Heicode

Heicode 面向多人协作、可追溯交付的软件团队：把需求对齐、实现、验证、发布和持续运营连成一条少断层的链路，并用可编排的智能体角色承接其中可标准化的环节——强调「能复盘、能审计、能按团队规模裁剪」，而不是罗列某一家的工具栈。

下面的目录表仅供工程查阅；不代表对外产品承诺、路线图或你必须采用的集成方式。

这个仓库里有什么（工程布局）

目录	大致含义
cc-haha/	Heicode（终端与桌面客户端及本地服务；此为源码目录名）。
new-api/	Heicode Manager（网关与管理控制台服务端；此为源码目录名）。
website/	产品介绍的静态页面（可本地 Docker 预览）。
docs/	愿景与范式；docs/milestones/ 交付里程碑；docs/integration/ Agnet 等平台接口设计。
_all-in-one-upload/	历史或打包目录（按需维护）。

产品在解决什么问题

• 协作范式：把瀑布 / 敏捷下的角色分工落到可复述的闸门与智能体承接边界（方向与原则见 docs/vision-heicode-full-stack-agentic-dev.md；编队明细在文档附录）。
• 交付可追溯：文档、沟通与变更尽量与版本、发布对齐，便于复盘与合规。
• 工程上：同一仓库便于客户端与服务端同步发版、统一回归，减少「谁和谁版本对不上」的摩擦。

详细愿景与范式

docs/vision-heicode-full-stack-agentic-dev.md

快速启动（开发联调）

# 根依赖（Bun monorepo 根目录）
bun install

# Heicode 客户端本地服务（目录 cc-haha）
cd cc-haha
bun run src/server/index.ts

# 另开终端：桌面端
cd cc-haha/desktop
bun run tauri dev

联调网关时示例：

HEICODE_TAIJIAICLOUD_BASE_URL=http://localhost:3000 bun run src/server/index.ts

Heicode Manager（new-api/）中与 Heicode 登录相关的路由（最小集，以实际代码为准）：

• GET /heicode/oauth/authorize
• GET /heicode/oauth/session

平台侧能力还包括模型发现（如 GET /v1/models）与 Anthropic Messages 兼容入口等，详见 Heicode Manager（new-api/）与 Heicode 客户端（cc-haha/）各自 README。

官网静态站（本地 Docker）

cd /path/to/heicode
docker compose up --build

浏览器访问：http://localhost:8888

若拉取 nginx:alpine 超时，请配置 Docker 镜像加速；也可直接打开 website/index.html 离线浏览（部分字体依赖 Google Fonts）。

发版与回归建议

• 同一版本标签发布客户端与网关镜像。
• 每次发版至少回归：登录、模型拉取、对话请求。
• 先在本地 Docker / 本地联调通过，再做外网域名与证书。

相关外部参考（概念）

• oh-my-claudecode — Claude Code 类工具的高效实践参考。
• Agnet 平台以实际部署环境与文档为准。

许可证

各子项目许可证见各子目录内 LICENSE（例如 Heicode Manager / new-api/ 侧常见为 AGPLv3）。