需彻底清除模型配置状态以解决WorkBuddy模型异常:删除%USERPROFILE%.workbuddy\models.json及备份文件,清空%APPDATA%\Tencent\WorkBuddy\Cache\models\缓存,批量解绑模型,最后以访客模式重启重建配置。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

当你在WorkBuddy中遇到模型列表错乱、自定义模型消失、切换后不生效或反复报“模型不可用”等异常,且常规重启、重载无效时,需要彻底清除所有模型配置状态,从零重建模型上下文环境。
确认重置范围与前提
重置操作将删除用户级模型配置(【models.json】)、AI模型管理界面中保存的凭证、绑定关系缓存及运行时模型元数据快照;但不会删除Claw技能配置、插件启用状态或工作区文件(如MEMORY.md、session.db)。
必须确保WorkBuddy已完全退出——任务栏托盘图标消失,后台进程workbuddy.exe或CodeBuddy.exe无残留。
删除用户级模型配置文件
第一步:关闭WorkBuddy后,按Win+R输入%USERPROFILE%\.workbuddy,回车打开该目录。
第二步:找到并永久删除models.json文件。若该文件不存在,跳过此步;若存在但为空或仅含{"models":[]},也请直接删掉——空配置文件会导致WorkBuddy加载失败或静默忽略后续写入。
第三步:检查同一目录下是否存在models.json.bak或models.json.backup等备份文件,一并删除。WorkBuddy某些版本会在保存失败时自动生成带后缀的副本,残留会干扰新配置初始化。
清除模型管理界面缓存数据
方法一:Windows系统下,删除模型运行时缓存目录
进入%APPDATA%\Tencent\WorkBuddy\Cache\models\,清空该文件夹全部内容。该路径存储模型能力探测结果、API连通性校验缓存、vendor签名验证记录——不清理会导致界面仍显示“已验证”但实际调用失败。
方法二:macOS系统下,执行终端命令rm -rf ~/Library/Caches/com.tencent.workbuddy/models/
【注意】此步骤不可跳过,否则即使重装models.json,WorkBuddy仍可能沿用旧缓存判定模型不可用。
重置模型绑定与技能关联状态
第一步:启动WorkBuddy,登录账号,等待主界面完全加载完成。
使用 draw.io(.drawio 格式)和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发: - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
第二步:点击右上角头像 →「Claw设置」→ 左侧导航栏选择「AI模型绑定」。
第三步:在绑定列表顶部点击「筛选」→ 勾选「当前绑定模型 ≠ 未绑定」→ 点击「应用筛选」。
第四步:勾选筛选出的所有条目 → 点击上方悬浮的「批量解绑」按钮 → 确认执行。
第五步:返回「AI模型管理」页面,逐个点击各模型右侧「重置配置」按钮(若无此按钮,则点击「配置」→ 清空API Key与Base URL字段 → 点击「测试连接」→ 显示失败后点「取消」,系统将自动标记为未验证状态)。
触发全新模型初始化流程
第一步:关闭WorkBuddy客户端。
第二步:重新启动WorkBuddy,不登录任何账号,直接进入欢迎页。
第三步:点击「开始使用」→ 在首屏弹窗中选择「跳过登录,以访客模式启动」。
第四步:此时WorkBuddy会强制重建默认模型配置栈,生成干净的models.json(含内置模型基础定义),并禁用所有用户绑定逻辑。
第五步:关闭访客窗口,重新用原腾讯账号登录,WorkBuddy将基于全新空白配置加载模型选单,此时可安全导入你整理好的标准models.json或通过UI逐步添加自定义模型。

















