快速入門
安裝 Spirit Agent，連接一個提供者，並完成一個小而經批准的文字編輯。
此頁面帶您從全新安裝到完成一個有用的變更。後續頁面涵蓋所有提供者和主機；沒有此路徑，這些頁面將無所依附。
1. 安裝 Desktop 或 CLI
選擇一個主機。它們共用同一個本地 daemon，因此您之後可以新增另一個。
從下載頁面下載適用於您平台的版本，然後開啟它。
- macOS：
.dmg（Intel 或 Apple silicon） - Windows：
.exe安裝程式（x64 或 ARM64） - Linux：
.AppImage（x64 或 ARM64）
詳細資訊：安裝 Desktop。
2. 開啟一個工作區
Agent 會在工作區根目錄中讀取和編輯檔案。開啟您想要變更的專案。
在側邊欄中使用開啟工作區資料夾並選擇一個資料夾。最近的工作區會保留在清單中。
3. 連接一個提供者
您需要一個來自您已在使用之提供者的 API 金鑰。Spirit 會將該金鑰儲存在作業系統的金鑰環（SpiritAgent）中。
- 開啟設定 → 模型。
- 選擇一個提供者並遵循連接精靈。
- 貼上金鑰。額外欄位（區域、站點、計畫端點）僅在該提供者需要時才會出現。
- 選擇一個聊天模型作為作用中模型。
4. 要求一個小變更，然後批准它
第一次執行時，請保持在 Agent 模式和預設批准。要求 Agent 讀取您熟悉的檔案，然後進行一個小而明顯的編輯。
範例：
Read README.md and add a one-line project summary at the top. Do not change anything else.Agent 會讀取檔案、提出編輯建議，然後等待。在提示中批准檔案變更（以及任何 shell 命令）。完成後，開啟檔案並確認編輯。
這就是整個迴圈：安裝 → 工作區 → 一個提供者 → 讀取 → 編輯 → 批准。這些文件中的其他一切皆依附於此路徑。
下一步
- 安裝 Desktop 和 安裝 CLI（如果您需要其他主機或固定版本）
- Providers 用於連接其他主機，或在模型未匯入時檢查站點 / 計畫 / 雲端欄位