← 返回
未分类

WorkBuddy智能诊断助手

WorkBuddy 智能诊断助手——WorkBuddy 报错、卡住、连不上、任务不跑?不用再瞎猜了。一键运行诊断脚本,自动扫描代理、连接器、日志、网络和客户端检测结果,匹配常见错误模式,直接告诉你问题在哪、怎么修。复杂问题还能自动生成官方反馈文案,复制就能提交。当用户说"诊断一下""检查环境""出问题了""帮我排查"或遇到连接器断开、调用失败、自动化不执行等故障时触发。不同于 workbuddy-guide(使用指南skill),本技能是主动诊断引擎:跑脚本→识别错误→输出结论+修复动作,复杂问题自动生成官方反馈文案。
WorkBuddy 智能诊断助手——WorkBuddy 报错、卡住、连不上、任务不跑?不用再瞎猜了。一键运行诊断脚本,自动扫描代理、连接器、日志、网络和客户端检测结果,匹配常见错误模式,直接告诉你问题在哪、怎么修。复杂问题还能自动生成官方反馈文案,复制就能提交。当用户说"诊断一下""检查环境""出问题了""帮我排查"或遇到连接器断开、调用失败、自动化不执行等故障时触发。不同于 workbuddy-guide(使用指南skill),本技能是主动诊断引擎:跑脚本→识别错误→输出结论+修复动作,复杂问题自动生成官方反馈文案。
该影
未分类 community v1.0.5 6 版本 100000 Key: 无需
★ 1
Stars
📥 42
下载
💾 0
安装
6
版本
#latest

概述

WorkBuddy 智能诊断助手

WorkBuddy 报错、卡住、连不上、任务不跑?不用再瞎猜了。

一键运行诊断脚本,自动扫描代理、连接器、日志、网络和客户端检测结果,匹配常见错误模式,直接告诉你问题在哪、怎么修。复杂问题还能自动生成官方反馈文案,复制就能提交。

快速使用

python scripts/smart_diagnose.py

使用示例

场景1:刚遇到问题,不知道怎么回事

  1. 在 WorkBuddy 里说「诊断一下」或「帮我排查」
  2. 脚本自动检查代理、连接器、日志、网络
  3. 看输出第一行 [*] 问题:xxx — 这就是根因
  4. 跟着 [>] 修复:xxx 的建议做
  5. 术语看不懂?打开 glossary.md 查大白话

场景2:修完还不行

  1. 再看输出底部「官方反馈报告」部分
  2. 复制文案 → 打开 WorkBuddy → 帮助(H) → 意见反馈 → 粘贴提交
  3. 同时加载 workbuddy-guide 技能做深度排查

场景3:脚本说"未能自动识别"

  1. 按输出的 5 步自助排查清单依次试
  2. 大部分问题到第 1 步(重启 WorkBuddy)就解决了
  3. 还不行就复制反馈报告提交给官方

诊断流程

用户说"诊断一下"
    │
    ▼
运行 smart_diagnose.py
    ├── 检测代理状态(是否运行/端口/响应时间)
    ├── 扫描连接器配置(哪些连接/哪些断开/错误码)
    ├── 读取最近日志(搜索 error/fail/timeout/401/403)
    ├── 检查专家注册(plugin.json/agents/目录完整性)
    ├── 验证自动化任务(status/trigger_time)
    ├── 检查客户端网络检测报告(帮助→网络检查)
    ├── 匹配错误模式(长任务卡住/文件读取/格式错乱/休眠/安全软件等)
    └── 输出一句话诊断 + 一个修复动作
    │
    ▼
匹配错误模式(pattern-db.md)
    │
    ▼
输出一句话诊断 + 一个修复动作
    │
    ▼
若无法匹配 → 自动生成300字以内官方反馈文案

覆盖的高频问题

  • 长任务中途卡住:上下文压缩触发或内存OOM
  • 文件读不出:沙箱权限不足或模型不支持
  • 格式乱掉:模型切换后格式指令丢失
  • 定时任务到点没跑:电脑休眠导致后台任务挂起
  • MCP连接器消失:OAuth token过期未自动刷新
  • 产物预览打不开:临时目录被系统清理
  • 安全软件拦截:火绒/360等误拦截WorkBuddy
  • 远程指令无响应:企业微信/飞书指令已发送但PC端没反应
  • 上下文压缩异常:压缩中卡住、消息错乱或丢失
  • Teams 项目任务历史丢失:重进运行中任务对话没了
  • 团队队列任务卡住:工作队列重复入队或停止态不同步
  • 沙箱弹窗反复出现:切换任务后拦截弹窗不消失
  • 沙箱权限不生效:授权了但仍然被拦
  • 任务流转失败:handoff 按钮异常
  • 锁屏后任务断开:合盖锁屏长时间任务连接中断
  • 数字助理异常:助理面板创建或管理出问题

