punchtape 是一款开源的 AI 编码智能体外部仲裁状态机,由独立开发者团队 neurophant 于 2026 年 9 月发布。它要解决的核心痛点是:AI 写完代码就宣称「做完了」,而验证的工作永远落在人身上。punchtape 以「外部第三方」身份站在项目旁边,把你的任务原话逐行记录为验收标准,机器亲自运行每一条真实检查、逐字节比对输出,AI 无法自我宣布完成——只有全部检查通过,它才会记录一个带校验和的 done: true。它支持 Cursor、Claude Code、Codex CLI 等任何带 shell 的智能体,不依赖特定模型,完全离线运行,数据全部留在本地 .punchtape/ 目录。其字段实验(25 项真实任务、独立盲评)显示:使用后人工式验收从每 25 项 32 次降到 2 次,人工验证时间从约 4.4 至 7.3 小时缩至 0.8 至 1.3 小时,25 项任务全部一次提交通过。

功能特点
-
外部事务状态机:不是 harness 也不是插件,作为独立第三方持有任务的状态、词语、事实与完成记录
-
原话即法律:任务原话逐行写入 demands.md,AI 不得转述或篡改你的要求
-
机器自跑检查:每条验收是真实命令加精确输出,程序亲自运行并逐字节比对,从不询问 AI
-
done: true 须被赢得:全部检查通过后,程序复核一切并记录带校验和的完成凭证
-
全程留痕:每个任务、每句话、每次检查结果都写入本地 .punchtape/ 目录,复制文件夹即带走全部历史
-
任意智能体兼容:IDE(Cursor、GitHub Copilot)或终端(Claude Code、Codex CLI)皆可,任何语言任何框架
-
一行接入:向 AI 粘贴一行 Bootstrap 指令,助手自动安装配置,无需学任何命令
优缺点
-
优点:把验证工作从人转移到机器,实测人工式验收从 32 次降到 2 次、验证时间缩短约八成;完全离线免费,无账号无云端,隐私可控;MIT 开源,可审计、可复现、可二次开发;实测 25 项任务全部一次提交通过
-
缺点:目前仅支持 Linux 与 macOS,暂无 Windows 版本;主要面向编码与自动化场景,非编码任务收益有限;项目较新,社区生态与知名度尚小;需要用户至少会用终端粘贴一行安装命令
主要应用场景
-
AI 编码验收:让智能体修复缺陷、开发功能,机器验证全部通过后才算完成
-
自动化数据处理管道:采集、清洗、转换每步记录校验证据,避免失败却被标记完成
-
离线合规环境:在无外网的内网运行智能体,要求可审计、可复现的场景
-
多智能体与多技术栈团队:统一任务状态与完成标准,降低集成与验收成本
使用方法
-
准备一台 Linux 或 macOS 电脑,以及你的 AI 助手(Cursor、Claude Code、Codex CLI 等均可)
-
打开任务所在文件夹,向 AI 粘贴一行 Bootstrap 指令,助手自动安装 punchtape 并完成全部配置
-
用大白话描述任务(新项目或既有仓库均可),AI 把你的原话写成验收标准并为每项行为编写真实检查
-
AI 开始工作,punchtape 自动运行每条检查、指出期望与实际的差距、驱动 AI 修复,直到全部通过
-
全部通过后程序记录带校验和的完成凭证,你只需阅读结果,无需亲自检查任何东西
收费标准
-
完全免费,MIT 开源许可
-
无账号、无云端、无订阅,可完全离线运行
-
支持 Linux 与 macOS,单个二进制文件即装即用
相关导航
暂无评论...
