工具部署|NoteGen 0.39.2 开源本地笔记整理|先记录再整理,本机 Ollama 就能出可编辑 Markdown

课设或平时写笔记,最烦一上来就要写成完整文章。NoteGen 是一款本地优先的桌面笔记工具:先把一句话、一段备忘留下来,再用本机模型整理成还能继续改的 Markdown。

本篇主线只用本地小模型,不填任何云端 API Key。本帖免费,下载区是钉死版本的源码包和中文部署说明。协议是 GNU GPL-3.0,这是一种强 copyleft 许可:再分发或二次开发时,必须保留 LICENSE,并开源、提供相应源码。不要理解成可以按 MIT 去闭源使用。包里 vendor 目录中的剪贴板插件是 MIT,请一并保留。仅供学习。如果把整理结果拿去写课设或公开发布,内容要自己核对,不要直接当原创。

这篇和站内已有的几篇不一样:不是 AnythingLLM、Open Notebook、RuoYi-AI 那种「把文档丢进去再提问」,不是 Presenton 出 PPT,也不是 MoneyPrinterTurbo 出短视频。本篇做的是:在本机用小模型,把几条自己写的碎片记录,整理成一篇可编辑的 Markdown 笔记。

先说清楚范围:中文对话和「整理」可以在本机完成,不需要云端 Key。但安装桌面包、下载模型时仍然需要正常下载。不要用官网演示、默认免费云模型或赞助商模型,当成已经跑通的证据。

先看几个词

工作区:你选定的本机目录,笔记以普通 Markdown 文件放在这里。本机用的是空的测试目录 testdir,不要选家目录或已有私人笔记。

Ollama:在本机运行开源小模型的工具。本篇对话和整理只用 qwen2.5:3b。体积不大,能在 CPU 上跑,文笔一般,但够做验收。

记录和整理:记录是随时留下的碎片;整理是选中若干条,让模型写成一篇还能继续改的 Markdown 笔记。

回环地址 127.0.0.1:只有这台电脑自己能访问。本篇 Ollama 只听这个地址,不要改成 0.0.0.0。

4 步上手

  1. 准备本机模型和安装包:安装 Ollama,让它只监听 127.0.0.1:11434,执行 ollama pull qwen2.5:3b。本篇主线不必再拉嵌入模型。Linux 用钉死的 NoteGen_0.39.2_amd64.deb(sha256 8f96f062e439d4a17e59d0523006163837990ce1177654bb544441fcbe161062),不要从「最新下载」拿别的版本。Debian 13 上,安装包声明的 libgtk-3-0 / libappindicator3-1 已经更名,本机先补装 libwebkit2gtk-4.1-0 和 libayatana-appindicator3-1,再 dpkg -i 装上。不要用 note-gen --version 探版本,它仍会拉起图形界面。
  2. 设好工作区,忽略更新:把工作区指到一个空的本机测试目录。自动更新请忽略,不要把 0.39.2 升到 latest。
  3. 先改到本机 Ollama,再开始对话:首次启动会写入默认免费云模型,对话前必须改掉。打开「设置 → 模型服务」,平台选或添加 Ollama。API 地址填 http://127.0.0.1:11434/v1(只填到 /v1),Key 填占位 ollama,网络代理选直连,再添加对话模型 qwen2.5:3b。检测连接通过后,到窗口底部的模型选择器里勾选它。不要留在默认免费云模型或赞助商模型上。
  4. 中文对话,再整理自写记录:在对话里发一句中文,必须看到可辨认的回复。再到「记录」里写 2~3 条自己的碎片,每条放一个独有记号,选中后用「整理」生成一篇可编辑的 Markdown。正文里要能看到这些记号或对应要点。3B 小模型质量一般,生成后要自己再改。

技术栈(压缩)

  • 桌面端:Tauri(用系统 WebView 包起来的桌面应用)+ Next.js 界面
  • 模型:本机 Ollama + qwen2.5:3b
  • 本篇主线:钉死的 Linux deb 桌面包,不是 pnpm dev 开发服务器

本机实跑(按实际操作看)

详细步骤见包里的 DEPLOY.txt。下面这些图都是本机实拍,用的是已经装好的 0.39.2 桌面包,模型是本机 Ollama 的 qwen2.5:3b。

