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>
3.3 KiB
3.3 KiB
08. Heicode 客户端说明
客户端定位
Heicode 客户端是用户主体验，承担本地对话、想法输入、任务推进、执行反馈、交付接收和高危审批。它不是独立模型配置工具，也不是 CodeGW 后台客户端。
Heicode Manager 不是主体验，但它仍然负责账号与安全、客户端下载、Git/云资源绑定、Agent 部署、任务状态、余额与审计等辅助操作。用户不在网页上编码，主要在客户端里推进开发任务。
客户端必须保持：
- 只登录 Heicode。
- 只使用 Heicode 提供的模型。
- 不出现模型提供方选择。
- 不出现旧服务入口。
- 视觉风格与 Heicode 保持一致。
登录
客户端登录地址：
https://code.xinghanlab.com
用户打开客户端后，点击登录，跳转或打开 Heicode 登录流程。登录完成后，客户端读取 Heicode 会话状态。
模型
客户端模型来源：
Heicode
-> CodeGW 用户侧模型能力
-> 客户端展示可用模型
客户端不内置默认 Claude 模型，也不让用户选择模型提供方。用户看到什么模型，由 Heicode 和 CodeGW 映射决定。
主要功能
| 功能 | 说明 |
|---|---|
| 对话输入 | 用户描述产品想法、开发任务或维护需求 |
| 任务推进 | 继续要求、查看 Agent 执行反馈、接收交付结果 |
| 任务状态 | 查看 Heicode 返回的任务和子 Agent 进度 |
| 模型选择 | 从 Heicode 提供的模型中选择 |
| 高危审批 | 对生产部署、密钥访问、云操作做确认 |
| 日志反馈 | 展示关键执行反馈和失败原因 |
| 安装更新 | 从 Heicode 下载页获取安装包 |
客户端里的 Agent 闭环
客户端里发生的不是单次对话，而是持续推进的任务闭环：
用户输入想法或补充要求
-> Heicode 判断当前子任务
-> 调用 Agent 执行需求/开发/测试/修复/部署中的某一环
-> Agent 按权限调用需要的 SK 工具
-> 中间结果、失败原因和下一步建议回到客户端
-> 用户继续补充、修正或审批
-> Agent 继续推进
-> 最终返回交付物和部署结果
所以客户端应该更像“任务驾驶舱”，而不是一次性聊天窗口。
高危审批体验
审批弹窗应清楚展示：
- 操作类型。
- 目标资源。
- 请求角色。
- 风险等级。
- 有效期。
- 预计影响。
- 是否会派生短期凭证。
用户操作：
- 批准。
- 拒绝。
- 查看详情。
安装包分发
安装包由 Heicode 下载页提供。
平台：
- macOS arm64。
- Windows。
- 后续可扩展 Linux。
macOS 注意：
- 如果未完成 Developer ID 签名和 notarization，系统可能弹出安全提示。
- 产品文案应说明当前安装方式和后续签名计划。
客户端不应该出现的内容
- 模型提供方配置。
- 旧登录入口。
- 第三方路由登录入口。
- CodeGW 后台入口。
- Azure Key Vault 地址、access token 或密钥保管器后台信息。
- 长期云密钥输入框。
- 无法解释的个人 API key 自动复制。
验收标准
- 打开客户端只看到 Heicode 登录入口。
- 登录地址是
https://code.xinghanlab.com。 - 模型列表来自 Heicode。
- 没有模型提供方菜单。
- 没有旧品牌和旧模型默认文案。
- 高危审批能明确展示风险和资源范围。