如果你的笔记还在用 Obsidian、Notion、飞书或者语雀,那你大概率犯了一个错误:你把笔记当成人看的,AI 只是旁边一个被塞进来的聊天框。 2026 年 6 月底,海外开源圈冒出一款叫 OpenKnowledge 的工具,一周内在 Hacker News 上冲到 377 分、170 多条评论,GitHub 星标从 0 涨到 1500+。它干的不是"再做一个 Notion",而是一件事:把你的笔记库直接重写成 Claude、Codex 这些 agent 能读、能查、能改的"第二大脑"。 这篇就拆这一个信息差——笔记该从"给人看"升级成"给 AI 读"——顺便带你看本周还值得装的两把新刀。
OpenKnowledge(inkeep/open-knowledge)是 Inkeep 公司开源的项目。Inkeep 这家公司你可能没听过名字,但只要你用过 Vercel、Stripe、Supabase 的官方文档里那个"问一下 AI"的搜索框,背后大概率就是它。现在他们把这套"让 AI 读懂文档"的能力,做成了一个本地的 Markdown 编辑器 + LLM Wiki。
它的定位用官方一句话说就是:"Notion 遇上 VSCode。" 但真正让它和 Obsidian、Notion 区分开的,不是编辑器界面,而是底层那一层"给 agent 用的接口"。
| 维度 | OpenKnowledge | Obsidian | Notion | 飞书文档 |
|---|---|---|---|---|
| 数据存储 | 本地 Markdown(私有) | 本地 Markdown | 云端 | 云端 |
| AI 接入方式 | 原生 MCP + Skills 自动接线 | 需装 Copilot 等插件 | AI 是聊天气泡 | AI 是侧边助手 |
| Agent 能否直接读写笔记 | ✅ 能,Claude/Codex/Cursor | ❌ 需自己写脚本 | ❌ 受限 | ❌ 基本不行 |
| 是否开源 | ✅ GPL-3.0 | ❌ 闭源 | ❌ 闭源 | ❌ 闭源 |
| 价格 | 免费 | 免费但闭源 | $10/月起 | 企业付费 |
1. ok init 一条命令,自动给你的笔记库接上 AI
这是最反常识的一点。大多数工具装完之后,你得手动配 MCP server、写 skills、调 prompt。OpenKnowledge 不一样——你在任意一个 Markdown 文件夹里跑:
npm install -g @inkeep/open-knowledge
cd your-project
ok init # 检测到 Claude Code / Cursor / Codex 后自动配好 MCP 和 skills
ok start --open # 在浏览器里打开编辑器
ok init 会扫描你电脑上装了哪些 AI harness(Claude Code、Cursor、Codex),然后自动写好对应的 MCP 配置和 skill 定义。意思是:跑完这条命令,你的笔记文件夹就已经是这些 agent 的"知识库"了——Claude Code 能直接搜你笔记、读你笔记、按你笔记里的规范写代码。不用你写一行集成代码。
2. 它能直接打开你现有的 Obsidian vault
官方明确写了:"Can be used with existing codebases, wikis, Obsidian vaults, etc." 也就是说你过去三年在 Obsidian 里攒的几百篇笔记,不用迁移,直接拿 OpenKnowledge 指过去,它就能把这些笔记变成 agent 可查询的 LLM Wiki。对国内深度用 Obsidian 的开发者,这是零迁移成本的升级路径。
3. 它给笔记库自动生成 "agentic search" 和 knowledge graph
普通 wiki 是人去搜索。OpenKnowledge 内置了面向 agent 的搜索(agentic search)和图谱视图(graph wiki link viewer),并支持生成 skills——也就是把你的笔记知识"打包成 agent 可调用的技能"。这是从"文档"到"agent 能力"的关键一跃。
90% 的中国开发者用 AI 的姿势是:开一个 ChatGPT / Claude / 文心一言窗口,把笔记内容复制粘贴进去问。这意味着:
OpenKnowledge 代表的趋势是:别让 AI 临时来"读"你的笔记,让笔记库本身成为 AI 长期挂载的知识层。 你写的每一篇 spec、每一次复盘、每一条踩坑笔记,都应该结构化成 agent 能直接 search 和 read 的 Wiki。这就是海外在喊的 "agent second brain"(agent 第二大脑)和 "LLM Wiki"。
下面这张图说清了"传统笔记"和"agent 第二大脑"的差别,也就是这一波工具在解决的核心架构差:
flowchart LR
subgraph OLD["传统笔记(给人看)"]
A1[你在 Obsidian/飞书写笔记] -->|手动复制粘贴| A2[聊天框里的 AI]
A2 -->|局部回答 每次重喂上下文| A3[你]
end
subgraph NEW["agent 第二大脑(给 AI 读)"]
B1[你在 OpenKnowledge 写笔记] --> B2[ok init 自动生成 MCP+Skills]
B2 --> B3[笔记库 = 可搜索的 LLM Wiki]
B4[Claude Code / Codex / Cursor] -->|search read edit| B3
B4 -->|带全量上下文干活| B5[你的代码仓库]
end
OLD ==|架构升级| NEW
npm install -g @inkeep/open-knowledge
ok init && ok start --open
注意 Node 24 这个版本要求比不少老项目高,国内用户如果用 nvm,记得 nvm install 24 切过去,不然装不上。
OpenKnowledge 解决的是"知识层",但跑 agent 还有两个高频痛点本周也有新答案。
仓库:workweave/router(Go,590+ 星)
官网:weaverouter.com
它干的事很直白:给 Claude Code、Codex、Cursor 这类 agentic 系统做模型路由。 每次请求由它在 <50ms 内判断该走哪个模型——简单的活(补全、格式化)走便宜模型,难的活(架构设计、复杂调试)走贵模型,对外只暴露一个 OpenAI 兼容端点。
对国内开发者的价值:很多人现在是"要么全用顶配 Claude 烧钱,要么全用便宜模型出 bug"。router 这类中间层让你不用动 agent 代码,换一个 endpoint 就能在质量和成本之间自动找平衡。一个提醒:它的 license 字段是 NOASSERTION,也就是用了自定义协议、不是标准开源协议,企业引入前一定要读一遍 LICENSE 条款,别想当然按 MIT 用。
仓库:NotASithLord/peerd(JavaScript,Apache-2.0,235 星,6 月 22 日才开源)
官网:peerd.ai
peerd 的口号是"the first AI agent harness native to the browser"——它是一个 Chrome/Firefox 扩展,agent 循环(agent loop)直接在你的浏览器里跑,能驱动你的标签页、在沙箱里起 JS notebook 甚至 WASM Linux 虚拟机做计算,还能把你做出来的东西 P2P 分享给别人。
三个让它和别的 agent 区分开的点:
适合谁:想体验 agent 自动操控网页、又不想把任务和数据丢到别人云端的开发者。Apache-2.0 协议,商用友好。
| 你以为的 | 实际情况(海外已在用) |
|---|---|
| 笔记是写给人看的,AI 是旁边聊天框 | 笔记库该重做成 agent 第二大脑,让 Claude/Codex 直接 search+read |
| 给 AI 喂知识要手动复制粘贴 | ok init 一条命令,自动给笔记库接好 MCP + Skills |
| 想用 AI 联想笔记得装一堆插件 | OpenKnowledge 原生支持 agentic search + 知识图谱 |
| Obsidian 用了三年,迁移成本太高 | OpenKnowledge 能直接打开现有 Obsidian vault,零迁移 |
| agent 要么烧钱要么出 bug | workweave/router 一个端点做模型路由,砍 40–70% 账单 |
| agent 必须跑在云端容器里 | peerd 在浏览器 + WASM Linux VM 里跑,零后端零遥测 |
| ## 四、行动指南:今晚就能做的三步 |
第一步(30 分钟):试用 OpenKnowledge。
如果你是 Mac,直接下 dmg。如果你主力是 Obsidian,别新建库——把你现有的 vault 文件夹指给 ok init,看看 Claude Code 能不能直接搜到你笔记里的踩坑记录。这一步就能让你直观感受到"第二大脑"和"聊天框"的区别。
第二步(1 小时):把项目规范结构化成 LLM Wiki。
挑你当前项目的 spec、架构决策(ADR)、踩坑笔记,用 OpenKnowledge 的 starter pack 起一个 LLM Wiki 模板。重点不是写得漂亮,而是让 agent 能通过标题和链接检索到——这是从"文档"到"agent 能力"的关键。
第三步(按需):给烧钱的 agent 路由器。
如果你的 Claude Code / Codex 月账单已经过百刀,去 workweave/router 仓库看看它的路由策略(务必先读它的自定义 LICENSE),或者参考它的思路自己用 GLM 等便宜模型分流简单请求。这是本系列之前讲过"砍思考税""换分词器"之外,又一个降本抓手。
OpenKnowledge 不是一个更好的笔记软件,它是一个信号:2026 年下半年,知识管理的重心正在从"人怎么记笔记"转向"agent 怎么读笔记"。谁先把自己的笔记库、项目文档重做成 agent 能直连的 LLM Wiki,谁的 AI 工作流就先跑出复利。国内绝大多数人还在复制粘贴,这就是你要的窗口期。
本文由「51学通信」技术团队出品。51学通信由通信行业18年老兵爱卫生(微信ID: gprshome201101)维护。 聚焦5G/6G核心网、3GPP标准、AI工具实战。知识星球「51学通信」提供深度技术答疑和行业洞察。
NOASSERTION,非标准开源)。/home/gprshome/ok*.json / hn3.json 等,可按需清理(不在仓库内,无敏感信息)。[!tip] 51学通信知识星球 星主:爱卫生(微信:gprshome201101)——公众号「51学通信」创办者,19 年通信行业运维与讲师经验,著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书(各大电商平台有售)。 星球定位:深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域,主打运维岗位与信令分析。 当前规模:5200 篇主题 / 990 个回答,198 元/年。 加入福利:加入星球后请加爱卫生微信,拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题,另有群内分享。 AI 加持:51学通信知识星球已作为 skill 接入 WorkBuddy,使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例,做总结、找文档和 PPT 等场景全覆盖。
