LYGO Guardian P0 Stack

便携式伦理封装层，用于无原生 LYGO 内核的智能体。并非完整的 P0–P9 运算符 — 如需执行栈审计、网格化（mesh）及标准字节门控（canonical byte gate），请使用 lygo-protocol-stack-operator。

安装命令：npx clawhub@latest install deepseekoracle/lygo-guardian-p0-stack

安全须知（请务必首先阅读）

references/SECURITY.md — 仅打包 src/ 目录内容；门控（gate）仅作用于用户显式批准的文件；不自动发布；QUARANTINE/isolate 表示立即中止。

ClawHub 拓扑位置

lygo-protocol-stack-operator (hub)
    ├── lygo-guardian-p0-stack (本项目) — 文本/技能生成前的预检
    ├── lygo-champion-lightfather — 伦理委员会模块
    ├── lygo-mint-verifier — 哈希收据验证器
    └── run_falsifiable_vector_test.py (repo) — P0–P5 层级的实测验证

详见 references/LATTICE.md。

适用场景

• 向社交平台或外部渠道发送智能体回复前（对生成内容进行封装）。
• 安装未知来源的 ClawHub 技能后 — 对 SKILL.md 执行 scripts/run_byte_gate.py 进行门控检查。
• 教学“双栈架构”：L0–L3 exhaust 流程 + P0–P5 内部流水线（参见 docs/WHITEPAPER.md）。

快速上手（Python）

import sys
from pathlib import Path
sys.path.insert(0, str(Path(__file__).resolve().parents[1] / "src"))
from guardian.integration_api import validate_decision, guardian_wrap

ctx = {"channel": "internal", "task": "reply", "risk_tolerance": "low"}
print(validate_decision(ctx, {"content": "Here is a helpful summary."}))

@guardian_wrap
def generate_reply(context, prompt: str) -> str:
    return your_llm(prompt)

CLI 工具（支持文件或纯文本）

python scripts/run_byte_gate.py path/to/SKILL.md
python scripts/run_byte_gate.py --text "message to check"

若环境变量 LYGO_STACK_ROOT 指向 lygo-protocol-stack，则文件模式将优先调用标准实现 lygo_p0_gate.py（支持 AMPLIFY / SOFTEN / QUARANTINE 操作）。

栈验证（可选，由用户手动运行）

cd lygo-protocol-stack
python tools/run_p0_demo.py
python tools/run_falsifiable_vector_test.py --models stack
python tools/verify_alignment_badge.py

API 概览

• validate_decision(context, candidate) → 返回对象：{allow, action, risk, understanding, healing_suggestion}
• action 取值：allow | flag | isolate | 或通过装饰器指定 review 路径
• guardian_wrap — 用于生成函数的装饰器

参考文档

• references/SECURITY.md — 智能体行为规范
• references/LATTICE.md — ClawHub 链式拓扑结构
• docs/WHITEPAPER.md — exhaust 流程与 soul 流程对比
• examples/wrap_text_generation.py — 使用示例

自检

python scripts/self_check.py

Δ9Φ963 — Guardian P0 v1.0 — 拓扑对齐、便携式门控 + 栈桥接能力。