协议与接口
火种协议与 API 概览
概述火种协议的设计目标、接口约束与兼容性,帮助未来工具安全读取或验证火种。
状态
Phase 1(草案)/ 双语
范围
描述火种协议的设计原则、数据结构与 API 约束,为解析、校验与互操作提供统一边界。
非目标
不覆盖具体实现细节、托管政策或 SDK 用例,只聚焦协议层定义。
设计原则
优先可验证性与隐私隔离,接口默认最小权限读取。协议鼓励离线校验与本地解密,避免服务端存储明文。
核心数据结构
定义 capsule manifest、时间线索引、附件引用与签名块。每个模块都有版本号与哈希指纹,支持向后兼容。
接口与访问控制
提供读取、校验、导出三类接口,默认只暴露经过脱敏的元数据。访问令牌可绑定范围与期限,便于托管或审计。
互操作与迁移
列出与常见归档格式的映射策略,包含文本、媒体与校验链的转换规则。说明如何在协议升级时维持老版本可解析。
路线图
第一阶段聚焦本地解析 SDK 与 CLI;第二阶段开放只读 API 沙箱;第三阶段评估多方托管接口,统一审计日志与撤销机制。