---
description: "统一 Harness 界面语言，并为社区插件做针对性适配，附只读兼容性审计。"
---

<p align="right"><a href="README.md">English</a> · <b>简体中文</b></p>

<p align="center">
  <img src="docs/icon/app-icon-dark.svg" alt="dsh-ui-harmonizer" width="104" height="104">
</p>

<h1 align="center">DSH UI Harmonizer</h1>

<p align="center">
  <strong>DeepSeek Harness 打造的界面规范化与协调层</strong><br>
  规范化官方界面 · 协调每个插件 · 设置页自动规范器 · 界面定制（宽度、字体、侧栏开合平顺）</p>

<p align="center">
  <img src="https://img.shields.io/npm/v/dsh-ui-harmonizer?style=flat&label=latest%20release&color=4D6BFE" alt="Latest release">
  <img src="https://img.shields.io/npm/dt/dsh-ui-harmonizer?style=flat&label=total%20downloads&color=4D6BFE" alt="Total downloads">
  <a href="https://github.com/Physicolor/dsh-ui-harmonizer/stargazers"><img src="https://img.shields.io/github/stars/Physicolor/dsh-ui-harmonizer?style=flat&label=%E2%98%85&color=08C" alt="GitHub stars"></a>
  <img src="https://img.shields.io/badge/license-MIT-2EA44F?style=flat" alt="MIT License">
  <img src="https://img.shields.io/badge/DSH%200.1.x-4493F8?style=flat-square" alt="Supported: DeepSeek Harness 0.1.x">
</p>

---

<p align="center">
  <sub>属于 <b>DSH Design System</b> —— 本仓库是运行时的那一半。<br>
  它执行的规范在 <a href="https://physicolor.github.io/dsh-design-resources/">Physicolor/dsh-design-resources</a>。</sub>
</p>

> **一句话* 你装了一DSH 插件，界面却风格割裂？DSH UI Harmonizer 用*CSS 覆盖 + 运行DOM 协调**」把它们拉回官方设计语言—*不破坏任何插件源码、卸载即还原、零模型开销**
DSH UI Harmonizer 是一*纯浏览器端（client-only*DSH bundle 插件。它不新增模型工具、不改写会话日志，只通过官方 `settings.section` / `settings.general.item` 槽位`--dsw-*` 语义令牌体系调整界面
---

## 当前功能

### 🎨 官方 UI 规范
| 能力 | 说明 |
| --- | --- |
| 顶部栏单行化 | 对话/轨迹选择器移入标题行，header 收成单行 |
| 按钮胶囊家族 | Session log、组件、toggle 按钮统一32px 胶囊 |
| 右侧栏贴边圆角矩| better-sidebar 面板覆盖式布局，header 不动 |
| 设置页头统一 | 标题 18/600 + 描述 13px + hairline 收尾 |
| 原生 title 悬浮提示统一 | `title` 属性改用官方深色气泡渲染，替代系统默认提示样式 |

### ♻️ 插件视觉协调

| 协调对象 | 做法 |
| --- | --- |
| `dsh-better-sidebar` | toggle 按钮胶囊化、面板背景统一、布局协调、平滑过渡动|
| `dsh-widgets` | 统计胶囊同族、header utilities 对齐 |
| `dsh-context` | 其「上下文」视图会隐藏输入框座位，而组件栏正挂在这个座位里，整个组件区域随之消失；组件栏开启时把座位恢复为裁切 + 零高度，仪表盘保住整列、组件栏照常绘制。其「上下文洞察」仪表盘（`shell.overlay`）把框架层级交还回来：遮罩打开期间把该出口的 z-20 层叠上下文抬到 z-21 页眉之上（此前遮罩在页眉和挂在 body 上的组件放大层面前失效），彩色 `ContextIcon` 在两个 chrome 位置统一解析为 `currentColor`，仪表盘内的激活药丸不再使用深色主题的近白主色填充。仪表盘本身随后改穿**设置窗口**的外壳：`--dsw-radius-panel` 圆角、`bg-layer-2` 底色、`--dsw-elevation-prominent` 投影且不再描边，标题行采用对话框配方（顶部 22px / 两侧 24px 内边距、16px/24px 500 标题、28px 圆形关闭位），内容列自窗口顶端下移 54px、四周 24px 内边距，内部卡片统一到官方卡片 recipe（20px 圆角、12px 14px 内边距、10px 卡片列表间距）—— 见 `docs/dialog-window-style.md` |
| `@omdsh-dev/dsh-genui` | `render_ui` 面板与工具卡片：宽度跟随「对话列最大宽度」（`--enhancer-content-width`，如 840px）而非冒泡到整列；修复折叠flex-nowrap 长标题撑宽根因并统一 11px/16px 内边距；`banner`/`steps` 等横贯块16px 左右间距规范（不向外扩盒）；svg/pre/canvas/img/mermaid 全部限宽护栏 |
| 第三方设置页 | 自动补标题、删多余图标、统一间距格式 |

### 🧹 设置页自动规范器 
任何第三方插件往 `settings.section` 加页面时，若没有严格按官方规范设计，插件会自动修正：

| 自动检查项 | 修正方式 |
| --- | --- |
| 缺页面标| 注入 18/600 标题（取导航项名或已知映射） |
| 标题旁多余图| 移除标题logo，保留纯文字 |
| 标题/描述贴太| 统一 4px 间距 + hairline 收尾 |
| 字号/格式不统一 | 标题 18/600、描13/20 + `border-bottom` |

### 🎛界面定制

设置 → 通用设置中的"界面定制"块：对话宽度、markdown 字号、工作区字号、UI 字体、侧栏开合平顺均可实时调节。「侧栏开合平顺」（默认开）让右侧栏开合不再逐帧重排整个界面：轨道一步到位，位移改由正文列与输入框胶囊上的 cover 承担，两者都不触发强制布局；关闭后恢复官方原始缓动。

---

## 工作原理

插件按**作用对象**分层，而不是按文件类型堆放 —— 它同时协调两件事：(a) DSH 本体自身的界面规范，(b) 装在同一台机器上的各个社区插件。每个源文件只属于四层之一：

| 层 | 回答什么 | 例子 |
| --- | --- | --- |
| `core/` | 与 DSH、与任何插件都无关的基础设施 | 状态模型与持久化、Harmony Contract、i18n、DOM/React 小工具 |
| `harness/` | 针对 **DSH 本体**的规范化与修补 | 官方控件 recipe 复刻、设置页表头规范器、对话宽度通道、列轨道动画兜底、菜单宽度、样式表守护、原生 title 气泡、圆角卡片 |
| `plugins/<包名>/` | 只服务于**某一个**社区插件 | `commandcode-provider` 文本归一、`dsh-widgets` 组件栏让位与手柄重锚、`dsh-better-sidebar` 面板、`dsh-genui` 宽度卫生 |
| `self/` | 插件**自己**画的界面 | 设置 → 通用 的五行、字体选择器、Harmony Doctor 页 |

