课设或平时写笔记,最烦一上来就要写成完整文章。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 步上手
- 准备本机模型和安装包:安装 Ollama,让它只监听
127.0.0.1:11434,执行ollama pull qwen2.5:3b。本篇主线不必再拉嵌入模型。Linux 用钉死的NoteGen_0.39.2_amd64.deb(sha2568f96f062e439d4a17e59d0523006163837990ce1177654bb544441fcbe161062),不要从「最新下载」拿别的版本。Debian 13 上,安装包声明的libgtk-3-0/libappindicator3-1已经更名,本机先补装libwebkit2gtk-4.1-0和libayatana-appindicator3-1,再dpkg -i装上。不要用note-gen --version探版本,它仍会拉起图形界面。 - 设好工作区,忽略更新:把工作区指到一个空的本机测试目录。自动更新请忽略,不要把 0.39.2 升到 latest。
- 先改到本机 Ollama,再开始对话:首次启动会写入默认免费云模型,对话前必须改掉。打开「设置 → 模型服务」,平台选或添加 Ollama。API 地址填
http://127.0.0.1:11434/v1(只填到/v1),Key 填占位ollama,网络代理选直连,再添加对话模型qwen2.5:3b。检测连接通过后,到窗口底部的模型选择器里勾选它。不要留在默认免费云模型或赞助商模型上。 - 中文对话,再整理自写记录:在对话里发一句中文,必须看到可辨认的回复。再到「记录」里写 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。

qwen2.5:3b。左侧是这个测试目录里的验收材料,不是官网示例。界面已经是简体中文。右侧对话栏当时已经准备提问,完整回复见后面的对话图。
http://127.0.0.1:11434/v1,Key 只有占位 ollama,网络代理是直连。下图是模型列表:qwen2.5:3b,类型是对话,已可检测连接。左侧列表里能看到赞助商平台名称,但没有填写云端 Key;那些不是本篇主线。
qwen2.5:3b。列表里有「NoteGen AI 免费」,但没有选它。对话前不要留在默认免费云模型上。

YGLD-NG-2211-A7Q3、LAMP-7042-SY、银杏灯核笺都看得见。中间打开的是第一条,时间是 2026-11-22 15:09(Asia/Shanghai)。这些只是验收用的虚构标记,不是密码,也不要写进自己的配置。
YGLD-NG-2211-A7Q3、LAMP-7042-SY、银杏灯核笺都在。文末参考文献只列了两条。3B 小模型会漏点或只做简单罗列,生成后要自己再改。
本机实际遇到的坑
- 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 中的捐赠入口、赞助商表格和官方宣传图。














暂无评论内容