把 AI 装进笔记，在自己的设备上听写、朗读、识图与思考。
本地语音识别 · 离线 TTS · 图片 OCR · 本地大语言模型
本地 AI · 主要功能 · 获取与体验 · 数据与隐私 · 从源码运行 · MIT License
非空笔记是一款基于 Flutter 构建的本地优先 AI 多媒体笔记应用。无需账号，打开即可记录，笔记与附件默认保存在设备上。 说出的想法可以实时变成文字，录音可以离线转写，图片里的文字可以识别和搜索，笔记也可以直接朗读。 还可以运行本地大语言模型，辅助摘要、改写、整理与笔记问答，让记录和回顾都用上设备端 AI。
从声音、图片到文字理解，AI 能力直接融入笔记。 安装好所需模型后，以下本地推理无需连接云端 AI 服务，也无需配置在线模型 API Key。
| 能力 | 在笔记里怎么用 | 本地实现 |
|---|---|---|
| 语音识别 · 录音转文字 | 将笔记中的录音转成可复制、可搜索的文字，方便回顾会议和口述内容 | SenseVoice 离线识别，通过 sherpa-onnx 在设备端运行 |
| 实时听写 · 边说边记 | 说话时实时输入文字，快速捕捉想法；可选择中文或中英双语模型 | Streaming Zipformer 本地流式识别 |
| 语音合成 · TTS 朗读 | 把笔记正文读出来，用听的方式回顾内容，支持中英双语 | Kokoro TTS 本地合成，模型安装后可断网朗读 |
| 图片文字识别 · OCR | 从照片、截图中提取文字，复制识别结果，并通过笔记搜索找回图片里的内容 | 随应用打包的 ML Kit 中文识别器，图片在设备端处理，无需另下 OCR 模型 |
| 本地大语言模型 · 笔记助手 | 摘要、改写、整理与笔记问答；按所选模型能力支持图片或音频输入 | MNN / LiteRT-LM 本地推理，可选 Qwen、MiniCPM、Gemma 等模型 |
例如，把一段录音离线转写后交给本地助手整理要点，或提取截图中的文字，再用离线朗读回顾整理后的笔记。
在 设置 → 本地模型 中按需下载或导入语音和语言模型，再开始听写、转写、朗读或对话。 本地 AI 优先面向 Android ARM64 设备，模型体积、内存需求和输入能力以应用内详情为准。 OCR 的图片与识别结果在设备端处理，但 ML Kit SDK 会发送性能与使用指标，详见数据与隐私。
使用与实现细节见编辑器的 AI 与语音、图片 OCR和本地语言模型。
| 场景 | 能做什么 |
|---|---|
| 随手记录 | 富文本编辑、自动保存、撤销，以及图片、录音、视频和文件引用 |
| 找回内容 | 按标题、正文、标签与附件文字搜索，通过标签分组、日历和提醒回顾笔记 |
| 图片与语音 | 在设备端识别图片文字、转写录音、实时听写和朗读笔记 |
| 笔记助手 | 使用本地模型，或连接自己配置的在线模型，辅助摘要、改写、整理与笔记问答 |
| 整理与分享 | 独立文件库、附件预览、接收 Android 系统分享，以及生成笔记分享图 |
| 数据管理 | 应用锁、独立认证的隐私工作区、完整备份恢复，以及手动 S3 / WebDAV 同步 |
支持中文、英文和多套主题。完整功能范围见产品说明。
Android 测试版可从 GitHub Releases 下载安装，附带 SHA-256 校验文件；也可通过源码运行体验。Android 应用内更新通过 GitHub 获取清单、安装包和更新说明，发布流程见Android 发布指南。
0.1.0 升级至 0.2.0 请从 Release 下载同架构 APK 手动覆盖安装；已发布的这两个版本仍保留原分包版本号。后续新构建已统一版本规则，详见版本号规则与历史版本限制。
- 主要平台：Android 手机；0.2.0 新增 iOS 适配预览。 iOS 最低版本为 15.5，已接入功能适配及无签名构建/归档流程，并通过 ARM64 模拟器 OCR 与 MNN CPU 推理验证。提供实验性未签名 IPA，需用户自行签名、安装并定期续签；签名安装、分享扩展 / App Group 及真机功能尚未验收。见 iOS 自行签名安装教程与 iOS 适配与验收。macOS、Windows、Linux 和 Web 工程用于开发验证。
- 本地 AI：优先使用 Android ARM64 设备。 语言模型需要额外下载，存储和内存要求因模型而异；应用内提供模型体积和内存建议。
- 基础记录无需配置 AI。 可以先记录和整理笔记，再选择本地模型、在线模型或云同步。
- 同步由你控制。 S3 / WebDAV 需要自行配置并手动触发；双端修改冲突时，由你选择保留的数据版本。
本地优先是应用的数据组织方式。使用前，也请了解当前测试版的边界：
| 项目 | 当前行为 |
|---|---|
| 笔记与附件 | 默认存储在应用私有目录，无需注册账号 |
| 应用锁与隐私工作区 | 通过系统认证保护应用内访问；笔记数据库与附件未额外做应用级加密 |
| 备份与同步快照 | 完整归档未加密，可包含隐私笔记；生成或导出含隐私内容的备份、上传这类快照前需要认证 |
| 在线 AI 与联网工具 | 按配置和授权访问外部服务；发送的上下文会交由对应服务处理 |
| 密钥与同步凭据 | 在线模型 API Key 使用系统安全存储；当前云同步凭据仍保存在应用私有配置文件中 |
图片文字识别目前使用随应用打包的 Google ML Kit。图片与识别结果在设备端处理， 但 SDK 会发送性能与使用指标，详见 Google 官方说明。 当前尚未实现可靠的遥测关闭方案或完成 OCR 引擎替换。
模型下载、Android 应用通过 GitHub 检查和下载更新、用户启用的在线服务等也会产生网络请求。 更多细节见产品数据原则、隐私工作区和智能体说明。
- Flutter 3.47.2，与发布 CI 一致，使用其自带的 Dart SDK。
- Android SDK 36、JDK 17 和 Make。
- 一台开启 USB 调试的 Android 手机，或 Android 模拟器。
下载或克隆本仓库后，进入包含 pubspec.yaml 的项目根目录：
# 检查环境并安装锁定的依赖
flutter doctor
flutter pub get --enforce-lockfile
# 查看设备；将下一条命令中的示例 ID 替换为实际设备 ID
flutter devices
make run-android DEVICE=emulator-5554首次 Android 构建会下载并校验固定版本的 MNN 原生运行库，需要网络连接。 普通 Debug 构建无需配置项目的正式发布签名。 开发流程和常见命令见开发指南。
在项目根目录运行：
flutter pub get --enforce-lockfile
(cd packages/fknotes_harness && dart pub get --enforce-lockfile)
dart format --output=none --set-exit-if-changed lib test packages/fknotes_harness/lib packages/fknotes_harness/test
flutter analyze --no-pub
flutter test --no-pub
(cd packages/fknotes_harness && dart analyze && dart test)
git diff --check签名、APK / AAB 构建、版本标签和发布流程见 Android 发布指南。
| 想了解什么 | 从这里开始 |
|---|---|
| 产品定位与功能范围 | 产品说明 |
| 页面交互、主题与视觉规范 | 设计规范 |
| 开发环境与代码结构 | 开发指南 |
| 本地模型和笔记助手 | 本地语言模型 · 智能体说明 |
| 数据管理与恢复 | 隐私工作区 · 备份与手动云同步 |
| 其他功能专题 | 完整文档索引 |
欢迎通过本仓库的 Issues 反馈问题、提出建议，或提交 Pull Request。
- 报告问题： 请提供应用版本、设备型号、Android 版本、复现步骤和预期行为；涉及本地模型时，附上模型名称。
- 提交改动： 说明解决的问题与验证方式。较大的功能或架构调整，建议先通过 Issue 讨论范围。
- 保护个人数据： 截图和日志请先脱敏，不要公开真实笔记、完整备份、API Key、同步凭据或本机个人路径。
项目原创代码、文档和自建视觉素材采用 MIT License，
包括 packages/fknotes_harness。素材来源与许可范围见素材说明。
感谢以下项目及其他依赖为非空笔记提供支持：
- Flutter Quill： 富文本编辑基础；兼容补丁与上游来源，MIT 许可。
- Lucide / Feather： 操作图标；来源说明，ISC / MIT 许可。
- Adobe 思源宋体： 纸张主题字体；来源说明，SIL OFL 1.1 许可。
第三方代码、字体、原生运行库和模型继续遵循各自的许可证或服务条款， 不因本项目采用 MIT 而变更。