样式表按同一划分拆成 29 个 `.module.css` 分片，入口只有一个（`src/client/styles/index.ts`），**它的 import 顺序就是层叠顺序**。

其余约束不变：

- **零模型开销**：host（node）半是 no-op，全部改动发生在浏览器半；
- **官方设计令牌**：所有样式走 `--dsw-*` 语义令牌，自动跟随明暗主题；
- **两条注入通道**：静态规则（CSS Modules）+ 动态 `<style data-plugin>` 标签；
- **可逆清理**：每个 `ctx.effect` 都返回 disposer，卸载后不留残留 —— 包括被搬迁过的 DOM 节点和被改写的第三方文案；
- **Slot 接入**：`settings.general.item` / `settings.section` / `shell.overlay`。

护栏都在 `scripts/`：`tools/css-baseline.mjs`（编译后样式表的字节不变式）、`verify-frame-track.cjs`（列轨道动画 + 侧栏平顺）、`verify-rapid-toggle.cjs`（联按回归：连续点击后不得残留内联样式、不得遗留 cover、轨道不得漂移）、`verify/settings-page.cjs`（设置页信号）、`probes/harness/*`（选择器与网络体检）。
---

## 安装

```sh
# 通过 npm（插件市场）
dsh plugin --profile web add dsh-ui-harmonizer

# 本地开发（link 方式dsh plugin --profile web add link:D:/dsh-home/plugins/dsh-ui-harmonizer
```

安装*硬刷新浏览器**（Ctrl+Shift+R），设置 通用设置 看到"界面定制"块
---

## 开
```sh
pnpm install
pnpm run build      # tsdown 构建 lib/
pnpm run check      # 类型检+ 构建
```

- `peerDependencies`：`@deepseek-ai/dsh-client-ui-slots`、`dsh-client-runtime`（由 DSH web profile 提供）；
- client 插件：`cordis.patch.yml` 插入 `ui-enhancer` 行，浏览器半`dsh.client` 声明
- **修改后需同步**：`npx tsdown` 重建 同步`profiles/web/node_modules/dsh-ui-harmonizer/lib/` 硬刷新浏览器
---

## 兼容
- DeepSeek Harness `0.1.0-rc.6` 及兼容的后续 `0.1.x`
- 通过官方 slot 接入，与 better-sidebar、dsh-widgets、dshmarket 等插件按 slot 顺序共处
- 已知协调对象：`dsh-better-sidebar`、`dsh-widgets`、`dsh-context`、`dsh-notification`、`dshmarket`
- 卸载/禁用后页面完全恢复默认，无残留
---

## 路线
- **阶段一 · 官方 UI 规范化**（进行中）：继续修复官方界面中未完善的部分；
- **阶段二 · 插件兼容协调**（进行中）：检测并修复插件间的布局/样式冲突；
- **阶段三 · 统一视觉风格**（进行中）：可选的视觉风格层——已落地 title 悬浮提示统一，待续：间距密度、更多圆角与动效统一；
  - *液态玻璃探索*：规范化的终点是降低认知成本——统一的标题与提示消除的是「风格切换」的微疲劳；材质层统一更进一步：用一致的物理隐喻暗示层级与可交互性，让整个页面形成单一心理模型，减少视觉与认知负担。边界：只在语义 token / CSS 层实验——设置开关可选、大面积 backdrop 表面至多两处（控制 GPU 开销）、尊重减弱透明动效偏好、不支持时回退到现行实底样式、绝不触碰插件源码，且以可读性不降为底线；
- **阶段四 · 生态共建**：沉淀为可扩展的规则注册机制。
---

## 变更日志

### v0.9.1 — 侧栏开合平顺、顶栏徽章让位、设置页表头收成一套骨架；删除圆角卡片

按车主决定以 **patch** 发布：这一版带新行为，严格按语义化应为 minor。它同时删掉了 0.9.0 里的一个可选视觉层，所以那一条写成"删除"，而不是让它悄悄消失。

**新增 —— 右侧栏开合不再逐帧重排整个界面（「侧栏开合平顺」，默认开）**

- 🔍 先量后改：产品在 `_frame` 上用缓动过渡 `grid-template-columns`，而它是**布局**属性——中栏轨道 300ms 内从 1427px 走到 659px，每一帧都重排整个框架（产品自己的 `ResizeObserver` 被唤醒 27 次，左侧栏开合只有 10 次），而合成器与 GPU 线程全程空闲。逐帧采集还抓到别的元凶：`_scrollBody` 的 `padding-right` 也在 300ms 里缓动，`_widthHandle` 的 `left`/`right` 同样是。正文列由 `scrollBody 宽度 − padding-right` 居中，于是轨道到位而内边距没跟上时，列会瞬移出去——实测关闭方向过冲 +261px。
- ✅ `harness/chrome/instant-track.ts` 在捕获阶段接住右栏按钮的点击：它把 `_frame` 与 `_scrollBody` 钉成 1ms 过渡，然后在产品自己写轨道的那次变更的微任务里**结束**这些过渡，于是轨道一帧到位，而 `transitionrun`/`transitionstart`/`transitionend` 仍然照常触发。位移改由**不触发强制布局**的 cover 承担（正文列用 `transform`、输入框胶囊用 `left`），cover 只**跟随**布局不**预测**布局。
- 🚫 绝对不给输入框胶囊或它的任何祖先加 `transform`：`dsh-widgets` 在那棵子树里放着三个 `position: fixed` 节点，加 `transform` 会改写它们的包含块，把导轨拖进视口（实测 1247 → 412.4）。用 `left` 则每档导轨漂移 0.0px。
- 🔁 联按不留残留：每次点击发一个 generation token，旧的 `step` 一失效就退出；修复前三组联按会把 `translateX(-230px)` 永久留在页面上。
- 🧪 门禁：`scripts/verify-frame-track.cjs`（12 项）与 `scripts/verify-rapid-toggle.cjs`（28 项）。

**新增 —— 顶栏跟着面板一起动，徽章在标题被压扁之前先让位**

- 🔍 先量后改：正文列在滑，而顶栏在点击的同一个 commit 里**瞬跳**。顶栏不能像列那样被 cover——它的左边缘钉在左栏、右边缘属于面板，几何是**宽度**而不是偏移量，相对偏移拉不开标题列。实测把 `header.style.width` 写回关闭时的值就能完整复现关闭态顶栏。
- ✅ `instant-track.ts` 在 `left`/`transform` 之外长了第三种模式 `width`，共用同一条驱动/重坐/释放路径。实测（1707×1067、三个徽章）开启方向 **12 个不同的绘制宽度，1427 → 659**，关闭方向 22 个，第一帧就是关闭宽度；内部所有东西（标题、徽章、页签条、右侧按钮）自动跟随，**不给任何顶栏节点加 `transform`**。
- 🐛 报告的另一半是换行，而徽章不是原因：页签条被搬进 30px 的标题行，带着产品的 `flex: 0 1 auto` + `min-width: auto`，于是被压到胶囊标签换行——页签条 26 → 58px、顶栏 50 → 78px。一条 `flex: none` 让它保持内容宽度，缺口全部落到产品本来就写了 `min-width: 0; overflow: hidden` 的 `_crumbs` 上。实测十种宽度组合下都是 `139x26` + 50px 顶栏，两次实时开合的**每一帧**都是。
- ✅ `harness/header-fit.ts` 按车主要的顺序让徽章退场——标准模式 → 智能体团队 → 子智能体，退回 100 宽度后原样恢复。
- 🧪 门禁：`scripts/verify-header-fit.cjs`（14 项）。

