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>
4.1 KiB
4.1 KiB
05. 产品 PPT 文案
Slide 1：标题
标题：
Heicode
副标题：
从一个想法，到可上线的软件产品
讲述：
Heicode 是一款全流程智能开发 Code 工具。它让用户输入想法，接入自己的代码和云资源，由 AI 开发团队完成需求、开发、检查、部署和维护。
Slide 2：问题
标题：
AI 已经会写代码，但软件交付仍然很难
要点：
- 想法到需求、原型、代码之间仍然断裂。
- AI 工具通常不能安全使用真实 Git、云资源和密钥。
- 多 Agent 协作缺少角色、权限、状态和审计。
- 模型用量、余额和日志分散在后台系统。
- 部署和后续维护没有统一生命周期。
Slide 3：解决方案
标题：
Heicode 把开发过程变成可编排的 AI 团队任务
要点：
- 用户输入自然语言目标。
- Heicode 生成任务、角色、权限和执行上下文。
- 客户端是主体验，Manager 负责资源、部署和审计辅助。
- 子 Agent 按角色推进开发、测试、修复和部署，并可调用 SK 工具。
- 密钥进入密钥保管器，子 Agent 只拿短期凭证。
- Heicode 展示模型用量、日志、事件和审计。
Slide 4：产品工作流
标题：
一条从想法到上线的主流程
流程：
登录
-> 客户端输入想法
-> Manager 绑定资源
-> Manager 部署 Agent
-> 客户端继续推进任务
-> Agent 执行开发/测试/修复并调用 SK
-> 审批高危操作
-> Agent 交付与部署
-> 观测与维护
讲述：
用户不需要直接操作 CodeGW 后台，也不需要直接管理 Azure Key Vault。所有操作都在 Heicode 和客户端内完成。
Slide 5：核心能力
标题：
Heicode 的四个核心能力
- 想法转开发任务。
- 资源绑定和权限分配。
- 子 Agent 编排和执行。
- 用量、日志、安全和审计闭环。
Slide 6：系统架构
标题：
Heicode 产品面连接执行、模型和密钥底座
架构：
用户 / 客户端
-> Heicode Manager
-> Agent 平台
-> CodeGW
-> Azure Key Vault
-> Git / SK / 云资源
讲述：
客户端是主体验，Manager 是辅助控制台。Agent 平台是执行层，执行过程中可调用 SK。CodeGW 是模型网关和计费服务。Azure Key Vault 是密钥保管器。
Slide 7：安全模型
标题：
资源可用，密钥不外泄
要点：
- Heicode 服务端数据库只保存
secret_ref。 - 长期密钥进入 Azure Key Vault。
- 子 Agent 只获得短期、最小权限凭证。
- 高危操作必须在客户端审批。
- 日志、Markdown、前端响应不包含明文密钥。
Slide 8：用户价值
标题：
让小团队拥有完整软件交付能力
对独立开发者：
- 更快从想法到 MVP。
对创业团队：
- 用更少人力完成产品迭代。
对企业团队：
- 在权限和审计边界内使用 AI 开发。
对技术负责人：
- 控制资源、成本、质量和风险。
Slide 9：当前 MVP
标题：
当前 MVP 先闭环三件事
- Heicode、CodeGW、Azure Key Vault 解耦部署。
- 资源绑定、Resource Grant、manifest 和密钥保管。
- 客户端只登录 Heicode，只使用 Heicode 模型。
延期项：
- Heicode 到 Agent 平台真实部署 API 的完整联调。
Slide 10：路线图
标题：
从可用工具到生命周期平台
阶段：
- 资源绑定和密钥保管。
- CodeGW 用户侧模型和用量展示。
- 客户端登录、审批和下载闭环。
- Agent 平台真实部署联调。
- 自动维护、升级、成本和质量观测。
Slide 11：演示故事
标题：
5 分钟看懂 Heicode
演示：
- 登录 Heicode。
- 客户端输入产品想法。
- Manager 绑定 Git 和云资源。
- Manager 部署 Agent 并展示权限。
- 客户端继续推进任务。
- 展示 Agent 调用 SK 和当前子环节。
- 客户端审批高危操作。
- 查看交付、部署结果、日志和模型用量。
Slide 12：结束页
标题：
Heicode，让想法进入真实开发流程
收尾语：
不是只生成代码，而是把产品、代码、权限、模型、部署和维护组织成一个可审计的软件生命周期。