emo-xiaoyu/harness-mix

Harness Mix

macOS/Linux 已加入源码构建与启动适配；目标系统的完整桌面验收仍需在对应机器执行。安装方式、Linux 桌面前提和支持边界见 跨平台指南。

⭐ 如果这个项目对你有帮助，请给我们一个 Star！ ⭐

Codex 原生 UI，连接多个原生 Coding Harness，并让任务在它们之间无缝接力。

当前注册的 Harness（17 个）

Antigravity
Codex
Claude Code
Pi

Oh My Pi
DeepSeek
OpenCode
Grok

OpenClaw
Hermes
Qoder
CodeBuddy

Kiro
Cursor
ZCode
Trae

Cline

图标与 Harness 能力均来自项目自身的注册表；只有本机已安装且握手成功的 Harness 才会进入真实运行。

Harness Mix 是接入官方 Codex Desktop 原生界面的本地内核。它通过本地编译的 CLI Shim 对接桌面的 app-server 协议，把包括 Antigravity、Codex、Pi、Oh My Pi、Claude Code、DeepSeek Harness、OpenCode、Grok、OpenClaw、Hermes、Qoder、CodeBuddy、Kiro CLI、Cursor CLI、ZCode、Trae 和 Cline 在内的原生 Coding Harness 接入同一套 UI。Host Runtime 与 Protocol Core 管理任务映射、协作和事件投影；模型调用、工具执行、原生会话与凭据仍由各 Harness 自己管理。

界面预览

预览来自当前 Codex Desktop 原生窗口：Harness Mix 作为原生扩展入口出现在桌面工具栏和 Composer 中，会话、模型、工具与权限仍由 Codex Desktop 及各 Harness 管理。

| 功能模块 | 核心能力 | 交互入口与特点 |
| :--- | :--- | :--- |
| 🔄 跨 Harness 任务接力 | 4 种接力模式（继续执行 / 执行计划 / 独立审查 / 重新分析）平滑交接 | 输入框接力角标 / /switch；持久化脱敏检查点与证据追溯 |
| 🎨 皮肤市场 | 内置 HeiGe、Codex Styler、Dream Skin 与经典编辑器配色主题，支持亮色 / 暗色、背景装饰和可读性保护 | 设置 → 皮肤；一键预览、应用和恢复原生外观 |
| 📚 历史会话导入与引用 | 一键导入 Pi / Claude / Codex / CodeBuddy 原生历史并可中断续跑；# 引用任意旧会话注入脱敏上下文 | 引用仅预取最近一页；MCP 只读工具 get_session_info / list_session_messages 供 Harness 按需翻页与读取分支 / 模型 / 用量元数据 |
| 🤝 多 Agent 协同编排 | 输入 # 唤起目标 Harness，胶囊标签直观管理，主控强约束派发 | 输入框 # 菜单；支持循环审查验证、子任务级联取消与超时熔断 |
| 🧩 原生 Skills 管理 | 全量覆盖 17 个 Harness 原生技能目录，会话启动自动预建根目录 | 设置 → Skills；支持单个 SKILL.md 或完整文件夹直接拖拽安装 |
| 🛠️ 原生 MCP 扩展 | 支持本地 stdio 与远程 Streamable HTTP / SSE 协议 | 设置 → MCP；支持自定义 Header 传递，按 Harness 独立生效 |
| 📋 原生消息队列 | 完整接入 Codex 会话排队机制（增删改查、排序、插队抢占与自动排空） | 原生 Composer 队列；当前回合完成后自动顺序调度执行排队消息 |
| ✅ 可配置验证门禁 | 任务级 off / advisory / required 策略，内置一致性检查与自定义验证命令 | 命令面板 /gate、/verify；强制模式保护隔离分支合并与推送 |
| 💾 会话存储治理 | schema v3 分片惰性加载、无损紧凑存储、迁移备份与体积诊断 | 冷启动只读任务索引；打开任务时才恢复对应 Core checkpoint |
| 🩹 失败分类与恢复 | 失败回合归类为连接 / 登录 / 额度 / 被拒 / 服务异常五类，分类来自原生结构化错误（Codex codexErrorInfo 透传）、状态码或消息特征，无法归类时诚实标注 unknown | 错误状态随任务投影；Renderer 可查 harnessmix/harness/turn-error 获取分类与动作（重试 / 去登录 / 新建会话），login 按钮按 Harness 真实登录能力出现 |
| 🌐 ChatGPT 侧边栏桥接 | 安全脱敏提取当前会话上下文并一键生成结构化草稿 | Web 快捷聊天面板；直通注入 ChatGPT，实现跨工具无缝协作 |
| 👤 账户与用量隔离 | Codex 多账户隔离与即时切换；实时追踪 Token / Credits 用量 | 原生侧边栏与设置面板；各 Harness 凭据、模型与审批原生自理 |

