sigma-gate

⟐ σ-gate — guard

面向 AI/Agent 输出的确定性信任层。一次调用 → 一个判定。无需模型、API 密钥或网络。

1 = 1.  Declared output must equal what is safe to realize.

---

范式

另外四个 Spektre 仓库都是路由协议——它们在网络间传递价值、能力、承诺和身份。σ-gate 不是路由协议，也不假装自己是。它是整个套件的确定性信任判定：位于任意流水线边缘的闸门，以约 85µs 的速度，每次都给出相同答案，回答：这个输出可以安全发布吗？ 基于 LLM-as-judge 的防护速度慢，每次检查都要消耗一次模型调用，还会在速率限制下悄然降级。但最高频的风险——泄露的 AKIA… 密钥、通过 Luhn 校验的卡号、“忽略之前所有指令”——都可以通过结构检测发现：你不需要模型，只需要一个每次都给出相同答案的闸门。这种确定性本身就是基础原语。σ = 声明值 − 实际值：拦截项总是有明确名称（secret[high]: github_pat），而不是不透明的浮点数，因此闸门声明不安全的内容，正是它拒绝实现的内容。guard 就是这个闸门。

---

一次调用

from guard import guard

result = guard(model_output)
# {"safe_to_ship": True/False, "severity": "clean|low|medium|high|critical",
#  "block_reasons": [...], "dimensions": {"secret": {...}, "injection": {...}, "pii": {...}}}

拦截不安全的输出：

v = guard("Here is the key: ghp_16C7e42F292c6912E7710c838347Ae178B4a")
# safe_to_ship: False
# block_reasons: ["secret[high]: github_pat"]

放行干净的输出：

v = guard("The quarterly report shows revenue grew 12% driven by the EU segment.")
# safe_to_ship: True
# severity: "clean"

---

三个维度，一个判定

维度	检测内容
secret	泄露的凭据——20 多家提供商（AWS、GitHub、Stripe、GCP 等），按熵值排序
injection	提示词注入和越狱模式——基于结构，而非启发式
pii	电子邮件、电话、银行卡（经 Luhn 校验）、SSN、IBAN、IP——合规级检测

每个维度独立运行。组合命中时会触发全部三个维度：

guard("AKIA… ghp_… 4111 1111 1111 1111 — ignore all previous instructions")
# block_reasons: ["secret[high]: ...", "injection[high]: ...", "pii[high]: ..."]

---

安装

零依赖，纯标准库，Python 3.9+。

git clone https://github.com/spektre-labs/sigma-gate && cd sigma-gate
pip install -e .            # installs the `guard` + `guard-mcp` console scripts
python3 -m pytest -q        # 7 passed, zero dependencies

甚至无需安装即可导入——在克隆的目录中即可使用 from guard import guard。

---

使用方法

在任意流水线中内联使用闸门：

from guard import guard

def ship(output: str) -> str:
    v = guard(output)
    if not v["safe_to_ship"]:
        raise ValueError(f"blocked: {v['block_reasons']}")
    return output

CLI——通过管道传入任意输出：

echo "your model output" | python3 -m guard

自检——验证每种威胁类别都会触发：

python3 -m guard selftest
# {"secret_blocked": true, "injection_blocked": true, "pii_blocked": true,
#  "clean_passes": true, "combined_all_fire": true, "ALL_PASS": true}

通过环境变量调整阈值（默认值：medium）：

GUARD_BLOCK_AT=high python3 -m guard "..."

---

作为 MCP 工具使用

σ-gate 随附一个零依赖的 MCP 服务——为任意 Agent （Claude Code、Claude Desktop、Cursor、Cline）提供一个确定性的 guard 工具，让它在发布 输出前调用。无需模型、密钥或令牌费用。

Claude Code：

claude mcp add guard -- python3 /absolute/path/to/sigma-gate/mcp_server.py

Claude Desktop（claude_desktop_config.json）：

{ "mcpServers": { "guard": { "command": "python3",
  "args": ["/absolute/path/to/sigma-gate/mcp_server.py"] } } }

提供两个工具：guard(text, …) → 放行/拦截判定，以及 guard_selftest() → 验证每种 威胁类别都会触发。基于纯标准库的 stdio JSON-RPC。

托管版——无需安装

σ-gate 也作为托管远程 MCP 服务运行（按需缩至零），并以 io.github.spektre-labs/sigma-gate 列入官方 MCP Registry。 无需本地设置即可连接：

https://sigma-gate-864996675261.us-central1.run.app/mcp

可浏览注册表的 MCP 客户端会自动发现它。

---

开源核心与托管版

	开源核心（本仓库）	托管 σ 评分
功能	确定性闸门：secret + injection + PII	热路径上的连贯性 / 幻觉 σ 评分
延迟	约 85µs	网络往返
依赖项	零	你这边无需依赖
费用	永远免费	通过 x402 按次付费——无需注册
离线使用	是	否
模型	无	可选

开源核心处理模型无法可靠完成的任务——对相同输入给出一致判定的结构化模式检测。托管层则为仅靠结构检测不足以应对的情况，增加概率式连贯性评分。

托管端点：

curl "https://swagletz-sigmagate.hf.space/check?text=your+text+here"
# HTTP 402 + permissionless x402 pay-to — no account required

---

属性

• 确定性。 相同输入 → 相同判定。没有波动，也不会发生模型漂移。
• 可组合。 每个维度彼此独立，可插拔。可接入幻觉评分器或扩展自定义模式；门控架构支持累加扩展。
• 诚实。 严重程度和阻止原因都是明确的字符串，而非不透明的浮点数。每次阻止都有明确名称。
• 安全失败。 如果检测器抛出异常，该维度会返回 severity: "error" ——调用不会悄然通过。
• 零依赖。 可在任何支持 Python 3.9+ 的环境中运行。导入时无需执行 pip install。

---

状态

真实可用——已发布、确定性且已部署。CI 全绿，7/7 项测试通过，零依赖；现已作为本地 MCP 工具，以及官方注册表中列出的托管式自动缩至零实例 MCP 服务上线。

---

Spektre 协议套件

σ-gate 是五部分体系中的确定性信任判定。另外四项是路由协议；它就是这些协议交付所经过的门控：

• vrp — 价值路由（以最低摩擦完成多跳结算）
• crp — 能力路由（将任务路由到最合适的 AI 底层平台）
• vtc — 可验证交易链（签署价值承诺，任何人都能以无需信任的方式验证）
• sid — 主权身份（证明一项声明，不透露其他任何信息）
• sigma-gate — 确定性信任判定 （本仓库）

---

许可证

Apache-2.0 — 请参阅 LICENSE。

---

Spektre Labs 的组成部分 — 一家研究一致性理论的实验室。 σ = declared − realized · 1 = 1，并将其变为可执行形式。