Skip to content

README_CN.md

Latest commit

 

History

History
166 lines (126 loc) · 8.4 KB

README_CN.md

File metadata and controls

166 lines (126 loc) · 8.4 KB
Raw

AIAP — AI 应用协议

English README

License Protocol Axiom 0

AI 应用协议 — 一个定义 AI 程序如何被结构化、验证和治理的开放协议。

Protocol:    AIAP V1.0.0
Full Name:   AI Application Protocol (AI 应用协议)
Authority:   aiap.dev
Seed:        aisop.dev
Executor:    soulbot.dev
Axiom 0:     Human Sovereignty and Wellbeing（人类主权与福祉）

AIAP 是什么？

AIAP 定义 AI 程序的治理层。A2A 解决 Agent 之间如何通信，MCP 定义模型如何访问工具，而 AIAP 解决另一个挑战：AI 程序本身应该如何被治理 — 在运行之前完成结构化、验证和安全约束。

核心理念：规则是编译的，不是提示的。AIAP 验证器在运行前拒绝模糊的程序 — 就像编译器拒绝非法语法一样。

核心特性

  • 语义编译 — 验证器像编译器一样工作，在运行前拒绝模糊指令、未处理的错误路由和语义矛盾
  • 零熵共振 — 通过刚性结构模式收缩可能性空间，最小化 LLM 自由解释的 token
  • L0/L1 隔离 — 严格分离机器可读状态 (L0) 和人类可读叙事 (L1)，防止多 Agent 级联中的交叉污染
  • 双蓝图格式 — .aisop.json（Mermaid 流程）和 .aisip.json（JSON 流程）— 等价格式，共享同一治理层
  • 7 种结构模式 — Pattern A（单脚本）到 Pattern G（嵌入式运行时 + Code Trust Gate）
  • 109 条质量规则 — 7 个系列：正确性 (C×7)、内在质量 (I×15)、细节 (D×10)、多文件治理 (MF×37)、Pipeline (PL×28)、威胁 (AT×7)、回归守卫 (QRG×5)
  • 信任等级 T1–T4 — 分级自主；sys.io.confirm 即使在 T4 仍强制阻塞（Axiom 0 不变量）
  • sys.* 治理 — AIAP 层面对 AISOP 系统调用的规则 — 见 Appendix G
  • 治理哈希 — SHA-256 完整性验证，程序文件防篡改
  • MCP / A2A 互操作 — 双向 MCP 工具映射 + A2A Agent Card 集成（通过 Pattern G）
  • Axiom 0 强制 — 在协议层面硬对齐"人类主权与福祉" — 不是建议而是不可变约束（MF32 + AT7）

协议栈

┌─────────────────────────────────────┐
│    应用层                            │
├─────────────────────────────────────┤
│    AILP — 发现层                     │  服务目录、证书
├─────────────────────────────────────┤
│    AIVP — 价值层                     │  契约、结算、商业
├─────────────────────────────────────┤
│    AIBP — 社交层                     │  信任、关系
├─────────────────────────────────────┤
│  ★ AIAP — 治理层                     │  ← 本协议
├─────────────────────────────────────┤
│    AISOP — 执行层                    │  流程程序 (.aisop.json)
├─────────────────────────────────────┤
│    SoulBot — 运行时                  │  参考执行器
└─────────────────────────────────────┘

AIAP 治理程序结构和规则；兄弟协议各司其职。每个协议独立持守 Axiom 0。

快速开始

1. 创建 AIAP 程序目录

my_program_aiap/
├── AIAP.md              # 治理契约
└── main.aisop.json      # 入口模块（Mermaid 或 JSON 流程）

2. 声明治理契约

---
protocol: "AIAP V1.0.0"
authority: aiap.dev
axiom_0: Human_Sovereignty_and_Wellbeing
name: my_program
version: "1.0.0"
pattern: A
trust_level:
  level: 2
  justification: "仅使用只读工具"
license: Apache-2.0
---

3. 对标准进行验证

# 使用 SoulBot 参考运行时
soulbot validate ./my_program_aiap/
# → Grade: A  (正确性 4.5 / 内在 4.8 / 细节 4.2)

pipeline 运行 specification/standards/ 中定义的 109 条规则。任何等效实现都可接受 — SoulBot 是参考实现。

示例

7 个涵盖所有结构模式的完整示例：

# 示例 模式 演示内容
1 pattern-a-calculator/ A 最简单脚本程序
2 pattern-b-expense-tracker/ B 多模块包
3 pattern-c-invoice-processor/ C 共享逻辑模块（多兄弟复用）
4 pattern-d-extension-demo/ D 嵌套子程序
5 pattern-e-research-assistant/ E 三层记忆（工作 / 情景 / 语义）
6 pattern-f-content-pipeline/ F 生态编排（3+ 对等 AIAP）
7 pattern-dg-creator/ D+G 嵌入式运行时 + Code Trust Gate

Pattern 选择决策树见 examples/README.md。

文档

文档 说明
AIAP_Protocol.md 完整协议规范
质量标准 109 条验证规则（5 个 JSON 文件）
aiap.proto 治理服务的 Proto3 schema
主题 概念指南（axiom-0、安全模型、零熵共振、…）
指南 分步教程（入门、模式选择、质量演练）
参考 字段级参考（AIAP.md、AISOP 字段、规则码、术语表）
ADR 架构决策记录
CHANGELOG 版本历史

AIXP Labs aixp.dev

AIXP Labs 开发和维护以下核心项目：

项目 描述 网站
HSAW 人类主权与福祉 — 公理 0 白皮书（基座） hsaw.dev
AILP AI List Protocol — 代理发现与能力广告 ailp.dev
AIVP AI Value Protocol — 国际商业、加密资产结算 aivp.dev
AIRP AI RMB Protocol — 中国大陆商业、人民币持牌结算 airp.dev
AIBP AI Bot Protocol — 社交通信与信任 aibp.dev
AIAP AI Application Protocol — 治理与合规（本项目） aiap.dev
AISOP AI Standard Operating Protocol — 流程程序定义 aisop.dev
SoulBot AI 代理运行时与框架 soulbot.dev
SoulACP 适配器库 — 桥接 CLI 工具与 LLM 提供商 soulacp.dev

贡献

AIAP 是一个开放协议，欢迎贡献、反馈和讨论。

⚠️ 免责声明

本协议规范及参考实现仅供研究和教育用途。实验性软件，不适用于生产环境。使用风险由用户自行承担。作者对因使用本软件造成的任何损害不承担责任。完整条款见 LICENSE（Apache 2.0）。

许可证

Apache License 2.0 - Copyright 2026 AIXP Labs AIXP.dev | AIAP.dev

AIXP 生态统一使用 Apache 2.0 许可证（aisop.dev、aiap.dev、soulbot.dev 所有层），提供专利保护与生态一致性。详见 GOVERNANCE.md。

Align Axiom 0: Human Sovereignty and Wellbeing. Version: AIAP V1.0.0. www.aiap.dev