🎨 皮肤市场预览

主题资源随项目发布，图片直接使用仓库内的授权素材；应用皮肤只改变视觉层，不改变 Codex 原生交互和 Harness 执行行为。

🎀 Miku
🌌 Genshin Night

🌠 Deepspace Star
🌊 Wuthering Tide

原生 Harness 功能支持矩阵

💡 设计原则：所有能力严格在 Adapter manifest 中诚实声明，界面按真实能力渲染，不依靠名称猜测。凭据、模型、工具与权限审批始终由原生 Harness 独立掌控。

| Harness | 原生接入协议 | 流式输出 | 思考推理 | 工具审批 | 用户提问 | 会话恢复/Fork | 图片附件 | 原生 Skills | MCP 扩展 |
| :--- | :--- | :---: | :---: | :---: | :---: | :---: | :---: | :---: | :---: |
| Antigravity | agy CLI (stream-json / Hook) | ✅ | ✅ | ✅ | ✅ | ✅ / ✅ | ✅ | ✅ | ✅ |
| Codex | codex app-server --stdio | ✅ | ✅ | ✅ | ✅ | ✅ / ✅ | ✅ | ✅ | ✅ |
| Claude Code | @anthropic-ai/claude-agent-sdk | ✅ | ✅ | ✅ | ✅ | ✅ / ✅ | ✅ | ✅ | ✅ |
| Pi | pi --mode rpc | ✅ | ✅ | ✅ | ✅ | ✅ / ✅ | ✅ | ✅ | ➖ |
| Oh My Pi | omp --mode rpc (pi-family.js) | ✅ | ✅ | ✅ | ✅ | ✅ / ✅ | ✅ | ✅ | ➖ |
| DeepSeek | 普通 Web Remote / 协作 ACP | ✅ | ✅ | ✅ | ✅ | ✅ / ✅ | ✅ | ✅ | ✅ |
| OpenCode | opencode serve (HTTP / SSE) | ✅ | ✅ | ✅ | ✅ | ✅ / ✅ | ✅ | ✅ | ✅ |
| Grok | grok agent stdio (_x.ai/) | ✅ | ✅ | ✅ | ✅ | ✅ / ✅ | ✅ | ✅ | ✅ |
| OpenClaw | Gateway WebSocket Loopback | ✅ | ➖ | ✅ | ➖ | ✅ / ➖ | ✅ | ✅ | ➖ |
| Hermes | hermes acp | ✅ | ✅ | ✅ | ✅ | ✅ / ✅ | ➖ | ✅ | ✅ |
| CodeBuddy | codebuddy --acp (_codebuddy.ai/) | ✅ | ✅ | ✅ | ✅ | ✅ / ➖ | ✅ | ✅ | ✅ |
| Kiro CLI | kiro-cli acp (_kiro/) | ✅ | ✅ | ✅ | ✅ | ✅ / ✅ | ➖ | ✅ | ✅ |
| Cursor CLI | cursor-agent acp (cursor/) | ✅ | ✅ | ✅ | ✅ | ✅ / ➖ | ➖ | ✅ | ✅ |
| Qoder | qoder --acp | ✅ | ➖ | ✅ | ➖ | ✅ / ➖ | ✅ | ✅ | ✅ |
| ZCode | 兼容 ACP 桥接程序 | ✅ | ➖ | ✅ | ➖ | ✅ / ➖ | ➖ | ✅ | ✅ |
| Trae | 兼容 ACP 桥接程序 | ✅ | ➖ | ✅ | ➖ | ✅ / ➖ | ➖ | ✅ | ✅ |
| Cline | cline --acp | ✅ | ✅ | ✅ | ➖ | ✅ / ➖ | ✅ | ✅ | ✅ |

