# AI Universal Control Plane

**屠龙刀框架架构 v1.8 (单刃执行 + 全刀蓝图)**

> 接纳 v1.7 单刃聚焦执行节奏, 但**系统框架必须从第一天起就能无缝扩展为屠龙刀**.
> 关键原则: **PoC 30 人日只交付 1/N, 但架构必须为 N 设计.**

| 字段 | 内容 |
|---|---|
| 文档类型 | 架构白皮书 (与 v1.7 路线图互补, 同等权威) |
| 版本 | v1.8 |
| 日期 | 2026-04-25 |
| 父版本 | v1.6 屠龙刀 (战略保留) + v1.7 利剑节奏 (执行采纳) |
| 核心承诺 | **架构层面 100% 屠龙刀蓝图, 实施层面 24 月渐进展开, 任何一刃随时可激活** |
| 设计哲学 | "Build for thousand, ship for ten" — 为千刃而建, 先发十刃 |

---

## 0. 核心矛盾的解法

### 0.1 v1.6 vs v1.7 的二元对立

```
v1.6 (屠龙刀): 三刃齐挥 → 战略发散 / 工程崩盘 / 安全打开 / 商业不通
v1.7 (利剑):   单刃聚焦 → 战略清晰 / 工程务实 / 安全收敛 / 商业可验
```

### 0.2 v1.8 的解 (打破二元对立)

```
v1.8 = 屠龙刀架构 × 利剑实施

┌──────────────────────────────────────────────────────┐
│  架构层 (Architecture, 24 月恒定)                    │
│  ┌────────────────────────────────────────────────┐ │
│  │ 性价比刀刃 接口 (CostKiller Interface)          │ │
│  │ 个性化刀刃 接口 (Customization Interface)        │ │
│  │ 兼容性刀刃 接口 (Compatibility Interface)        │ │
│  │ + 反向兼容竞品 接口 (RivalAdapter Interface)     │ │
│  │ + ISV 商店 接口 (ISVMarket Interface)            │ │
│  │ + OSS Core 接口 (OSSCore Interface)              │ │
│  │ + 国际市场 接口 (Locale Interface)               │ │
│  └────────────────────────────────────────────────┘ │
│  统一接口契约, 不变. 即使只实现 1 个, 接口为 N 准备 │
└────────────────────┬─────────────────────────────────┘
                     │ 接口 ↔ 实现 解耦
┌────────────────────▼─────────────────────────────────┐
│  实施层 (Implementation, 24 月渐进)                  │
│                                                      │
│  Phase 0  (4 周): 实现 5% 刀刃 (汇川+信捷 MCP)       │
│  Phase 0.5 (3 月): 实现 10% (3 工厂 + ISV 访谈)      │
│  Phase 1  (6 月): 实现 25% (5 协议 + 5 客户)         │
│  Phase 2  (6 月): 实现 50% (OSS Core 发布)           │
│  Phase 3  (12 月): 实现 80% (Pro + ISV)              │
│  Phase 4  (24 月+): 实现 100% (反向兼容 + 国际)      │
│                                                      │
│  每个 Phase 只做新功能, 不重构架构. 接口稳定.       │
└──────────────────────────────────────────────────────┘
```

### 0.3 关键洞察

**v1.6 失败不在战略, 在执行节奏.**
**v1.7 务实不在战略, 在阶段交付.**
**v1.8 兼得: 架构敢想, 实施敢砍.**

---

## 1. 屠龙刀框架架构 (24 月恒定, 不变)

### 1.1 七层抽象 (从一开始就定义)

