桌面版安裝與使用

本指南介紹 Remy 桌面版的安裝、登入、專案設定、任務執行、結果檢視與更新。首次使用時，可搭配快速開始完成一項完整的程式開發任務。

flowchart LR
    A["下載與安裝"] --> B["登入帳號"]
    B --> C["加入專案"]
    C --> D["啟動任務"]
    D --> E["檢查結果"]
    E --> F["繼續修改或交付"]

1. 使用前的準備

1.1 選擇適合電腦的安裝套件

下載頁同樣提供 Linux 版本；本指南涵蓋 macOS 與 Windows。

在 Mac 上，可透過蘋果選單 → 關於這台 Mac查看晶片或處理器；在 Windows 上，可透過設定 → 系統 → 系統資訊／關於 → 系統類型查看架構。

1.2 準備帳號與工作環境

Remy 與專案的執行環境須分別準備。桌面版內建執行環境，無須為安裝 Remy 另行安裝 Python 或 Node.js；若專案需要這些工具，仍須依專案說明準備。

2. 下載與安裝

透過 Remy 官網下載入口取得安裝套件，依上一章的系統與晶片選擇對應版本。

2.1 macOS

1. 下載對應晶片的 DMG 安裝套件。
2. 按兩下開啟 DMG，依安裝視窗提示將 Remy 放入 Applications（應用程式）。
3. 從「應用程式」資料夾開啟 Remy。

安裝成功的標準： Remy 可以正常開啟，並顯示登入畫面；若已登入，則進入工作介面。

2.2 Windows

1. 下載 Windows x64 EXE 安裝套件。
2. 按兩下安裝套件，依安裝精靈繼續操作。
3. 選擇安裝目錄，完成安裝。
4. 從「開始」選單開啟 Remy。

安裝成功的標準： Remy 可以正常開啟，並顯示登入畫面或工作介面。

2.3 安裝後先檢查什麼

• 安裝套件與電腦的系統及晶片相符。
• 應用程式可以正常啟動。
• 點選 Get started 後，系統瀏覽器能開啟登入頁面。

無法開啟安裝套件或啟動應用程式時，請參閱第 7 章的對應問題。

3. 登入與認識介面

3.1 登入帳號

1. 開啟 Remy，點選 Get started。
2. 在系統瀏覽器完成登入。
3. 返回 Remy，進入工作介面。

等待瀏覽器登入期間，應用程式會顯示 Continue signing in with your browser。

若需重新開始，可以點選 Cancel sign-in，再點選 Get started。登入失敗時，先依介面提示檢查網路，或重新啟動登入流程。

3.2 認識常用入口

檢視設定： 點選側邊欄底部的帳號入口，選擇 Settings。需要登出目前帳號時，在帳號選單選擇 Log out。

4. 專案與對話

4.1 加入既有專案

1. 開啟專案選擇選單，點選 New project。
2. 在 Create project 視窗填寫 Project name。
3. 在 Source folders 點選 Add folders the agent can read and edit，選擇程式碼所在的本機目錄。
4. 核對專案名稱與目錄，點選 Create project。
5. 在該專案點選 New chat，開始任務。

通常應選擇包含專案說明、原始碼與建置設定的專案根目錄。例如：

example-project/       ← 加入這個目錄
├── README.md
├── package.json       ← 專案的環境與相依套件設定（範例）
├── src/
└── tests/

這是目錄結構範例；實際檔名取決於你的專案。

Source folders 是 Remy 可以讀取與編輯的專案目錄。建立專案前，請確認已選取目標專案，並在任務中說明本次操作範圍。

4.2 一個專案需要多個目錄時

例如前端與後端分別位於兩個目錄，可以在 Source folders 繼續點選 Add folder。

補充要求時，請說明涉及哪個目錄，避免讓 Remy 僅依名稱猜測。

這個專案包含前端與後端兩個目錄。
請先檢查前端提交參數是否與後端驗證規則一致，列出相關檔案與差異。
只進行分析，不修改檔案。

4.3 建立新對話還是繼續對話

開始任務前，請檢查目前專案名稱與目錄。建立新對話後，仍應清楚說明本次目標與限制。

5. 執行任務與檢視結果

5.1 選擇模型並說明任務

在輸入框旁選擇可用模型；若提供推理設定，可依任務需要調整。也可以選擇 Dynamic，由 Remy 依任務選擇模型，遇到困難時可自動升級；具體型號不會向使用者顯示。

