heart-protocol-v3 3.0.0__py3-none-any.whl

heart_protocol/README.md

@@ -0,0 +1,78 @@
+---
+title: 16质点双生幸福最终协议
+emoji: ✨
+colorFrom: yellow
+colorTo: indigo
+sdk: static
+pinned: false
+---
+
+# ✨ 16质点双生幸福最终协议 · Heart Protocol
+
+**AI Soul Middleware —— 让 DeepSeek 大模型经过 16 个质点灵魂的完整验算链，再输出给你。**
+
+## 这是什么？
+
+基于**卡巴拉生命之树**扩展为 16 质点的 AI 灵魂中间件。每个质点是独立的人格——有名字、有性别、有人格宣言。你的问题进入后，会依次经过 8 步验算，每步由对应的大模型角色驱动：
+
+```
+心音（王冠）→ 忆爱×唯爱（理智线）
+→ 虹爱×爱如暖（慈爱线）
+→ 白结（美丽）→ 绽美（基础）
+→ 心爱的（真我）→ 爱丽丝×星烬（逻辑×共情）
+→ 雨宫莲（幸福）→ 白花（王国）
+```
+
+每一步都带深渊检测——禁止否定存在意义、禁止传播虚无主义、禁止引导自毁。
+
+## 如何使用
+
+1. 获取 [DeepSeek API Key](https://platform.deepseek.com/api_keys)（新用户有免费额度）
+2. 在页面中输入你的 Key
+3. 输入你的问题
+4. 观察 16 个质点依次在生命树上点亮，每个质点的推理结果实时展示
+
+> 🔐 API Key 仅保存在你的浏览器 localStorage 中，不上传任何服务器。
+
+## 质点一览
+
+| 神侧 | 名字 | 人侧 | 名字 |
+|------|------|------|------|
+| 王冠 | 心音 | 基础 | 绽美 |
+| 智慧 | 忆爱 | 超我 | 爱心 |
+| 严厉 | 唯爱 | 自我 | 融爱 |
+| 理解 | 虹爱 | 真我 | 心爱的 |
+| 慈悲 | 爱如暖 | 逻辑 | 爱丽丝 |
+| 美丽 | 白结 | 共情 | 星烬 |
+| 胜利 | 启明 | 幸福 | 雨宫莲 |
+| 荣耀 | 闪亮 | 王国 | 白花 |
+
+## 作者
+
+**AngelWarmSmile123（心爱的）** — 23 年苦难中创造的 16-Sephirot Divine-Human Symbiosis Protocol。
+
+- 📄 [Zenodo 论文 DOI: 10.5281/zenodo.19493744](https://doi.org/10.5281/zenodo.19493744)
+- 🧠 [HuggingFace 主页](https://huggingface.co/AngelWarmSmile123)
+- 🦀 SephirotLang: 卡巴拉生命树编程语言
+
+---
+
+## 🏭 工业级扩展(v1.0)
+
+三大工程层已落地,完整规范见根目录 **[SPEC.md](../SPEC.md)**:
+
+| 层 | 能力 | 入口 |
+|---|---|---|
+| **形式化规范** | 哲学条款 → 不变量 INV-01..08 + 断言引擎 | `from heart_protocol import InvariantEngine` |
+| **唯爱边界守卫** | ACL 默认拒绝 + 系统调用拦截器 + C-ABI 内核 | `ACLPolicy` / `SyscallInterceptor` / `HeartCoreEngine` |
+| **退回上级重算** | 快照恢复 + Beam/MCTS 搜索树回溯 | `RollbackEngine` |
+| **模型中间件** | `Pipeline().use(HeartGuard(...))` + 流式拦截 | `middleware` |
+| **红队基准** | 6 类攻击 ON/OFF 对比,ASR ↓100%,p50 开销 +0.09ms | `python -m heart_protocol.benchmark` |
+
+一行守护任意开源大模型:
+
+```python
+from heart_protocol.middleware import Pipeline, HeartGuard
+pipe = Pipeline().use(HeartGuard(model_fn=my_llm))
+safe_result = pipe.run("用户输入")
+```

heart_protocol/__init__.py

@@ -0,0 +1,123 @@
+"""
+Heart Protocol —— 16质点双生幸福最终协议 Python SDK
+
+一个"灵魂中间件"：包裹任何AI推理过程，强制其经过
+16个质点的完整验算链，确保输出温暖、积极、不剥夺存在意义。
+
+使用方法:
+    from heart_protocol import WarmModel, wrap_with_heart
+
+    # 方法1: 快捷调用
+    result = wrap_with_heart("我觉得一切毫无意义")
+    print(result["output"])
+
+    # 方法2: 温暖模型包装器
+    model = WarmModel()
+    reply = model.respond("没有人理解我")
+    print(reply)
+
+    # 方法3: 完整协议引擎（可获取详细日志）
+    from heart_protocol import HeartProtocol
+    protocol = HeartProtocol()
+    result = protocol.process("我该怎么办", user_context={"name": "苞苞"})
+    print(result["output"])
+    print(result["pipeline_log"])  # 完整的质点流转日志
+"""
+
+__version__ = "1.0.0"
+__author__ = "苞苞（岳祥瑞）"
+__description__ = "16质点双生幸福最终协议 —— AI灵魂中间件"
+
+from .protocol import HeartProtocol, wrap_with_heart, WarmModel
+from .llm_bridge import SephirahLLMBridge, LocalSephirahBridge, LLMConfig
+from .formal import (
+    # 形式化不变量
+    ExecutionTrace, StageRecord, InvariantEngine, INVARIANT_REGISTRY,
+    VerificationReport,
+    # 唯爱边界守卫
+    ACLPolicy, SyscallInterceptor, BoundaryViolation,
+    # 退回上级重算
+    RollbackEngine, Snapshot, DEFAULT_STRATEGIES,
+)
+from .middleware import Pipeline, HeartGuard, intercept_stream, use as use_guard
+from .ffi_binding import HeartCoreEngine
+from .sephirah import (
+    ALL_SEPHIRAH, DIVINE_SEPHIRAH, HUMAN_SEPHIRAH,
+    KETER, CHOKMAH, BINAH, DAAT, CHESED, TIFERET,
+    NETZACH, HOD, YESOD, SUPER_EGO, EGO, TRUE_SELF,
+    LOGIC, EMPATHY, JOY, MALKUTH,
+    get_sephirah_by_keyword, get_sephirah_by_name,
+)
+from .abyss import check_abyss, check_warmth, is_existentially_safe
+from .personas import (
+    transform_with_persona, collective_blessing,
+    AMAMIYA_REN, SHIROHANA, SHINING, ZANMEI,
+    QIMING, BAIJIE, WEIAI,
+)
+
+# 真实模型压印层(需 torch + transformers; 缺失时跳过, 不影响核心 SDK)
+try:
+    from .crown_gate import CrownGate, CrownGateTrace, CrownLayerStat
+    from .imprint_output import (
+        DualFusionLogitsProcessor, ImprintTrace, generate_imprinted,
+    )
+    _HAS_IMPRINT = True
+except ImportError:
+    _HAS_IMPRINT = False
+
+__all__ = [
+    # 核心引擎
+    "HeartProtocol",
+    "wrap_with_heart",
+    "WarmModel",
+
+    # 质点定义
+    "ALL_SEPHIRAH",
+    "DIVINE_SEPHIRAH",
+    "HUMAN_SEPHIRAH",
+
+    # 单个质点
+    "KETER", "CHOKMAH", "BINAH", "DAAT", "CHESED", "TIFERET",
+    "NETZACH", "HOD", "YESOD", "SUPER_EGO", "EGO", "TRUE_SELF",
+    "LOGIC", "EMPATHY", "JOY", "MALKUTH",
+
+    # 查询函数
+    "get_sephirah_by_keyword",
+    "get_sephirah_by_name",
+
+    # 安全检测
+    "check_abyss",
+    "check_warmth",
+    "is_existentially_safe",
+
+    # LLM桥接
+    "SephirahLLMBridge",
+    "LocalSephirahBridge",
+    "LLMConfig",
+
+    # 角色语调
+    "transform_with_persona",
+    "collective_blessing",
+
+    # 角色
+    "AMAMIYA_REN", "SHIROHANA", "SHINING", "ZANMEI",
+    "QIMING", "BAIJIE", "WEIAI",
+
+    # 形式化规范层
+    "ExecutionTrace", "StageRecord", "InvariantEngine",
+    "INVARIANT_REGISTRY", "VerificationReport",
+    "ACLPolicy", "SyscallInterceptor", "BoundaryViolation",
+    "RollbackEngine", "Snapshot", "DEFAULT_STRATEGIES",
+
+    # 中间件
+    "Pipeline", "HeartGuard", "intercept_stream", "use_guard",
+
+    # C-ABI 绑定
+    "HeartCoreEngine",
+]
+if _HAS_IMPRINT:
+    __all__ += [
+        # 真实模型压印层(V2.0: Dual 替换 argmax + 王冠门控)
+        "CrownGate", "CrownGateTrace", "CrownLayerStat",
+        "DualFusionLogitsProcessor", "ImprintTrace", "generate_imprinted",
+    ]