**重构 —— 设置页表头是一套骨架、一套几何，每个页面都一样**

**修复 —— 侧栏账号浮层比它挂靠的那一行更窄**

**修复 —— 某个第三方设置页完全没上样式（loader 认领通道的 bug）**

**清理 —— 死选择器、重复的 1Hz 定时器、按长度而非文本做的表头指纹**

**删除 —— 中栏圆角卡片**

- 🗑️ 「圆角卡片」（设置 → 通用设置 → 界面定制）连同它的 `shell.overlay` 覆盖层、样式表与状态字段一并删除。理由：它是**视觉主张**而不是规范化——给产品加了一圈它本来没有的圆角与投影，并且在中栏里又占了一块别的插件必须绕开的表面。这一块里留下的是**消除缺陷**而不是**增加外观**的那部分：对话宽度、字体栈、侧栏开合平顺。删除本身零残留：根类不再写入，`disposeDynamicStyle` 仍会清掉 `enhc-center-card-on`，所以热更新时还在跑旧构建的页面不会留下一张没人绘制的卡片；读取状态时丢弃持久化的 `card` 键，老配置不会带着一个没人认领的字段。
- 🧭 因此 Doctor 的表面清单从两个降为一个。下面的历史条目仍会提到圆角卡片——它们记录的是对应版本当时的样子，保持原样。

### v0.9.0 — 一套 Harness 界面语言，以及按目标分层的代码布局

**重构 —— 每个源文件只属于一层**

- 插件按**作用对象**分层：`core/`（与 DSH、与任何插件都无关的基础设施）、`harness/`（针对 DSH 本体的规范化）、`plugins/<包名>/`（只服务于某一个社区插件）、`self/`（本插件自己画的界面）。`src/client/` 顶层现在只剩 `index.ts` 与 `services.d.ts`。
- 1253 行的样式表拆成若干 `.module.css` 分片（今天是 29 个 —— 拆分之后又追加了 dsh-widgets / dsh-context 的协调分片，含它的设置窗口外壳），入口只有一个（`src/client/styles/index.ts`），**它的 import 顺序就是层叠顺序**；拆分本身已证明与原文件逐字节相同，`scripts/tools/css-baseline.mjs` 现在守住编译后的结果。
- `npx tsc --noEmit` 从 **52 个错误降到 0**；`build` 现在会跑 `tsc`，`lib/types/` 这才真的存在（此前 `files` 里声明了它却从未生成）。

**修复 —— 对真实 DOM 做对抗性复核后找出的失效与错配选择器**

- **下拉菜单的配方从未生效**：`[role='menu'] [class^='_list_']` 既是后代又是前缀匹配，而产品把 `role` 与 list 类放在**同一个**元素上、且 list 类不在最前（`_surface… _list_4ub78_7 …`）。菜单打开时实测：后代 0、前缀 0、包含 1。改成 `[role='menu'][class*='_list_']` 后，list / item / icon / label 四条规则全部落地（padding 4px、min-width 218px、item min-height 40px）。
- 侧栏里带修饰类的行（`_brand _wide`）会静默不再匹配 `[class$='_brand']`；锚点改为「class 列表**包含**一个 `_brand` 词条」的写法。
- 品牌字标不再被改尺寸 —— 0.2 把它渲染成**两个** svg（鲸鱼 + HARNESS 徽章），一条 `svg { width:182px }` 会把鲸鱼拉伸 7.6 倍。
- `menu-anchor` 不再把官方设置按钮（`aria-haspopup="dialog"`，且设置对话框开着期间 `aria-expanded` 恒为 true）当成菜单触发器 —— 它此前把产品自己的弹层强行改成侧栏某行的宽度。
- Doctor 的 `deadInThisView` 被声明了两次（一个计数、一个行数组），导致 Markdown 导出打印 `[object Object]`；另外删掉一条死规则 `market-hash`、修正一条错归属的 `data-dsh-*` 耦合。

**修复 —— 帧的列轨道在 DSH 0.2 上真的会动了**

- 0.2 把 AppFrame 的 `transition: grid-template-columns` 挪到 `[data-animating]` 后面，而 React 在**写入新轨道的那次 commit** 的 layout effect 里设置这个属性 —— 起始样式因此没有 transition，过渡从不启动，对话列是**瞬变**的。实测：一帧从 1640px 到 776px、没有任何 transition 事件、`data-animating` 靠组件自己的 600ms 兜底定时器清除。
- 样式表现在让帧常驻这条 transition（产品自己的 `[data-dragging]` / `[data-rightbar-instant]` 规则依然优先），并由 `frame-track.ts` 承担产品用 JS 排除的那一种情况 —— 窗口缩放。

**修复 —— 生命周期**

- 两处 DOM 搬迁（会话 tabs、底部工作台开关）在 dispose 时把节点搬回原位；圆角卡片那条无条件的 1Hz `setInterval` 已删除（ResizeObserver + resize + transition 事件早已覆盖同一路径）；设置页表头的指纹改为对**文本内容**做哈希，而不是长度（等长改写会让标题冻结）。

### 未发布（待验收）：侧栏开合平顺 · 设置页表头统一骨架 · 行内弹层宽度 · 第三方样式表守卫

**新功能 —— 右侧栏开合不再逐帧重排整个界面（「侧栏开合平顺」，默认开）**

