01. 产品说明文档

产品定位

Heicode 是一款覆盖软件生命周期的智能开发 Code 工具。它面向的是“从想法到上线”的完整开发过程，而不是单个模型聊天窗口、CodeGW 管理后台或简单的 Agent 控制台。

用户只需要注册登录，输入想法和约束，Heicode 就帮助用户组织子 Agent 团队，接入用户授权的 Git、SK、项目文档和云资源，完成产品设计、代码开发、代码检查、部署、观测和后续维护。

当前状态（实现进度，避免过度承诺）：当前已接入并经生产验证的是模板 Agent 主链路（用户在 Manager 选模板 + 资源部署常驻 Agent，客户端直连使用，模型调用经 Manager 计费）。多 Agent 蜂群运行时在 agent_swarm （HeiCode Swarm），运行时契约待冻结后接入。「从想法到上线」的完整生命周期闭环仍在建设中，本文对产品形态的描述为目标形态，不代表所有环节均已全量上线。

目标用户

用户	典型问题	Heicode 价值
独立开发者	有想法但缺工程团队	用 AI 团队完成从需求到上线
创业团队	人少、迭代快、交付压力大	用 Heicode 编排产品、开发、测试、部署流程
企业创新团队	有资源和代码，但协作成本高	在既有 Git 和云资源边界内受控开发
技术负责人	担心权限、成本、质量和审计	统一资源授权、模型用量、日志和审计

核心价值

把自然语言想法变成可执行的软件开发任务。
把 Git、文档、SK、云资源变成用户可按流程连接、确认和撤销的任务上下文。
把子 Agent 的角色、权限、模型和上下文自动组织成可运行的开发团队，普通用户只确认摘要。
把持续开发拆成需求、设计、开发、测试、修复、部署等子环节，由 Agent 持续推进。
让 Agent 在执行过程中可以调用项目 SK 工具和外部能力，而不是只做一次性任务分发。
把模型调用、余额、额度和日志统一展示给用户。
把长期密钥放入密钥保管器，只给子 Agent 短期、最小权限凭证。
把开发、检查、部署、维护纳入同一个生命周期闭环。

产品形态

产品面	说明
Heicode 客户端	用户主体验，负责本地对话、输入想法、继续开发、查看执行反馈、接收交付结果和高危审批，只登录 Heicode，只使用 Heicode 提供的模型
Heicode Manager / 浏览器控制台	辅助控制台，负责账号与安全、客户端下载、资源准备向导、Agent 启动、任务状态总览、模型余额与用量、审计与日志查看
Agent 平台	执行层，负责部署和运行子 Agent，在任务推进过程中完成需求、开发、测试、修复、交付与部署，并回传日志、状态、事件和指标
CodeGW	内部模型网关与计费服务，普通用户不直接进入后台
密钥保管器	Azure Key Vault 实现，保存长期凭证，按审批和权限提供短期凭证租约

说明：Heicode 客户端是用户主体验，用户不在网页上编码。Heicode Manager 是浏览器里的辅助控制台，承担资源准备、Agent 启动、状态、余额、审计和下载等辅助操作。Manager 不应该让用户面对完整参数，而应该用任务准备清单引导用户完成必要确认。真正持续推进任务的是 Heicode 调度下的 Agent 执行闭环，Agent 在过程中还可以调用已授权的 SK 工具和外部能力，最终完成交付与部署并把结果回传到客户端。

核心流程

注册登录
-> 输入产品想法
-> 生成产品文档和任务计划
-> 在 Manager 按准备清单连接 Git、SK、文档和云账号
-> Heicode 自动发现资源并生成执行摘要
-> 用户确认推荐范围并启动 Agent
-> 客户端继续追加需求和修正方向
-> Agent 按子环节执行需求、开发、测试、修复
-> Agent 按需要调用已授权 SK 工具
-> 客户端确认高危操作
-> Agent 完成交付物整理和部署
-> Manager 查看状态、余额、审计和下载
-> 客户端展示执行反馈和交付结果
-> 持续维护和升级

差异化

对比对象	差异
普通 AI 聊天工具	Heicode 不只回答问题，而是组织资源、权限和执行团队
IDE 插件	Heicode 不局限于本地代码编辑，而覆盖部署、审计和生命周期
CodeGW 后台	Heicode 不管理渠道后台，面向用户完成开发任务
传统 DevOps 平台	Heicode 以自然语言和 AI 团队为核心，自动生成任务和执行上下文

产品承诺

用户不需要理解底层模型供应商。
用户不需要把密钥交给子 Agent 长期保存。
用户不需要查看或填写完整技术参数，只确认系统整理后的资源、风险和执行摘要。
高危操作必须经过客户端审批。
所有关键动作都能审计。

从一个想法开始，让 Heicode 组织 AI 开发团队，持续调用 Agent 完成开发、测试、交付与部署，安全接入你的代码和云资源，把产品推进到生产环境。

介绍