NoteGen 主界面,工作区 testdir,底部模型 qwen2.5:3b
看这里:这是装好后的主界面。底部工作区是本机测试目录 testdir,右下角模型是 qwen2.5:3b。左侧是这个测试目录里的验收材料,不是官网示例。界面已经是简体中文。右侧对话栏当时已经准备提问,完整回复见后面的对话图。
模型服务页两联:Ollama 地址 127.0.0.1:11434/v1,Key 占位 ollama,模型 qwen2.5:3b 已就绪
看这里:这是「设置 → 模型服务」的两联。上图是连接设置:平台 Ollama 已就绪,API 地址是 http://127.0.0.1:11434/v1,Key 只有占位 ollama,网络代理是直连。下图是模型列表:qwen2.5:3b,类型是对话,已可检测连接。左侧列表里能看到赞助商平台名称,但没有填写云端 Key;那些不是本篇主线。
底部模型选择器已勾选 Ollama qwen2.5:3b,列表里有 NoteGen AI 免费但未选
看这里:点击窗口底部的模型名称,会弹出选择器。这里已经勾选 Ollama 的 qwen2.5:3b。列表里有「NoteGen AI 免费」,但没有选它。对话前不要留在默认免费云模型上。
中文问句与可辨认回复,用时约 15 秒
看这里:问句是「请用一句话说明如何把零散记录整理成课设笔记。」模型回复「将零散记录按主题分类整理并撰写成课设笔记。」用时约 15 秒。这是可辨认的中文,但只是一句很短的复述。3B 质量一般,不要期待商用助手那样的展开。
记录列表 3 条,记号 YGLD-NG-2211-A7Q3、LAMP-7042-SY、银杏灯核笺都可见
看这里:「记录」列表里有 3 条自写碎片,记号 YGLD-NG-2211-A7Q3、LAMP-7042-SY、银杏灯核笺都看得见。中间打开的是第一条,时间是 2026-11-22 15:09(Asia/Shanghai)。这些只是验收用的虚构标记,不是密码,也不要写进自己的配置。
整理后的可编辑 Markdown「今日验收课题记录.md」,三个记号都在正文
看这里:整理后的笔记「今日验收课题记录.md」正在编辑器里,可以继续改。正文三条要点里,YGLD-NG-2211-A7Q3、LAMP-7042-SY、银杏灯核笺都在。文末参考文献只列了两条。3B 小模型会漏点或只做简单罗列,生成后要自己再改。
关于页 v0.39.2,工作区 testdir,简体中文
看这里:关于页显示 v0.39.2,底部工作区仍是 testdir,界面是简体中文。这张图避开了捐赠二维码。当时页面写着「当前已是最新版本」,仍请忽略更新提示,不要去跟 latest。

本机实际遇到的坑

  • Debian 13 上,deb 声明的 libgtk-3-0 / libappindicator3-1 已经更名,需要先补 libwebkit2gtk-4.1-0 和 libayatana-appindicator3-1 再安装。
  • 不要用 note-gen --version 查看版本,它会再拉起图形界面。
  • 第一次启动会写入默认免费云模型。必须先改成 Ollama:地址只填到 /v1,Key 用占位 ollama,代理选直连,再在底部选择器里勾选 qwen2.5:3b。
  • 模型服务页可能列出赞助商平台。那不是本篇主线,也不要去申请那些 Key。
  • 不要用官网演示、默认免费云模型或赞助商模型的回复当能跑证据。
  • 忽略自动更新,不要把 0.39.2 升走。
  • pnpm dev 默认绑 0.0.0.0:3456,不要暴露到局域网。本篇主线是装好的桌面包,不是开发服务器。
  • Ollama 继续只听 127.0.0.1,不要改成 0.0.0.0。
  • 3B 小模型质量一般。对话可能只是短复述,整理结果也可能漏点或罗列,以「独有记号出现在可编辑 Markdown 里」为准,不要写成商用写作助手。

没有在本篇验收的功能

知识库 RAG、LLM Wiki、Agent、MCP、画布或思维导图、录音转写、官方或自托管同步、插件市场,都不是本篇必过项。不要把它们写成这份开源包已经跑通的能力。

包里是 0.39.2 源码和中文 DEPLOY.txt。已原样保留根目录的 GPL-3.0 LICENSE,以及 vendor 剪贴板插件的 MIT 说明;去掉了默认免费云模型配置里的硬编码访问密钥,也去掉了 README 中的捐赠入口、赞助商表格和官方宣传图。

© 版权声明
THE END
喜欢就支持一下吧
点赞8 分享
评论 抢沙发

请登录后发表评论

    暂无评论内容