```
┌─────────────────────────────────────────────────────────┐
│  L7 商业模式层 (Business Model)                         │
│  - OSSCore (Apache 2.0, 免费)                            │
│  - ProEdition (商业 License, 工业 Pro)                   │
│  - ISVMarket (Skill 商店 + MCP 商店)                     │
│  - Locale (中国 / 东南亚 / 全球)                          │
└────────────────┬────────────────────────────────────────┘
                 │
┌────────────────▼────────────────────────────────────────┐
│  L6 用户交互层 (User Interface)                          │
│  - NLU (自然语言)                                        │
│  - ChatUI (Web / 钉钉 / 企微 / Slack)                    │
│  - OpenAPI / WebSocket / GraphQL                         │
│  - CLI / IDE 插件                                        │
└────────────────┬────────────────────────────────────────┘
                 │
┌────────────────▼────────────────────────────────────────┐
│  L5 大脑决策层 (Brain)                                   │
│  - LLMRouter (13+ 厂商抽象, 可热切换)                    │
│  - JudgeConsensus (双裁判 → N 裁判可扩展)                │
│  - SkillRuntime (94+ Skill 自由扩展)                     │
│  - PolicyEngine (deny-overrides + 优先级)                │
│  - CapabilityGraph (能力图谱)                            │
│  - SagaStore (持久化 + 补偿)                             │
│  - AuditLog (Merkle chain + RFC 3161)                    │
│  - DataSovereignty (数据主权路由)                        │
└────────────────┬────────────────────────────────────────┘
                 │
┌────────────────▼────────────────────────────────────────┐
│  L4 协议适配层 (MCP Cluster, 18+ 协议接口)                │
│  IndustrialProtocols / DesktopProtocols /                │
│  MobileProtocols / VisionProtocols / RivalAdapters       │
└────────────────┬────────────────────────────────────────┘
                 │
┌────────────────▼────────────────────────────────────────┐
│  L3 安全网关层 (Edge Gateway)                            │
│  bump-in-wire / TPM / HMAC heartbeat / mTLS              │
└────────────────┬────────────────────────────────────────┘
                 │
┌────────────────▼────────────────────────────────────────┐
│  L2 传输层 (Transport)                                   │
│  Headscale + 国内 DERP / WireGuard / mTLS                │
└────────────────┬────────────────────────────────────────┘
                 │
┌────────────────▼────────────────────────────────────────┐
│  L1 物理设备层 (Physical Devices)                        │
│  PLC / SCADA / 机器人 / HMI / 摄像头 / 仪器              │
│  + 急停硬件回路 (永远独立, 不接软件)                     │
└─────────────────────────────────────────────────────────┘
```

### 1.2 七大核心接口 (从 v1.0 到 v3.0 不变)

#### 接口 1: ProtocolAdapter (协议刀刃)

```typescript
// L4 协议适配统一接口 — Phase 0 起就定义, 为 18+ 协议留位
interface ProtocolAdapter {
  readonly id: string;                    // 唯一 ID, 如 'huichuan-h5u'
  readonly vendor: string;                // 'huichuan' / 'siemens' / 'ignition' (反向兼容)
  readonly category: ProtocolCategory;    // industrial / desktop / mobile / vision / rival
  readonly capabilities: Capability[];    // 暴露的能力
  
  connect(config: ConnectionConfig): Promise<Session>;
  disconnect(session: Session): Promise<void>;
  
  introspect(session: Session): Promise<CapabilityInfo>;     // 协议反查
  read(session: Session, address: string): Promise<Reading>;
  write(session: Session, address: string, value: any): Promise<WriteResult>;
  
  // 健康检查
  healthCheck(): Promise<HealthStatus>;
}

// Phase 0 实现 2 个 (汇川 + 信捷)
// Phase 1 扩展到 6 个 (+ 西门子 + 三菱 + 欧姆龙 + 罗克韦尔)
// Phase 2 扩展到 12 个 (+ MQTT + BACnet + ONVIF + ADB + ...)
// Phase 4 扩展到 18+ (+ Ignition / 卡奥斯 / 华为盘古 反向兼容)
// 接口不变, 仅实现增加.
```

#### 接口 2: LLMProvider (LLM 抽象)

```typescript
// Phase 0 起就实现, 即使只接 2 家
interface LLMProvider {
  readonly id: string;
  readonly family: ModelFamily;           // qwen / glm / deepseek / claude / gpt / gemini / ...
  readonly vendor: string;
  readonly architecture: string;          // 异构 enforce 用
  readonly hosting: 'cloud' | 'self_hosted' | 'edge';
  readonly compliance: ComplianceTags[];  // ['china_compliant', 'data_export_blocked']
  
  chat(req: ChatRequest): Promise<ChatResponse>;
  toolCall(req: ToolCallRequest): Promise<ToolCallResponse>;
  
  healthCheck(): Promise<HealthStatus>;
  estimateCost(tokens: TokenUsage): CostEstimate;
}

// Phase 0: Qwen3-Max + DeepSeek-R1 (双裁判异构)
// Phase 1: + GLM-4.6 + Kimi K2
// Phase 2: + ERNIE / Doubao / Hunyuan / 自部署 OpenAI 兼容
// Phase 3: + Claude / GPT-5 / Gemini / Grok (合规场景)
// 接口不变. 添加新 LLM = 写一个 Adapter, 不改大脑代码.
```

#### 接口 3: JudgeConsensus (裁判共识)

```typescript
// Phase 0 起设计为 N 裁判可扩展, 即使只用 2 个
interface JudgeConsensus {
  readonly minJudges: number;             // Phase 0 = 2, Phase 4 可扩 3-5
  readonly heterogeneityRules: HeterogeneityRule[];
  
  // 接口为 N 裁判设计, 当前只调 2 个
  evaluate(plan: Plan, judges: LLMProvider[]): Promise<ConsensusResult>;
  
  // 扩展点: SMT/TLA+ 形式验证作为第 N+1 裁判
  registerVerifier(verifier: FormalVerifier): void;
}

// Phase 0: 2 LLM 异构裁判
// Phase 4: + 形式验证 (SMV / TLA+) 作为第 3 裁判
// Phase 5: + 行业专家 KB (作为第 4 裁判, RAG 增强)
// 接口不变.
```

