Rocketnotes 是一款基于 Web 的 Markdown 笔记应用，内置原生 AI 功能集成，如聊天、文本补全、语音转文字转录以及代理式文档归档。
它使用以下技术构建： langchain， langgraph， S3 向量，ChromaDB， sentence-transformers， Ollama。

使用方法

• 注册 免费账户，并以 Web 或 Electron 应用的形式使用。
• 使用 Docker 在本地完全运行：[INSTALLATION.md#run-with-docker]。
• 参阅 贡献指南，了解如何设置本地开发环境。

✨ 功能

• 📝 代码语法高亮：为开发者和技术用户提供一种整洁、易读的格式来保存和阅读代码片段。
• 📊 Katex 和 Mermaid 支持：在文档中直接嵌入复杂的数学公式（Katex）并创建图表或流程图（Mermaid）。
• 🌳 分层文档树：通过拖放功能将文档组织成嵌套结构，轻松重构知识库。
• 🌐 文档共享：与他人共享特定文档进行协作。
• 🔍 内容搜索：通过搜索笔记内容中的关键词，快速高效地找到所需笔记。
• 🔦 语义搜索：超越关键词搜索，理解查询背后的含义，找到概念上最相关的笔记。
• ✍️ 类似 Copilot 的文本补全：AI 会建议如何完成你的句子或段落，从而加快写作速度。
• 🤖 与文档对话：用自然语言提问，系统会从你自己的文档中合成答案。
• ✨ 多 LLM 支持：无缝切换不同的大型语言模型，目前支持 OpenAI、Anthropic 和 Together AI 的模型。
• 📥 Zettelkasten 与代理式归档：AI 代理会分析“收件箱”中的片段，并智能地将其归档到最相关的现有文档中。
• 🗣️ 语音转文字记笔记：无需打字，直接口述笔记内容。
• 📦 本地模式（Docker）：使用 Ollama 在本地机器上运行整个应用，实现 100% 的本地私密 AI 处理。
• ⚙️ MCP 服务器集成：将知识库作为 MCP 集成，以便与任何 LLM 应用程序一起使用。
• 🎮 Neovim 插件：将笔记功能直接集成到 Neovim 代码编辑器中。

🛠️ 技术栈

• 前端：Angular、TypeScript、Electron
• 后端：Go、Python
• AI：Langchain、Langgraph、S3 向量（云端）/ ChromaDB（本地）
• 基础设施：AWS、Docker
• 数据库：DynamoDB
• 存储：S3

💬 与文档对话

✍️ LLM 驱动的文本补全

 

💻 带语法高亮的代码文档

• 使用语法高亮功能，以你喜欢的编程语言创建有用的代码片段。

⚡ 超快速文档搜索

• 🔎 按内容搜索所有文档。
• 🚀 对符合搜索模式的所有文档提供自动建议——速度极快！

 

🌳 分层文档树

• 📚 以无限深度的子文档层次结构保存文档。
• 🗂️ 通过拖放操作整理文档结构。
• 🌟 将常用文档置顶，方便快速访问。

📥 Zettelkasten 收件箱与代理式归档

• ✍️ 通过打字或语音录制，将每日笔记片段保存到 Zettelkasten 收件箱中。

• 🤖 由 AI 代理工作流将笔记片段插入到最相关的文档中。

⭐️ 星级历史

🙌 贡献

进行首次贡献的一个好方法是参与 good first issues。在其中一些问题中，已经有人提交了带有代码注释的 PR，说明需要完成的工作。如果这些 PR 尚未被分配给其他人，你可以直接接手。

最便捷的入门方式是在 Gitpod 工作区中打开该项目——该工作区已预装所有依赖和工具，并且内置了一个运行中的数据库及示例数据。

 

如果你更倾向于在本地设置项目，请参阅 贡献指南，了解在本地开发模式下运行该项目所需的所有步骤。

如发现潜在的 bug 或希望新增某项功能，请随时提交 issue 获取反馈。我们也非常欢迎你查看现有的 issues，为现有问题提供意见，或直接提交解决相应问题的 PR。我们欢迎任何形式的贡献！

🛟 故障排除

• Apple 无法验证“rocketnotes”是否包含可能损害您的 Mac 或危及您隐私的恶意软件。

  • 这是因为该 dmg 文件并非使用官方 Apple 开发者证书构建的。要绕过此限制，请前往“系统设置”->“隐私与安全性”->“安全性”-> 找到“rocketnotes”已被阻止以保护您的 Mac -> 点击“仍要打开”。

Rocketnotes 快速上手指南

Rocketnotes 是一款基于 Web 的 Markdown 笔记应用，集成了原生 AI 功能（如聊天、文本补全、语音转文字及智能文档归档）。它支持本地部署（使用 Ollama）或云端使用，旨在打造私有的第二大脑。

环境准备

在开始之前，请确保您的系统满足以下要求：

• 操作系统: Windows, macOS, 或 Linux。
• 容器运行时 (推荐本地部署): 安装 Docker 和 Docker Compose。
  • 国内用户建议: 若拉取镜像缓慢，可配置 Docker 国内镜像加速器（如阿里云、腾讯云等）。
• AI 模型后端 (本地模式必选): 安装 Ollama 用于本地大模型推理。
  • 验证安装：终端运行 ollama --version。
  • 拉取默认模型（可选，应用启动时通常会自动处理，但预拉取可加速）：ollama pull llama3 (或其他您偏好的模型)。
• 开发环境 (仅贡献者需要): Go, Python, Node.js/Angular, TypeScript。普通用户无需安装。

安装步骤

Rocketnotes 提供三种主要使用方式：直接使用在线版、本地 Docker 部署（推荐）、或开发模式。以下是本地 Docker 部署的步骤，可实现 100% 数据本地化和隐私保护。

1. 克隆项目仓库

git clone https://github.com/fynnfluegge/rocketnotes.git
cd rocketnotes

2. 配置环境变量 (可选)

如果需要使用特定的 AI 模型或修改端口，可以复制示例配置文件：

cp .env.example .env

注：对于基础本地体验，通常可直接使用默认配置启动，默认会连接本地的 Ollama 服务。

3. 启动服务

确保本地 Ollama 服务正在运行，然后使用 Docker Compose 启动应用：

docker compose up -d

• 该命令将自动构建并启动前端、后端、向量数据库 (ChromaDB) 等容器。
• 首次启动可能需要几分钟下载依赖镜像和初始化数据库。

4. 访问应用

服务启动完成后，在浏览器中访问：

http://localhost:4200

提示：如果您更喜欢桌面应用体验，也可以直接在官网下载预编译的 Electron 版本安装包，或在 Web 端使用后将其安装为 PWA。

基本使用

启动成功后，您可以立即开始体验核心功能：

1. 创建笔记与层级管理

• 点击左侧边栏的 + 号创建新文档。
• 支持 Markdown 语法编辑。
• 通过拖拽文档节点，构建无限层级的 文档树 (Document Tree)，整理您的知识库。

2. 体验 AI 文本补全 (Copilot)

• 在编辑器中输入文字时，AI 会自动灰色显示建议的后续内容。
• 按下 Tab 键即可采纳建议，实现流畅写作。

3. 与文档对话 (Chat with Documents)

• 点击右上角的 Chat 图标打开侧边栏。
• 输入自然语言问题（例如：“总结我关于 Docker 的笔记”），AI 将基于您库中的文档内容生成回答。
• 本地模式: 确保 Ollama 已加载相应模型，所有推理均在本地完成。

4. 智能归档 (Zettelkasten Inbox)

• 在 "Inbox" 区域快速记录碎片化想法（支持语音输入）。
• 触发 Agentic Archiving 工作流，AI 代理会自动分析这些片段，并将其移动或链接到最相关的现有文档中，自动维护知识体系。

5. 代码与图表支持

• 代码高亮: 使用 ```language 语法块插入代码，享受专业的语法高亮。
• 图表绘制: 直接嵌入 Mermaid 流程图或 Katex 数学公式。

现在，您已经成功部署并开始使用 Rocketnotes。您可以进一步探索设置中的多模型切换（OpenAI/Anthropic/Together AI）或 Neovim 插件集成等高级功能。