双智能体搭子marketleonai-del/codex-deepseek-partner

Codex × DeepSeek Harness 搭子

一个可公开复用的本地双智能体开发工作流：Codex 负责想清楚、拆任务、验收和返工，DeepSeek Harness 负责实际编码、调试与测试。

用户需求
↓
Codex：理解 → 规划 → 写验收条件
↓ 派发 headless 任务
DeepSeek Harness：实现 → 测试 → 返回结果
↓
Codex：检查 diff/测试 → 通过，或给出精确返工意见

本项目参考 LearnPrompt/partner-skill 的持久化任务和验收闭环思路，改造成不依赖 Claude Code 的 Codex → DeepSeek Harness 路径。版权与差异见 NOTICE.md。

已实现能力

- DSH headless 非交互执行：dsh --profile headless "任务"。
- 后台派发，不占住 Codex 当前命令。
- 任务状态、日志、结果和返工父子关系持久化。
- doctor / submit / status / result / resume / cancel / list 全生命周期。
- 超时和输出大小限制。
- PID 身份令牌检查，只关闭本控制器创建的进程树。
- 常见 API key/token/password 模式落盘脱敏。
- 无第三方 Python 依赖；兼容 Windows、macOS、Linux。
- 中文 Codex Plugin 与 Skill。

环境要求

- Python 3.10+
- Node.js 与 npm/npx
- DeepSeek Harness：可由 npx --yes @deepseek-ai/dsh 启动
- DeepSeek Harness 已在本机完成你自己的模型配置
- Codex（只有使用 Skill/插件时需要）

项目不会读取或生成密钥，也不会修改 .env、系统环境变量、注册表、服务、计划任务、防火墙或全局 npm 配置。

快速开始

1. 克隆并检查

git clone https://github.com/marketleonai-del/codex-deepseek-partner.git
cd codex-deepseek-partner
.\partner.ps1 doctor --json

macOS/Linux 使用：

python3 skills/codex-deepseek-partner/scripts/delegate_deepseek.py doctor --json

安装到 Codex

.\install.ps1

安装器只复制插件清单和 Skill 到个人插件目录，更新个人 marketplace，并调用 Codex CLI 安装；更新旧版本时会保留一个带时间戳的备份。安装后请新建 Codex 任务，让应用读取最新版 Skill。

2. 准备一个子任务

新建 task.md：

目标
为当前项目增加输入校验并补充测试。

允许修改
- src/
- tests/

不允许修改
- .env、密钥、无关文件
- 不提交、不推送、不部署

验证
- 运行项目现有测试
- 最终说明修改文件、检查结果和剩余问题

3. 派发、查看和验收

$job = .\partner.ps1 submit --repo "D:\你的项目" --prompt-file .\task.md --label validation --json | ConvertFrom-Json
.\partner.ps1 status $job.job_id --repo "D:\你的项目" --wait --timeout 1800
.\partner.ps1 result $job.job_id --repo "D:\你的项目"

done 只代表 DSH 正常退出。Codex 仍需检查文件差异和真实测试结果。

4. 返工

把验收问题写入 feedback.md，然后：

.\partner.ps1 resume  --repo "D:\你的项目" --prompt-file .\feedback.md --json

5. 状态检测和关闭

.\partner.ps1 list --repo "D:\你的项目"
.\partner.ps1 status  --repo "D:\你的项目" --json
.\partner.ps1 cancel  --repo "D:\你的项目" --json

也可以双击 搭子控制台.cmd 查看命令帮助。

在 Codex 中使用

插件中的 Skill 名称是 $codex-deepseek-partner。安装后可直接说：

- “用搭子模式完成这个功能。”
- “Codex 负责审查，让 DeepSeek 干活。”
- “检查上一个搭子任务，没通过就返工。”
- “关闭正在运行的搭子任务。”

Codex 会读取 Skill，生成有边界的任务文件，派发给 DSH，检查结果并决定是否返工。

任务数据

每个目标项目下会生成：

.partner/deepseek/jobs//
├── metadata.json
├── prompt.md
├── stdout.log
├── stderr.log
└── result.md

建议把 .partner/ 加入目标项目的 .gitignore。任务提示仍不应包含任何密钥；脱敏是兜底，不是密钥存储方案。

指定本地 DSH 入口

默认优先寻找 PATH 中的 dsh，否则使用 npx --yes @deepseek-ai/dsh。如果你已有本地 JS 入口：

.\partner.ps1 doctor --dsh-bin "D:\path\to\@deepseek-ai\dsh\lib\bin.js" --json

也可设置当前进程的 DEEPSEEK_PARTNER_DSH_BIN；项目不会替你写系统环境变量。

开发与测试

python -m unittest discover -s tests -v
python C:\Users\\.codex\skills\.system\skill-creator\scripts\quick_validate.py skills\codex-deepseek-partner

每次迭代只改一个工作流维度，并用单元测试或真实最小闭环证明改进。详见 Skill 内的 references/iteration.md。

安全模型

- DSH 只获得目标工作目录及任务文本，不获得发布权限。
- Git 提交、推送、部署和外部消息始终由 Codex 在用户明确授权后单独处理。
- cancel 会核对随机身份令牌；匹配失败时拒绝杀进程。
- stdout/stderr 有大小上限，超时会结束受管进程树。
- Windows 下任务提示限制为 12,000 字符，避免超过 DSH headless 命令行上限。
- 当前 DSH headless 没有公开的继续会话参数；resume 创建新会话，并提供经过裁剪和脱敏的上一轮上下文。