剧云离线版本地数据库加载异常是SQLite初始化失败或script.db损坏所致；需检查data/目录下script.db是否存在及大小，若缺失或为0KB须重装或删除后重启重建；通过开发者工具执行window.require('sqlite3')验证模块加载，返回undefined则失败；强制重建需重命名script.db为script.db.bak后重启，并观察状态栏提示及Console报错定位问题。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
剧云离线版本地数据库加载异常时，界面常显示“数据库离线”“无法连接本地存储”或诊断按钮灰显无响应，此时不是网络问题，而是SQLite引擎在本地初始化失败或数据文件损坏导致的硬性阻断。
确认SQLite数据库文件是否存在且可读
打开剧云离线版安装目录下的 data/ 子文件夹（Windows默认在 %APPDATA%\JuYun\offline\data\，macOS在 ~/Library/Application Support/JuYun/offline/data/）；
检查是否存在名为 script.db 的文件——若完全缺失，说明首次启动未完成初始化，需重装离线版并确保安装过程未被杀毒软件拦截；
若存在但大小为 0 KB 或小于 12 KB，该文件已损坏，【不可直接覆盖写入，必须先删除再重启剧云触发重建】。
验证SQLite运行环境是否被系统策略禁用
方法一：在剧云离线版主界面按 Ctrl+Shift+I（Win）或 Cmd+Option+I（Mac）打开开发者工具→切换到 Console 标签页→输入 window.require('sqlite3') 并回车；
若返回 undefined 或报错 Cannot find module 'sqlite3'，说明Node.js原生模块加载失败；
方法二：关闭剧云→在终端中执行 which sqlite3（macOS/Linux）或 where sqlite3（Windows）；若无输出，系统未安装SQLite CLI，但剧云离线版自带嵌入式引擎，此步仅作辅助判断——真正关键的是方法一的 require 检测结果。
强制重建本地数据库结构
第一步：完全退出剧云离线版（任务管理器中确认 ju-yun-offline.exe 或 JuYun Offline 进程已结束）；
第二步：进入 data/ 目录，将 script.db 重命名为 script.db.bak（不要删除，保留原始文件用于日志回溯）；
第三步：重新启动剧云离线版→等待约8–12秒，观察底部状态栏是否出现“正在初始化本地数据库…”提示；
第四步：若提示消失后仍显示“数据库离线”，立即打开开发者工具 Console 标签页，复制全部红色报错行（尤其是含 SQLITE_CANTOPEN 或 SQLITE_CORRUPT 的日志）→这些是定位底层文件权限或磁盘只读状态的关键证据。
