dsh-openkapsel：把远端 OpenKapsel 工作区接入 DeepSeek Harness 的桥接插件

它是做什么的？

zzzmmmnn/dsh-openkapsel 是 DeepSeek Harness（DSH）的远程工作区桥接插件，把远端 OpenKapsel 工作区变成模型可直接调用的工具集。它解决的问题是：让 Agent 在不接触宿主机文件系统与 Shell 的前提下，依然能读写文件、执行 Shell 任务。插件由 zzzmmmnn 维护，采用 MIT 协议，属于社区插件而非官方产品，可视为云端 Agent 沙箱的自托管替代方案。

核心功能

• 远程工作区接入：只需提供以 /w/ 结尾的只读工作区 URL 与配套控制令牌，即可把远端 OpenKapsel 工作区映射为模型可见的工具。
• 文件与 Shell 能力：支持列出、读取、写入远端文件，并执行 Shell 任务，同时可调用 OpenKapsel 的其他 REST 接口。
• 失败即关闭的权限模型：内置的 remote-only 预设不向模型暴露宿主机文件工具与宿主机 Shell 工具，run_code 同样被拒绝。
• 固定脚本传输：每个 kapsel_* 工具通过 DSH 宿主 Shell 服务调用两个固定 Python 脚本，模型无法自选脚本，也无法把该服务当作通用 Shell 使用。
• 凭据与策略托管：认证、Context 归属、REST 错误解码与凭据续期由维护中的技能代码负责，凭据存放在 DSH 状态目录下，Unix 使用 0600 文件与 0700 目录。
• 策略联动：read-only 策略会拒绝远端写操作与 Shell，workspace-write 与 danger-full-access 仍受远端令牌授权范围约束。

怎么使用这个插件？

在 DSH 的 web profile 下启用并加载 OpenKapsel Remote 预设后，向插件提供远端工作区 URL 与控制令牌即可开始使用。之后你可以让 Agent 列出、读取或写入远端文件，执行 Shell 任务，或调用其他 OpenKapsel REST 接口；需要收紧权限时切换 DSH 策略，read-only 下写操作与 Shell 会被拒绝，必要时可通过单次审批重试。使用前需确认宿主机 PATH 上有 Python 3.10+（Windows 为 python，macOS/Linux 为 python3），并保证目标 OpenKapsel 服务器可达。

报错怎么排查？

插件对宿主机环境有明确要求：若工具调用失败，先确认宿主机 PATH 上存在对应平台的 Python 解释器，且版本不低于 3.10。若远端操作被拒绝，检查当前 DSH 策略是否为 read-only，该策略会拒绝远端写操作与 Shell，可通过单次审批授权重试。若凭据失效，插件会自动续期并可能替换已存储的凭据，按官方说明确认工作区 URL 与控制令牌仍然有效即可。