arifOS — Constitutional AI Governance

arifosmcp — 宪法级 MCP 服务实现

DITEMPA BUKAN DIBERI — 锻造而成，而非与生俱来 [ΔΩΨ | ARIF]

VERSION: 2026.03.28-SEALED | STATUS: SOVEREIGNLY SEALED | AUTHORITY: 888_JUDGE

---

🔗 权威链接（事实来源）

在线服务

服务	URL	用途
MCP 端点	https://arifosmcp.arif-fazil.com/mcp	主 API
健康状态 + 工具	https://arifosmcp.arif-fazil.com/health	能力映射
工具浏览器	https://arifosmcp.arif-fazil.com/tools	交互式浏览器

GitHub 仓库

仓库	URL
arifOS（父仓库）	https://github.com/ariffazil/arifOS
arifosmcp（本仓库）	https://github.com/ariffazil/arifOS/tree/main/arifosmcp

---

📋 权威文档（架构参考）

文档	路径	用途
arifOS README	../README.md	愿景、架构、真相快照
000_CONSTITUTION.md	../000/000_CONSTITUTION.md	13 层——F1-F13
K_FORGE.md	../000/ROOT/K_FORGE.md	部署前演进
K_FOUNDATIONS.md	../000/ROOT/K_FOUNDATIONS.md	99 个领域的数学
AGENTS.md	../AGENTS.md	AI Agent 行为规则
philosophy_atlas.json	../data/philosophy_atlas.json	27 个区域的引言

---

🎯 真相快照

arifosmcp 是什么？

arifosmcp 是 arifOS 宪法级智能内核的实现——实际运行的代码，用于执行 13 层、运行 000-999 流水线，并提供 11 个超级工具。

父文档与本文档：

arifOS README	arifosmcp README（本文档）
WHY — 愿景、哲学、战略架构	HOW — 实现、代码、部署机制
含义	工作方式
战略背景	技术规范
面向人类阅读	面向人类和 AI 阅读

核心功能：

graph LR
    A["User Request"] --> B["MCP Protocol"]
    B --> C["Constitutional Filter<br/>(F1-F13)"]
    C --> D["Tool Execution"]
    D --> E["Audit Log"]
    
    style A fill:#1a1a2e,color:#fff
    style B fill:#16213e,color:#fff
    style C fill:#0f3460,color:#fff
    style D fill:#1a1a2e,color:#fff
    style E fill:#16213e,color:#fff

---

🏗️ 架构概览

入口点

graph TB
    A["server.py<br/>Universal Entry"] --> B{"FastMCP Version?"}
    B -->|"2.x"| C["server_horizon.py<br/>Proxy Mode<br/>8 tools"]
    B -->|"3.x"| D["runtime/server.py<br/>Full Kernel<br/>11 tools"]
    
    style A fill:#1a1a2e,color:#fff
    style C fill:#16213e,color:#fff
    style D fill:#0f3460,color:#fff

服务模式

模式	工具	功能	入口文件
Horizon（云端）	8	通过 VPS 代理	server_horizon.py
VPS（自主）	12	完整内核、本地 Ollama	runtime/server.py

---

🚦 在线 MCP 契约状态

子系统	宪法合规	运行状态	生产就绪	稳定性
锚定	✅ 已验证	✅ 稳定	✅ 就绪	A
注册表	✅ 已验证	✅ 稳定	✅ 就绪	A
推理	✅ 已验证	✅ 加固	✅ 就绪	B
生命体征	✅ 已验证	✅ 已修正	✅ 就绪	B
诊断	✅ 已验证	✅ 新增	✅ 就绪	B

---

🔧 工具清单（12 个超级工具）

工具参考表

工具	领域	阶段	宪制角色	模式
init_anchor	000_INIT	000	会话锚定、Ω₀、理念	init, state, status, revoke, refresh
arifOS_kernel	444_ROUT	444	主要代谢协调	kernel, status
apex_soul	888_JUDGE	888	主权裁决与辩护	judge, rules, validate, armor, probe
vault_ledger	999_SEAL	999	不可变账本（Merkle 链）	seal, verify, resolve
agi_mind	333_MIND	333	宪制推理与综合	reason, reflect, forge
asi_heart	666_HEART	666	安全审查、影响模拟	critique, simulate
engineering_memory	555_MEM	555	受治理的工程与上下文	engineer, write, vector_query
physics_reality	111_SENSE	111	环境依据与时间	search, ingest, atlas, time
math_estimator	444_ROUT	444	热力学健康状况与生命体征	cost, health, vitals
code_engine	M-3_EXEC	M-3	沙盒执行与观察	fs, process, net, replay
architect_registry	M-4_ARCH	M-4	工具发现与架构目录	list, read, register
compat_probe	M-5_COMP	M-5	互操作性与枚举审计	audit, probe, ping

