用途:verify-paperclip 用于验证 Paperclip,可从源码检出、已发布的 npm 安装,或现有预发/生产环境进行。开始前需明确验证目标,普通功能开发默认使用当前主机上的当前检出与隔离数据,仅在需要时扩展到跨平台或发布资格验证。
主要能力:按独立维度记录验证信息,包括制品(源码检出的路径、提交、脏状态;npm 包渠道与解析版本;部署镜像/发布)、环境(本地、预发、生产;目标 URL、公司/工作区、身份与认证方式)、起始数据(全新未引导、新播种、克隆或复用;内嵌或外部 PostgreSQL)、平台(服务器 OS/架构、Node/npm 版本、浏览器 OS)、旅程(首次安装/引导、既有用户功能、升级或实时智能体运行)。
使用方式:从仓库根目录运行,需 Node 24.11+、Python 3、lsof,并用 pnpm install --frozen-lockfile 安装依赖。创建独立的数据与证据目录后,用 python3 .agents/skills/verify-paperclip/scripts/launch.py --data-dir "$VERIFY_DATA_DIR" --evidence-dir "$VERIFY_EVIDENCE_DIR" 启动空实例;随后用 doctor.py --evidence-dir 做只读体检,用 onboarding-smoke.mjs --evidence-dir 执行引导冒烟,最后用 stop.py --evidence-dir 停止。浏览器驱动使用现有 @playwright/test 依赖。
适用场景:源码行为验证、首次运行引导、npm 安装验证、预发/生产托管验证、API/智能体访问证明等。
限制:验证请求本身不授权部署、npm 发布、舰队默认变更或生产发布;空数据不等于全新安装,播种测试不能证明引导,源码构建不能证明 npm 打包,预发通过不能证明生产。不得记录凭据或连接字符串,不得伪造 launch.json,不得按进程名杀进程。资料未提供具体收费、价格或平台支持范围。