异常技能需通过三步强制卸载：一、在claw设置→技能管理后台→“已注册技能（含异常）”页勾选并输入force_unregister注销；二、退出程序后删除registry目录下skills.active.json和registration.log，重启重建索引；三、用wbctl命令行工具按哈希值强制清理。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在WorkBuddy中导入了异常技能包（如无法启用、显示乱码、触发崩溃或未出现在常规列表中），且该技能未正常注册至插件市场或人员技能库界面，则需进入技能管理后台执行强制卸载操作。以下是直接干预本地技能索引与运行时注册状态的步骤：
一、通过Claw设置中的技能管理后台强制卸载
该方式绕过UI层可见性判断，直接调用底层技能注销接口，适用于已加载进运行时但UI未渲染、或因manifest解析失败而卡在“灰色禁用态”的异常技能，操作后立即解除其对核心调度链路的干扰。
1、启动WorkBuddy客户端，确保已登录腾讯云账号。
2、点击右上角个人头像，进入「个人中心」，选择「Claw设置」。
3、在左侧导航栏中点击「技能」，再点击子菜单中的「技能管理后台」（该选项仅对v3.7.0+版本可见，若未显示请先升级客户端）。
4、页面顶部切换至「已注册技能（含异常）」标签页，系统将列出所有被内核识别但未通过校验的技能条目，状态栏标注为解析失败、签名无效或元数据缺失。
5、勾选目标异常技能左侧复选框，点击页面右上角「强制注销」按钮。
6、在弹出确认框中，输入FORCE_UNREGISTER以通过安全校验，点击确定完成卸载。
二、手动清除技能注册缓存并重建内核索引
该方式用于解决技能管理后台仍无法识别异常技能的情形，即技能文件虽存在于磁盘，但已被内核标记为“不可恢复损坏”，需清空运行时注册快照并触发全量重扫描，不删除原始文件，仅重置加载状态。
1、完全退出WorkBuddy：右键系统托盘图标，选择「退出」；Windows用户需在任务管理器中结束所有WorkBuddy.exe进程，macOS用户需在活动监视器中终止com.tencent.workbuddy进程。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
2、定位注册缓存路径：Windows系统前往%APPDATA%\CodeBuddy\workbuddy\registry\，macOS系统前往~/Library/Application Support/CodeBuddy/workbuddy/registry/。
3、在registry文件夹中，查找并永久删除以下两个文件：skills.active.json 与 registration.log。
4、重新启动WorkBuddy，客户端初始化阶段将自动重建注册表，并跳过此前标记为损坏的技能路径。
5、再次进入「技能管理后台」→「已注册技能（含异常）」页，确认原异常技能条目已消失。
三、使用命令行工具执行底层强制清理
该方式适用于技能引发主进程反复崩溃、无法正常进入图形界面的情形，通过独立CLI工具绕过GUI依赖，直接调用内核清理API，要求用户具备基础终端操作能力。
1、关闭WorkBuddy全部进程，包括后台服务。
2、打开终端（Windows使用PowerShell，macOS使用Terminal）。
3、执行以下命令定位CLI工具：Windows输入Get-ChildItem "$env:APPDATA\CodeBuddy\bin" -Filter "wbctl.exe"，macOS输入find ~/Library/Application\ Support/CodeBuddy/bin -name "wbctl"。
4、进入对应目录后，执行强制清理指令：Windows运行.\wbctl.exe skill unregister --force --by-hash "ab3f9d2e"，macOS运行./wbctl skill unregister --force --by-hash "ab3f9d2e"（其中ab3f9d2e为异常技能哈希值，可通过查看Skills文件夹内对应子文件夹名末尾8位获取）。
5、命令返回Unregister successful后，无需重启即可生效；若提示Hash not found，说明该技能尚未被内核加载，应转用方法二。
