ClaimGate starter kit - set up a publish gate

ClaimGate

AI 辅助营销内容的发布闸门。

将你准备发布的文案和组织实际掌握的证据交给它。它会告诉你哪些声明无法证实、违反了哪些内部政策规则，以及内容是否缺少法律现行要求的披露信息。

退出代码 1 表示阻止发布。因此，它可用于 CI、提交前钩子或发布流水线——在这些环节，闸门能阻止错误，而不是事后记录错误。

$ claimgate check campaign.md --evidence substantiation/ --policy policy.json

Claims requiring substantiation (14)
  ✗ [attribution] According to research at a leading university, 94% of finance teams waste more
      unsupported: the figure(s) 94% in this claim do not appear in any supplied evidence
  ✗ [statistic] thousands of businesses, and we are fully ISO 27001 certified.
      contradicted: evidence states "Acme Invoicing is not certified under ISO 27001"
  ~ [statistic] Meridian Freight cut their reconciliation time from 22 hours to 9 hours a week
      partially_supported: the case study confirms 22 hours and 9 hours, but not "always"
      try: Meridian Freight's finance team reduced reconciliation from 22 hours a week to 9

Policy findings (3)
  ✗ [prohibited] guaranteed
      absolute guarantees are unenforceable and are treated as misleading advertising
  ✗ [disclosure] AI disclosure missing
      required under EU AI Act Article 50 (in force 2 Aug 2026) and platform labelling rules

BLOCKED — 14 unsupported claim(s), 3 blocking policy finding(s).

为什么要做这个工具

如今，大量营销文案都由生成式 AI 撰写，但相应的管控措施并未同步扩展。2025–2026 年反复出现的发现并不是模型不擅长写作，而是审核人员无法分辨幻觉数据和真实数据——两者没有任何语法信号可以区分——因此，随手一读就会让幻觉内容蒙混过关。那些在没有审核闸门的情况下扩大 AI 内容规模的组织，并没有降低内容风险，而是加速了风险的扩散。

现有工具无法解决这个问题。检测器只能告诉你文本是由 AI 撰写的，但这并非关键问题。生成器只会产出更多文案。治理平台则要等到季度末才告诉你发生了哪些事件。

ClaimGate 回答的是决定内容能否发布的实际问题：这项具体声明能否追溯到我们可以明确指出的依据？

三项检查

1. 证据支持。 提取草稿中的每项可核实声明，再根据你的证据进行判定。关键在于判定方式：

• 声明中的数字必须出现在证据中。这是字符串搜索，不是主观判断，任何模型都不能推翻结果。编造的数据无法靠说服让它通过。
• 语义支持由模型判定，模型只会收到声明和证据，必须指出所依据的证据，也可以回答 unsupported 或 unverified。
• 如果模型不可用、缺少密钥或回复格式有误，判定结果就是 unverified，也就是阻止发布。系统绝不会倾向于判为“有支持”。

2. 政策。 将禁止和受限声明一次性写明，并在每份草稿中执行：保证性承诺、医疗和金融声明、无来源的最高级表述、具名竞争对手、个人数据。

3. 披露。 自 2026 年 8 月 2 日起，《欧盟 AI 法案》（第 50 条）要求在特定情况下披露 AI 生成的内容；Meta、TikTok 和 Google 也都要求在广告中的逼真合成媒体上标注 AI。面向客户的 AI 辅助内容若未披露，即使文案再好也不合规——因此，披露会作为草稿的一项属性进行检查，而不会交由上传者自行处理。

安装

无依赖项。Python 3.9+。

pip install "claimgate @ git+https://github.com/caseone115/claimgate"

这不是一个可直接运行 pip install claimgate 的包。 PyPI 上的这个名称属于另一个无关项目（一个 AI Agent 测试工具），因此直接安装会装上那个工具，而它并不提供 claimgate check。本产品通过自己的源代码仓库安装，该仓库也包含其许可证和测试。在检出代码后，pip install -e . 的效果相同。

