Workbuddy排错指南：按使用场景查故障，先归因再动手

Workbuddy 排错的第一原则是先归因再动手：同一个“任务失败了”的表现，可能是意图没说清、Skill 没触发、环境权限不够、任务本身不适合自动执行这四种完全不同的原因，对应的修复动作也互不通用。Workbuddy 是管理本地电脑与企业协作、用自然语言操作办公环境的 Agent，它的故障大多发生在意图、挂载、文件与协作这四层。本文按使用场景而不是按技术层组织排查顺序，每一步只做成本最低的验证，具体命令与界面入口以 Workbuddy 官方文档当天的版本为准，不在此凭记忆罗列。

先看场景速查表，再进对应小节

这张表的用法是先对号入座，再按“先查—再查”的顺序做最小验证。跳过先查直接重装，是这类排错里最常见的浪费：相当一部分“坏了”只是提问措辞和 Skill 触发说明没对上，重装一百次也不会改变结果。

场景一：首次调用没反应

挂载完成后第一次调用就沉默，先做两个动作。第一，把你的提问和 Skill 的触发说明放在一起读：如果 Skill 说明写的是“生成公司调研报告”，而你问的是“帮我看看这家公司”， Agent 可能判定没有任务匹配。换用与触发说明同结构的表述再试一次，这是零成本验证。第二，确认挂载本身完整：文件是否都在、有没有在拷贝时丢了某个部分。这两步都过了仍不触发，问题更可能在挂载方式与当前版本不兼容，此时去官方文档或 Skill 来源页核对，而不是反复重新提问。

一个容易忽略的细节：同一个任务如果有多个相近 Skill 同时挂载，Agent 可能在几个之间摇摆或选错。首次排错时可以先只保留最匹配的一个，跑通后再加回来。

场景二：调研报告这类长任务中途失败

长任务断掉，先看断点前的最后一段输出在做什么。如果停在你要求它“去查某公司最新融资信息”这类外部信息上，而当时并没有开放对应的信息访问，任务失败的原因是输入契约不成立——你要求了它做不到的获取动作。最小验证是把任务改小：只给本地已有的资料，看能否完整跑完。能跑完，说明执行链路本身没坏，缺的是信息源。 如果断点没有规律、两次重试都断在同一位置附近，多半是任务一次塞了太多目标：一份报告里同时要行业、竞品、财务、团队四个维度的深度分析，上下文和步骤数都会被拉到极限。修复方向是拆成四次调用，每次一个维度，最后由人合并。这比调参数更可靠，也更符合 Vibe Marketing 里“人负责编排、AI 负责执行单元”的分工。

场景三：本地文件读写失败

文件层故障的验证成本最低，所以排在调权限之前。先确认你给 Agent 的路径是否准确、文件是否真的在那个位置——用文件管理器直接看一眼，比让 Agent 反复重试快得多。路径没问题再查授权：Workbuddy 对本地文件的操作范围有边界设定，目录不在范围内时读写会被拒绝，这是设计上的保护而不是故障。修复方向是把需要访问的目录纳入授权范围，而不是想办法绕过限制。 特别提醒：涉及删除、覆盖、批量移动的操作，无论排错排到哪一步，都应当先让 Agent 输出它打算执行的动作清单，人工确认后再执行。排错的目的本来就是减少不可逆操作，别在排错过程中制造新的。

场景四：企业协作里同事用不了

协作场景的故障多数不是技术错误，而是“产物在哪里”的错位。你本地生成的调研报告，如果只存在你自己的工作目录里，同事自然看不到。最小验证是确认产物的保存位置是否是你预期的共享位置；其次才是核对共享范围与成员权限设置。涉及给外部人员或跨组织开通访问时，停止自行调整，转人工流程审批——这类操作影响面超出个人任务，属于典型的人工关卡。

人工接管线：什么时候停止让 Agent 试

四个场景各有一条接管线，汇总成一条通用规则：同一场景内做了两轮最小验证仍无进展，或操作涉及删除、覆盖、权限变更、外部共享、对外发布这五类之一，就从“让 Agent 继续”切换到“人工处理这一步”。切换不等于放弃自动化——把该步骤的人工做法记下来，就是下一次改写 Skill 触发说明或调整授权范围的依据。排错的产出不只是这一次修好，还包括让同类故障下次出现时能被更快识别。

预防比排错省事的三件事

第一，挂载任何 Skill 前把触发说明读一遍并把常用提问写成同结构的表述，能避开大半“没反应”。第二，给长任务的输入里写清“哪些信息源你可以访问、哪些不要尝试获取”，减少中途断掉的概率。第三，把授权范围按“当前任务需要的最小集合”设定，并定期清理不再使用的部分——范围越小，文件层故障越少，出问题时的定位也越快。这三件事都属于 Vibe Marketing 里“人的判断”环节：Agent 的稳定性不是调出来的，是先把意图、边界和权限说清楚带来的。