#### 接口 4: PolicyEngine (策略引擎)

```typescript
// Phase 0 起完整, 不留 TODO
interface PolicyEngine {
  // deny-overrides 语义, Phase 0 锁定
  evaluate(action: Action, context: Context): PolicyDecision;
  
  // 扩展点: 自定义策略加载
  loadPolicies(source: PolicySource): Promise<void>;
  registerPlugin(plugin: PolicyPlugin): void;
  
  // Phase 1+: 组合升格策略 (combo-soft-param-uplift)
  // Phase 4+: 跨工厂联邦策略 (federation policies)
  // 接口不变, 实现扩展.
}
```

#### 接口 5: SkillRuntime (Skill 执行)

```typescript
// Phase 0 起为 ISV 商店准备, 即使商店 Phase 3 才上线
interface SkillRuntime {
  // 当前 Phase 0: 平台内置 5 个 Skill (巡检 / 告警 / 推送 / ...)
  // Phase 3+: 加载 ISV 第三方 Skill, 同接口
  
  registerSkill(skill: SkillDescriptor): void;
  invoke(skillId: string, args: any, ctx: SkillContext): Promise<SkillResult>;
  
  // 扩展点: 沙箱隔离 (Phase 3 ISV 商店启用)
  setSandbox(sandbox: SandboxProvider): void;
  
  // 扩展点: 资源限制
  setResourceLimits(limits: ResourceLimits): void;
}
```

#### 接口 6: DataSovereignty (数据主权)

```typescript
// Phase 0 起就强制使用, 即使只有 2 个 LLM 也走数据分级
interface DataSovereigntyRouter {
  classify(data: any): DataClassification;     // general / personal / important / core
  route(prompt: Prompt, classification: DataClassification): LLMProvider[];
  
  // Phase 1+: 自动 PII 扫描 + 工艺秘方扫描
  registerScanner(scanner: SensitivityScanner): void;
  
  // Phase 2+: 数据出境 CAC 申报自动化
  enableExportCompliance(provider: ComplianceProvider): void;
}
```

#### 接口 7: AuditLog (审计日志)

```typescript
// Phase 0 起 Merkle chain 闭环, Phase 1+ 加 RFC 3161 anchor
interface AuditLog {
  append(record: AuditRecord): Promise<AuditEntry>;       // Merkle chain
  query(filter: AuditFilter): Promise<AuditEntry[]>;
  verify(entryId: string): Promise<VerificationResult>;
  
  // Phase 1+: RFC 3161 时间戳锚定
  registerTSA(tsa: TimestampAuthority): void;
  
  // Phase 2+: WORM 对象存储集成
  registerWORM(worm: WORMStorage): void;
}
```

### 1.3 接口稳定性承诺

```yaml
interface_stability:
  v1.0_to_v3.0:
    promise: 主版本号内不破坏向后兼容
    breaking_change_policy: 跨主版本号 (v2.0 / v3.0) 才允许
    deprecation_window: ≥ 12 月通知期
  
  reason: |
    ISV 基于这些接口写 Skill / Adapter / Plugin.
    接口频繁变 = ISV 生态死亡.
    
  enforcement:
    - 每个 PR 跑接口快照 diff 测试
    - 任何 breaking change 必须 RFC 流程 + 4 人 review
    - 接口变更需提供 migration codemod
```

---

## 2. Phase 0 实施: 5% 屠龙刀, 100% 框架

### 2.1 PoC 4 周, 30 人日, 但接口完整

