常見問題 FAQ

按主題分組。技術性排錯和錯誤碼在 排錯與錯誤碼。

官方支援渠道

本頁解決不了的問題，可以發郵件到 workbuddy@tencent.com 諮詢。附上錯誤碼、截圖、系統版本和發生時間會快很多。

安裝與登入

裝不上 / 起不來

先確認系統版本：Windows 10 及以上（不支援 Win 7 / 8 / 8.1，Windows 11 ARM64 暫不支援），macOS 12 (Monterey) 及以上。不滿足要求的系統無法啟動。

Mac 上還要選對晶片版本：M 系列選 ARM64，Intel 選 X64。官網識別不出裝置時預設給 X64（能通過 Rosetta 在 M 系列上跑，相容性更廣）。

點了登入沒反應

三個常見原因，見 下載與安裝 和 排錯：沒設預設瀏覽器、賬號目錄權限不足、安全軟體攔截。

升級後工作空間不見了

Windows 上的已知現象。檔案通常還在，去這兩個位置找：

• Windows：C:\Users\<用户名>\workbuddy
• macOS：/Users/<用户名>/WorkBuddy

用 WorkBuddy 開啟以日期或自定義名字命名的資料夾，歷史記錄一般就回來了。

長期建議：重要檔案同步儲存到獨立目錄，別隻留在預設工作空間。

更新提示「安裝目錄下存在使用者專案目錄」

WorkBuddy 更新或重灌時安裝目錄會被清空重寫。處理辦法見 下載與安裝。

根本對策：不要把工作空間設在安裝目錄裡。

檔案與工作空間

讀不了圖片 / PDF / Excel / Word

兩個原因：當前模型不支援對應檔案型別，或者沒裝相關外掛與 Skill。

處理：

1. 切換到支援圖片或文件輸入的模型
2. 分步驟描述需求，讓它逐步完成環境安裝與檔案處理
3. 在外掛或技能市場裝文件處理類外掛與 Skill（辦公文件四件套）

生成的檔案打不開

最常見的原因是沒在需求裡明確指定輸出檔案型別。下達任務時寫清楚要 Word、Excel、PDF 還是 Markdown。

整理桌面後文件丟了

Windows 上的已知情況：下發整理桌面指令後會生成一個 PS 指令碼，執行後桌面完成整理，但部分檔案疑似丟失。

處理：先檢查目標整理目錄和回收站；保留生成的指令碼與執行結果截圖便於排查。

更根本的建議：不要讓它直接整理桌面。桌面混雜著系統檔案、快捷方式和正在用的臨時檔案。把要整理的東西挑出來放進獨立資料夾再動手。

工作資料夾拖不進去

已知問題，暫無明確修復方案。建議記錄系統版本、拖拽方式與報錯現象後提交排查。

變通做法：用「选择工作空间」的檔案選擇器定位，而不是拖拽。

助理的歷史會話找不到了

助理工作空間中，只有最近產生對話的任務會在助理中展示，其它任務僅在工作空間列表展示。

助理適用於遠端控制。在電腦端新建任務時不建議把助理作為工作空間。

功能相關

支援自定義模型嗎

支援。設定 → 模型，圖形介面配置，不需要手改配置檔案。三種方式：提供商接入、本地部署（Ollama）、自定義 URL。見 MCP 與外掛。

助理為什麼不能改預設資料夾

助理專門適用於遠端任務，工作目錄固定，不支援修改。這是設計約束。

支援雲端部署或伺服器安裝嗎

當前伺服器端能力仍在完善中。Windows Server 安裝後出現連線失敗、SSH 連線雲端失敗等情況都有反饋，正式支援以官方後續版本為準。

企業有私有化需求的話，看企業專享版（專有云）方案。

「完全访问权限」只對當前任務生效嗎

不是。 它是全域性開關，開啟後當前客戶端內所有任務（含之後新建的）統一切到完全訪問；關閉後一起恢復。見 權限模式與安全沙箱。

記憶是即時更新的嗎

不是。每晚整理當天會話。今天說的偏好今天不一定生效。急用就寫在提示詞裡，或去「設定 - 記憶」手動編輯。

網頁端和客戶端的技能庫通嗎

個人 Skill 庫不通。專案級 Skill 在雲端統一管理，雙端一致。給團隊用的、要跨端用的，放專案級。

效能與異常

回覆亂碼、胡亂輸出、長時間無響應

常見原因是模型異常、任務過重或網路不穩定。處理：

1. 先切換模型測試
2. 將複雜任務拆分為更小步驟
3. 記錄是否伴隨錯誤碼、超時或網路波動

執行緩慢，一個任務執行很久

1. 優先確認網路環境是否穩定
2. 減少一次性過長、過大的複合任務
3. 必要時切換模型，或拆分為多個獨立任務並行處理

任務卡住沒有響應

1. 點右下角傳送任務處的按鈕停止任務
2. 切換到其他模型
3. 重新執行歷史任務

移動端要求上傳桌面檔案時提示無法完成

Windows 上的已知限制。移動端下發指令後無法直接完成本地桌面檔案上傳，受裝置權限、路徑訪問方式與平臺能力限制。

變通做法：在本機側明確指定檔案路徑後再執行；或讓它把檔案整理到一個目錄，通過網盤 / 騰訊文件 / 郵件發出來。