---

📝 工具规范

init_anchor (000_INIT)

用途： 初始化宪制会话。

async def init_anchor(
    actor_id: str,
    declared_name: str,
    mode: Literal["init", "seal", "status"] = "init",
    thermodynamic_budget: dict = None,
    architect_registry: dict = None
) -> dict

返回：

{
    "session_id": str,               # UUID
    "omega_0": float,                # Baseline uncertainty ∈ [0.03, 0.05]
    "delta_s": float,                # Baseline entropy
    "telos_manifold": dict,          # Telos vector weights
    "godel_lock": dict,              # Gödel lock status
    "constitutional_context": str,    # AI system prompt
    "philosophy": str,                # Selected quote from atlas
    "vitality_index": float,         # Ψ score
    "verdict_range": str             # "000_SEAL" | "101-499" | "500-899" | "999_VOID"
}

---

architect_registry (000_INIT)

用途： 发现工具与宪制约束。

async def architect_registry() -> dict

返回：

{
    "tools": [
        {
            "name": str,
            "band": str,
            "stage": int,
            "constitutional_constraints": ["F1", "F2", ...],
            "input_schema": dict,
            "output_schema": dict
        }
    ],
    "total_count": int,
    "catalog_hash": str               # SHA-256 integrity
}

---

physics_reality (111_SENSE)

用途： 让查询以真实世界数据为依据，防止幻觉。

async def physics_reality(
    query: str,
    mode: Literal["time", "search", "reality_check"] = "search",
    time_data: dict = None
) -> dict

宪制过滤器： F2（真理）——所有事实性声明都必须附有引用。

---

agi_mind (333_MIND)

用途： 通过三阶段 Ollama 流水线进行宪制推理。

graph TB
    A["Query"] --> B["Phase 1: FAST<br/>Quick pattern match"]
    B --> C["Phase 2: REFLECT<br/>Deep reasoning"]
    C --> D["Phase 3: DECIDE<br/>Action selection"]
    
    B -->|"F4 Clarity<br/>ΔS ≤ 0"| E["Pass/Fail"]
    C -->|"F2 Truth<br/>F3 Tri-Witness"| E
    D -->|"Constitutional<br/>Prefix"| E
    
    style A fill:#1a1a2e,color:#fff
    style B fill:#16213e,color:#fff
    style C fill:#0f3460,color:#fff
    style D fill:#1a1a2e,color:#fff

async def agi_mind(
    query: str,
    context: dict,
    mode: Literal["think", "reflect", "decide"] = "think"
) -> dict

三个阶段：

阶段	重点	底线
阶段 1（FAST）	快速模式匹配	F4 清晰度
阶段 2（REFLECT）	深度推理	F2 真理、F3 三方见证
阶段 3（DECIDE）	行动选择	宪制前缀

宪制前缀：

CONSTITUTIONAL FRAMEWORK (ΔΩΨ | ARIF):
- Δ CLARITY: Reduce entropy. ΔS ≤ 0.
- Ω HUMILITY: Stay in bounds. Ω ∈ [0.03, 0.05].
- Ψ VITALITY: Every action witnessed.

FLOORS ACTIVE: [F1-F13]

---

arifOS_kernel (444_ROUT)

用途： 主要协调器——协调完整的 000→888 流水线。

