# 08. Heicode 客户端说明

## 客户端定位

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

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

客户端必须保持：

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

## 登录

客户端登录地址：

```text
https://code.xinghanlab.com
```

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

## 模型

客户端模型来源：

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

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

## 主要功能

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

## 客户端里的 Agnet 闭环

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

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

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

## 高危审批体验

审批弹窗应清楚展示：

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

用户操作：

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

## 安装包分发

安装包由 Heicode 下载页提供。

平台：

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

macOS 注意：

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

## 客户端不应该出现的内容

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

## 验收标准

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