Bot 與助理

已完成接入但發訊息沒響應

按順序：確認連線狀態是否線上 → 優先切換模型再測 → 微信場景斷開重連 → 記錄復現時間與平臺型別。

鴻蒙微信掃碼失敗

鴻蒙 6 的微信掃碼當前存在不相容情況，鴻蒙 4 正常。臨時方案：先用安卓手機完成首次掃碼連線，再切回鴻蒙微信繼續使用。

企業微信提示 Webhook 域名主體校驗未通過

企業微信側會對 Webhook 地址做域名主體校驗。核對地址是否完整、是否與配置要求一致；仍不通過就保留報錯截圖提交排查。

QQ 機器人頻繁斷開或不回覆

優先切換模型測試。問題持續的話，記錄錯誤碼、發生時間與網路環境後再排查。

飛書配置 Webhook 提示無法檢查連結

重複輸入同一 Webhook 地址後可能出現。建議重新建立或重新填寫一次配置，避免重複輸入同一地址。

怎麼連線微信小程式

滑鼠懸停左側小程式圖示，掃碼開啟 WorkBuddy 小程式完成授權。

賬戶與積分

怎麼申請退款

先確認是否滿足退費條件（見 積分與套餐），然後：

1. 登入騰訊雲官網，進入提交工單頁面，找到騰訊雲程式碼助手
2. 填寫退還原因和問題描述後提交
3. 客服在 3 個工作日內處理
4. 稽核通過後執行退款，5–10 個工作日原路退回
5. 在訂單管理頁面檢視退款狀態

積分沒到賬或消耗異常

先去官網「個人主頁 - 用量管理」查餘額和用量明細。確實對不上的話，把異常截圖發到 workbuddy@tencent.com。

怎麼領補償積分

登入官網 → 右上角頭像 → 個人主頁 - 用量管理領取。

怎麼開發票

個人版：官網個人主頁 → 左側導航「賬單與發票」→「檢視發票」→ 前往騰訊雲控制台發票管理。

企業版：企業管理後臺 → 左側導航「訂單管理」→「發票管理」→ 前往騰訊雲控制台。注意使用企業繫結的騰訊雲 uin 登入。

怎麼登出賬號

官網登入 → 頭像 → 個人主頁 - 賬號管理 → 登出賬號。

升級後仍顯示體驗版

已知的前端顯示異常，仍在修復中。已確認購買成功的話，先保留訂單與版本資訊等待修復。

資料安全

WorkBuddy 構建了三層縱深防禦體系。

技術防禦層：沙箱隔離與權限控制

• Bash 命令沙箱——AI 操作與真實系統嚴格隔離
• 檔案系統隔離——只能訪問預先授權的工作空間目錄，無法訪問系統敏感檔案
• 防沙箱逃逸——阻止對配置檔案的寫入
• 預設安全設計——啟動時僅擁有隻讀權限，編輯檔案、執行命令需顯式使用者批准
• 分層權限系統——支援 allow / ask / deny 三種權限規則

管理管控層：企業級統一管控

• SSO 單點登入——統一身份認證，組織架構自動同步
• Credit 額度控制——按部門 / 角色設定差異化額度
• IP 白名單——限制特定 IP 段裝置登入
• 精細化工具呼叫權限——控制 AI 對檔案、命令、網路的訪問能力

合規審計層：資料保護與合規

• Skill 安全審計——與安全團隊聯動，分級風險判別
• skill-scanner 本地安全檢查——安裝前主動防禦潛在風險
• 資料本地執行不上傳——所有資料在本地環境執行處理
• 服務端僅處理資料片段——用後即棄，不儲存，不用於模型訓練

通訊安全

• HTTPS 全鏈路加密，支援 TLS 1.2 / 1.3
• IM 內建 WebSocket 通道通訊——複用企業微信、QQ、釘釘、飛書已有的安全通道，不需要在企業防火牆上開放額外埠，不依賴 frp / ngrok / Tailscale 等第三方穿透工具
• 安全通訊閘道器——支援 Gateway Token 認證與連線鑑權，配合 SSO 與 Role 權限控制

VPC 專享版

企業專享版提供物理級隔離：後臺服務、資料庫、向量資料庫等所有元件部署在獨立 VPC 內，與其他租戶物理隔離；服務間通訊在專屬 VPC 內網進行，企業可通過私有連結從辦公內網直接訪問。

這套體系解決什麼，不解決什麼

解決的：資料不出本機、越權訪問、惡意 Skill、賬號管控、傳輸安全。

不解決的：模型理解偏差導致的操作失誤。沙箱能攔住「不該碰的目錄」，攔不住「該碰的目錄裡做錯了事」。

所以備份和預覽確認這兩條習慣，是任何安全體系都替代不了的。

新手適合從哪些場景入手

官方給的高頻入門場景：

• 控制微信，自動發朋友圈或統計群聊資訊
• 自動編寫併發布小紅書內容
• 自動採集指定網頁資訊並整理成目標檔案

建議做法：優先從單一、結果明確的場景開始，先跑通一次完整流程，再逐步擴充套件到更復雜任務。

本書的 實戰案例 就是按這個思路組織的。