# 07. CodeGW、Azure Key Vault、Agnet 平台边界说明

## 目标

本文用于讲清楚 Heicode 与 CodeGW、Azure Key Vault、Agnet 平台之间的产品和技术边界，避免再次变成缝合式系统。

## 总体边界

| 系统 | 能力归属 | 普通用户是否直接进入 |
|------|----------|----------------------|
| Heicode | 产品总入口，包含客户端主体验与 Manager 辅助控制台 | 是 |
| CodeGW | 模型网关、模型调用、余额、额度、用量日志 | 否 |
| Azure Key Vault | 长期凭证托管、密钥引用、后端受控读取 | 否 |
| Agnet 平台 | AKS 执行层、状态、日志、事件、指标 | 否 |

## Heicode 与 CodeGW

Heicode 使用 CodeGW 的方式：

- 查询普通用户可见模型。
- 查询余额和额度。
- 查询用量和调用日志。
- 建立 `channelId`、CodeGW user、token 或 group 的映射。

Heicode 不做：

- CodeGW 渠道管理。
- CodeGW 模型供应商配置。
- CodeGW 价格配置。
- CodeGW 管理员用户管理。
- 把 CodeGW 后台开放给普通用户。

产品口径：

> CodeGW 是 Heicode 的模型网关和计费底座，用户在 Heicode 中查看模型和用量，不直接使用 CodeGW 后台。

## Heicode 与 Azure Key Vault

Heicode 使用 Azure Key Vault 的方式：

- 写入用户授权后的长期凭证。
- 保存和管理 `secret_ref`。
- 执行密钥健康检查、metadata、轮换、禁用、撤销。
- 为高危操作申请短期凭证。

Heicode 不做：

- 在数据库保存明文密钥。
- 把 Azure Key Vault access token 交给前端。
- 把 Azure Key Vault 管理入口作为普通用户入口暴露。

产品口径：

> 密钥保管器负责保存凭证，Heicode 只保存引用。子 Agnet 使用资源时，平台按权限和审批结果获取短期访问能力。

## Heicode 与 Agnet 平台

Heicode 传给 Agnet 平台：

- 用户上下文。
- 任务目标。
- 子 Agnet 角色。
- AGENT.md。
- resource context。
- permission manifest。
- `secret_ref`。
- 审批策略。
- 模型和预算配置。
- `sk_context` / `tool_permissions`。
- 回调地址。

Agnet 平台回传 Heicode：

- deployment 状态。
- 子 Agnet 状态。
- 事件。
- 日志。
- 指标。
- 审计事件。
- 使用量。
- 当前子环节状态。
- 中间交付物。
- 部署结果。

Heicode 不传：

- 长期明文密钥。
- CodeGW key 原文。
- Azure Key Vault 管理凭据。
- 数据库密码。

产品口径：

> Heicode 决定用户想做什么、能用什么资源和谁来做；Agnet 平台负责把这些任务安全运行起来，在过程中按权限调用需要的 SK 工具，并把子环节状态、交付物和部署结果回传给 Heicode。

## 客户端与 Manager 的边界

客户端主做：

- 登录 Heicode。
- 对话和任务输入。
- 继续补充要求和修正方向。
- 展示 Heicode 提供的模型。
- 高危操作审批。
- 查看执行反馈和交付结果。

Manager 主做：

- 账号与安全。
- 客户端下载。
- Git、文档、SK、云资源绑定。
- Agnet 部署。
- 任务状态、用量和审计查看。
- 风险与授权范围确认。

客户端不做：

- 选择模型提供方。
- 配置 CodeGW 渠道。
- 直接访问 Azure Key Vault。
- 直接保存长期云密钥。

Manager 不做：

- 主开发对话。
- 网页编码。
- 替代客户端完成高危审批。

## 当前延期项

Heicode 到 Agnet 平台真实部署 API 的完整联调仍可延期。

但 Heicode 侧必须准备好：

- payload。
- manifest。
- 审计字段。
- callback URL。
- 本地占位控制面。
- 日志、事件、指标的数据展示位置。

## 验收口径

1. 普通用户只进入 Heicode。
2. 客户端只登录 Heicode。
3. CodeGW 独立服务运行。
4. Azure Key Vault 只通过 Manager 后端受控身份访问，普通用户不直接进入。
5. Agnet 平台接口只收结构化上下文和 `secret_ref`，不收长期明文密钥。