workbuddy离线功能失效的根本原因是本地模型加载、隐私模式清理、离线额度分配、任务缓存同步四者未对齐；缺一即导致卡顿或静默失败，如模型未启用llama.cpp则ai技能哑火，未清缓存会触发重连阻塞，额度未固化则任务拒绝启动，未完成初始同步则本地数据库为空。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy 离线功能失效，根本原因不是“没网就用不了”，而是本地缓存、模型加载、额度分配、隐私策略这四块没对齐——缺一不可，任意一项漏配都会导致看似离线但实际卡在某个环节（比如能打开界面却无法执行OCR，或任务可编辑但保存后消失）。
确认本地模型已真正加载并启用llama.cpp
很多人点过【添加本地模型】就以为完事了，但llama.cpp引擎未启用时，AI相关技能（如指令解析、表单语义补全）会静默退化为哑模式，不报错也不响应。
- 必须勾选【启用本地推理引擎(llama.cpp)】，仅设置上下文长度或线程数无效
-
qwen2.5-0.5b-q4_k_m.gguf这类小模型适合CPU推理，但若线程数设为0或超过物理核心数，llama.cpp会初始化失败且状态栏无提示 - 验证方式：在聊天窗口输入“你好”，观察右下角是否出现实时token流；若仅显示“思考中…”持续超5秒，说明模型未就绪
检查隐私模式是否清除了联网残留组件
隐私模式不只是开关，它会主动卸载遥测模块和云端技能同步代理。如果跳过【强制清空现有缓存】步骤，session.db里残留的远程会话句柄会让部分任务在离线时尝试重连，直接阻塞执行队列。
- 关键路径：
%APPDATA%\WorkBuddy\Cache\session.db和history.json必须被真实删除，不是“清空内容”而是删文件 - macOS用户注意：
~/Library/Application Support/WorkBuddy/Cache/同样要手动清理 - 重启后标题栏没出现“隐私模式:ON”标识，说明该模式未生效，所有离线配置都白设
验证离线额度是否已固化且覆盖目标任务类型
离线状态下没有动态扣费机制，所有任务调度依赖联网时预分配的“离线计算额度单元”。如果没初始化或配额总和为0，连最基础的文件整理技能都会拒绝启动，且不弹错误提示。
- 必须在联网时进入【设置】→【离线与同步】→【离线额度管理】点击“初始化离线额度”
- “文件整理”“本地脚本运行”“离线OCR识别”这三类需显式填入整数配额，不能留空或填0
- 修改系数后（如把
文件批量重命名系数从1.0改为2.3），必须重新提交任务才能按新规则计费
确认本地任务缓存已完成初始同步
“启用本地任务缓存”开关只是允许缓存，不代表数据已落盘。断网前没点【立即同步当前任务】，任务列表看起来正常，实则本地SQLite里是空的——此时切换离线模式，看到的是上一次成功同步的旧快照，甚至可能为空。
- 同步完成后必须看到明确提示：“同步成功,共缓存12项任务”（数字要具体，不是“完成”或“成功”两个字）
- 任务详情页点击“…”→【查看本地校验信息】，若显示“最后同步时间”为空或早于本次操作时间，说明同步未真实发生
- Windows用户注意：同步过程会被杀毒软件拦截
workbuddy.exe访问%APPDATA%，需临时放行
最容易被忽略的是“同步完成”和“同步成功”的区别——前者只代表流程走完，后者才表示数据已写入本地数据库并生成校验摘要。很多问题其实卡在最后一步落盘失败，但界面没有任何异常提示。