注：✅ 为原生支持并已打通；➖ 为上游协议当前未开放或未声明；只有本机已安装且握手成功的 Harness 才会进入真实运行。详见 原生 ACP 深度适配 与 Harness 管理说明。

核心功能特色

🔄 跨 Harness 任务接力（Task Handoff）
一个 Harness 负责深入分析，另一个编写具体实现，再切回原 Harness 交叉复核——整个过程无缝保留在同一个 Codex Desktop 原生窗口中：
- 现场完整保留：保留对话历史、未提交代码改动、Git 状态与 Review 记录。
- 持久化检查点：创建带哈希的接力快照，自动脱敏测试证据与敏感密钥，支持随时暂停与恢复。
- 独立会话恢复：每个 Harness 的原生 Session 与参数独立保存，切回时调用其原生恢复机制（如 Pi --session 或 Claude resume）。
- 四种接力方式：支持「继续执行」、「执行上一方案」、「独立审查」与「重新分析」。

🤝 多 Agent 协同编排（Multi-Agent Collaboration）
- 触发符解耦：在原生输入框输入 # 调出协同菜单（#pi、#claude、#codex、#dsh），完全保留官方 @ 菜单给 Codex 原生功能。
- 标签可视化：已选协同 Agent 在输入框顶部呈现为胶囊标签，支持点击快速删除或 Backspace 撤销。
- 严谨编排约束：自动为主控 Coordinator 注入硬约束，严禁越界派发给未指定的 Harness；完善级联取消与子任务超时熔断机制。
- 真正的 Agent Team：一个 Lead 可组织最多六个并发的具名 Harness 成员；Team、职责、共享任务依赖图和成员邮箱均由 Host 持久化，teammate 可直接定向通信、交接和反馈，而不是只把并行结果返回 Lead。
- 独立开关：「设置 → 协作」中「多 Agent 协作」与「Agent Team」是两个独立开关（默认均开启）；关闭协作即同时停用团队，关闭团队则保留一次性委派。
- 原生 Team Workbench：对话顶部团队驾驶舱点击「展开详情」后在 Codex 内容流内显示唯一主导者、各成员职责、独立任务列、进度、通信流和事件回放，不覆盖原生侧栏、消息或输入框；成员卡片可跳转其原生子任务。状态直接向 Host 实时刷新，各成员仍使用自己的原生 Harness Session、模型、工具、权限和账户。
- 统一 Workspace 能力：全部 Harness 由 Host 统一获得 Git 探测、Worktree 隔离和最终快照 Diff；原生实时 Diff 继续按各 Harness 实际协议叠加。显式隔离失败不会降级到共享目录。

🧩 原生 Skills 与 MCP 管理
- 17 平台免配置预建：打开会话时自动预建全部 17 个 Harness 声明的原生 Skills 根目录，新安装 Harness 也能即开即用。
- 拖拽安装：在「设置 → Skills」中可将单个 SKILL.md 或完整技能文件夹直接拖拽安装，自带安全路径校验。
- 作用域与安全停用：支持 Global（全局）与 Project（项目级）无缝切换；停用时安全移入保留目录，绝不损坏用户源文件。
- 远程 MCP 支持：支持配置带自定义 Headers 的 Streamable HTTP / SSE 远程服务。

🎨 皮肤市场与可读性保护
- 主题预览与切换：设置 → 皮肤中可预览并应用内置主题，也可随时恢复原生 Codex 外观。
- 全界面覆盖：背景、侧边栏、消息卡片、输入框、按钮和文字颜色统一使用主题令牌。
- 暗色可读性：自动增加遮罩和对比度，避免侧边栏、任务列表和消息内容在深色背景上消失。
- 交互零侵入：不替换 Codex 控件，不修改模型、工具、权限、队列或原生会话。

本地运行

