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>
Heicode 产品资料包
版本：v0.1 日期：2026-05-07 用途：对外介绍、官网设计、销售沟通、内部产品对齐、演示和用户上手。
资料包目录
| 文档 | 用途 |
|---|---|
01-product-overview.md |
产品说明文档，回答 Heicode 是什么、解决什么问题、系统边界是什么 |
02-homepage-design-brief.md |
产品首页设计文档，指导官网首页结构、文案和视觉重点 |
03-user-journey-and-core-flow.md |
用户旅程与核心流程，描述从想法到上线的完整路径 |
04-platform-usage-guide.md |
登录平台和使用平台指南，面向真实用户上手 |
05-ppt-copy.md |
产品 PPT 文案，面向路演、客户介绍和团队同步 |
06-security-and-credential-management.md |
安全与凭证管理说明，解释密钥保管器、secret_ref、高危审批 |
07-integration-boundaries.md |
CodeGW、Azure Key Vault、Agent 平台边界说明 |
08-client-guide.md |
Heicode 客户端说明，强调只登录 Heicode、只使用 Heicode 模型 |
09-demo-script.md |
5 分钟演示脚本，用于产品演示和录屏 |
10-frontend-detail-spec.md |
前端细节说明，覆盖 Heicode 和客户端页面、组件、状态、文案规则 |
11-product-prototype-wireframes.md |
产品原型图，说明 Heicode 客户端主体验、Manager 辅助控制台与 Agent 执行闭环的边界 |
12-narrated-user-operation-flow.md |
口述用户操作流程，用于演示、培训、录屏旁白和销售讲解 |
13-platform-description.md |
平台说明文档，解释平台组成、使用方式、系统边界和常见问题 |
统一表述
Heicode 是一款面向全流程智能开发的 SaaS Code 工具。用户注册登录后，只需要输入想法，平台逐步完成需求澄清、产品文档、原型描述、代码开发、代码检查、生产部署、后续维护和升级。
对外一句话：
Heicode 让用户从一个想法开始，组织 AI 开发团队，接入自己的代码和云资源，完成从产品设计到生产部署的软件生命周期。
命名规则
- 用户侧叫
Heicode，不要叫 CodeGW 后台。 Heicode 客户端是用户主体验，用于对话、输入想法、推进开发任务、查看执行反馈、高危审批和接收交付结果。Heicode Manager是浏览器里的辅助控制台，负责账号与安全、客户端下载、Git/云资源绑定、Agent 部署、任务状态、余额与审计。- 继续开发时，Heicode 会持续调用 Agent 推进需求、开发、测试、修复和部署等子环节。
- Agent 在执行过程中可以调用已授权的 SK 工具，最终完成交付与部署并把结果回传给客户端和 Manager。
- 用户侧叫
密钥保管器，技术实现可以说明是 Azure Key Vault；Manager 通过 VM Managed Identity 访问，不要求普通用户进入 Key Vault 后台。 - 用户侧叫
资源绑定，不要叫 Git 来源。 - 客户端不出现
模型提供方、旧服务入口、第三方路由入口。 - CodeGW 是内部模型网关和计费服务，不作为普通用户产品入口。
- Agent 平台是执行层，不替代 Heicode 的用户控制台。
当前产品边界
当前资料包以 docs/heicode.md、docs/plan.md、docs/product-requirements.md 为依据。旧 Agent 草案、旧 M1-M5 计划和旧 UI 命名不作为产品主线。