- 🔍 先量后改：官方在 `_frame` 上缓动 `grid-template-columns`，而这是**布局属性**——中列轨道在 300ms 里从 1427px 走到 659px，每一帧都让整个 frame 重新布局（官方自己的 `ResizeObserver` 因此被唤醒 27 次，而左侧栏开合只有 10 次），同时合成器与 GPU 线程几乎空转。逐帧录得的元凶不止一条：轨道之外，`_scrollBody` 的 `padding-right` 缓 300ms、`_widthHandle` 的 `left`/`right` 也缓 300ms，而正文列按 `scrollBody width − padding-right` 居中，轨已到位、padding 未到时正文列会瞬态飞出去（实测关栏方向过冲 +261px；只压轨道不压 padding 仍残留 +54px）。
- ✅ `src/client/harness/chrome/instant-track.ts` 在 capture 阶段接管右栏按钮的点击：给 `<html>` 写 `data-enhc-instant`，把 `_frame` 与 `_scrollBody` 的过渡压到 1ms，再在产品写轨道那个 mutation 微任务里对所有由 gate 产生的过渡调 `finish()`——轨道一步到位，同时 `transitionrun`/`transitionstart`/`transitionend` 三个事件照常触发。用属性而非 class，是因为主题观察器盯着 `<html>` 的 `class`，每次写 class 都要重建主题材质（实测约 7ms，见 handoff）；`transition-duration: none` 与真 `0s` 同样是错的——从未启动的过渡根本不产生事件，而 dsh-widgets 的轨道让步靠的正是这个事件。
- 🧷 动效以**不触发重排**的 cover 补回——正文列用 `transform`、输入框胶囊用 `left`。cover 不能**预测**布局，只能**跟踪**布局：关键帧的 `from` 取的是**武装那一帧**读到的位移，运行期间 `ResizeObserver` 在布局后、绘制前把它重定位（固定关键帧只要 `from` 取自瞬态就必然过冲——关栏方向第一个可读的种子是 +358px，而廊道只有 304px）。四臂实测**没有任何一帧画到 `[312, 616]` 廊道之外**，且从不回退到起点——这正是「先闪烁后平移」的判据。
- 🚫 绝不给输入框或其祖先加 `transform`：`dsh-widgets` 的 `dsx-stats-drawer`/`-zoom`/`-rail` 三个 `position: fixed` 节点就挂在那些祖先里，`transform` 会改写它们的包含块并把导轨拖进视口（实测导轨 1247 → 412.4）。`left` 是布局属性、不建立包含块，所以导轨漂移在每一档读数里都是 **0px**。
- 🔁 联按守恒：驱动为每次点击发一个 generation 令牌，旧的 `step` 认出自己已过期就退出。修之前 9 次 130ms 连击会留下 `transform: translateX(-230px)` 与 `left: -230px` 永久残留（孤儿 cover 把后一次点击写入的内联样式当成「原值」又「还原」了一次）；修之后三档风暴（9×130ms / 15×60ms / 5×400ms）全部检查通过、零残留。
- 🔒 gate 只在「确实没有东西还在动」时才摘（dock 的 `getAnimations()` 加每条 cover 自己的 `busy()`），硬上限 `HOLD_MS + 400ms`。按点击时钟摘 gate 会把开栏滑动切在 `currentTime 254.7/300`（全程没有 `animationend`），dock 从 `translateX(10.35px)` 直跳 `none`；现在摘除时刻与面板自己的 `animationend` 相差约 **10ms**。
- 📊 代价与收益（同一份已构建产物，唯一变量是 `<html>` 上的 `enhc-panel-glide`，各 9 次开关）：长任务阻塞 **285.2ms → 205.7ms（−28%）**、长任务条数 58 → 43；代价是每次开关约 +8ms 布局与 +23 次 `LayoutCount`，`TaskDuration`/`ScriptDuration` 基本不变。**这组数字只作方向性参考**：后来同一 build 内 15 次那一对的两臂自相矛盾，所以因果只采用隔离机制测量（`<html>` 上写 class vs 写属性；在轨道 `transitionrun` 里调 `getComputedStyle`）。
- 🎛️ 设置 → 通用 → 界面定制里的「侧栏开合平顺」开关实时生效、默认开、卸载零残留（`apply.ts` 负责增删根类，`disposeDynamicStyle` 一并摘掉 `data-enhc-instant`）。
- 🧪 护栏：`scripts/verify-frame-track.cjs`（12 项，含开/关栏 snap、三个过渡事件、cover 落在正文列、导轨零漂移、窗口改尺寸不缓动且 `enhc-window-resizing` 及时出现与释放）与 `scripts/verify-rapid-toggle.cjs`（28 项，含上面的联按 re-entrancy 契约与「两个 gate 都必须已释放」）。联按护栏还会分辨导轨漂移**是谁的账**：若漂移时导轨的 `right` 仍停在 anchor 表达式，那是 `dsh-widgets` 自己的 swallowed-rail race（本插件 inert 时 30 次风暴复现 2 次、live 时 60 次复现 1 次），只有这个签名才放行；若导轨已 claim `0px` 却仍漂移，才算我们的残留、判定失败。

**新功能 —— 顶栏跟着面板一起平滑，空间不够时先花徽标、不再压标题**

- 🔍 先量后改：正文列在缓动，而**顶栏在点击那一次 commit 里直接跳到位**。逐帧采样一次开合：snap 之后
  `_headerUtilities` 与 tab strip 的 `left` **一次都没变**，而正文列在缓动 `509.1 → 312`。顶栏没法照抄
  正文列的 cover —— 它的左边缘钉在左列、**右**边缘是面板的，所以它的几何是**宽度**而不是位移，而相对位移
  托不住标题列的宽度（先试的方案：给所有没有 `position: fixed` 后代的宿主各加一条位移 cover，结果是标题照样
  瞬跳截断）。决定性实测：开栏状态下把 `header.style.width` 写回关闭值，关闭态被**逐项复现** ——
  `280,1427,50`、标题列 212px、strip `867.5,139,26`；对照开态 `280,659,78` / 41.5px / `697,87,58`。
- ✅ `instant-track.ts` 在 `left`、`transform` 之外新增 `width` 模式，三者共用同一条 driver、reseat 与
  release 路径；capture 阶段读一次顶栏宽度就武装。三徽标参考会话（1707×1067）实测：开栏
  **12 个不同绘制宽度 `1427 → 659`**（首轮 18 个）、关栏 22 个，首帧即关闭宽度。里面的一切都免费跟着走 ——
  标题、徽标、tab strip、右侧按钮 —— 所以既不需要每个宿主各来一条 cover，也**没有给任何顶栏节点加 `transform`**。
- 🐛 反馈的另一半是换行，而且不是徽标挤的：tab strip 被搬进 30px 的 title row，带的是产品的
  `flex: 0 1 auto` + `min-width: auto`，于是 cluster 的收缩先压 strip，strip 内部再压胶囊标签 ——
  strip `26 → 58`、顶栏 `50 → 78`。修复只有一条 `flex: none`：把 strip 摁在内容宽度上，
  亏空全部落到 `_crumbs`（产品本来就给了 `min-width: 0; overflow: hidden`）。实测
  **十臂**（1707/1440/1280/1152/1024 × 开/关）strip 恒 `139x26`、顶栏恒 50px，且两次真实开合的
  **每一帧**（57 / 69 帧）都成立。
- ✅ `harness/header-fit.ts` 按车主指定的顺序花徽标 —— 标准模式 → 智能体团队 → 子智能体，
  叫不出名字的徽标排最后 —— 直到 `_crumbs` 达到 160px 的可读地板，外加 24px 迟滞防止边界抖动。
  参考会话开栏实测：标题 **0px → 165px**，3 个徽标隐 2 个；开栏过程中 rung 单调不减（56 对帧零回退），
  关栏恢复全部 3 个与标题满宽 212px。
