若WorkBuddy技能包安装失败，需依次验证Python环境（3.9–3.11）、检查插件数字签名、清空skills与cache缓存目录、调试时可临时禁用签名校验，并通过/ debug install-skill --verbose获取详细日志定位具体错误。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您尝试为 WorkBuddy 安装技能包（插件），但安装过程卡住、无响应或提示“找不到模块”“依赖缺失”“权限拒绝”等错误，则很可能是本地运行环境未就绪或配置存在阻断点。以下是解决此问题的步骤：
一、验证基础运行环境完整性
WorkBuddy 的插件机制依赖于本地 Python 运行时及预置工具链，若系统未预装或版本不匹配，将导致技能包无法加载。该步骤用于确认底层支撑是否可用。
1、打开 WorkBuddy 主界面右下角的「设置」图标，进入「开发者选项」面板。
2、点击「检查 Python 环境」按钮，等待系统自动扫描并返回结果。
3、若显示 Python 3.9–3.11 未检测到 或 pip 版本低于 23.0，需手动安装或升级：前往 python.org 下载 Python 3.10 安装包，勾选“Add Python to PATH”，完成安装后重启 WorkBuddy。
二、检查插件来源与签名合规性
WorkBuddy 默认仅允许安装经腾讯云签名认证的技能包，未经签名或来源异常的 .skill 文件会被静默拦截。该步骤用于排除非法分发渠道导致的安装失败。
1、确认插件文件扩展名为 .skill，且文件大小不为 0 字节。
2、右键点击该文件，选择「属性」→「数字签名」选项卡，查看是否存在「Tencent Cloud CodeBuddy Signing Authority」签名项。
3、若签名栏为空或显示 “该文件没有数字签名”，请勿双击安装，应改用官方插件市场获取同名技能包。
三、重置插件缓存与临时目录
旧版插件残留、损坏的缓存文件或写入权限不足的临时路径，会干扰新插件的解压与注册流程。该步骤通过清理关键路径恢复安装通道。
1、关闭 WorkBuddy 全部进程（包括后台服务）。
2、按 Win+R 输入 %APPDATA%\WorkBuddy\skills，回车后删除该文件夹内全部内容。
3、再输入 %TEMP%\workbuddy_cache，回车后清空该目录下所有子项。
4、重新启动 WorkBuddy，尝试重新安装目标技能包。
四、绕过签名强制校验（仅限调试场景）
在已确认插件功能安全、且仅用于本地测试的前提下，可临时禁用签名验证以验证是否为签名机制导致失败。该操作不可用于生产环境。
1、关闭 WorkBuddy。
2、用记事本打开 %APPDATA%\WorkBuddy\config.json。
3、查找字段 "verify_skill_signature"，将其值由 true 修改为 false。
4、保存文件并重启 WorkBuddy，再次尝试安装同一插件。
五、启用详细日志定位具体失败环节
当上述方法均未奏效时，需捕获安装过程中产生的底层错误信息，以识别是网络下载中断、磁盘空间不足，还是模块 import 报错等具体原因。
1、启动 WorkBuddy 前，按住 Shift 键不放，同时双击桌面图标，进入诊断模式。
2、在主界面输入框中键入指令：/debug install-skill --verbose，然后回车。
3、执行安装操作，观察对话区域滚动输出的逐行日志。
4、若日志中出现 “PermissionError: [WinError 5] 拒绝访问”，说明目标目录被系统策略锁定；若出现 “ModuleNotFoundError: No module named ‘xxx’”，则需手动 pip install 对应模块。
