heicode-mananger/docs/product-package/08-client-guide.md

08. Heicode 客户端说明

客户端定位

Heicode 客户端是用户主体验，承担本地对话、想法输入、任务推进、执行反馈、交付接收和高危审批。它不是独立模型配置工具，也不是 CodeGW 后台客户端。

Heicode Manager 不是主体验，但它仍然负责账号与安全、客户端下载、Git/云资源绑定、Agnet 部署、任务状态、余额与审计等辅助操作。用户不在网页上编码，主要在客户端里推进开发任务。

客户端必须保持：

• 只登录 Heicode。
• 只使用 Heicode 提供的模型。
• 不出现模型提供方选择。
• 不出现旧服务入口。
• 视觉风格与 Heicode 保持一致。

登录

客户端登录地址：

https://code.xinghanlab.com

用户打开客户端后，点击登录，跳转或打开 Heicode 登录流程。登录完成后，客户端读取 Heicode 会话状态。

模型

客户端模型来源：

Heicode
-> CodeGW 用户侧模型能力
-> 客户端展示可用模型

客户端不内置默认 Claude 模型，也不让用户选择模型提供方。用户看到什么模型，由 Heicode 和 CodeGW 映射决定。

主要功能

功能	说明
对话输入	用户描述产品想法、开发任务或维护需求
任务推进	继续要求、查看 Agnet 执行反馈、接收交付结果
任务状态	查看 Heicode 返回的任务和子 Agnet 进度
模型选择	从 Heicode 提供的模型中选择
高危审批	对生产部署、密钥访问、云操作做确认
日志反馈	展示关键执行反馈和失败原因
安装更新	从 Heicode 下载页获取安装包

客户端里的 Agnet 闭环

客户端里发生的不是单次对话，而是持续推进的任务闭环：

用户输入想法或补充要求
-> Heicode 判断当前子任务
-> 调用 Agnet 执行需求/开发/测试/修复/部署中的某一环
-> Agnet 按权限调用需要的 SK 工具
-> 中间结果、失败原因和下一步建议回到客户端
-> 用户继续补充、修正或审批
-> Agnet 继续推进
-> 最终返回交付物和部署结果

所以客户端应该更像“任务驾驶舱”，而不是一次性聊天窗口。

高危审批体验

审批弹窗应清楚展示：

• 操作类型。
• 目标资源。
• 请求角色。
• 风险等级。
• 有效期。
• 预计影响。
• 是否会派生短期凭证。

用户操作：

• 批准。
• 拒绝。
• 查看详情。

安装包分发

安装包由 Heicode 下载页提供。

平台：

• macOS arm64。
• Windows。
• 后续可扩展 Linux。

macOS 注意：

• 如果未完成 Developer ID 签名和 notarization，系统可能弹出安全提示。
• 产品文案应说明当前安装方式和后续签名计划。

客户端不应该出现的内容

1. 模型提供方配置。
2. 旧登录入口。
3. 第三方路由登录入口。
4. CodeGW 后台入口。
5. Azure Key Vault 地址、access token 或密钥保管器后台信息。
6. 长期云密钥输入框。
7. 无法解释的个人 API key 自动复制。

验收标准

1. 打开客户端只看到 Heicode 登录入口。
2. 登录地址是 https://code.xinghanlab.com。
3. 模型列表来自 Heicode。
4. 没有模型提供方菜单。
5. 没有旧品牌和旧模型默认文案。
6. 高危审批能明确展示风险和资源范围。