前言¶
DeepSeek Harness (DSH) 的设计理念是“一切皆插件”。在插件生态中，dsh-waibao 插件解决了开发者在命令行中委派任务后难以追踪过程的问题。它将原本隐藏在命令行的任务执行，搬到了可视化的 DSH 桌面工作区。
插件简介¶
名称：dsh-waibao
定位：DSH 外包。Codex 分配任务，DSH 桌面执行；同一会话继续，完成后回来验收。
维护者：ericlee041769-hash
分类：工作流
许可：MIT
核心功能¶
- 桌面可见会话：任务会话出现在原生工作区和侧栏，正文、工具过程和用量由 DSH 展示。
- 上下文续接：后续任务重用保存的 session binding，接着原会话执行。
- 完成回调：任务结束后通知发起任务的 Codex 聊天，由 Codex 检查产物。
- 历史接入：把已有的 headless 会话加入桌面工作区，继续工作。
- 保留模型：使用已选 provider/model；续接时检查是否发生切换。
安装与启用¶
首版仅支持 Windows 和 Node.js 24+。完成回调功能需要 Codex 桌面客户端及已启用的 Codex App Tools。
- 从 v0.1.0 发布页 下载
dsh-waibao-0.1.0.tgz。 - 使用 DSH 桌面自带 CLI 安装：
$dsh = "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd"
& $dsh plugin --profile desktop add 'D:\Downloads\dsh-waibao-0.1.0.tgz'
- 正常退出并重开 DSH。
- 安装 Codex 技能：
$plugin = "$env:USERPROFILE\.dsh\profiles\desktop\node_modules\dsh-waibao"
node "$plugin\bin\install-skill.mjs"
- 在 Codex 新聊天中输入：
用 dsh-waibao 把这个任务委派给 DSH，完成后帮我验收。
典型用法¶
创建任务文件¶
在工作区创建提示词文件和任务 JSON。以下为示例路径：
{
"workspace": "D:\\code\\demo",
"workspaceTitle": "外包演示",
"title": "检查实现与测试",
"requestId": "demo-round-1",
"bindingPath": "D:/code/demo/work/dsh-session.json",
"promptFile": "D:/code/demo/work/round1.txt"
}
运行任务¶
使用 CLI 执行：
node "$plugin\bin\cli.mjs" run 'D:\code\demo\work\task.json'
续接与历史接入¶
续接任务时，保留 bindingPath，使用新的 requestId 和提示词文件。不要复制历史正文或同时驱动同一会话。
若要接入已有 headless 会话，使用 adopt 命令：
node "$plugin\bin\cli.mjs" adopt '{"workspace": "D:\\code\\demo", "sessionId": "xxx", "workspaceTitle": "接入演示"}'
adopt 接受 workspace、sessionId 和可选的 workspaceTitle。执行前需确认旧 headless 进程已结束，并使用原始工作目录。接入本身不调用模型。
完成回调处理¶
技能在 Codex 环境中调用 bin/job.mjs run <job.json>。任务结束后，通过本机 Codex App Tools 发出完成事件。
查看状态：
node "$plugin\bin\job.mjs" status <id>
处理投递：
node "$plugin\bin\job.mjs" deliver <id>
技术细节与注意事项¶
- 通信机制：插件通过带随机令牌的 Windows 本地命名管道通信，不使用 HTTP 端口。
- 数据存储：连接记录与回调状态位于
~/.dsh/dsh-waibao/。可通过环境变量DSH_WAIBAO_DATA_DIR统一数据目录。 - 权限与费用：提示词交给 DSH 原生 Agent，使用当前账号、模型和工具权限。模型费用由对应 provider 收取。
- 断线处理：客户端在收到
done前断开会报错，重试前应检查桌面会话状态。 - 安全建议：不要将令牌、完整日志、个人项目和会话数据提交到公开仓库。
结语¶
dsh-waibao 让开发者能够利用 DSH 的桌面能力处理复杂、长时间的任务，同时保持与 Codex 的协作流程。相关目录与源码可参考下方链接。
