dsh-openkapsel：遠程 OpenKapsel 工作區橋接

前言¶

DeepSeek Harness (DSH) 的插件化架構允許開發者擴展智能體的能力。當智能體需要操作遠程 OpenKapsel 工作區時，dsh-openkapsel 提供了一個橋接層。它將遠程工作區轉化爲模型可見的工具，通過 skill-driven tool calls 調用，而不是直接暴露主機本地權限。

插件介紹¶

這是一個 Remote-only OpenKapsel workspace bridge for the DeepSeek Harness。

維護者：zzzmmmnn
分類：聯網工具
許可證：MIT

核心功能¶

該插件通過 skill-driven tool calls 調用遠程資源，提供以下能力：
- 對遠程 OpenKapsel 工作區的文件、Shell、上下文、記憶、共享和預覽進行操作
- 提供統一的 kapsel_* 工具接口
- 重用 skill/openkapsel-rest skill 中的 Python 輔助函數 (openkapsel_http.py 和 openkapsel_config.py)

安裝¶

插件通過 DSH 的包管理器安裝，默認安裝在 web profile。

dsh plugin --profile web add github:zzzmmmnn/dsh-openkapsel

安裝完成後，插件會自動安裝一個名爲 OpenKapsel Remote 的預設。這個預設只包含 OpenKapsel 橋接工具，不包含主機的文件系統或 Shell 工具。

使用方法¶

選擇預設：在 DSH 的模式選擇器中，選擇 OpenKapsel Remote 預設。
配置連接：通過 kapsel_config 工具提供遠程工作區的 URL 和控制令牌。URL 需要以 /w/<READ_TOKEN> 結尾。
執行操作：模型將使用提供的 kapsel_* 工具來操作遠程工作區。

權限與安全¶

該插件對本地和遠程權限有嚴格區分：

本地權限：在 OpenKapsel Remote 預設下，模型沒有主機文件系統或主機 Shell 工具。本地訪問僅限於通過 DSH Shell 服務運行固定的 Python 輔助腳本，且無法使用 run_code。
憑據存儲：連接憑據存儲在用戶 DSH 狀態目錄下（默認爲 ~/.dsh/state/dsh-openkapsel）。
- Unix 系統：文件權限設爲 0600，目錄權限設爲 0700。
- Windows 系統：依賴目錄的 ACL（chmod 在 Windows 上不強制執行 Unix 權限）。
遠程權限：模型對遠程工作區的操作受令牌授權限制。DSH 策略中的 read-only 拒絕遠程修改和 Shell 操作；workspace-write 和 danger-full-access 仍受遠程令牌限制。
憑據管理：自動續訂機制可能會替換存儲的憑據。

環境要求¶

DSH：建議使用 DSH 0.1.2-rc.1 及以上版本（web profile），並注意 0.1.5-rc.2 更新了預設的 persona 字段。
Node.js：Node.js >= 18（測試覆蓋 22 和 24）。
Python：Python 3.10+，必須包含在系統 PATH 中（Windows 使用 python，macOS/Linux 使用 python3）。

注意事項¶

這是一個社區插件，非 DeepSeek 官方產品。
不要將 OpenKapsel Remote 預設添加到 standard 或 minimal profile，因爲它們會暴露主機本地工具。
插件重用 openkapsel-rest skill 的代碼，模型無法選擇腳本或將該服務用作 Shell 工具。