← 返回

你的笔记不是给你看的,是给Agent看的

詹叔 · 2026年07月29日

7月底,一个叫Hubble的开源笔记应用冲上Hacker News榜首,71分。点进去一看,slogan只有一句话——「为你和你的AI Agent设计的记事本」。

不是「支持AI」,是「为Agent而建」。这个措辞差别很大。

我又翻了一下GitHub仓库,发现这个东西的设计思路确实跟Notion、Obsidian这些主流笔记工具有一个根本性的分歧。值得拆一拆。

它到底是什么

Hubble是一个免费开源的桌面笔记应用,MIT协议,支持macOS、Windows、Linux。写起来跟Notion或Apple Notes差不多,有斜杠命令、Markdown快捷键、文件属性。底层是纯Markdown文件。

到这里听起来平平无奇。真正的差异在一行文档里:point your agent at your notes folder——把你的AI Agent指向你的笔记文件夹。

这句话的意思是,你的Agent可以直接读写你的笔记。Hubble会实时热重载,Agent改了什么你立刻能看到,你改了什么Agent也能读到。

笔记不再是只给人消费的,它同时是Agent的结构化上下文。

解决了什么真问题

过去一年Agent能力暴涨,但每个开发者都撞到同一面墙:Agent没有记忆。

你跟Claude Code聊完,关掉终端,下次打开它什么都不记得。Cursor也一样,每个会话是干净的。各家解决方案五花八门:有人往向量数据库里塞对话记录,有人搞RAG检索,有人手工维护context文件。都挺重的,而且效果一般。

Hubble换了个思路。它不去给Agent造一套记忆系统,而是直接用你已有的笔记当记忆。

这为什么聪明?因为你的笔记本身就是经过你整理的结构化知识。比起让Agent在一堆原始对话记录里做向量检索,让它直接读你精心组织的Markdown文件,信噪比高得多。

而且Markdown是纯文本,任何Agent都能读,不需要专门的API对接。你用的Claude、GPT、Cursor,只要是能读文件的Agent,都能直接用Hubble的笔记。

从源码里翻到的几个有意思的设计

我翻了Hubble的GitHub仓库(github.com/bholmesdev/hubble.md),monorepo结构,pnpm workspace管理。几个技术选型值得说说。

第一,编辑器用的是Tiptap。这是Notion同款的富文本编辑器框架,基于ProseMirror。选这个不意外——要做出Notion级别的编辑体验,Tiptap几乎是开源社区的唯一选择。Hubble把它封装成了一个framework-agnostic的editor包,可以独立使用。

第二,它搞了一个叫「HTML Apps」的概念。你的笔记不只是Markdown文本,还可以是可运行的HTML应用——表格、书架、地图视图。而且有一个runtime包专门负责在笔记里运行这些HTML应用。这意味着笔记从「记录信息的容器」变成了「可交互的微型应用平台」。

第三,它有一套skills系统。你可以给Hubble装skills,然后让你的编程Agent(比如Claude Code、Cursor)根据这些skills去构建自定义视图。这实际上是让Agent帮你定制笔记工具——你需要什么功能,让Agent写一个skill就行了。

第四,Cloud Sync用的是Convex。这是一个实时后端平台,跟Firebase类似但更现代。目前sync模块标着「HEAVILY WIP」,云同步还没完全做好。但技术选型说明团队的目标是做端到端的笔记同步,不只是本地工具。

仓库里还有个有意思的细节:自动化用的是Warp Factory agents。新issue自动打标签、写draft PR,PR提交后先过AI code review再到人工review。一个做Agent工具的团队,自己的代码仓库也在用Agent跑流程。还算自洽。

跟Notion和Obsidian的本质区别

很多人第一反应是:这跟Notion有什么区别?Notion也有AI啊。

区别在于Agent的地位。

在Notion里,AI是一个附加功能——你可以在编辑器里召唤AI帮你写东西,但AI不是Notion的一等公民。AI不持有你的笔记,它只是被临时叫来帮忙的。而且Notion的数据在云端,Agent想用必须走Notion的API,有速率限制、有权限管控、有数据格式转换。

在Hubble里,Agent是一等公民。笔记文件就在本地文件系统上,Agent直接读写,不需要API、不需要认证、不需要担心速率限制。Hubble的设计前提就是:你的笔记同时服务于你和你的Agent。

跟Obsidian比呢?Obsidian也是本地Markdown文件,插件生态极其丰富。但Obsidian从第一天起就是给人用的个人知识管理工具,它的所有设计假设都是「人在读、人在写」。Agent这个概念在Obsidian的设计哲学里根本不存在。

Hubble相当于在这两者之间开了一条新路线:本地优先(像Obsidian),但Agent优先(Notion从来没做到的)。

还得说几个局限

现在Hubble还在很早期的阶段。桌面版v0.1.22,Windows和Linux的构建没有签名,首次打开会有系统警告。Web版标记为「HEAVILY WIP」,基本不能用。Cloud Sync也没做完,目前只能单机使用。

skills系统刚刚起步,官方仓库只有几个示例。社区还没有形成规模,864颗星说明有关注度,但跟Obsidian的几万颗星比,生态差距很大。

HTML Apps的概念很酷,但目前还没有杀手级应用。能做表格、书架、地图视图,但这些在Notion里都有更成熟的实现。HTML Apps的真正价值可能要等社区开发者用skills构建出Notion做不到的东西才能体现。

还有一个我个人的疑虑:Hubble的定位非常依赖Agent生态的成熟度。如果Agent读写本地文件这个使用场景没有成为主流——比如大部分用户还是习惯用云端API调用Agent——那Hubble的核心卖点就站不住。它赌的是「本地Agent」这个方向会赢。

项目信息

项目名称:Hubble
GitHub:github.com/bholmesdev/hubble.md
星数:864 | 语言:TypeScript | 协议:MIT
作者:@bholmesdev
一句话评价:Agent-native笔记工具的第一批探索者,赌的是本地Agent这个方向

关注 SomethingAI 公众号

每日 AI 趋势日报,深度选题分析,独立开发思考

微信搜索「SomethingAI」关注