mrsibe/KnowNote

KnowNote – 本地优先的研究工作空间

它是什么

• 一款跨平台桌面应用程序（Electron），让您能将自己的 PDF、Word 文档、PowerPoint 和网页转化为可搜索的知识库。
• 您可以提出自然语言问题，并获得引用回原始段落的精确答案。
• 所有繁重的工作——解析、分块、嵌入和向量搜索——皆在您的机器上执行。唯一的网络调用是您发送给所配置 LLM 端点的请求。

运作方式

1. 导入文件。应用程序使用 pdfjs-dist、mammoth、officeparser 和 turndown 来提取文本，同时保留结构（页面、标题、幻灯片）。
2. 分割文本为约 500 字符的段落并保留少量重叠；每个段落记录其开始/结束偏移量以进行精确引用。
3. 嵌入每个段落，通过 ONNX 使用开源 Xenova/multilingual‑e5‑small 模型（384 维，量化至 q8），并在 Electron 主进程中执行。
4. 存储嵌入向量于本地 SQLite 数据库（通过 Drizzle ORM 使用 sqlite‑vec）。每个笔记本都有自己的向量表，因此不同的嵌入空间永远不会混杂。
5. 查询：您输入问题；应用程序检索最相关的段落，将其（加上您的提示词）发送到您配置的聊天模型（OpenAI、Anthropic、Google、Ollama 等），并显示答案以及可点击的引用。
6. 笔记：您可以在答案旁边撰写结构化笔记，并将笔记本转化为思维导图。

主要功能

• 本地 RAG – 无服务器、无 Docker、无云端存储；一切皆保留在您的设备上。
• 自备模型 (BYO) – 任何兼容 OpenAI、Anthropic、Google 或本地 Ollama 的端点；应用程序本身不内置聊天模型。
• 可追溯的答案 – 每个响应都会列出来源段落及其在原始文档中的确切位置。
• 多格式导入 – PDF、Word、PowerPoint 和任意网页。
• 笔记与思维导图 – 捕捉结论并可视化关系。
• 开源 – GPL-3.0 授权；嵌入模型仅下载一次并进行缓存。

缺失功能（截至最新版本）

• 音频上传/转录、测验生成和幻灯片生成仍在开发中。
• 尚未提供 Linux 版本；macOS 版本仅支持 Apple Silicon。
• 构建版本未签名（macOS）且未经公证，因此您会看到一次性的安全性提示。
• 无多用户同步、协作或遥测功能 – 这是一个单人工具。

技术栈

• Electron + React + TypeScript + TailwindCSS – UI 与桌面封装。
• Tiptap – 富文本笔记编辑器。
• ONNX runtime – 在本地执行 multilingual‑e5‑small 嵌入器。
• SQLite + sqlite‑vec – 向量存储与相似度搜索。
• Node.js – 开发环境；npm run dev 以热重载模式启动应用程序。

入门指南

1. 从 Releases 页面下载适当的安装程序（Windows 为 .exe，Apple Silicon macOS 为 ‑arm64.dmg）。
2. 在 macOS 上，清除隔离标记 (sudo xattr -rd com.apple.quarantine /Applications/KnowNote.app)。
3. 在 Windows 上，如果 SmartScreen 发出警告，请点击 仍要运行。
4. 开启 Settings → Models 并添加端点（例如 https://api.openai.com/v1/chat/completions 加上您的 API 密钥，或本地 Ollama 服务器）。
5. 导入文档、提出问题并探索引用的答案。

典型使用案例

• 学术研究：针对一系列论文提问，并查看支持每个答案的确切句子。
• 商业知识管理：查询内部 PDF、幻灯片和政策文档，无需将其上传至云端服务。
• 个人学习：建立一个私人的“第二大脑”，并使用您信任的任何 LLM 进行查询。

授权

• GPL-3.0 – 您可以自由使用、修改和重新分发代码，前提是必须保留相同的授权。

了解更多

• 项目网站：https://knownote.pages.dev（详细功能指南、设计理念以及与 NotebookLM/AnythingLLM 的比较）。
• 架构概述与设计笔记位于仓库的 DESIGN.md。
• 贡献指南位于 CONTRIBUTING.md。

---

KnowNote 是一款真正的开源 AI 增强桌面工具，将本地检索增强生成 (RAG) 带入日常研究工作流程，同时保持数据隐私并由用户掌控。