常见问题与排障

官网没有安装包

官网下载入口指向 GitHub 上的 v1.9.4 历史发行页。安装器未签名，SHA-256 仅用于核对完整性；请勿关闭安全软件或绕过安全检查，并同时下载发行页的两个必要材料包。

插件找不到桌面端

1. 01
   确认桌面端已运行

   Collector 依赖当前 Windows 用户会话中的 LuckyRay。

2. 02
   查看提示类型

   区分桌面端未运行、协议不兼容与业务保存失败。

3. 03
   更新同一发布线

   桌面端与插件协议不兼容时，应更新到相互匹配的版本。

素材或文档在磁盘中变化

• 链接素材缺失时重新定位真实文件，不要让 LuckyRay猜测路径
• Vault 文档出现外部变化时先刷新知识库
• 存在未保存编辑时先比较内容，再决定接受哪一份
• 恢复应用备份前确认外部文件仍在原位置

AI 或联网搜索不可用

• 测试当前模型连接并同步可用模型
• 确认 API Key 已由本机后端保存
• 确认当前提供商与协议支持所需能力
• 需要读取笔记时，先打开对应 Vault 并确认授权范围
• 联网能力取决于当前模型与工具配置，以会话提示为准

保存失败、空间不足或预览异常

1. 01
   先保护未保存内容

   保留错误提示和未保存文本，暂停重复导入。不要用「清除应用内容」或恢复旧备份来试错。

2. 02
   核对位置与空间

   打开「设置 → 存储」，核对「应用数据路径」「托管素材目录」与「存储总览」。在文件管理器确认磁盘有空间、目标目录可访问；外置盘离线时先接回。

3. 03
   按症状恢复

   原文件能打开但缩略图异常时，可清理「缩略图缓存」后重新预览。源文件缺失应先恢复原文件位置。修正空间或访问问题后，用一个小文件重试并检查结果。