09 · 入门与安全
新手九类常见失败
新手排错不要靠反复重试。文件、路径、权限、工具、上下文和结果分别属于不同故障层。保留原指令和日志，先找到层级，问题往往会迅速缩小。
新手排错不要靠反复重试。文件、路径、权限、工具、上下文和结果分别属于不同故障层。保留原指令和日志，先找到层级，问题往往会迅速缩小。
本章最终要解决的问题是：找不到文件、权限不足、任务跑偏、结果空白时怎样排查？
这一章怎么学
- 核心教程
- 一、安装和登录的问题
- Q1：装完打不开，点了没反应
- Q2：登录失败，扫码没反应
- Q3：Win11 ARM架构装不了
- Q4：更新或重启后，工作空间没了
先跑出一个可检查的小结果，再逐步扩大任务范围。 阅读正文时，把注意力放在任务输入、真实动作、交付文件和人工判断点上。
资料说明：下面的具体步骤、案例和截图根据已收集的第三方教程重组。正文中的第一人称均指原教程作者，不代表曾俊本人的经历或实测；案例数字也不能直接视为官方承诺。
核心教程
用了三个月，踩过的坑比写过的周报还多。这篇文章把我和朋友群里被问得最多的问题全整理出来，直接对号入座。
一、安装和登录的问题
Q1：装完打不开，点了没反应
八成是没设默认浏览器。 系统 怎么搞 Windows 设置 → 默认应用 → 把Chrome设为默认浏览器，重启WorkBuddy Mac 系统偏好设置 → 通用 → 默认浏览器改Chrome，重启 还不行？看看是不是360、火绒、电脑管家在拦截——关掉安全软件试试。
Q2：登录失败，扫码没反应
先试试这些：
- 把Chrome设为默认浏览器（见Q1）
- 如果浏览器没自动弹，点"复制链接"，手动粘贴到浏览器
- Mac用户：终端执行sudo chown -R $(whoami) ~/Library/Application\ Support/CodeBuddyExtension ，给权限
Q3：Win11 ARM架构装不了
不支持。WorkBuddy目前不支持ARM架构的Windows。改用x64设备，或者等后续版本。
Q4：更新或重启后，工作空间没了
去这个路径找：
- Windows：C:\Users\你的用户名\WorkBuddy
- Mac：/Users/你的用户名/WorkBuddy 打开对应日期的文件夹就能恢复。建议把重要文件同步存到独立目录，别全依赖WorkBuddy的工作空间。
二、运行卡顿和报错
Q5：AI回复乱码、胡言乱语、长时间不响应
三步走：
- 先切换模型（DeepSeek换混元或Kimi），八成能解决
- 把大任务拆小
- 确认网络没问题
Q6：任务跑一半卡住了
点右下角停止任务按钮→ 切换模型 → 重新执行。
Q7：常见错误码怎么办
错误码 原因 怎么搞 14003 / 11133 / 1001 模型问题 切换模型重试 3002 / 3003 / 400-504 网络问题 公司网找IT，家庭网检查代理 6003 请求太频繁 等一会再试，或切模型
三、Bot连接问题
Q8：企业微信/微信机器人连上了但不回消息
- 先检查连接状态是否在线
- 切换模型再测试
- 微信场景长时间不响应 → 断开重连
Q9：鸿蒙微信扫码失败
移动端兼容性需按当前系统和客户端版本实测，无法登录时使用官方支持渠道。
四、文件和工作空间
Q10：读不了图片、PDF、Excel
原因 解决 当前模型不支持 切到支持多模态的模型（如混元） 没装相关Skill 去技能市场装"办公文档四件套" 要求没说清楚 明确说"读取这个PDF/Excel"
Q11：让AI整理桌面后文件丢了
血泪教训：整理前先备份桌面重要文件！ 如果已经丢了，先去目标整理目录和回收站找。还找不到就用数据恢复工具，AI生成的脚本不会彻底删除。
Q12：生成的文件打不开
没指定格式。下达任务时说清楚："输出Word/Excel/PDF"。不说它就按默认来。
Q13：更新时提示"检测到安装目录下有用户项目"
把安装目录里你自己产生的文件夹移走，只保留系统文件夹（bin、locales、resources、tools），然后重新更新。
五、功能问题
Q14：能不能自定义模型？
能。设置里可以配置第三方模型。具体配置文档官网有。
Q15：能不能在服务器上装？
暂时不推荐。Windows Server有人装过但连接不稳定，服务器端能力还在完善中。
Q16：助理工作空间为什么不能改文件夹？
助理是专门给远程控制用的，设计上就不让你改。电脑端新建任务时别把助理当普通工作空间用。
六、账户和积分
Q17：升级专业版购买后还是显示体验版
前端显示bug，不影响实际使用。确认已购买成功就行，团队在修。
Q18：积分没到账或消耗异常
去官网 → 个人主页 → 用量管理查明细。异常截图发邮件到 workbuddy@tencent.com[1]。
Q19：补偿积分怎么领
官网 → 右上角头像 → 个人主页 → 用量管理 → 领取。
Q20：数据安全吗？
安全。三层保障： 层级 做什么 技术层 沙箱隔离，AI操作不了你授权外的文件 管理层 SSO登录、IP白名单、权限控制 合规层 数据本地处理不上传，用后即弃 简单说：你的文件存在你的电脑上，AI只是临时读取处理，不会上传到云端保存。腾讯云的ISO27001、等保三级这些资质齐全。
最后几条建议
建议 原因 重要文件先备份 防AI改过头 先切模型再排查 90%的问题换模型能解决 报错先截图 保留错误码和系统版本 新人从小任务开始 先跑通一次完整流程 👉收藏这篇：遇到问题回来搜 👉留言告诉我：你遇到过什么奇葩bug？ 👉关注我：后续持续更新 AI Agent 实战，不吹不黑，用过才写 WorkBuddy AI Agent 实战系列 · 第12期 #小龙虾#WorkBuddy#AIagent#智能体#踩坑指南#AI百宝箱#效率技巧#新手教程#FAQ常见问题
补充教程
说实话，这两年我试过的 AI 工具没有十个也有八个。
它们的画风很统一：你打字，它回字。你再说，它再回。聪明是真聪明，但就是不干活。
会议纪要写完了？你自己复制进飞书。表格整理好了？你自己贴进 Excel。周报写完了？你自己改成 PPT。三个小时的会，AI 陪你聊了四十分钟，最后发现活儿还是你的。
它永远是你的军师，不是你的手。
直到 WorkBuddy 出现，我才第一次觉得：这玩意儿是真的会替我搬砖。它不是跟你聊天，它是直接打开电脑，读写文件，把成品交到你手上。
今天这篇文章写给两种人：一是完全没听过的小白，二是装完之后就吃灰的新手。读完你就能跑通第一个任务，顺便避开我踩过的 9 个坑。
放轻松，跟我走。
一、WorkBuddy 到底是个啥？
一句话人话版
WorkBuddy = 会动手干活的 AI 员工。 你把任务丢给它，它会自己拆解、自己规划、自己操作电脑，最后把产物交给你。
- ChatGPT / DeepSeek = 你的顾问：只动嘴给建议，活你自己干。- WorkBuddy = 你的员工：你说它干，干完交差。
（数据来源：WorkBuddy 官方文档整理）
这个区别听起来简单，但用惯了聊天 AI 的人会很不适应。你不需要再问一句、复制一段、改一下格式——你只要验收结果就行。
比如你说「帮我整理这 50 份发票」。聊天 AI 会给你一段整理思路，然后你继续自己干活。WorkBuddy 会直接在你的电脑上新建 Excel，把发票编号、金额、日期、类型分好列，文件存好，然后告诉你「做完了，在 发票汇总.xlsx 里」。
这就是最本质的差别。
二、下载安装：5 分钟搞定
2.1 下载
官方入口曾多次调整，请从腾讯当前官方页面或企业管理员提供的地址进入，发布前重新核验域名。 按系统选：
- Windows 下载
.exe - Mac 下载
.dmg
2.2 安装
双击一路下一步。装完桌面出现 WorkBuddy 图标，打开即可。 小贴士：
- 建议提前装好 Node.js（LTS 版）和 Git。部分技能和后端任务会依赖它们。
- 如果只体验基础功能，可以先不装，等提示缺了再补。
- 安装路径最好不要带中文或特殊符号，避免后续脚本调用时路径解析出错。
2.3 登录
两种方式：
1.微信扫码（推荐）： quickest，不用记密码。
2.账号密码：适合公司电脑不方便扫码的场景。
登录后主界面分成三块，左边导航栏，中间对话区，右边结果区，干净不迷路。
（图片来源：WorkBuddy 官方文档）
一句话总结
下载安装没门槛，5 分钟能开干。唯一要注意的就是路径别带中文，Node 和 Git 迟早要装。
三、跑通第一个任务：让它写一份周报
别一上来就干大事。第一个任务越简单越好，目的是把流程跑顺，把 Ask / Plan / Craft 三个模式都摸一遍。
第一步：新建任务
点左侧「新建任务」或者直接按快捷键。输入框上方有三个工作模式可以切换。
（图片来源：WorkBuddy 官方文档）
第二步：先用 Ask 模式探路
如果你刚上手，先把模式切成Ask。Ask 模式只回答不动文件，不会把你的桌面搞乱。
（图片来源：WorkBuddy 官方文档）
输入：
帮我写一份产品经理周报，包含本周已完成、进行中和下周计划三段，300 字以内，正式语气。 它会立刻给你一段文字。这时候你什么都不用管，先看格式对不对、语气合不合适。不满意就继续改，比如：
太正式了，改成团队内部汇报的语气，加一句风险提醒。 Ask 模式就是用来反复试的，便宜又安全。
第三步：切 Plan 模式，看方案再执行
内容调满意之后，切换到Plan 模式。
（图片来源：WorkBuddy 官方文档）
输入：
把这份周报保存成 Word 文档，文件名 周报_0805.docx，存到工作空间根目录。先告诉我你要怎么做。 这时候它不会立刻动手，而是给你列一个计划：
- 生成周报内容
- 创建 docx 文件
- 保存到指定路径 你点确认，它才开始执行。Plan 模式适合所有「第一次跑」或者「后果比较重」的任务。
第四步：切 Craft 模式，直接交付
如果你确定流程没问题了，以后同样的事就可以切换到Craft 模式。
（图片来源：WorkBuddy 官方文档）
输入：
生成一份产品经理周报，三段式，300 字以内，保存为 周报_0805.docx。 点击发送后，它会自己调用工具生成文件。几秒后右侧结果区会出现产物。
第五步：在结果区验收
右侧结果区有四个视图：
-产物：生成的 Word / Excel / PPT 文件
-全部文件：工作空间里的所有文件
-变更：这次任务改了哪些文件
-预览：直接在面板里看文件内容
（图片来源：WorkBuddy 官方文档）
点开产物，双击文件，就能用系统默认程序打开。第一份周报已经在你电脑上了。
一句话总结
第一个任务跑通的标准不是它答得多好，而是它生成的文件能直接打开。
四、三种工作模式，选错就是白烧积分
输入框上方有三种模式。很多人搞不清楚，结果重要任务没用 Plan，简单任务挂了极致模型，积分哗哗掉。
（数据来源：WorkBuddy 官方文档整理）
三个真实例子
例 1：查一个名词 直接 Ask：「USB-IF 认证是什么？」它给你一段话，完事。 例 2：整理 50 份文件 先用 Plan：「把这 50 份文件按日期和类型重命名归档，先列方案给我。」确认后再执行。 例 3：每天生成日报 用 Craft 加自动化：指令固定，格式固定，数据路径固定，直接跑。
一个容易搞混的点
有人以为 Ask → Plan → Craft 是权限从低到高。
不对。工作模式管的是它怎么思考，权限模式管的是它能碰你电脑的边界。这是两个独立开关。
（图片来源：WorkBuddy 官方文档）
一句话总结
Ask 用来试，Plan 用来稳，Craft 用来快。三者没有高低，只有场景。
五、两种权限模式，决定它能不能直接动你的文件
权限只有两档：
（数据来源：WorkBuddy 官方文档整理）
新手建议一直开着默认权限。它会在删除、修改、执行命令前弹窗确认。完全访问只在两种情况下开：
- 你已经跑过同样的流程，确认不会出问题。
- 它只在一个副本目录里工作，原始文件安全。
（图片来源：WorkBuddy 官方文档）
四种常见组合
（数据来源：WorkBuddy 官方文档整理）
如果你看到弹窗还点是，那出问题就别怪 AI。
一句话总结
Craft 模式不等于完全访问。想让它直接干，先确认权限也开到了对应档位。
六、界面就三块，认准了就不迷路
（数据来源：WorkBuddy 官方文档整理）
结果区四个视图具体怎么用
-产物：只看 AI 这次生成了什么。最重要的视图。 -全部文件：看工作空间里所有文件，方便找历史产物。 -变更：AI 这次任务改了哪些文件、改了什么内容。验收前必看。 -预览：不用打开外部软件，直接在工作台里看文档内容。 刚开始你会觉得右边有点空。等它开始生成文件，你就知道结果区为什么重要了。所有产物都在那里，不用你到处找。
一句话总结
侧边栏管历史，对话区管输入，结果区管验收。三块各司其职。
七、模型那三档，其实就一个原则
除了工作模式和权限模式，还有一个地方会决定积分消耗：模型档位。 -快速：优先响应速度，适合简单问答和格式转换。 -均衡：兼顾速度和质量，默认就用它。 -极致：优先深度和准确性，复杂分析才上。 日常任务挂快速或均衡就行。极致模式不是越贵越好，它是为深度推理准备的。你让它重命名十个文件也挂极致，纯属浪费。
选择建议
（数据来源：WorkBuddy 官方文档整理）
别小看这个下拉框。一天下来，档位选错可能让你的积分消耗差出两三倍。
一句话总结
简单活别挂极致，复杂活别挂快速。均衡模式承担 80% 的工作。
八、快速上手的三个好习惯
除了避开坑，还有三个好习惯能让你少走一个月弯路。
习惯一：每个任务单独一个文件夹。
不要把所有文件都丢进一个「WorkBuddy 测试」目录。按任务建文件夹，比如 周报20250805、发票202507、竞品调研_Q3。AI 在干净目录里工作效率更高，你事后找文件也方便。
习惯二：给任务起个看得懂的名字。
默认任务名可能是「新任务」或者你第一句话的前几个字。手动改成「0805 周报生成」这种名字，一周后你搜索时能一眼认出。
习惯三：跑完先看变更区。
这是最重要的一条。变更区会列出 AI 具体改了哪些文件、改了什么内容。养成跑完必看的习惯，能避免很多「我以为它没动，其实它动过了」的误会。
一句话总结
文件夹分开、任务名写清、变更区必看。这三条坚持一周，你就会明显顺手。
九、新手最容易踩的 9 个坑
我把坑和填坑方法整理成一张表，建议你直接收藏。
（数据来源：WorkBuddy 官方文档整理）
重点说六个最常见的。
坑一：把整个 D 盘设成工作空间。
第一次用它会问你要用哪个文件夹。很多人为了方便，直接选一个大的根目录。结果 AI 每次都要扫一堆无关文件，既慢又容易误操作。更可怕的是，如果它理解错了你的指令，可能会把不该碰的文件也纳入操作范围。
正确做法是：每个任务单独建一个文件夹，只放这个任务要用的文件。处理完再归档。比如 周报20250805、发票202507、竞品调研_Q3。文件夹越小，AI 越不容易跑偏。
坑二：原始文件不留备份。
这是事故第一名。AI 的变更记录能告诉你它改了什么，但它没法告诉你改之前长什么样。让它动文件前，先复制一份 _backup 副本。养成这个习惯，能救你一命。尤其是批量重命名、批量移动这类操作，备份就是后悔药。
坑三：分五次问同一件事。
聊天 AI 养成的习惯。但 WorkBuddy 是多轮上下文累加计费的。第五轮的时候，前面四轮的内容还在被反复处理。一次把目标、输入、格式、约束四要素说清楚，通常能省一半。不要先说一句试试水，再说一句补条件。
坑四：让它猜文件在哪。
「处理一下桌面上那份表格」这种话风险很高。桌面可能有十份表格，它不一定猜中你要哪一份。正确说法是：「处理工作空间里的 sales2025.xlsx，路径是 ./sales2025.xlsx」。
坑五：简单活也挂极致模式。
极致模式是为深度推理准备的。你让它重命名十个文件、转换格式、汇总表格也挂极致，纯属浪费。日常 80% 的任务，均衡模式完全够用。
坑六：装一堆技能从不清理。
技能多了之后，AI 可能会调用错误的技能，或者多个技能互相抢活。建议只开启当前任务真正需要的技能，用完就关。连接器同理，不用的授权及时断开。
一句话总结
工作空间要小，备份要勤，指令要一次说全，路径要给准，档位别乱挂，技能别滥装。
九、写在最后
用了这么多 AI 工具，WorkBuddy 给我的最大感触是：
它终于把 AI 从「回答问题」变成了「完成任务」。 以前 AI 是我的智囊，给建议、帮我想，但最后动手的还是我。 WorkBuddy 不一样。你说，它做，它交付。 这个转变比任何一个单独功能都重要。它还不完美，复杂任务偶尔会跑偏，需要你追问纠正。但方向对了。 如果你刚入门，今天这篇文章够你跑通第一个任务。剩下的，就是在真实工作里一点点喂它、调它、用它。 我是「座舱里的AI」，一个混在智能座舱行业里研究 AI 工具的打工人。咱们下篇见。
把这一章真正跑一遍
下面这条任务可以直接放进 WorkBuddy。先用脱敏副本练习，确认无误后再替换成正式材料。
不要重做整个任务。请根据原指令、报错和目录清单定位失败层级：输入、路径、权限、工具、过程或产物。给出最小复现步骤和只改变一个变量的重试方案。
本章完成后，应留下这些结果：
- 新手排错决策树 已生成、能打开，关键内容能回到输入材料。
最后再看一遍实际文件和变更记录。删除、覆盖、外发、发布、付款、审批和生产写入继续由有权限的人确认。遇到材料冲突、权限不足或外部状态不确定，让任务停下并列出待处理问题。
AI 办公产品教程 · 完整版