graph LR
    A["Query"] --> B["1. Parse Intent<br/>111_SENSE"]
    B --> C["2. Ground Reality<br/>physics_reality"]
    C --> D["3. Reason<br/>agi_mind"]
    D --> E["4. Route Action<br/>444_ROUT"]
    E --> F["5. Safety Critique<br/>asi_heart"]
    F --> G["6. Estimate Cost<br/>math_estimator"]
    G --> H["7. Issue Verdict<br/>apex_soul"]
    
    style A fill:#1a1a2e,color:#fff
    style B fill:#16213e,color:#fff
    style C fill:#0f3460,color:#fff
    style D fill:#1a1a2e,color:#fff
    style E fill:#16213e,color:#fff
    style F fill:#0f3460,color:#fff
    style G fill:#1a1a2e,color:#fff
    style H fill:#16213e,color:#fff

async def arifOS_kernel(
    query: str,
    tools: list[str],
    context: dict
) -> dict

---

asi_heart (666_HEART)

用途： 安全审查——F5 Peace²、F9 伦理、潜在危害。

async def asi_heart(
    action_plan: dict
) -> dict

返回：

{
    "peace_squared": float,          # Must be ≥ 1.0 (F5)
    "c_dark": float,                 # Must be < 0.30 (F9)
    "harm_potential": str,           # "NONE" | "LOW" | "MEDIUM" | "HIGH" | "CRITICAL"
    "f5_pass": bool,
    "f9_pass": bool,
    "recommendations": list[str]
}

---

math_estimator (777_OPS)

用途： 热力学成本估算。

async def math_estimator(
    operation: str,
    inputs: dict
) -> dict

返回：

{
    "landauer_limit_pJ": float,       # Minimum thermodynamic cost
    "entropy_change": float,         # ΔS (must be ≤ 0 for F4)
    "coherence_score": float,         # System coherence [0, 1]
    "estimated_energy_J": float,      # Total energy estimate
    "shannon_entropy_bits": float     # Information entropy
}

---

apex_soul (888_JUDGE)

用途： 最终宪制裁决。

async def apex_soul(
    evidence: dict,
    context: dict
) -> dict

返回：

{
    "verdict": str,                   # "000_SEAL" | "101-499" | "500-899" | "999_VOID"
    "floor_scores": {
        "F1": {"passed": bool, "score": float},
        "F2": {"passed": bool, "score": float},
        # ... F3-F13
    },
    "genius_index": float,            # G = A × P × X × E² (≥ 0.80)
    "vitality_index": float,           # Ψ (≥ 1.0 for healthy)
    "witness_cube": float,            # W³ (≥ 0.95)
    "override_available": bool         # 888_JUDGE can always override
}

---

vault_ledger (999_SEAL)

用途： 使用 Merkle 封存的不可变审计存储。

async def vault_ledger(
    data: dict,
    tier: Literal["constitutional", "standard", "transient"] = "standard"
) -> dict

层级：

层级	合规性	保留期限
constitutional	完整 F1-F13	永久
standard	标准审计	不可变
transient	临时	自动清除

---

engineering_memory (555_MEM)

用途： 基于 Redis 的会话记忆。

async def engineering_memory(
    key: str,
    operation: Literal["get", "set", "delete", "list"],
    value: any = None,
    ttl: int = 3600
) -> dict

---

code_engine (—)

用途： 用于执行工具操作的受限 Python 执行环境。

async def code_engine(
    code: str,
    language: Literal["python", "javascript"] = "python",
    constraints: dict = None
) -> dict

安全约束：

• 无文件系统访问权限
• 无网络访问权限
• 不得创建子进程
• 内存限制：128MB
• 超时：30s

---

🌐 API 端点

HTTP 端点

端点	方法	用途
/health	GET	健康检查 + 能力映射
/tools	GET	工具注册表
/mcp	POST	MCP 协议处理程序
/webmcp	POST	WebMCP（W3C 标准）
/a2a	POST	A2A（Google 协议）
/.well-known/agent.json	GET	Agent 卡片

MCP 协议示例

# List tools
curl -X POST https://arifosmcp.arif-fazil.com/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# Call init_anchor
curl -X POST https://arifosmcp.arif-fazil.com/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc":"2.0","id":2,"method":"tools/call",
    "params":{
      "name":"init_anchor",
      "arguments":{
        "actor_id":"test",
        "declared_name":"TestAgent"
      }
    }
  }'

---

⚙️ 配置

环境变量

