协议与接口

火种协议与 API 概览

概述火种协议的设计目标、接口约束与兼容性，帮助未来工具安全读取或验证火种。

状态

Phase 1（草案）/ 双语

范围

描述火种协议的设计原则、数据结构与 API 约束，为解析、校验与互操作提供统一边界。

非目标

不覆盖具体实现细节、托管政策或 SDK 用例，只聚焦协议层定义。

设计原则

优先可验证性与隐私隔离，接口默认最小权限读取。协议鼓励离线校验与本地解密，避免服务端存储明文。

核心数据结构

定义 capsule manifest、时间线索引、附件引用与签名块。每个模块都有版本号与哈希指纹，支持向后兼容。

接口与访问控制

提供读取、校验、导出三类接口，默认只暴露经过脱敏的元数据。访问令牌可绑定范围与期限，便于托管或审计。

互操作与迁移

列出与常见归档格式的映射策略，包含文本、媒体与校验链的转换规则。说明如何在协议升级时维持老版本可解析。

路线图

第一阶段聚焦本地解析 SDK 与 CLI；第二阶段开放只读 API 沙箱；第三阶段评估多方托管接口，统一审计日志与撤销机制。

当前 Capsule Schema（capsule-v2）

该结构来自 fireseedManifestSchemaV2 与 Lab 向导使用的 capsule payload 类型，明确 manifest 与内容分层，支持未来演进。wakePolicy 与 selfProof 等字段保证与 Vol. III 想法兼容，符合 Blueprint 对 AGI 可读性与 schema 兼容性的承诺。

type CapsuleV2 = {
  manifest: {
    title: string;
    language: string;
    timeframeStart?: string;
    timeframeEnd?: string;
    audience?: string;
    tags?: string[];
    publicSummary?: string;
    revisionTag?: string;
  };
  content: {
    structured: {
      bioSummary: string;
      milestones: string;
      values: string;
      boundaries: string;
      reflections: string;
      wakePolicy: string;
      selfProof: string;
    };
    rawContent: string;
  };
  meta: {
    schemaVersion: "capsule-v2";
    createdAt: string;
    updatedAt?: string;
  };
};

meta.schemaVersion 显式标注当前格式（加密封装头同样保留 schemaVersion），以便未来解析器在升级时维持兼容。

Schema 版本与更新记录

协议保持向后兼容，旧版 capsule 仍可解析。

capsule-v1（legacy，scripts/export-smoke.ts 使用）
capsule-v2（current，Lab 向导使用）

返回文档目录