2. V2EX
  3. 做了个能远程访问的本地 Markdown 知识库， Claude、ChatGPT 和手机 Web 都能读写

做了个能远程访问的本地 Markdown 知识库， Claude、ChatGPT 和手机 Web 都能读写

jaydenWang 2026-07-23 10:24 1

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 。

最新回复 (7)
  • jaydenWang 楼主 07-23 10:26
    1楼
    注意：需要自己配置 embedding 和 LLM API Key ，API Key 保存在本机 HomeKB 配置中
  • jaydenWang 楼主 07-23 11:28
    2楼
    还有一个有意思的功能点，可以透过中继把家里的文档分享出去：<https://www.homekb.app/s/123f525c60ebc32339c12948bc1cba42?r=https%3A%2F%2Fhomekb-relay.wangjintaoapp.workers.dev> 支持配置分享参数
  • dimlau 07-23 12:06
    3楼
    Osaurus 也刚更新了一个知识库功能。
  • jaydenWang 楼主 07-23 12:28
    4楼
    @dimlau 支持远端访问吗？
  • dimlau 07-23 13:06
    5楼
    Cloudflare Tunnel 大概可行吧，我没试过。您可以瞧一瞧：osaurus.ai
  • Maxwe11 07-23 22:47
    6楼
    我是在自己家里的一个老笔记本上部署了 openviking ，但是因为不想把这台设备的内部服务直接暴露给外网，所以在需要用到服务的其他设备上都装了 tailscale （包括 iphone ），然后把要用到 agent 记忆服务的都通过 tailscale 连到这台设备上，另外也是同时开了 smb 服务，然后同样通过 tailscale 访问目录，把笔记 vault 库统一也都放到这台机器上，这样除了自己可以访问使用笔记，也顺便同时把记忆和知识库同时在尽量不暴露对外服务的前提下，提供给我的 agents 使用。
  • jaydenWang 楼主 07-24 00:29
    7楼
    @Maxwe11 很可以。不过一直开着 tailscale 也挺麻烦，可能会跟梯子打架。可以试试 HomeKB ，直接把 Markdown 文件丢进.homekb/notes 就可以直接编译了。
* 帖子来源V2EX
附近帖子
返回
飞读
随机推荐