做了个能远程访问的本地 Markdown 知识库, Claude、ChatGPT 和手机 Web 都能读写
Claude Code 、Codex 读取本机知识库并不难。但换到 Claude.ai 、ChatGPT Web 或手机后,要么失去这些上下文,要么需要重新上传和维护另一份知识库。所以我做了 HomeKB:
https://github.com/do-md/homekb
HomeKB 的核心思路是:知识库继续运行在家里的电脑上,但可以从本机和远程使用。
Markdown 、索引和写入保留在本机;
Claude Code 、Codex 通过本地 MCP 直接访问,不经过中继;
本机主动建立 outbound tunnel ,不需要公网 IP 或开放入站端口;
通过一次性配对码,可以连接 HomeKB Web 、Claude.ai 、Claude mobile 和 ChatGPT Web ;
所有客户端搜索、读取和更新的是同一份知识库,修改最终写回本机 Markdown 。
中继代码是公开的,可以部署到自己的 Cloudflare Workers 或 Node 环境。中继只持久化配对关系和令牌哈希,不保存笔记、附件、索引或搜索结果。
HomeKB 没有付费计划,建议使用个人中继( Cloudflare Workers 可以一键部署),数据全链路在自己手中。
召回质量:在 73 篇真实笔记的库上,用 44 条刻意换说法的口语化查询实测,Recall@5 达 97%、MRR 0.90 。
安装、支持平台和完整架构都在 GitHub README ,欢迎直接提 Issue 。 注意:需要自己配置 embedding 和 LLM API Key ,API Key 保存在本机 HomeKB 配置中 还有一个有意思的功能点,可以透过中继把家里的文档分享出去:<https://www.homekb.app/s/123f525c60ebc32339c12948bc1cba42?r=https%3A%2F%2Fhomekb-relay.wangjintaoapp.workers.dev> 支持配置分享参数 Osaurus 也刚更新了一个知识库功能。 @dimlau 支持远端访问吗? Cloudflare Tunnel 大概可行吧,我没试过。您可以瞧一瞧:osaurus.ai
页:
[1]