# MNotes

**Repository Path**: fyypll/mnotes

## Basic Information

- **Project Name**: MNotes
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-27
- **Last Updated**: 2026-10-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MNotes

MNotes 的 Flutter 重构版本。它不是对 Vue/Tauri 界面的逐像素翻译，而是以 **快速记录 → 本地保存 → 全局找回** 为主路径重新设计的 Windows-first 桌面应用。

## 当前功能

- 本地 SQLite 数据库（首次启动自动创建）
- 随手记与待办空间，支持新建自定义空间
- 快速记录：输入后点击“保存”或按 `Ctrl/⌘ + Enter`
- 连续编辑、全部空间搜索、置顶；列表支持最近修改／最近创建／标题排序，待办可直接完成并按完成状态筛选
- 快速切换：工作区／速记菜单或 `Ctrl+P` 按标题查找，支持最近访问、键盘选择与跨空间打开
- 正文内查找：编辑工具中的查找或 `Ctrl+F`，支持匹配计数、上一处／下一处与 `Esc` 收起
- 软删除
- 回收站：最多 200 条批量选择、恢复、二次确认后的永久删除，已删除记录保留 30 天
- 宽屏导航栏与窄屏 Drawer 响应式布局
- 双主界面布局：三栏工作台与桌边便签栏；桌边栏默认宽 344 逻辑像素，可停靠左右侧，点击便签在栏内编辑，返回列表保留草稿，一键展开工作台
- Markdown 阅读视图：支持标题、列表、代码块、引用和安全的 data URL 内嵌图片预览
- 从文件或 Windows 剪贴板插入图片：自动缩放并转换为受限的 WebP data URL
- 便签列表右侧预览正文第一张图片，新建和编辑时实时更新，无图记录不预留空白
- 记录移动（保留原始便签/待办类型）
- 自定义空间重命名与拖拽排序
- 删除自定义空间：可迁移记录，或将记录移到回收站后删除
- 结构化备份：导出 `.mnotes-backup`，导入前查看不含正文的变更预览，确认后自动快照并原子恢复
- 外观：跟随系统、浅色、深色；标准磨砂与暖纸风格；5 种强调色预设与支持实时预览的自定义配色
- Windows 在线更新：设置中的“版本与更新”支持启动时检查、手动检查、更新说明、下载进度/取消及安装包校验；安装由用户主动启动。默认使用本仓库 Gitee 发行版，发布流程见 [在线更新说明](docs/online-updates.md)。
- 提醒：完整编辑可设置时间，到期后由 Windows 通知提示，可在记录中消除
- Windows 托盘：关闭主窗口时隐藏到托盘，可从托盘显示或退出
- 退出保护：主编辑和速记提供保存／放弃／继续编辑；浮游窗口需先保存关闭，保存失败保留草稿
- 窗口选项：主界面布局、桌边停靠位置、置顶、不透明度、展开窗口恢复、独立的紧凑速记模式及速记保存后隐藏
- 全局快捷键：可配置组合键以显示窗口并聚焦速记；`F1` 查看快捷键，`Ctrl+K` 搜索，`Ctrl+N` 新建便签，`Ctrl+Shift+N` 新建待办
- 浮游便签：从记录菜单打开独立窗口，支持编辑、提醒操作、置顶与跨窗口同步
- 删除撤销：移到回收站后 8 秒内可直接恢复
- Markdown 导出：可导出单条记录或全部记录
- 本地自动快照：写入后 45 秒创建 `.mnotes-backup` 快照，启动时补偿缺失或过期快照，保留最近 30 份；备份窗口可查看健康状态、手动创建、打开或复制快照目录

产品规划见 [迁移计划](MIGRATION_PLAN.md)，本轮 19 个模块的三方案比较、推荐选择和实施验收见 [全功能检查与优化](docs/product-review-2026-10-02.md)。后续首图预览设计和 Windows 原生补验见 [便签列表首图预览与原生补验](docs/note-list-thumbnails-2026-10-02.md)。

最新一轮功能评估、方案选择和全界面验收见 [产品评估与功能完善](docs/product-evolution-2026-10-02.md)。

桌边紧凑主界面的三方案比较、操作规则和验收记录见 [桌边便签栏设计](docs/edge-panel-design.md)。在工作区选项或「设置 → 主界面布局」中切换；桌边栏是普通覆盖式窗口，不预留系统工作区，也不强制置顶。

## 本地开发

需要 Flutter stable、Visual Studio 的“使用 C++ 的桌面开发”工作负载。将 Flutter SDK 的 `bin` 目录加入 PATH，在项目根目录运行：

```powershell
flutter pub get
flutter analyze
flutter test --no-pub
flutter run -d windows
```

如 Windows 分析服务在含中文的项目路径下报告 LSP 编码异常，可使用临时的 ASCII 路径映射运行，完成后移除自己创建的映射。

## Windows 构建

```powershell
flutter build windows --release
```

完整程序位于 `build/windows/x64/runner/Release/`，运行其中的 `mnotes.exe`，不要只复制单个 exe。安装包通过下列脚本生成（需要 Inno Setup 6）：

```powershell
./tools/build_windows_release.ps1 -ReleaseNotesFile ./docs/releases/1.0.0.md
```

安装包输出到 `build/releases/`。脚本只构建本地产物，不会自动发布在线更新。

## 验证基线

2026-10-02：静态分析通过；408 项测试通过，1 项原有性能基准默认跳过。覆盖数据仓库、恢复与并发保护、图片／Markdown、列表首图、查找与快速切换、草稿退出、更新、交互及 Windows 平台主题渲染；检查 249 张渲染截图。原生验收结果和待人工补验项见 [产品评估与功能完善](docs/product-evolution-2026-10-02.md)。

上述为上一轮已完成基线。本轮桌边便签栏全量测试 448 项通过、1 项既有跳过，静态分析无问题；视觉检查和 Windows 原生验收记录见 [桌边便签栏设计](docs/edge-panel-design.md#验收记录)。