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

3.8 KiB

Raw Blame History

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 命名不作为产品主线。

3.8 KiB Raw Blame History Unescape Escape