什么是 WorkBuddy 的技能中心？

什么是 WorkBuddy 的技能中心？

简单来说，WorkBuddy 的技能中心并非一个简单的插件列表或模型切换器。它更像是一个集成的任务指挥台，所有你安装好、准备就绪的 Skills 都从这里统一调度和执行。

技能中心 = 已启用 Skills 的实时操作台

它的核心功能远不止展示清单。这个操作台直接承载着三项关键动作：启用/禁用、运行、配置。举个例子，当你在对话中输入“整理桌面文件夹”，背后被唤醒的，正是技能中心里处于启用状态的 ColorFit 技能。而当你点击那个“运行”按钮，真正动起来的，是该技能目录下 dist/ 文件夹里打包好的 Python 脚本或 Node.js 模块。

这一切的背后，是三个确保稳定和安全的特性在支撑：

• 状态同步即时：开关一切换，active.json 配置文件立刻更新，完全无需重启客户端。
• 权限控制可见：每个技能卡片的右上角都有一个小锁图标。点开它，你能清楚看到这个技能申请了哪些本地路径的读写权限，比如它是否需要访问 D:\Projects。
• 运行上下文隔离：同一个技能多次运行，各自的日志、临时文件和参数缓存都互不干扰。这得益于沙箱机制为每个进程生成的独特后缀名（例如 colorfit-20260415-8a3f）。

为什么找不到刚安装的技能？检查这三处

一个常见的情况是：ZIP 包明明导入成功了，技能中心里却不见踪影。这多半不是安装失败，而是加载流程在某个环节被卡住了。问题通常出在以下三处：

1. manifest.json 文件问题：这个文件必须存在，且必须包含正确的 id、name、version 字段。尤其要注意，id 字段里不能包含空格或大写字母。
2. 技能目录路径错误：在 Windows 系统下，技能必须被解压到 C:\Users\{用户名}\WorkBuddy\Claw\skills\{skill-id}\ 这个精确的路径下。目录多了一层嵌套，或者放错了盘符，系统都会直接忽略。
3. 签名校验失败：这一点界面可能没有明确提示。如果是手动导入的 ZIP 包，且包内 dist/ 中的文件被修改过，系统会静默跳过注册。要确认这一点，需要打开终端，执行 workbuddy-cli list-skills --verbose 命令，然后查看输出中该技能的 status 字段是否显示为 disabled (signature mismatch)。

“我的技能”和“Marketplace”标签页的区别

这两个标签页代表的是完全不同的状态和来源：

• “我的技能”：这里列出的是已经落户在你本地 skills/ 目录下、完成解压和注册、并且状态为 enabled 的技能。它们是随时可以调用的“现役部队”。
• “Marketplace”：这里展示的则是远程的技能元数据快照，你可以把它理解为一个“技能商店”。点击“导入”按钮，才会真正将技能 ZIP 包下载并解压到你的本地目录。它本身不运行任何代码，也不校验与你当前环境的兼容性，本质上是一个带搜索功能的技能展示页。

这里有个容易忽略的细节：Marketplace 列表里那个 ✅ WorkBuddy v3.2+ 的标识，仅仅表示该技能在编译时与指定版本兼容，并不保证你当前选用的大模型（比如 DeepSeek-R1）一定能顺利调用技能里的 llm_call() 函数。要真正验证兼容性，你得点进技能详情页，查看 model_requirements 字段里是否明确列出了你正在使用的那个模型 ID。

来源：互联网