HomeKB：远程访问本地Markdown知识库，支持多平台读写

HomeKB 旨在解决 AI 大模型（如 Claude.ai、ChatGPT Web）在远程或移动端无法便捷访问本地 Markdown 知识库的问题。该项目核心理念是将知识库部署在本地电脑，同时支持本地和远程使用。其技术实现包括：知识库的 Markdown 文件、索引和写入操作均保留在本地；Claude Code 和 Codex 可通过本地 MCP 协议直接访问，无需中继；本地设备主动建立出站隧道，无需公网 IP 或开放入站端口。用户通过一次性配对码，即可将 HomeKB Web、Claude.ai、Claude mobile 和 ChatGPT Web 等客户端连接至同一知识库，实现所有客户端对同一份知识库的搜索、读取和更新，修改最终写回本地 Markdown。为确保数据安全，HomeKB 的中继代码是公开的，用户可自行部署到 Cloudflare Workers 或 Node 环境，中继仅持久化配对关系和令牌哈希，不保存笔记、附件、索引或搜索结果，从而实现数据全链路在用户掌控之中。项目不设付费计划，鼓励用户使用个人中继。在实际测试中，HomeKB 在包含 73 篇笔记的库上，对 44 条口语化查询实现了 97% 的 Recall@5 和 0.90 的 MRR，展现了优秀的召回质量。这为中国开发者和 AI 创业者提供了一个高效、安全且统一的 AI 知识库解决方案。