前言¶

在 DeepSeek Harness（DSH）里做智能体开发，长会话里往往会堆满工具调用、思考过程、按步展开的执行记录。这些行对排错有用，但日常阅读会把正文撑得很长。DSH 自带「工作详情」四档（精简 / 标准 / 详细 / 冗长），需要进设置 → 通用里改 transcriptView。若你只是偶尔想「看一眼结果、少看日志」，反复切设置并不顺手。

社区插件 clear-ui（维护者 HoaXQuill，分类：客户端）在输入框上方加一个「清爽」开关：一键把会话正文切到内置「精简」形态，再点一次回到切换前的档位。它不重写渲染，只读写 Host 已有的 ui-chat.transcriptView。

这是什么¶

clear-ui 是 DSH 客户端插件：在 conversation.input.dock 槽位注册一个切换控件，把 transcript 切到 DSH 内置 compact 工作详情视图（并可恢复）。仓库：https://github.com/HoaXQuill/clear-ui，许可证 MIT，当前 package 版本 0.1.0。SkillHub 目录页：https://www.skillhub.cn/plugins/HoaXQuill/clear-ui（社区站点，与 DeepSeek / 幻方无官方从属关系）。

核心功能¶

下面分点说明已文档化的行为（以仓库 README 为准）。

清爽开 / 关与档位¶

1. 清爽 · 开：transcriptView = "compact"。进行中的回合不再逐条展开工具行；历史回合按分组折叠，只留结果。
2. 清爽 · 关：回到切换前那一档（默认「标准」）；回退档写在 localStorage["clear-ui:prev-transcript-view"]。
3. 你在设置页改「工作详情」档位时，按钮状态会跟随 Host 设置实时更新。
4. 设置尚未加载完或当前不可写时，按钮置灰并给出原因，不会假装切换成功。

槽位与横排样式¶

• 槽位：conversation.input.dock（list / session 作用域），注册 id clear-ui，order 41。
• 与「追问澄清」「复盘本会话」等 dock 条目并列。插件在 apply() 里向 <head> 注入样式 id clear-ui-dock-row，把 div[data-slot="conversation.input.dock"] 从默认的纵向占行改成横排 flex，槽位内条目宽度按内容自适应，放不下才换行。

实现边界¶

• 只切档，不改 DSH 行渲染：折叠策略由 @deepseek-ai/dsh-client-ui-chat 的 POLICIES 决定。
• 浏览器侧通过 ctx.configForms.get("ui-chat") 订阅并写入，不直接碰 remote.settings；Host 侧 lib/index.js 为空壳，用于加载 lib/client.js。
• 横排样式作用于整个 dock 槽位：同槽位里若有待办、队列等面板型条目，也会进同一行并按内容收缩。
• 若 Host 禁用设置持久化（非 loopback 页面），writable 为 false，按钮禁用，属设计行为。

安装与启用¶

安装命令须指向本包 package.json 所在目录，任选一种来源。

克隆仓库后从本地路径安装（示例）：

git clone https://github.com/HoaXQuill/clear-ui.git
dsh plugin add file:<clone 出来的目录> --profile desktop

若本地已有副本，可直接：

dsh plugin add file:C:/Users/HoaXQ/Desktop/插件/clear-ui --profile desktop

安装后重启 DSH（客户端插件在启动时扫描并加载；改 lib/client.js 后同样需要重启）。运行环境要求 Node >=20（见 package.json 的 engines）。

开发时若用 dsh plugin add 装进 profile，编辑器保存可能切断硬链接；改完 lib/*.js 后需重跑 dsh plugin add 或 npm run sync，再重启 DSH 或刷新窗口。

典型用法¶

1. 按上一节安装并重启 DSH，打开任意会话。
2. 在输入框上方 dock 区域找到「清爽」开关。
3. 开启：会话正文按「精简」工作详情展示，日志类行收成精简形态。
4. 关闭：恢复你开启前的档位（未切换过则多为「标准」）。
5. 也可在 设置 → 通用 → 工作详情 中改四档；按钮会与设置页保持同步。

本地自测（维护者提供的命令，不要求终端用户必跑）：

node test/smoke.mjs        # Host 半边
node test/client-smoke.cjs # 浏览器半边
node scripts/sync.mjs      # 同步进 profile

适用场景与注意¶

适合谁：经常在 DSH 桌面端长聊、又需要偶尔「少看工具日志、多看结果」的开发者；不想每次进设置改「工作详情」档位的用户。

权限与安全：插件以当前 DSH 进程在浏览器上下文中运行，读写的是 UI 配置与 localStorage，不替代你对第三方插件源码与 MIT 许可证的自查。安装前可在 GitHub 阅读 lib/client.js 与 cordis.patch.yml。

兼容性：若未来 DSH 改掉 ui-chat / transcriptView 字段名，按钮会进入「设置不可写」或「仍在读取」状态而非静默失败，届时需改 lib/client.js 中的 NS / FIELD。

结尾¶

clear-ui 的价值很直接：在 composer 上方多一个切换器，复用 DSH 内置 compact 工作详情，少动设置、少改渲染。需要源码与问题反馈见 GitHub：https://github.com/HoaXQuill/clear-ui；社区索引见 https://www.skillhub.cn/plugins/HoaXQuill/clear-ui。