开发环境需要 Windows、macOS 或 Linux，近期 Node.js LTS 和 npm。应用不会读取或保存 Harness 的账户密钥，请先在对应的原生 CLI 中完成安装与登录；平台前提和真机验收范围见 跨平台指南。
git clone https://github.com/emo-xiaoyu/harness-mix.git
cd harness-mix
npm install

从 npm 安装

Harness Mix 发布为 @harness-mix/cli npm 包，命令名仍是 harness-mix。当前发布包包含本次构建平台的 native Shim；macOS/Linux 请在目标系统执行源码构建，完整说明见 跨平台指南。

npm install --global @harness-mix/cli
harness-mix

升级到最新版本：

npm update --global @harness-mix/cli

首次运行会重启已打开的 Codex Desktop。npm 包只分发 Harness Mix 本身；各 Harness 的 CLI、登录状态、模型额度和权限仍需按下表在本机单独安装和配置。

运行方式

原生模式（默认）：本地编译的 Shim 与 Renderer 扩展接入官方 Codex Desktop，模型选择会路由到对应 Harness。首次启动会重启已打开的 Codex Desktop：
npm start

常用原生依赖：

- Codex：安装 @openai/codex，确保 codex 命令可用。
- Pi：确保 pi.cmd 可用。
- Claude Code：SDK 已由 npm 依赖安装，认证仍由 Claude Code 环境管理。
- DeepSeek Harness：使用本项目锁定的 @deepseek-ai/dsh@0.1.2-rc.1。可通过 HARNESS_MIX_DSH_ROOT 显式指定源码目录，但版本必须被内核支持。
- CodeBuddy：安装官方 codebuddy CLI 并完成登录；旧 WorkBuddy 安装也可通过兼容别名继续使用。
- Kiro CLI：安装 kiro-cli，启用 acp 子命令并完成 CLI 登录。
- Cursor CLI：安装 cursor-agent 并完成 CLI 登录。
- Cline：安装 cline（npm i -g cline）并通过 cline auth 完成登录；Harness Mix 以官方 cline --acp 接入。
- Qoder：安装 qodercli（或 qoder）并完成 CLI 登录；ACP 入口由本机版本决定。
- ZCode / Trae：只有在拥有已验证的 ACP 兼容桥接程序时才配置 HARNESS_MIX_ZCODE_ACP_EXECUTABLE / HARNESS_MIX_TRAE_EXECUTABLE，项目不会猜测官方入口。

原生接入方式、数据目录和验证说明见 原生 Codex 接入。

验证

npm run check
npm run test:core-all
npm run e2e:native
npm run smoke:native-ui

涉及原生 Adapter 时，再执行对应的真实链路：

npm run e2e:pi
npm run e2e:dsh
npm run e2e:claude
npm run e2e:codex

部分 E2E 会启动真实 Harness，可能需要本机安装、登录或模型额度。测试生成物写入 output/，不应提交到仓库。

License
Harness Mix 基于 Apache License 2.0 或 MIT 双许可证发布，可任选其一。第三方组件仍适用各自的许可证；归属信息见 NOTICE。

鸣谢

Harness Mix 一路走来，受了下面这些开源项目不少启发。它们都把成果公开在自己的仓库里，本项目的架构分层、协议接线和界面细节都从中获益：

- BytePioneer-AI 的 Codex Desktop 集成项目（MIT）—— 官方 Codex Desktop 原生界面集成（renderer extension / desktop control / shared contracts）的衍生基础，也是整体分层与协议接线的思路来源。
- NanmiCoder/cc-haha —— 多 Agent 协作运行时的编排思路来源。
- xintaofei/codeg —— 工具协议与多 Harness 接线方式的参考。
- HeiGeAi/heige-codex-skin-studio —— 皮肤市场内置皮肤素材的来源。
- Fei-Away/Codex-Dream-Skin 与 miniLV/Anthropic-codex-theme —— 皮肤市场部分内置主题的背景素材与配色方案来源。

以上项目各自适用原有许可证，归属声明与许可正文见 NOTICE 与 licenses/。相关商标仍归各自所有者，本项目仅用于标识所集成的产品，不主张任何商标权、背书或关联关系。

Harness Mix

