F
Fireseed.net

Trilogy Lab · Portal

检查中…
|

协议与接口

火种协议与 API 概览

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

状态

Phase 1(草案)/ 双语

范围

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

非目标

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

设计原则

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

核心数据结构

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

接口与访问控制

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

互操作与迁移

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

路线图

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