- 🧷 徽标身份**只按属性**、绝不按文案：可见字符串是运行时 locale 查表（整个 asar 里中文字面量 0 处，
  原文与转义都没有），模块类名带构建哈希 ⇒ 子智能体用 `aria-haspopup="tree"`、智能体团队用
  `data-team-action`、标准模式是 seat 里唯一的 `span`。判据是「先应用候选档、再读 `_crumbs.clientWidth`」
  而不是拿徽标宽度做算术 —— 那些宽度不是常量：产品自己的 `@container` 会在 row ≤540px 时把
  「标准模式」标签清零、≤480px 清零「智能体团队」标签，后台任务计数还随任务数变宽。
- 🧪 护栏：`scripts/verify-header-fit.cjs`（14 项 —— 关闭基线与阶梯徽标集合、开栏的不同宽度数与首帧值、
  **整段真实开合零换行帧**、rung 单调、落定态前缀 + 地板、关栏全恢复、四个宽度两种面板态的尺寸、
  无残留属性、无 page error）。

**重构 —— 设置页表头只剩一套骨架、一套几何，所有页面一致**

- 🔍 先量后改（`scripts/probes/settings/probe-header-geometry.mjs`，八个月有表头的页面全量测）：标题的 viewport 位置本来就一致（`titleTopFromDialog = 54`），但标题→描述的距离不一致——本插件自己的页面 4px、官方页 12px、Command Code **0px**（它的容器是 block 流、根本没有 gap，描述贴着标题）、侧边卡片 16px。把我们插件的样式表整体禁用后量到的官方值：模型 / Agent 预设 / 内置插件**都是 12px**，也就是官方 section 容器自己的 `gap`。旧文档写的「官方 4px」其实是本插件当年自己压出来的，正式作废。
- ✅ `src/client/settings-page.ts` 现在只产出页面真正需要的那套骨架：`h2.enhc-page-title` + `p.enhc-page-intro` 两个兄弟节点。本插件自己的页面用 `SettingsPageHeader` 渲染，别人的页面由规范器打在真实节点上；**head 包裹容器已删除**，所以在 DevTools 里无论官方页还是第三方页，看到的表头形状都是同样的两个节点。
- 📐 间距不再是样式表常量：规范器实测真正负责排版的那层容器（会穿过 `display: contents` 的插槽出口向上找），把差值写到描述上（`margin-top = 12px − 容器 gap`）；容器自己有 `padding-top`/`border-top` 时，再给标题等量的负 `margin-top`。修完后每页读数都是 **标题 y=134、描述 y=172、间距 12px**，而各页容器依然各不相同（4 / 无 / 12 / 16 / 2px）。
- 🔒 不移动、不包裹任何节点（别人的 React 树不会看到自己没渲染过的容器）；本来就合规的页面保持原样；页面重渲染后，规范器会把不再承担角色的节点、连同内联间距一起释放。

**修复 —— 侧边栏账号弹层比它所在的行更窄**

- 🐛 账号菜单（设置 / 意见反馈 / 退出登录）用的是产品 Menu 的内容驱动宽度（218–360px），而它挂在的侧边栏行是满宽 256px，弹层与触发行之间有明显错位。
- ✅ `src/client/menu-anchor.ts` 把从 `settings.launcher` 座位打开的门户菜单钉到触发行的宽度（`box-sizing: border-box`），且只作用于该座位：输入区的模型/权限选择器等其它菜单维持各自配方。

**修复 —— 某个第三方设置页完全没样式（产品 loader 的 claim 缺陷）**

- 🔍 根因在产品的 client-module loader，而非插件：`claimStyles(id)` 在每个模块工厂完成物化后运行，会把文档里**所有没有 `data-plugin` 的 `<style>`** 都记到当时物化的那个插件名下；而 `removeOwnedStyles(id)` 会在那个「收养者」重载/卸载/被 prune 时删掉所有 `style[data-plugin=id]`。于是在 `apply()` 里手写注入一次样式表的插件（dsh-notification 的 `#dsh-notification-style`）会整会话丢掉样式——真机实测：通知页退化成裸文本（没有卡片、没有徽标、按钮是浏览器默认样式），`#dsh-notification-style` 根本不在文档里。
- ✅ `src/client/style-keeper.ts` 对「手写注入」的样式表做快照（判别依据是 `data-plugin-css`：打包器产出的标签归 loader 所有，不动），消失后延迟一小段时间再恢复——这个延迟正好让「合法热重载后自行重注入」的属主抢先，避免重复。恢复出来的样式表保持作者写的属性，不带「小偷」留下的 `data-plugin`。
- 📊 探针（真机页面，按 loader 语义复现）：基线 38 条规则 + 卡片 `1px/12px/flex` → 偷走瞬间无样式表、卡片 `0px/0px/block` → 宽限期后 38 条规则、卡片恢复；9/9 全绿。

**清理**

- 🧽 修掉 `enhancer.module.css` 注释里 48 个乱码字符（早前 PowerShell `Get-Content -Raw`/`Set-Content` 往返把文件按 GBK 重编码：`—` → `鈥?`、`×` → `脳`，还有一处中文词组被毁）。仅注释受影响、构建从来不受影响；已用 Node 脚本按 UTF-8 重写，不经 shell。

### v0.9.0 定位升级：从「CSS 补丁」到「UI 契约+ 兼容性审计器
**新功能（Harmony Contract 跨插UI 契约*

- 🧭 `<html>` 上发布协商变量，任何插件或主题都能读，不需要互相依赖：`--enhc-contract`（契约版本）、`--enhc-surface-solid`、`--enhc-glass-aware`、`--enhc-solid-fill`、`--enhc-content-width`、`--enhc-sidebar-scale`
- 🔌 提供 `ctx.get('uiHarmony')` 服务（与官方 `ctx.sidebarRight` 同一 `ctx.reflect.provide` 约定）：别的插件用 `registerSurface({ id, role, occupies, widthVariable, transition, tokens, opaque })` **申报**自己占了哪块表面、用哪个 token、动画多长。本插件只做仲裁与告警，不再靠猜别人的 DOM。本插件自身也申报了一个表面（通用设置里的行，以及 UI 兼容性页）。
- 🪟 **材质感知**：从语义 token 本身判断界面是实体还是半透明（`--dsw-alias-bg-base` / `-layer-1` / `--dsw-specific-sidebar-fill` alpha），不做插件身份判断。检测到玻璃主题`--enhc-solid-fill` 变为 `transparent`，会header / 面板不再往玻璃上糊一块不透明矩形（此前是「玻璃上一个没有模糊的洞」）。尊`isTranslucent()` 的解析规则（`rgba`/8 hex/`transparent`；`var()`、`color-mix()` 视为实体，不猜）*实测（模拟玻璃，不装第三方主题）**：把 `--dsw-alias-bg-base` 就地改成 `rgba(255,255,255,0.45)` 后，`--enhc-glass-aware` 0、`--enhc-surface-solid` 1、`--enhc-solid-fill` `transparent`、会header `background-color` `rgb(255,255,255)` 变为 `rgba(0,0,0,0)`；移除该覆盖后四项全部回滚
**新功能（Harmony Doctor 本机只读兼容性审计）**

