要让WorkBuddy调用自定义专家,需先执行注册命令并严格匹配路径,确保expert.md、config.json、icon.png三文件齐全且YAML title非空,重启后在【我的专家】中验证显示与启用状态,再通过中文名触发。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你想让WorkBuddy调用自己写的专家,而不是只用内置的151个预设专家,就得把本地创建好的专家“注册”进系统,并确保它能被正确识别和触发。
确认专家已正确初始化
进入Craft模式,运行命令:python3 ~/.workbuddy/resources/builtin-skills/expert-manager/scripts/init_expert.py 你的专家英文名 --type agent --path ~/.workbuddy/plugins/marketplaces/my-experts/plugins。这一步必须执行成功,否则后续所有操作都无效。
【路径必须严格匹配】:脚本中的--path参数不能写错,WorkBuddy只认这个固定路径下的专家插件,写成~/my-experts或/Users/xxx/workbuddy-experts都会失败。
检查专家文件结构是否合规
打开你刚初始化的专家目录,确认里面包含且仅包含以下三个文件:expert.md(定义角色与能力)、config.json(声明元信息)、icon.png(图标,可选但推荐)。缺任何一个,WorkBuddy启动时会跳过该专家。
其中expert.md开头必须有标准YAML front matter,且title字段不能为空字符串——如果只写了title: "",专家会静默加载失败,界面里完全看不到它。
重启WorkBuddy并验证加载状态
关闭WorkBuddy进程,重新启动客户端。
第一步:点击顶部工具栏【专家】→【我的专家】,查看列表中是否出现你的专家名称;
使用 draw.io(.drawio 格式)和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发: - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
第二步:若名称可见但无法点击,说明config.json里的enabled字段值不是true;
第三步:若名称不可见,回到终端执行ls -la ~/.workbuddy/plugins/marketplaces/my-experts/plugins/你的专家英文名,确认目录存在且权限为755。
在对话中触发自定义专家
方法一:直接说“请用【你的专家中文名】分析这份财报”,只要中文名与expert.md中title一致,系统就会自动路由;
方法二:在输入框右上角点击专家标识图标→从下拉菜单手动选择你的专家;
方法三:在Ask/Plan/Craft任意模式下,先上传PDF或Excel文件,再输入“按【你的专家中文名】规则处理”,文件内容会被自动注入上下文。
注意:首次调用时会消耗积分,因为实际推理由远程模型完成;但专家本身创建、修改、本地加载全程不扣分。

