```yaml
phase_0_implementation:
  scope: 5% 功能, 100% 框架
  
  # 协议适配层: 实现 2 个 (18+ 接口位留)
  protocol_adapters:
    implemented:
      - HuichuanH5UAdapter (Modbus TCP)
      - XinjeXDHAdapter (Modbus TCP)
    interface_ready_but_empty:
      - SiemensS7Adapter (Phase 1 实现)
      - MitsubishiMCAdapter (Phase 1)
      - OmronFINSAdapter (Phase 1)
      - RockwellEthernetIPAdapter (Phase 1)
      - 12 其他协议 (Phase 2-3)
      - IgnitionRivalAdapter (Phase 4 反向兼容)
      - KaosRivalAdapter (Phase 4)
      - HuaweiPanguRivalAdapter (Phase 4)
  
  # LLM 提供商: 实现 2 个 (16+ 接口位留)
  llm_providers:
    implemented:
      - QwenProvider (Qwen3-Max)
      - DeepSeekProvider (DeepSeek-R1)
    interface_ready_but_empty:
      - GLMProvider (Phase 1)
      - KimiProvider (Phase 1)
      - 8 其他国内 LLM (Phase 2)
      - ClaudeProvider / OpenAIProvider / GeminiProvider / GrokProvider (Phase 3)
  
  # 裁判共识: N 裁判接口, 当前 N=2
  judge_consensus:
    implementation: TwoJudgeConsensus (异构强制)
    extension_points:
      - registerVerifier(formal_verifier)  # Phase 4
      - registerJudge(expert_kb_rag)        # Phase 5
  
  # 策略引擎: 完整, 不留 TODO
  policy_engine:
    implementation: DenyOverridesEngine (Phase 0 完整)
    enabled_policies:
      - read-only-anytime
      - soft-param-business-hours
      - hard-action-strict (双裁判 + 物理钥匙)
      - registry-downgrade-block
    plugins_ready_but_unused:
      - combo-soft-param-uplift (Phase 1 启用)
      - federation-policies (Phase 4)
  
  # Skill Runtime: 沙箱接口预留
  skill_runtime:
    implementation: InProcessSkillRuntime (Phase 0 内置 5 Skill)
    sandbox_interface: SandboxProvider 接口已定义, 实现 Phase 3
    resource_limits: 接口已定义, enforce Phase 3
  
  # 数据主权: 强制启用 (即使只有 2 LLM 也分级)
  data_sovereignty:
    implementation: ChinaCompliantRouter (Phase 0 强制)
    classifications: [general, personal, important, core]
    routing_rules:
      core: local_only       # 强制本地
      important: domestic_only
      personal: domestic_with_anonymize
      general: any
  
  # 审计日志: Merkle chain 完整, TSA 接口预留
  audit_log:
    implementation: MerkleChainAuditLog
    tsa_provider_interface: 接口已定义, RFC 3161 实现 Phase 1
    worm_storage_interface: 接口已定义, MinIO 集成 Phase 2
```

### 2.2 代码组织 (从 Day 1 就为屠龙刀准备)

```
bookworm-aiocp/
├── packages/
│   ├── core/                          # OSSCore (Apache 2.0)
│   │   ├── interfaces/                # 七大核心接口 (Day 1 完整)
│   │   │   ├── ProtocolAdapter.ts
│   │   │   ├── LLMProvider.ts
│   │   │   ├── JudgeConsensus.ts
│   │   │   ├── PolicyEngine.ts
│   │   │   ├── SkillRuntime.ts
│   │   │   ├── DataSovereignty.ts
│   │   │   └── AuditLog.ts
│   │   ├── brain/                     # L5 大脑实现
│   │   ├── transport/                 # L2 传输层
│   │   └── edge/                      # L3 边缘网关
│   │
│   ├── adapters/                      # L4 协议适配
│   │   ├── industrial/
│   │   │   ├── huichuan-h5u/         # Phase 0 实现
│   │   │   ├── xinje-xdh/            # Phase 0 实现
│   │   │   ├── siemens-s7/           # Phase 1 (空 stub + 接口)
│   │   │   ├── mitsubishi-mc/        # Phase 1
│   │   │   ├── omron-fins/           # Phase 1
│   │   │   ├── rockwell-eip/         # Phase 1
│   │   │   └── ...                   # 18 个目录全部预创建, 仅 README 说明 Phase
│   │   ├── desktop/
│   │   ├── mobile/
│   │   ├── vision/
│   │   └── rival/                    # Phase 4 反向兼容
│   │       ├── ignition/             # Phase 4 (接口位留)
│   │       ├── kaos/                 # Phase 4
│   │       ├── huawei-pangu/         # Phase 4
│   │       └── tpt2/                 # Phase 4
│   │
│   ├── llm-providers/
│   │   ├── qwen/                     # Phase 0
│   │   ├── deepseek/                 # Phase 0
│   │   ├── glm/                      # Phase 1 stub
│   │   ├── kimi/                     # Phase 1 stub
│   │   ├── claude/                   # Phase 3 stub
│   │   ├── openai/                   # Phase 3 stub
│   │   └── ...                       # 16 个目录全部预创建
│   │
│   ├── skills/                       # Phase 0 内置 5 个
│   │   ├── inspect-line/
│   │   ├── notify-foreman/
│   │   ├── read-status/
│   │   ├── voice-confirm/
│   │   └── archive-event/
│   │
│   ├── isv-store/                    # Phase 3 启用, Phase 0 仅接口骨架
│   │   ├── sandbox/                  # 沙箱接口 (Phase 0 定义)
│   │   ├── manifest/                 # capability manifest 定义
│   │   └── registry/                 # 注册逻辑骨架
│   │
│   ├── pro/                          # Phase 3+ 商业版 (单独 repo, 商业 license)
│   │   ├── hsm-air-gap/
│   │   ├── federation/
│   │   ├── auto-learn/
│   │   ├── secret-version/           # 涉密版
│   │   └── compliance-evidence/      # 等保 33 项证据自动化
│   │
│   ├── i18n/                         # Phase 4 国际化
│   │   ├── zh-CN/                    # Phase 0 默认
│   │   ├── en-US/                    # Phase 1 stub
│   │   ├── vi-VN/                    # Phase 4 (东南亚)
│   │   ├── th-TH/                    # Phase 4
│   │   └── ...
│   │
│   └── docs/                         # 文档
│       ├── architecture/
│       ├── adapters/                 # 18 协议各一份模板, Phase 0 写 2 份
│       └── extension-guide/          # 如何写新 Adapter / LLM / Skill
│
├── tools/
│   ├── interface-snapshot/           # 接口稳定性测试
│   ├── policy-static-check/
│   ├── llm-conformance/              # LLM Adapter 一致性测试
│   └── adapter-conformance/
│
└── README.md
```

