chenchenandClaude Opus 4.8
2c60af0216
agent_swarm PR#41 已合并 main(契约冻结),HM 补齐客户端+swarm 双方点名需要的
两条透传端点(均设备签名,挂 /api/heicode/swarms/:id 下):
- POST /swarms/:id/input → 代理 Swarm POST …/{deployment_id}/input(追加用户输入,
注入 source=user_append;终态 run 自动 reopen,stopped 拒绝)。写路,需
SWARM_RUNTIME_ENABLED+base+token,缺一即拒不伪造受理。**指令文本仅转发,绝不落
HM 日志/审计/事件**(#40 原文不进事件流 + #46 勿落日志);审计只记发生过一次 append。
- GET /swarms/:id/result → 代理 Swarm GET …/{deployment_id}/result,返回
{summary, deliverable, artifacts[], termination_reason, status};产物按 uri 取非内联。
读路,需 base+token(与派发开关解耦);透出前 stripSensitiveKeys 递归剔除 secret_ref 等兜底。
新增:callSwarmRuntimeJSON(通用 JSON 调用 + envelope 归一,错误信息不含请求体)、
agentRuntimeSwarm{Input,Result}Path(默认 create-path 基路径,SWARM_RUNTIME_{INPUT,RESULT}_PATH 可覆盖)。
测试:swarm_io_proxy_test.go 覆盖路径构造(默认/空回退/env 覆盖)、input 转发(方法/路径/鉴权/body)、
result 解析 + deliverable/artifacts 脱敏、运行时非 2xx 报错。go build ./... + controller/router 全绿。
影响面:Manager ✅(透传端点)/ agent_swarm ✅(消费 PR#41 契约)/ Client ✅(驾驶舱 I/O 闭环)/
Agent ❌ / CodeGW ❌ / 计费 ❌ / 密钥 ❌(不经手 secret)/ 审计 ✅(input_appended,不含原文)/ 发布链路 ❌
Refs #46 #28。Depends-on-contract: agent_swarm PR#41 (已合并 main)。
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Heicode
Heicode 面向多人协作、可追溯交付的软件团队：把需求对齐、实现、验证、发布和持续运营连成一条少断层的链路，并用可编排的智能体角色承接其中可标准化的环节——强调「能复盘、能审计、能按团队规模裁剪」，而不是罗列某一家的工具栈。
下面的目录表仅供工程查阅；不代表对外产品承诺、路线图或你必须采用的集成方式。
本仓 = Heicode Manager（HM）端。 历史上终端/桌面客户端（
cc-haha）、官网（website）与 Manager 曾同处一个 monorepo；现已拆分，本仓只保留 Heicode Manager（基于 new-api 的模型网关 + 管理控制台）。客户端（终端 + 桌面）在heicode-macos-release-dev/heicode-winos-release-dev独立仓。
这个仓库里有什么（工程布局）
| 目录 | 大致含义 |
|---|---|
heicode/ |
Heicode Manager：基于 new-api 的模型网关 + 管理控制台。Go（Gin/GORM）后端 + web/default 前端（Bun/Rsbuild/React）。 |
docs/ |
产品共识、实施计划与集成契约（索引见 docs/README.md）。 |
客户端与官网不在本仓。
产品在解决什么问题
- 协作范式：把瀑布 / 敏捷下的角色分工落到可复述的闸门与智能体承接边界。
- 交付可追溯：文档、沟通与变更尽量与版本、发布对齐，便于复盘与合规。
- 模型与执行分层：HM 提供模型网关与权限 / 计费；云端 agent 由 agent_management（AM）部署，客户端拿到 agent 公网地址后直连 agent 使用。
产品定位与架构共识见 docs/heicode.md，实施计划见 docs/plan.md。
快速启动（开发联调）
Heicode Manager 在 heicode/ 子目录：Go 后端 + web/default 前端。完整构建 / 运行命令与分层规则见 heicode/CLAUDE.md 与 heicode/README.md。
与 Heicode 登录相关的最小路由（以实际代码为准）：
GET /heicode/oauth/authorizeGET /heicode/oauth/session
平台侧能力还包括模型发现（如 GET /v1/models）与 Anthropic Messages 兼容入口等。
集成与对接契约见 docs/integration/（HM↔AM、桌面客户端对接等）。
许可证
heicode/（Heicode Manager，基于 new-api）许可证见 heicode/LICENSE（常见为 AGPLv3）。