排錯與錯誤碼

排錯的通用順序

遇到問題先按這個順序試，能解決八成：

1. 換個模型重試——錯誤碼裡一半以上都指向這一條
2. 把任務拆小——複雜的複合任務失敗率高得多
3. 確認網路——公司網路先找 IT，家庭網路查代理
4. 重開會話——上下文太長導致的怪異行為，開新任務最快
5. 跑一遍診斷工具——上面都不行時，讓它自己體檢

保留證據

提交排查前先備齊：錯誤碼、報錯截圖、系統版本、網路環境、發生時間。有這幾樣，排查速度差一個量級。

錯誤碼速查

錯誤碼	常見判斷	處理方案
1001	多與模型側狀態有關	優先切換模型重試
3002	多與網路環境有關	見下方網路問題
3003	多與網路環境有關	見下方網路問題
3007	多與網路環境有關	見下方網路問題
6003	請求頻率受限（專業版也可能出現）	優先切換模型重試
6004	請求頻率受限（專業版也可能出現）	優先切換模型重試
11115	輸入內容過長	精簡輸入，或切換為支援更大上下文的模型
11133	多與模型側狀態有關	新開會話或切換模型重試
11134	多與模型側狀態有關	新開會話或切換模型重試
14003	多與模型側狀態有關	優先切換模型重試

一半的錯誤碼都是「換個模型」

1001、6003、6004、11133、11134、14003 都指向模型側的臨時狀態，和你的提示詞、賬號、網路無關。

換一個模型再跑一遍，通常就好了。這是成本最低的排錯動作。

網路問題

3002 / 3003 / 3007 都屬於網路類。處理順序：

1. 先確認當前使用的是公司網路還是家庭網路
2. 公司網路——建議聯絡企業 IT 協助排查。企業閘道器、代理、白名單策略都可能攔住
3. 家庭網路——按官網網路排查流程逐項處理
4. 關掉網路代理——見下方

網路代理配置

WorkBuddy 從 5.3.0 版本之後內建了網路代理切換功能，在設定裡可以配置。

不確定就選「跟隨系統」

三個選項如果你分不清區別，選「跟隨系統」。

如果懷疑是代理導致的問題，關掉系統代理再試：

• macOS：系統設定 → 網路 → 選中當前網路 → 詳細資訊 → 代理
• Windows：設定 → 網路和 Internet → 代理

登入失敗

點了登入沒反應，三個原因。

原因一：沒設預設瀏覽器

客戶端要靠系統預設瀏覽器開啟登入頁。

Windows：

1. 系統設定 → 預設應用 → 把 Chrome 設為預設瀏覽器
2. 回到 WorkBuddy，選「在瀏覽器中開啟」重試
3. 或者選「複製連結」，自己開啟瀏覽器 Ctrl + V 貼上完成驗證

macOS：

1. 系統偏好設定 → 通用 → 設預設瀏覽器為 Chrome 或 Safari
2. 重啟應用後重新登入

原因二：賬號目錄權限不足

先確認目錄權限。

macOS 終端裡執行：

ls -la ~/Library/Application\ Support/CodeBuddyExtension/

ls -la ~/Library/Application\ Support/CodeBuddyExtension/Data/Public/auth/

如果目錄 owner 不是當前使用者（用 whoami 確認當前使用者名稱），需要授權。

Windows PowerShell 裡執行：

Get-Acl "$env:APPDATA\CodeBuddyExtension" | Format-List

確認 Owner 和 Access 列表中包含當前使用者。

然後授權給當前使用者。

macOS 終端：

sudo chown -R $(whoami) ~/Library/Application\ Support/CodeBuddyExtension

Windows 以管理員身份開啟 PowerShell：

$user = [System.Security.Principal.WindowsIdentity]::GetCurrent().Name
$path = "$env:APPDATA\CodeBuddyExtension"
takeown /F $path /R /D Y
icacls $path /grant "${user}:(OI)(CI)F" /T

最後退出 WorkBuddy 並重新開啟，重新登入。

這幾條命令會改檔案權限