**核心实践**: 18 协议目录在 Day 1 全部预创建, Phase 0 只在 2 个目录有代码, 其他 16 个目录有 README 说明"Phase X 实现". 这样:

- 后续添加协议**不改主仓结构**, 仅填空
- 接口契约从 Day 1 就完整, 不会有 Phase 1 才发现接口缺设计的尴尬
- ISV 看代码结构就知道扩展点在哪
- OSS 公开后, 社区贡献者可立即认领空 stub

---

## 3. 三刃接口的渐进展开

### 3.1 第一刃 — 性价比 (CostKiller)

```yaml
phase_progression:
  phase_0_4w:
    interface: 完整定义 CostModel / PricingTier / RebateCalculator
    implementation: 仅 OSSCore Apache 2.0, 不收费
    proof: |
      ¥0 软件 License (OSS Core)
      ¥0 平台抽成 (集成商自由)
      用户付的: LLM 厂商 API 费 + 自购硬件
  
  phase_0.5_3m:
    interface: 添加 ROITracker 接口
    implementation: 3 工厂 PoC 收集真实成本数据
    proof: 真实 ROI 数据, 修订 v1.7.1
  
  phase_1_6m:
    interface: 启用 PricingTier (轻量 / 标准 / 高合规)
    implementation: 商业 License 系统 + 设备数计数
    proof: 1-3 付费客户实测毛利
  
  phase_2_6m:
    interface: 启用 RebateCalculator (ISV 三级返点)
    implementation: ISV 商店 + 自动分润
    proof: ¥800/设备/年 模型 PMF 验证
  
  phase_3+_12m:
    interface: 启用 InternationalPricing (东南亚 / 一带一路)
    implementation: 多币种 / 多税务 / 渠道商管理
    proof: 5+ 国际客户
```

### 3.2 第二刃 — 个性化 (Customization)

```yaml
phase_progression:
  phase_0_4w:
    interface: SkillSDK / ConfigSchema / PluginRegistry 完整定义
    implementation: 内置 5 Skill + YAML 配置
    proof: 用户可改 LLM / Zone / 通道 (5 分钟)
  
  phase_1_6m:
    interface: 启用 Skill 商店接口 (但商店未上线)
    implementation: 平台内 ISV 提交 Skill (PR 模式)
    proof: 2 个 ISV Skill 通过 PR 审核合并
  
  phase_2_6m:
    interface: 启用 SandboxProvider (沙箱)
    implementation: 完整沙箱 + capability manifest 静态扫描
    proof: ISV 商店内测 (邀请制)
  
  phase_3_12m:
    interface: 启用 ForkSupport / fork 后远程升级
    implementation: 用户 fork 后仍能选择性接收 OSS 安全补丁
    proof: 5+ 用户 fork 实战使用
  
  phase_4+:
    interface: 启用 EnterpriseDSL (企业级 Skill 定制语言)
    implementation: 大客户专属定制
    proof: 大客户深度个性化交付
```

### 3.3 第三刃 — 兼容性 (Compatibility)

```yaml
phase_progression:
  phase_0_4w:
    protocols: 2 (汇川 + 信捷)
    llm_providers: 2 (Qwen + DeepSeek)
    os: Linux (树莓派) + Windows (Edge Agent)
  
  phase_1_6m:
    protocols: 6 (+ 西门子 / 三菱 / 欧姆龙 / 罗克韦尔)
    llm_providers: 4 (+ GLM / Kimi)
    os: + macOS
  
  phase_2_6m:
    protocols: 12 (+ MQTT / BACnet / ONVIF / ADB / SSH / VNC)
    llm_providers: 8 (+ ERNIE / Doubao / Hunyuan / 自部署)
    os: + Android (Termux)
  
  phase_3_12m:
    protocols: 16 (+ KNX / SCPI / Modbus RTU / FANUC)
    llm_providers: 13 (+ Claude / GPT-5 / Gemini / Grok / MiniMax)
    rival_adapters: 0 (推迟)
  
  phase_4_24m+:
    protocols: 18+ (+ 国密 + 罕见协议)
    llm_providers: 16+ (+ 自部署 + 任意 OpenAI 兼容)
    rival_adapters: 5 (Ignition / 卡奥斯 / 华为 / TPT-2 / AISCADA)
    locale: 中国 + 东南亚 + 全球
```

