前言¶

DeepSeek Harness（DSH）在对话里会展示模型的 reasoning / thinking 内容，但默认预览往往是长段原始 trace，展开前很难一眼看出「这一步在干什么」。若你习惯 OpenAI Codex 那类「短标题 + 一两句说明、仍可切回原文」的呈现，原生 UI 不会自动替你生成这层摘要。

dsh-thinking-summary 是社区维护的客户端插件（作者 HUSTforever），在 Harness 自带的 thinking disclosure 里接入逐步推理摘要：用简短 action title 替换原始预览，展开后可见 1–2 句说明，并可切换回原始思考。回答、工具调用、图片、分组与 disclosure 行为仍走原生渲染器。

下面介绍插件定位、行为、安装与配置。事实以 GitHub README 为准；目录页见 SkillHub。

这是什么¶

插件一句话定位：Codex-style per-step reasoning summaries inside DeepSeek Harness’s native thinking disclosure（在 DSH 原生思考披露区域内，按步骤提供类似 Codex 的推理摘要）。

• 许可证：MIT
• 运行环境：Node.js ^22.19.0 || >=24.0.0；engines.dsh 要求 >=0.2.1-rc.2
• README 写明在 Harness desktop 0.2.1-rc.2 上做过测试
• 当前包版本（package.json）：0.3.0

0.2 起，摘要不再只是回合末尾卡片：会在每个 model step 过程中更新，step 落定后给出最终快照。0.3 起插件以可安装的 DSH bundle 发布（Release tarball 或 Git tag），无需把文件拷进 profile；摘要行为与 0.2 一致。

实现上接近 Codex 的展示方式，但 DeepSeek 侧仍需辅助模型请求生成摘要，因此延迟与流式行为与 OpenAI 原生 reasoning-summary 不同。README 指向 reasoning summaries 与 streaming events 作对照说明。

核心行为¶

更新节奏与请求¶

• 首次 live update：约 1.2 秒后，且源文本至少 40 个字符；宿主还会强制执行 minReasoningChars。
• 后续 live update：需间隔 8 秒且新增 600 字符；step 落定后会请求该步的最终快照。
• 辅助调用按页面串行；相同请求会合并（coalesce）。

界面呈现¶

• 摘要渲染在 reasoning 行下方的可见过程卡片上，不展开 disclosure 也能读正文；disclosure 仍保留短标题，并可切回原始 thinking。
• 历史行进入或接近视口时会自动回填；滚动时懒加载，而不是整段会话一次性批量生成。
• 摘要失败可重试；原始 thinking 仍可通过官方 reasoning body 槽位访问（含其他 body 展示类插件）。

语言与内容边界¶

• 默认跟随 DSH locale；可在插件设置里选摘要模型，语言设为 auto 跟随 DSH，或填 zh、en、zh-CN 等标签。
• Prompt 要求 action heading + 1–2 句，并 grounded 在用户请求、工具活动/结果与回答上，而不是只复述私有 trace。
• 不修改 session 事件或模型可见消息；浏览器侧仅为 reasoning 块创建展示用副本。

与旧版差异¶

旧版在最终回答下方有 end-of-turn 卡片；0.2 起改为逐步更新。README 说明新格式不会复用旧的回顾式摘要缓存。

安装与启用¶

插件以 DSH bundle 安装：manifest 指向 cordis.patch.yml，插件管理器会下载包、加入 profile 的 bundle 列表并应用默认项，无需手动改 profile、也无需拷贝文件。Bundle 自带默认（language: auto、thinking: off、maxChars: 600），一般不必再往 profile 的 cordis.patch.yml 里追加配置。

桌面 / Web：插件页¶

1. 侧栏打开 Plugins。
2. Add plugin → Install a third-party plugin。
3. 粘贴下列其一：
   - Release tarball：
   https://github.com/HUSTforever/dsh-thinking-summary/releases/download/v0.3.0/dsh-thinking-summary-0.3.0.tgz
   - Git tag：
   github:HUSTforever/dsh-thinking-summary#v0.3.0
4. 安装；若对话框提供 Enable now 则启用。
5. 打开 Plugins → Installed plugins → dsh-thinking-summary，选择摘要用的模型与语言。

桌面 profile 由桌面应用持有，应在插件页安装，不要用 CLI 往 desktop profile 里加。

CLI（Web、TUI、无头 profile）¶

在对应 profile 下执行（将 <spec> 换成与上面相同的 tarball URL 或 Git spec）：

dsh plugin --profile <profile> add <spec>

示例 spec（与 README 一致）：

https://github.com/HUSTforever/dsh-thinking-summary/releases/download/v0.3.0/dsh-thinking-summary-0.3.0.tgz

或：

github:HUSTforever/dsh-thinking-summary#v0.3.0

升级¶

第三方 bundle 升级方式为先卸载再安装新版本 spec；插件页通常提供 uninstall 后 install。每个 release 有稳定 tag，例如 github:HUSTforever/dsh-thinking-summary#v0.3.0。

替换已导入的 JavaScript 后需刷新页面（若宿主侧有变更还需重启 Harness）。本地端口可能变化，可在当前端口访问 /dsh-thinking-summary/health 检查。

典型用法与设置¶

安装并启用后，正常对话即可：有 reasoning 且满足长度门槛时，thinking 行会显示摘要标题，下方过程卡片展示正文，需要时可展开 disclosure 查看原文。

插件设置页¶

路径：Plugins → Installed plugins → dsh-thinking-summary → Thinking summary 区域。

• 选择摘要的 provider/model（或跟随对话 route）。
• 语言：auto 跟随 DSH；zh、en、zh-CN 等可覆盖。

设置写入 ~/.dsh/thinking-summary/settings.json，保存后立即生效。

配置项（宿主 / bundle 默认）¶

持久化缓存：~/.dsh/thinking-summary/cache.json。清空缓存不影响已有会话。

适用场景与注意¶

适合谁： 经常在 DSH 里看长 reasoning、又希望每步有可读摘要的开发者；需要 Codex 式「标题 + 短说明」、同时保留原生 thinking 与工具链展示的用户。

应注意：

• 摘要依赖额外模型调用，会有延迟与费用/配额消耗，行为与 OpenAI 原生流式摘要不同。
• 插件在当前 DSH 进程权限下运行；安装前请自行查看 源码 与 MIT 许可证。
• SkillHub 插件目录 为社区站点，与 DeepSeek / 幻方无官方从属关系；DSH 生态强调「一切皆插件」，本文介绍的是第三方 bundle，非官方应用商店条目。
• 仅本地开发调试时才 README 所述的手动拷贝到 %USERPROFILE%\.dsh\profiles\desktop\node_modules\dsh-thinking-summary；已与 bundle 共存的 profile 不要重复插入 cordis.patch.yml 条目。

结尾¶

dsh-thinking-summary 把逐步推理摘要嵌进 Harness 原生 thinking disclosure：短标题替代冗长预览，过程卡片与展开原文并存，且不改动会话与模型侧消息。若你在 DSH 里处理复杂 agent 步骤，可先按上文 tarball 或 Git tag 安装，再在插件详情页选定摘要模型与语言。

• 目录页：https://www.skillhub.cn/plugins/HUSTforever/dsh-thinking-summary
• 仓库：https://github.com/HUSTforever/dsh-thinking-summary