前言¶
在 DSH 或智能體開發裏，如果每次請求的系統提示前綴因爲工作目錄等可變內容而發生變化，provider 側基於前綴匹配的 prompt cache 可能不容易複用。dsh-cache-stabilizer 是一個面向 DeepSeek Harness 的 MIT 許可插件，由 dongsheng123132 維護。它做兩件事：一是把 DSH 已知默認人格句中的工作目錄移到 runtime-context snapshot；二是規範化 tool schema 中 object-key 的順序。插件還提供 /cache 命令，用於報告 provider 返回的緩存讀取、未緩存輸入和緩存寫入 token。
這是什麼¶
dsh-cache-stabilizer 的定位是 cache-prefix stabilization 和 evidence-based cache metrics。它不實現第二套緩存，不代理模型響應，不凍結 tool catalog，也不復用 stale context。它只在當前 DSH 請求構造階段做一些語義保持的前綴穩定化，並通過 provider 指標展示緩存證據。
該插件要求 Node.js >=22。
核心功能¶
把 cwd 從默認人格句中移出¶
插件會把 DSH standard/headless coding persona 中已知的確切句子裏的 working directory 移出系統提示前綴，改放到 runtime-context snapshot 中。這樣，不同項目可以共享同一段 system-prompt 前綴，同時每個請求仍然能收到正確的 cwd。
這裏有一個明確邊界：只有 DSH 標準或 headless coding persona 使用的確切句子會被遷移。如果自定義 persona 以其他形式提到 {{cwd}}，插件不會改動，因爲盲目移動任意自然語言可能改變含義。
規範化 tool schema 的 key 順序¶
插件會規範化 tool schemas 內部 object-key 的順序。這個改動服務於前綴穩定，但不會改變 tool 集合本身。
增加 /cache 命令¶
插件增加 /cache 命令。這是一個 human-only 命令，用於報告 provider 的持久指標：
cacheReadTokens- 未緩存的
inputTokens - cache-write tokens
/cache 不會憑空構造一個 cache hit。DeepSeek provider cache 是自動的，依賴從 token zero 開始的精確前綴匹配；緩存存儲和淘汰仍由 provider 控制。
安裝與啓用¶
在 web profile 下安裝：
dsh plugin --profile web add dsh-cache-stabilizer
如果使用自定義 profile，把 web 替換爲對應 profile 名稱。
典型用法¶
1、安裝插件：
dsh plugin --profile web add dsh-cache-stabilizer
2、重啓 DSH，發送幾條消息，然後在支持命令的客戶端中輸入：
/cache
如果需要在某個 profile 中關閉某項優化，可以用 profile patch 配置：
- id: dsh-cache-stabilizer
config:
relocateCwd: false
canonicalizeTools: false
適用場景與注意¶
適合使用 DSH standard/headless coding persona、希望減少可變內容對系統提示前綴影響、並且想查看 provider 緩存證據的開發者。
使用前需要注意：
- 插件以當前 DSH 進程權限運行，安裝前應檢查源碼和許可證。
- 該插件不會創建新的緩存層，也不會改變 provider 的緩存存儲和淘汰策略。
- 如果自定義 persona 的
{{cwd}}不是 DSH 已知默認句子的精確形式，插件不會自動遷移。 /cache只報告 provider 給出的指標，不會推斷或生成不存在的 cache hit。
開發與驗證¶
倉庫提供開發命令：
npm test
npm run check
鏈接¶
GitHub：
https://github.com/dongsheng123132/dsh-cache-stabilizer
社區目錄頁面（資料提供，未由 README/package.json 確認）：
https://www.skillhub.cn/plugins/dongsheng123132/dsh-cache-stabilizer
社區目錄是獨立站點，並非 DeepSeek 或幻方官方應用商店。
