官网没有安装包
官网下载入口指向 GitHub 上的 v1.9.4 历史发行页。安装器未签名，SHA-256 仅用于核对完整性；请勿关闭安全软件或绕过安全检查，并同时下载发行页的两个必要材料包。
插件找不到桌面端
- 01确认桌面端已运行
Collector 依赖当前 Windows 用户会话中的 LuckyRay。
- 02查看提示类型
区分桌面端未运行、协议不兼容与业务保存失败。
- 03更新同一发布线
桌面端与插件协议不兼容时，应更新到相互匹配的版本。
素材或文档在磁盘中变化
- 链接素材缺失时重新定位真实文件，不要让 LuckyRay猜测路径
- Vault 文档出现外部变化时先刷新知识库
- 存在未保存编辑时先比较内容，再决定接受哪一份
- 恢复应用备份前确认外部文件仍在原位置
AI 或联网搜索不可用
- 测试当前模型连接并同步可用模型
- 确认 API Key 已由本机后端保存
- 确认当前提供商与协议支持所需能力
- 需要读取笔记时，先打开对应 Vault 并确认授权范围
- 联网能力取决于当前模型与工具配置，以会话提示为准
保存失败、空间不足或预览异常
- 01先保护未保存内容
保留错误提示和未保存文本，暂停重复导入。不要用「清除应用内容」或恢复旧备份来试错。
- 02核对位置与空间
打开「设置 → 存储」，核对「应用数据路径」「托管素材目录」与「存储总览」。在文件管理器确认磁盘有空间、目标目录可访问；外置盘离线时先接回。
- 03按症状恢复
原文件能打开但缩略图异常时，可清理「缩略图缓存」后重新预览。源文件缺失应先恢复原文件位置。修正空间或访问问题后，用一个小文件重试并检查结果。