dsh-simplify-theme

给 DeepSeek Harness 的极简主题，外加一组界面增强。

主题部分只做一件事：在当前配色之上叠一层 token，压掉装饰性噪音——去投影、去毛玻璃、 收紧圆角、气泡与交互态中性化。交互增强部分全部在浏览器侧完成，不新增 Host 行为， 禁用插件即完全还原。

• 版本：0.3.7
• 环境：DSH ≥ 0.2.0；运行时需要 react / react-dom（由宿主 ModuleLoader 提供）

当前界面

侧栏、权限和设置截图来自启用插件的隔离 DSH 预览； 模型、思考等级及委派图通过当前源码组件在浏览器中渲染，使用演示目录与状态，图内已注明。 截图采用浅色主题，不代表深色主题的验收结果。

模型选择按供应商分列并着色，思考等级独立展开：

权限入口在输入框右下方，模型与思考等级在左下方。隔离预览未配置模型凭据， 所以这里的思考等级显示「不可用」：

工作步骤折叠后仍可看到按批次分开的委派摘要；下图展示展开和收起两种状态（演示数据）：

设置面板展示当前主题的圆角、描边与中性交互态：

安装

# 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.7/dsh-simplify-theme-0.3.7.tgz

把 desktop 换成你实际使用的 profile（dsh web 默认是 web）。首次安装后需要重启 DSH； 之后的代码改动只需 pnpm build + 刷新页面，不必重启整个应用——插件包是页面加载时读取的。

激活时控制台会打印一行 [dsh-simplify-theme] 已加载构建 <版本+构建时间>，并写到 <html data-dsh-simplify-build>。界面没变化时先比对这行，确认加载的是最新构建。

主题层

src/client/tokens.ts 是主题的唯一事实源，通过 ctx.theme.overrideTokens(source, tokens) 叠层，每个 token 给出 { light, dark } 一对值。当前覆盖 25 个 token，分四组：

组	覆盖内容
圆角	--dsw-corner-shape 回到 round；xs/sm/md/lg/xl/panel 分别为 3/6/8/12/16/20px
阴影	四档 shadow 全部 none；panel/prominent/soft 三档 elevation 退化为发丝描边
菜单	关闭 --dsw-menu-backdrop-filter，菜单与分组头改不透明实底
交互与内容	hover/active 改中性灰；气泡、引用气泡、代码块、行内代码改中性底

语义色（品牌蓝、状态色、焦点环）和字号一律不动，因此亮/暗/跟随系统都能直接生效。 未覆盖的 token 继承内置值，DSH 升级新增 token 时不需要跟进。

交互增强

以下功能全部在 Client 侧用 DOM 注入或 slot 注册实现，没有对应的 Host 代码。

侧栏归档分页

「工作区」标题下方两页 tab（未归档 / 已归档）。点击写回原生视图状态 uiWorkspace.view.setArchivedFilter('default' | 'only')，高亮从 dsh.workspace.view.v5 轮询同步，因此原生「视图选项」里的手动切换也能反映出来。

侧栏筛选行

用一个固定高度的输入行替换原生的搜索按钮与视图过滤按钮（这两个原生控件被隐藏）：

• 输入即筛选已渲染的会话/工作区行；命中会话时保留其工作区组头，命中工作区时保留组头本身
• 右侧下拉写回原生分组状态 uiWorkspace.view.setGroupBy('workspace' | 'workspace-tree' | 'flat')
• Escape 清空并收起筛选

工作区列表排序、置顶与折叠

• 排序：置顶组优先，其余按「当前分页内会话的最近 updatedAt」降序；没有可用会话时用工作区 createdAt。归档页按归档会话的时间单独计算。
• 折叠：默认只显示最近活跃的 5 个普通工作区，更多收进「还有 N 个工作区」；置顶不占额度； 筛选时临时展开被折叠的组。
• 置顶：表头「置顶」按钮打开浮层（挂在 body 上，不受侧栏 overflow: hidden 裁剪）， 选完自动收起，Escape 或点外部关闭。
• 徽标：工作区行右侧显示当前可见会话数，悬停提示同样内容。

输入框下方的控件条

模型、思考等级、权限三颗控件移到输入卡片下方的 dock 行：模型与思考等级在左，权限在右， 原生 tps / Token 用量 / 上下文统计保留在中间。

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

底部栏平铺上下文与真实 TPS（取代弹窗胶囊）

参考 PI-Desktop 的上下文指标设计，将原生需要点击弹出的统计胶囊（ActivityPill / UsagePill）与抽象的上下文环替换为输入框下方的平铺状态流：