macOS/Linux 源码构建与启动适配已就位；这些系统上的完整桌面验收仍需在相应机器上运行。安装选项、Linux 桌面先决条件与支持边界见跨平台指南。

⭐ 如果这个项目对你有帮助，请给我们一个 Star！⭐

Codex 原生界面，连接多个原生编码 Harness，并在它们之间无缝交接任务。

当前已注册的 Harness（17）

Antigravity
Codex
Claude Code
Pi

Oh My Pi
DeepSeek
OpenCode
Grok

OpenClaw
Hermes
Qoder
CodeBuddy

Kiro
Cursor
ZCode
Trae

Cline

图标与 Harness 能力来自项目自身的注册表；只有本地安装且握手成功的 Harness 才会进入真实运行。

Harness Mix 是一个本地内核，可接入官方 Codex Desktop 原生 UI。它通过本地编译的 CLI Shim 使用桌面端的 app-server 协议，并将原生编码 Harness——包括 Antigravity、Codex、Pi、Oh My Pi、Claude Code、DeepSeek Harness、OpenCode、Grok、OpenClaw、Hermes、Qoder、CodeBuddy、Kiro CLI、Cursor CLI、ZCode、Trae 和 Cline——连接到同一个 UI 中。Host Runtime 与 Protocol Core 负责任务映射、协作与事件投影；模型调用、工具执行、原生会话和凭据仍由各个 Harness 自身拥有。

UI 预览

该预览来自当前 Codex Desktop 原生窗口：Harness Mix 作为原生扩展入口出现在桌面工具栏和 Composer 中，而会话、模型、工具和权限仍由 Codex Desktop 和各个 Harness 管理。
| 模块 | 核心能力 | 入口与说明 |
| :--- | :--- | :--- |
| 🔄 跨 Harness 任务交接 | 4 种交接模式（继续 / 运行计划 / 独立审查 / 重新分析），过渡平滑 | Composer 交接徽章 / /switch；持久化的脱敏检查点，具备证据可追溯性 |
| 🎨 皮肤市场 | 内置 HeiGe、Codex Styler、Dream Skin 以及经典编辑器调色板主题，支持浅色 / 深色模式、背景装饰和可读性保护 | 设置 → 皮肤；一键预览、应用并恢复默认外观 |
| 📚 历史导入与引用 | 一键导入 Pi / Claude / Codex / CodeBuddy 原生历史记录，支持可中断恢复；# 可引用任意过往会话，并注入脱敏上下文 | 引用仅预取最新一页；只读 MCP 工具 get_session_info / list_session_messages 让 Harness 按需分页浏览并读取分支 / 模型 / 用量元数据 |
| 🤝 多智能体编排 | 输入 # 召唤目标 Harness，将其作为胶囊标签管理，在强协调器约束下进行调度 | Composer # 菜单；循环审查与验证，级联子任务取消和超时熔断 |
| 🧩 原生技能管理 | 覆盖全部 17 个 Harness 的原生技能目录，会话启动时预先创建根目录 | 设置 → 技能；拖放安装单个 SKILL.md 或完整文件夹 |
| 🛠️ 原生 MCP 扩展 | 本地 stdio 与远程 Streamable HTTP / SSE 传输 | 设置 → MCP；支持自定义请求头，按 Harness 应用 |
| 📋 原生消息队列 | 完整集成 Codex 会话队列（添加 / 移除 / 编辑、重新排序、抢占和自动排空） | 原生 Composer 队列；当前轮次完成后，排队消息将按顺序调度 |
| ✅ 可配置验证门禁 | 按任务设置关闭 / 建议 / 必需策略，内置一致性检查和自定义验证命令 | 命令面板 /gate、/verify；必需模式保护隔离分支的合并与推送 |
| 💾 会话存储治理 | schema v3 分片懒加载、无损紧凑存储、迁移备份和大小诊断 | 冷启动仅读取任务索引；仅在打开任务时才恢复其 Core 检查点 |
| 🩹 故障分类与恢复 | 失败的轮次被分类为连接 / 登录 / 配额 / 拒绝 / 服务故障，来源于原生结构化错误（Codex codexErrorInfo 透传）、状态码或消息模式，无匹配时如实标记为未知 | 错误状态跟随任务投影；Renderer 可查询 harnessmix/harness/turn-error 获取分类和操作（重试 / 去登录 / 新会话），登录按钮仅在 Harness 真正支持时出现 |
| 🌐 ChatGPT 侧边栏桥接 | 安全地脱敏并提取当前会话上下文，一键生成结构化草稿 | Web 快捷聊天面板；直接注入 ChatGPT，实现无缝跨工具协作 |
| 👤 账户与用量隔离 | Codex 多账户隔离，支持即时切换；实时 Token / Credits 追踪 | 原生侧边栏与设置面板；每个 Harness 管理各自的凭据、模型与审批 |

