下載好安裝包後，這一節我們分平臺詳細講解安裝步驟。無論你用 Windows 還是 Mac，跟著做，幾分鐘就能裝好。
一、Windows 安裝指南#
安裝步驟#
- 找到安裝包：在"下載"資料夾找到
WorkBuddySetup.exe - 雙擊執行：如果彈出"使用者賬戶控制"提示，點選"是"允許
- 跟隨安裝嚮導：
- 安裝嚮導啟動後，會提示"選擇安裝使用者"，建議選擇"僅為我安裝"
- 選擇安裝位置（預設即可，也可自定義）
- 點選"安裝"開始
- 完成安裝：進度條走完後點選"完成"
Windows 預設目錄#
安裝完成後，相關檔案位置：
| 內容 | 預設路徑 |
|---|---|
| 程式安裝目錄 | C:\Users\<使用者名稱>\AppData\Local\Programs\WorkBuddy |
| 工作區目錄 | C:\Users\<使用者名稱>\workbuddy |
| 擴充套件資料 | $env:APPDATA\CodeBuddyExtension |
Windows 安裝常見問題#
問題1：安裝被安全軟體攔截
- 臨時關閉火絨、360、電腦管家、Windows 安全中心等
- 或將安裝包加入信任白名單
- 安裝完成後可重新開啟安全軟體
問題2：提示"許可權被拒絕"
- 對
CodeBuddyExtension目錄及其子資料夾，當前使用者需有"完全控制"許可權 - 右鍵資料夾 → 屬性 → 安全 → 編輯許可權
問題3：安裝後無法啟動
- 以管理員身份執行
- 檢查系統是否為 Windows 10/11 x64
- 檢視是否有其他安全軟體持續攔截
二、macOS 安裝指南#
安裝步驟#
- 找到安裝包：在"下載"資料夾找到
WorkBuddy.dmg - 雙擊開啟：彈出安裝視窗，左側是 WorkBuddy 圖示，右側是 Applications 資料夾
- 拖動安裝：把 WorkBuddy 圖示拖入 Applications 資料夾
- 等待複製：進度條完成後，推出（Eject）dmg 映象
- 啟動應用：
- 在啟動臺（Launchpad）找到 WorkBuddy，或用
Cmd + Space搜尋"WorkBuddy" - 首次啟動可能提示"無法開啟"或"來自身份不明的開發者"
- 在啟動臺（Launchpad）找到 WorkBuddy，或用
- 放行（如需要）：前往
系統設定 → 隱私與安全性，點選"仍要開啟"放行
macOS 預設目錄#
| 內容 | 預設路徑 |
|---|---|
| 應用程式 | /Applications/WorkBuddy.app |
| 工作區目錄 | /Users/<使用者名稱>/WorkBuddy |
macOS 安裝常見問題#
問題1："無法開啟，因為無法驗證開發者"
- 這是 macOS 的安全機制（Gatekeeper）
- 解決：
系統設定 → 隱私與安全性→ 滾動到下方 → 點選"仍要開啟"
問題2：提示"已損壞，無法開啟"
- 多為下載不完整或系統快取問題
- 重新下載安裝包
- 或在"終端"執行：
xattr -cr /Applications/WorkBuddy.app（清除隔離屬性）
問題3：拖入 Applications 時提示需要密碼
- 輸入你的 Mac 登入密碼即可，這是正常的許可權確認
三、升級與重灌#
如何升級#
WorkBuddy 支援線上自動更新：
- 點選左下角帳號頭像 → 進入"個人中心"
- 點選**"檢查更新"**
- 有新版本時按提示升級
也可以從官網重新下載最新版覆蓋安裝。
重灌注意事項#
重要：重灌會清空安裝目錄並覆蓋檔案。重灌前務必：
- 把個人檔案、專案從安裝目錄（
bin/locales/resources/tools等子目錄）移出 - 工作區目錄（
workbuddy或WorkBuddy）一般不受影響，但建議也備份重要內容 - 記錄你的登入方式和已配置的聯結器/技能，方便重灌後恢復
四、安裝後的首次啟動#
無論哪個平臺，安裝完成後首次啟動 WorkBuddy：
- 會彈出登入頁面（下一節詳解）
- 可能需要授權資料夾訪問許可權（首次使用時提示）
- macOS 使用者還需在系統設定中授權"輔助功能""螢幕錄製"等許可權（詳見 2.4 節）
小結#
這一節我們完成了 WorkBuddy 的安裝。關鍵要點：
- Windows：雙擊 exe → 選"僅為我安裝" → 完成
- macOS：開啟 dmg → 拖入 Applications → 首次啟動到"隱私與安全性"放行
- 重灌前務必把個人檔案移出安裝目錄
裝好後，下一節我們來完成登入和工作區配置。