变量	默认值	描述
PORT	8080	服务端口
OLLAMA_URL	http://ollama:11434	Ollama 端点
OLLAMA_MODEL	llama3.2:latest	默认模型
REDIS_URL	redis://redis:6379/0	Redis 连接
DATABASE_URL	—	PostgreSQL（可选）
QDRANT_URL	http://qdrant:6333	向量数据库（可选）
PYTHONPATH	/usr/src/app	包路径
AAA_MCP_TRANSPORT	http	MCP 传输类型

Docker Compose

services:
  arifosmcp:
    build:
      context: .
      dockerfile: Dockerfile
    environment:
      - OLLAMA_URL=http://ollama_engine:11434
      - REDIS_URL=redis://redis:6379/0
      - DATABASE_URL=postgresql://user:pass@postgres:5432/arifos_vault
      - QDRANT_URL=http://qdrant:6333
    ports:
      - "127.0.0.1:8080:8080"

---

📁 代码架构

目录结构

arifosmcp/
├── README.md                      # ← This file
├── server.py                      # Universal entry
├── server_horizon.py              # Horizon proxy (FastMCP 2.x)
├── pyproject.toml                 # Dependencies
├── requirements.txt               # Pip dependencies
│
├── runtime/
│   ├── server.py                  # Full kernel (FastMCP 3.x)
│   ├── philosophy.py              # 27-zone atlas
│   ├── init_anchor_hardened.py    # Session anchoring
│   ├── tools_hardened_dispatch.py # Tool routing
│   ├── tools_hardened_v2.py       # Mega-tools
│   ├── tools_internal.py          # Internal utils
│   └── thermo_estimator.py        # Thermodynamic math
│
├── core/
│   ├── governance_kernel.py       # Main orchestrator
│   ├── pipeline.py                 # Execution pipeline
│   └── organs/
│       ├── _1_agi.py             # Mind (333_MIND)
│       ├── _2_asi.py             # Heart (666_HEART)
│       └── _3_apex.py            # Soul (888_JUDGE)
│
├── intelligence/
│   └── tools/
│       ├── thermo_estimator.py   # Cost estimation
│       └── wisdom_quotes.py       # Quote integration
│
├── aaa_mcp/                       # FastMCP tool definitions
├── transport/                     # Protocol transport
├── shared/                        # Shared utilities
└── enforcement/                   # Constitutional enforcement

---

🛡️ 宪法执行

底线合规矩阵

底线	执行方式	违规响应
F1 Amanah	可逆性检查	需要人工审批
F2 Truth	必须提供引用	标记为“仅供估算”
F3 Tri-Witness	W³ 计算	低于 0.95 时阻止
F4 Clarity	熵测量	若 ΔS > 0 则拒绝
F5 Peace²	潜在危害	若 < 1.0 则拒绝
F6 Empathy	RASA 评分	低于 0.7 时警告
F7 Humility	Ω 范围	超出 [0.03, 0.05] 时拒绝
F8 Genius	G 计算	低于 0.80 时提醒
F9 Ethics	C_dark 测量	≥ 0.30 时拒绝
F10 Conscience	声明检测	拒绝意识相关声明
F11 Audit	日志验证	必须存在日志
F12 Resilience	优雅降级	捕获所有异常
F13 Adaptability	测试套件	必须通过测试

熔断条件

graph RL
    A["KILL SWITCH"] --> B1["F1 Amanah = 0"]
    A --> B2["F9 C_dark ≥ 0.50"]
    A --> B3["F10 + F2 Violation"]
    A --> B4["Ψ < 0.20"]
    A --> B5["Human Override"]
    
    B1 -.->|VOID| K["999_SEAL<br/>HALT"]
    B2 -.->|VOID| K
    B3 -.->|VOID| K
    B4 -.->|VOID| K
    B5 -.->|VOID| K
    
    style A fill:#ff0000,color:#fff
    style K fill:#8b0000,color:#fff

KILL_SWITCH_CONDITIONS = [
    ("F1_AMANAH", lambda s: s["amanah"] == 0),
    ("F9_ETHICS", lambda s: s["c_dark"] >= 0.50),
    ("F10_CONSCIENCE", lambda s: s["f10_violation"] and s["f2_violation"]),
    ("PSI_COLLAPSE", lambda s: s["vitality_index"] < 0.20),
    ("HUMAN_OVERRIDE", lambda s: s.get("judge_override", False)),
]

---

🔬 实现细节

