应刷新SDK知识库：一、核对「关于」页版本哈希与官网发布页是否匹配；二、关闭程序后删除kb-cache目录下.json/.db/.bin文件并重启；三、通过「SDK知识库管理」手动导入.kbpack包；四、设置中切换Schema解析为Draft 07兼容模式。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试在WorkBuddy中调用新版本API，但系统提示“技能未识别”或“接口不可用”，则可能是由于本地SDK知识库未同步最新协议定义与端点元数据。以下是解决此问题的步骤：
一、验证当前SDK知识库版本与API更新范围是否匹配
WorkBuddy依赖本地缓存的SDK知识库（含OpenAPI Schema、MCP能力描述、模型适配规则）进行API签名校验与参数自动补全。若知识库版本滞后于服务端API变更（如新增/v2/analyze接口或字段类型升级），将拒绝加载对应技能。
1、启动WorkBuddy后点击右上角头像，进入「关于」页面。
2、向下滚动至「SDK知识库版本」条目，记录显示的哈希值（例如sdk-kb-20260318-7a2f4c）。
3、访问官方SDK知识库发布页：https://www.codebuddy.cn/sdk/knowledge-base/releases，核对最新版本号及变更日志中是否包含您所调用API的更新记录。
二、强制刷新本地SDK知识库缓存
本地知识库缓存文件（kb-index.json、schema_cache.db）可能因网络中断或校验失败而残留旧结构，导致新API定义无法载入。该操作仅替换元数据，不删除用户已配置的技能绑定关系。
1、关闭WorkBuddy主程序（包括系统托盘进程）。
2、打开本地SDK知识库路径：%APPDATA%\CodeBuddy\sdk\kb-cache（Windows）或 ~/Library/Application Support/CodeBuddy/sdk/kb-cache（macOS）。
3、删除该目录下所有以.json、.db、.bin结尾的文件，保留文件夹结构本身。
4、重新启动WorkBuddy，软件将在初始化阶段自动从官方CDN拉取最新知识库快照并完成本地索引重建。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
三、手动注入指定API版本的知识包
当目标API属于灰度发布或企业专属通道（如/internal/v3/report），官方知识库未同步时，可手动导入定制化知识包。该方式绕过自动发现机制，直接注册接口契约。
1、联系API提供方获取对应版本的SDK知识包文件（通常为.kbpack格式，含openapi.yaml与mcp-adapter.json）。
2、进入WorkBuddy设置页 → 「高级」→ 「SDK知识库管理」→ 点击「手动导入」按钮。
3、选择下载的.kbpack文件，确认导入后界面显示“已注册X个API端点，Y个MCP能力”。
4、在命令行窗口（开发者模式）输入/sdk list --detailed，验证目标API路径是否出现在已注册列表中。
四、切换SDK解析引擎至兼容模式
部分新API采用JSON Schema v2020-12规范定义，而默认SDK解析器仍基于v7标准，可能导致required字段误判或nullable类型忽略。启用兼容模式可降级解析逻辑，保障基础字段识别率。
1、进入「设置」→ 「高级」→ 「SDK解析配置」。
2、找到「Schema解析标准」选项，从下拉菜单中选择Draft 07 (Legacy)。
3、勾选「应用后重载知识库」，点击「保存并重启」。
4、重启完成后，在开发者模式中执行/sdk validate https://api.example.com/openapi.json，确认返回状态为“valid with compatibility mode”。
