问题排查

最常见的问题，每个都附有简短回答和详细说明的章节。

格式化、F7 或 F5 提示缺少工具。对很多语言来说，格式化工具、检查器和解释器都是外部程序。LightNote 会打开一个助手，列出该类型的工具，标出已安装的，并一键安装所选的工具。如果程序装在 LightNote 找不到的位置，请在 设置 → 代码工具 → 外部程序 中指定。参见 运行代码（F5）。

AI 没有回答，或提示模型已停用。消息会说明发生了什么以及该怎么做：余额不足不会因重试而解决；提供商要求等待时，消息会给出秒数。如果模型已停用，消息本身会提供 更换模型…，在 设置 → AI 助手 中还可以开启自动切换，它从不选择更贵的模型。参见 连接一个模型。

忘记了安全口令。它无法找回：它就是加密的密钥。如果这台电脑仍保存着它，数据在这里依然可以打开，并且可以在 帮助 → 配置安全口令… 中换成新的口令，全部重新加密。没有它，已加密的内容（连接密码、.lne 笔记、密码单元格）无法打开。普通笔记不依赖它。参见 安全: 安全口令・PIN・安全 Markdown。

树中不显示 Git 的颜色。只有在 工具 → 工作区 → 工作区配置... 中为此文件夹开启版本控制、并且找到 Git 程序时，颜色才会出现。如果 Git 装在 LightNote 找不到的位置，请在 设置 → 代码工具 → 外部程序 中指定。被其他程序修改的文件会在一两秒内显示颜色。参见 对打开的文件夹做版本控制。

搜索找不到 PDF 里的内容。扫描的 PDF 是每一页的照片，没有文本，搜索 标签页会显示有多少个。安装 Tesseract 后，PDF 的 ⋯ 菜单会提供 识别文字（OCR）…，每个文档运行一次。第一次打开包含大量文档的文件夹时，提取文本也需要几分钟。参见 在文件与文档中搜索。

按含义搜索不出现或什么都找不到。它依赖在 设置 → 常规 → 功能 中开启的语义增强（嵌入），以及提供嵌入的 AI 提供商。在每个文件夹第一次使用时会请求建立索引；失败时界面会说明原因，例如密钥过期或提供商不可用。参见 活动与按含义搜索。

图表显示为代码块。LightNote 无法读取图表时，会在代码块下方说明原因和所在行。如果没有任何提示，说明这里还不绘制该类型。类型列表见 工作方式，代码块的编辑栏（Ctrl+Enter）可以请 AI 重写它。

公式在 Word 中变成了文本。导出会转换 LightNote 能绘制的公式；其余的以文本输出，导出结束时会列出每一处及其原因。参见 折叠、固定与导出。