插件列表为空等问题需依次确认插件目录存在且路径正确、授予Windows插件目录读写权限、修复macOS完整磁盘访问授权、重置插件缓存并强制扫描、排除第三方安全软件拦截。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在安装 WorkBuddy 后发现插件列表为空、已安装插件未显示、点击启用无响应或控制台报错“Failed to load plugin from …”，则可能是插件目录权限受限、路径未被识别或 NTFS 安全策略拦截所致。以下是解决此问题的步骤：
一、确认插件目录存在且路径正确
WorkBuddy 默认从固定位置加载插件，若该路径不存在、被重命名或指向错误位置，将导致插件完全不可见。必须确保插件根目录结构完整且位于客户端可扫描范围内。
1、打开文件资源管理器，输入以下路径并回车：C:\Users\%USERNAME%\AppData\Roaming\WorkBuddy\plugins（Windows）或 ~/Library/Application Support/WorkBuddy/plugins（macOS）。
2、检查该目录是否存在；若不存在，请手动创建名为 plugins 的空文件夹。
3、确认插件子目录命名符合规范：每个插件应为独立子文件夹，名称不含空格或特殊字符（如 my_custom_tool），且内部包含有效的 manifest.json 文件。
二、授予插件目录完整读写权限（Windows）
NTFS 权限未开放将导致 WorkBuddy 进程无法枚举子目录、读取 manifest 或加载动态库，即使以管理员身份运行也无法绕过该限制。
1、右键点击 C:\Users\%USERNAME%\AppData\Roaming\WorkBuddy\plugins 文件夹，选择「属性」。
2、切换至「安全」选项卡，点击「编辑」按钮。
3、在用户列表中选中当前登录账户（如 YOURPC\YourName），勾选下方权限项中的「修改」和「写入」。
4、点击「应用」→「确定」保存更改，随后重启 WorkBuddy 客户端。
三、修复 macOS 插件目录的完整磁盘访问授权
macOS 12+ 系统默认禁止应用访问除白名单外的任意路径，插件目录若位于非标准位置（如桌面、文档或自定义路径），需显式授予「完整磁盘访问」权限才能完成扫描与加载。
1、打开「系统设置」→「隐私与安全性」→「完整磁盘访问」。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
2、点击右下角锁图标，输入管理员密码解锁。
3、点击「+」号，按 Cmd+Shift+G 调出「前往文件夹」窗口，输入插件目录绝对路径（如 /Users/YourName/Library/Application Support/WorkBuddy/plugins）并回车选中。
4、确保 WorkBuddy.app 左侧复选框已被勾选；若已存在但未勾选，请手动启用，并重启 WorkBuddy。
四、重置插件缓存并强制重新扫描
WorkBuddy 会缓存插件元数据以提升启动速度，但缓存损坏或版本不匹配会导致插件状态异常，需清除缓存并触发全量路径扫描。
1、关闭 WorkBuddy 客户端，确保任务管理器/活动监视器中无残留进程。
2、定位并删除缓存目录：C:\Users\%USERNAME%\AppData\Roaming\WorkBuddy\cache\plugin_cache.db（Windows）或 ~/Library/Caches/WorkBuddy/plugin_cache.db（macOS）。
3、重新启动 WorkBuddy，等待约 5–8 秒，观察右下角是否出现「正在扫描插件…」提示。
4、若仍无响应，可在 Claw Settings → Advanced 中点击「Force Rescan Plugins」手动触发。
五、验证插件目录是否被第三方安全软件拦截
部分终端防护软件（如 Windows Defender 实时保护、火绒、卡巴斯基）会将插件目录误判为潜在风险路径，主动阻止文件读取行为，导致 manifest 解析失败或 DLL 加载中断。
1、临时禁用实时防护功能（Windows：设置 → 隐私与安全性 → Windows 安全中心 → 病毒和威胁防护 → 管理设置 → 关闭实时检测；macOS：访达 → 右键杀软图标 → 停止防护）。
2、重启 WorkBuddy 并检查插件是否正常加载。
3、若恢复正常，将插件目录完整路径添加至对应杀软的「排除项」或「信任目录」列表中，再重新启用防护。
