LightNote Android 版帮助

手机应用是电脑上 LightNote 的伙伴：它打开同一个笔记文件夹，读写同样的文件，并用同一个内核保存——理解 Markdown、任务看板、表格和卡片的代码在两边完全相同。你在手机上写的内容在电脑上无需转换即可打开，反之亦然。

安装与更新（预览版）

应用尚未上架 Google Play：它是免费预览版，以 APK 形式在 GitHub 发布，地址为 github.com/nglczr/LightNote-Android。需要 Android 9 或更高版本的 64 位 ARM 手机。

安装。用手机浏览器下载 .apk 并点按它。Android 会要求允许通过浏览器或文件管理器安装应用，Play 保护机制可能会提示开发者未知。
核对来源。LightNote 的每个 APK 都用同一把密钥签名；证书的 SHA-256 指纹写在仓库的 README 和每个发布中。
更新。把新 APK 覆盖安装在旧版本上：笔记会保留。不要为更新而卸载——卸载会删除未通过 Git 同步、也未用导出 Vault (.zip)导出的工作区。在 Obtainium 应用中填入仓库地址，即可收到新版本提醒。

LightNote 上架 Google Play 后，将成为一次性买断的付费应用（价格未定）。预览版不包含商店版的使用权，上架后 GitHub 上的 APK 可能不再更新。

开始：手机上的 Vault

应用保存多个工作区：每个都是设备上的独立文件夹，可以有也可以没有 Git 仓库。点按主屏幕顶部的工作区名称，即可切换工作区或导入另一个：

从 Git 账户中选择——用访问令牌添加账户（GitHub、GitLab、Gitea/Forgejo 或其他服务器），应用会列出它的仓库；点按一个即可将其克隆为新的工作区。这是推荐的方式：之后更改会自动双向同步（参见同步）。
扫描电脑上的二维码——在电脑上的 LightNote 中，Git 菜单里的在手机上打开…会显示一个包含该文件夹仓库地址和提交作者的二维码。如果电脑上包含了访问凭据，应用会要求输入在那里设置的密码，在服务器上验证令牌并保存账户；密码输错时，重新输入即可。扫描二维码需要 Google Play 服务；在没有该服务的设备上，应用会提示，此时请使用按地址克隆。
按地址克隆——粘贴仓库的 HTTPS 地址。在访问权限中，公开仓库无需任何内容；私有仓库请粘贴访问令牌（创建令牌会打开服务器页面）。只有既不是 GitHub 也不是 GitLab 的服务器才会要求填写用户。
导入 Vault (.zip)——在电脑上压缩文件夹，把文件发送到手机，然后在文件夹菜单中选择导入 Vault (.zip)。这是一份副本：之后两个文件夹不再关联。同一菜单中的导出 Vault (.zip)则反过来：把整个空间打包成 .zip，用于保存或带到电脑上。

主屏幕直达每天要做的事：今天直接以编辑状态打开当天的笔记，快速记录向其中添加一行，下方紧接着是最近的笔记和同步状态。文件夹中的文件排在后面。有未完成的任务时，待办部分会列出笔记中的复选框和看板中的任务，并注明看板名称；查看全部显示完整列表。同步、空间、Git 账户、卡片和看板等界面都有帮助按钮（问号），可打开本页对应的章节。

笔记：阅读与编辑

