常见问题 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、账号管控、传输安全。

不解决的：模型理解偏差导致的操作失误。沙箱能拦住「不该碰的目录」，拦不住「该碰的目录里做错了事」。

所以备份和预览确认这两条习惯，是任何安全体系都替代不了的。

新手适合从哪些场景入手

官方给的高频入门场景：

• 控制微信，自动发朋友圈或统计群聊信息
• 自动编写并发布小红书内容
• 自动采集指定网页信息并整理成目标文件

建议做法：优先从单一、结果明确的场景开始，先跑通一次完整流程，再逐步扩展到更复杂任务。

本书的 实战案例 就是按这个思路组织的。