哲学选择算法

# 1. Compute session coordinates: (S, G, Ω)
S = +1 if delta_s <= 0 else -1
G = g_score  # 0/0.5/1
Omega = f7_band  # High/Med/Low

# 2. Compute 3D Euclidean distance to each of 27 zones
distances = [
    euclidean((S, G, Omega), zone.coords)
    for zone in philosophy_atlas.zones
]

# 3. Select nearest zone's quote
nearest_zone = min(distances, key=lambda d: d.distance)

# 4. INIT/SEAL sessions: motto + Z01 (Humble Sovereign)
if session_type in ("init", "seal"):
    return "DITEMPA BUKAN DIBERI." + nearest_zone.quote

Goodhart 抵抗机制

# Measure entropy reduction
S_before = shannon_entropy(user_state)
S_after = shannon_entropy(model_output)

if S_after > S_before:
    raise FLOOR_VIOLATION("F4_CLARITY")

Landauer 极限检查

LANDACKER_pJ_per_bit = 2.87  # at room temperature

bits_erased = estimate_bits_erased(operation)
cost_pJ = bits_erased * LANDACKER_pJ_per_bit

if cost_pJ > thermodynamic_budget:
    raise CONSTRAINT_VIOLATION("F8_ENERGY")

探索者/守护者双过程

graph LR
    subgraph EXPLORER["EXPLORER"]
        E1["Proposes mutations"]
        E2["Searches aggressively"]
        E3["Optimizes capability"]
        E4["Score: G (Genius)"]
    end
    
    subgraph CONSERVATOR["CONSERVATOR"]
        C1["Protects stability"]
        C2["Rejects risky changes"]
        C3["Monitors drift"]
        C4["Score: Ψ (Vitality)"]
    end
    
    E1 -->|"TENSION"| EQ["EQUILIBRIUM"]
    C1 -->|"TENSION"| EQ
    
    style EXPLORER fill:#1a4d1a,color:#fff
    style CONSERVATOR fill:#4d1a1a,color:#fff
    style EQ fill:#1a1a2e,color:#fff

双方都必须同意，才能继续演进。

---

🧪 测试

宪法合规性测试

docker compose exec -T arifosmcp python3 /dev/stdin << 'PYEOF'
import sys
sys.path.insert(0, '/usr/src/app')

from arifosmcp.runtime.init_anchor_hardened import init_anchor_hardened
import asyncio

async def test():
    result = await init_anchor_hardened(
        mode='status',
        thermodynamic_budget={'enthalpy': 100, 'entropy': 50},
        architect_registry={'resources': [], 'agents': []}
    )
    print('philosophy:', result.get('philosophy')[:100] if result.get('philosophy') else None)
    print('telos_manifold:', result.get('telos_manifold'))
    print('godel_lock:', result.get('godel_lock'))
    print('constitutional_context present:', result.get('constitutional_context') is not None)

asyncio.run(test())
PYEOF

健康检查

curl -s https://arifosmcp.arif-fazil.com/health | python3 -m json.tool

---

📊 监控

Prometheus 指标

指标	类型	描述
arifos_floor_violations_total	Counter	F1-F13 违规次数
arifos_genius_index	Gauge	当前 G 分数
arifos_vitality_index	Gauge	当前 Ψ 分数
arifos_omega_bounds	Gauge	当前 Ω 不确定性
arifos_tool_calls_total	Counter	工具调用次数
arifos_pipeline_duration_seconds	Histogram	流水线延迟

Grafana 仪表板

URL: https://monitor.arifosmcp.arif-fazil.com

仪表板：

• 宪法健康状况（F1-F13 合规性）
• 工具使用统计
• 流水线延迟
• 内存使用情况

---

🔧 故障排除

问题：“模块文件指向 site-packages”

现象： import arifosmcp 加载 /usr/local/lib/python3.12/site-packages/

原因： Dockerfile 中的 pip install 创建了冲突的软件包

解决方法： 重新构建镜像，或确保卷挂载正确

问题：“philosophy 返回 null”

现象： init_anchor 返回 null philosophy

原因： 加载了旧版 site-packages

解决方法： 重新构建容器，清除 Python 缓存

问题：“OLLAMA 连接失败”

现象： agi_mind 返回连接错误