- 🩺 设置 **UI 兼容*：一次点击跑完四类检查，零网络、零模型调用，可导出 Markdown 报告
- 🕳**死规则台*：逐条 `querySelectorAll` 统计本插件自己的 CSS 规则命中数；**只有在一个视图里从没命中过才算「未观测」，在多个视图里都没命中才算「死*——台账按视图持久化，用户走到哪、结论就精确到哪。开箱即得的核心数字49 条选择器里 **53 条在任一视图命中6 条在所有已观测视图里全*（会话视图未接入6 是上界）
- 🔗 **跨插件耦合健康*：列出仍然在读别人私有类/`data-*` 的选择器与实时命中数（本机实测自动报出 **39 条耦合**，其中一批因 better-sidebar 0.19.1 已移除对应类而命0）
- ⚖️ **冲突 / 冗余判定**：行内声明自检（写进去的值必须读得回来）+ 冗余检测（把自己所有样式表临时 `disabled` 再读计算值，值没= 这条规则什么也没做）
- 🗂**表面清单**：每`data-slot`、每个跨插件 `data-*`、每个已发布契约变量、每个被申报的表面，各自的使用方与数量
**修复（字体设置此前完全不生效 已定位并修复*

- 🔍 **根因**：字号行12 `--dsw-font-markdown-*` 令牌写在一`<style>` 标签里，该标签在 `document.head` 中排**4** 位，而官theme `gradient-shadow-text.css`（同样把令牌声明`body{}` 上）排第 **24** 位。选择器与特异性完全相后写的官方赢*四个字体预设（默衬线/等宽/雅黑）读出来的令牌值逐字节相*，CDP 实测渲染字体也全`Segoe UI + Microsoft YaHei`。此前「改了没反应」不是字体没装（实测 HarmonyOS Sans SC、微软雅黑、Noto Sans SC、Georgia、SimSun、Consolas、Courier New 均在本机可用）
- **修法**：字体族改写**`<body>` / `<html>` 的行内自定义属*（行内优先，与样式表顺序无关），并在销毁时精确移除；令牌里的字号不再写px，而是引用产品自己`--dsh-content-font-size` / `--dsh-content-font-delta`
- 🎯 修复后实测：`serif` 令牌 `Georgia…`、CDP 渲染 `Georgia`(10 字形) + `SimSun`(4)；`yahei` + 作用范围「整个界→ 界面元素渲染 `Microsoft YaHei`；`default` 完全不留覆盖（纯官方）
- 🧩 **补齐覆盖缺口**：现在覆盖官0.1.5 全部 **12** 个真正被 `var()` 消费markdown 令牌，补上旧版漏掉的 `-table-head`（表格表头）、`-code-block-small`（工技Cordis 面板代码块）、`-code-font-family`（slash chip）；另外 90 个从未被消费的声明不再触碰。代码块只在选到等宽预设时跟随，选衬线不会把代码也变成衬线
- 新增**字体作用范围**（对话正/ 整个界面）与**未安装字体提*（两基线 canvas 宽度差判定，`document.fonts.check` 对未知字体恒返回 true，不可用）
**修复 / 减法（官0.1.5 已收编或已失效的部分*

- 🗑删除 **`html.enhc-panel-open` 座位机制**与整better-sidebar toggle-cluster 座位。实better-sidebar 0.19.1 192 CSS-module 表里**已无** `toggleCluster` / `panelHidden` / `panelResize`，也不再发布 `--dsh-sidebar-width`（改`--dsh-title-bar-strip` / `--dsh-sidebar-height`）。保留下来的后果是反向的：`panelOpen` 恒为 `true`，只要面板节点在 DOM 里「紧凑浮动座位」就成了默认形态——不是失效，*反着生效**
- 🗑删除 `[data-input-scroll]` 与用户气泡的字号覆盖：产品自己就`--dsh-content-font-size` 控制这两处，我们的覆盖把官方「内容字号」行在这两个表面冻住了。实测行高从我们写死`21px` 回到官方 `24px`
- 🗑内容字号行本身下线：官方 0.1.5 自带 `FontSizeRow`27px，命名空`ui-theme`），本插件改为消费它的通道而不是和它抢同一组令牌*保留**官方没有的两项：对话宽度设置行、字体族与作用范围（官方 `--dsw-font-family` `:root` 上的固定值、无用户设置）
- 🧹 中间列圆角卡片改为材质变量驱动（`--enhc-solid-fill`），为玻璃主题让出画
**可复*

- 渲染级探针：`node scripts/probes/plugin-eco/probe-harmony.mjs http://127.0.0.1:19387 out.json`（`scripts/lib/auth.mjs` 用本机持久化browser-session secret 自签 cookie 通过 UI 门禁，无需启动令牌、不打扰正在使用的会话）
- 全部量化数据、口径与反例（含「未观测会话视图6 是上界」这一限制）：`docs/MEASUREMENTS.md`
### v0.8.4（未发布，待验收
**兼容适配 DeepSeek Harness 0.1.5 的客户端结构变更*

- 🧭 **中栏定位改写（唯一硬失效项*.1.5 把会话从 root 的直接子`conversation` 改成 `main` 的键控条目，并在其下声明 `main.conversation`；两anchor 都是 `display:contents`（零盒），旧`slot.parentElement` 会拿到一个不可测量的 wrapper。`findCenterColumn()` 现在同时接受 `[data-slot="main.conversation"]` `[data-slot="conversation"]`，并`closest('[class$="_centerCol"]')` 取回真正的列容器（旧parentElement 逻辑保留为回退）。圆角卡片的 CSS `:has()` 守卫同步接受 `main` / `conversation` 两种锚点写法
- 🔌 **类型与打包来源对齐官*：`@deepseek-ai/dsh-client-runtime` 已在 0.1.5 web 组装中退役（npm 上停更于 0.1.1-rc.2），客户端上下文的类型来源改`@deepseek-ai/cordis` `Context`；`package.json` peer/devDependencies `tsdown.config.ts` 的平台模块表同步移除该包（运行时import 它，原先只有类型依赖）
- 🔍 **审计结论（其余全部存活，未改代码*：`[data-slot="conversation.session.header"] > header`、`_titleCluster` / `_headerActions` / `_tabs` / `_viewArea` / `_composerSeat`、侧栏系列、设置页四件套（`settings.section` + `_intro` + `nav button` + `_navCell`）、菜单基元、`shell.overlay` / `settings.general.item` / `settings.section` 三个 slot 0.1.5 全部原样存在；`_flowItem` / `_bubble` 随聊天渲染迁入新`dsh-client-ui-chat`（哈希变、后缀选择器不受影响）
- **实测**.1.5-rc.2 隔离实例（独DSH_HOME + 独立 profile + 3081 端口）中，圆角卡overlay `main.conversation` 结构下几何正确（`left=56px / width=694px`），插件样式63 个客户端 entry 一同加载，无未捕获异常、无 slot 错误
- 🎛**顶部栏（2026-09-13 追加，两处按官方为主*\n- **对话/轨迹回归官方 tab 样式**.1.5 自带真正tab 选择器（`_tabs` `gap:36px; margin-top:10px` + `_tab` 的文字＋2px 下划线指示条，激活态用 `state-business-primary`），此前被本插件改成了自造胶囊。现已删除该胶囊覆盖，恢复官方下划线样式；同时把 `margin-top:10px` 在标题行内归零（10px 正是「tab 比顶部栏低一截」的错位根因），标签上下改为对称 5px 内边距，由标题行`align-items:center` 完成垂直居中\n- **移除右侧预留*：header 原本`margin-right: max(var(--dsh-sidebar-width,0px), 90px)` better-sidebar 的浮动按钮簇留位.19 起该插件把控件注册进官方 header 座位（`ctx.sidebarRight` / header corner）且不再发布该变量，90px 会变成右侧死白。现改为只跟随变量（0.1.5 下解析为 0，官grid 列自己让位），旧better-sidebar 若仍设置该变量则保留其预留
- 📌 已知待目视复核：`_flowItem` 的新哈希只影响观感细节；`.nArs4W_*`（better-sidebar .14 类名）相关规则在 0.19.1 下已是死代码，可后续清理
### v0.8.3（未发布，待验收
**性能 侧栏挤压动画保留丝滑渐进观感的同时达到满帧率（配dsh-widgets v1.2.3）：**