从这里开始：免费入门套件

claimgate init my-project && cd my-project
claimgate check DRAFT-template.md --evidence evidence/ --policy policy.json --no-model

这会创建一个可编辑的政策文件、一个证据文件夹、一个空白草稿模板、一份包含六个问题的发布前检查清单（包括 AI 披露部分），以及一个用于拦截每个拉取请求的 GitHub Actions 作业。--no-model 无需 API 密钥或网络连接：它会运行确定性检查，也确实能发现编造内容——如果草稿中出现了证据里没有的数据，无论是谁写的，都会被拦截。

该套件免费，并会一直免费：https://github.com/caseone115/claimgate。

完整引擎——对每项声明进行模型判定、为流水线提供 JSON 输出，以及完整测试套件——需一次性下载，地址为 https://teeterbot.gumroad.com/l/claimgate/LAUNCH39：发布活动期间售价 39 美元，之后为 149 美元。它与本仓库中的代码完全相同，采用 MIT 许可证；源代码中没有任何保留未公开的部分。

使用

claimgate init my-project                  # the free starter kit
claimgate init-policy policy.json          # a starter policy to edit
claimgate claims draft.md                  # just list the claims
claimgate check draft.md --evidence ./evidence/
claimgate check draft.md --evidence evidence.json --policy policy.json --json
claimgate check draft.md --no-model        # facts and policy only, no API calls

证据可以是包含 .txt/.md/.html 文件的任意目录，也可以是 JSON 数组：

[{"id": "spec", "title": "Product spec", "text": "..."},
 {"id": "case-1", "title": "Meridian case study", "url": "..."}]

设置 DEEPSEEK_API_KEY 以进行裁定。没有它，--no-model 仍会运行确定性检查——虚构数字保障正是由此实现的。

本工具不是什么

• 不是事实核查工具。 它不会搜索网络，也不会判定什么是真实的。它会根据你提供的证据，判断你能否证明自己写下的内容。这正是合规审查实际要提出的问题，也是唯一一个不假装拥有工具并不具备的权威性就能回答的问题。
• 不是检测器。 它不会猜测文本是否由 AI 撰写。
• 不是律师。 它会执行你编写的政策。它会标出 AI 披露义务似乎适用的情况，但不会提供法律建议。

从 MCP 客户端使用

同样的检查也可作为 MCP 服务运行，因此 Agent 可以在发布草稿前进行审核，而不必依赖人工记得去做。mcp/server.py 无需安装——uv 会获取它唯一的依赖项。在客户端配置中添加以下内容：

{
  "mcpServers": {
    "claimgate": {
      "command": "uv",
      "args": ["run", "--directory", "<repo>/mcp", "<repo>/mcp/server.py"]
    }
  }
}

它提供 check_draft、check_draft_json、list_claims、check_policy_only 和 about。请参阅 mcp/README.md，了解它刻意拒绝执行的操作。

免费入门套件是另一个注册表条目 io.github.caseone115/claimgate-kit。init_kit 会将政策文件、证据文件夹、检查清单和 GitHub Actions 作业写入你指定的目录；随后 check_kit 会在离线且无需 API 密钥的情况下运行该审核关卡。请参阅 mcp-kit/。

测试

python tests/test_claimgate.py     # 55 checks — the engine
python tests/test_outreach.py      # 21 checks — the outreach guardrails
python tests/test_kit.py           # 44 checks — the starter kit
python scripts/test_mcp_server.py  # 19 checks — the MCP server, over real stdio

测试套件依据产品承诺编写，而非依据其实现：不捏造任何声明；证据中没有的数字绝不会被报告为有证据支持；任何无法核查的内容都会阻止通过；相同输入始终得到相同答案。tests/test_kit.py 还会使用随附的政策检查随附的 README，因为对一个声明核查产品来说，没有什么演示比自家首页包含违规声明更糟糕。

许可证

MIT。