Timaga/noda-local-ai-notes

项目介绍

Noda 是一款 Windows 桌面笔记应用，每个项目的笔记都以 Markdown 形式保存在用户指定的文件夹里，应用设置和聊天记录则单独存放在 Windows 用户配置中。它在笔记之上叠加可选的本地 AI 环节：自动生成标题和标签、保存笔记间连接、知识图谱、语义搜索，以及能引用并链接来源笔记的问答。所有处理都使用机器上安装的模型，常规流程不依赖托管模型 API。

它适合已经在写 Markdown、又希望在不把整个知识库交给云服务的前提下做检索和跨笔记提问的人。图谱展示的是已保存的关系，而不是按相似度强行连线；AI 生成的元数据仍可手动修改。

安装与首次使用

官方安装方式是 Windows x64 安装包，从发布页下载 Noda-Setup-<version>-x64.exe，运行后从开始菜单启动。由于代码签名尚未落实，安装包目前未签名，项目要求安装前先看已知安全问题。

首次运行时新建项目或连接已有的 Markdown 文件夹。初始化会下载语义搜索模型（约 1.1 GB），随后可选择笔记处理模型或关闭可选 AI 环节，模型权重不随安装包分发。创建一条速记，确认它进入处理队列，再在库中打开结果。

应用不包含自动更新：备份项目和用户配置，通过托盘菜单完全退出 Noda，再运行新版本安装包。项目文件夹和配置数据在重装后保留。

从源码构建

开发者需要 Windows x64、Git，以及 22.x 系列中不低于 22.12 的 Node.js 和 npm。在 PowerShell 中执行：

git clone https://github.com/Timaga/noda-local-ai-notes.git
cd noda-local-ai-notes
npm --prefix frontend ci
npm --prefix frontend run build

构建脚本会打印生成的安装包路径，但不会发布它。测试流程见开发指南，版本准备见发布指南。

使用约束

• 需要 Windows 10 或 11 x64 和支持 AVX2 的处理器；推荐模型配置以 16 GB 内存为起点，更大的模型需要更多资源。
• 不装语义搜索模型也能浏览、编辑和使用文本搜索；语义搜索和笔记问答需要各自的本地模型，CPU 处理可能耗时数分钟。
• 随附的笔记处理配置只支持俄语和英语。界面提供十种语言，但切换界面语言不会翻译笔记。
• Noda 自行管理本地 Python 和 Qdrant 组件，安装时下载运行时依赖，因此首次安装需要联网并预留额外磁盘空间。
• 项目文件不加密，README 建议依赖操作系统存储保护并做好备份。微调功能已禁用；真实安装包在干净机器上的验证和更广泛的模型评估仍是文档中承认的缺口。
• 代码采用 PolyForm Noncommercial License 1.0.0，属于带非商业限制的源码公开软件，不是 OSI 开源许可，未授予商业使用权。第三方运行时、模型和素材保留各自许可。

问答结果和生成的元数据可能出错，README 建议在对准确性有要求时核对引用原文。截图使用合成演示笔记。

HotRepo 点评

站内目前只有 2026-11-15 的一条新项目榜快照（JavaScript 榜）：项目在一小时窗口内增加 3 颗 Star，达到 105 颗。单次观察不足以判断趋势。对读者更有价值的信息是它刻意收窄的形态：数据用 Markdown 自有，检索结果带引用，许可证为非商业的源码公开；与此同时，安装包未签名，仓库材料没有说明二进制与源码的对应关系，也没有体现真实使用情况。