EasyNote

工具办公软件案例ID：255150

阿蒙

10 年经验· 埃森哲

微信扫码沟通，客服可协助直接对接工程师；如当前档期不合，也可继续推荐相似案例作者。

案例介绍

EasyNote（局域网笔记）——纯局域网 P2P 同步笔记应用

一句话定位：Flutter 一套代码覆盖 iOS、Android、Windows、macOS，手机随手记、电脑自动同步，数据只走局域网，不经过任何第三方服务器。

功能明细
笔记：富文本编辑支持加粗、斜体、标题、列表、引用、代码块和本地插图；笔记可归入文件夹，文件夹支持置顶和拖拽排序；支持全文搜索和搜索历史，编辑器内可查找定位；回收站支持软删除、恢复和清空，并通过墓碑记录防止已删除笔记重新出现；单条笔记有「仅本机保存」开关。
发现与配对：自研 UDP 广播通告，参考 Syncthing 和 LocalSend；支持「可被发现」和「扫描设备」手动互联；采用请求-同意配对与 HMAC 挑战认证，防止冒充 deviceId；支持设备 ID 冲突检测与重置。
同步：WebSocket 点对点通信，固定端口 58888，流程为握手、全量对齐、增量推送；多设备全互联 mesh，任一端改动后 2 秒内到达所有对端；冲突按「版本号优先、最后写入时间兜底」的 LWW 合并；断线后由重新上线方凭地址缓存自动直连；图片附件分片传输，并进行 sha256 校验。
工程化：跨端协议版本强制互检；旧库自动迁移，纯文本正文转 Quill delta；54 项回归测试和 97 场景真实网络栈联调脚本。

技术栈：Flutter 3.44 / Dart 3.12、drift（SQLite）、Riverpod、go_router、web_socket_channel、flutter_quill；发现与同步协议自研，无 mDNS、无云依赖。

我的角色：独立开发，全流程独立完成，包括需求拆解、交互与视觉设计（自研玻璃拟态设计系统）、数据层与 LWW 合并模型、UDP 发现与 WebSocket 同步协议及版本演进、三端打包发版、联调测试与缺陷修复。lib/ 约 2.3 万行 Dart（含 drift 生成代码），代码与文档均由我维护。

可承接的同类需求：局域网、离线优先应用、P2P 点对点同步、设备发现与配对、WebSocket 实时通信、冲突合并（LWW）、Flutter 跨平台（移动和桌面）开发、SQLite 本地持久化、富文本编辑器集成、数据迁移与协议兼容设计。