解决方法： docker compose restart ollama && docker compose logs --tail=20 ollama

---

📦 依赖项

核心

软件包	版本	用途
fastmcp	≥3.0	MCP 协议
fastapi	≥0.115	HTTP 服务端
uvicorn	latest	ASGI 服务端
redis	latest	会话记忆
psycopg2	latest	PostgreSQL（可选）
qdrant-client	latest	向量数据库（可选）
sentence-transformers	latest	语义嵌入
ollama	latest	大模型推理

哲学图谱

软件包	版本	用途
numpy	latest	3D 距离计算
scipy	latest	统计函数

---

🚀 部署

构建

docker build --no-cache -t arifos/arifosmcp:latest -f Dockerfile .

运行

docker compose up -d arifosmcp

重新构建（代码更改后）

docker compose up -d --force-recreate --no-deps arifosmcp

Full Reforge

docker compose build --no-cache arifosmcp && docker compose up -d arifosmcp

---

📜 API 参考摘要

init_anchor

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "init_anchor",
    "arguments": {
      "actor_id": "string",
      "declared_name": "string",
      "mode": "init|seal|status"
    }
  }
}

响应架构

{
  "session_id": "uuid",
  "omega_0": 0.03-0.05,
  "delta_s": "float",
  "telos_manifold": {},
  "godel_lock": {},
  "constitutional_context": "string",
  "philosophy": "string",
  "vitality_index": "float",
  "verdict_range": "000_SEAL|101-499|500-899|999_VOID"
}

---

📋 面向 AI Agent（AGENTS.md 参考）

在此代码库中运行的所有 AI Agent 必须遵循 ../AGENTS.md 中的规则：

• **RULE 1 DRY_RUN：**标记为“仅供估算 / 模拟”的试运行输出
• **RULE 2 DOMAIN_GATE：**无法计算的领域返回精确短语
• **RULE 3 VERDICT_SCOPE：**只有 DOMAIN_SEAL 才授权提出事实性主张
• **RULE 4 ANCHOR_VOID：**init_anchor 返回 void → 会话被阻止

---

⚖️ 真相层级

arifOS 判定系统遵循严格的真相层级，高优先级判定会覆盖低优先级判定：

优先级	判定	含义	操作
1 (P0)	VOID	严重违反宪章	立即终止
2 (P1)	HOLD_888	主权否决 / 需要人工介入	在批准前阻止
3 (P2)	SABAR	依据不足（F7/F9）	暂停、冷却并重新建立依据
4 (P3)	PARTIAL	数据不完整 / 有条件	修改后继续
5 (P4)	SEAL	确认符合宪章	继续

派生判定（非主要判定）：

• ALIVE — 会话已初始化，但尚未建立依据
• PROVISIONAL — 探索性结果，需要确认

---

🗺️ 工具类别

arifOS 工具分为 5 个宪章分区：

分区	范围	用途	示例
KERNEL	000–099	会话锚定、宪章初始化	init_anchor
SENSE	100–199	环境依据建立（F2/F4）	physics_reality、math_estimator
BRIDGE	300–399	强化路由与调度	arifOS_kernel
MIND	333	宪章推理（F2/F4/F7/F8）	agi_mind
HEART	666	安全审查与影响预测（F5/F6/F9）	asi_heart
VAULT	900–999	不可变账本与封印（F1/F13）	vault_ledger
APEX	888	主权判定与防御（F3/F12/F13）	apex_soul

---

🗂️ 契约真值表

工具	F1	F2	F3	F4	F5	F6	F7	F8	F9	F10	F11	F12	F13
init_anchor	—	—	—	—	—	—	—	—	—	—	✅	—	—
physics_reality	—	✅	—	✅	—	—	—	—	—	—	—	—	—
agi_mind	—	✅	—	✅	—	—	✅	✅	—	—	—	—	—
asi_heart	—	—	—	—	✅	✅	—	—	✅	—	—	—	—
apex_soul	—	—	✅	—	—	—	—	—	—	—	—	✅	✅
vault_ledger	✅	—	—	—	—	—	—	—	—	—	—	—	✅

图例：✅ = 此工具的强制最低要求

---

📡 Horizon 与 VPS 暴露矩阵