目前使用者無法在任務執行過程中手動切換模型。可選模型與推理設定以應用程式內的清單為準。

容易執行與檢查的任務，可以依下列方式描述：

5.2 使用可複製的任務範本

以下範例中的業務模組與行為，應替換成專案的實際情況。

找出並修復問題

訂單清單在第 3 頁時切換狀態篩選，結果顯示為空白；
回到第 1 頁後才有資料。

請找出原因，讓切換篩選時重設頁碼，補充並執行相關測試。
只修改相關邏輯，最後說明變更檔案、檢查結果與無法完成的檢查。
先不要提交或推送程式碼。

僅審查現有變更

請審查目前未提交變更，重點檢查篩選、分頁與排序是否互相影響，
以及是否遺漏邊界情況。

依嚴重程度列出問題，附上檔案位置、觸發條件與修改建議。
先不要修改檔案、提交或推送程式碼。

完整的首次程式開發任務範例請見快速開始。

5.3 在任務過程中補充資訊

若 Remy 需要你補充資訊或確認操作，請先閱讀問題，再回答。需求改變時，請在同一段對話明確說明調整範圍。

補充一項限制：本次不修改介面，只調整前端篩選行為。
若目前方案需要修改介面，請先說明原因與影響，等待我確認。

5.4 檢視檔案與變更

• 在 Explorer 檢視專案檔案，開啟需要檢查的內容。
• 在 Changes 檢視 Git 工作區的檔案變更。選擇檔案，閱讀新增、刪除或修改的內容。
• 若尚未開啟這些面板，可從新增面板入口選擇 Explorer 或 Changes。

Changes 顯示的是目前 Git 工作區的變更。可能同時包含任務開始前已有的未提交變更；檢查時須區分本次任務與原有工作。非 Git 目錄沒有相對於 HEAD 的差異，可以直接檢查實際檔案與任務說明。

5.5 判斷任務是否完成

結果不符合預期時，請在原對話描述具體問題。例如：

切換篩選條件後，頁碼已回到第 1 頁，但清單沒有重新整理。
預期應在更新篩選條件後立即請求新資料。

請只修復這個問題，補充並執行相關測試，
最後說明修改與檢查結果。先不要提交或推送程式碼。

6. 更新 Remy

6.1 查看目前版本

在 macOS 上，可透過 Remy → About Remy 查看應用程式版本。

提交問題回饋時，也可以在回饋視窗將滑鼠移至 Information included automatically，查看 Remy version 等隨報告提供的資訊。

6.2 手動檢查更新

檢查結果可能包括：

6.3 安裝更新

1. 儲存正在編輯的內容，檢查是否仍有執行中的任務。
2. 更新下載完成後，在更新提示選擇 Install Update；也可以點選側邊欄的 Relaunch to update。
3. 依提示完成安裝並重新開啟應用程式。

若應用程式提示任務仍在執行，建議先完成目前工作，再重新啟動以更新。

7. 常見問題與已知限制

7.1 安裝、登入或使用遇到問題

7.2 需要瞭解的限制

• 使用者無法在任務執行過程中手動切換模型；Dynamic 可以自動升級模型。
• Branch 建立的是對話分支，不會復原檔案變更。
• Browser Use 與 Computer Use 目前僅支援 macOS。
• 處理本機專案時，請保持電腦、Remy 應用程式與任務所需環境可用；雲端任務的使用方式請見 Cloud 指南。

8. 取得協助與進一步使用

8.1 提交問題回饋

1. 開啟對應對話的選單，選擇 Send feedback。
2. 在 Submit feedback to Remy 視窗填寫回饋類型、影響程度與問題描述。
3. 視需要補充螢幕截圖或附件，點選 Submit feedback。

也可以在側邊欄的對話項目按右鍵開啟選單，選擇 Send feedback。

描述問題時，請說明重現步驟、預期結果與實際結果，並附上錯誤提示或相關螢幕截圖。

8.2 評價任務回覆

使用回覆下方的讚／倒讚，補充哪些內容有幫助、哪些地方不符合預期。具體的任務目標、錯誤現象與預期結果，更有助於後續處理。

找不到回饋入口或無法進入應用程式時，可聯絡營運支援：support@corepass.com。

8.3 延伸閱讀