☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
nova ai加载失败时界面卡在“正在初始化”或报错退出，根本原因是本地缓存污染、工作区元数据错乱或权限校验中断；需依次关闭进程、彻底删除~/.nova-ai/cache（macos/linux）或%localappdata%\novaai\cache（windows）全部内容、重启应用，若仍失败则删除项目根目录下.nova-meta文件夹或执行nova-cli reset-meta --force重置元数据，并核验oh-package.json5签名配置、agc账号权限及build-profile.json5模块名大小写一致性。
nova ai加载项目失败时，界面卡在“正在初始化”或直接报错退出，项目列表空白、历史工程无法打开——这通常不是模型本身出问题，而是本地缓存污染、工作区元数据错乱或权限校验中断导致的前端加载阻塞。
清理Nova AI本地缓存
第一步：关闭Nova AI桌面端，确保进程完全退出（Windows任务管理器/ macOS活动监视器中确认无devenv或nova-ai相关进程）。
第二步：打开文件管理器，进入用户主目录下的隐藏目录：【~/.nova-ai/cache】（macOS/Linux）或 【%LOCALAPPDATA%\NovaAI\Cache】（Windows）。注意：此路径不可跳过，其他位置的缓存不会被清空。
第三步：选中cache文件夹内全部内容（包括子文件夹），按Delete键彻底删除。不要仅清空“temp”或“download”子目录——Nova AI的符号索引与项目快照混合存储在此处，残留任意一个损坏的.idx文件都会导致后续加载失败。
第四步：重新启动Nova AI，此时会重建缓存结构。首次启动稍慢，但项目列表应正常渲染。
重置项目工作区元数据
若清理缓存后仍无法加载特定项目，说明该项目的本地元数据已损坏。Nova AI 3.2+版本将项目配置、依赖图谱、调试断点等信息统一存于项目根目录下的【.nova-meta】文件夹中。
方法一：手动重置
进入出问题的项目根目录 → 找到并删除【.nova-meta】文件夹 → 在Nova AI中重新打开该项目目录（不是双击.nova文件，而是用“打开文件夹”方式导入）。
方法二：命令行强制重建
终端切换至项目目录 → 执行：nova-cli reset-meta --force → 等待提示“Meta reset completed”后重启IDE。该命令会保留源码和配置文件，仅重生成语义索引层。
注意：执行前请确认项目已提交Git或有本地备份，【.nova-meta】删除后所有断点、自定义代码片段、局部变量监视项将丢失】。
检查项目签名与权限状态
Nova AI对HarmonyOS/OpenHarmony工程启用强签名验证，若module.json5中声明的签名证书指纹与当前登录账号不匹配，加载时会静默终止并返回空项目视图。
① 打开项目根目录下的【oh-package.json5】，查找"signingConfig"字段，确认其"certPath"指向的.p12证书文件真实存在且可读。
② 进入Nova AI设置 → 账户 → 查看当前登录账号是否与AGC控制台注册账号一致；若使用华为云企业账号，请确认该账号已被授予对应应用包名的开发者权限。
③ 若项目含HSP/HAR模块，在【build-profile.json5】中检查"modules"数组内每个模块的"name"是否与实际目录名完全一致（区分大小写），任意一处拼写错误都会触发元数据解析失败。
