1. URN (Uniform Resource Name) 规范
定义: URN 是逻辑资产在 Runly 全球生态中的唯一、永久、位置无关的逻辑地址。它确保了当逻辑从 Hub 迁移到 Store,或者集成到第三方企业系统时,其身份标识始终保持一致。- 标准格式:
urn:runly:<domain>:<sub_domain>:<asset_name>:<unique_suffix> - 字段解析:
runly: 协议固定的前缀,声明该资产遵循 Runly 协议标准。domain: 行业大类。用于全局索引和分类(如:ecommerce,legal,fintech,devops)。sub_domain: 细分场景。定义大类下的具体业务领域(如:amazon,kyc,seo,saas)。asset_name: 逻辑资产的语义化名称。需具备描述性,统一使用连字符命名(kebab-case)。unique_suffix: 唯一识别后缀。由作者自定义的版本标识或系统生成的短哈希,用于区分同名资产的不同分支。
- 示例:
urn:runly:ecommerce:amazon:selection-expert:v1-8892
2. Version (版本号) 规范
定义: 协议版本遵循 Semantic Versioning (语义化版本) 规范。版本号不仅代表了逻辑的迭代顺序,还定义了执行引擎对该逻辑资产的兼容性预期。- 标准格式:
X.Y.Z(Major.Minor.Patch) - 字段解析:
Major (主版本号):涉及协议底层结构变更、删除必填字段或重大的逻辑流改动,导致无法向前兼容。Minor (次版本号):增加了新节点、新变量或可选配置,保持向前兼容。Patch (修订号):仅针对 Prompt 微调、节点描述修正或不改变接口定义的逻辑修复。
- 示例:
1.2.4
3. Type (协议类型) 规范
定义: Type 声明了该资产的运行模态。执行引擎根据此字段分配不同的运行沙箱环境、资源限制和节点解析逻辑。- 标准枚举值:
SOP_FLOW: 标准业务流。包含完整闭环,支持从输入到交付的全流程节点。LOGIC_MODULE: 逻辑组件。属于子流程,设计用于被其他协议嵌套调用,不可独立执行。DATA_AGENT: 数据智能体。侧重于多源数据抓取与结构化转换,不含人工卡点。DECISION_TREE: 决策树。侧重于复杂的条件判定逻辑,常用于合规与审批场景。
- 示例:
SOP_FLOW
4. Creator (创建者身份) 规范
定义: 声明资产的法律归属与结算主体。通过公钥与唯一 ID 建立资产与 Runly Me 之间的不可篡改联系。- 字段解析:
me_id: 创建者在 Runly 全球身份中心注册的唯一 ID。pub_key: 创建者的 Ed25519 公钥,用于验证资产文件的数字签名。name: 创建者的品牌或个人显示名称(可选)。
- 示例:
me_id: "me_dow_001",pub_key: "ed25519:0x8e...331a"
5. Status (资产状态) 规范
定义: Status 声明了当前逻辑资产的可用性阶段。它指导 Runly Store 的展示策略以及 Runly Executor 在加载时的警告级别。- 标准枚举值:
alpha: 内部测试版本。仅限作者本人或特定授权 ID 运行,可能包含未经验证的逻辑。beta: 公开测试版本。允许外部用户试用,但不建议在生产环境的大规模业务中使用。stable: 稳定商用版本。逻辑经过鲁棒性测试,承诺接口稳定性,适用于正式业务场景。deprecated: 已废弃版本。该版本存在安全风险或已被新版本取代,执行引擎加载时会触发强警告。
- 示例:
status: "stable"
6. Created_at (创建时间) 规范
定义: 资产初次生成的原始时间戳。该字段一旦在初始版本(v1.0.0)中确定,在后续的修订版或次版本迭代中应保持不变,用于追溯资产的历史源头。- 标准格式: ISO 8601 扩展格式(UTC 时间),即
YYYY-MM-DDTHH:MM:SSZ。 - 示例:
created_at: "2026-01-20T08:00:00Z"
7. Updated_at (更新时间) 规范
定义: 资产最近一次进行逻辑修改、重新编译并签名的时刻。执行引擎通过对比updated_at 和本地缓存时间,决定是否需要重新加载或同步最新的逻辑包。
- 标准格式: ISO 8601 扩展格式(UTC 时间),即
YYYY-MM-DDTHH:MM:SSZ。 - 约束: 该时间戳必须大于或等于
created_at。 - 示例:
updated_at: "2026-02-05T18:45:00Z"
8. Min_runtime (最低运行时版本) 规范
定义: 声明该协议运行所需的 Runly Executor (执行引擎) 的最低版本号。这确保了较新的协议特性(如新定义的节点类型或加密算法)不会在过旧的引擎上因无法解析而导致崩溃。- 标准格式: 采用
v前缀加上主版本或次版本号(如v1.0,v2.1)。 - 验证逻辑: 执行引擎在解析前会检查自身版本,若
Local_Runtime_Version < min_runtime,则拒绝执行并报错。 - 示例:
min_runtime: "v1.0"
