外观
附录 C 常见问题与错误处置
附录 · 放在手边查
大部分「它坏了」,其实是「我没说清」或者「权限边界到了」。这一页先教你怎么定位,再按症状给答案。
难度 ★☆☆耗时 3–10 分钟前置 第 6、21 章
这一页怎么用
先别急着重装。按「错误处置四步法」走一遍,八成问题在第二步就露出来了;剩下的翻 FAQ——20 条,分安装与登录、权限与文件、产物与验收、积分与套餐、连接器与定时任务五组,症状对不上再查最后的对照表。
错误处置四步法
出问题时最浪费时间的动作是「再试一次」。它可能只是运气好了一次,也可能把现场毁掉。按顺序做这四步,每次只花几分钟。
- 复述现象。 用一句话写下来:我在做什么、它做了什么、和预期差在哪。写成「让它把 37 个 docx 转 PDF,结果只转了 12 个,剩下的报文件被占用」,比「转换失败」有用得多。这句话也是你后面去官方 FAQ 搜索的关键词。
- 定位环节。 任务是分步跑的:读文件 → 处理 → 写文件。看结果区那句「改了哪些文件」,判断是没读到、读错了,还是写的时候被拦住了。被拦住通常是权限在起作用,不是它坏了——这时看对话区有没有等确认的提示。
- 最小复现。 拿一个文件、一张表、一段话重跑。很多人第一次会说「它就是不干活」,其实是一口气丢了 200 个文件进去,中途某一步卡住,整条流程停了。缩到最小能跑通,再逐步加回去,你就知道是哪一类文件的问题。
- 换一条路。 同一步用另一种说法、另一个格式、另一个权限档位再试。比如它读不出扫描版 PDF 的文字,就先让它把 PDF 转成图片、逐页看;比如批量删除总被拦,就改成先移动到「待删」文件夹、你自己确认后清空。不要为了绕过确认去开完全访问,那等于把刹车拆了。
一个反例
「我开了完全访问它还是不行」——九成情况下,问题不在权限,而在路径:文件在另一个盘、文件名里有特殊字符、表格被 Excel 独占打开。先让它列出它看到的文件清单,比调权限快得多。
安装与登录
装完打不开,或者系统提示来源不明
Windows 上的 SmartScreen 和 macOS 的隐私与安全拦的是「没见过的开发者」,不是这个软件本身有问题。Windows 点提示里的「更多信息 → 仍要打开」;macOS 到系统设置的隐私与安全里允许这次打开。企业电脑若被统一管控,需要 IT 放行安装包。
我的系统能不能装
官方支持 Windows、macOS,以及统信 UOS、银河麒麟这类国产系统。具体到你的版本和芯片架构,以官网下载页当前列出的安装包为准,页面没写就是暂时没有。
登录时选「个人」还是「企业」
自己用、先试用,选个人,用微信扫码登录。公司统一采购了企业版,选企业,走管理员给你的入口。选错不会丢数据,但套餐和积分归属不同,事后要换得重新登录。
更新之后菜单找不到了
这个产品迭代很快,菜单位置会微调,名字一般不变。先按第 3 章的四大区去对应位置找;实在对不上,就按「以当前版本为准」看官方文档里的同名条目,不要照着半年前的截图硬找。
权限与文件
它为什么老停下来问我
这是默认权限在干活。它以你选的工作空间为边界,写敏感路径、删受保护文件或批量删除、执行脚本命令、访问网络这些高风险动作,都会先请求确认。被问一次说明它想越界一步,不是出错。
它能读我整个硬盘吗
默认不能,只能在这次任务的工作空间里活动。想让它处理别的目录,正确做法是把副本放进工作空间,而不是把工作空间设成整个盘。
「允许完全访问」开了怎么关
入口是输入框底部那个常驻的权限按钮。要注意它是全局开关:当前客户端的所有任务都生效,但不跨设备——换台电脑还是默认档。开之前有风险确认弹窗,干完活记得切回来。
它说没有权限写这个目录
先看目标路径在不在工作空间内。另外,首次打开含开发配置目录(比如 .codebuddy)的工作区会弹信任窗,选「正常打开」才是完整权限;选了「受限模式」,读写和命令都会受限。受限模式适合只看不改的场景。
文件被改坏了还能恢复吗
安全中心有自动备份(默认开启)和删除保护,多数误删、误改能找回。但备份不能替代你自己的副本:动重要文件之前,先在工作空间外留一份原始件,这是唯一稳妥的做法。
产物与验收
结果区只有一段话,没有文件
说明输出格式没指定。补一句「输出 Word / Excel / PPT,文件名 xxx,放在工作空间里」,它就会落成文件。这不是它偷懒,是「写一段话」和「交一个文件」在它看来是两件事。
表格的数字对不上
先查口径:含税还是不含税、自然月还是账期、去重按单号还是按行。再让它出一张「说明」页,写清清洗前后的行数、金额合计、删了多少重复行——对不上时,这页比结论有用。
产物存在哪,关掉还能找回吗
产物默认在工作空间里,结果区的「产物 / 全部文件 / 变更」都能看。任务留在侧边栏,按文件夹分组,也能搜索标题。真找不到了,先在工作空间里按修改时间排序。
积分与套餐
体验版 500 积分够用吗
跑通本书前几章、做十几个小任务通常够。消耗跟任务复杂度走:读几个文件、写份文档是小额,批量处理几百个文件、反复重跑会明显更快把额度用掉。具体额度与消耗规则以官方为准。
积分用完了怎么办
可以买加量包,官方列的是 1000 积分 / 50 元 / 1 个月,也可以升级套餐。WorkBuddy 与 CodeBuddy 的积分是共享的。价格和有效期都会变,以官方定价页为准。
体验版和付费版差在哪
差在额度,也差在额度之外的上限:自动化任务条数、项目数、成员数、资料库容量都按版本不同,体验版较少、付费版更多,以你当前版本显示为准。公开价目是标准版 99 元/月、高级版 199 元/月、旗舰版 999 元/月,连续包月与包年有折扣——下单前再核一遍官方定价页。
连接器与定时任务
连不上腾讯文档或知识库
先在连接器里重新授权,确认登的是同一个账号(个人号和企业号经常不是一套)。公司网络限制外网或禁止第三方授权时,连接会一直转圈,这种情况找 IT。
定时任务到点没跑
最常见的原因是电脑关机、休眠或没联网——它跑在你这台机器上,不是云端。其次是流程本身没跑稳:先手动跑一次,确认能出产物,再交给定时。触发时间也检查一下,别把上午和晚上设反。
定时任务的结果去哪看
任务记录在侧边栏,按时间排序就能找到;如果你挂了助理,结果会推到微信、企微、飞书或钉钉里。移动端发起的任务在「助理」里看,不在电脑端的任务列表里。
微信助理收不到推送
先确认助理还绑着、账号没换;再确认这个任务是发给助理的,而不是只在电脑上跑的一次性任务。仍收不到,就在电脑端手动重跑一次,看产物有没有生成——先分清是「没跑」还是「没推」。
邮箱接进来了,附件读不到
先让它列出「看到了哪些邮件、哪些带附件」,确认范围对不对;再看附件格式,扫描件和图片型 PDF 需要额外识别,可能要多花时间或积分。涉及合同、发票这类敏感附件,建议在工作空间里放副本处理。
去哪找答案
| 症状 | 先看哪章 / 哪页 | 官方链接 |
|---|---|---|
| 装不上、登录不了、找不到入口 | 第 2 章 / 附录 B | 官方常见问题 |
| 一直弹确认、被拦住不能写 | 第 6 章「权限与安全」 | 权限与安全沙箱 |
| 产物不对、数字对不上 | 第 20 章「验收与可靠性」 | 创建任务 |
| 报错、任务中途停下、想回滚 | 第 21 章「排错、回滚与安全边界」 | 官方常见问题 |
| 错误码、具体报错文案 | 把报错原文贴进官方 FAQ 搜索 | 官方常见问题 |
| 积分、套餐、发票与开票 | 本页「积分与套餐」一节 | 官方定价页 |
| 连接器连不上、授权失败 | 第 15 章「连接器与 IM」 | 官方常见问题 |
| 定时任务不跑、推送收不到 | 第 18 章「定时任务」 | 适用场景 |
| 想直接找人(商务、开票、合作) | 官网底部入口 | 官网 |
两个入口没有固定短链
「错误码」和「联系我们」在官方站点上没有稳定可引用的独立地址,从官网文档页的目录或页脚进最稳。链接失效时,直接在官网搜索同名条目。
免责声明
本站是社区编写的读本,与腾讯公司及 WorkBuddy 官方无隶属关系,不代表官方立场。文中提到的功能、界面路径、积分与价格,均以你当前客户端版本和官方定价页为准;产品迭代很快,如有出入以官方文档为最终依据。
书里的提示词和操作建议供核对,涉及合同、财务、人事、法律等需要专业判断的事项,请由对应责任人复核后再使用。
下一章
FAQ 是按问题分的,如果你的症状还没对上号,去「按症状排查」页,从表现倒推原因。
下一章按症状排查:帮你解决→