chenchenandClaude Opus 4.8
0fe1d20d67
按桌面客户端统一方案 v0.1 + agent_management Sub Mode Runtime 对接,强制全量统一,不留兼容。
命名统一(强制,无兼容):
- 全仓 agnet/Agnet/AGNET → agent/Agent/AGENT:后端 Go(路由 /api/agent/*、env AGENT_*、
结构体/函数、19 个文件改名)、前端(agent-console/agent-hub、/api/agent 调用、i18n)、
DB(表 agent_*、列 agent_id)、compose/.env、文档、脚本。
- DB 加幂等迁移 renameAgnetTablesToAgent():启动时 rename 老 agnet_* 表/列,保住生产数据。
统一方案核心(10 项):
- callback 统一 /api/agent/callbacks/runtime-events(路由/广播URL/函数名)。
- artifact 兜底判定改用 Runtime 权威信号 metadata.synthesized(§7.2)+ 结构化 artifact_type。
- Manager→Runtime 路径对齐 /api/agent/sub-agile/deployments(§2.2),{deployment_id} 回退 swarm_id。
- 状态裁决 display_status:Manager 唯一裁判,completed 无有效产物→needs_codegen/
completed_without_deliverable(§10.6),接入 detail/timeline/workflow。
- GET /api/heicode/capabilities 能力发现(§6)。
- 模型策略 per_role(role_models)+ 收集 allowed_model_ids(§9)。
- resource_binding_id→secret_ref 服务端解析,客户端不再 inline secret_ref(§17.6)。
- 客户端统一路由层 /api/heicode/sub-agile|swarm/*(task≡deployment,复用控制面)+ workflow 投影。
- 日志分层 user_logs/debug_logs(§13)。
验证:go build ./... + go test(controller/router/model/middleware)全绿;前端 tsc -b + rsbuild build 通过。
待部署:VM .env 的 AGNET_*→AGENT_*;启动迁移自动 rename 表;其他三仓库需同步切到 /api/agent。
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
76 lines
3.1 KiB
Markdown
76 lines
3.1 KiB
Markdown
# Heicode
|
||
|
||
Heicode 面向**多人协作、可追溯交付**的软件团队：把需求对齐、实现、验证、发布和持续运营连成一条少断层的链路，并用**可编排的智能体角色**承接其中可标准化的环节——强调「能复盘、能审计、能按团队规模裁剪」，而不是罗列某一家的工具栈。
|
||
|
||
下面的目录表仅供工程查阅；**不代表对外产品承诺、路线图或你必须采用的集成方式。 **
|
||
|
||
## 这个仓库里有什么（工程布局）
|
||
|
||
| 目录 | 大致含义 |
|
||
|------|----------|
|
||
| `cc-haha/` | **Heicode**（终端与桌面客户端及本地服务；此为源码目录名）。 |
|
||
| `heicode/` | **Heicode Manager**（网关与管理控制台服务端；此为源码目录名）。 |
|
||
| `website/` | 产品介绍站点（Next.js；可 `pnpm dev` 或 Docker 预览）。 |
|
||
| `docs/` | 愿景与范式；**[`docs/milestones/`](./docs/milestones/README.md)** 交付里程碑；**[`docs/integration/`](./docs/integration/README.md)** Agent 等平台接口设计。 |
|
||
|
||
## 产品在解决什么问题
|
||
|
||
- **协作范式**：把瀑布 / 敏捷下的角色分工落到可复述的闸门与智能体承接边界（**方向与原则**见 `docs/vision-heicode-full-stack-agentic-dev.md`；编队明细在文档附录）。
|
||
- **交付可追溯**：文档、沟通与变更尽量与版本、发布对齐，便于复盘与合规。
|
||
- **工程上**：同一仓库便于客户端与服务端**同步发版、统一回归**，减少「谁和谁版本对不上」的摩擦。
|
||
|
||
## 详细愿景与范式
|
||
|
||
**[docs/vision-heicode-full-stack-agentic-dev.md](./docs/vision-heicode-full-stack-agentic-dev.md)**
|
||
|
||
## 快速启动（开发联调）
|
||
|
||
```bash
|
||
# 根依赖（Bun monorepo 根目录）
|
||
bun install
|
||
|
||
# Heicode 客户端本地服务（目录 cc-haha）
|
||
cd cc-haha
|
||
bun run src/server/index.ts
|
||
|
||
# 另开终端：桌面端
|
||
cd cc-haha/desktop
|
||
bun run tauri dev
|
||
```
|
||
|
||
联调网关时示例：
|
||
|
||
```bash
|
||
HEICODE_TAIJIAICLOUD_BASE_URL=http://localhost:3000 bun run src/server/index.ts
|
||
```
|
||
|
||
**Heicode Manager**（`heicode/`）中与 Heicode 登录相关的路由（最小集，以实际代码为准）：
|
||
|
||
- `GET /heicode/oauth/authorize`
|
||
- `GET /heicode/oauth/session`
|
||
|
||
平台侧能力还包括模型发现（如 `GET /v1/models`）与 Anthropic Messages 兼容入口等，详见 **Heicode Manager**（`heicode/`）与 **Heicode 客户端**（`cc-haha/`）各自 README。
|
||
|
||
## 官网（Next.js）
|
||
|
||
```bash
|
||
cd website && pnpm install && pnpm dev
|
||
```
|
||
|
||
若根目录提供 `docker compose`，可按 compose 说明构建预览镜像（以仓库内 `docker-compose.yml` 为准）。
|
||
|
||
## 发版与回归建议
|
||
|
||
- 同一版本标签发布客户端与网关镜像。
|
||
- 每次发版至少回归：**登录**、**模型拉取**、**对话请求**。
|
||
- 先在本地 Docker / 本地联调通过，再做外网域名与证书。
|
||
|
||
## 相关外部参考（概念）
|
||
|
||
- [oh-my-claudecode](https://ohmyclaudecode.com/) — Claude Code 类工具的高效实践参考。
|
||
- Agent 平台以实际部署环境与文档为准。
|
||
|
||
## 许可证
|
||
|
||
各子项目许可证见各子目录内 `LICENSE`（例如 Heicode Manager / `heicode/` 侧常见为 AGPLv3）。
|