# 作者感言：从拯救十几年生活印记，到打造全平台私有知识库 > `nowen-note`（弄文笔记）的诞生与破局 · [English version](./AUTHOR_STORY.en.md) 作为一个玩了七八年 NAS 的老玩家，我一直觉得，折腾硬件的终点，终究是找到完美承载自己数字资产的软件。 回顾这个项目的诞生，它并非源于什么宏大的商业计划，而是纯粹出自一个开发者在面对生活习惯断代、硬件频繁更迭时的"自救"与"强迫症"。 --- ## 一、起源：一次换机引发的"数字考古" 去年，我做了一个决定：告别了从高中时代就陪伴我的小米手机，换入了一加。 设备迁移看似简单，但当我看到小米笔记里躺着的、横跨了十几年、记录了从青涩高中到步入职场的数千条笔记时，我犯了难。怎么把这些数据完美、优雅地导出来？没有现成的官方工具，第三方方案也差强人意。 作为一名开发工程师，"与其将就，不如重构"的职业病驱使我撸起袖子直接开干。我开始分析抓包，通过获取 Cookie 调用接口，硬生生地把小米笔记的数据全量拉了下来。 但这只是第一步。接踵而至的是无尽的格式兼容噩梦：文字怎么排版、图片附件如何优雅地异步回填、混乱的导入时间戳如何与历史真实时间完美匹配……在一边吐槽一边打补丁的过程中，一个支持历史时间回填、能看能改的文本编辑器初具雏形。 --- ## 二、催化：折腾 NAS 时的"生态荒漠" 时间到了双十一，我趁着大促升级了我的家庭 HomeLab，将服役多年的群晖 NAS 换成了国产新型 NAS。 硬件的性能飙升让我兴奋，但当我想迁移笔记系统时，却迎来了巨大的心理落差。过去在群晖上，我重度依赖 **群晖 Note Station**。虽然它的 UI 有些简陋，但它支持网页剪藏、多端同步和任务清单，完美契合了我的日常刚需。而在新的系统里，官方的笔记生态几乎是一片荒漠。 我开始在开源社区寻找替代品： - **思源笔记**：功能确实强大，但在 NAS 部署后感觉有些繁琐，学习成本太高，功能太杂，不符合我追求直观、轻量的要求。 - **Memos**：作为碎片化记录很棒，但用来做长文知识管理和深度编辑又显得过于单薄。 期间我甚至妥协过，在 NAS 的虚拟机里套娃装了黑群晖，只为了内联穿透过去继续用 Note Station。但这终究不是长久之计。 "算了，既然手里有之前导小米笔记时写的编辑器雏形，为什么不自己开发一个完全对标群晖 Note Station、同时技术栈更现代化的自托管笔记系统呢？" --- ## 三、进化：将个人的"怪癖"写进代码 有了这个想法后，`nowen-note`（弄文笔记）的雏形正式诞生了。 我把我在不同时期积累的工具习惯，全都一股脑缝合且重构到了这个系统里： 1. **有道云笔记的执念**：因为高中时也用过很久的有道云笔记，我顺手开发了有道云笔记的备份导入模块，将当年的记忆也悉数收纳。 2. **迷你思维导图**：我日常对思维导图有很强的依赖，于是直接在编辑器里集成了轻量化的脑图组件。 3. **"说说"功能**：我习惯经常自言自语地写一些碎碎念，这个习惯从读书时代延续至今。所以我没有做纯粹的文档管理，而是专门做了一个类似朋友圈/Memos 的"说说"流，用来安放那些不连贯的灵感。 最重要的是，作为一个骨子里有着强烈分享欲的 NAS 玩家，我知道我们这类人群最需要的是什么：**绝对的隐私安全、现代化的视觉交互、以及无缝的三端协作。** 于是，我基于 `React 18` + `Hono` + `SQLite` 搭建了坚实的后端，并利用 `Electron` 和 `Capacitor` 实现了 Web、桌面端（Win/macOS/Linux）和移动端（Android）的全平台覆盖。 --- ## 四、蜕变：从"取悦自己"到"服务大家" 起初，我觉得能用就行。但当我把项目开源后，社区的反馈和用户的涌入给了我巨大的震撼。 以前作为独狼开发者，我想得非常简单，很多功能都基于自己的习惯，完全没有从用户的角度去思考人机交互。当不同背景的用户带着各式各样的 NAS 环境、使用习惯和边界 Case 找到我时，我才意识到，真正的开源需要从"服务自己"转变为"服务大众"。 这两个月，是项目迭代最频繁、最疯狂的时期。在社区群友们的"鞭策"与建议下，我们合力完成了许多硬核的优化： - **富文本与 Markdown 双引擎**：引入了 Tiptap 3 和 CodeMirror 6，让喜欢精美排版和喜欢纯文本键盘流的用户都能找到归宿。 - **深度拥抱 AI 时代**：支持了 DeepSeek、Gemini、OpenAI 以及本地化的 Ollama，实现了 AI 写作辅助和 RAG 知识库问答。 - **细节拉满的体验优化**：就在最近的更新里，我们搞定了弱网防丢字机制、利用 Sharp 实现的图片密集场景全链路缩略图服务（单页流量暴砍 100 倍）、支持未登录访客评论的 4 档隐私分享流，以及针对主流私有云生态的飞牛 fnOS（.fpk 一键安装）支持。 老实说，我有一份本职工作。但在如今 AI 工具大放异彩的时代，开发效率得到了成倍的提升。在工作之余，我把几乎所有的闲暇时间都奉献给了这个项目的快速迭代。看着社区群里越来越热闹，看着 Issue 一个个被闭环，那种作为开发者的成就感，是无可比拟的。 --- ## 五、未来：一个延续百年的开源承诺 经常有新来的朋友问我：这个项目以后会收费吗？数据放你这里安全吗？ 我的回答从来没有变过：**`nowen-note` 采用 GPL-3.0 协议完全开源，它不属于任何商业公司，它只属于你和社区。** 它提倡的是**完全纯粹的本地化部署（Self-Hosted）**。你的所有日记、灵感、生活琐碎和知识财富，全都存放在你自己的 NAS 或服务器的 SQLite 数据库中，没有任何云端厂商能够偷窥或锁死你的资产。 我的目标是把这个项目**维护一百年**。只要我们的设备还在通电，只要我们还有记录生活的欲望，`nowen-note` 就会一直迭代下去。 如果你也是一个喜欢折腾 NAS、重度依赖笔记，同时对数字隐私有极高要求的朋友，欢迎来体验、拍砖、提 PR，或者加入我们的反馈群（QQ 群：`1093473044`）。让我们一起，把这个小小的私有知识库，打造成最懂折腾玩家的数字避风港。 - **GitHub 仓库**：[cropflre/nowen-note](https://github.com/cropflre/nowen-note)