Flow Read

Flow Read 是一款面向英语阅读和词汇积累的 Flutter 应用，把书架、EPUB 阅读、查词、AI 辅助和本地备份放在同一个安静的工作流里。

当前公开发布目标以 macOS 桌面端为主；Windows 桌面端支持本地运行、构建和 zip 打包，仍作为实验性平台验证。移动端和其他桌面平台需要单独验证后再作为正式发行目标。

应用截图

核心体验

• 继续阅读：从书架直接回到上次章节，阅读进度、预计剩余时间和阅读目标一目了然。
• EPUB 书库：导入英文电子书，按最近阅读、进度和书籍信息快速管理。
• 阅读难度提示：为书籍展示阅读等级，帮助判断是否适合当前词汇水平。
• 阅读中查词：点击单词即可查看释义，宽屏下可固定在侧栏，减少阅读中断。
• AI 辅助阅读：按需开启单词详解、句子分析、章节总结和练习题生成。
• 本地备份：导出和恢复本地阅读、词汇、设置和学习数据。

本地运行

项目使用 Flutter。仓库通过 .fvmrc 固定 SDK 版本，推荐使用 FVM。以下命令在 macOS 和 Windows PowerShell 中相同，启动脚本会自动选择当前系统对应的桌面设备：

fvm flutter pub get
fvm dart run tool/run_app.dart

如果不使用 FVM，请确认本地 flutter --version 与 .fvmrc 中的版本一致，然后运行：

flutter pub get
dart run tool/run_app.dart

macOS 仍可使用 make run 作为快捷方式；Windows 不需要安装 make。可通过 --device-id 覆盖自动选择的设备，例如 dart run tool/run_app.dart --device-id windows。

Windows 桌面开发还需要 Visual Studio 的“使用 C++ 的桌面开发”工作负载、Windows SDK，以及 flutter_tts 构建所需的 NuGet CLI。使用 flutter doctor -v 确认 Visual Studio - develop Windows apps 检查通过，并确保 nuget.exe 在 PATH 中；工具也会自动识别 %LOCALAPPDATA%\NuGet\nuget.exe。

常用检查

fvm dart analyze
fvm flutter test
git diff --check

发布与安装

本地打包命令会按宿主系统自动构建 macOS 或 Windows x64，并在 dist/ 生成 zip：

dart run tool/release.dart package-local

Windows zip 解压后运行 FlowRead/FlowRead.exe，必须保留同目录的 DLL 和 data/。首次 Windows 构建会由 sqlite3 的 Dart build hook 从其官方 Release 下载并校验 SQLite DLL，之后会随应用一起打包。当前 GitHub Release 产物仍以 macOS zip 为主；除非具体 Release 说明另有标注，请默认它未经过 Apple 公证，安装时可能需要在 macOS 安全设置中手动允许运行。

发布流程见 Release Runbook。版本号不会随普通功能开发自动更新。

隐私与安全

Flow Read 是本地优先应用，不需要账号。AI、在线词典和更新检查会在用户启用对应功能时访问外部服务。详情见：

• Privacy
• Security
• Third-party notices

贡献

贡献前请阅读 CONTRIBUTING.md。当前项目已关闭 Pull Request，请通过 GitHub Issues 提交问题、建议或需求。