前言¶
DeepSeek Harness (DSH) 允許模型在特定權限下調用工具，例如 bash、pwsh、write 和 edit。在 All Access 會話（danger-full-access + never）中，模型已經處於最高權限且無需審批，但官方工具定義仍然要求模型填寫 sandbox_permissions 和 justification 參數。這導致模型填入參數後，在執行階段因參數不匹配或權限衝突報錯（例如 invalid justification），進而陷入重試循環。
dsh-sandbox-escalation-fix 是一個零配置的兼容性插件，旨在解決上述問題。它通過動態投影模型可見的工具 Schema，確保工具定義與當前會話的實時沙箱模式和安全策略一致。
插件簡介¶
- 名稱：dsh-sandbox-escalation-fix
- 定位：Session-aware sandbox escalation compatibility plugin for DeepSeek Harness
- 作者：HakureiMonika
- 類型：社區插件（admin-security）
核心功能¶
該插件主要解決第三方模型在 DSH 環境下的工具調用失敗問題：
* 按會話投影 Schema：根據當前會話的 Sandbox Mode 和 Approval Policy，只向模型展示其真正能夠使用的工具選項。
* 修復升級提示：解決了 bash、pwsh、write、edit 等工具在 All Access 模式下的參數提示錯誤。
* 處理冗餘請求：在運行時處理重複的相同模式升級請求。
* 全平臺支持：支持 Windows、Linux 和 macOS。
兼容性與環境要求¶
- DeepSeek Harness 版本：兼容 0.1.1-rc.1 至 0.1.6-alpha.2。
- DeepSeek Desktop 版本：支持 2.0.3。
- Node.js 版本：需要 Node.js ^22.19.0 或 >=24.0.0。
- 注意：DSH 官方版本 0.1.6-alpha.2 已經顯著緩解了該問題，插件可能在下一個官方版本發佈後停止維護。
安裝與使用¶
該插件爲零配置設計，安裝後自動生效。由於未提供具體的命令行安裝語法，建議通過以下方式手動部署：
* 手動部署：將插件文件解壓並放置到對應的 Profile 目錄中。
* ZIP 包部署：使用官方提供的 Release ZIP 包進行解壓覆蓋。
注意事項¶
- 獨立社區插件：該插件由社區開發維護，未經 DeepSeek 官方發佈、維護或背書，不修改 DSH 核心包。
- 維護狀態：鑑於 DSH 0.1.6-alpha.2 已經大幅緩解了問題，且該插件可能隨下一次官方發佈而停止維護，建議優先嚐試官方行爲。僅在重試次數、開銷或穩定性不可接受時再安裝此插件。
- 權限風險：作爲兼容性插件，請確保在安裝前檢查源碼與許可證。
總結¶
dsh-sandbox-escalation-fix 通過動態 Schema 投影，修復了第三方模型在 All Access 會話中的工具調用報錯問題。對於因沙箱升級參數導致的模型重試循環，該插件提供了一種可靠的本地化解決方案。
