DeepSeek Harness 极简主题插件

前言¶

DeepSeek Harness（DSH）在智能体开发流程中承担调度与编排角色，但原生界面在大量会话与子代理调用场景下容易变得杂乱。本插件在 DSH 原有配色之上叠加一组主题 token，压掉装饰性噪音，并补充一批在浏览器侧实现的交互增强功能。禁用插件即可完全还原原生界面。

插件定位¶

• 名称：dsh-simplify-theme
• 维护者：zdt3476
• 版本：0.3.2
• 环境：DSH ≥ 0.2.0；运行时需要 react / react-dom（由宿主 ModuleLoader 提供）

核心功能¶

主题层¶

主题层通过 src/client/tokens.ts 叠层覆盖 25 个 token，分四组：

语义色（品牌蓝、状态色、焦点环）和字号不覆盖，因此亮/暗/跟随系统主题能直接生效。

侧栏增强¶

• 归档分页：在「工作区」标题下方两页 tab（未归档 / 已归档），点击写回原生视图状态 uiWorkspace.view.setArchivedFilter('default' | 'only')。
• 筛选行：用固定高度输入行替换原生搜索按钮与视图过滤按钮，输入即筛选已渲染的会话/工作区行；右侧下拉写回原生分组状态 uiWorkspace.view.setGroupBy('workspace' | 'workspace-tree' | 'flat')；Escape 清空并收起筛选。
• 工作区列表排序、置顶与折叠：
• 排序：置顶组优先，其余按当前分页内会话的最近 updatedAt 降序；没有会话时用工作区 createdAt；归档页按归档会话的时间单独计算。
• 折叠：默认只显示最近活跃的 5 个普通工作区，更多收进「还有 N 个工作区」；置顶不占额度；筛选时临时展开被折叠的组。
• 置顶：表头「置顶」按钮打开浮层（挂在 body 上），选完自动收起，Escape 或点外部关闭。
• 徽标：工作区行右侧显示当前可见会话数，悬停提示同样内容。

输入框下方的控件条¶

• 布局：模型、思考等级在左，权限在右；原生 tps / Token 用量 / 上下文统计保留在中间。
• 入口规格：与宿主原生 seat 同规格（28px 高、13px 字号、透明底无描边），悬停或展开才出现浅灰底 / 品牌色淡染；模型入口带供应商色点。
• 模型面板：按供应商分列，每列一个专属色；默认只显示模型名，同名模型跨供应商时加 供应商 / 前缀；完整名称在悬停提示里；面板打开时按使用频率重排（权重 = 会话列表里用过该模型的会话数 + 本地选择次数）。
• 思考等级：range 滑块带填充轨道，标题行显示当前档位；供应商未声明默认档位时保留「默认」档位；切换模型会沿用原档位，目标模型不支持时回落到它自己的默认档位。
• 权限：与原生选择器同源（同一 permissionPresets.catalog RPC、同一 /permission 提交通道），完全权限 / 自动审查保留两步确认；按风险只染色圆点，完全权限额外把文字标红。
• 几何：控件行宽度由运行时读取输入卡片实际宽度决定（ResizeObserver 写入 --dsh-simplify-card-width），左右各内缩「卡片圆角半径」的距离与圆角末梢对齐，距卡片 5px、距窗口底边 16px。

统计着色与回合耗时¶

• 缓存命中 [data-composer-stat="usage"] 里的「缓存命中 N%」：≥80% 绿、≥50% 橙、其余红。
• 上下文环的 N%：≤50% 绿、≤75% 橙、其余红；环的描边与数字同色。
• 回合耗时：一轮结束时在回复操作行最右侧追加「· 耗时 X 秒」；计时来自会话 running 状态翻转的墙钟时间（<1s 显示毫秒，>min 显示分秒）；DOM 未就绪时按 0 / 120 / 400ms 重试写入。

子代理委派图¶

• 结构：每一批委派在它发生的位置画一张单层图，左侧「主 Agent」卡片 → 连接线 → 右侧子代理节点。
• 分组：同一回合内连续出现的委派算一批；中间夹了别的工具调用就另起一张。
• 节点：状态角标、名称（单行省略，完整名在提示里）、模型、思考等级、状态·耗时、步数；失败节点红字显示错误原因；运行中节点带旋转指示与「停止」。
• 状态：已完成 / 运行中 / 失败 / 已拒绝；点击节点进入对应子会话。
• 连线：按真实几何绘制（SVG），主干覆盖首末分支，主 Agent 横线固定在主干正中。
• 原生 subagent 工具行被卡片取代（display: none，插件禁用即恢复）。
• 数据：会话列表快照（origin: 'subagent' + parentId + projectionValues）；工具行里拿不到子会话 id 时按快照顺序兜底认领；节点缺统计时主动调一次 sessions.refreshProjections(父会话) 补齐。

