前言¶

DeepSeek Harness（下称 DSH）的理念是「一切皆插件」。这套设计给了足够的灵活度，但门槛也留在了界面上：一次任务里，模型会连续调用一串工具，原生界面上相应滚过一长串工具卡片，术语、参数、状态混在一起。想先用起来的人，很难从中读出「这轮到底做了什么」；熟悉它的老手又需要完整信息，不希望界面被简化。原生界面只有一种读法，两拨人只能迁就同一种呈现。

dsh-prism 针对的就是这一点：给 DSH 的 Web UI 加了两档模式，「简化」给想省事的人，「原生」原样还给老手，一键切换，不用的时候卸掉也不留痕迹。下面介绍它的功能、安装和用法。

这是什么¶

dsh-prism 是一个 DSH 客户端类插件，由 KhalilYamber 维护，MIT 许可证，当前版本 1.2.0（2026-08-18）。一句话定位：DSH 界面两档模式插件，简化 / 原生一键切换，工具卡片白话化，降低 DeepSeek Harness 的上手门槛。

默认处于原生档，产品界面原样呈现；切到简化档，插件才开始接管界面。切换即时生效，不需要刷新页面。

核心功能¶

左下角悬浮入口¶

启动 Web UI 后，左下角会出现一个悬浮按键，显示当前所处模式。点开菜单可以在「简化 / 原生」之间切换，菜单里还有一个「隐藏复杂工具」开关。切换即时生效，无需刷新。

简化档：工具调用收成折叠组¶

简化档的核心是折叠组。归组规则：一次 user turn 内、模型正式回复之前的全部工具调用算一组。收起时只显示一行统计「N 个工具 · M 次思考」，行尾带组状态：✓ 完成、● 运行中、✕ 有出错。

文档化面板与交付文档¶

点开统计行，展开一个文档化面板，分三块：

1、标题区：显示「本次调用 N 个工具 · M 次思考」；
2、清单区：每个工具一行，类别图标 + 白话动作/参数摘要 + 状态图标；
3、说明区：补充说明。

再点单行，可以展开该工具的「交付文档」详情：结果先脱敏，再按 Markdown 子集渲染，支持表格、代码块、标题、列表、粗体、行内代码与 commit 哈希高亮；任何解析失败都退化为纯文本。

隐藏复杂工具¶

简化档面板内，21 个高级工具（目标/计划、子代理编排、后台任务、插件系统）默认折叠成一行白话摘要，点开可以看详情。这个行为由菜单里的「隐藏复杂工具」开关控制，默认开启，可随时关闭。

白话文案与双语界面¶

白话文案来自一张 33 个工具的规则表，例如 pwsh 显示为「正在电脑上执行一条命令」。v1.0.0 起，19 个没有原生卡片的工具由插件卡片接管；v1.1.0 起，折叠组内的所有工具——包括官方已有产品级卡片的 read、write、web_search——统一按白话规则渲染，原生档下它们仍是产品原版卡片。

界面文案全部跟随 DSH 的界面语言（简体中文 / English），在设置里切换语言即时生效，无需刷新。这是 v1.2.0 加入的能力。

数据脱敏¶

简化档的详情展示做了三层脱敏：

• 路径类参数只显示文件名（file_path 取 basename）；
• token、secret、password、api_key、authorization 等敏感参数名永不展示；
• 结果文本中的常见密钥形态（sk-xxx、Bearer xxx、key=xxx）替换为占位符。

详情面板只展示白话摘要与脱敏结果，不暴露原始参数。

原生档与设计原则¶

原生档下插件不注册任何工具卡片，产品原貌原样渲染，切换即时生效。几条贯穿的设计原则：

• 纯展示层：只改界面呈现，模型收到的输入输出与原生完全一致，不影响 agent 干活；
• 内存态切换：档位存在内存里，刷新页面回到原生档；卸载插件后，界面回到出厂状态，无配置污染、无残留；
• 跟随主题：全部使用官方 --dsw-alias-* 设计变量，明暗主题自适应。

实现上补充一句：简化档通过在 conversation.chat.node 槽位以 priority: -1 shadow 产品自带的 ToolCallTree 渲染器实现归组，原生档则完全不注册；全部客户端逻辑集中在 lib/client.js，改完刷新页面即生效。

安装¶

前置只有一个：装好 DeepSeek Harness（Node.js 22.19+ 或 24+）。插件自身声明了两个 peerDependencies：react ^18.2.0、@deepseek-ai/cordis ^4.0.1。

插件未发布到 npm，通过仓库克隆或 Releases 产物分发。先克隆仓库：

git clone https://github.com/KhalilYamber/dsh-prism.git

然后以本地路径安装，把 <本仓库目录> 换成刚克隆出来的路径：

npx -y @deepseek-ai/dsh plugin --profile web add ./dsh-prism

这一步把插件以 web profile 装进 DSH。如果不想克隆仓库，也可以直接从 GitHub Releases 下载打包产物。装好后启动 Web UI，左下角会出现悬浮入口。

典型用法¶

经过上面的步骤，插件已经可用，日常操作如下：

1、启动 Web UI，点击左下角悬浮按键（显示当前模式）；
2、选择「简化」：一次任务里的工具调用归成折叠组，收起是一行统计，点开展开面板看每个工具的白话行与交付文档详情；
3、菜单里按需开关「隐藏复杂工具」（仅简化档生效）；
4、想看完整信息时选「原生」，恢复完整原生界面；
5、刷新页面回到原生档。

适用场景与注意¶

适合谁：

• 刚上手 DSH 的用户：简化档把一次任务的工具调用收成一行统计，想知道细节再逐行展开；
• 需要演示或复盘流程的场景：文档化面板和交付文档比原始工具卡片好读；
• 老手不受影响：默认就是原生档，切过去也是零改动。

使用前注意：

1、插件以当前 dsh 进程的权限运行，安装任何第三方插件前都应检查源码与许可证。dsh-prism 是 MIT，实现集中在 lib/client.js 一个文件，方便通读；
2、档位不持久化：刷新即回原生档是刻意设计，想持续用简化档，每次打开页面需要重切一次；
3、简化档只改你看到的界面，模型收到的输入输出与原生完全一致，不会影响任务结果。

结语¶

dsh-prism 不改变 DSH 的工作方式，只改变人读界面的方式：新手看白话折叠组，老手要完整原生呈现，两档一键切换，卸载后无残留。如果你正被 DSH 的上手门槛劝退，或者想给团队里的新手一个更平缓的入口，可以从下面两个地址开始：

• GitHub 仓库：https://github.com/KhalilYamber/dsh-prism
• 社区插件目录收录页：https://www.skillhub.cn/plugins/KhalilYamber/dsh-prism （社区独立站点，与 DeepSeek 官方无从属关系）