4.4 KiB
4.4 KiB
04. 登录平台和使用平台指南
面向用户
本文面向第一次使用 Heicode 的普通用户，说明如何登录、绑定资源、下载客户端、创建任务和查看结果。
访问入口
平台入口：
https://code.xinghanlab.com
用户只需要登录 Heicode。普通用户不需要登录 CodeGW 后台，也不需要登录 Azure Key Vault。
第一步：登录 Heicode
- 打开
https://code.xinghanlab.com。 - 输入账号和密码，或使用平台支持的登录方式。
- 登录成功后进入 Heicode 控制台。
- 进入首页，查看资源、模型、任务和客户端下载状态。
登录后平台会读取：
- 用户 ID。
- 用户邮箱。
- 用户角色。
channelId。
这些信息用于用户身份、CodeGW 额度和用量映射。
第二步：下载客户端
- 在 Heicode 控制台进入
客户端下载。 - 选择对应系统版本，例如 macOS 或 Windows。
- 下载并安装 Heicode 客户端。
- 打开客户端后，只需要登录
https://code.xinghanlab.com。
客户端不会要求选择模型提供方。客户端可用模型由 Heicode 提供。
macOS 提示说明：
- 如果安装时出现系统安全提示，说明当前安装包可能还没有完成 Apple Developer ID 签名和 notarization。
- 用户可以按平台提供的安装说明继续打开。
- 长期方案应完成签名和 notarization。
第三步：在客户端输入想法
主要在 Heicode 客户端输入要做的事情。Manager 负责下载、资源绑定、Agnet 部署、状态和审计等辅助能力，不承担主开发对话。
例如：
我想做一个面向小团队的任务管理 SaaS，
需要登录、项目、任务、评论、通知和后台管理，
希望部署到 Azure。
平台会生成：
- 需求摘要。
- 产品文档草案。
- 推荐开发角色。
- 需要绑定的资源。
- 高危操作提示。
第四步：绑定资源
进入 资源绑定。
可绑定资源：
- 代码仓库。
- SK 仓库或技能包。
- 项目文档。
- 云账号。
- 云资源。
推荐流程：
先绑定 Git
-> 再绑定项目文档或 SK
-> 再绑定云账号
-> 从云账号自动发现资源
-> 选择允许使用的云资源
用户不需要把密钥贴到文档里。真实凭证由 Heicode 写入密钥保管器，Heicode 只保存 secret_ref。
第五步：分配权限
用户可以使用平台推荐角色：
- Product Agnet。
- Architect Agnet。
- Frontend Agnet。
- Backend Agnet。
- Reviewer Agnet。
- Ops Agnet。
每个角色确认：
- 能访问哪些仓库。
- 能读写哪些路径。
- 能使用哪些云资源。
- 哪些操作需要审批。
- 授权是否有有效期。
第六步：确认高危操作
高危操作会在客户端审批。
常见高危操作：
- 生产部署。
- 修改数据库。
- 创建或删除云资源。
- 访问生产密钥。
- 大额模型预算消耗。
用户确认后，平台才会为子 Agnet 派生短期凭证。
第七步：启动任务
用户确认任务后，Heicode 会生成：
- 子 Agnet 角色。
- AGENT.md。
- resource context。
- permission manifest。
- 模型和预算配置。
- 审批策略。
Heicode 将这些内容提交给 Agnet 平台执行。
第八步：在客户端持续推进
任务开始后，主流程回到客户端。
闭环应理解为：
客户端继续补充要求
-> Heicode 生成下一步子任务
-> Agnet 执行需求/开发/测试/修复/部署中的当前环节
-> Agnet 按权限调用需要的 SK 工具
-> 中间结果和失败原因回到客户端
-> 用户继续修正或审批
-> 最终返回交付物和部署结果
第九步：查看执行结果
用户可以在 Heicode 查看：
- 当前任务状态。
- 子 Agnet 活动状态。
- 运行日志。
- 失败原因。
- 模型用量。
- 资源访问记录。
- 高危审批记录。
- 部署结果。
第十步：维护和升级
上线后，用户可以继续输入：
- 修复 bug。
- 增加功能。
- 优化性能。
- 升级依赖。
- 调整部署资源。
Heicode 会复用已有项目上下文、资源绑定和审计信息。
用户注意事项
- 不要把密钥写入需求、Markdown、聊天内容或 Git。
- 授权云资源时先从测试环境开始。
- 生产部署必须仔细确认审批内容。
- 如果不确定某个资源是否应该授权，选择只读或暂不授权。
- CodeGW 后台不是普通用户入口，模型和余额在 Heicode 中查看。