ws1234567891011/dsh-interim-narration ↗★ 1
dsh-interim-narration
让 DeepSeek Harness 的 agent 每轮先讲理解与计划、在工具调用之间用正文写过程叙述(边做边说),在「插件 → 本插件 → 配置」里直接调整参数并可一键让过程全程可见;系统提示末尾还有短提醒,静默的步骤会自动加压,长任务也不会只顾调工具不说话;0.5 起支持 /narration 快捷命令与单字段/整体恢复默认;0.6 起 language auto 跟随消息语言、句数跟随档位、配置页分区且会话状态有界 适合希望Agent在调用工具时“边做边说”、展示详细思考和执行步骤的用户。
설치
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:ws1234567891011/dsh-interim-narration在 DSH 里直接改配置(0.3.0+)
不用改代码、也不用碰 YAML:
- 打开侧边栏 插件 页,找到 dsh-interim-narration 这一行;
- 点该行的 配置 按钮,进入表单页;
- 改完点 保存。保存会写入当前 profile 的
cordis.patch.yml,并立即生效(下一轮对话的系统提示词就带新配置;无需重启、无需刷新)。
表单里可以改:enabled、style、maxSentences、minToolCalls、language、debug、reportBlockers、ackSteering、announcePlan、reminder、enforce、escalateAfter(0.6.0 起表单分为「基本 / 开场与提醒 / 进阶 / 聊天里的显示」四块;maxSentences 填 0 表示跟随档位)。
其余字段(order、text、extra、logFile)属于安装期配置,仍需编辑 profile patch 或重新安装后生效。
每个字段右侧的 ↺ 可单独「恢复默认」(取消该字段在 profile patch 里的覆盖),底部「全部恢复默认」一次清掉 12 个覆盖。
页面底部的「聊天里的显示」区块可以顺手把「工作步骤展示 / 收起时机」调好(见下一节)。
说明:这个表单走的是 DSH 官方设置通道(
plugins.row.config插槽 +configForms服务 + 宿主settings服务), 保存语义与官方插件配置页一致(CAS 版本校验、只写 volatile 字段、写当前 profile patch)。
配置
可编辑字段也能在应用内「插件 → dsh-interim-narration → 配置」改(见上)。
也可以在 profile 的 cordis.patch.yml 中按 id 覆盖,例如:
- id: dsh-interim-narration
config:
enabled: true
style: standard
minToolCalls: 2
language: zh
| 字段 | 默认值 | 说明 |
|---|---|---|
enabled | true | false 时不注册任何提示词段(插件仍挂载,便于随时开关) |
order | 8950 | 提示词段排序(越大越靠后);工具文档在 1000–5000、交付物指引在 9000 |
style | standard | 详略档位:concise(只给结论)/ standard(结论+必要依据)/ verbose(补证据与风险) |
maxSentences | 0 | 每条叙述的句子数上限 0–10;0 = 跟随 style 档位(concise 2 / standard 3 / verbose 5),1–10 覆盖档位 |
minToolCalls | 2 | 少于等于该次数工具调用的任务可直接给答案,不必叙述;设 0 表示任何任务都可叙述 |
language | auto | auto 跟随你最近一条消息的语言(中文/英文自动检测);zh/en 强制指定 |
reportBlockers | true | 是否要求失败/受阻/计划变更时先说明再继续 |
ackSteering | true | 是否要求用户中途插话时先回应一句再继续 |
announcePlan | true | 是否要求每轮开场(首次工具调用前)先说理解、计划与第一步;关掉只去掉开场要求 |
reminder | true | 是否在系统提示尾部再放一条短提醒(约 126 字符),防止长任务里只顾调工具、不说话 |
enforce | true | 机制级兜底:监听会话事件,某一步只调工具没写正文时,让下一步的尾部提醒加压;关掉则提醒保持静态 |
escalateAfter | 1 | 连续静默几步后开始加压(1–5);1 最积极,调大可容忍更长的静默段 |
text | 无 | 完全替换内置文案 |
extra | 无 | 追加到内置文案(或 text)之后的自定义要求 |
debug | false | 写挂载日志,便于确认插件真的生效(超过 64 KiB 会自动清空重写) |
logFile | $DSH_HOME/dsh-interim-narration.log | debug 日志路径 |
其中 enabled、style、maxSentences、minToolCalls、language、debug、reportBlockers、ackSteering、announcePlan、reminder、enforce、escalateAfter
是 volatile 字段,可在应用内表单修改并立即生效;order、text、extra、logFile 需要改 patch(重载后生效)。
三档预设
| 想要的效果 | 配置 |
|---|---|
| 安静:只在关键转折处说话 | style: concise、minToolCalls: 3 |
| 标准(默认) | 不配置 |
| 详细:像直播一样跟进度 | style: verbose、minToolCalls: 1、reportBlockers: true |