用途
Mantyl 是一个本地优先的命令行工具（CLI），用于 AI 代码交接。它解决的是：使用编码智能体构建的软件，其知识往往集中在脆弱的角落——会话记录、被丢弃的提示词以及操作者的记忆中。当这类项目需要转手时，接收方通常只能拿到源代码和口头保证。Mantyl 用可检查的记录替代这些保证，生成一份接收方可独立核验的项目护照。
主要能力
- 读取仓库及其编码智能体历史（Claude Code、Cursor、OpenAI Codex CLI），提取声明与决策。
- 生成护照（passport），描述：软件包含什么、如何运行、构建期间做出了哪些决策、哪些内容已由执行证明、哪些仍然未知。
- 每个声明、决策、风险和设置步骤都附带八种状态之一，底层规则是：解释永远不能升级为证明。LLM 可以解释，但绝不能将任何内容标记为已验证；与代码相矛盾的声明会被呈现为矛盾，并指明证据，绝不隐藏。
- 输出物存放在 .mantyl/ 目录：passport.json（规范且带摘要戳的契约）、可读的 HTML 与 Markdown 报告，以及每条陈述背后的证据文件。
- 所有处理均在本地进行。除非显式执行发布命令，否则不会上传任何内容；所有转录文本在存储或分析前都经过失败关闭式（fail-closed）密钥脱敏。
- 提供接收方验证命令：重新计算护照摘要、对交付文件进行指纹识别、比较提交，并在接收方自己的沙箱中重新执行记录的检查。任何偏差都会被精确指出，并以非零状态退出。
使用方式
需要 Node 20.12+。Docker Desktop 是完整结果的前置条件：它驱动沙箱验证，护照最强的证据来源于此；没有 Docker 时，检查会被如实记录为跳过。读取 Cursor 历史需要 Node 22.13+。仓库中包含完整的 CLI，运行在本机的所有内容均公开可审计。托管护照服务与 Mantyl Verified 签名基础设施位于独立的私有代码库，签名密钥不会随任何客户端分发。护照格式本身是开放的，模式位于 mantyl.dev/schemas/passport-v1.json。
完整文档位于 mantyl.dev/docs，包括快速入门、支持的智能体、真实模型、带稳定退出码的命令参考以及发布。工具背后的推理见 mantyl.dev/manifesto。支持智能体的存储布局详情见 mantyl.dev/guides。
适用场景
适用于将 AI 构建的软件交付给他人、需要提供可验证交接材料的场景。生成方与接收方均可独立核验。该仓库本身即为其自身生成护照并经独立重执行验证的证明。测试套件包含确定性门（两次运行必须产生逐字节相同的护照）和密钥泄露门（夹具中植入的凭据绝不能到达任何产物）。沙箱集成测试在无 Docker 守护进程时自动跳过，并在 CI 中运行。
限制
- 完整沙箱验证依赖 Docker Desktop，无 Docker 时检查被记录为跳过。
- 读取 Cursor 历史需要 Node 22.13+。
- 托管护照服务与签名基础设施为私有代码库，不在本仓库中。
- Mantyl 输出为证据支撑，而非认证（not a certification）。
- 本资料未提供具体收费信息，仅说明采用 MIT 许可。