---

## 4. 反向兼容刀刃 (Phase 4, 但接口 Day 1 就在)

### 4.1 接口先行

```typescript
// Phase 0 就定义, 仅在 Phase 4 实现
interface RivalAdapter extends ProtocolAdapter {
  readonly rivalProduct: 'ignition' | 'kaos' | 'pangu' | 'tpt2' | 'aiscada';
  readonly trustLevel: 'verified_mtls' | 'channel_only' | 'unverified';
  readonly compatibilityTested: boolean;       // 必须经第三方测试
  
  // 强制单向数据流: 仅读, 不写
  readonly capabilities: ReadOnlyCapability[];
  
  // 数据源信任校验
  validateSource(data: any): TrustValidation;
  
  // 多源交叉校验 (>= 2 独立通道)
  crossValidate(data: any, otherSources: DataSource[]): CrossValidationResult;
}
```

### 4.2 Phase 4 启用条件

```yaml
phase_4_rival_adapter_prerequisites:
  - OSS Core 已发布 ≥ 6 月
  - 至少 30 家付费客户稳定运行
  - 第三方安全审计通过 SLSA L3
  - 红队评分 ≥ 70 (越高越安全, 反向后)
  - 独立法务审查 (反向兼容是否触犯竞品 ToS)
  - 至少 2 家工厂客户主动要求该兼容功能

failure_to_meet_prerequisite:
  - 推迟到 Phase 5
  - 不强行做, 不为做而做
```

---

## 5. ISV 商店刀刃 (Phase 3, 但接口 Day 1 就在)

### 5.1 ISV 接口契约 (从 Day 1)

```typescript
// ISV 看到这个接口就知道未来怎么写 Skill
interface ISVSkillManifest {
  id: string;                          // com.acme.line-monitor
  version: string;
  isv: ISVIdentity;                    // 必须 isv-key 签名
  
  // capability manifest — 关键安全边界
  required_mcp_capabilities: string[]; // ['opcua-mcp.read_*', 'hikvision-mcp.snapshot']
  required_llm_use_cases: string[];    // ['classify', 'summarize']
  
  network_access:
    type: 'none' | 'allowlist'
    allowlist?: string[]                // 仅这些域名可访问
  
  resource_limits:
    cpu_quota: number                   // 0.5 core
    memory_quota: number                // 512 MB
    timeout_ms: number                  // 30000
  
  audit:
    log_every_call: true                // 强制
    quarantine_on_anomaly: true
}
```

### 5.2 ISV 沙箱实现进度

| Phase | 实现 |
|---|---|
| Phase 0 | 接口完整定义, 内部 Skill 不走沙箱 |
| Phase 1 | 沙箱 stub (子进程隔离, 无完整资源限制) |
| Phase 2 | 完整沙箱 (cgroup + seccomp + 网络白名单) |
| Phase 3 | ISV 商店上线 + 第三方安全审计流程 |
| Phase 4+ | 商店成熟, 80/20 分润运营 |

---

## 6. OSS Core 刀刃 (Phase 2, 但代码 Day 1 就 OSS-ready)

### 6.1 Day 1 OSS-ready 实践

```yaml
oss_readiness_from_day_1:
  license:
    all_files_have_apache_2_0_header: true
    no_proprietary_dependencies: enforced_in_ci
  
  documentation:
    every_module_has_readme: true
    architecture_docs_in_chinese_and_english: true
    extension_guide_per_interface: true
  
  testing:
    unit_test_coverage: ≥ 70%
    interface_conformance_tests: required
  
  security:
    sigstore_signed_commits: required from day_1
    dependabot_enabled: true
    sbom_per_release: required
  
  community_readiness:
    code_of_conduct: present
    contributing_md: present
    issue_templates: present
    pr_templates: present
    dco_check: enabled

note: |
  Phase 0-2 期间仓库私有 (GitHub private repo).
  Phase 2 末转 public, 已有 6 月清晰提交历史 + 完整文档.
  避免"突然公开" → 历史脏 + 没文档 → 社区差评.
```

### 6.2 OSS 公开发布渐进式 (Phase 2)

```yaml
oss_public_release_stages:
  stage_1_private_to_invite_only:
    duration: 6 weeks
    audience: 20 邀请客户 + 10 ISV
    license: Apache 2.0 (private repo, NDA)
    feedback_loop: weekly
  
  stage_2_invite_to_public_beta:
    duration: 8 weeks
    audience: GitHub public + Hacker News + 工业自动化社区
    license: Apache 2.0
    target: 1k stars, 50 contributors
  
  stage_3_v1_release:
    duration: 4 weeks
    audience: 媒体宣传 + 行业大会演讲 + 培训
    target: 5k stars, 100 ISV signups
```