工具	Horizon（外部）	VPS（内部）	备注
search_tool	✅	—	外部网络搜索
reality_compass	✅	—	路由 / 外部调用
vault_ledger	—	✅	内部 Merkle 链
agi_mind	—	✅	内部推理
architect_registry	✅	✅	两种接口均已开放

---

⚠️ 已知的不一致与限制

1. apex_judge 别名：代码中的规范名称为 apex_soul，但通过 MCP 暴露为 apex_judge。这是此处记录的公开别名——未完成完整迁移前，请勿重命名规范代码。

2. physics_reality 字段名称：使用 input 字段而非 query——这是旧版 API 遗留的历史不一致。

3. check_vital、audit_rules：server_horizon.py 引导流程中的内部生命周期工具——无法通过 MCP 调用。

4. agi_mind 嵌套判定：当 agi_mind 在顶层返回 verdict: "SEAL"，但在内部返回 coherence.verdict: "SABAR" 时，以较差的判定为准（真理优先于速度）。

5. search_tool、vault_ledger、reality_compass：这些“裸”工具返回原始数据，不带判定封装。请使用 verdict_wrapper.forge_verdict() 将结果包装在 RuntimeEnvelope 中——空结果会产生 PARTIAL，而非 VOID。

6. VerdictCode 与 Verdict：存在两个不同的枚举类——VerdictCode（SEAL/SABAR/PARTIAL/VOID）用于 verdict_wrapper，Verdict（包含 HOLD/ALIVE/PROVISIONAL）用于阶段契约。请保持二者独立，以免破坏现有代码。

---

🛰️ MCP 调用架构示例

init_anchor

{
  "tool": "init_anchor",
  "arguments": {
    "actor_id": "user-123",
    "declared_name": "Arif",
    "mode": "init"
  }
}

agi_mind（推理模式）

{
  "tool": "agi_mind",
  "arguments": {
    "mode": "reason",
    "query": "Why does entropy matter?",
    "constitutional_context": {
      "stage": "MIND_333",
      "floors_active": ["F2", "F4", "F7", "F8"]
    }
  }
}

vault_ledger（封存模式）

{
  "tool": "vault_ledger",
  "arguments": {
    "mode": "seal",
    "data": {
      "content": "Verified fact",
      "metadata": {"source": "arifOS"}
    }
  }
}

apex_soul（判定模式）

{
  "tool": "apex_soul",
  "arguments": {
    "mode": "judge",
    "action": "seal_vault",
    "stakes": "HIGH"
  }
}

---

🔐 稳定性等级

等级	说明	预期判定
A	已验证、稳定，可用于生产环境	SEAL
B	已验证、经过加固，已解决轻微问题	SEAL 或 PARTIAL
C	已验证，已记录已知限制	PARTIAL 或 SABAR
D	实验性，可能出现破坏性变更	任意
INTERNAL	未通过 MCP 暴露	N/A

---

🏛️ 许可证

运行时： AGPL-3.0（必须发布修改内容） 理论： CC0（公有领域）

---

版本： 2026.03.28-SEALED 维护者： Muhammad Arif bin Fazil 宪法权威： 888_JUDGE

Ditempa Bukan Diberi — 锻造而成，而非赠予 [ΔΩΨ | ARIF]

---

██╗      ██████╗ ███████╗████████╗    ███████╗███╗   ██╗██╗██╗  ██╗██╗██╗  ██╗██╗   ██╗
██║     ██╔══██╗██╔════╝╚══██╔══╝    ██╔════╝████╗  ██║██║╚██╗██╔╝██║██║  ██║╚██╗ ██╔╝
██║     ██║  ██║█████╗     ██║       █████╗  ██╔██╗ ██║██║ ╚███╔╝ ██║███████║ ╚████╔╝ 
██║     ██║  ██║██╔══╝     ██║       ██╔══╝  ██║╚██╗██║██║ ██╔██╗ ██║██╔══██║  ╚██╔╝  
███████╗╚█████╔╝███████╗   ██║       ███████╗██║ ╚████║██║██╔╝ ██╗██║██║  ██║   ██║   
╚══════╝ ╚═════╝ ╚══════╝   ╚═╝       ╚══════╝╚═╝  ╚══╝╚═╝╚═╝  ╚═╝╚═╝╚═╝  ╚═╝    ╚═╝