模型列表为空需依次排查：一、刷新并切换镜像源至https://mirrors.codebuddy.cn/modelhub；二、删除本地models目录下index.db和catalog.json后重启；三、授权workbuddy对models路径的完全读取权限；四、将模型协议版本切为v1.1兼容模式；五、为缺失元数据的模型手动生成并放入同名.wbmeta文件。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在 WorkBuddy 中打开模型管理界面，发现模型列表为空、无任何模型显示，或仅显示“未检测到可用模型”，则可能是由于模型源连接异常、本地缓存损坏、权限缺失或协议版本不匹配所致。以下是解决此问题的步骤：
一、验证模型服务端连通性与镜像源状态
WorkBuddy 依赖腾讯 ModelHub 服务动态拉取模型元数据，若网络无法访问官方模型源（如因 DNS 污染、代理拦截或镜像站临时不可用），将导致模型库加载为空白。
1、打开 WorkBuddy 主界面 → 左下角「设置」→「模型管理」→ 点击右上角「刷新源」按钮。
2、观察底部状态栏是否出现“连接超时”或“HTTP 503”提示；若出现，说明当前镜像源不可达。
3、点击「源配置」→ 在「镜像地址」栏手动输入备用地址：https://mirrors.codebuddy.cn/modelhub。
4、勾选「强制校验签名」，点击「测试连接」，确认返回状态为“200 OK”且响应时间低于800ms。
二、清除本地模型索引缓存并重建元数据
客户端将模型描述信息缓存在本地 SQLite 数据库中，若 index.db 文件损坏或字段结构过期（如升级后未迁移），会导致模型列表无法解析渲染，呈现空白状态。
1、完全退出 WorkBuddy（包括系统托盘/菜单栏进程）。
2、按 Windows 键+R，输入 %APPDATA%\CodeBuddy\workbuddy\models（Windows）或前往 ~/Library/Application Support/CodeBuddy/workbuddy/models（macOS）。
3、定位并删除文件 index.db 和 catalog.json（保留所有 .bin、.gguf、.safetensors 模型文件本身）。
4、重新启动 WorkBuddy，等待约12秒，观察模型管理页是否自动触发全量扫描并填充列表。
三、检查模型文件系统权限与路径可读性
WorkBuddy 需要读取本地模型目录中的文件头信息以识别格式、参数量与支持协议，若操作系统拒绝访问该路径（如 macOS 完全磁盘访问未授权、Windows Defender 隔离了 models 文件夹），将跳过全部模型扫描，造成空白。
1、Windows 用户：进入「设置 → 隐私和安全性 → 文件系统」，搜索 WorkBuddy，确保其对 %APPDATA%\CodeBuddy\workbuddy\models 路径具有读取权限。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
2、macOS 用户：前往「系统设置 → 隐私与安全性 → 完全磁盘访问」，点击锁图标解锁后，拖入 WorkBuddy.app 并勾选。
3、在模型管理页点击「诊断权限」按钮，确认输出结果中 models/ 目录可遍历: ✅ 且 至少1个模型文件可读取头信息: ✅。
四、切换模型协议运行模式并重载解析器
当前模型库采用 MCP-v1.2 协议定义模型能力契约，但部分本地部署模型（尤其社区编译版）仍沿用 v1.1 的 capability 字段命名规范。协议解析器若严格校验字段，会直接过滤掉不兼容模型，导致列表为空。
1、进入「设置 → 高级 → 协议配置」，找到「模型能力协议版本」选项。
2、将下拉值由「v1.2（严格模式）」切换为「v1.1 兼容模式」。
3、勾选「重启后生效」，点击「应用并重启」。
4、重启完成后，在命令行窗口（启用开发者模式）执行 /model list --raw，确认返回 JSON 中包含非空的 model_id 数组。
五、手动注入缺失模型元数据文件
当某模型文件（如 glm-4-flash.Q4_K_M.gguf）已存在于 models 目录，但缺少对应 .wbmeta 描述文件时，WorkBuddy 不会将其纳入展示列表。该情况常见于直接解压模型包而未运行安装脚本的情形。
1、访问官方模型元数据生成工具页：https://www.codebuddy.cn/model-meta-gen。
2、上传目标模型文件（支持 .gguf/.safetensors/.bin），填写名称、参数量、支持协议（MCP-v1.1 或 v1.2）、推理后端（llama.cpp / transformers）等必填字段。
3、点击「生成 .wbmeta」，下载生成的 JSON 文件，重命名为与模型同名（如 glm-4-flash.Q4_K_M.wbmeta）。
4、将该 .wbmeta 文件放入 models 目录，与对应模型文件处于同一层级，无需重启即可在模型管理页即时显示。