sudo chown -R 和 takeown /R 都是遞迴操作。確認路徑完全正確再執行——路徑寫錯的話，你會把一個不相干目錄的所有權改掉。

原因三：安全軟體攔截

WorkBuddy 常被誤攔。臨時退出以下安全軟體後重試：

• 火絨
• 360 安全衛士
• 電腦管家
• Windows 安全中心

成功了就把 WorkBuddy 加進白名單，別一直關著安全軟體。

診斷工具

WorkBuddy 內建「诊断工具」，一鍵檢測網路、系統資源、安全軟體、環境資訊與崩潰日誌，結果視覺化展示並自動生成診斷報告。

遇到無法登入、連線失敗、客戶端異常等問題時，建議先執行自檢。

怎麼用

1. 開啟 WorkBuddy，點頂部幫助 → 診斷工具
2. 點「開始檢測」，逐項執行，即時顯示進度與結果
3. 檢測過程中關閉彈窗不影響檢測進行，重新開啟可恢復檢視
4. 完成後自動生成 .txt 報告，儲存在日誌目錄 logs/self-check/ 下（保留最近 10 份）
5. 可在彈窗底部點「匯出報告」或「定位檔案」獲取，提交反饋時一併提供

檢查什麼

大類	檢查內容
網路	API 連通性、DNS、TCP 埠、代理檢測、丟包率
系統資源	磁碟剩餘空間（低於 1GB 報失敗、低於 3GB 告警）、記憶體使用
安全軟體	EDR / 防毒軟體識別、檔案讀寫監控檢測
環境資訊	系統資訊、客戶端版本、安裝日誌
崩潰日誌	崩潰歷史摘要

報告已脫敏，可以放心提供

IP 僅保留前兩段、使用者名稱替換為 ***，可以安全提供給支援團隊。

另外注意：個人賬號與海外版僅展示「網路」分組；企業賬號及內網版 / iOA 版 / 專享版展示全部檢查項。

檢測到安全軟體攔截時，會展示需要加入白名單的路徑；失敗項會給出方向性修復建議。

日誌在哪

macOS：開啟 WorkBuddy → 頂部幫助 → 開啟日誌資料夾，找到對應的 .zip 日誌包。

Windows：開啟 WorkBuddy → 左上角幫助下拉框 → 開啟日誌目錄，裡面的壓縮包就是日誌檔案。

日誌可能包含對話記錄

日誌僅用於排查問題，可能包含對話記錄、裝置資訊等資料。提交前如果涉及敏感內容，先確認一下。

提交反饋

兩個入口：

• 右上角幫助下拉框 → helpFeedback
• 右下角頭像 → 設定 → 幫助與反饋 → 意見反饋

在意見反饋頁面描述問題、上傳截圖並勾選上傳日誌後提交。

磁碟空間

診斷工具的判定標準：磁碟剩餘低於 1GB 報失敗，低於 3GB 告警。

這條值得單獨說，因為它導致的症狀很迷惑——任務莫名失敗、產物寫不出來、客戶端卡頓，看起來像別的問題。

跑大任務前先看一眼磁碟。特別是用了很多 Worktree 並行任務 的時候，每個 worktree 都是一份完整的工作目錄副本。

按症狀查

症狀	先看這裡
裝不上、起不來	系統要求
點登入沒反應	登入失敗
讀不了某類檔案	換支援該型別的模型；裝辦公文件四件套
生成的檔案打不開	提示詞裡明確指定輸出格式
回覆亂碼、跑偏	換模型；拆小任務；開新會話
卡住不動	停止 → 換模型 → 重新執行
很慢	查網路；拆任務；並行處理
助理 / Bot 不回話	FAQ - Bot 與助理
積分異常	積分與套餐
工作空間不見了	FAQ - 升級後工作空間不見了
檔案被改壞了	安全中心 - 自動備份

還是不行

發郵件到 workbuddy@tencent.com，附上：

• 診斷工具生成的報告
• 錯誤碼和報錯截圖
• 系統版本和客戶端版本
• 網路環境（公司 / 家庭 / 是否用代理）
• 發生時間和復現步驟