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

• 请不要在回答技术问题时复制粘贴 AI 生成的内容

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 。

知识库

本地

远程

8 replies • 2026-07-24 02:19:47 +08:00

jaydenWang

18h 56m ago

注意：需要自己配置 embedding 和 LLM API Key ，API Key 保存在本机 HomeKB 配置中

jaydenWang

17h 53m ago

还有一个有意思的功能点，可以透过中继把家里的文档分享出去：<https://www.homekb.app/s/123f525c60ebc32339c12948bc1cba42?r=https%3A%2F%2Fhomekb-relay.wangjintaoapp.workers.dev> 支持配置分享参数

dimlau

17h 15m ago

Osaurus 也刚更新了一个知识库功能。

jaydenWang

16h 53m ago

@dimlau 支持远端访问吗？

dimlau

16h 16m ago

Cloudflare Tunnel 大概可行吧，我没试过。您可以瞧一瞧：osaurus.ai

Maxwe11

6h 34m ago

我是在自己家里的一个老笔记本上部署了 openviking ，但是因为不想把这台设备的内部服务直接暴露给外网，所以在需要用到服务的其他设备上都装了 tailscale （包括 iphone ），然后把要用到 agent 记忆服务的都通过 tailscale 连到这台设备上，另外也是同时开了 smb 服务，然后同样通过 tailscale 访问目录，把笔记 vault 库统一也都放到这台机器上，这样除了自己可以访问使用笔记，也顺便同时把记忆和知识库同时在尽量不暴露对外服务的前提下，提供给我的 agents 使用。

jaydenWang

4h 53m ago

@Maxwe11 很可以。不过一直开着 tailscale 也挺麻烦，可能会跟梯子打架。可以试试 HomeKB ，直接把 Markdown 文件丢进.homekb/notes 就可以直接编译了。

Maxwe11

3h 2m ago

@jaydenWang 对，确实是有这类问题，因为我有个 agent 部在阿里云上，tailscale 的地址会被阿里的服务器内部解析到内部流量去，导致 update 等无法正常运行，也是排查了多半天。

主要是刚开始那时候市面上确实没什么符合需求的方案，就拼凑了一下，结果因为记忆都挂到了 openviking 上，向量化维度都锁死了，向量模型现在都没办法轻易切了，迁移成本就很麻烦。

有机会我试试看看，现在被绑定死本身就很难受。