Delimit 是一个围绕 API 治理与 AI 辅助代码合并门禁构建的开发者工具集,主要面向需要在 CI/CD 流程中控制 API 变更风险、并对 AI 生成代码进行可审计治理的团队。
一、用途 Delimit 的核心用途是检测 OpenAPI/Swagger 规范版本之间的破坏性变更,并依据可配置的策略规则给出结构化的通过/失败判定。它同时提供针对 AI 辅助代码的合并门禁与本地签名证明,帮助团队在合并前捕获 API 破坏性变更、泄露密钥等问题,并保留可离线验证的证据。
二、主要能力
- 零配置 PR 安全门禁:delimit check 无需 init、无需设置、无需账户、无需密钥,可在任意仓库上运行,对暂存或修改的文件应用确定性检查(破坏性 API 变更 + 泄露密钥)。当检查发现破坏性变更或泄露密钥时,会打印违规文件与问题并以非零状态退出,可直接用于 pre-commit 钩子或 CI 步骤。
- 记录与证明:--record 选项将检查的内容固定记录写入 .delimit/records/check-<ts>.json(或指定路径),该记录是签名、可重放 Seal 证明的前身,证据形态相同,并固定到所检查的确切内容。
- 合并门禁端到端流程:lint 规范变更(基线 vs 提议,应用策略,给出单一通过/失败判定);纯结构差异展示具体破坏点(新增/删除/修改的端点、模式、参数,不含策略);确定性分类版本号变更(MAJOR/MINOR/PATCH/NONE,相同输入始终相同答案);当门禁判定属于主观判断时,交由多个模型辩论至共识;在门禁事件(部署/安全/测试/审计)后记录证据包并可随时验证。
- 签名与离线验证:每次包装运行都会生成本地 delimit.attestation.v1 包,包含仓库前后 HEAD、变更文件、门禁结果以及 HMAC-SHA256 签名。可使用 delimit seal-verify 离线验证;托管重放暂不可用。默认仅建议,可切换为强制执行。
- delimit wrap:将 claude -p、cursor、aider、codex 或任何 AI 辅助 CLI 通过签名治理门禁运行。快照前后 git diff,运行 lint + 测试,HMAC 签名生成 att_* 证明,并将回执写入本地以供离线验证。默认建议模式;--enforce 在策略违规时阻止 CI;--max-time <s> 是终止开关,会将证明标记为 liability_incident 并打印跨模型交接命令。
- 跨会话与跨模型上下文:决策、约束和任务跨会话持久化,可在 Claude Code、Codex、Cursor、Antigravity、GitHub Copilot 或 Muse 中继续使用保存的记录。Memory 持久化并回忆“为什么”而非仅差异;Ledger 提供跨所有助手和会话共享的单一任务列表。
- 其他命令:delimit trust-page 将证明目录渲染为静态 HTML 信任页面 + JSON Feed 1.1 订阅源(单文件、无框架、可离线渲染、可部署到任何地方);delimit ai-sbom 将证明聚合为 CycloneDX 1.6 物料清单,包含 AI 特定字段(按供应商检测到的模型、工具调用面、策略门禁计数);delimit doctor 检查本地设置并建议修复(支持 --ci 和 --fix);delimit simulate 策略试运行;delimit status 可视化终端仪表盘;delimit report 治理报告(--since 7d --format md|html|json);delimit think 使用已配置提供商进行多模型审议;delimit build 启动分离的规划工作进程检查仓库并撰写简报(不执行 ledger 任务);delimit vault 以仅所有者可读(0600)的明文 JSON 文件存储密钥。
- 多模型审议:将问题同时交给 4 个 AI 模型,它们相互辩论直至一致同意。审议使用已配置的模型 CLI 或 API 密钥,提供商可用性取决于用户设置。
三、使用方式 最快上手路径是 delimit check:在任意仓库运行,无需初始化或账户。Golden Path 建议:scan(delimit_scan)报告 Delimit 能为该仓库做什么;init(delimit_init)放入策略预设和合并门禁配置,无需账户和密钥。随后可运行门禁 lint、结构差异、版本号分类、多模型审议、记录签名证明。证明可通过 npx delimit-cli seal-verify <receipt.json> 离线验证。
四、适用场景 适用于需要在合并前捕获 API 破坏性变更的团队;需要在 CI 中对 AI 辅助代码调用进行治理并保留可审计回执的场景;需要跨 Claude Code、Codex、Cursor、Antigravity、GitHub Copilot、Muse 等工具保持会话上下文与交接的场景;需要生成信任页面或 AI 物料清单以供采购/合规使用的场景。
五、限制 托管回执重放暂不可用;证明需离线验证。多模型审议的提供商可用性取决于用户配置。Muse 和 Copilot 是原生交互式 harness,不是新的模型投票或自动构建循环后端。二进制发现目前仅支持 Copilot 在 ~/.local/bin、/usr/local/bin 或 /usr/bin,以及 Muse 的版本化 ~/.local/bin/muse-bin-<version>-R<revision> 分发;其他安装布局不会自动发现。Muse 原生上下文设置已用 Muse Code 1.2.1 检查,升级客户端时需重新检查兼容性。启动文本合计必须不超过 16 KiB;项目 AGENTS.md / CLAUDE.md 文件达到或超过 64 KiB 会被拒绝而非静默截断。Delimit 不安装官方客户端、不购买计划、不登录、不验证订阅额度。