快速开始
从登录到在 GitHub 上拿到一个 Draft PR。大约 15 分钟,大部分时间在等这一轮跑完。
开始之前
你需要一个已开通 Yi Code 的组织里的账号,组织里要有额度。组织还没开通的话,请申请试用。
1. 登录
- 打开 https://code.theyilabs.com,点「使用组织账号登录」。页面可能显示产品原来的名称「Preworld Code」。
- 用 Yi Labs 账号登录,选择你的组织。
进来后看到的是「想在代码里完成什么?」。左栏底部的钱包显示组织当前可用的额度。
如果页面提示「组织尚未开通或已停用,请联系管理员。」,说明组织没有开通 Yi Code,或者已经停用。见组织、登录与角色。
2. 连接 GitHub
- 点「连接 GitHub」,会打开 GitHub 上 Yi Code 这个 App 的安装页。
- 选 GitHub 账号或组织,选「Only select repositories」,勾上允许 Agent 处理的仓库。
- 点 Install。GitHub 接着会让你授权这个 App,用来证明刚装的这个安装确实属于你的 GitHub 账号。这一步不会保存你个人的 GitHub 令牌。
完成后回到「想在代码里完成什么?」。以后要增减仓库,点输入框下面的「管理 GitHub 仓库」。
一个安装只能连到一个 Yi Code 组织。细节见 Pull Request 与 GitHub。
3. 选仓库和分支
在输入框下面打开「选择仓库」,选一个。「选择分支」默认是仓库的默认分支,需要的话改一下。
发出第一条消息时,分支会解析成它当时的提交,这个会话的每一轮都基于这个提交。之后再推到这个分支上的提交,不会进入这个会话。
4. 选 Ask 或 Code,选模型和预算
- Ask 只回答问题,不改仓库。还不熟悉代码的话,先用它。
- Code 会改代码。跑完后你先看差异,什么都不会自动推到 GitHub。
点「预算」打开「本轮预算(USD)」和「模型」。预算是这一轮最多能花的钱,开始时从额度里冻结,结束时按实际费用扣掉,剩下的释放。每种模式都有最低预算。预算不够或额度不足时,输入框下面的提示会说明。见预算与计费。
5. 发出消息
写下你要做的事。比如在 Ask 里问「解释这个仓库的结构」,在 Code 里写「parse_date 收到空字符串时返回 None,并补一个测试」。点箭头,或按 Ctrl+Enter(Mac 上是 ⌘+Enter)。
这一轮会依次显示进度:「拉取源码」「探测验证」「运行」「验证」「收集产物」。在这之前可能要先排队等执行环境。Ask 每轮最长 15 分钟,Code 最长 60 分钟。
想在跑完时收到浏览器通知,点顶部的「开启完成通知」。
6. 看结果
一轮结束后能看到:
- Agent 的回答,以及「工具步骤」里它执行的每条命令、每次文件修改。
- 验证结果:「验证通过」「验证失败」或「未验证」,跑的是哪条命令、原因是什么(见验证)。
- 回执:「本轮费用」、预算,以及会话固定的提交。
右侧「会话面板」里有整个会话的费用、改动(增删行数、文件数)、「查看差异」,还有「原始日志与产物」,里面是补丁和测试输出。
7. 创建 Draft PR
第一次发布前,先绑定你自己的 GitHub 账号:在「会话面板」的「GitHub 发布身份」下点「绑定个人 GitHub」,到 GitHub 上授权。PR 用你的授权创建,你的账号要对仓库有写权限。
Code 这一轮成功了、差异也没问题,就点「创建 Draft PR」,在「确认将已审阅的差异发布为 GitHub Draft PR?」里确认。
Yi Code 会把改动推到一个新分支,名字是 preworld/ 加会话 ID,并向你选的分支开一个 Draft PR。「查看 Draft PR」会链接过去。不会合并,合并由你们在 GitHub 上做。
最新一轮是 Ask、没有成功、会话没有任何改动,或者还没绑定 GitHub 账号时,这个按钮是灰的。
8. 追问
在「继续追问,或描述下一步修改…」里写下一步。新的一轮从这个会话目前为止的全部改动开始,有自己的预算。跑完后审阅,点「更新 Draft PR」,同一个 PR 上会多一个新提交。不会强推。