WorkBuddy装完新技能列表里不显示，如何快速确认装没装上？

WorkBuddy技能列表不显示，先别认定安装失败，技能文件可能已在磁盘上，只是卡在路径、元数据、索引、会话四道加载关口中的某一关。 WorkBuddy技能不显示的第一道关口：路径落错位置 系统识别技能有固定目录要求。 用户级目录通常落在工作空间的skills文件夹下，技能必须是完整子文件夹，内部带manifest.json或SKILL.md。 多一层嵌套、放错盘符，都会被直接忽略。 第二道关口：元数据缺字段或签名校验失败 manifest.json必须包含id、name、version等必需字段，id不能带空格或大写字母。 如果导入包里的文件被改过，签名校验可能失败，界面却不给明显提示，技能会被静默跳过注册。 第三道关口：索引未刷新 客户端依赖本地检索索引来呈现技能列表。 索引没有更新，即使技能已在目录里，列表也可能看不到它。 部分用户重启后技能突然出现，就是重启触发了重新扫描。 第四道关口：会话未重开或未启用 已打开的对话会话不会自动加载新装技能，需要新开一个会话才能看到它进入可用列表。 技能没有处于已启用状态，或者关闭了发布至本地搜索的开关，同样不会出现在可调用列表中。 从实际案例来看，大部分“装完不显示”停在第一道或第三道，而不是安装动作本身失败。 先确认技能文件夹在哪里、里面有什么，比反复重装更能定位问题。 把四道关口按顺序过一遍，WorkBuddy装没装上就会落到一个具体环节，而不是停留在“好像没装成功”的猜测里。

确认WorkBuddy装没装上，按“页签、开关、目录、日志”四步从界面到文件逐层核对，比反复重装更快。 WorkBuddy装没装上的第一步：看已安装页签 打开客户端，点击左侧边栏的「技能市场」图标，切换到「已安装」标签。 这里列出本地已识别且结构合规的技能。 看目标卡片徽章：绿色「已启用」代表已加载；灰色「已禁用」代表文件在但没参与调用；卡片不出现，说明卡在更早环节。 第二步：查Claw设置的启用开关 点击右上角头像旁的「Claw设置」，进入「技能管理」。 这里能看到每个技能的状态、来源和版本号。 目标技能显示为禁用，点击开关即可恢复，开关切换后active.json会即时更新，不需要重启客户端。 这里也找不到，进入第三步。 第三步：核对技能目录与元数据 打开文件管理器，进入用户级skills目录，每个子文件夹对应一个技能。 点进去确认是否存在manifest.json或SKILL.md。 缺元数据文件、文件夹名带非法字符，系统就不会把它识别为有效技能。 第四步：用命令行或任务日志反向确认 在终端执行技能列表命令，查看目标技能状态是否为enabled。 显示签名不匹配，说明文件被改过，需要重新导入原始包。 另一种方式：在对话里跑一个明确需要该技能的任务，结束后展开历史记录，检索技能日志行，看它是否被实际调用。 四步走完，WorkBuddy装没装上会得到一个明确答案：文件没到位、元数据不合格、索引没刷新，还是单纯没启用。 不同答案对应不同处理动作，不需要反复重装来试。

WorkBuddy技能不显示时，先分清是文件没到位、索引没刷新，还是跨端没同步，再决定修索引、重装还是迁移文件。 WorkBuddy技能不显示时先修索引还是先重装 界面能查到技能但列表不显示，优先重建索引，成本最低。 技能文件夹在、元数据也齐全，列表和搜索都看不到，大概率是本地索引卡住了。 关闭主程序，删除index类缓存文件后重启，软件会自动重建索引并重新扫描已存技能包。 目录里没有完整文件夹：直接重装或复制 目标技能目录里根本没有对应子文件夹，或者文件夹里缺manifest.json、缺scripts、缺SKILL.md，重建索引不会凭空把文件变出来。 回到技能市场重新导入原始包，或者手动把完整文件夹复制到正确路径，比在索引上排查更快。 多台电脑找不到：先确认技能是否同步 自定义Skill默认不随账号自动同步，一台电脑装好，换另一台电脑后默认不会出现。 技能启用或关闭状态可以随账号配置同步，但技能文件本身是否需要手动迁移，取决于安装方式。 把“没同步”误判成“没装上”，是跨端排查里最容易绕远路的一种情况。 可复用的判断顺序 先问技能文件夹在不在，不在就重装或复制； 在，就问元数据齐不齐，不齐就补文件； 齐，就问界面启没启用，没启用就开开关； 都正常还不显示，再重建索引。 顺序对了，多数问题在第二步就能收敛。 按这个顺序判断，WorkBuddy装没装上就不再靠猜，修索引、重装、查同步各归其位。