前言¶
DeepSeek Harness 的 agent 在执行多步任务时，往往只在最后给出一个答案，中间的工具调用过程看不到，调试和信任都受影响。让 agent 在每轮先说明理解与计划、在工具调用之间写过程叙述，是提高透明度和可控性的常见做法。dsh-interim-narration 是一个很小的 DeepSeek Harness 插件，通过向系统提示词注册一段结构化的写作契约，实现这一点。
这是什么¶
这是一个 host 侧 Cordis 插件，维护者是 ws1234567891011，版本 0.6.1。它不注册工具或 UI，只向系统提示词注册两个段落：主段落 narration:interim（order 8950）和尾部提醒段落 narration:interim-reminder（order 10150）。插件让模型在收到新消息、调用工具前后写过程叙述，并支持应用内配置和显示桥接。0.5 起支持快捷命令 /narration，0.6 起支持语言自适应（language: auto）、句数跟随档位（maxSentences: 0）、配置页分区，以及会话状态有界。
核心功能¶
- 边做边说：每轮先说明理解与计划、在工具调用之间写过程叙述，而非只给最终答案。
- 结构化写作契约：包含什么时候说、说什么、详略（
style）、怎么写四块。 - 应用内配置：0.3.0 起支持在「插件 → dsh-interim-narration → 配置」修改 volatile 字段，下一轮立即生效。
- 显示桥接：0.4.0 起配置页底部有「聊天里的显示」区块，可直接绑定 Chat 的
ui-chat设置。 - 机制级兜底：0.4.0 起监听会话事件，跟踪工具步骤是否带正文，尾部提醒可加压。
- 语言自适应：0.6.0 起支持
language: auto跟随最近消息的语言。 - 句数跟随档位：0.6.0 起支持
maxSentences: 0跟随style档位。 - 快捷命令：0.5.0 起支持
/narration快捷切换详略、开关、调整显示。
安装与启用¶
桌面端 profile 由 Electron 应用管理，CLI 不能直接启动 desktop profile，但 dsh plugin 子命令可以直接给 desktop profile 装包。
方式一（npm，推荐）
dsh plugin --profile desktop add dsh-interim-narration
也可以直接 npm install dsh-interim-narration，然后把 dsh-interim-narration 加入 profile 的 dsh.profile.bundles。
方式二（CLI，本地目录）
# 链接安装（改完 lib/ 重新启用即可）
resources/runtime/cli/bin/dsh.cmd plugin --profile desktop add link:C:/path/to/dsh-interim-narration
# 或拷贝安装（改源码需要重新装）
resources/runtime/cli/bin/dsh.cmd plugin --profile desktop add file:C:/path/to/dsh-interim-narration
安装完（或更新本包后）刷新一次 DSH 页面（Ctrl+R / F5）；若「配置」入口没出现，重启一次 DSH 应用。
典型用法¶
安装后，agent 会自动在每轮开头说明理解与计划，并在工具调用之间写过程叙述。效果类似：
我会逐项重写 91 项审计要点，明确公司"应做到什么"，再核对程序能否查证……
[编辑了文件] [运行了命令] [搜索了网页]
治理、风险管理和信息安全部分已完成重写。接下来处理系统建设……
[编辑了文件] [运行了命令]
过程叙述是正常 assistant 正文，需要把「工作步骤展示」设置为保留/显示过程才能在时间线中看到。0.4.0 起可在配置页底部直接点击「推荐：让过程全程可见」设置。
适用场景与注意¶
适合需要透明度的多步任务场景，例如审计、代码重构、批量修改等。插件以当前 dsh 进程权限运行，安装前应检查源码与许可证（MIT）。插件依赖可选的 @deepseek-ai/schemastery ^3.18.1。
短结尾¶
dsh-interim-narration 通过结构化写作契约让 agent 边做边说，支持应用内配置和显示桥接，适合需要提高透明度的多步任务。插件目录页：https://www.skillhub.cn/plugins/ws1234567891011/dsh-interim-narration；GitHub：https://github.com/ws1234567891011/dsh-interim-narration
