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 工具。