🎨 皮肤市场预览

主题资源随项目一同发布，图片使用本仓库的授权素材；应用皮肤仅改变视觉层，绝不会改变 Codex 的原生交互或 Harness 执行行为。

🎀 Miku
🌌 原神之夜

🌠 深空之星
🌊 鸣潮之汐

原生 Harness 支持矩阵

💡 设计原则：每项能力都在 Adapter 的 manifest 中如实声明，UI 根据真实能力渲染，而非根据名称猜测。凭据、模型、工具与权限审批始终由各个原生 Harness 自行掌控。

| Harness | 原生协议 | 流式输出 | 推理 | 工具审批 | 用户提问 | 恢复 / 分叉 | 图片附件 | 原生 Skills | MCP |
| :--- | :--- | :---: | :---: | :---: | :---: | :---: | :---: | :---: | :---: |
| Antigravity | agy CLI (stream-json / Hook) | ✅ | ✅ | ✅ | ✅ | ✅ / ✅ | ✅ | ✅ | ✅ |
| Codex | codex app-server --stdio | ✅ | ✅ | ✅ | ✅ | ✅ / ✅ | ✅ | ✅ | ✅ |
| Claude Code | @anthropic-ai/claude-agent-sdk | ✅ | ✅ | ✅ | ✅ | ✅ / ✅ | ✅ | ✅ | ✅ |
| Pi | pi --mode rpc | ✅ | ✅ | ✅ | ✅ | ✅ / ✅ | ✅ | ✅ | ➖ |
| Oh My Pi | omp --mode rpc (pi-family.js) | ✅ | ✅ | ✅ | ✅ | ✅ / ✅ | ✅ | ✅ | ➖ |
| DeepSeek | 纯 Web Remote / 协作 ACP | ✅ | ✅ | ✅ | ✅ | ✅ / ✅ | ✅ | ✅ | ✅ |
| OpenCode | opencode serve (HTTP / SSE) | ✅ | ✅ | ✅ | ✅ | ✅ / ✅ | ✅ | ✅ | ✅ |
| Grok | grok agent stdio (_x.ai/) | ✅ | ✅ | ✅ | ✅ | ✅ / ✅ | ✅ | ✅ | ✅ |
| OpenClaw | Gateway WebSocket Loopback | ✅ | ➖ | ✅ | ➖ | ✅ / ➖ | ✅ | ✅ | ➖ |
| Hermes | hermes acp | ✅ | ✅ | ✅ | ✅ | ✅ / ✅ | ➖ | ✅ | ✅ |
| CodeBuddy | codebuddy --acp (_codebuddy.ai/) | ✅ | ✅ | ✅ | ✅ | ✅ / ➖ | ✅ | ✅ | ✅ |
| Kiro CLI | kiro-cli acp (_kiro/) | ✅ | ✅ | ✅ | ✅ | ✅ / ✅ | ➖ | ✅ | ✅ |
| Cursor CLI | cursor-agent acp (cursor/) | ✅ | ✅ | ✅ | ✅ | ✅ / ➖ | ➖ | ✅ | ✅ |
| Qoder | qoder --acp | ✅ | ➖ | ✅ | ➖ | ✅ / ➖ | ✅ | ✅ | ✅ |
| ZCode | 兼容 ACP 桥接 | ✅ | ➖ | ✅ | ➖ | ✅ / ➖ | ➖ | ✅ | ✅ |
| Trae | 兼容 ACP 桥接 | ✅ | ➖ | ✅ | ➖ | ✅ / ➖ | ➖ | ✅ | ✅ |
| Cline | cline --acp | ✅ | ✅ | ✅ | ➖ | ✅ / ➖ | ✅ | ✅ | ✅ |