- 面板开合掉帧的根因：三个被挤压表面（对话区 `viewArea`、输入框 `composerSeat`、会header）以 0.3s 过渡动画 `margin-right: var(--dsh-sidebar-width)`——每帧对**整个对话 DOM** reflow，长会话（数千节点）下掉201%，并与合成器驱动的组件栏/面板滑动肉眼可见地不同步
- 修复*原样保留渐进 margin 动画**（左缘恒定、右缘平滑滑动、文字渐进重排——不做「先跳到终宽再平移」的妥协），转而把每帧重排变便宜：对话每个回合/步骤（`*_flowItem`）获`content-visibility: auto` + `contain-intrinsic-size: auto 120px`，离屏条目完全跳过布局，动画每帧只重排视口附近的几条。`auto` 让浏览器记住每条最后渲染高度，滚动条高度稳定；不支持的浏览器自动忽略该规则（仅回退到较慢行为）
- **实测数*（playwright + 本机 Edge，组件栏开启，重会话，面板开合窗口）：掉帧率 **201% 11.5%（rail 修复）→ 0%**；动画期viewArea **左缘漂移 0px**（始终对齐）；rail↔对话列右缘恒距（std 0.01px，完全锁步）；跳到滚动底部后 scrollHeight 偏移 0%（intrinsic 尺寸收敛）；热状态后开合的最大单帧步进约 89px——headless 软件渲染下的中段帧，真机 GPU 上更小。已知一次性现象：页面加载*第一*开面板仍有一帧较大步进（better-sidebar 面板首次渲染的长任务，与本修复无关）
- 自包含验证：`scripts/archive/dead-probes/verify-glide.cjs`（`npm i -D playwright-core && node scripts/archive/dead-probes/verify-glide.cjs [会话名]`）
### v0.8.2 已发
**新功能（i18n 中英文语言适配）：**
- 设置 通用页面中所有硬编码的中文字符串现已根据浏览器语言自适应：页面标描述、五个设置行的标描述、以及字体预设标签，在非 `zh-*` 语言环境下会显示英文
- 新增 `src/client/i18n.ts` 模块集中管理所有面向用户的字符串；语言检测为**响应*——每次渲染调用时重新检测，切换设置语言后立即生效，无需刷新页面
- 检测优先级：`localStorage('dsh-language')`（官方设置面板写入）`<html lang="...">` 属`navigator.language` 回退
- 设置页标题填充逻辑中的 `KNOWN_TITLES` 回退表（用于为无标题的第三方页面注入标题）现在支持中英文匹配，且每次调用时重新获取，语言切换后注入的标题也会更新
- 中文环境下无任何视觉或行为变化；英文环境不再出现中英混杂的标签
### v0.8.1 已发布（2026-08-27
**修复（跨插件宽度卫生 @omdsh-dev/dsh-genui render_ui 面板与工具卡片）*
- 根因：`.panelToggle` 标题 span（长 nowrap 文本，如「opencode-go Key 迷你最终架构」）flex 子项却缺 `min-width:0`，flex 默认 `min-width:auto` 不允许收标题 max-content 宽度把折叠条与面板一起撑出对话列。harmonizer hash 无关属性选择器补 `flex:1 1 0%; min-width:0`（ellipsis 生效）；同类（`.toolFallbackMeta`、`.tlTime`）一并覆盖。纯 CSS 覆盖、零侵入 dsh-genui 源码
- 最终基准（定）：面板宽度 = **对话内容宽度**（`--enhancer-content-width`，当840px，与官方 `Md3f7G_column` 一致），`[data-genui-panel]{ display:block; width:100% !important; max-width: var(--enhancer-content-width, 748px) !important; margin:10px auto 2px !important; contain:inline-size }`，随「对话列最大宽度」滑杆即时自适应；此前「实测输入框宽」方案废弃（基准偏差）。教训：`width:auto + margin:auto` 会在 flex 交叉轴触shrink-to-fit 竖线回归，必须显`width:100%` 再叠max-width
- 横贯块左右间距：`banner` 与折叠条复用同一宽度格式（内容宽 + 16px 左右内缩，不向外扩盒）；`steps` 在无容器 padding 的内工具卡内16px；svg/pre/canvas/img/mermaid 全部限宽护栏；块组件（callout/card/list）不动
### v0.8.0 已发
**新功能（原生 title 悬浮提示统一）：**
- 仅依赖裸 HTML `title` 属性的元素（模型选择trigger 及其他直接用 title 的官方控件）此前弹出的都是系统默认样式的悬浮提示，与走官Tooltip 组件的所有表面不在一个视觉语言里。现在悬键盘聚焦时接管：title 在交互期间被暂时摘除，同文案以官方气泡重绘——`--dsw-alias-tooltip-bg` 深色底px 7px 内边距px 圆角3/20 字号0vw 宽度上限；悬浮延500ms、键盘聚焦立即显示；锚点下方 8px 放置（下方放不下自动翻转到上方）、距视口边缘 12px 钳制、处z-index 100 弹层带
- 回退安全：任意祖先携`data-enhc-no-tooltip` 即整棵子树退出统一；摘除的 title 在离开/失焦/插件停止时原样恢复（应用若在悬浮期间重写title 则保留新值）；淡入动画尊prefers-reduced-motion
**修复（toggle 按钮簇座位）*
- better-sidebar 浮动按钮簇获`bg-base` 不透明座位。默认（面板关闭）：整高块，覆盖会话 header 整个横带（top 0 56px），按钮/座位/header 读作同一条右侧边缘，widgets 组件列卡片不再透出。better-sidebar 右侧面板打开时（client 半边同步的根`html.enhc-panel-open`）座位收回到紧凑浮动形态——面板顶边设计上低于页顶，整高座位会探进面板预留角
**修复（圆角卡片包裹会header）：**
- AppFrame shell.overlay 出口自身就是 z-20 层叠上下文，画在里面的卡片装饰永远盖不过 z-21 的会header。零像素分工绘制模型（无任何白色卡底）：header 自己INSET box-shadow 画卡片上沿线（真 border-top 会让 header 长高 1px、与流外控件错位 左上 18px 圆角；悬浮层盒子退化为覆盖「header+内容」的纯投影投射器，改用强调左/上方向的定制阴影配方——官lv3 偏移向右下且其贴边接触晕会沿窗缘拉出一条多余暗线。无会话 header 的路由回退为经典自绘卡片。hover/激活填充照旧画在座位之上；座位顶部延续 header 上沿线，整卡宽度内边线读作一条不断线
### v0.7.1（并v0.8.0**修复（better-sidebar Files 标签栏）*
- 📏 标签现在撑满 44px 标签栏：此前固定 `height: 36px` 破坏better-sidebar 原生`align-items: stretch` 链条，在栏底留下8px 空白。改`height: auto` + 显式 `align-self: stretch`—4px 标签文字与图标仍在更高的栏内垂直居中
- ↔️ 右面板打开时标签栏右端让位 72px 90px：toggle cluster 变大后（两个 32px 胶囊 + 6px 间隙、`right: 12px` 起共 82px），旧让位会让最右侧标签 / + 按钮滑到胶囊下面0px = 82px cluster + 8px 呼吸空间。底部面板的 40px 让位不受影响
- 🧭 会话 header 的共享右外边距由 82px 90px，与加大后的 cluster 对齐（覆盖折叠态角部座位与打开面板`max()` 两种路径）
**修复（深色模式激活态文字）*
- 激活的「对话」标签在深色模式下改为蓝色填+ 白色文字。此前用的是 `--dsw-alias-label-primary-inverted`，在深色主题下解析为近黑bluish-800——蓝底黑字
- 激活的「组件」胶囊保留插件自带的正确搭配（`state-business-primary` + `#fff`）：此前本插件的一条覆盖把白色换成了同一近黑 token（仅深色下出现）。该覆盖已删除，两个按钮在明暗两种主题下均呈现「品牌蓝填充 + 白字」，与官方导cell 的范式一致
### v0.7.0
**元信包名改为 `dsh-ui-harmonizer`*
- 📦 npm 包由 `harness-ui-enhancer` 更名`dsh-ui-harmonizer`（dsh 前缀 + harmonizer 命名贴合生态惯例与检索；旧包deprecate 并指路）
- 🎯 定位：「为 DeepSeek Harness 打造界面规范化与协调层」——把 UI 规范调和进官方设计语言（不只是美化）
- 🔀 GitHub 仓库`Physicolor/harness-ui-enhancer` 更名`Physicolor/dsh-ui-harmonizer`（旧链接自动跳转，star/issue 保留）
- ♻️ 安装命令：`dsh plugin --profile web add dsh-ui-harmonizer`。无数据影响（纯 client 插件，无持久化键）
### v0.6.2
**修复*
- 🧱 会话顶部栏获得不透明卡片表面（`--dsw-alias-bg-base`），并提升到 shell overlay 层之1 级（`z-index: 21`，仍低于 better-sidebar 面板 40 与弹窗）：dsh-widgets 组件栏及其悬浮放大层将滑入顶部栏白色矩形之下，不再与顶部按钮视觉重叠。顶部栏规则统一enhancer（widgets 插件不再插手官方元素）
### v0.6.1
**修复*
- 🧩 侧栏打开时「对输入框与右侧面板之间的大段空隙」：修复对话`margin-right` 的二次挤压。此前对 `#root` 的中和只清掉`margin-right`，却保留better-sidebar 同规则里`width: calc(100% - var(--dsh-sidebar-width))` —width 挤压把整列先缩到面板左缘，viewArea/composerSeat margin 挤压再叠一遍，对话比面板多让出一个整面板宽。现`width: 100%` 完整中和 `#root`，内margin 成为唯一、正确的挤压（对话右缘贴合面板左缘，仅剩 scrollbar 8px 沟槽）
### v0.6.0
**移除*
- 🗑移除 MCP 服务器管自动化任务调度：这两项本不属UI 强化"范畴，从插件中整体删除（host half 相关 API 路由随之删除，插件回归纯 client、零 host 逻辑）。左下角不再MCP / 自动化按钮
**新功能：**
- 🃏 圆角卡片：对话区域显示为左上圆角的卡片并附投影（设置 通用设置 界面定制 圆角卡片）。不改任何源码：`shell.overlay` 挂透明覆盖层（顶边+ 左上圆角 + `--dsw-shadow-lv3` 投影）；阴影向左溢出到侧栏（形成卡片厚度），顶部下移 1px 给投影留缝；下为窗口自然边界、不画边框；左侧不分界线：借用侧栏自身`border-right` 作卡片左边界；覆盖层`ResizeObserver` 跟踪中间列，侧栏拖拽/折叠/详情列开合自动跟随；内容左上角由中间列自`border-radius` 蒙成圆角，与覆盖层同半径；纯 CSS 门控（`html.enhc-center-card-on` 类），可随时关闭、卸载零残留
**修复*
- 🎚界面定制开关实时反馈：圆角卡片开关改为本地镜像状态，按下瞬间 thumb 滑动 + 底色翻转，无需等待重渲染
### v0.4.1
- 🎯 better-sidebar toggle 按钮 relocate header utilities 区域（CSS 悬浮对齐
- 📐 header `max()` 共享宽度：sidebar 关闭时让80pxtoggle cluster，打开时跟sidebar 宽度
- 🎬 header `margin-right` 添加平滑过渡动画
- 📏 better-sidebar tab bar 高度调整4px，内部元素按比例放大
- 🔧 更新 better-sidebar hash 前缀 `W-zNGW` `nArs4W`
- 📐 panel 顶部定位改为 `top: 6px`

### v0.4.0
- 🔌 MCP 服务器管理面
- 自动化任务调度（周期/间隔/单次
- 💬 提示词输入框复用聊天样式
- 🎨 弹窗高斯模糊 + 平滑动画
- 改进：MCP/自动化弹窗移除左侧导航栏；单次执行改为选择未来时间

### v0.3.0
- 设置页自动规范器上线
- better-sidebar、dsh-widgets 视觉协调
- 顶部栏单行化
- 深浅主题自适应

### v0.2.0
- 对话宽度、字号、字体可
- 工作区字号缩
### v0.1.0
- 初始版本

---

## License

[MIT](LICENSE)