nowen-note

自托管的私有知识库，对标群晖 Note Station。

A self-hosted private knowledge base. English README · 作者感言 · 在线体验

功能概览

• 富文本 + Markdown 双引擎：Tiptap 3 + CodeMirror 6，共享 AI、版本历史、评论等上层能力
• AI 助手：支持通义千问 / OpenAI / Gemini / DeepSeek / 豆包 / Ollama，覆盖写作辅助、生成标题、推荐标签、RAG 知识问答
• 知识管理：无限层级笔记本、彩色标签、任务、思维导图、说说、FTS5 全文搜索
• 协作 & 历史：分享支持 4 档权限（仅查看 / 可评论 / 可编辑 / 可编辑需登录）+ 访客留言 + 密码 / 有效期、版本回溯
• 文件管理：图片缩略图（webp 三档自适应，密集图床场景流量降至 1/100）、「我的上传」分类（已引用 / 未引用细分）、孤儿清理
• 自动化：沙箱插件系统、Webhook、审计日志、定时自动备份
• 多端：Web / Electron（Win/macOS/Linux）/ Android（Capacitor）
• 开发者生态：MCP Server、TypeScript SDK、CLI、浏览器剪藏扩展、OpenAPI 3.0（见 packages/）

技术栈

React 18 · TypeScript · Vite 5 · Tiptap 3 · Tailwind · Hono 4 · SQLite(FTS5) · JWT · Electron 33 · Capacitor 8

截图

桌面端

AI 写作助手	AI 服务商配置

移动端（Android / Capacitor）

侧边栏	笔记列表	编辑器

在线体验

不想本地部署？可以直接打开作者维护的官方体验站点：

• 地址：https://note.nowen.cn/
• 账号：demo
• 密码：demo123456

⚠ 体验账号为只读演示用途，数据可能被定期重置，请勿存放任何敏感或重要内容。生产使用请按下方「快速开始」自托管部署。

快速开始

默认管理员：admin / admin123，首次登录后请立即修改密码。

Docker（推荐）

git clone https://github.com/cropflre/nowen-note.git
cd nowen-note
docker-compose up -d

访问 http://<你的IP>:3001。

本地开发

需要 Node.js 20+。

git clone https://github.com/cropflre/nowen-note.git
cd nowen-note
npm run install:all
npm run dev:backend   # 后端 :3001
npm run dev:frontend  # 前端 :5173

访问 http://localhost:5173。

桌面端 / 移动端

npm run electron:dev      # Electron 开发
npm run electron:build    # 打包 Windows / macOS / Linux

Android 可直接从 Releases 下载 APK，或 npx cap sync android && npx cap open android 自行构建。

飞牛 fnOS（.fpk 一键安装）

从 Releases 下载最新 nowen-note-x.y.z.fpk，在飞牛 NAS 「应用中心 → 设置 → 手动安装应用」选中文件即可。安装后桌面出现「弄文笔记」图标，浏览器打开 http://<飞牛IP>:3001。

当前 .fpk 仅支持 x86_64 飞牛设备（platform=x86）。手动打包参见 scripts/fpk/README.md。

配置

数据持久化：容器需将 /app/data 映射到宿主机（不是 /data）。镜像已声明 VOLUME ["/app/data"]，主流 NAS 面板会自动预填该路径。

备份策略：自动备份默认写入 /app/data/backups，与数据在同一个卷。建议按 3-2-1 原则把 /app/backups 另挂到独立磁盘，并设置 BACKUP_DIR=/app/backups，详见 docker-compose.yml 内的注释。

文档

• 浏览器剪藏扩展（Chrome / Edge）：Chrome Web Store
• 部署指南（本地 / Docker / 桌面 / 移动 / 群晖 / 绿联 / 威联通 / 飞牛 / 极空间 / ARM64）：docs/deployment.md
• 附件对象存储（S3 / R2 / MinIO）：docs/object-storage.md
• 飞牛 .fpk 应用打包：scripts/fpk/README.md
• ARM64 详解：docs/deploy-arm64.md
• 邮件备份配置：docs/backup-email-smtp.md
• 编辑器模式切换：docs/editor-mode-switch.md
• 隐私策略：docs/PRIVACY.md
• OpenAPI：运行后访问 /api/openapi.json

📚 教程中心：docs/tutorials/ — 从快速上手到高级功能的完整教程

