Show HN: OpenKnowledge —— 开源 AI 优先的 Obsidian/Notion 替代方案

背景

在当前的生产力工具市场中，Notion 和 Obsidian 占据了笔记与知识管理的重要地位。Notion 以块编辑器和协作能力见长，而 Obsidian 则凭借本地优先（Local-first）的 Markdown 文件和强大的插件生态受到极客喜爱。然而，随着大语言模型（LLM）技术的爆发，传统的笔记工具在“AI 原生”体验上仍存在断层：要么 AI 功能作为附加插件存在，要么依赖云端服务导致数据隐私顾虑。

在此背景下，Hacker News 上出现了一个名为 OpenKnowledge 的项目。它定位为一款“AI 优先”的开源替代方案，旨在结合本地优先的数据控制权、类 Notion 的流畅编辑体验以及深度的 AI 集成。该项目由 Inkeep 团队开发，不仅提供了桌面应用，还通过 CLI 支持 Web 应用模式，试图解决团队协作、AI 集成与数据主权之间的矛盾。

核心内容

OpenKnowledge 是一款美观的、本地优先（Local-first）的 Markdown 编辑器，同时也是一个集成了大语言模型能力的 Wiki 系统。其核心特性包括：

1. 编辑体验与 AI 集成

• 所见即所得（WYSIWYG）编辑：编辑器提供了完整的 WYSIWYG 体验，使得编辑 Markdown 的过程如同在 Google Docs 或 Notion 页面中操作一样流畅，降低了 Markdown 语法的认知负担。
• 多模型支持：原生集成了 Claude、Codex 和 Cursor 等主流 AI 工具的能力，允许用户在笔记环境中直接调用 AI 进行内容生成、代码辅助或知识检索。

2. 协作与同步机制

• 基于 Git 的协作：团队间的分享和自动同步功能由 Git 驱动。这意味着所有数据变更都可以通过版本控制系统进行追踪和同步，既保证了数据的完整性，又利用了 Git 成熟的分布式协作优势。

3. 安装与部署方式

OpenKnowledge 提供了多种部署形态，以适应不同用户的需求：

• macOS 桌面应用：

  • 用户可下载 DMG 安装包，将 OpenKnowledge 拖入 Applications 文件夹即可启动。
  • 最新版本可通过官方渠道获取。

• Linux 或 Intel Mac 的 Web 应用模式：

  • 对于非 Apple Silicon 的 Mac 用户或 Linux 用户，可以通过命令行界面（CLI）将编辑器作为本地 Web 应用运行。
  • 注意：目前 Windows 尚不支持此模式。
  • 环境要求：需要 Node.js 24 或更高版本。
  • 快速启动命令：

    npm install -g @inkeep/open-knowledge
    cd your-project
    ok init # 初始化项目，并配置 Claude Code, Cursor 和 Codex
    ok start --open # 启动编辑器并在浏览器中打开
    

  • 通用使用文档见：https://openknowledge.ai/docs

4. 开发者贡献指南

• 公共 Pull Requests (PR)：欢迎公开提交 PR。当公共 PR 打开时，自动化流程会将其镜像到内部 monorepo 中进行审查和合并。
• 贡献详情：具体流程请参阅 CONTRIBUTING.md。

5. 开发环境依赖

构建和运行 OpenKnowledge 需要以下环境：

• Bun：1.3.13 或更新版本（在 .bun-version 中固定）。
• Node.js：24 或更新版本（在 .node-version 中固定）。
• Git

若使用 Node 版本管理器，需固定 Node 24，例如：

• fnm install
• volta install node@24
• mise install

注意：较早的 Node 版本会在 bun install 期间因引擎检查失败。

6. 本地开发与构建命令

• 安装依赖：bun install
• 代码检查：bun run check
• 运行应用：bun run --filter @inkeep/open-knowledge-app dev
• 运行文档站：cd docs && bun run dev

7. 项目结构

• packages/app：Web 应用及编辑器 UI。
• packages/cli：命令行入口点。
• packages/core：共享领域逻辑。
• packages/desktop：Electron 桌面应用。
• packages/plugin：Agent 集成包。
• packages/server：本地服务器。
• docs：文档站点。

8. 代码质量与测试

• 格式化：bun run format
• Linting：bun run lint
• 类型检查：bun run typecheck
• 测试：bun run test
• 构建：bun run build

9. 开源许可证

OpenKnowledge 采用 GNU General Public License v3.0 or later (GPL-3.0-or-later) 许可证。

关键要点

• AI 原生而非 AI 附加：OpenKnowledge 并非简单的 Markdown 编辑器加上 AI 插件，而是从底层架构上集成了 Claude、Codex 和 Cursor 的能力，实现了“AI-first”的工作流。
• 本地优先与 Git 同步：通过 Git 驱动协作和同步，既保留了 Obsidian 式的本地数据控制权，又解决了 Notion 式的协作痛点，适合对数据隐私敏感的技术团队。
• 跨平台策略差异化：macOS 提供原生桌面应用，而 Linux 和 Intel Mac 用户需通过 Node.js 环境运行 Web 应用，Windows 用户目前无法使用 CLI/Web 模式。
• 严格的版本依赖：项目强制要求 Node.js 24+ 和 Bun 1.3.13+，这表明其利用了较新的 JavaScript/TypeScript 运行时特性，对开发环境有较高要求。
• 开源与透明：采用 GPL-3.0 许可证，代码结构清晰（Monorepo），并建立了从公共 PR 到内部仓库的自动化镜像机制，鼓励社区贡献。

意义与影响

OpenKnowledge 的出现反映了生产力工具领域的一个明显趋势：从“文档管理”向“智能知识工作流”的转变。

1. 填补市场空白：目前市场上缺乏一款既拥有 Notion 般流畅编辑体验，又具备 Obsidian 本地数据控制权，同时还能深度整合 LLM 能力的开源工具。OpenKnowledge 试图在这一三角关系中取得平衡。
2. 技术栈的前沿性：项目对 Bun 和 Node.js 24 的依赖，显示了开发者对高性能 JavaScript 运行时和新语言特性的拥抱。这可能会推动更多本地优先应用向更现代化的构建工具链迁移。
3. Git 作为协作后端的新范式：利用 Git 处理笔记和文档的同步与协作，是一种回归本源但极具技术美感的选择。它避免了专有云服务的锁定，同时也比纯本地文件同步更可靠。这对于重视数据主权和版本控制的开发者群体具有吸引力。
4. 对现有巨头的挑战：虽然目前 OpenKnowledge 仍处于早期阶段（如 Windows 支持缺失），但其“AI 优先”的定位直接对标 Notion AI 和 Obsidian 的 AI 插件生态。如果其体验足够流畅，可能会吸引那些对 Notion 数据隐私或 Obsidian 学习曲线不满的用户群体。

总的来说，OpenKnowledge 是一个值得关注的开源项目，它不仅是一个笔记工具，更是探索本地优先架构与 AI 能力深度融合的一次重要实践。