使用 WorkBuddy 的過程中，你可能會遇到各種問題。這一節彙總了最常見的問題和解決方案，幫你快速排錯。遇到問題時，先來這裡查。
一、安裝與啟動問題#
Q1：安裝後無法啟動#
排查清單：
- Windows：確認系統是 Windows 10/11 x64（不支援 ARM64）；以管理員身份執行；檢查安全軟體是否攔截
- macOS：確認系統是 12.0 及以上；到"系統設定→隱私與安全性"放行；若提示"已損壞"，終端執行
xattr -cr /Applications/WorkBuddy.app
Q2：macOS 提示"無法驗證開發者"或"身份不明"#
解決：這是 macOS 的 Gatekeeper 安全機制。前往 系統設定 → 隱私與安全性，滾動到下方，點選"仍要開啟"。
Q3：登入頁面打不開 / 登入失敗#
排查：
- 將 Chrome 設為預設瀏覽器（登入驗證依賴瀏覽器）
- 檢查網路連線是否正常
- 確認在登入頁選擇了正確的登入方式（個人/企業）
二、許可權問題#
Q4：WorkBuddy 無法點選、輸入、截圖、讀檔案#
這是最常見的一類問題，根因是系統許可權未授權或未生效。
| 症狀 | 需檢查的許可權 |
|---|---|
| 無法點選/輸入 | 輔助功能（Accessibility） |
| 無法截圖/識屏 | 螢幕錄製 |
| 無法讀檔案 | 完全磁碟訪問 / 資料夾訪問 |
最關鍵的一步（macOS）：授權後必須完全退出並重啟 WorkBuddy，許可權才生效。很多人卡在這裡。
Q5：安全軟體（火絨/360）攔截操作#
解決：將 WorkBuddy 加入安全軟體的信任/白名單。自動化操作（模擬點選、鍵盤輸入）特別容易被攔截。
三、任務執行問題#
Q6：任務執行失敗或卡住#
排查：
- 簡化指令：複雜任務先拆成小步（技巧2）
- 檢查工作區：確認所需檔案確實在工作區內
- 檢查積分：複雜任務消耗大，確認積分餘額充足
- 切換模型：某些模型對特定任務表現更好（參見第23章）
Q7：AI 生成的結果不符合預期#
解決：
- 不要直接放棄，用多輪調整（技巧3）：指出問題、補充限制、切換視角
- 提供參考樣本（技巧6）：給一個滿意的例子讓它模仿
- 召喚專家（技巧5）：提升專業度
- 任務拆解（技巧2）：複雜任務分步做，每步確認方向
Q8：AI 修改了我的檔案，改壞了#
預防：讓 AI 改重要檔案前，務必備份（技巧8）。或在指令裡要求"另存為修訂版，不覆蓋原檔案"。
補救：如果已被改壞，檢查是否有備份；Windows 使用者可檢視 WorkBuddy 是否自動備份了原檔案（沙箱機制支援）。
Q9：批次操作被反覆要求確認#
原因：預設許可權模式下，批次/高風險操作會觸發確認。
解決：
- 這是正常的安全機制，建議逐個確認
- 僅在隔離/測試環境（Docker/VM/測試目錄）才考慮用"完全放開"模式
- 把檔案集中到工作區，可減少工作區外操作的確認
四、積分與費用問題#
Q10：積分消耗太快#
控制積分的建議：
- 任務拆解，避免一次性跑超複雜任務
- 先用便宜的圖片生成打磨提示詞，再花錢做影片
- 專家團消耗是單專家的 3-5 倍，按需使用
- 新使用者附贈 5000 Credits，注意檢視用量
Q11：自定義模型扣了我的積分嗎？#
不會。自定義模型的費用由你向第三方（模型廠商）支付，WorkBuddy 不扣積分。WorkBuddy 僅作通訊鏈路。
五、聯結器與遠端問題#
Q12：聯結器授權失敗#
排查：
- QQ 郵箱：確認 App 版本 7.1.5 / 鴻蒙 0.2.9+；掃碼後必須在瀏覽器彈窗點"開啟"
- 騰訊文件/樂享：確認微信/手機號登入授權完成
- 撤銷重試：到對應平臺的應用授權管理裡撤銷，重新授權
Q13：Claw 遠端控制不響應#
排查：
- 確認已開啟遠端控制
- 確認繫結的 IM 平臺配置正確（企業微信/飛書/釘釘需配回撥 URL 和憑據）
- 確認電腦端 WorkBuddy 線上執行
- WebSocket 模式確認顯示"已連線"
六、效能問題#
Q14：響應很慢#
可能原因：
- 網路問題：檢查網路穩定性
- 模型選擇：極致模式/複雜任務耗時更長，簡單任務用快速模式
- 檔案過大：超大檔案處理慢，可分批
Q15：知識庫初始化失敗#
解決：檢查網路連線後重新整理頁面（參見 chat.json 的 knowledgeBaseFailed 提示）。
通用排錯思路#
遇到任何問題，按這個順序排查：
bash
錯誤碼參考#
官方提供完整的錯誤碼說明。遇到具體錯誤碼時，查閱：
/docs/workbuddy/From-Beginner-to-Expert-Guide/Error-Code
常見錯誤碼類別：網路類、許可權類、積分類、模型類、檔案類等。
小結#
排錯的核心是系統化排查：先看 FAQ，再查基礎項（網路/許可權/版本/積分），然後簡化復現，最後查官方文件和錯誤碼。
記住：90% 的問題都能在本節或官方 FAQ 找到答案。遇到問題別慌，按思路一步步查。