v0.6.8

🐛 Bug 修复

• fix: Windows 上 hooks 可执行位检查导致 doctor 误判未安装
  • Claude/Codex 适配器：fs.statSync().mode & 0o111 在 Windows 上始终返回 0，导致 hooks 检查失败。在 Windows 上跳过可执行位检查。
  • doctor 命令：continue 跳过了具体检查项的打印，用户看不到失败原因。改为先显示各检查项详情，再显示未安装摘要。

📝 文档

• 精简 README 结构，新建 ROADMAP.md

v0.6.7

v0.6.7 (2026-07-27)

Major

• 🆕 evokit update 命令 — 对已安装适配器执行升级安装，自动检测清单中的适配器，使用 upgrade profile 覆盖框架文件（hooks、rules、commands、agents、skills），保留用户数据（CLAUDE.md、MEMORY.md、memory/）
• 🔄 /review → /evokit-review — 将内置代码审查命令改名，避免与用户项目自定义命令冲突
• 🧹 移除冗余 Skills — 删除 code-review（与命令重复）和 debug（与规则重叠），保留 learning-recorder

Architecture

• 🏗️ AdapterInstallConfig 新增 profile 字段 — 支持 full / minimal / upgrade 三种安装配置
• 🔧 buildStandardLayout 根据 profile 动态调整策略 — upgrade 时认知核心/MEMORY.md 为 skip-if-exists、agents 覆盖 body + 合并 frontmatter、其余始终覆盖
• 🐛 修正 buildClaudeLayout upgradeMode 行为 — CLAUDE.md 从 always 改为 skip-if-exists，MEMORY.md 从 always 改为 skip-if-exists

Documentation

• 📖 README 同步 — 新增 evokit update 命令说明，更新 /evokit-review 引用

Internal

• 🧪 测试新增 12 个 — 覆盖 upgrade profile 文件策略（CLAUDE.md/MEMORY.md 保留、agents body 覆盖、hooks/rules/commands/skills 覆盖、seed-memory 保留、幂等性）和命令注册验证

影响范围

• 更新 template 中 hooks/rules/commands/agents/skills 文件会被覆盖，CLAUDE.md/MEMORY.md/memory/ 不受影响
• 若用户有自定义 /review 命令，需手动改为 /evokit-review 或保留自己的版本

v0.6.6

v0.6.6

适配器版本号更新

• Claude Code ≥ 2.1.220
• Codex CLI ≥ 0.145.0
• OpenCode CLI ≥ 1.18.4
• Pi CLI ≥ 0.82.0

交互式菜单描述修正

• 修正 README 中交互式菜单描述：从「输入数字多选」改为「↑↓ 导航 · 空格切换 · 回车确认」
• 预览区 UI 更新为 @clack/prompts multiselect 实际风格

其他改进

• adapter-spec.md: Pi CLI 状态修正为 ✅ Complete
• codex/pi adapter status 方法新增 memoryPresent 字段
• opencode adapter 补充 copyDirs 配置
• base-adapter buildStandardLayout 可见性改为 public
• CLAUDE.md 重组为中文精简版
• 中英文文档同步更新（README、INSTALL、MULTI_AGENT）

v0.6.5

修复

• 卸载确认逻辑缺陷 — 按 Esc/Ctrl+C 取消卸载确认时正确终止卸载流程
• 默认只安装全局配置 — evokit init/install 默认仅安装全局配置，项目级安装需显式指定 --project-dir
• doctor 检查去重 — 不再在 HOME 目录运行时重复检查全局和项目级配置
• BaseAdapter 重叠保护 — projectDir 与 homeDir 相同时自动跳过项目级安装

改进

• CLI 帮助信息补全 — evokit --help 显示完整命令说明、快速上手示例
• Pi 适配器补全 — 所有命令帮助信息中补全 pi 适配器

v0.6.4

修复

• 卸载确认逻辑缺陷 — 按 Esc 或 Ctrl+C 取消卸载确认时，@clack/prompts 的 confirm() 返回 cancel symbol（truthy），原代码仅检查 !shouldContinue 导致取消操作被忽略，卸载仍会执行。现已正确使用 isCancel() 处理取消场景，选 No 和按 Esc 均能正确终止卸载流程。

改进

• CLI 帮助信息补全 — evokit --help 现在显示完整的命令说明、快速上手示例和详细帮助提示，而非仅列出命令名和一行描述。

v0.6.3

v0.6.3 — 多适配器 bug 修复 + 种子文件 + 权限系统更新

🐛 修复

严重度	问题	修改文件
🔴 严重	purge 卸载未删除用户数据	src/core/uninstall-engine.ts
🔴 严重	卸载后 settings.json 残留	src/core/uninstall-engine.ts
🟡 中等	doctor 缺少 --project-dir 选项	src/commands/doctor.ts
🟡 中等	doctor checkMemory 逻辑反转	src/commands/doctor.ts
🟡 中等	轮转仅基于时间不基于行数	src/core/rotate.ts

✨ 新功能

• 各适配器新增 learned-rules.md / evolution-log.md 种子文件
• evolve 命令新增 --adapter 选项
• OpenCode 权限系统从 tools 迁移至 permission 字段
• merge-agents 支持深度合并 permission 配置

🧹 清理

• 移除测试残留文件及目录
• .gitignore 新增适配器安装实例规则

📚 文档

• 双语同步更新 ADAPTER_SPEC / PLAN_OPENCODE_ADAPTER

📦 升级

npm install -g @zythegit/evokit@0.6.3
evokit install --adapter claude,codex,opencode,pi --verify

v0.6.2 — permissions.allow 可选安装 + pre-tool-use.sh 可配置化

新功能

