前言¶
DeepSeek Harness（DSH）的插件化生态允许扩展其桌面能力。esroamer/codex-dsh-collab 旨在解决 Codex 与本地桌面环境协作的痛点。它通过一个可重用的技能，允许 Codex 将任务委派给桌面可见的 DeepSeek Harness 代理，并支持跟踪执行、读取结果及继续工作。
插件定位¶
- 名称：esroamer/codex-dsh-collab
- 维护者：ESROAMER
- 类别：工作流
- 核心价值：将 Codex 的任务处理能力延伸至桌面环境，提供作用域凭证管理和持久会话支持。
核心能力¶
该插件主要实现以下功能：
- 任务委派与执行跟踪：Codex 可发起任务，DSH 代理在桌面执行，插件负责跟踪执行流程。
- 工作区感知协作：支持基于工作区的上下文协作，Codex 可读取执行结果并继续后续工作。
- 客户端无关协议：底层采用循环认证的 HTTP 协议，不依赖特定客户端实现。
- 安全与会话管理：提供作用域凭证，支持持久会话和可重用技能。
安装与配置¶
安装需要同时配置 DSH 插件环境和 Codex 客户端。
-
在 DSH 中添加插件：
打开 Settings → Plugins → Add plugin，输入以下任一地址：https://github.com/ESROAMER/codex-dsh-collab@esroamer/codex-dsh-collab- 本地仓库路径
注：全工作区设置和注册需要 0.2.0 及以上版本。
-
运行配置脚本：
在仓库根目录下执行 PowerShell 命令以授权工作区：
powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1 -ConfigureOnly
系统会提示选择要授权的工作区，该步骤会安装 `$deepseek-harness` Codex 技能并为选定工作区创建本地令牌。
- 检查连接状态：
安装完成后，在仓库根目录运行：
.\install.ps1 -Check
- 在 Codex 中使用：
重启 DSH（如需要）后，在 Codex 中调用$deepseek-harness，并描述任务和目标工作区。
高级配置¶
若需为当前及未来的所有工作区进行配置，并允许 Codex 创建新工作区：
.\install.ps1 -ConfigureOnly -AllWorkspaces -AllowWorkspaceCreate
注意：Codex 仅在 DSH 尚未存在对应路径的工作区时才会注册现有目录，否则会复用现有工作区，不会创建新目录。
运行环境与安全¶
- 系统要求：仅支持 Windows 平台。必须安装 DSH Desktop 和 Codex 客户端。
- 开发环境：Setup 和 Codex 客户端需要 Node.js 22+ 和 Python 3.10+。
- 权限范围：插件访问权限覆盖选定的工作区或显式授权的全工作区范围。
- 权限分离：工作区的创建权限与 DSH 工具的审批权限是分离的，DSH 工具审批在插件安装后依然有效。
注意事项¶
- 会话唤醒机制：Codex 是交互的发起者。DSH 不会主动唤醒处于空闲状态的 Codex 会话。
- 桌面安装修补：桥接安装程序不会自动修补桌面安装的 Windows shell 启动配置。如果遇到相关启动问题，需参考文档手动处理。
- 许可证：本项目采用 MIT 许可证。
结语¶
该插件为 Codex 与本地 DSH 的协同工作提供了标准化入口。通过作用域凭证和持久会话机制，开发者可以在不破坏安全隔离的前提下，让智能体在桌面环境中持续执行复杂任务。
