需完成插件注册、技能包加载与环境适配三类操作:一、确认WorkBuddy≥v2.8.0;二、将龙虾Skills文件夹复制至对应系统插件路径;三、在config.yaml中启用插件并配置权限;四、启动后验证加载状态与技能列表;五、通过/reload指令热重载更新。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜

如果您已安装WorkBuddy主程序并希望接入龙虾Skills插件以扩展其能力,则需完成插件注册、技能包加载与环境适配三类关键操作。以下是具体配置步骤:
一、确认WorkBuddy版本兼容性
龙虾Skills插件仅支持WorkBuddy v2.8.0及以上版本,低版本将无法识别插件签名或加载技能定义文件。需先验证当前运行版本是否满足最低要求。
1、启动WorkBuddy客户端,点击左上角“帮助”菜单。
2、选择“关于WorkBuddy”,在弹出窗口中查看版本号显示区域。
3、若版本号低于v2.8.0,请前往官方GitHub Releases页面下载最新安装包并覆盖升级。
二、部署龙虾Skills插件核心文件
该步骤将插件主体(含skills.yaml、handlers/目录及Python运行时依赖)置入WorkBuddy指定插件路径,确保主程序启动时可自动扫描加载。
1、解压下载的龙虾Skills压缩包,进入根目录,确认存在skills.yaml与handlers/子目录。
2、根据操作系统定位WorkBuddy插件目录:
Windows系统为%APPDATA%\WorkBuddy\plugins\;macOS系统为~/Library/Application Support/WorkBuddy/plugins/;Linux系统为~/.config/workbuddy/plugins/。
3、将解压后的整个龙虾Skills文件夹(不含外层压缩包名目录)复制到上述插件路径下,确保路径结构为plugins/longxia-skills/skills.yaml。
三、配置插件启用开关与权限策略
WorkBuddy默认禁用第三方插件,需手动修改配置文件开启加载,并为龙虾Skills授予必要系统调用权限,否则技能将处于未激活状态。
1、关闭WorkBuddy进程,防止配置被锁定。
2、打开WorkBuddy主配置文件config.yaml,位置与插件目录同级(通常在用户数据目录下)。
3、在plugins:节点下添加新条目: longxia-skills: enabled: true permissions: - shell_exec - file_read - network_call
4、保存文件,确保缩进为两个空格且无制表符,否则解析失败会导致WorkBuddy拒绝启动。
四、验证技能加载状态与触发词映射
插件启用后,WorkBuddy会在启动时解析skills.yaml中的技能定义,并建立自然语言触发词与handler函数的绑定关系,需通过日志与交互方式双重确认。
1、重新启动WorkBuddy,在启动界面底部状态栏观察是否出现“longxia-skills: loaded (12 skills)”字样。
2、打开调试控制台(Ctrl+Shift+I),切换至Console标签页,输入window.skills.list()并回车。
3、检查返回数组中是否包含"weather_query"、"file_summarize"等龙虾Skills预置技能ID,且每个对象的status字段为"active"。
五、执行技能热重载避免重启
当修改skills.yaml或handlers内Python脚本后,无需退出WorkBuddy即可使变更生效,通过内置热重载机制即时刷新技能逻辑。
1、保持WorkBuddy运行,在任意聊天输入框中键入指令:/reload longxia-skills。
2、观察控制台输出:若显示"Reloaded longxia-skills: 3 handlers updated",表示重载成功。
3、立即尝试调用刚修改的技能,例如发送“总结我上周的会议纪要”,验证行为是否符合最新代码逻辑。










