專案與 URL

#新增專案

1. 使用 檔案 → 開啟專案資料夾…（⌘O / CtrlO）、側邊欄中的 新增專案，或標題列專案選單中的 新增專案…。
2. 選擇專案的來源：
   • 在這台電腦上：選擇一個資料夾。
   • 從 GitHub / GitLab 複製：從你的儲存庫中選擇一個（透過你的 gh 或 glab 登入列出），或貼上 URL，再選擇上層資料夾，Ferret 就會複製並開啟它。
   • 透過 SSH 開啟：從 ~/.ssh/config 中選擇主機。終端機與 Agent 會在遠端機器上執行；審查則保留在這台電腦上。

名稱預設為資料夾名稱。新增已經登錄過的資料夾時，會直接開啟它（在 macOS 與 Windows 上，路徑比對不分大小寫）。你可以從側邊欄選單 重新命名 專案，或 從清單中移除。移除絕不會刪除資料夾。

終端機會在專案資料夾中開啟，審查則儲存在 <project>/.ferret/ 底下。

#儲存 URL

1. 在內建瀏覽器中開啟頁面。
2. 按一下瀏覽器工具列中的 +（儲存目前的 URL）。目前的 URL 會預先填入。
3. 輸入 名稱，然後按一下 儲存。

只接受 http:// 與 https:// 的 URL。如果保留建議的名稱，會根據主機推測名稱：

#審查目標面板

在意見模式中，右側的 審查目標 面板會列出目前專案中所有可以審查的項目。切換目標不會停止錄製。可用 顯示方式 → 切換審查目標（⌘⇧K / CtrlShiftK）或 隱藏面板 切換面板顯示。

• 目標：專案中儲存的 URL。每個 URL 底下是你在該網站造訪過的頁面樹狀結構。造訪過但未儲存的網站會各自成為一個群組。
• 檔案：專案資料夾。檔案會以預覽開啟（Markdown 與 Mermaid 會轉譯顯示，其他文字為唯讀），因此也能審查文件。鉛筆圖示（在編輯器中開啟）會在編輯器中開啟檔案。

篩選目標 會同時篩選目標、頁面與檔案，使用與 前往檔案… 相同的模糊比對。在清單中，可用 ↑ ↓ Enter 或 1–9 切換目標。開啟 URL… 可開啟一次性的 URL，儲存到專案 URL 則會保留它。

目標來自 settings.json 中的 projects[].urls（請參閱範例）。每個項目都需要 url、launchCommand（在終端機中執行，例如啟動桌面 App）或 windowMatch（要錄製的視窗）其中之一。選擇視窗目標會將它設為錄製來源，因此錄製期間無法這麼做。造訪過的頁面會依專案記住，只保存在這台電腦上（最多 200 個）。

#開啟與切換環境

按一下儲存的 URL 即可開啟。如果目前的頁面位於另一個儲存的 URL 之下，Ferret 會保留路徑、查詢字串與雜湊，只替換來源（origin）。例如在 http://localhost:3000/pricing?plan=pro 上按一下 prd，會開啟 https://example.com/pricing?plan=pro。

與目前頁面相符（最長前綴）的標籤會反白顯示。在標籤上按右鍵，或使用其鉛筆圖示，即可編輯或 刪除 它。開啟專案時若沒有上次的 URL，會載入第一個儲存的 URL。