必须先判断agent卡住是缺原始资料还是工具权限/配置问题：若其主动索要具体文件则属资料缺失；若报模糊错误或python异常，则查右下角工具占用值，为0.0k说明工具未启用，正常则看error日志中工具名是否为空或提示权限拒绝；再用读readme、算23×47两步闭环验证工具链。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在WorkBuddy里交代一个任务，Agent执行中途卡住、报错、反复追问细节，或输出明显不完整（比如只列了大纲没填数据、引用全为空、文件生成但内容为空），必须立刻判断：它缺的是原始资料，还是调用工具的权限/配置？这个判断错了，后续所有调试都是白费力气。
看Agent是否主动发起“资料索取”
如果Agent在首轮响应中就明确列出缺失项，例如：“未找到客户反馈Excel文件，请提供路径”“知识库中无2024Q3销售政策文档，是否上传PDF？”——这属于【资料缺失】。它已成功加载检索工具，只是本地工作空间里没对应材料。
反之，若它全程不提任何具体文件名、目录或字段，而是输出模糊提示如“无法完成操作”“步骤中断”“调用失败”，甚至直接抛出Python报错（如ModuleNotFoundError、ConnectionRefusedError）——大概率是工具链断了。
查右下角上下文圈圈里的“工具及子智能体占用”
点击对话框右下角灰色小圈→展开上下文详情→定位“工具及子智能体占用”行。
若该数值为“0.0K”或远低于预期（例如你配置了3个连接器，这里却显示0.2K），说明WorkBuddy根本没加载任何工具插件，【工具未启用或配置失效】。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
若数值正常（比如25.6K），但任务仍失败，再往下看日志：点开「执行记录」→找最近一条红色error条目→看报错前最后调用的工具名。如果工具名是空白、乱码，或显示“unknown_tool”，就是工具注册失败；如果显示真实工具名（如“file_reader”“notion_connector”）但后面跟着“Permission denied”，那就是权限问题。
用最小闭环验证工具链通路
第一步：新建会话，输入指令：“请读取当前工作空间根目录下的README.md，并返回前10个字符。”
第二步：观察结果。若返回“# WorkBuddy”之类正确内容，说明文件读取工具正常；若报错“找不到文件”但你知道该文件存在，说明工具能调用但路径解析异常；若直接回复“我无法访问文件系统”，则是工具权限开关未打开。
第三步：在同一会话中追加指令：“请用Python计算23×47。”→若返回1081，说明代码执行工具可用；若报错“未启用代码解释器”，则需进入设置→技能管理→开启Python Runtime。
这三步必须串起来做，不能跳过任意一环。因为有些工具（如数据库连接器）依赖前置工具（如环境变量加载器）才能激活，单点测试会误判。