• 上下文容量：直接平铺 已用 / 窗口上限 (百分比)（如 121k / 500k (24%)），告别看不清上限的盲盒感；超过 75% 预警黄、超过 90% 警戒红
• 真实端到端 TPS：严格将首字延迟（TTFT，包含排队与推理思考等待）计入总耗时，彻底消除仅统计吐字片段导致的虚高数值（如原本虚高标出 200+ t/s，真实端到端显示为 27.2 t/s）
• Prompt 缓存命中率：保留按数值颜色分级（≥80% 绿、≥50% 橙、其余红）
• 最新一轮耗时：实时展示最新单轮总等待时长（如 4.2 秒）
• 悬停 Tooltip：鼠标悬停在各段上可查看完整 Token 构成（输入/输出/缓存读取明细）与延迟拆解（首字延迟与纯吐字速率）

每轮耗时

一轮结束时在回复操作行的最右侧追加「· 耗时 12.3 秒」。计时来自会话 running 状态翻转的 墙钟时间（<1s 显示毫秒，>1min 显示分秒）；DOM 未就绪时按 0 / 120 / 400ms 重试写入。

子代理委派图

委派摘要放在相应工作步骤折叠区之外，即使收起步骤也可见。每批默认显示一行状态摘要，点击展开单层图 （结构参考 PI-Desktop 的 SubagentTopology）：左侧「主 Agent」卡片 → 连接线 → 右侧子代理节点。 同一折叠区内的多批摘要按顺序排列在该区之后，不一定保留每次调用的精确原始位置。

• 分组：同一回合内连续出现的委派算一批；中间夹了别的工具调用就另起一张
• 节点：状态角标、名称（单行省略，完整名在提示里）、模型、思考等级、状态·耗时、步数； 失败节点红字显示错误原因（取自工具行的错误输出）；运行中节点带旋转指示与「停止」
• 状态：已完成 / 运行中 / 失败 / 已拒绝；点击节点进入对应子会话
• 连线：按真实几何绘制（SVG），主干覆盖首末分支，主 Agent 横线固定在主干正中
• 支持 subagent、subagent_fork 与 spawn_teammate 等委派工具；原生工具行被卡片取代（display: none，插件禁用即恢复）
• 数据：优先通过显式 UUID 与描述匹配，宿主折叠时按会话目录创建时序单次认领；节点缺统计时主动调一次 sessions.refreshProjections(父会话) 补齐

文案本地化

插件自带中英文字典并注册给宿主 locale。宿主未解析某个键（返回键名）时使用内置文案，并在 控制台告警一次，因此界面不会出现 filter.placeholder 这类内部键。档位名（minimal / low / high…）与内置供应商名也做了中文映射。

数据与本地存储

键	用途	写入方
dsh-simplify-theme.pinned-workspaces	置顶的工作区 id 列表	插件
dsh-simplify-theme.workspaces-expanded	是否展开全部工作区	插件
dsh-simplify-theme.usage	本地累计的模型选择次数（排序权重）	插件
dsh-simplify-theme.debug	设为 '1' 时打印委派图扫描统计	手动
dsh.workspace.view.v5	归档过滤、分组方式（宿主视图状态）	宿主；插件只调视图方法
dsh.sessions.current	当前会话 id（只读）	宿主

本地存储只保存上述偏好与计数，不包含会话内容。清理浏览器数据会重置本地计数，排序退回 会话统计。

工作原理

• 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 / 外点关闭兜底

开发

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

路径	作用
src/host/index.ts	空 Host 插件
src/client/index.ts	Client 入口：注册字典、token 层、样式与各项注入
src/client/tokens.ts	主题的唯一事实源，所有覆盖值在这里
src/client/styles.ts	全部运行期样式（dock、侧栏、委派图、统计着色…）
src/client/sidebar-*.ts	侧栏分页、筛选、排序/置顶/折叠
src/client/model-*.ts、permission-*.ts	模型与权限控件、目录数据、本地化映射
src/client/delegation-*.ts	委派图的几何、分组与节点渲染
src/client/turn-duration.ts、stat-colors*.ts	回合耗时与百分比着色
src/client/usage-*.ts	模型使用频率统计与排序
tests/client/	纯逻辑单测（token 形状、排序、解析、格式化等）
cordis.patch.yml	bundle patch，插入 simplify-theme 条目

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

调试委派图：控制台执行 localStorage.setItem('dsh-simplify-theme.debug','1') 后刷新， 每次扫描会打印「工具行 N 条，已匹配 M 条，会话 」。

License

MIT