Physicolor/harness-ui-enhancer ↗★ 2
harness-ui-enhancer
Web UI polish layer for DeepSeek Harness: normalizes unfinished or self-contradictory official UI, reconciles style conflicts between installed plugins, and unifies the visual language — with live-customizable chat width, markdown font size, workspace scale and UI font stack from Settings → General, all following official design tokens. Client-only dsh bundle, zero model cost, removable without residue.
AI 분석
核心用途是为安装了众多插件的 DSH 提供一键式视觉美化与样式协调。适合希望界面视觉语言高度统一、且不希望增加任何模型开销的 Web 端用户。
설치
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:Physicolor/harness-ui-enhancerHarness UI Enhancer
美化你装了一堆插件的 DeepSeek Harness。
规范化官方界面 · 协调每个插件 · 全部可逆 · 零模型开销
快速开始 · 能力 · 原理 · 路线图 · License
一句话： 你装了一堆 DSH 插件，界面却风格割裂、按钮东一个西一个？Harness UI Enhancer 用「CSS 覆盖 + 运行时 DOM 协调」把它们拉回官方设计语言，不破坏任何插件源码、卸载即还原、零模型开销。
Harness UI Enhancer 是一个纯浏览器端（client-only） 的 DSH bundle 插件。它不新增模型工具、不改写会话日志，只通过官方 settings.section / settings.general.item 槽位与 --dsw-* 语义令牌体系调整界面。装上它，任何插件在你的界面里都会"更懂规矩"。
✨ 核心能力
| 能力 | 说明 |
|---|---|
| 🎨 官方 UI 规范化 | 修复官方界面中未完善、自相矛盾的设计（顶部栏单行化、设置页头、对话/轨迹选择器…） |
| ♻️ 插件视觉协调器 | 让 better-sidebar、widgets、以及任何第三方设置插件统一到官方视觉语言 |
| 🧹 设置页自动规范器 ⭐ | 自动扫描任意插件的 settings.section 表头：缺标题补标题、多余图标删除、标题/描述间距与格式统一 |
| 🌙 深浅主题自适应 | 全部走 --dsw-* 语义令牌，明暗主题自动跟随，不脱节 |
| 🧩 可逆 / 无侵入 | 覆盖式实现，卸载后浏览器完全恢复默认，绝不破坏对方插件源码 |
它具体帮你做什么
- 顶部栏单行化：对话/轨迹选择器移入标题行、做成互斥胶囊，header 收成单行，视觉重心更稳。
- 少分隔线、多层级：用背景层级/圆角/阴影/留白自然分区，替代生硬的 1px 分隔线。
- 按钮胶囊家族：Session log、组件胶囊、better-sidebar toggle、对话/轨迹 tabs——统一为同一族 32px 胶囊，激活态品牌色填充。
- 右侧栏贴边圆角矩形：better-sidebar 面板从"整页推挤"改为"覆盖式 + header 不动"，面板随 widgets rail 对齐。
- 设置页自动规范器：见下一节。
🧹 设置页自动规范器（v0.3 方向，当前已上线）
这是本插件的核心差异化卖点：任何第三方插件往 settings.section 里加页面时，只要没有严格按官方规范设计，Harness UI Enhancer 会自动把它拉回规范。
| 它自动检查并修正 | 做法 |
|---|---|
| 缺页面标题 | 若页面只有描述没有 ` |
| `，自动注入一个 18/600 的标题（取当前设置导航项名，取不到则由已知映射兜底） | |
| 标题旁多余图标 | 移除标题行里那个 logo/图标，让标题是干净的纯文字 |
| 标题/描述贴太紧 | 统一为官方 4px 间距 + 描述下方 hairline 收尾 |
| 字号/格式不统一 | 标题统一 18/600、描述统一 13/20 + border-bottom hairline |
详情与给插件作者的规范见
docs/settings-section-style.md（官方设置页表头设计规范，欢迎插件作者对标）。
不越界：只统一"表头"这一层的视觉；不重排你的内容区、不删功能性图标（只删标题行 logo）、不伪造描述文案。
🔧 工作原理
- 零模型开销：host（node）半是 no-op，全部改动发生在浏览器半；
- 官方设计令牌：所有样式走
--dsw-*语义令牌（背景、边框、阴影、品牌色），因此自动跟随 DSH 明暗主题，不会出现"插件样式与主题脱节"； - 两条注入通道：
- 静态规则（
enhancer.module.css）读取 `` 上的--enhancer-*自定义属性； - 动态 `` 标签重写
--dsw-font-markdown-*字体令牌（字体简写无法用自定义属性表达）；
- 静态规则（
- 可逆清理：插件停止/更新/卸载时，动态样式标签与根属性通过 fiber 的 effect disposer 一并移除，页面恢复原状。
🚀 安装
# 发布到 npm / 插件市场后
dsh plugin --profile web add harness-ui-enhancer
# 本地开发（link 方式，改动即时生效，client 改动无需重启）
dsh plugin --profile web add link:D:/dsh-home/plugins/harness-ui-enhancer
装完硬刷新浏览器（Ctrl+Shift+R）即可在 设置 → 通用设置 看到"界面定制"块，并让所有第三方设置页自动收敛到规范。
🗺️ 路线图
按"先官方、再插件、后风格"的顺序推进，每一阶段都保持可逆、只读协调、不破坏其它插件 DOM：
- 阶段一 · 官方 UI 规范化（进行中）：继续修复官方界面中未完善、自相矛盾的部分——设置页头只是第一步；
- 阶段二 · 插件兼容协调器（进行中）：检测并修复与其他插件叠加时的布局/样式冲突（右栏、侧边栏、浮层 z-index、重复页头、字体/间距令牌冲突等），以"已知冲突清单 + CSS 变量归一化 + 布局锚点协调"实现；
- 阶段三 · 统一视觉风格：在此之上提供可选的视觉风格层（间距密度、圆角、动效、配色微调），并探索其它 Agent 工具（如 Codex）的视觉风格移植；
- 阶段四 · 生态共建：把"官方 UI 修复 + 冲突协调"沉淀为可扩展的规则注册机制，让其它插件可以声明自己的 UI 兼容诉求。
🛠️ 开发
pnpm install
pnpm run build # tsdown 构建 lib/
pnpm run check # 类型检查 + 测试 + 构建（如有）
- 依赖的官方包（
@deepseek-ai/dsh-client-ui-slots、dsh-client-runtime）以peerDependencies声明，由 DSH web profile 提供； - 纯 client 插件：
cordis.patch.yml插入一行ui-enhancer行，浏览器半由dsh.client声明被 client-modules 扫描加载； - 修改后需同步：改 bundle 后
npx tsdown重建lib/client.js并同步到 profile 拷贝（profiles/web/node_modules/harness-ui-enhancer/lib/）；浏览器读 profile 拷贝而非源目录，服务端no-cache，无需重启 DSH，硬刷新即可。
✅ 兼容性
- DSH
0.1.0-rc.6及兼容的后续0.1.x； - 通过官方
settings.general.item/settings.sectionslot 接入，与 better-sidebar、harness-widgets、dshmarket 等插件按 slot 顺序共处； - 已知协调对象：
dsh-better-sidebar、harness-widgets、dsh-notification、dshmarket； - 卸载/禁用后页面完全恢复默认，无残留。
FAQ
会破坏其它插件吗？ 不会。所有协调通过 CSS 覆盖 + 运行时 DOM 协调实现，对方插件升级时最坏情况是我们的规则静默失效，绝不破坏它。
会不会拖慢 DSH？ 不会（零模型开销，浏览器侧纯样式/轻量 DOM 观察）。
有些插件我不想要它协调？
可以自行从 enhancer.module.css 里注释对应规则（覆盖式，逐条可选）。
📄 License
MIT