文案本地化¶

插件自带中英文字典并注册给宿主 locale；档位名与内置供应商名做了中文映射；宿主未解析某个键时使用内置文案，并控制台告警一次。

数据与本地存储¶

本地存储只保存上述偏好与计数，不包含会话内容。

工作原理¶

• Host 半（src/host/index.ts）：空插件，只为让 Loader 有条目并下发 dsh.client 清单。
• Client 半（src/client/index.ts）激活时注册五项：locale 字典、token 层、全局样式、侧栏注入、dock 控件；每一步用 step() 包裹，单步失败不影响其余功能。
• Client 半打成 CJS，用 window.__ModuleLoader__.load({ id, factory }) 包成浏览器插件包；React 不进 bundle，通过 require('react') 由宿主提供。

注入依赖的稳定钩子（DSH 大版本更新时优先检查这些选择器）：

[data-slot="sidebar.workspaces"]              侧栏列表插槽
[data-row-key^="workspace:"]                  工作区行
[data-slot="conversation.input.dock"]         输入区上方 dock
[data-composer-card] / [data-composer-dock]   输入卡片与控件行
[data-chat-turn] / [data-chat-node-key]       回合与聊天节点
[data-tool]                                   工具行（含 data-state）
[data-clock="end"]                            消息操作行

已知限制¶

• 主题只覆盖 token；组件里写死的颜色或阴影不会受影响。
• Appearance 设置里没有独立主题入口，这是 DSH 当前设置 schema 的限制（本插件走 token 叠层，因此也不需要在设置里选择）。
• 侧栏 tabs / 筛选 / 工作区排序、控件条、统计着色、回合耗时、委派图都依赖上表选择器；DSH 大版本更新可能需要跟进。
• 委派图只画一层父子关系，不显示子代理再委派的后代；状态只区分宿主暴露的运行中/已完成/失败/已拒绝，timed_out、aborted 等终止态在会话行里没有稳定字段，未做推断。
• 委派图依赖会话列表快照：从未打开过、且投影尚未拉取的子代理可能只显示标题与状态，统计会在补齐后出现；mode: 'external' 的子代理不会出现在快照里。
• 回合耗时是运行状态的墙钟观察值，包含排队与流式等待，口径可能和原生折叠行略有差异。
• 统计着色只作用于「缓存命中」标签与上下文环的百分比，其它数字不动。
• dock 弹层是自绘而非 MenuSurface，键盘导航由 Escape / 外点关闭兜底。

安装¶

# npm
dsh plugin --profile desktop add dsh-simplify-theme

# GitHub 源码
dsh plugin --profile desktop add git+https://github.com/zdt3476/dsh-simplify-theme.git

# 本地开发目录（link）
dsh plugin --profile desktop add link:"$PWD"

# Release 里的预构建包
dsh plugin --profile desktop add https://github.com/zdt3476/dsh-simplify-theme/releases/download/v0.3.2/dsh-simplify-theme-0.3.2.tgz

把 desktop 换成你实际使用的 profile（dsh web 默认是 web）。首次安装后需要重启 DSH；之后的代码改动只需 pnpm build + 刷新页面，不必重启整个应用——插件包是页面加载时读取的。激活时控制台会打印一行 [dsh-simplify-theme] 已加载构建 <版本+构建时间>，并写到 <html data-dsh-simplify-build>。界面没变化时先比对这行，确认加载的是最新构建。

调试委派图¶

控制台执行 localStorage.setItem('dsh-simplify-theme.debug','1') 后刷新，每次扫描会打印「工具行 N 条，兜底 M 条，会话 」。

开发¶

pnpm install
pnpm test        # 类型检查 + vitest（当前 59 项）
pnpm build       # 产出 lib/index.js（Host）与 lib/client.js（Client）
pnpm check       # test + build

调整主题：只改 src/client/tokens.ts，然后 pnpm build 并刷新页面。新增覆盖时注意——key 必须是 --dsw-*，值必须是 { light, dark }，优先引用语义 alias 而不是复制色值。

许可证¶

MIT