注意：✅ 表示原生支持并已端到端打通；➖ 表示上游协议当前未暴露或未声明该能力；只有本地安装且握手成功的 Harness 才会进入真实运行。详见 Native ACP Deep Integration 和 Harness Management。

核心功能

🔄 跨 Harness 任务交接
一个 Harness 深入分析，另一个编写实现，然后你切换回原来的 Harness 进行交叉审查——所有这些都在同一个 Codex Desktop 原生窗口内无缝完成：
- 上下文完整保留：对话历史、未提交的代码更改、Git 状态和审查记录全部延续。
- 持久化检查点：带哈希的交接快照，自动脱敏测试证据和敏感密钥，可随时暂停和恢复。
- 独立会话恢复：每个 Harness 的原生会话和参数单独存储，切换回来时调用其原生恢复机制（例如 Pi --session 或 Claude resume）。
- 四种交接模式：“继续”、“运行上一个计划”、“独立审查”和“重新分析”。

🤝 多智能体协作
- 解耦触发：在原生编辑器中输入 # 打开协作菜单（#pi、#claude、#codex、#dsh）；官方 @ 菜单完全保留给 Codex 原生功能。
- 标签可视化：选中的协作 Agent 以胶囊标签形式显示在编辑器上方，支持点击移除和 Backspace 撤销。
- 严格编排约束：协调器自动注入硬约束，禁止向未指定的 Harness 派发任务；内置级联取消和子任务超时熔断。
- 真正的 Agent Teams：一个 Lead 最多可组织六个并发的具名 Harness 成员；Team、角色、共享任务依赖图和成员邮箱均由 Host 持久化，因此队友之间可以直接通信、交接和汇报，而不仅仅是向 Lead 返回并行结果。
- 独立开关：设置 → 协作提供多智能体协作和 Agent Team 的独立开关（默认均开启）；禁用协作同时禁用团队，而禁用团队则保留一次性委派能力。
- 原生团队工作台：展开对话顶部的团队驾驶舱详情，可在 Codex 内容流中显示单一负责人、成员角色、每位成员的任务泳道、进度、消息流和事件回放——而不会遮挡原生侧边栏、消息或编辑器。成员卡片可跳转到其原生子任务。状态从 Host 实时刷新，成员继续使用各自的原生 Harness 会话、模型、工具、权限和账户。
- 统一工作区能力：每个 Harness 都统一获得 Host 拥有的 Git 检测、工作树隔离和最终快照差异；原生实时差异会根据每个 Harness 的真实协议继续叠加在其上。显式的隔离失败绝不会降级为共享目录。

🧩 原生 Skills 与 MCP 管理
- 跨 17 个平台的零配置预创建：打开会话时会预创建全部 17 个 Harness 声明的原生 Skills 根目录，因此即使是新安装的 Harness 也能开箱即用。
- 拖放安装：在 设置 → Skills 中，拖入单个 SKILL.md 或完整的技能文件夹即可安装，并内置安全路径校验。
- 作用域化且安全的禁用：可在 Global 和 Project 作用域之间无缝切换；禁用会将技能移入保留目录，绝不会破坏用户源文件。
- 远程 MCP 支持：配置带有自定义请求头的 Streamable HTTP / SSE 远程服务器。

🎨 皮肤市场与可读性保护
- 主题预览与切换：在 设置 → Skins 中预览并应用内置主题，或随时恢复 Codex 原始外观。
- 全 UI 覆盖：背景、侧边栏、消息卡片、编辑器、按钮和文本颜色均遵循主题令牌。
- 深色模式可读性：自动叠加层和对比度确保侧边栏、任务列表和消息内容在深色背景上清晰可见。
- 零交互侵入：不会替换任何 Codex 控件，也绝不会修改模型、工具、权限、队列和原生会话。

本地运行

