Files

T

chenchenandClaude Opus 4.8 0fe1d20d67 feat(agent): unify agnet→agent and implement client/runtime unification spec v0.1 core

按桌面客户端统一方案 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>

2026-06-01 23:45:10 +08:00

4.4 KiB

Raw Blame History

01. 产品说明文档

产品名称

Heicode

产品定位

Heicode 是一款覆盖软件生命周期的智能开发 Code 工具。它面向的是“从想法到上线”的完整开发过程，而不是单个模型聊天窗口、CodeGW 管理后台或简单的 Agent 控制台。

用户只需要注册登录，输入想法和约束，Heicode 就帮助用户组织子 Agent 团队，接入用户授权的 Git、SK、项目文档和云资源，完成产品设计、代码开发、代码检查、部署、观测和后续维护。

目标用户

用户	典型问题	Heicode 价值
独立开发者	有想法但缺工程团队	用 AI 团队完成从需求到上线
创业团队	人少、迭代快、交付压力大	用 Heicode 编排产品、开发、测试、部署流程
企业创新团队	有资源和代码，但协作成本高	在既有 Git 和云资源边界内受控开发
技术负责人	担心权限、成本、质量和审计	统一资源授权、模型用量、日志和审计

核心价值

把自然语言想法变成可执行的软件开发任务。
把 Git、文档、SK、云资源变成可授权、可撤销、可审计的资源。
把子 Agent 的角色、权限、模型和上下文组织成可运行的开发团队。
把持续开发拆成需求、设计、开发、测试、修复、部署等子环节，由 Agent 持续推进。
让 Agent 在执行过程中可以调用项目 SK 工具和外部能力，而不是只做一次性任务分发。
把模型调用、余额、额度和日志统一展示给用户。
把长期密钥放入密钥保管器，只给子 Agent 短期、最小权限凭证。
把开发、检查、部署、维护纳入同一个生命周期闭环。

产品形态

产品面	说明
Heicode 客户端	用户主体验，负责本地对话、输入想法、继续开发、查看执行反馈、接收交付结果和高危审批，只登录 Heicode，只使用 Heicode 提供的模型
Heicode Manager / 浏览器控制台	辅助控制台，负责账号与安全、客户端下载、Git/云资源绑定、Agent 部署、任务状态总览、模型余额与用量、审计与日志查看
Agent 平台	执行层，负责部署和运行子 Agent，在任务推进过程中完成需求、开发、测试、修复、交付与部署，并回传日志、状态、事件和指标
CodeGW	内部模型网关与计费服务，普通用户不直接进入后台
密钥保管器	Azure Key Vault 实现，保存长期凭证引用，按审批和权限提供短期访问能力

说明：Heicode 客户端是用户主体验，用户不在网页上编码。Heicode Manager 是浏览器里的辅助控制台，承担资源、部署、状态、余额、审计和下载等辅助操作。真正持续推进任务的是 Heicode 调度下的 Agent 执行闭环，Agent 在过程中还可以调用已授权的 SK 工具和外部能力，最终完成交付与部署并把结果回传到客户端。

核心流程

注册登录
-> 输入产品想法
-> 生成产品文档和任务计划
-> 在 Manager 绑定 Git 和云资源
-> 在 Manager 部署 Agent
-> 客户端继续追加需求和修正方向
-> Agent 按子环节执行需求、开发、测试、修复
-> Agent 按需要调用已授权 SK 工具
-> 客户端确认高危操作
-> Agent 完成交付物整理和部署
-> Manager 查看状态、余额、审计和下载
-> 客户端展示执行反馈和交付结果
-> 持续维护和升级

差异化

对比对象	差异
普通 AI 聊天工具	Heicode 不只回答问题，而是组织资源、权限和执行团队
IDE 插件	Heicode 不局限于本地代码编辑，而覆盖部署、审计和生命周期
CodeGW 后台	Heicode 不管理渠道后台，面向用户完成开发任务
传统 DevOps 平台	Heicode 以自然语言和 AI 团队为核心，自动生成任务和执行上下文

产品承诺

用户不需要理解底层模型供应商。
用户不需要把密钥交给子 Agent 长期保存。
用户可以清楚知道哪些资源被哪个角色使用。
高危操作必须经过客户端审批。
所有关键动作都能审计。

当前一句话卖点

从一个想法开始，让 Heicode 组织 AI 开发团队，持续调用 Agent 完成开发、测试、交付与部署，安全接入你的代码和云资源，把产品推进到生产环境。

4.4 KiB Raw Blame History