Open Kioku 上线：为 AI 编码 Agent 提供本地索引证据层

Open Kioku 是一个面向 AI 编码 Agent 的开源「证据层」工具，通过本地代码索引与 MCP（Model Context Protocol）协议，为 Claude、Cursor、Codex、Gemini CLI、Windsurf、Trae、Zed、OpenCode 等主流编码 Agent 在编辑前提供基于索引的事实依据，而非依赖重复爬取文件或从文本匹配推断引用关系。项目以 npm、crates.io、GitHub Releases 多渠道分发，源码托管在 github.com/shivyadavus/open-kioku。

核心功能：六步预编辑流程

Open Kioku 默认通过本地 stdio 提供只读 MCP 服务，将索引能力暴露为一组结构化工具调用：search_code（搜索代码与文件）、get_definition（解析符号定义）、impact_analysis（分析改动影响范围）、find_tests_for_change（推荐相关测试）、plan_change（生成预编辑计划）、verify_change（编辑后验证）。Agent 在修改代码前可依次调用这些工具，获得包括主要文件、相关符号、影响范围、验证命令、置信度评分及下一步 MCP 调用建议在内的预编辑方案。

工具还提供 ok prove 命令，可针对仓库生成可分享的 Markdown 或 HTML 报告，输出索引规模、任务评分与验证信号，但不包含源码片段，便于在私有仓库中对外评审。

性能表现

官方在某个公开仓库上进行的代表性审计显示，Open Kioku 在本地完成了 4,600 多个文件、46,000 多个符号、8,900 多个测试的索引，耗时 33.1 秒。索引数据存储在仓库根目录的 .ok/ 下，SQLite 存放元数据与图谱数据，.ok/index.sqlite 与 .ok/search/tantivy 分别承载结构化与 BM25 检索数据，大规模索引时会按 scan、parse、occurrences、store、graph、search、complete 阶段输出进度。

安装与 Agent 连接

三条命令即可完成最小可用流程：npm install -g open-kioku、ok index .、ok mcp install <client> --repo .，其中 client 支持 cursor、claude、codex、gemini、windsurf、trae、zed、opencode。安装脚本会输出对应的 MCP 配置片段，粘贴到目标 Agent 即可生效。项目同时提供 cargo binstall、crates.io 与 GitHub Releases 渠道，发布 Linux x86_64/arm64 musl、macOS x86_64/arm64 与 Windows x86_64 的原生二进制包及 SHA-256 校验值，并附带 OpenAI Codex、Claude、Cursor 的预配置插件元数据（.codex-plugin、.claude-plugin、.cursor-plugin）。

设计理念

项目作者指出，当前 AI 编码 Agent 的短板在于缺乏对代码库的事先感知，往往在编辑前后重复爬取文件、用文本匹配推断引用关系、在错误发生后才去补选测试。Open Kioku 把「先取证、再动手」固化为一套 MCP 工具序列：先在本地索引中检索代码与文件，再解析符号与引用，生成基于证据的预编辑计划与影响分析；Agent 自身的记忆不得凌驾于索引证据之上，且上下文会被压缩为可回溯原文的句柄。MCP 服务器默认只读、运行在本地 stdio，兼顾私有仓库的安全与可审计性。

整体而言，Open Kioku 是面向 AI 编码工作流的 MCP 生态工具，强调本地优先、证据驱动与 Agent 无关性，适合在多种主流编码 Agent 之间复用同一套代码事实层。