点按笔记会以阅读方式打开：带格式的笔记，包括标题、列表、表格、引用、提示框、LaTeX 公式、Mermaid 图和化学结构式，都由与电脑相同的引擎绘制。笔记之间的链接（[[笔记]] 和 [[笔记#章节]]）在应用内打开笔记；网页链接交给浏览器。

顶部的编辑按钮切换到笔记的 Markdown 文本，标记以颜色显示。键盘上方的工具栏提供撤销和重做、标题、粗体、斜体、列表、任务复选框、[[ ]] 链接和代码。保存是自动的：停止输入片刻后就会保存，返回、旋转设备和离开应用时也会保存。

每个文件夹右下角的 + 按钮会在该处新建笔记，并打开编辑器，键盘已位于正文中。顶部是笔记名称，根据你写下的第一行自动建议（在此之前是日期和时间）；点按它即可改用别的名称。只有在有正文时才会创建文件，留空的笔记不会留在文件夹中。同一个输入框也可以重命名已有的笔记。

从模板新建笔记（在 ⋮ 菜单中）使用 Vault 中 Templates（或 Modelos）文件夹里的模板——与电脑上的相同，并填好 {{title}} 和 {{date}} 字段。

长按文件或文件夹可重命名、移动或删除；新建文件夹在文件夹菜单中。重命名任务看板或表格时，其附件文件夹会一起移动。返回按钮回到上一个屏幕——从搜索打开的笔记会回到搜索。

列表和任务。在编辑器中，任务复选框绘制为方框，点按即可切换；已完成的任务带删除线，Markdown 标记（#、**、[[ ]]）在光标所在行之外会隐藏——文字以格式化效果显示——光标进入该行时再以淡色出现。粗体按钮（以及斜体和代码按钮）像格式化编辑器一样可开可关。Enter 会延续列表——项目符号、任务（以未完成开始）和编号（递增）——在空项目上按 Enter 则退出列表。工具栏提供编号列表、降级和升级，可将项目移到成为子列表的正确列。文件仍是您写下的 Markdown。

记录：今天的笔记、分享与小组件

今天打开每日笔记，与电脑使用的是同一篇。
快速记录在不打开笔记的情况下，向今天的笔记追加一行带时间的内容。
从其他应用分享并选择 LightNote：链接或一句短文会成为今天笔记中的一行（例如 Gemini 会把对话作为链接分享）。多行文字——AI 的回答、文章的摘录——会成为一篇新笔记，正文保持原样，今天的笔记中则加入指向它的链接。照片和 PDF，无论一个还是一次多个，都会放进今天笔记的附件文件夹，并在笔记中加入链接。之后，接收内容的笔记会在屏幕上打开。
主屏幕小组件有两个快捷方式：打开今天的笔记和快速记录。

语音笔记。主屏幕上的语音笔记按钮（或图标快捷方式）通过麦克风录音——熄屏时也会继续；通知会显示时长并提供停止。录音保存到工作区的录音文件夹（录音，与电脑上 LightNote 的相同），并作为一行添加到今天的笔记中；点按即可打开播放器。文件为 .m4a，这是电脑录制并能转写的格式：转写和摘要在同步后于电脑上完成。

搜索与相互链接的笔记

搜索查找 Vault 中所有笔记的正文，列出每处匹配及其所在笔记和行号；点按结果即可打开该笔记。每篇笔记底部的 链接到此的笔记列出所有链接到它的笔记。

任务、表格与 Bases

任务看板（.lnt）按状态分列打开。你可以把任务移到另一列、勾选其清单项目、重命名和新建任务。手机不显示的字段会原样保留在文件中。点按一个任务会打开它的字段：标题、截止日期、优先级和所在列，也可以在这里归档或删除它。
自定义表格（.lnd）以电脑上的列打开；可以编辑文本、数字、复选框和选择类型的单元格，并添加行。密码列显示为 ****：点按单元格会要求输入安全口令，然后显示会显示密码，复制会把它放进剪贴板，剪贴板会在 30 秒后清空。
Bases（.lnq）以只读方式显示查询结果。
任务或行的文件文件夹显示在记录中，附件可从那里打开。

由 LightNote 更新版本保存的看板或表格不会被打开：应用会说明原因，而不是冒险损坏文件。请更新应用。

复习卡片

复习卡片列出今天到期的卡片，来自带有 #flashcards（或 #cartoes）标签的笔记——语法与电脑相同。答案会一直隐藏，直到你点按显示答案；四个评分（重来、困难、良好、容易）各自显示下一次的间隔。每次作答后都会保存日程，并与电脑同步。

提醒

今天到期或已经逾期的任务会在打开应用时发出通知，之后几天到期的任务会排在到期当天上午 9 点提醒。在 Android 13 及以上版本，只有在有事需要提醒时才会请求通知权限。

其他文件

代码以与电脑编辑器相同的颜色显示。顶部的铅笔可切换为纯文本编辑（没有笔记的格式），适用于 1 MB 以内的文件；文件保留原有的编码和换行符。
块笔记本（.lnb）在一个页面中打开，单元格按笔记本的顺序排列，每个单元格下方显示在电脑上最后一次运行的结果——手机上不运行任何内容。点按单元格名称即可打开其文件进行编辑。
数据库连接（.lnc）、HTTP 测试（.lnh）和 SSH 连接（.lns）属于电脑上的 LightNote，由它运行：在手机上以只读方式打开，并附有一句说明。
图片可双指缩放，PDF 逐页显示。
CSV 和 TSV 以表格打开（文件较大时只显示前面的行），分隔符自动识别。
其他任何类型都交给打开方式，列出设备上能打开它的应用。

安全 Markdown

加密笔记（.lne）需要输入工作区的安全口令。口令只在应用打开期间保存在内存中，明文永远不会写入磁盘：笔记由与电脑相同的代码解密并重新加密。

与电脑同步 (Git)

同步使用 Git 仓库（GitHub、GitLab、Gitea…），与电脑上的 LightNote 在该文件夹中使用的仓库相同。每个克隆的工作区都通过其服务器的 Git 账户与自己的仓库同步。

Git 账户。在 Git 账户中选择提供商和服务器，并粘贴一个对您想在手机上使用的仓库具有读写权限的访问令牌（在 GitHub 上是个人访问令牌；在网站上创建令牌按钮会打开正确的页面）。应用会先验证令牌，再将其加密保存在设备上。其他服务器（其他服务器）还需要填写用户，并且不列出仓库：通过地址克隆。

克隆之后，同步会自动进行：打开应用时、离开会保存内容的界面（笔记、看板、任务、表格、卡片）时，以及应用转入后台时。笔记打开期间，收到的内容中会改动这篇笔记的部分要等它关闭后才合并——否则编辑器会用自己的文本覆盖它。主屏幕显示上次同步的时间、待发送的内容以及是否失败；同步（接收并发送）可立即执行同样的操作。网络故障不会提示，下次会再试。

提交作者。手机上的提交带有姓名和电子邮件：工作区通过二维码而来时用电脑上的，否则用 Git 账户的（在 GitHub 上是个人资料的 noreply 邮箱，可把提交关联到该资料）。在同步 (Git)中，点按作者旁的编辑即可修改两者。

冲突。当同一篇笔记在手机和电脑上都有改动时，不同位置的改动会被合并。如果改的是同一处，也不会丢失任何内容：手机上的版本会成为旁边的一份副本（笔记 (手机).md），应用会告诉你创建了哪些副本。任务看板、表格和卡片按记录逐条合并。

手机不支持 Git LFS 和子模块：使用 LFS 时，文件会以很小的文本指针形式到达（不要在手机上编辑它们）；子模块显示为空文件夹。仓库使用其中任何一种时，界面会给出提示。

冲突副本会列在同步 (Git)中，点按即可打开，直到被查看为止。在工作区列表中选择从手机中移除，会从此手机删除其文件夹：已同步的内容仍保留在仓库中。移除当前工作区时，应用会先切换到其他工作区；唯一的工作区无法移除。如果还有内容未上传，应用会说明将丢失多少项更改，并提供同步并移除。

只在电脑上的功能

手机用于阅读、书写和记录。以下功能只在电脑上：AI 助手和 MCP、SQL 客户端与数据分析、终端、导出为 Word、PDF 等格式、从其他应用导入、版本历史，以及在含日程模式下编辑看板。Office 文档和 EPUB 通过打开方式打开。