NoteGen 0.39.2 · 本机部署说明（远影归灯实测 2026-11-22，Asia/Shanghai，CPU 机器）

本说明对应钉死版本：tag note-gen-v0.39.2，提交 325e9940ed785576d9963088afdca66d6593a6bb。
不要跟 latest，也不要让应用自动更新把 0.39.2 升走。启动后若出现更新提示，直接忽略。

本篇主线是已经装好的桌面包，不是开发服务器。源码包供对照和学习；若要从源码构建，请自行准备 Node / pnpm、Rust 1.88，以及 Linux 下的 Tauri / WebKitGTK 依赖。
pnpm dev 默认绑定 0.0.0.0:3456，不要把它暴露到局域网。本篇没有把这条当作主线。

全程不需要云端 API Key。不要用官网演示、默认免费云模型或赞助商模型代替本机验收。

一、准备本机模型和安装包

  1. 本机已安装 Ollama，并且只监听 127.0.0.1:11434（不要改成 0.0.0.0）。
     拉取对话模型：

       ollama pull qwen2.5:3b

     本篇主线不必再拉嵌入模型。

  2. 使用钉死的 Linux 安装包（不要从官网「最新下载」拿别的版本）：

       文件名：NoteGen_0.39.2_amd64.deb
       SHA-256：8f96f062e439d4a17e59d0523006163837990ce1177654bb544441fcbe161062

  3. Debian 13 上，安装包声明的 libgtk-3-0 / libappindicator3-1 已经更名。
     本机先安装了 libwebkit2gtk-4.1-0 和提供 libappindicator3-1 的 libayatana-appindicator3-1，
     再执行：

       sudo dpkg -i NoteGen_0.39.2_amd64.deb

     若缺 GTK 相关库，按发行版补齐后再装。不要为此把服务改成监听全部网卡。

  4. 不要用 note-gen --version 或 --help 查看版本：这两个参数仍会拉起完整图形界面。
     版本以安装包、关于页或 dpkg 显示的 0.39.2 为准。

二、第一次打开时先改设置

  1. 把工作区设到一个空的本机测试目录，不要选家目录或已有私人笔记。
  2. 忽略自动更新，不要升 latest。
  3. 首次启动会写入默认免费云模型。对话和整理之前，必须先改到本机 Ollama：
       打开「设置 → 模型服务」（左侧 AI 分组）
       平台选 Ollama；若模板列表暂时拉不到，就「添加自定义平台」，名称填 Ollama
       API 地址：http://127.0.0.1:11434/v1
         （只填到 /v1，不要再加 /chat/completions）
       API Key：填占位 ollama（Ollama 通常不校验，但不能留空）
       网络代理：直连，避免代理把本地请求带走
       在该平台下添加模型，模型 ID 填 qwen2.5:3b，类型选「对话」
       点「检测连接」，确认就绪后再关闭设置
  4. 点击窗口底部的模型名称，勾选刚才的 Ollama qwen2.5:3b。
     不要留在默认免费云模型或赞助商模型上。
     模型服务页里可能看到赞助商平台名称，那不是本篇主线，也不要去点申请 Key。

三、主线验收（两步都要过）

  1. 中文对话：在对话面板发一句中文，例如「请用一句话说明如何把零散记录整理成课设笔记。」
     必须看到本机模型给出可辨认的中文回复。3B 质量一般也可以，但不能是报错或空白。
  2. 整理自写记录：在「记录」里新建 2～3 条你自己写的中文碎片（不要用官网示例或他人笔记），
     每条放一个只在这份材料里才有的记号。选中这些记录，用「整理」生成一篇 Markdown 笔记。
     生成后的笔记必须能在编辑器里继续改，并且正文里能看到这些记号或对应要点。

  本机实测（2026-11-22，Asia/Shanghai）：
  - 问句「请用一句话说明如何把零散记录整理成课设笔记。」
    回复「将零散记录按主题分类整理并撰写成课设笔记。」用时约 15 秒。
  - 三条自写记录的记号 YGLD-NG-2211-A7Q3、LAMP-7042-SY、银杏灯核笺，
    都出现在整理后的可编辑笔记「今日验收课题记录.md」正文里。
  - 3B 小模型文笔一般，整理结果可能重复、漏点或只做简单罗列，生成后要自己再改。
    不要把效果写成商用写作助手。

四、不要做的事

  - 不要用官网演示组件、官方同步里的云端笔记，或默认免费云模型 / 赞助商模型的回复当能跑证据。
  - 不要登录官方同步，也不要部署 note-gen-server 当本篇必过。笔记默认就在本地工作区。
  - 不要把 Ollama 改成监听 0.0.0.0。
  - 不要把 pnpm dev 的 0.0.0.0:3456 暴露到局域网。
  - 不要把运行后的 store.json、note.db、工作区私人笔记、插件缓存打进再分发包。
  - 知识库 RAG、Wiki、Agent、MCP、画布、录音转写、插件市场：支持但本篇未实测，不要写成已经跑通。

五、许可

  第一方以根目录 LICENSE 的 GNU GPL-3.0 为准，是强 copyleft，不能按 MIT 闭源使用。
  详细说明见 LICENSE-NOTE.txt。请同时保留 vendor/tauri-plugin-clipboard 的 LICENSE 与 PATCH.md。