• 快速上手：5 分钟快速上手 · 界面概览 · 创建第一篇笔记
• 笔记管理：文档树/笔记本 · 标签和收藏 · 搜索
• 编辑器：富文本编辑器 · Markdown 编辑器 · 斜杠命令
• AI 功能：AI 配置 · AI 生成标题和标签 · AI 总结
• 思维导图：入门 · 从笔记生成 · 导出
• 部署：Docker · NAS · 备份与迁移

常见问题

macOS 首次打开报错 / 无法启动 / "ERR_DLOPEN_FAILED"

由于本应用未做 Apple 公证（notarization），系统会把 dmg 里下载来的 .app 打上 quarantine 隔离属性，导致内部的 better-sqlite3 原生模块加载失败、 后端启动卡住 30 秒后报"后端启动超时"。

终端执行一行命令解除隔离即可（路径换成你实际拖过去的位置）：

sudo xattr -dr com.apple.quarantine "/Applications/Nowen Note.app"
# 或
sudo xattr -dr com.apple.quarantine ~/Downloads/Nowen\ Note.app

执行后双击重新打开即可。Apple Silicon 用户若用了 x64 版本，需要 Rosetta 2 （系统会自动提示安装）。

问题反馈

QQ 群：1093473044

支持作者

如果这个项目对你有帮助，欢迎扫码请作者喝杯咖啡 ☕

开源协议

GPL-3.0 — 派生作品对外分发时须同样以 GPL-3.0 开源并保留原作者版权声明。

更新日志

最近 5 个版本的更新内容，完整历史见 CHANGELOG.md。

v1.1.19 - 2026-06-11

✨ 新增

• 前端: 思维导图标记和主题名称支持多语言 i18n (8f46744)
• add notebook-first collaboration with hidden workspace UX (e6875a1)
• mindmap: 侧边栏搜索框旁增加收藏筛选按钮 (df89085)
• mindmap: 新建文件夹按钮移到列表顶部 (ccc6425)
• mindmap: 文件夹右键菜单 - 重命名/删除 (37313a7)
• backend: 新增导图移动到文件夹的 PATCH /:id/move 路由 (770b062)
• mindmap: 支持拖拽导图到文件夹 (4213873)
• mindmap: 导图模板功能 - 新建导图时可选择预设模板 (09f7f17)
• mindmap: 文件夹树前端 UI (1adf85a)
• mindmap: 文件夹树后端 + 数据模型 (124562f)
• mindmap: 节点聚焦模式 (9c0ed1a)
• mindmap: 拖拽节点调整结构 (044cb67)
• mindmap: 收藏导图功能 (f1868bd)
• mindmap: 节点复制/剪切/粘贴 (a272d4f)
• mindmap: Ctrl+滚轮鼠标位置缩放 + 节点搜索 + 列表搜索 (7ffe9eb)
• mindmap: 支持 Ctrl+Click 多选节点 (0f0f462)
• mindmap: 思维导图模块 5 阶段增强 (e8f3c66)
• mindmap: 新增全屏编辑模式 (db3ae8b)
• mindmap: 新增添加同级节点 + 快捷键 + 选中节点置顶渲染 (5348b85)
• mindmap: 新增 mindmapTransform.ts 独立解析器 (8255b65)
• editor: MermaidView 工具栏增强 + MindMapEditor 事件监听 + 编辑器 appendMarkdown (03e7782)
• ai: AIChatPanel 支持笔记本级 RAG 作用域 (9a3a4a3)
• ai: EditorPane 新增 AI 总结、AI Mermaid、保存为思维导图 (8effbf2)
• ai: 前端 API 扩展 + i18n + NoteEditorHandle 类型增强 (54a7b26)
• ai: 后端 AI 路由改造 + 笔记本级 AI 端点 (f81d0b8)
• ai: 新增 AI Client 适配层，统一 stream/non-stream 调用 (c1e182d)

🐛 修复