输出格式

[*] 诊断结论:问题类型 — 简要描述
[>] 推荐修复:具体操作(1条,不列多个选项)
[?] 详细参考:需要翻 workbuddy-guide 的哪个卡片/文档

与 workbuddy-guide 的协作

  • 本技能输出"诊断 + 修复",workbuddy-guide 提供"原理 + 完整流程"
  • 诊断结论中附带 guide 引用链接,用户需要深入学习时跳转
  • 诊断失败(无匹配模式)时,建议用户加载 workbuddy-guide 详细排查

使用规范

  1. 不要只列可能原因,输出 1 个最可能的根因和 1 个修复动作
  2. 诊断失败时,输出 scripts/smart_diagnose.py 的完整输出,引导用户去 workbuddy-guide
  3. 涉及外部操作(如重启服务、修改配置),先提示用户确认
  4. 模式库持续更新:发现新错误模式后,追加到 scripts/smart_diagnose.pyPATTERN_DB 字典中

参考文件索引

场景文件用途
------------------
智能诊断引擎scripts/smart_diagnose.py一键诊断 + 模式匹配 + 输出建议
错误模式库references/pattern-db.md错误模式与修复动作速查表(供人类阅读)
术语白话表references/glossary.md专业术语的大白话解释
协作技能workbuddy-guide深度排查手册,复杂问题时的兜底方案

版本历史

共 6 个版本

  • v1.0.5 V1.0.5基于客户端v5.0.0–v5.0.2版本更新 新增8条模式:Teams 项目历史丢失/队列卡住/任务流转、沙箱弹窗/权限、上下文压缩异常、锁屏断开、数字助理异常;模式库达45条 当前
    2026-06-09 13:50 安全 安全
  • v1.0.4 Initial release
    2026-06-04 11:50 安全 安全
  • v1.0.3 ##v1.0.3 1、新增兜底5步自助排查清单、术语白话对照表(glossary.md)、使用示例章节; 2、修复Windows GBK终端emoji报错; 3、清理未使用代码
    2026-06-04 11:42 安全 安全
  • v1.0.2 v1.0.2 — 正式发布 一键诊断 WorkBuddy 常见故障,自动匹配 37 种错误模式 覆盖 8 大问题场景:代理崩溃、连接器断连、长任务卡住、文件读取失败、格式错乱、定时任务中断、MCP OAuth 过期、安全软件拦截 集成客户端网络检测报告解析(代理/hosts/服务/TCP/丢包) 支持 300 字以内官方反馈报告自动生成 基于官方 FAQ、公众号文章、使用教程等 4 类来源构建模式库
    2026-06-04 11:19 安全 安全
  • v1.0.1 支持一键诊断WorkBuddy常见故障,自动匹配36种错误模式(PS0/PS1/PS2),集成客户端网络检测报告解析,支持300字以内官方反馈报告自动生成。
    2026-06-03 15:19 安全 安全
  • v1.0.0 初始版本,支持一键诊断WorkBuddy常见故障,自动匹配36种错误模式(PS0/PS1/PS2),集成客户端网络检测报告解析,支持300字以内官方反馈报告自动生成。
    2026-06-03 14:34 安全 安全

安全检测

腾讯云安全 (Keen)

安全,无风险
查看报告

腾讯云安全 (Sanbu)

安全,无风险
查看报告

🔗 相关推荐

ai-agent

Self-Improving + Proactive Agent

ivangdavila
自我反思+自我批评+自我学习+自组织记忆。智能体评估自身工作、发现错误并持续改进。
★ 1,379 📥 320,422
ai-agent

Skill Vetter

spclaudehome
AI智能体技能安全预审工具。安装ClawdHub、GitHub等来源技能前,检查风险信号、权限范围及可疑模式。
★ 1,227 📥 267,824
ai-agent

self-improving agent

pskoett
捕获经验教训、错误及修正内容,以实现持续改进。适用于以下场景:(1)命令或操作意外失败;(2)用户纠正Claude(如“不,那不对……”“实际上……”);(3)用户请求的功能不存在;(4)外部API或工具出现故障;(5)Claude发现自身
★ 4,082 📥 810,077