af094dde279ccbe99df5e4fa30fcde21042601c9
#9 的审计脱敏半部已由 PR#11 完成。据评审报告(L95 usage/billing 结构完整、 L112 监控 mock metrics 属 AM)核实:HM 侧通用用量聚合并不缺,真正缺的是 agent 维度用量视图。 - model.SumAgentUsage(userId, tokenName, start, end):按 agent 铸币 token 名 'agent:<deployment_id>' 聚合 consume 日志(quota/prompt/completion/调用数), COALESCE+COUNT/SUM 跨 SQLite/MySQL/PG。 - GET /api/heicode/agents/:deployment_id/usage:返回该 agent 用量 + quota_per_unit (raw,调用方换算,与 /api/heicode/self 同契约),支持 ?start=&end= 时间窗。 - 测试 model/agent_usage_test.go:聚合正确、排除他人/非消费/不同 token、时间窗、空名。 go build/vet 干净;测试 PASS。 Refs #9 (审计脱敏半部 PR#11 已完成;监控 mock metrics 属 AM 侧) Co-authored-by: chenchen <chenchen@xinghanlab.com> Co-authored-by: Claude Opus 4.8 <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)。
Languages
Go
98.8%
Python
1.1%