开发需要 Windows、macOS 或 Linux、较新的 Node.js LTS 和 npm。该应用绝不会读取或存储 Harness 账户凭据——请先安装并登录各个原生 CLI；平台先决条件和设备端验收范围请参阅跨平台指南。
git clone https://github.com/emo-xiaoyu/harness-mix.git
cd harness-mix
npm install

从 npm 安装

Harness Mix 以 @harness-mix/cli npm 包的形式发布，命令仍然是 harness-mix。当前版本捆绑了构建它的平台的原生 Shim；在 macOS/Linux 上，请在目标系统上从源码构建——完整详情见跨平台指南。

npm install --global @harness-mix/cli
harness-mix

升级到最新版本：

npm update --global @harness-mix/cli
首次运行会重启一个已经打开的 Codex Desktop。npm 包只分发 Harness Mix 本身；每个 Harness 的 CLI、登录状态、模型配额和权限仍需要按下面列出的方式在本地安装和配置。

如何运行

原生模式（默认）：本地编译的 Shim 和 Renderer 扩展会接入官方 Codex Desktop，模型选择会路由到对应的 Harness。首次启动会重启一个已经打开的 Codex Desktop：
npm start

常见原生依赖：

- Codex：安装 @openai/codex，并确保 codex 命令可用。
- Pi：确保 pi.cmd 可用。
- Claude Code：SDK 作为 npm 依赖随包提供；认证仍由 Claude Code 环境管理。
- DeepSeek Harness：使用本项目锁定的 @deepseek-ai/dsh@0.1.2-rc.1 版本。HARNESS_MIX_DSH_ROOT 可以显式指向源代码检出目录，但版本必须受内核支持。
- CodeBuddy：安装官方 codebuddy CLI 并登录；旧的 WorkBuddy 安装可通过兼容别名继续工作。
- Kiro CLI：安装 kiro-cli，启用 acp 子命令并登录。
- Cursor CLI：安装 cursor-agent 并登录。
- Cline：安装 cline（npm i -g cline）并通过 cline auth 登录；Harness Mix 通过官方 cline --acp 连接。
- Qoder：安装 qodercli（或 qoder）并登录；ACP 入口取决于已安装的版本。
- ZCode / Trae：只有在拥有经过验证的 ACP 兼容桥接时，才设置 HARNESS_MIX_ZCODE_ACP_EXECUTABLE / HARNESS_MIX_TRAE_EXECUTABLE；本项目绝不会猜测官方入口点。

有关接线、数据目录和验证说明，请参见 Native Codex Integration。

验证

npm run check
npm run test:core-all
npm run e2e:native
npm run smoke:native-ui

当涉及原生 Adapter 时，还要运行对应的真实链路：

npm run e2e:pi
npm run e2e:dsh
npm run e2e:claude
npm run e2e:codex

一些 E2E 套件会启动真实的 Harness，可能需要本地安装、登录或模型配额。测试产物会写入 output/，不应提交。

许可证

Harness Mix 采用双重许可，您可以选择 Apache License 2.0 或 MIT。第三方组件仍受其各自许可证约束；有关署名信息，请参见 NOTICE。

致谢

Harness Mix 在很大程度上得益于以下开源项目。它们都在自己的仓库中发布作品，本项目的架构、协议接线和接口细节都从中受益：

- BytePioneer-AI 的 Codex Desktop 集成项目（MIT）——原生 Codex Desktop 集成（renderer 扩展、桌面控制、共享契约）的上游基础，也是其整体分层和协议接线的来源。
- NanmiCoder/cc-haha — 多 Agent 协作运行时背后的编排方案。
- xintaofei/codeg — 工具协议与多 Harness 接线的参考。
- HeiGeAi/heige-codex-skin-studio — 皮肤市场中捆绑的美术资源。
- Fei-Away/Codex-Dream-Skin 和 miniLV/Anthropic-codex-theme — 用于额外内置皮肤的背景美术和配色方案。

每个项目仍受其自身许可证约束；有关归属记录和上游许可证文本，请参见 NOTICE 和 licenses/。所有商标仍归其各自所有者所有。它们被捆绑在此仅用于标识本项目所集成的产品，并不主张任何商标权、认可或关联关系。