# Heicode 产品资料包

版本：v0.1
日期：2026-05-07
用途：对外介绍、官网设计、销售沟通、内部产品对齐、演示和用户上手。

## 资料包目录

| 文档 | 用途 |
|------|------|
| [`01-product-overview.md`](./01-product-overview.md) | 产品说明文档，回答 Heicode 是什么、解决什么问题、系统边界是什么 |
| [`02-homepage-design-brief.md`](./02-homepage-design-brief.md) | 产品首页设计文档，指导官网首页结构、文案和视觉重点 |
| [`03-user-journey-and-core-flow.md`](./03-user-journey-and-core-flow.md) | 用户旅程与核心流程，描述从想法到上线的完整路径 |
| [`04-platform-usage-guide.md`](./04-platform-usage-guide.md) | 登录平台和使用平台指南，面向真实用户上手 |
| [`05-ppt-copy.md`](./05-ppt-copy.md) | 产品 PPT 文案，面向路演、客户介绍和团队同步 |
| [`06-security-and-credential-management.md`](./06-security-and-credential-management.md) | 安全与凭证管理说明，解释密钥保管器、`secret_ref`、高危审批 |
| [`07-integration-boundaries.md`](./07-integration-boundaries.md) | CodeGW、OpenBao、Agnet 平台边界说明 |
| [`08-client-guide.md`](./08-client-guide.md) | Heicode 客户端说明，强调只登录 Heicode、只使用 Heicode 模型 |
| [`09-demo-script.md`](./09-demo-script.md) | 5 分钟演示脚本，用于产品演示和录屏 |
| [`10-frontend-detail-spec.md`](./10-frontend-detail-spec.md) | 前端细节说明，覆盖 Heicode 和客户端页面、组件、状态、文案规则 |
| [`11-product-prototype-wireframes.md`](./11-product-prototype-wireframes.md) | 产品原型图，说明 Heicode 客户端主体验、Manager 辅助控制台与 Agnet 执行闭环的边界 |
| [`12-narrated-user-operation-flow.md`](./12-narrated-user-operation-flow.md) | 口述用户操作流程，用于演示、培训、录屏旁白和销售讲解 |
| [`13-platform-description.md`](./13-platform-description.md) | 平台说明文档，解释平台组成、使用方式、系统边界和常见问题 |

## 统一表述

Heicode 是一款面向全流程智能开发的 SaaS Code 工具。用户注册登录后，只需要输入想法，平台逐步完成需求澄清、产品文档、原型描述、代码开发、代码检查、生产部署、后续维护和升级。

对外一句话：

> Heicode 让用户从一个想法开始，组织 AI 开发团队，接入自己的代码和云资源，完成从产品设计到生产部署的软件生命周期。

## 命名规则

- 用户侧叫 `Heicode`，不要叫 CodeGW 后台。
- `Heicode 客户端` 是用户主体验，用于对话、输入想法、推进开发任务、查看执行反馈、高危审批和接收交付结果。
- `Heicode Manager` 是浏览器里的辅助控制台，负责账号与安全、客户端下载、Git/云资源绑定、Agnet 部署、任务状态、余额与审计。
- 继续开发时，Heicode 会持续调用 Agnet 推进需求、开发、测试、修复和部署等子环节。
- Agnet 在执行过程中可以调用已授权的 SK 工具，最终完成交付与部署并把结果回传给客户端和 Manager。
- 用户侧叫 `密钥保管器`，技术实现可以说明是 OpenBao。
- 用户侧叫 `资源绑定`，不要叫 Git 来源。
- 客户端不出现 `模型提供方`、`旧服务入口`、`第三方路由入口`。
- CodeGW 是内部模型网关和计费服务，不作为普通用户产品入口。
- Agnet 平台是执行层，不替代 Heicode 的用户控制台。

## 当前产品边界

当前资料包以 `docs/heicode.md`、`docs/plan.md`、`docs/product-requirements.md` 为依据。旧 Agnet 草案、旧 M1-M5 计划和旧 UI 命名不作为产品主线。