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.4 KiB
4.4 KiB
04. 登录平台和使用平台指南
面向用户
本文面向第一次使用 Heicode 的普通用户，说明如何登录、绑定资源、下载客户端、创建任务和查看结果。
访问入口
平台入口：
https://code.xinghanlab.com
用户只需要登录 Heicode。普通用户不需要登录 CodeGW 后台，也不需要登录 Azure Key Vault。
第一步：登录 Heicode
- 打开
https://code.xinghanlab.com。 - 输入账号和密码，或使用平台支持的登录方式。
- 登录成功后进入 Heicode 控制台。
- 进入首页，查看资源、模型、任务和客户端下载状态。
登录后平台会读取：
- 用户 ID。
- 用户邮箱。
- 用户角色。
channelId。
这些信息用于用户身份、CodeGW 额度和用量映射。
第二步：下载客户端
- 在 Heicode 控制台进入
客户端下载。 - 选择对应系统版本，例如 macOS 或 Windows。
- 下载并安装 Heicode 客户端。
- 打开客户端后，只需要登录
https://code.xinghanlab.com。
客户端不会要求选择模型提供方。客户端可用模型由 Heicode 提供。
macOS 提示说明：
- 如果安装时出现系统安全提示，说明当前安装包可能还没有完成 Apple Developer ID 签名和 notarization。
- 用户可以按平台提供的安装说明继续打开。
- 长期方案应完成签名和 notarization。
第三步：在客户端输入想法
主要在 Heicode 客户端输入要做的事情。Manager 负责下载、资源绑定、Agent 部署、状态和审计等辅助能力，不承担主开发对话。
例如：
我想做一个面向小团队的任务管理 SaaS，
需要登录、项目、任务、评论、通知和后台管理，
希望部署到 Azure。
平台会生成：
- 需求摘要。
- 产品文档草案。
- 推荐开发角色。
- 需要绑定的资源。
- 高危操作提示。
第四步：绑定资源
进入 资源绑定。
可绑定资源：
- 代码仓库。
- SK 仓库或技能包。
- 项目文档。
- 云账号。
- 云资源。
推荐流程：
先绑定 Git
-> 再绑定项目文档或 SK
-> 再绑定云账号
-> 从云账号自动发现资源
-> 选择允许使用的云资源
用户不需要把密钥贴到文档里。真实凭证由 Heicode 写入密钥保管器，Heicode 只保存 secret_ref。
第五步：分配权限
用户可以使用平台推荐角色：
- Product Agent。
- Architect Agent。
- Frontend Agent。
- Backend Agent。
- Reviewer Agent。
- Ops Agent。
每个角色确认：
- 能访问哪些仓库。
- 能读写哪些路径。
- 能使用哪些云资源。
- 哪些操作需要审批。
- 授权是否有有效期。
第六步：确认高危操作
高危操作会在客户端审批。
常见高危操作：
- 生产部署。
- 修改数据库。
- 创建或删除云资源。
- 访问生产密钥。
- 大额模型预算消耗。
用户确认后，平台才会为子 Agent 派生短期凭证。
第七步：启动任务
用户确认任务后，Heicode 会生成：
- 子 Agent 角色。
- AGENT.md。
- resource context。
- permission manifest。
- 模型和预算配置。
- 审批策略。
Heicode 将这些内容提交给 Agent 平台执行。
第八步：在客户端持续推进
任务开始后，主流程回到客户端。
闭环应理解为：
客户端继续补充要求
-> Heicode 生成下一步子任务
-> Agent 执行需求/开发/测试/修复/部署中的当前环节
-> Agent 按权限调用需要的 SK 工具
-> 中间结果和失败原因回到客户端
-> 用户继续修正或审批
-> 最终返回交付物和部署结果
第九步：查看执行结果
用户可以在 Heicode 查看：
- 当前任务状态。
- 子 Agent 活动状态。
- 运行日志。
- 失败原因。
- 模型用量。
- 资源访问记录。
- 高危审批记录。
- 部署结果。
第十步：维护和升级
上线后，用户可以继续输入：
- 修复 bug。
- 增加功能。
- 优化性能。
- 升级依赖。
- 调整部署资源。
Heicode 会复用已有项目上下文、资源绑定和审计信息。
用户注意事项
- 不要把密钥写入需求、Markdown、聊天内容或 Git。
- 授权云资源时先从测试环境开始。
- 生产部署必须仔细确认审批内容。
- 如果不确定某个资源是否应该授权，选择只读或暂不授权。
- CodeGW 后台不是普通用户入口，模型和余额在 Heicode 中查看。