$ cat ~/map/zenpi.md

ZenPi

极简自改进 harness：重复摩擦沉淀为证据，一次一个人工批准的最小改进。

tools✓ 10月16日

git clone --branch v0.8.1 --depth 1 https://github.com/TannerMidd/ZenPi.git && cd ZenPi && ./zenpi install

## 速览

围绕 pi 编码 agent 的极简自改进 harness——把经过隐私最小化的本地摩擦信号记录下来、加以甄别，再通过 /harness-improvement 循环逐条转化为一次经人工批准、可验证、可回滚的改进。

## 要点

• $靠证据生长，而非靠堆积：当真实、可复用的能力缺口挡路时，ZenPi 记录一条经清洗、有界、按任务去重的本地信号，衡量复现频率与影响面，然后给人一个明确的下一步改进——采集默认关闭、需显式开启，报告从不上传。
• $/harness-improvement 打开一个菜单，列出已甄别与待复核的条目；选中一条即明确授权这一次「最小够用」的改进，由 zenpi-improve 技能检视证据、实现最窄干预并直接跑验收检查。
• $完成门会校验注册表集成，运行 npm run check 与受支持的封闭验证器，全部通过才让条目退役——每次退役都保留证据、门禁与变更文件；检查失败则条目保持选中，后续摩擦会把它重新送回复核菜单。
• $新增 /zen（专注执行模式）、/files（浏览文件、看 diff、留评审注释）、/zen-subagents（记住你偏好的 subagent 配置），以及私有的 /wishlist——含 status、history [gap-id] 与循环健康报告（退役数、重开率、待复核数、退役耗时）。
• $命令守卫在执行前分析每一条模型发起的命令，可选 Guard、Strict、Off 三种模式——Guard 直接拒绝确定的整机级灾难操作，Git 有破坏性操作前先询问；批准精确到单次调用且仅限当前会话，关键尝试会锁定会话直到人工复核，/guard 随时切换模式。
• $需要 Node.js 22.19+、npm 与 Git；若尚未安装 pi（0.84.4+），安装器会代为装好。./zenpi plan 只预览不改动，./zenpi install 先确认再安装，./zenpi doctor 复核托管状态并重跑能力验证器；一切皆有备份、可回滚。

## 常见问题

## 参考链接

• README ↗
• Wiki ↗
• 展示页 ↗

最后更新: 2026年8月31日