Kiokuko（记忆库）

1.0 不再支持旧数据库，请使用新数据库。参见破坏性变更与旧配置清理。

English | 日本語 | 简体中文 | 한국어

通过 MCP 连接，检索需要的记忆，并在工作后积累知识。

Kiokuko 是面向 AI 编程代理的本地外部记忆。它把知识保存在 SQLite 中，在下一次任务中检索相关上下文， 并保存可复用的工作结果。

请求 → MCP 连接 → 检索相关记忆 → 完成工作
                              ↓
                         保存可复用知识

记忆分为 Project、Ecosystem 和 Global。当前代码、配置和运行结果优先于历史记忆。

快速开始

需要 Node.js 24.16.0 或更高版本（也支持 Node.js 26.1.0 或更高版本）。

npm install --global @askdkc/kiokuko
kiokuko setup

setup 会初始化数据库、检测支持的客户端、安装标准 Skill 并配置 MCP。已运行的客户端请在设置后重启。 精确配置和恢复规则请参阅英文 Getting started。

主要功能

• RAG 记忆（默认 lexical，可选本地 semantic 检索）
• Akinator 让模糊请求先变得具体
• 本地 Web UI 用于检查和整理记忆
• 外部 Skill 仅作为经过验证的参考，绝不自动执行

可选的 semantic 检索使用与 setup 相同的客户端配置流程：

kiokuko embeddings setup

它会更新 managed MCP block 和项目 instructions。替换 unmanaged identity 需要交互确认；非交互或 --dry-run --json 执行会在不修改配置的情况下 fail closed。详见英文 semantic retrieval。

支持的客户端

Codex、OpenCode、Claude Code、Hermes Agent。

安全性与限制

Kiokuko 不保存完整对话，并拒绝看起来像密码、API key、token 或私钥的内容。记忆只是参考信息，应以当前代码和运行结果为准。

MCP 是否调用由客户端和模型决定，不保证每一轮都会调用 Kiokuko。详细安全边界请看英文 Security and trust。

详细文档

请从英文文档目录开始；其中链接到 Getting started、Concepts、Semantic retrieval、Security and trust， 以及实现者用的 architecture、database、execution-ledger 和 client-compatibility 文档。