# 12. 口述用户操作流程 ## 使用场景 本文用于产品演示、培训、录屏旁白和销售讲解。语气以真实用户操作为主，不讲复杂技术实现；当需要解释安全、模型、密钥和 Agnet 平台时，只讲用户需要理解的边界。 ## 一句话开场 > 我现在打开 Heicode，从一个产品想法开始，绑定我的代码和云资源，让平台生成 AI 开发团队，并在我确认权限和高危操作后推进开发、部署和维护。 ## 完整口述流程 ### 1. 打开平台 我先打开 Heicode 的平台地址： ```text https://code.xinghanlab.com ``` 这里是 Heicode 的浏览器控制台，也就是 Heicode Manager。后续我不会直接进入 CodeGW 后台，也不会直接进入密钥保管器后台。Manager 负责资源、部署、状态和审计等辅助动作；真正持续推进开发任务和高危审批，主要会回到客户端完成。 ### 2. 登录账号 我输入账号和密码登录。 登录成功后，平台会识别我的用户身份，包括用户 ID、邮箱、角色和 `channelId`。这些信息用于后续模型额度、用量和审计归属。 用户不需要理解 `channelId` 的技术细节，只需要知道：我的模型余额、调用记录和任务消耗都能在 Heicode 里看到。 ### 3. 进入首页 登录后，我首先进入首页。 首页会告诉我： - 当前有没有正在运行的任务。 - 有没有失败任务。 - 有没有待我审批的高危操作。 - 我绑定了哪些资源。 - 模型余额和今日用量。 - 客户端是否已经下载。 如果我是第一次使用，首页会提示我下一步：输入产品想法、绑定资源或下载客户端。 ### 4. 下载客户端 如果我还没有安装客户端，我会先进入“客户端下载”。 这里可以看到适合我系统的安装包，比如 macOS 或 Windows。下载安装后，我打开客户端。 客户端只需要登录： ```text https://code.xinghanlab.com ``` 客户端不会让我选择模型提供方，也不会出现 旧服务入口 或其他旧入口。客户端里能用什么模型，由 Heicode 提供。 ### 5. 输入产品想法 回到 Heicode 或客户端，我输入我的产品想法。 比如我输入： ```text 我想做一个小团队任务管理 SaaS， 需要登录、项目、任务、评论、通知和后台管理， 希望部署到 Azure。 ``` 我不需要一开始就写完整 PRD。Heicode 会先理解我的目标，再帮我生成需求摘要、功能清单、原型描述和需要的资源。 ### 6. 查看平台生成的任务草案 平台会根据我的输入生成一个任务草案。 我可以看到： - 这个产品要解决什么问题。 - 第一版包含哪些功能。 - 推荐哪些页面和接口。 - 需要哪些代码仓库、文档、SK 和云资源。 - 建议使用哪些子 Agnet 角色。 - 哪些操作可能属于高危操作。 如果草案不准确，我可以直接修改。确认后，Heicode 会提示我补充这个任务需要的上下文。 ### 7. 绑定代码仓库 在任务上下文卡片里，我先授权代码仓库。 如果我已有项目仓库，我可以授权 GitHub、GitLab、Gitea、Gitee 或自建 Git。平台会让我选择仓库、分支和允许访问的路径。 例如： - 仓库：`repo-main` - 分支：`main` - 后端路径：`services/api/**` - 前端路径：`web/**` 这里的重点不是把 Git token 贴在页面里，而是完成授权。真实凭证会进入密钥保管器，Heicode 只保存密钥引用。 ### 8. 绑定项目文档和 SK 如果我有产品文档、原型描述或技能仓库，我继续绑定项目文档和 SK。 项目文档可以作为 Product Agnet 和 Architect Agnet 的上下文。SK 可以作为子 Agnet 可调用的技能来源。 绑定后，平台知道： - 哪些文档可以读。 - 哪些技能可以使用。 - 哪些路径和版本有效。 ### 9. 绑定云账号 接下来我绑定云资源，比如 Azure、AWS 或 GCP。 以 Azure 为例，我授权云账号后，平台会尽量自动发现我账号下的资源，比如： - 虚拟机。 - 数据库。 - 存储。 - Kubernetes 或 AKS。 - 资源组。 我不应该手动填写一堆复杂资源 ID。正常体验应该是：平台发现资源，我选择哪些资源允许 Heicode 使用。 ### 10. 选择允许使用的云资源 云账号授权后，我从自动发现列表里选择资源。 例如： - 允许使用测试环境 AKS。 - 允许读取开发数据库。 - 不允许直接操作生产数据库。 - 生产部署必须审批。 保存后，这些云资源会变成 Resource Binding。 ### 11. 确认密钥保管状态 资源绑定完成后，我能看到密钥保管状态。 我看到的是： - 已托管。 - 无需密钥。 - 待补充。 - 已撤销。 - 异常。 我不会看到明文密钥。平台最多展示 `secret_ref` 这种引用，让我知道凭证由密钥保管器管理。 ### 12. 生成子 Agnet 团队 资源准备好后，Heicode 会推荐一组子 Agnet 角色。 例如： - Product Agnet：负责需求和验收标准。 - Architect Agnet：负责架构和技术方案。 - Frontend Agnet：负责页面和交互。 - Backend Agnet：负责 API、数据模型和服务逻辑。 - Reviewer Agnet：负责代码检查和安全审查。 - Ops Agnet：负责构建、部署和运行观察。 我可以使用推荐团队，也可以增减角色。 ### 13. 分配资源权限 接下来我确认每个角色可以使用哪些资源。 例如： Backend Agnet 可以： - 读项目文档。 - 读写后端代码路径。 - 使用开发数据库。 Frontend Agnet 可以： - 读项目文档。 - 读写前端代码路径。 Ops Agnet 可以： - 部署测试环境。 - 请求生产部署审批。 这一步不要求我手写复杂策略。页面应该用角色卡片告诉我：这个角色能用什么、能做什么、是否需要审批。 ### 14. 预览权限清单 如果我想看更详细的权限，我可以打开 manifest 预览。 这里会展示： - 资源 ID。 - 资源类型。 - 允许动作。 - 限制条件。 - `secret_ref`。 manifest 不会显示 Git token、云 access key、SSH 私钥、数据库密码或 CodeGW key 原文。 ### 15. 确认开始执行 在开始执行前，Heicode 会用一张确认卡展示本次任务摘要： - 本次要做什么。 - 会启动哪些子 Agnet。 - 每个子 Agnet 使用哪些资源。 - 是否会访问密钥。 - 是否会部署云资源。 - 预计模型预算。 - 哪些动作需要审批。 确认无误后，我点击开始执行。真实部署动作仍由任务过程触发，并在高危场景下要求客户端审批。 ### 16. 客户端审批高危操作 如果任务过程中出现高危操作，客户端会弹出审批。 例如： ```text Ops Agnet 请求部署到生产环境。 目标资源：aks-prod 操作：cloud:deploy 风险等级：高 凭证：密钥保管器将派生 15 分钟短期凭证 ``` 这时我可以批准或拒绝。 如果我批准，平台会使用密钥保管器派生短期、最小权限凭证。子 Agnet 不会拿到长期密钥。 ### 17. 在客户端持续推进开发 任务启动后，我不会停留在网页上编码，而是回到客户端继续推进。 这里的真实闭环是： ```text 我在客户端补充要求 -> Heicode 判断下一步要推进哪个子环节 -> Agnet 执行需求、开发、测试、修复或部署中的当前任务 -> Agnet 按权限调用已绑定的 SK 工具 -> 中间结果回到客户端 -> 我继续修正方向或批准高危动作 -> Agnet 继续推进直到交付和部署完成 ``` ### 18. 查看执行状态 任务启动后，我在 Heicode 里查看执行状态。 我能看到： - Product Agnet 是否完成需求。 - Backend Agnet 是否正在写代码。 - Frontend Agnet 是否等待后端接口。 - Reviewer Agnet 是否发现问题。 - Ops Agnet 是否等待审批或部署中。 如果失败，页面应该显示失败原因，而不是只显示一个错误码。 ### 19. 查看执行记录和模型用量 我可以在当前任务里打开执行记录。 这里能看到： - 子 Agnet 运行日志。 - 模型调用日志。 - 消耗了多少额度。 - 哪个任务使用了哪个模型。 - 哪些资源被访问。 - 哪些高危操作被批准或拒绝。 模型和余额来自 CodeGW，但我不需要进入 CodeGW 后台。Heicode 会展示用户需要知道的信息。 ### 19. 查看交付结果 当任务完成后，我查看交付结果。 结果可能包括： - 产品文档。 - 原型描述。 - 代码变更。 - 测试结果。 - 部署结果。 - 访问地址。 - 审计记录。 如果部署到生产，我还可以看到部署时间、目标资源和审批记录。 ### 20. 后续维护和升级 上线后，如果我想继续迭代，我可以直接输入新的需求。 例如： ```text 给任务管理 SaaS 增加企业微信通知， 并检查现有权限模型是否支持团队成员邀请。 ``` Heicode 会复用之前的项目上下文、资源绑定和 Agnet 角色，生成新的开发任务。 ## 简短演示口述版 > 我先登录 Heicode 的浏览器控制台。这里不是 CodeGW 后台，而是资源、部署、状态和审计的辅助入口。登录后，我会在客户端输入一个产品想法，比如做一个小团队任务管理 SaaS。平台会生成需求草案、推荐资源和子 Agnet 团队。接下来我绑定 Git 仓库、项目文档、SK 和云资源。真实密钥会进入密钥保管器，Heicode 只保存 secret_ref。然后我确认每个子 Agnet 的角色和权限，比如 Backend 能写后端路径，Ops 可以部署测试环境，但生产部署需要客户端审批。任务运行后，Agnet 会持续推进开发、测试和部署，并按权限调用需要的 SK 工具；我可以看到每个子 Agnet 的状态、日志、模型用量和审计记录。客户端只登录 code.xinghanlab.com，不选择模型提供方，模型由 Heicode 提供。整个流程的重点是：从一个想法开始，把产品、代码、云资源、模型、密钥和审计组织成一个完整的软件生命周期。 ## 极简销售口述版 > Heicode 让用户从一个想法开始，接入自己的代码和云资源，由 Heicode 生成 AI 开发团队。平台负责资源授权、密钥保管、模型用量和审计；子 Agnet 负责开发、检查和部署。用户只在 Heicode 和客户端中操作，不需要进入 CodeGW 后台，也不会把长期密钥交给子 Agnet。 ## 口述时必须强调 1. Heicode 是用户主入口。 2. 客户端只登录 Heicode。 3. CodeGW 是内部模型网关，不是普通用户后台。 4. 密钥进入密钥保管器，不进入 Git、Markdown 或日志。 5. 高危操作在客户端审批。 6. 子 Agnet 拿短期凭证，不拿长期密钥。 7. 资源绑定和权限分配要尽量自动化和角色化。 ## 口述时不要说 1. 让用户去 CodeGW 后台配置模型。 2. 让用户去 OpenBao 控制台管理密钥。 3. 让客户端选择模型提供方。 4. 让用户手写复杂 manifest。 5. 把 tenant/project 当作当前产品主轴。 6. 把 Agnet 平台说成用户控制台。