**[中文化] harnessrouter**

此项目是 [HarnessRouter/harnessrouter](https://github.com/HarnessRouter/harnessrouter) 的中文翻译版本。

• 原项目 Stars: 2993
• 主语言: Python
• 许可证: Apache-2.0
• 翻译日期: 2026-10-14
• 原始 README: README_en.md

说明：下方 README 正文为**原项目文档的中文翻译**，力求忠于原文；本页顶部的「中文快速上手」为**面向中文用户的补充导读**（非原文内容），目的是让你不用读完整篇 README 就能先把项目跑起来。

如有翻译不准确之处，欢迎提 Issue 或 PR。

---

🚀 中文快速上手（补充导读，非原文）

这是什么 / 解决什么问题

HarnessRouter 是一个「agent harness 的统一接口」基础设施层。它把 Codex、Claude Code 这类已有的 harness 变成即插即用的 agent 后端，让你的产品通过一个 API 就能运行任务、取回结果、切换 harness。它实现了 Unified Harness Protocol (UHP)，并提供兼容 OpenAI Responses 的 API，负责处理持久会话、流式进度、文件、产物、取消和结构化失败。

快速上手（最短路径）

1. 启动 HarnessRouter（需已安装 Docker）：

docker run -d --name harnessrouter \
  -p 127.0.0.1:3000:3000 \
  -v harnessrouter:/data \
  harnessrouter/harnessrouter

1. 等待首次启动完成（首次启动会安装启用的 harness CLI）：

docker logs -f harnessrouter

当日志出现 `[harnessrouter] ready on :3000` 时继续。按 Ctrl+C 停止跟踪日志，容器会继续运行。

1. 打开控制台 [http://localhost:3000](http://localhost:3000)，使用默认凭据登录：用户名 `harnessrouter`，密码 `harnessrouter`。

2. 在侧边栏打开 **Bring Your Own Key**，点击 **Add Integration**，选择 provider、命名并填入其 API key，其支持的模型即可在控制台中使用。

（原文 README 前 7000 字在此处截断，后续步骤原文未说明。）

环境要求

• 操作系统：原文未说明（仅给出 Docker 运行方式）。
• 硬件：约 4 GB 磁盘空间。
• 依赖：Docker；一个 provider API key。
• 版本要求：原文未说明。
• 国内网络环境提示：原文未提及镜像源或加速下载相关内容，如需可自行考虑更换 Docker 镜像源。

常见坑与注意事项

• 需要自备 provider API key：无需 HarnessRouter 账号，也没有捆绑的模型或试用 key。
• 首次启动会安装 harness CLI，需要等待；若控制台未就绪或某个 harness 缺失，可查看日志中的 backends available: 及 requested but not installed 警告。
• 不要加 --user：entrypoint 和 Runner 需要 root 来管理每会话用户。
• 默认密码必须修改：登录后应在 Profile 中修改默认密码，修改前保持实例仅本地可访问；保存会短暂重启控制台并登出其他浏览器。

---

---

<