跳转到主要内容
# RSS-DSL Specification v1.0
manifest:
  # 标识
  urn: "urn:runly:ecommerce:listing-expert:v1:7788"
  version: "1.0.5"
  type: "SOP_FLOW"
  title: "Cross-border Listing Optimizer"
  # 身份
  creator:
    me_id: "me_dow_001"
    name: "Dow | Solo Arch Lab"
    pub_key: "ed25519:0x8e...331a"
  # 生命周期
  status: "stable"
  created_at: "2026-01-20T08:00:00Z"
  updated_at: "2026-02-05T18:45:00Z"
  min_runtime: "v1.0"

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"