Cloud 使用指南

Cloud 让任务在云端执行。你可以直接选择仓库创建任务，也可以将已有本地任务转到云端，再通过已开放、支持 Cloud 的客户端跟进结果。

本指南以桌面端为主要操作入口，另提供 CLI 发起本地任务上云和查询上云状态的命令。

flowchart TD
    A["确认账号与仓库授权"] --> B{"从哪里开始？"}
    B --> C["选择仓库，直接创建云端任务"]
    B --> D["打开已有本地任务"]
    D --> E["确认会话与未提交改动的迁移范围"]
    C --> F["云端准备并执行任务"]
    E --> F
    F --> G["跟进进度、补充要求、检查结果"]
    G --> H["继续修改或通过 PR 交付"]

1. 使用前准备

1.1 账号与入口

本指南以 GitHub 代码仓库任务为例。安装及登录步骤参见桌面端指南。

1.2 选择使用路径

2. 连接仓库与确认运行条件

2.1 连接 GitHub

1. 打开桌面端的项目选择菜单，找到 Cloud。
2. 如果 Cloud 尚不可用，点击旁边的设置按钮，进入 GitHub 连接页面。
3. 按页面提示完成 GitHub 授权。
4. 返回项目选择菜单，打开 Cloud，确认可以看到目标仓库。

仓库列表支持通过 Search repos 搜索。找不到仓库时，先检查连接的 GitHub 账号及授权范围。

2.2 确认仓库与分支

选择仓库后，Remy 会先使用该仓库的默认分支。需要其他分支时，点击分支选择入口，选择本次任务要基于的分支。

2.3 云端环境如何准备

提交任务后，云端会进行相应初始化，例如准备工作空间、获取仓库代码和启动任务。无需在这份流程中另外创建一个命名的“云端环境”。

本机已经安装的依赖、正在运行的开发服务或本机凭据，不应被视为云端环境已经具备。任务涉及特殊依赖时，在项目文档或任务说明中写清准备与检查方法。

请先阅读仓库的 README 和项目约定，确认依赖安装、启动及测试方式。
如果当前环境缺少必要条件，请说明具体缺少什么和对应错误。
能够执行的检查请实际运行；无法执行的检查请单独列出。

3. 直接创建云端任务

3.1 选择仓库并发送任务

1. 新建对话，在项目选择菜单中打开 Cloud。
2. 搜索并选择目标仓库，检查分支。
3. 确认执行方式显示 Send to cloud。
4. 选择可用模型，输入任务并发送。
5. 等待初始化和任务执行，查看返回的进度与结果。

如果希望先审阅计划，可以在执行方式菜单中启用 Plan before editing，再提出任务。查看返回的计划后，在对话中说明确认或需要调整的内容。

3.2 提供明确的任务要求

下面的示例可以按实际项目修改：

请检查订单列表切换筛选条件后分页不正确的问题，并完成修复。

要求：
1. 先读取仓库说明和相关约定。
2. 只修改筛选、分页及直接相关的逻辑。
3. 沿用项目现有样式和测试方式。
4. 补充并运行相关测试。
5. 最后说明改动文件、检查结果和未完成事项。

不要合并 PR。

3.3 文本与本地附件的区别

直接发送给 Cloud 的任务消息目前只支持文本。本地附件、文件夹引用及本地代码引用不能随这类消息一起发送。

4. 将本地任务转到云端

4.1 在桌面端发起上云

1. 打开要继续处理的本地对话，确认当前项目和任务。
2. 等待当前本地执行结束。
3. 打开对话标签的菜单，选择 Move to Cloud。
4. 如存在未提交文件，查看文件数量、清单及传输大小提示，选择是否携带。
5. 核对出现的仓库、提交和其他确认信息，按界面提示继续。
6. 等待上云成功，再在原任务中跟进云端执行。

GitHub 尚未授权时，先通过对应设置入口完成授权，再重试。

4.2 决定是否携带未提交改动

出现 Include uncommitted changes? 时：

这一步是在“携带改动”和“不携带改动”之间选择。迁移前应核对提示中的文件范围，而不是假设整个本地目录都会上传。

4.3 上云前后有哪些变化

上云成功与任务完成是两件事。任务转到云端后，还需要等待执行、检查结果，并处理后续问题。

4.4 通过 CLI 发起上云

在已登录 CLI 的终端中，先查看目标项目的对话：

remy --workspace "/path/to/project" history list

将 /path/to/project 替换为真实项目路径，将下面的 CHAT_ID 替换为对应的对话 ID。

携带未提交改动：

remy --workspace "/path/to/project" cloud handoff --chat-id "CHAT_ID" --include-workspace --message "请在云端继续处理剩余检查，并说明结果。"

