ws1234567891011/dsh-interim-narration ↗★ 1

dsh-interim-narration

让 DeepSeek Harness 的 agent 每轮先讲理解与计划、在工具调用之间用正文写过程叙述(边做边说),在「插件 → 本插件 → 配置」里直接调整参数并可一键让过程全程可见;系统提示末尾还有短提醒,静默的步骤会自动加压,长任务也不会只顾调工具不说话;0.5 起支持 /narration 快捷命令与单字段/整体恢复默认;0.6 起 language auto 跟随消息语言、句数跟随档位、配置页分区且会话状态有界 适合希望Agent在调用工具时“边做边说”、展示详细思考和执行步骤的用户。

パッケージ
dsh-interim-narration
互換性
未検証
バージョン
0.6.0
ライセンス
MIT
最終更新
2026/10/22

インストール

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:ws1234567891011/dsh-interim-narration

ドキュメント

README 全文を読む ↗

在 DSH 里直接改配置(0.3.0+)

不用改代码、也不用碰 YAML:

  1. 打开侧边栏 插件 页,找到 dsh-interim-narration 这一行;
  2. 点该行的 配置 按钮,进入表单页;
  3. 改完点 保存。保存会写入当前 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
字段默认值说明
enabledtruefalse 时不注册任何提示词段(插件仍挂载,便于随时开关)
order8950提示词段排序(越大越靠后);工具文档在 1000–5000、交付物指引在 9000
stylestandard详略档位:concise(只给结论)/ standard(结论+必要依据)/ verbose(补证据与风险)
maxSentences0每条叙述的句子数上限 0–10;0 = 跟随 style 档位(concise 2 / standard 3 / verbose 5),1–10 覆盖档位
minToolCalls2少于等于该次数工具调用的任务可直接给答案,不必叙述;设 0 表示任何任务都可叙述
languageautoauto 跟随你最近一条消息的语言(中文/英文自动检测);zh/en 强制指定
reportBlockerstrue是否要求失败/受阻/计划变更时先说明再继续
ackSteeringtrue是否要求用户中途插话时先回应一句再继续
announcePlantrue是否要求每轮开场(首次工具调用前)先说理解、计划与第一步;关掉只去掉开场要求
remindertrue是否在系统提示尾部再放一条短提醒(约 126 字符),防止长任务里只顾调工具、不说话
enforcetrue机制级兜底:监听会话事件,某一步只调工具没写正文时,让下一步的尾部提醒加压;关掉则提醒保持静态
escalateAfter1连续静默几步后开始加压(1–5);1 最积极,调大可容忍更长的静默段
text无完全替换内置文案
extra无追加到内置文案(或 text)之后的自定义要求
debugfalse写挂载日志,便于确认插件真的生效(超过 64 KiB 会自动清空重写)
logFile$DSH_HOME/dsh-interim-narration.logdebug 日志路径

其中 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