---

## 7. 国际化刀刃 (Phase 4, 但 i18n Day 1 就在)

### 7.1 i18n 框架从 Day 1

```typescript
// 即使 Phase 0 只有中文, 接口已为多语言准备
interface LocaleProvider {
  readonly locale: string;             // 'zh-CN' / 'en-US' / 'vi-VN' / ...
  readonly currency: string;           // 'CNY' / 'USD' / 'VND'
  readonly compliance: ComplianceTags[]; // ['china_pipl', 'gdpr', 'vietnam_pdpd']
  readonly llm_provider_filter: LLMProviderFilter; // 不同地区可用的 LLM
  readonly tax_calculator: TaxCalculator;
}

// Phase 0: 仅 zh-CN
// Phase 1: + en-US (国际客户咨询)
// Phase 4: + vi-VN, th-TH, id-ID, es-MX (东南亚 + 墨西哥)
```

### 7.2 东南亚优先 (Phase 4 突破点)

按市场专家建议, 东南亚中国系工厂是 v1.6/v1.7 的破局点:

```yaml
southeast_asia_strategy:
  rationale:
    - 越南/泰国/墨西哥的中国系工厂数字化需求强
    - 用中国 PLC (汇川/信捷/三菱日产) + 海外 LLM (Claude/GPT)
    - 无信创合规约束 (海外可用 Claude / GPT-5)
    - 竞品几乎不覆盖 (卡奥斯/华为不出海)
  
  phase_4_goal:
    - 5+ 东南亚中国系工厂客户
    - 越南/泰国/墨西哥 i18n 完成
    - 海外支付通道 (Stripe / Wise)
```

---

## 8. 安全防御 Day 1 就到位 (不给红队机会)

### 8.1 即使 Phase 0 只 2 用户, 安全也是企业级

```yaml
day_1_security:
  configuration_signing:
    devices_yaml: ed25519 (Phase 0 强制)
    policies_yaml: ed25519 (Phase 0 强制)
    llm_providers_yaml: ed25519 (Phase 0 强制)        # v1.6 红队 #1 修复
    judge_llm_config: ed25519 + system prompt hash pin (Phase 0 强制)
  
  supply_chain:
    sigstore_signed_commits: from day_1
    pinned_dependencies: lock 文件 SHA256 (Phase 0 强制)
    slsa_level: L3 (Phase 1 末达到, Phase 0 准备)
  
  judge_consensus:
    heterogeneity_enforce: hard_block_on_startup (Phase 0)  # 接受红队 #2 建议
    approve_threshold: max_individual_risk < 0.30
    divergence_threshold: |score_a - score_b| < 0.20         # v1.4 修订接受
  
  llm_endpoint:
    whitelist_only: true                                     # 红队 #3 修复
    no_user_added_relay: Phase 0 起禁用                      
    pii_scanner_enabled: Phase 1 起
  
  data_sovereignty:
    enforce_from_day_1: true
    important_data_never_overseas: hardcoded
  
  policies_yaml:
    signed_required: true                                     # 红队 #5 修复
    runtime_enforce_invariant: 异构裁判检查代码硬编码
    integrity_check_on_load: true
```

### 8.2 红队评分预期 (Day 1 即合格)

| 阶段 | 红队评分 (越低越安全) | 备注 |
|---|---|---|
| v1.6 屠龙刀实评 | 38 | 攻击面太大 |
| v1.7 单刃 | 55 | OSS 推迟 + 4 P0 加固 |
| **v1.8 Day 1** | **45-50** | 接口安全 + Day 1 加固 |
| v1.8 Phase 1 末 | 35-40 | SLSA L3 + 沙箱 stub |
| v1.8 Phase 2 末 (OSS 发布) | 30-35 | 第三方审计通过 |
| v1.8 Phase 3 末 | 25-30 | ISV 商店成熟 + 商业客户验证 |

---

## 9. 工作量重新分配 (诚实)

### 9.1 v1.8 vs v1.7 对比

| Phase | v1.7 (利剑) | v1.8 (屠龙刀框架 + 利剑实施) | 增量 |
|---|---|---|---|
| Phase 0 PoC | 30 人日 | **45 人日** (+15 接口设计 + 18 协议目录骨架 + 安全 Day 1) |
| Phase 0.5 客户验证 | 90 人日 | 90 人日 |
| Phase 1 客户验证 | 240 人日 | 240 人日 |
| Phase 2 OSS Core | 360 人日 | 360 人日 |
| Phase 3 Pro + ISV | 720 人日 | 720 人日 |
| Phase 4 反向兼容 + 国际化 (新增) | — | 480 人日 |
| **合计** | 1440 | **1935** |

