前言¶

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