• --allow-workflow CLI 选项 — 安装时可选择合并 permissions.allow 工作流规则，让 npm test、npm run lint、shellcheck 等常规命令免确认
• pre-tool-use.sh 可配置化 — 拦截规则从 blocked-commands.json 读取，支持动态配置；jq 不可用时自动回退到硬编码规则
• 新建 blocked-commands.json — 拦截规则配置文件，安装时自动部署

改进

• mergeSettings 新增 allowWorkflow 参数，permissions.allow 合并策略与 hooks/env 一致（仅添加不覆盖）
• ManifestCollector 新增 recordPermissionAllow() 方法，清单可追溯
• 清单 permissionsAllow 字段恢复为正式字段
• UninstallResult 添加 permissionsAllowRemoved 计数
• 卸载时可精确移除安装时添加的 permissions.allow 规则

修复

• permissions 合并使用局部 permsChanged 变量，避免冗余写入
• pre-tool-use.sh jq 解析失败时正确回退到硬编码规则
• 拦截消息中文化
• 恢复 settings.json 中被误删的旧 permissions 规则

用法

# 标准安装（不写入 permissions.allow）
bash bin/install.sh

# 启用工作流免确认
bash bin/install.sh --allow-workflow

v0.6.1 — 修复卸载预览 BUG + 增强帮助信息

🐛 修复

• 卸载预览硬编码路径 BUG — evokit uninstall opencode 启发式模式下预览错误显示 ~/.claude/ 路径，现已根据适配器动态显示实际路径（如 ~/.config/opencode/）
• 卸载引擎循环依赖 — 适配器注册逻辑分离到 register.ts，executeUninstall 接受 adapter 实例参数避免通过 registry 查找
• 类型安全改进 — AdapterInstaller 接口新增 resolveHome() 和 getHeuristicConfig()，消除卸载引擎中的鸭子类型检查（as 断言）
• OpenCode 适配器启发式配置 — 覆盖 getHeuristicConfig()，返回 OpenCode 实际文件结构（opencode.json、agent/、skills/）

✨ 增强

• 卸载命令详细帮助 — evokit uninstall --help 新增卸载模式说明、选项详解、示例用法、卸载后指引
• 中文化输出 — buildPreview() 和 buildResultSummary() 输出从英文改为中文，与安装命令保持一致

📊 验证

• ✅ 类型检查通过
• ✅ 构建通过
• ✅ 259 个测试全部通过
• ✅ evokit uninstall opencode --dry-run 正确显示 ~/.config/opencode/
• ✅ evokit uninstall claude --dry-run 正确显示 ~/.claude/

完整变更: v0.6.0...v0.6.1

v0.6.0 — Codex/Pi 适配器完整集成

🚀 v0.6.0 — Codex/Pi 适配器完整集成

🤖 主要新功能

• Pi CLI 适配器完整集成（v0.6.0）

  • TypeScript 扩展系统：evokit-lifecycle、evokit-boot、evokit-evolve、evokit-memory、evokit-session
  • Agent Skills 标准支持
  • 完整模板文件（AGENTS.md、settings.json、skills/、agent/）
  • 生命周期事件自动处理（session_start、session_shutdown、tool_call）

• 双语 ADAPTER_SPEC 规范文档

  • 四个 CLI 适配器的官方规格摘要
  • 版本号、目录结构、生命周期事件、扩展机制

• BaseAdapter 基类 + 共享版本工具

  • 抽象安装管线，供子类继承
  • src/core/version.ts 提取 getEvokitVersion() 为统一入口

🐛 重要修复

• Pi 扩展路径硬编码 — 5 个 TypeScript 扩展使用 resolvePiHome() 替代硬编码路径，尊重 PI_CODING_AGENT_DIR 环境变量
• Claude Hook 脚本列表不完整 — CLAUDE_HOOK_FILES 补充 pre-tool-use.sh、post-tool-use.sh、pre-compact.sh

📖 文档同步

• FAQ：新增 Pi CLI 和 OpenCode 支持条目
• INSTALL：前置要求新增 Pi CLI 条目
• MULTI_AGENT：状态从"计划中"改为"已实现"
• README/README.en：路线图更新，Pi CLI 状态从存根改为完整支持
• CHANGELOG：新增 v0.6.0 条目

🧪 测试

• 265 个测试全部通过（16 个测试文件）
• 新增 claude-adapter.test.ts，扩展 codex/pi 适配器测试

📦 适配器版本

适配器	版本	状态
Claude Code	v0.2.0	✅ 完整支持
Codex CLI	v0.4.0	✅ 完整支持
OpenCode CLI	v0.5.0	✅ 完整支持
Pi CLI	v0.6.0	✅ 完整支持

完整变更见 CHANGELOG.md

v0.5.0

🚀 v0.5.0

✨ 新功能

• evokit project 命令 — 项目级规范生成，支持在当前项目中初始化 EvoKit 规范结构（路径规则、子代理、命令模板等）
  • 新增 src/commands/project.ts 和 src/core/project-generator.ts
  • 新增完整测试 tests/core/project-generator.test.ts

📖 文档

• 双语开发规范 DEV_STANDARDS.md — 新增 docs/zh/ 和 docs/en/ 双语平行版本
• 中文 AI 开发规范 — 新增 docs/zh/AI-DEVELOPMENT-STANDARDS.md（中文单语）
• CLAUDE.md 瘦身 — 将详细规则迁移至独立文档，保持认知核心精简

📐 路径规则

• 新增 .claude/rules/chinese-output.md — 中文优先输出规则
• 新增 .claude/rules/docs-sync.md — 文档同步规则
• 新增 .claude/rules/src-quality.md — 源码质量规则
• 新增 .claude/rules/template-redlines.md — 模板红线规则

🧪 测试

• 同步测试断言与中文化错误消息

📊 变更统计

• 18 个文件变更，+1518 / -25 行