• 前端: NoteList 补回 confirm 导入，修复 tsc -b 构建错误 (182c698)
• 前端: 修复6个TypeScript编译错误 — import缺失、path字段缺失、函数未导出 (76721f1)
• 前端: 补回缺失的 diagnoseConnection 导出函数，修复 vite build 失败 (bb765a6)
• Electron: setupWindow 和 waitForRemoteReady 支持反代路径前缀 (142c990)
• 前端+后端: 服务器地址支持反代路径、修复Windows频闪、新增连接诊断 (4442716)
• 前端: 浮动操作条按钮添加细微边框增强轮廓感 (7cb9e70)
• 前端: 思维导图标记菜单改用带颜色SVG图标，与节点显示一致 (1014ca0)
• 前端: 浮动操作条按钮增强可见性 — 加深背景色、加粗文字、加大点击区域 (98fbff7)
• backend: 修复 mindmaps 相关路由 TypeScript 编译错误 (174f668)
• mobile: 修复移动端回收站一键清空按钮无响应 (1f2fb74)
• mindmap: 文件夹数量跟随收藏/搜索筛选动态更新 (380d594)
• i18n: 修复文件夹右键菜单中文翻译乱码 (e38650f)
• i18n: 修复导图模板中文翻译乱码 (42b1d73)
• backend: requireWorkspaceFeature 中间件正确放行 personal 空间请求 (a0c4947)
• backend: 修复 personal workspaceId 传入时文件夹和导图 API 返回 403 的问题 (164b8d8)
• mindmap: Ctrl+滚轮缩放改为原生事件，阻止浏览器页面缩放 (fe67b0f)
• mindmap: 修复 FloatingToolbar 定位偏移 (9f4ccc3)
• mindmap: 修复数据风险 + UI 扁平化 + 代码拆分 (a789add)
• mindmap: 适应视图图标改为 Scan，与全屏 Maximize2 区分 (d988ec1)
• i18n: 补全思维导图多语言文案 (ffc33cd)
• ai: 标题生成字数限制从10改为20，避免AI输出被截断 (8dfcb05)
• mindmap: 保存为思维导图后可靠跳转 + 使用独立解析器 (caff2d6)
• ai: 修复 RAG 向量召回未传 notebookIds + /ask 复用 ai-client (9061916)
• build: 修复 vite 构建循环 chunk 错误 (9d81de3)

♻️ 重构

• 前端: 思维导图样式收尾 — indigo→blue统一、transition补齐、菜单背景token化、模板弹窗圆角与阴影优化 (e0db228)
• 前端: 思维导图悬浮状态与创建按钮样式统一收敛 (ef81bea)
• 前端: 思维导图菜单与激活态样式继续收敛 (dec1717)
• 前端: 思维导图模块 macOS 风格样式重构 (87a48b3)

📝 文档

• 添加完整官网教程体系（47篇教程 + 索引 + 规划） (210f537)

v1.1.18 - 2026-06-09

✨ 新增

• 更新Android组件和Tiptap编辑器功能 (c489050)
• 增强Tiptap编辑器功能并优化用户体验 (ce05f9e)
• 添加鸿蒙ArkWeb原生应用项目 (f63e84f)
• 添加鸿蒙ArkWeb WebView原生适配支持 (f6d4923)

🐛 修复

• 移动端Sidebar约束宽度防溢出，移除选择时自动关闭侧边栏的逻辑 (03bb588)
• 移除NavRail点击导航项后自动关闭移动端侧边栏的逻辑 (a429f1a)
• 移动端侧边栏遮罩区分点击/滑动，禁用手势关闭侧边栏，添加overflow-hidden防溢出 (948e447)
• 优化Android WebView选择菜单处理，使用委托模式替代直接返回null (fa20e06)

v1.1.17 - 2026-06-08

♻️ 重构

• 大规模代码精简和架构优化 (60f051b)

v1.1.16 - 2026-06-05

✨ 新增

• 全面增强搜索功能和用户体验 (524cf8c)
• 增强搜索体验和侧边栏布局管理 (14b61c2)
• 增强附件对象存储功能和搜索高亮显示 (7ce7d53)

🐛 修复

• 修复 TypeScript 编译错误 - Buffer 类型兼容性 (ff2f4b5)
• 全面优化版本恢复功能和编辑器状态管理 (85783d1)
• 优化侧边栏布局计算和滚动性能 (5e49465)

📌 杂项

• 实现对象存储支持和同步中心功能 (d576ec1)

v1.1.15 - 2026-06-04

📌 杂项

• 优化同步引擎和网络状态检测 (a2e6fbd)
• 修复macOS Electron侧边栏拖拽区域CSS (07545f2)