在执行之前，拦住危险动作。
可观测工具只会告诉你「Agent 删了什么」——等它删完。TraceGuard 站在工具调用的执行路径上，在动作发生之前就把它拦下来。本地运行、零联网、确定性判断。
pip install ai-traceguard复制
# 在工具执行之前 from traceguard import TraceGuard guard = TraceGuard(policy="policies/base.yaml", mode="strict") decision = guard.check("delete_file", {"path": "/data/users.csv"}) if not decision.allowed: raise PermissionError(decision.reason) $ traceguard test delete_file: BLOCKED read_file: ALLOWED
事后记录，不等于事前阻挡。
任何一套可观测 / 追踪工具都能帮你回放「Agent 把表删掉的那一秒」——但没有一套能阻止那一秒发生。
可观测 / 追踪工具
调试很好用。但当一条 span 被记录下来时，生产库已经没了，API Key 已经躺在某个 webhook 里了。
TraceGuard
在进程内、在工具调用路径上做确定性策略判断。动作在发生之前就被拒绝，并把这次裁决写进防篡改审计链。
三行接入。零基础设施。
包住你的工具
在每个工具函数的最前面调用 guard.check(名称, 参数)，早于任何副作用。
确定性判断
静态风险 + 策略规则决定放行或阻断。判断路径里没有模型，所以不会有「它应该没事吧」的幻觉。
可验证地记录
每次裁决都用 SHA-256 链接。`traceguard verify` 能证明它没有被改过。
开源核心人人可用，硬核能力留给生产环境。
MIT 核心本身就能用；Pro 才是受监管团队和生产团队真正会掏钱的部分。
✓ 执行前拦截 核心
按工具名与风险等级，在副作用发生前阻断。
✓ SHA-256 审计链 核心
防篡改、可本地复核的裁决日志。不依赖任何服务器。
✓ 策略包 核心
开箱即用模板：防删除、防 Token 暴走、防数据泄露。
✓ 参数级敏感信息扫描 Pro
抓出工具参数里的 api_key、password、private_key 与 PII。
✓ 预算与死循环拦截 Pro
掐断烧光 Token 的会话和卡住反复重试的 Agent。
✓ 可校验审计导出 Pro
JSONL 导出，任何第三方都能独立重算哈希链。
✓ 行业策略包 Pro
金融 / 医疗 / DevOps 的敏感词与预算预设。
✓ 人工审批流 Team
中风险调用改为人工审批，而不是静默放行。
✓ 企业版 Ent
自定义策略包、签名导出、气隙支持、SLA。
数据永远不出你的机器。这是设计本身。
- ✓无网络请求。 拦截层从不联系外部服务器，因此没有可被拦截、泄露或审查的东西。
- ✓无模型 API。 不代理、不转售、不路由任何模型调用。
- ✓只存本地 SQLite。 审计数据属于你，句号。
- ✓离线授权。 气隙环境可用——授权码本身就是自包含、防篡改的凭证。
几个诚实的回答。
TraceGuard 会把东西发到网上吗？
不会，一个请求都不会。拦截层是运行在你进程里的确定性代码，审计链是一个本地 SQLite 文件。这条红线写在项目自己的护栏里，也写在 SECURITY.md。
和云端护栏 API 有什么区别？
云端 API 会引入网络延迟，要求你的 prompt 与数据离开本机，还需要过一次数据合规审查。TraceGuard 在进程内，这些成本都不存在——而且能在气隙环境里跑。
为什么判断要用确定性逻辑，而不是模型？
因为「模型觉得应该没事」不是安全评审能接受的答案。策略规则 + 静态风险给出的是每次一致、可逐条解释的判断。
没有服务器，授权怎么管？
授权码用 HMAC-SHA256 签名、本地验签。你拿到一串 key，包在本地校验——没有激活请求、没有席位服务器、没有遥测。
要改我的 Agent 框架吗？
不用。TraceGuard 不依赖任何框架，你在工具函数开头调用 guard.check() 即可——MCP、LangChain、LlamaIndex、CrewAI 或你自己的循环都行。
选好版本 → 扫码付款 → 24 小时内收到授权码。
离线授权，本地激活。不需要账号、不需要服务器、不需要备案。
参数级密钥 / PII 扫描 · Token 预算与死循环拦截 · 可校验审计导出 · 金融 / 医疗 / DevOps 行业包
含 Pro 全部能力 + 人工审批流 + 席位报表 + 优先支持
自定义策略包 · 签名审计导出 · 气隙 / 本地化部署支持 · SLA 与合规报告
pip install ai-traceguard），需要了再升 Pro。未授权时 Pro 会优雅降级，不影响核心功能。