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>
49 lines
3.8 KiB
Markdown
49 lines
3.8 KiB
Markdown
# Heicode 产品资料包
|
||
|
||
版本：v0.1
|
||
日期：2026-05-07
|
||
用途：对外介绍、官网设计、销售沟通、内部产品对齐、演示和用户上手。
|
||
|
||
## 资料包目录
|
||
|
||
| 文档 | 用途 |
|
||
|------|------|
|
||
| [`01-product-overview.md`](./01-product-overview.md) | 产品说明文档，回答 Heicode 是什么、解决什么问题、系统边界是什么 |
|
||
| [`02-homepage-design-brief.md`](./02-homepage-design-brief.md) | 产品首页设计文档，指导官网首页结构、文案和视觉重点 |
|
||
| [`03-user-journey-and-core-flow.md`](./03-user-journey-and-core-flow.md) | 用户旅程与核心流程，描述从想法到上线的完整路径 |
|
||
| [`04-platform-usage-guide.md`](./04-platform-usage-guide.md) | 登录平台和使用平台指南，面向真实用户上手 |
|
||
| [`05-ppt-copy.md`](./05-ppt-copy.md) | 产品 PPT 文案，面向路演、客户介绍和团队同步 |
|
||
| [`06-security-and-credential-management.md`](./06-security-and-credential-management.md) | 安全与凭证管理说明，解释密钥保管器、`secret_ref`、高危审批 |
|
||
| [`07-integration-boundaries.md`](./07-integration-boundaries.md) | CodeGW、Azure Key Vault、Agent 平台边界说明 |
|
||
| [`08-client-guide.md`](./08-client-guide.md) | Heicode 客户端说明，强调只登录 Heicode、只使用 Heicode 模型 |
|
||
| [`09-demo-script.md`](./09-demo-script.md) | 5 分钟演示脚本，用于产品演示和录屏 |
|
||
| [`10-frontend-detail-spec.md`](./10-frontend-detail-spec.md) | 前端细节说明，覆盖 Heicode 和客户端页面、组件、状态、文案规则 |
|
||
| [`11-product-prototype-wireframes.md`](./11-product-prototype-wireframes.md) | 产品原型图，说明 Heicode 客户端主体验、Manager 辅助控制台与 Agent 执行闭环的边界 |
|
||
| [`12-narrated-user-operation-flow.md`](./12-narrated-user-operation-flow.md) | 口述用户操作流程，用于演示、培训、录屏旁白和销售讲解 |
|
||
| [`13-platform-description.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 命名不作为产品主线。
|