### 9.2 关键: Phase 0 +15 人日的价值

```
+15 人日花在哪:
- 七大核心接口完整定义 (TypeScript 类型 + 文档): 5 人日
- 18 协议目录骨架 + README + 接口位留: 3 人日
- 16 LLM Adapter 接口骨架: 2 人日
- ISV Skill 商店接口骨架 + 沙箱接口: 3 人日
- 反向兼容竞品接口 + i18n 接口骨架: 2 人日

回报:
- Phase 1+ 添加新协议 = 填空, 不改主结构 (节省 50+ 人日)
- Phase 2 OSS 发布时, 仓库结构清晰, 文档完整 (节省 80+ 人日)
- Phase 3 ISV 商店上线时, 接口已稳定 (节省 60+ 人日)
- Phase 4 反向兼容时, 接口已为之准备 (节省 40+ 人日)

ROI: +15 人日投入, 节省 230+ 人日, 净收益 215 人日.
```

---

## 10. 评分预期 (诚实)

| 维度 | v1.6 屠龙刀 | v1.7 利剑 | **v1.8 框架+利剑** |
|---|---|---|---|
| 架构稳健性 | 78 | 82 | **88** (七大接口 Day 1 完整 + 安全 Day 1) |
| 市场可行性 | 70 | 75 | **77** (路径清晰 + 长期屠龙刀蓝图清晰) |
| 算法稳健性 | 80 | 80 | **82** (异构强制 + 数据主权 Day 1) |
| 红队安全 | 38 | 55 (OSS 推迟) | **65** (接口安全 + Day 1 加固, 比 v1.7 好) |
| 工程可执行 | 62 | 80 | **80** (+15 人日合理) |
| **综合** | **74** | **78-80** | **≈ 82-84 (B / B+ 临界)** |

**v1.8 比 v1.7 高 4 分**, 因为:
1. 长期蓝图更清晰 (投资人 + 团队信心)
2. ISV 看接口就知道扩展点 (生态吸引力)
3. 安全 Day 1 就到位 (红队评分提升)
4. Phase 1+ 节省 200+ 人日 (执行效率)

---

## 11. 战略一句话总结

> **v1.6 错在: 想 8 周做出 18 协议屠龙刀, 工程崩盘.**
> **v1.7 错在: 砍到只剩单刃, 投资人 / 团队 / ISV 看不到长期愿景.**
> **v1.8 取中: 架构 = 屠龙刀蓝图 (Day 1 完整七接口), 实施 = 利剑节奏 (4 周 30+ 人日聚焦).**
>
> **本质**: 不是"打几把刀", 而是"做一个永远能扩刀的刀架".
> 刀架建好了, 第一把刀只 5%, 但第二把第三把不需要重做刀架.
>
> 24 月后, 刀架上挂着 18 把刀, 每把都是真的屠龙刀.

---

## 12. 修订记录

| 版本 | 日期 | 变更 | 自评 | 实评 |
|---|---|---|---|---|
| v1.0-v1.5 | 2026-04-25 | 多轮工程修复 | 56.6 → 76 | — |
| v1.6 屠龙刀 | 2026-04-25 | 三刃齐挥 | 83-86 | 74 |
| v1.7 利剑 | 2026-04-25 | 单刃聚焦 | 78-80 | — |
| **v1.8** | **2026-04-25** | **屠龙刀框架 + 利剑实施 (七大接口 Day 1 + 渐进展开)** | **82-84** | **PoC 验证后回填** |

---

## 13. 立即下一步

### 今天

1. 创始人 + 技术合伙人评审 v1.8 的"屠龙刀框架 + 利剑实施"是否真的可行
2. 确认接口设计的 +15 人日是否值得 (vs 短期 PoC)

### 本周

3. **Day 1-3 spike**: 七大核心接口的 TypeScript 类型定义草稿
4. **Day 4-5**: 18 协议目录骨架创建 + README 模板
5. **Day 6-7**: Phase 0 项目脚手架 (monorepo + workspaces + CI)

### 本月

6. Phase 0 PoC 启动 (4 周, 45 人日)
   - Week 1: 接口完整 + Headscale + 2 LLM Adapter
   - Week 2: 汇川 H5U MCP server (真机调试)
   - Week 3: 信捷 XDH MCP server + Edge Gateway
   - Week 4: Policy Engine + Audit Log + 1 业务 Skill + 演示视频

7. 同步: 客户开发 (40 家) + ISV 名单 (10 家)

---

> **v1.8 终极承诺**:
> 
> **架构敢想屠龙刀, 实施敢砍到 5%. 5% 永远在屠龙刀骨架上, 不是孤立的小作品.**
> 
> 24 月后回头看, 第一刃 (汇川 MCP) 与第十八刃 (Ignition 反向兼容) 共享同一接口契约.
> 这才是真正的"无缝可扩展", 不是嘴上说说.