前言¶
用 DSH 的 Web 界面跑智能体任务时,模型的原生状态只有一行 “Deep diving”,思考过程本身又是英文文本。对看不懂英文思考的用户来说,很难跟上模型的工作节奏:等弄明白它打算做什么,命令可能已经开始执行了。
dsh-thinking-summary 针对的就是这个问题。DSH 的理念是「一切皆插件」,这个插件在 “Deep diving” 右侧实时显示下一步计划,并在每段思考下方插入中文摘要卡片。下面介绍它的功能、安装方式和配置。
这是什么¶
dsh-thinking-summary 是一个 DSH Web 插件,由 Rosmarinus-Young 维护,许可证为 MIT,当前版本 1.0.0(以 package.json 为准)。它做两件事:
- 在原生 “Deep diving” 状态文字右侧实时显示「下一步计划」;
- 在消息流中每段思考的正下方插入摘要卡片。
摘要由 deepseek-v4-flash 生成。插件面向 web 平台,通过 dsh.client 注入 dsh-client-ui-slots / conversation / settings / runtime 等 UI 插槽。社区目录页将其归入「工作流」分类(分类信息以目录页标注为准)。
核心功能¶
- 计划后缀:在原生 “Deep diving” 状态文字右侧实时显示「下一步计划」,思考刚结束即出现,命令执行前可见。
- 摘要卡片:在消息流中每段思考的正下方插入摘要卡片,内容为计划 + 详细摘要,卡片直接显示内容、无标题行。
- 低成本生成:摘要由 deepseek-v4-flash 生成,调用时禁用思考、失败自动重试,成本最低且不污染主上下文。
- 不动历史:只处理插件激活后新产生的消息,历史消息不受影响。
数据流¶
插件内部的数据流如下:
session/event 日志(assistant/chunk 提前还原思考文本)
→ 推理块结束即触发
→ deepseek-v4-flash(reasoningEffort: off)
→ 计划(后缀显示)+ 摘要(流内卡片)
客户端通过 /thinking-summary/api/*(同源路由)轮询 Host 状态。
安装¶
前提:已安装 DSH(@deepseek-ai/dsh),且 pnpm、git 在 PATH 中;engines 要求 Node >= 20。
先执行下面的命令安装插件:
dsh plugin --profile web add github:Rosmarinus-Young/dsh-thinking-summary
安装后重启 dsh web,插件集合变更在重启后生效。这条命令会转发给 pnpm 把插件装进 profile 目录,并自动加入 dsh.profile.bundles 插件层(因为本包声明了 dsh.bundle),无需手工配置。
如需固定版本,把安装目标换成带 semver 的写法:
dsh plugin --profile web add github:Rosmarinus-Young/dsh-thinking-summary#semver:^1.0.0
更新与卸载¶
更新插件:
dsh plugin --profile web update dsh-thinking-summary
卸载插件:
dsh plugin --profile web remove dsh-thinking-summary
两条命令执行后都需要重启 dsh web。
设置¶
安装并重启后,打开 Web 界面 → 设置 → 「思考摘要」标签页,共有三项设置:
| 设置 | 默认 | 说明 |
|---|---|---|
| 在 Deep diving 右侧显示计划 | 开 | 关闭后原生状态文字保持原样 |
| 显示思考摘要卡片 | 开 | 关闭后不再在消息流插入卡片 |
| 计划长度上限 | 36 字 | 12–48,超出按标点边界截断 |
设置写入后立即生效,无需重启。
本地联调¶
改插件代码时,可以在 profile 中以文件方式安装:
dsh plugin --profile web add file:.
pnpm 会复制文件,改完代码后需重跑这条命令或手动同步。
适用场景与注意事项¶
它适合在 web 平台使用 DSH、希望用中文跟上模型工作节奏的用户。使用前注意以下几点:
- 插件以当前 dsh 进程的权限运行,安装前建议先检查源码与许可证。本项目的源码在 GitHub 公开,许可证为 MIT。
- 插件只处理激活后新产生的消息,历史消息不会补摘要。
- 安装、更新、卸载之后都要重启
dsh web,变更才会生效。
小结¶
经过上面的步骤,装好插件、重启 dsh web、按需调整三项设置,就能在 “Deep diving” 右侧看到下一步计划,并在每段思考下方读到中文摘要。摘要由 deepseek-v4-flash 禁用思考生成,成本可控,也不会污染主上下文。
- GitHub:https://github.com/Rosmarinus-Young/dsh-thinking-summary
- 社区目录页:https://www.skillhub.cn/plugins/Rosmarinus-Young/dsh-thinking-summary
顺带说明:上面的社区目录是独立站点,与 DeepSeek、幻方无官方从属关系。