Kage 是一款面向编程智能体的编排器，构建在记忆层之上。核心目标是让编程智能体不再反复重新理解你的代码库，也不会依据过时的知识行动。
主要能力
-
记忆的持久化与共享：随着智能体工作，Kage 将其学到的内容（决策、缺陷修复、约定、代码结构关系）捕获为 Open Knowledge Format（OKF）概念文件，提交在仓库的 .agent_memory/ 目录下。下一次会话（无论你还是队友）一开始就已掌握这些内容，无需重新阅读或重新询问。记忆通过 git 共享，具有协作性。
-
代码验证：每条记忆都会引用其对应的代码，Kage 在写入时、召回时以及 diff 改动代码时核对这些引用。引用了不存在文件的记忆会被当场拒绝；当某次 diff 改变了某条记忆所引用的代码，该记忆会在提交/PR 阶段被标记（kage pr check），并在重新验证或被替换之前从召回中屏蔽，从而避免记忆悄悄腐化。
-
编排与委派：声明一个意图，Kage 的编排器会从仓库自身记忆中为编程智能体生成简报，在隔离的 git worktree 中运行它——可以是单次运行，也可以是多波次的目标——然后由 Kage 自己重新运行检查（测试、diff 大小、引用），而不是相信智能体的自我报告。只有当声明成立时 kage merge 才会合入代码，并确认智能体所学内容，让下一次简报（无论你的还是队友的）起点更聪明。
-
标准与可移植性：记忆是符合 OKF 的纯 Markdown 文件，带 YAML frontmatter，可在代码审查的同一个 PR 中查看，任何 OKF 工具都能读取，不被锁定在某台机器或厂商云中。可通过 kage okf migrate 将存储渲染为 .agent_memory/okf/ 下的 OKF bundle，并可无损导入任何第三方 OKF bundle。Kage 的信任元数据保存在 OKF 合法的 x-kage-* 字段中，保持 100% 兼容。
使用方式
在仓库内执行一条命令，然后重启智能体即可完成整个安装：npx -y @kage-core/kage-graph-mcp install。它会创建 .agent_memory/、构建代码图、写入 AGENTS.md / CLAUDE.md 策略以告知智能体使用 Kage、自动检测并接线智能体、配置 .gitignore 与 packet merge 驱动。要求 Node.js 18+，无需账号或 API 密钥。也可以直接让你的智能体按提示完成设置。
安装后 Kage 处于环境级运行，无需手动执行：任务开始时（以及智能体打开文件时）自动召回相关且经过验证的记忆，过时或已删除的记忆被排除；工作中将持久学习内容捕获为 packet；代码变动时保持诚实。可用 kage viewer 在本地仪表盘中观察 packet、记忆↔代码图、信任门与实时事件流。将内容包裹在 <private>...</private> 中即不会被存储。
其他命令与界面：kage app --project <dir> 启动或复用地本地守护进程并打开 UI，包含同一房间、运行看板与记忆视图；从检出可用 npm start --prefix shell 以原生窗口运行（Electron 薄壳，无自有 HTML）。守护进程可绑定局域网地址，但每个请求（含读取）都需配对密钥，目前需在 .agent_memory/config.json 手动设置 "lan": true，尚无 --lan 标志或应用开关。kage projects add <dir> --agent claude 可无终端注册另一个仓库。macOS（仅 arm64）有未签名的 .dmg 原生外壳，首次启动会提示"未识别开发者"，需在 Finder 中右键选择打开。
适用场景与限制
适用于使用编程智能体的团队，希望在仓库内共享经过验证的代码知识，避免重复解释代码库、避免依据过时记忆行动。仓库内容要求 Node.js 18+，Windows/Linux 打包暂未构建，局域网访问需手动配置，无需账号、无数据库、无 API 密钥。检索路径本身无依赖（BM25 + 稀疏词法评分，无嵌入、无网络）。许可证为 GPL-3.0-only；GPL 切换前的版本为 MIT。
性能与验证数据（来自资料）
在真实代码导航任务中比 grep 快 18%（同等正确性，N=3 套件，同一智能体/模型）。LongMemEval-S 检索：98.72% R@10 / 99.79% R@20 / 0.909 MRR，除 R@5（96.17% vs BM25 的 96.60%）外各深度均领先 BM25。变更下的记忆正确性：0% 过时服务（代码已删除或变更的记忆被屏蔽），而捕获一切型存储为 100%。信任基准：100/100，覆盖幻觉拒绝、过时排除与实时接地。
