DeepSeek Harness（DSH）採用插件化架構，但僅列出插件列表往往不足以復現環境。插件加載順序、版本漂移以及配置補丁的差異，都會導致環境行爲不同。dsh-stack 旨在捕獲這些完整的上下文，生成一個單一、可移植的配置文件。
這是一個由 weivwang 維護的插件。它通過一個 JSON Stackfile 來聲明環境，包含插件順序、安裝的註冊表版本、Git 源碼的 commit 鎖定，以及配置補丁。該文件可用於項目、發佈說明或團隊手冊中，在允許它接觸配置文件之前，任何人都可以檢查它。
核心功能¶
- 捕獲完整配置：記錄插件順序、版本和配置補丁。
- 生成 Stackfile：導出爲可移植的 JSON 文件。
- 密鑰管理：使用佔位符管理密鑰，而不是明文憑證。
- 完整性驗證：包含摘要校驗。
- inspect 工具：提供
stack_inspect模型工具。
安裝與啓用¶
首先安裝 CLI：
npm install --global dsh-stack
安裝後，將 bundle 添加到 Harness 配置中。
典型用法¶
導出環境：
dsh-stack export --profile web --name "research-workbench"
檢查文件：
dsh-stack inspect web.dsh-stack.json
規劃變更：
dsh-stack plan web.dsh-stack.json --profile research
應用配置：
dsh-stack apply web.dsh-stack.json --profile research --yes
從 URL 規劃：
dsh-stack plan https://example.com/research.dsh-stack.json --profile research
注意事項¶
- 版本要求：需要 DeepSeek Harness 0.1.0-rc.6 和 Node.js 22.19+。
- Apply 行爲：
apply命令需要--yes標誌，並且絕不移除目標獨有的插件。現有未在 Stackfile 中命名的 bundle 在聲明層之後仍然保留。 - 排除項：Stackfile 排除會話歷史記錄、憑據、全局狀態和本地工作區文件。
- 安全性：Inspect 列出所需變量。在應用之前，請檢查 Stackfile。建議使用託管憑證或環境引用，以防止原始密鑰進入配置補丁。
總結¶
dsh-stack 通過將 Harness 環境的完整契約（包括順序、版本和配置）打包爲單一文件，解決了環境不可復現的問題。它通過 inspect、plan 和 apply 命令提供了安全的讀/寫路徑，並通過佔位符管理密鑰。
