DeepSeek Harness 插件：Codex 与 Claude Code 子代理预设

前言¶

DeepSeek Harness 默认由单一模型处理整个任务。这个插件引入 Codex 和 Claude Code 作为子代理，支持读写分离与并行执行，解决了单一模型在特定工具链（如代码审查、测试运行）上能力受限的问题。

插件定位¶

名称：dsh-preset-codex-claude
作者：Magica-Chen
分类：工作流
简介：DeepSeek Harness agent preset：Codex and Claude Code as delegation subagents at read-only and full-access tiers.

核心功能¶

该插件提供以下能力：
- 子代理支持：将 Codex 和 Claude Code 作为子代理引入。
- 权限分级：每个厂商提供只读和完全访问两个层级。
- 并行运行：支持在同一个会话中同时运行两个子代理。
- 官方实现：使用官方 @deepseek-ai/dsh-subagent-codex 和 @deepseek-ai/dsh-subagent-claude-code 提供商，无二次封装。
- 轻量级：作为声明层，注册了四个提供商和四个工具。

安装与启用¶

安装分为两步，顺序不能颠倒：

安装提供商包到 DSH 安装目录（注意：不是安装到 profile，而是安装到 dsh 的安装根目录）。
升级 DSH 后需要重新运行此步骤，因为升级会清除依赖。

DSH_INSTALL="$(dirname "$(dirname "$(readlink -f "$(command -v dsh)")")")"
npm install --no-save --prefix "$DSH_INSTALL" \
  @deepseek-ai/dsh-subagent-codex@0.2.0-rc.2 \
  @deepseek-ai/dsh-subagent-claude-code@0.2.0-rc.2

安装预设到 Profile。

dsh plugin --profile web add github:Magica-Chen/dsh-preset-codex-claude

安装完成后，重启 dsh 并创建新会话以使插件生效。

典型用法¶

在 DSH 会话中，可以通过以下四个工具进行代理调用：

subagent_codex：Codex 完全访问模式
subagent_codex_readonly：Codex 只读模式（继承用户配置）
subagent_claude_code：Claude Code 完全访问模式
subagent_claude_readonly：Claude Code 硬性只读模式

示例用法：

subagent_codex task="Run the test suite and fix the two failures in parser.js"
subagent_claude_code task="Review the diff on this branch for security issues"

所有子代理均以独立进程启动，不继承当前会话上下文，因此提示词必须自包含。

权限与限制¶

插件对权限有明确的划分与限制：

Claude 只读模式 (subagent_claude_readonly)：这是一个硬性阻断。该模式无法运行测试或构建（包括 Bash 命令），除非使用 bypassPermissions。
Claude 完全访问模式 (subagent_claude_code)：使用 bypassPermissions，可读写文件并运行命令。
Codex 只读模式 (subagent_codex_readonly)：这是建议性的，不强制阻断，直接继承用户的 ~/.codex 配置。
Codex 完全访问模式 (subagent_codex)：使用 dangerously-bypass-approvals-and-sandbox。

由于子代理声明了 NO_START_CAPABILITIES，因此无法使用 toolFilter 和 persona。

注意事项¶

版本匹配：提供商包与 DSH 主程序版本必须匹配。版本不匹配会导致静默的代理调用失败。
进程级缓存：如果预设加载失败，该错误会在整个进程生命周期内被缓存，仅重启 dsh 可清除。
单次调用：代理调用是“一次性”的，不暴露可继续对话的模式。
会话隔离：已存在的会话无法自动应用新安装的预设，必须创建新会话。
Profile 要求：需要使用 dsh web profile。

结语¶

该插件为 DSH 生态提供了 Codex 和 Claude Code 的官方集成方案，适合需要针对不同代码工具进行精细权限控制和并行处理的开发者。