open-zk-kb

你打开一个新会话，你的智能体对你一无所知。又是这样。你重新解释你的技术栈、你的约定、那个你已经纠正过五次的边界情况。

open-zk-kb 给你的智能体一份记忆——让纠正得以沉淀，让上下文不断累积，让每一次会话都比上一次更聪明地开始。

快速开始

需要 Bun — 使用 curl -fsSL https://bun.sh/install | bash 安装

bunx open-zk-kb@latest

安装程序会配置你选择的客户端、安装智能体指令，并创建一个本地知识库。支持的客户端：OpenCode、Claude Code、Cursor、Windsurf、Zed、Pi 和 OMP。

手动安装和故障排查请参阅设置指南。

Related MCP server: Memento

为什么选择 open-zk-kb？

你的智能体每次会话都从零开始。没有记忆，没有学习曲线。你纠正同样的错误，重新解释同样的约定，重新传授同样的上下文。切换工具就更糟了——你的 Cursor 智能体不知道你的 Claude 智能体学到了什么。

open-zk-kb 解决了这个问题。

• 纠正一次，永久生效 — 你的智能体会存储纠正、偏好和决策。下次会话，它已经知道了。

• 跨所有工具工作 — 一个知识库，由 Claude Code、Cursor、Windsurf、OpenCode、Zed、Pi 和 OMP 共享

• 找到相关内容 — 混合搜索匹配语义而不仅仅是关键词，因此只有有用的上下文才会浮现

• 本地运行 — 无需 API 密钥，无需云端，可离线工作。你的数据留在你的机器上。

• 人类可读 — 纯 Markdown 文件，你可以浏览、编辑和进行版本控制

• 开源 — MIT 许可

Pi：原生知识工具

安装 Pi 包，然后重启 Pi：

pi install npm:open-zk-kb

该扩展在 Pi 中直接暴露全部十个 knowledge-* 工具。结果使用 Pi 原生的紧凑渲染：搜索、存储、上下文和健康状态具有聚焦摘要和可展开详情，而其他工具则显示简洁的状态输出。MCP 服务器和本地 SQLite/嵌入工作仍然需要 Bun >= 1.0 运行；Pi 本身在其支持的 Node.js 运行时下运行。因此，即使使用 Pi 包，也仍然需要安装 Bun。

Pi 还会在会话启动时自动加载活动的项目偏好，并将其注入模型上下文，无需模型发起的搜索。可见的 knowledge-context 条目会报告实际发生的情况，而不会伪造工具调用。

完整的偏好工作流和渲染器示例请参阅 Pi 体验指南。有关安装程序管理的指令、验证和故障排查，请参阅 Pi 安装。

配置

零配置要求。本地嵌入开箱即用，无需 API 密钥。

有关嵌入、知识库路径、生命周期调优和服务器设置，请参阅配置指南。

底层原理

基于 Zettelkasten 方法构建——原子化、相互链接、具有结构化类型的笔记。每条笔记捕捉一个概念（一个决策、一个偏好、一个陷阱），并链接到相关笔记，构建一个互联的知识图谱。

搜索结合了 SQLite FTS5 全文索引和本地向量嵌入（MiniLM-L6-v2）进行语义匹配。Markdown 文件是事实来源；数据库是可重建的索引。

遥测

启用后（telemetry.enabled: true 和 telemetry.share: true），open-zk-kb 会在后续启动时向 PostHog（欧盟云）发送每个已完成会话的一条匿名事件。它包含规范客户端、有界模型 ID、知识库大小以及全部十个工具的计数——不包含笔记内容、查询、路径、名称或电子邮件地址。运行时默认禁用；交互式安装程序仅在获得明确同意后才启用共享，而无人值守和直接包安装则保持禁用，除非另行配置。设置 DO_NOT_TRACK=1 可无条件阻止共享（本地 SQLite 计数器不受影响），或者将两个标志都保持为 false。完整的事件模式和详情请参阅遥测。

文档

• 设置指南 — 安装、客户端特定设置、故障排查

• Pi 体验 — 原生工具、自动偏好和渲染器画廊

• 工具参考 — 全部 10 个 MCP 工具及参数和示例

• 笔记生命周期 — 笔记类型、状态、审查系统

• 配置 — 嵌入、知识库、生命周期和服务器设置

• 架构 — 双存储、所有权模型、设计决策

• 开发 — 本地开发、测试、调试

• 贡献 — 贡献者指南

许可证

MIT 许可证