English · 中文

🧠⚡ EvoKit

项目上下文引擎 — 让 AI 秒懂项目

持久化 AI 不可能知道的项目/个人专属知识

EvoKit 是一个开源的项目上下文引擎，专为 AI 编程助手设计。它从对话中提取项目知识、构建可检索索引、自动检测过期信息——让 Claude Code、Codex、OpenCode 等 AI 工具秒懂你的项目，无需每次从零开始。

| 核心能力 | 说明 | | ------------------- | -------------------------------------------------------- | | 💬 对话提取 | 从自然对话中自动提取项目知识，无需手动编写 | | 📇 知识索引 | 构建结构化索引，AI 按需检索，精准命中上下文 | | 🕐 过期检测 | 自动标记过时知识，避免 AI 使用失效信息 | | 🚚 一键迁移 | 跨机器无缝迁移学习数据 | | 🔒 隐私优先 | 所有数据本地存储，无云端、无遥测 | | 🤖 多智能体 | 适配器架构，支持 Claude Code / Codex / OpenCode / Pi CLI |

快速开始

前置条件

• Claude Code ≥ 2.1.220（或其他支持钩子/工具的 AI 编程助手）
• bash 4.0+（Linux / macOS / WSL / Git Bash）
• Node.js ≥ 20.12.0

安装

# npm 安装（推荐）
npm install -g @zythegit/evokit
evokit init

# Homebrew 安装
brew tap zyTheGit/homebrew-evokit
brew install evokit

# 一行命令安装（交互式选择适配器）
curl -fsSL https://raw.githubusercontent.com/zyTheGit/EvoKit/main/bin/install.sh | bash

安装时可通过交互式菜单选择适配器：

| 适配器 | 安装目录 | | ---------------- | ---------------------- | | Claude Code | ~/.claude/ | | Codex CLI | ~/.codex/ | | OpenCode CLI | .opencode/（项目级） | | Pi CLI | ~/.pi/agent/ |

也支持 --adapter claude,codex 参数跳过菜单（适用于 CI 自动化）。

升级

已安装 EvoKit 的老用户，新版本发布后更新模板文件：

evokit update        # 更新所有已安装适配器

update 会自动覆盖框架文件（hooks、rules、commands、agents、skills），保留用户数据（CLAUDE.md、MEMORY.md、memory/）。

CLI 命令

evokit init         初始化安装
evokit update       升级模板文件
evokit migrate      从 v0 迁移到 v1.0
evokit doctor       系统健康检查

验证

启动 AI 助手，运行：

/evokit-boot

内置命令

安装后在 AI 助手内可用以下斜杠命令：

| 命令 | 运行时机 | 功能 | | ---------------- | ------------- | ---------------------------- | | /evokit-boot | 每次会话启动 | 验证系统完整性 | | /evokit-learn | 对话结束后 | 提取知识、检测过期条目 | | /evokit-review | 提交代码前 | 通过审查员智能体进行代码审查 |

适配器版本

| 适配器 | 版本 | 助手版本兼容 | | ---------------- | ------- | ----------------------------- | | Claude Code | v1.0.0 | Claude Code ≥ 2.1.220（CLI） | | Codex CLI | v0.4.0 | Codex CLI ≥ 0.145.0（OpenAI） | | OpenCode CLI | v0.5.0 | OpenCode CLI ≥ 1.18.4 | | Pi CLI | v0.6.0 | Pi CLI ≥ 0.82.0 |

文档

| 文档 | 说明 | | ------------------------------------------ | ------------------------ | | ARCHITECTURE.md | 四层架构深度解析 | | EVOLUTION.md | 进化流水线详解 | | INSTALL.md | 跨平台安装指南 | | MIGRATION.md | 跨机迁移指南 | | CUSTOMIZE.md | 自定义规则、智能体、命令 | | MULTI_AGENT.md | 多智能体适配器架构 | | FAQ.md | 常见问题 | | ROADMAP.md | 路线图与规划 |

贡献

欢迎贡献代码！请阅读贡献指南。

更新日志 · 路线图 · 贡献指南

许可证

MIT © 2026 EvoKit Contributors

用 ❤️ 为开源 AI 生态构建。