Physicolor/harness-ui-enhancer

Harness UI Enhancer

为 DeepSeek Harness 打造的界面美化与插件协调层。
规范化官方界面 · 协调每个插件 · 设置页自动规范器 · MCP 与自动化管理
A polish layer for DeepSeek Harness — normalizes official UI, reconciles plugin styles, and auto-fixes settings pages.

一句话： 你装了一堆 DSH 插件，界面却风格割裂？Harness UI Enhancer 用「CSS 覆盖 + 运行时 DOM 协调」把它们拉回官方设计语言——不破坏任何插件源码、卸载即还原、零模型开销。

TL;DR: You installed a bunch of DSH plugins but the UI looks inconsistent? Harness UI Enhancer uses CSS overrides + runtime DOM coordination to bring them back to the official design language — non-destructive, fully reversible, zero model cost.

Harness UI Enhancer 是一个纯浏览器端（client-only） 的 DSH bundle 插件。它不新增模型工具、不改写会话日志，只通过官方 settings.section / settings.general.item 槽位与 --dsw-* 语义令牌体系调整界面。

Harness UI Enhancer is a client-only DSH bundle plugin. It adds no model tools and modifies no session logs — it adjusts the UI purely through official slots (settings.section / settings.general.item) and the --dsw-* semantic token system.

当前功能 · Features

🎨 官方 UI 规范化 · Official UI Normalization

♻️ 插件视觉协调 · Plugin Visual Reconciliation

🧹 设置页自动规范器 · Settings Auto-Normalizer ⭐

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

🔌 MCP 服务器管理 · MCP Server Management

点击左下角 MCP 按钮：添加/编辑/删除/测试连接，配置保存在 ~/.dsh/mcp.json。

⏰ 自动化任务调度 · Task Automation

点击左下角 自动化 按钮：支持周期/间隔/单次三种调度模式，提示词输入框复用聊天样式。

🎛️ 界面定制 · UI Customization

设置 → 通用设置中的”界面定制”块：对话宽度、markdown 字号、工作区字号、UI 字体均可实时调节。

工作原理 · Architecture

• 零模型开销：host（node）半是 no-op，全部改动发生在浏览器半；
• 官方设计令牌：所有样式走 --dsw-* 语义令牌，自动跟随明暗主题；
• 两条注入通道：静态规则（CSS Modules）+ 动态 <style data-plugin> 标签；
• 可逆清理：fiber effect disposer 管理所有副作用，卸载即恢复；
• Slot 接入：settings.general.item / settings.section / sidebar.footer.action / shell.overlay。

安装 · Installation

# 通过 npm（插件市场）
dsh plugin --profile web add harness-ui-enhancer

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

安装后硬刷新浏览器（Ctrl+Shift+R），在 设置 → 通用设置 看到”界面定制”块。

开发 · Development

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/harness-ui-enhancer/lib/ → 硬刷新浏览器。

兼容性 · Compatibility

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

路线图 · Roadmap

• 阶段一 · 官方 UI 规范化（进行中）：继续修复官方界面中未完善的部分；
• 阶段二 · 插件兼容协调器（进行中）：检测并修复插件间的布局/样式冲突；
• 阶段三 · 统一视觉风格：可选的视觉风格层（间距密度、圆角、动效）；
• 阶段四 · 生态共建：沉淀为可扩展的规则注册机制。

变更日志 · Changelog