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 延伸閱讀