保留未提交改动在本机：

remy --workspace "/path/to/project" cloud handoff --chat-id "CHAT_ID" --exclude-workspace --message "请在云端基于已提交代码继续处理任务。"

根据需要选择其中一条命令。目录没有未提交改动时，可以省略 --include-workspace 和 --exclude-workspace。

CLI 会展示迁移预览。核对账号范围、仓库、分支、提交及文件范围后，输入 yes 确认。

4.5 查询或取消上云过程

如果上云过程尚未完成，可以查询：

remy --workspace "/path/to/project" cloud status --chat-id "CHAT_ID"

如果已经获得上云记录 ID，也可以明确指定：

remy --workspace "/path/to/project" cloud status --chat-id "CHAT_ID" --handoff-id "HANDOFF_ID"

将 HANDOFF_ID 替换为该次操作返回的记录 ID。上传后连接断开、结果未知时，先查询同一次上云记录，不要直接重复发起新的上云。

需要取消尚未激活的上云过程时：

remy --workspace "/path/to/project" cloud cancel --chat-id "CHAT_ID" --handoff-id "HANDOFF_ID"

该命令只用于取消尚未激活的上云过程，不能取消已经激活的云端任务。已进入云端执行的任务，应在桌面端查看并通过任务的停止操作处理。

CLI 的 cloud status 查询的是上云过程。完整的任务进度、继续对话与 PR 操作，以桌面端任务界面为主。

5. 跟进任务与跨设备使用

5.1 查看当前阶段

停止请求发出后，等待任务状态更新，确认云端执行已经结束。

5.2 在原任务中继续

需要调整结果时，打开同一云端任务继续说明：

筛选条件变化后已经能回到第 1 页，但列表没有刷新。
请只修复刷新逻辑，保留此前已经完成的改动，
补充并运行相关测试，最后说明结果。

不要合并 PR。

网络中断后，先重新打开原任务查看当前状态和最新回复，再决定是否补发消息。任务列表刷新失败时，界面可能仍显示上次取得的记录。

5.3 换一台设备跟进

1. 在另一台已安装 Remy 桌面端的设备上登录相同账号，并确认团队范围一致。
2. 在侧栏找到对应的云端任务。
3. 打开任务，等待最新消息和状态加载。
4. 继续查看结果，或在同一任务中补充要求。

云端任务不依赖发起它的电脑持续在线。关闭桌面应用、电脑离线或关机后，云端任务仍可继续；需要你回复的问题会等待后续处理。

跨设备操作以支持 Cloud 的客户端为准。

6. 查看结果与交付

6.1 检查任务结果

任务返回结果或生成 PR，都不能替代对测试结果和实际功能的检查。

6.2 通过 PR 交付

需要 PR 时，在任务中明确说明交付要求。例如：

请为已完成的改动准备 PR：
说明解决的问题、主要改动、已运行的检查和剩余事项。
如果已有本任务的 PR，请更新原 PR。

不要合并。

任务生成 PR 后，界面会显示 Draft PR 或 PR 卡片。点击卡片中的链接，在浏览器中打开对应 PR，检查工作分支、目标分支和实际差异。

需要在 Remy 中合并时，先审阅 PR，再使用卡片中的 Merge PR，核对确认窗口中的源分支和目标分支后执行。合并会修改远端仓库，具体结果以返回状态为准。

6.3 本地目录不会自动更新

Cloud 的执行结果不会自动同步回本地工作目录。通过 PR 合并或准备继续本地工作时，按项目正常的 Git 流程拉取和检查代码。

不要将本地 Changes 面板中的内容直接当作云端任务的最新改动。

7. 常见问题与已知限制

7.1 入口、执行与结果问题

7.2 当前需要注意的边界

• 本地上云按预览和选择的范围执行，不是将整台电脑或整个运行环境复制到云端。
• 直接发起和继续 Cloud 任务的消息当前只支持文本。
• 本机未提交文件是否带到云端，由上云时的选择决定。
• CLI 上云过程查询与云端任务本身的进度不同。
• 云端结果不自动同步回本地；是否完成交付，要看实际代码、检查结果及 PR 状态。

8. 获取帮助与继续阅读

8.1 提交问题反馈

通过对应任务的 Send feedback 入口反馈问题。CLI 的反馈提交方法参见 CLI 指南。

说明问题发生在创建任务、本地上云、跟进任务还是 PR 交付阶段，并补充仓库与分支、任务或上云记录 ID（如有）及错误提示。

无法进入任务或使用反馈入口时，可以联系运营支持：support@corepass.com。

8.2 继续阅读