前言¶
DeepSeek Harness(DSH)的提示詞管理往往分散在配置文件或手動粘貼中,難以統一控制、覆蓋或查看子代理收到的提示詞。本插件提供了一套分層提示詞管理方案,支持按全局、工作區、會話三級投放,內置段落與運行時上下文的禁用或覆蓋,並給出逐行 diff 與真實裝配快照。
插件定位¶
dsh-prompt-manager 是 DeepSeek Harness 的分層提示詞管理器,由 elfmingh 維護。它解決三大問題:給所有會話固定加指令而不修改源碼;只對特定項目禁用或覆蓋內置約定;查看當前輪次系統提示詞的完整內容,包括子代理收到的提示詞。
核心功能¶
- 三級投放:條目可標記爲全局、當前工作區或單個會話。工作區按歸一化路徑識別,切換目錄自動切換生效條目。
- 內置段落改寫:Harness 或其他插件註冊的 section 可被禁用或全文替換。列表來自真實裝配,非硬編碼。
- 運行時上下文改寫:
working-directory:current、sandbox:policy、team:identity等動態上下文同樣可禁用或覆蓋。 - 逐行 diff:被覆蓋的段落通過行級 LCS 高亮真正變化的行,未變段落摺疊成“⋯ N 段未變”,同一行內剝離公共前後綴精確定位。
- 父子智能體作用域:條目可標記爲“主+子代理”、“僅主代理”或“僅子代理”,依據框架寫入的
origin/parentSession/delegationDepth判定。 - 改動時機分兩條路:全局改完等下一個會話生效;會話頁改完立即生效且僅影響該會話。原因是提示詞前綴緩存:前綴變動則整段緩存失效。
- 真實裝配快照:每輪記錄
system-prompt/assemble結果,可枚舉代理作用域段落和全部工具,是查看子代理提示詞的唯一位置。 - 工具 + HTTP 接口:全部能力可通過
prompt_manager工具或/prompt-manager/api調用,Web 界面是其中一層封裝。
安裝與啓用¶
前置條件:DSH >= 0.2.1-rc.2,Node ^22.19.0 || >=24.0.0。
安裝:
dsh plugin --profile web add @vertixara/dsh-prompt-manager
本地開發時:
dsh plugin --profile web add link:D:\dsh-dev\plugins\dsh-prompt-manager
dsh web
卸載與更新:
dsh plugin --profile web remove @vertixara/dsh-prompt-manager
dsh plugin --profile web update @vertixara/dsh-prompt-manager@latest
dsh plugin 會將包名寫入 profile 的 package.json 的 dsh.profile.bundles,該列表纔是啓用開關。未加入 bundles 不會加載。
典型用法¶
- 打開左側邊欄的“提示詞”面板。
- 在“提示詞檔案”頁籤新建條目,填寫標題與正文。
- 在右側“全局”區塊將該條目開關打開。
- 新建會話,該條目會出現在系統提示詞中,會話頁籤的“本會話生效條目”可見。
臨時使用可從會話頁直接添加,僅影響當前會話。
適用場景與注意¶
適合需要統一管理提示詞、靈活覆蓋內置約定或需要查看子代理提示詞的開發者。插件以當前 DSH 進程權限運行,安裝前建議檢查源碼與許可證。
短結尾¶
本插件爲 DSH 提供了一套分層提示詞管理能力,從配置到快照全鏈路可追溯。更多細節與文檔可訪問插件目錄頁與 GitHub 倉庫。
目錄頁¶
https://www.skillhub.cn/plugins/elfmingh/dsh-prompt-manager
GitHub¶
https://github.com/elfmingh/dsh-prompt-manager