P089 HarnessRouter/harnessrouter

信息卡

项目	内容
仓库	HarnessRouter/harnessrouter
语言 / 许可证	Python / Apache-2.0
总星标	⭐ 611（截至 2026-08-26）
创建时间	2026-08-09
榜单	近30天新星榜第39名

一句话定位

在自己机器上运行 AI Agent Harness 的自托管方案：单容器内置 Claude Code、Codex、Pi、DeepSeek Harness、Hermes 五个后端，暴露 OpenAI Responses 兼容 API 与完整控制台，自带 API 密钥、无账号无云端无遥测。

走红原因分析

"多 Agent CLI 各装各的"是当下真实混乱，本项目把五种 harness 收进一个 Docker 容器并统一成一套 API，痛点抓得准；它同时押注开放标准 UHP（Unified Harness Protocol，规范版本 2026-08-11），自称是参考实现且通过 class Full 符合性测试，给了"不锁定厂商"的叙事；真实工作区（bash/git/文件系统而非沙箱模拟）加会话级独立系统用户隔离，工程姿态专业；Slides/Sheets/Dashboards/Videos 四个可启动 Starter Kit 让人五分钟看到完整产品形态。

核心功能拆解

五后端运行时选择：`HR_BACKENDS` 环境变量启用 claude/codex/hermes/pi/dsh/opencode；
BYOK 模型接入：Integrations 页填 provider+API key，密钥不出镜像不外发；
OpenAI Responses 兼容 `/v1` API：turn 执行、harness CRUD、sessions、SSE 流式、取消与幂等性；
会话硬隔离：每会话独立工作目录与独立系统用户，容器 root 启动后自行降权；
Starter Kits：对话式幻灯片、表格内逐行跑 harness 的 agent 列、只读 SELECT 数据库仪表盘（连接串加密存储）、按镜头合成视频；
Tasks 控制台实时流式展示命令、文件改动与回答 transcript；

7. Push to cloud：一键单向推送到官方托管服务。

架构与技术栈浅析

三层结构：Next.js UI 占唯一对外端口 :3000 → 同源代理到仅 loopback 的 Gateway :8080（Responses API）→ Runner :8081 为每会话各起一个 agent CLI。存储走适配器接口（records/files/secrets），CE 本地实现与托管版共享同一代码库——这是它宣称 "not a reduced fork" 的结构基础。工作区默认 72 小时空闲 TTL，按检查点重组。

安装与环境要求

前置仅需 Docker、约 4 GB 磁盘、任一模型商 API key。六步上手：拉镜像（约 700MB）→ `docker run -d -p 127.0.0.1:3000:3000 -v harnessrouter:/data …` → 看日志就绪 → 用默认 harnessrouter/harnessrouter 登录并立即改密 → Integrations 加模型 → New Task 开跑。注意容器禁止 `--user` 参数。

快速上手示例

docker pull harnessrouter/harnessrouter
docker run -d --name harnessrouter -p 127.0.0.1:3000:3000 \
  -v harnessrouter:/data harnessrouter/harnessrouter
# 浏览器登录 :3000 后，或直接调 API：
curl -X POST http://127.0.0.1:3000/api/harness/v1/responses \
  -d '{"input":"...","metadata":{"harness_id":"codex"},"model":"gpt-5.4-mini"}'

进阶使用要点

脚本化部署用 HR_SECRET_GLOBAL_HARNESS_CONN_* 连接 JSON 与 POLICY_ 路由链；provider-backend 兼容表要留意（如 bedrock 不支持 Codex 与 DSH），控制台只列可行组合而环境变量配错会静默返回空 turn；公网暴露务必先改密码并用 TLS 反代前置，Caddy 需 `flush_interval -1` 保 SSE 不被缓冲；严禁使用 0.1.x/0.2.0（无登录门），0.3.0 起才有认证。

典型应用场景

团队内部统一多个 Agent CLI 的私有网关与审计留痕点；
用 Dashboards Kit 让 agent 对自有数据库做安全只读问答报表；
代码库批量任务的 headless 自动化调用方；
UHP 协议研究与二实现的合规性验证平台。

资源导航

官网 harnessrouter.ai（文档/云服务/定价）；UHP 标准站 unifiedharnessprotocol.org；协议规范、OpenAPI 3.1 与 conformance 工具都在仓库 protocol/ 目录；治理见 protocol/GOVERNANCE.md；Starter Kits 有独立仓库；社区走 Discord，安全报告走 SECURITY.md。

HarnessRouter/harnessrouter

信息卡