跳转到主要内容

​
1. 协议愿景：业务逻辑的“集装箱”

在 AI 时代，业务逻辑正变得碎片化且不可控。Runly Protocol 旨在定义一套工业级的逻辑封装标准。正如 Docker 封装了运行环境，Runly 封装了业务执行的路径。 通过 RSS (Runly SOP Standard)，开发者可以将非标的“Prompt 交互”升级为具备 MeID 身份确权、异构资源契约、人工卡点（HITL）以及自动化版税分账 能力的数字化逻辑资产。

​
2. 核心架构设计 (The 7-Domain Model)

一份 .runly 资产文件由七个核心域组成，确保了逻辑在全生命周期内的安全性与确定性。 2.1. Manifest (协议名片)
  • 确权与唯一性：通过 URN 标识资产身份，并绑定基于 Runly Me 的创作者 MeID。
  • 版本控制：遵循 SemVer 2.0.0 规范，确保下游集成的稳定性。
2.2. Knowledge (知识契约)
  • RAG 标准化：定义语义检索（RAG）或向量数据库的接入规范，实现动态知识注入。
2.3. Skills (技能契约)
  • 工具解耦：静态定义协议所需的外部 Action（如 REST API、本地脚本），支持输入输出 Schema 强校验。
2.4. Dictionary (数据字典)
  • 强类型准入：支持 string, json, file, enum 等，在数据进入 AI 节点前拦截异常。
  • 交付定义：定义最终生成的 Artifacts（如 HTML 报告或 JSON 数据包）。
2.5. Topology (逻辑拓扑)
  • 执行语义：定义 AI_TASK (生成)、LOGIC_GATE (决策)、HITL (人工审批) 的执行流。
  • 状态机挂起：原生支持流程在关键决策点暂停，等待专家通过 Runly Me 授权唤醒。
2.6. Commerce (商业分账)
  • 自动结算：内置定价模型与版税比例（Royalty Share），实现“调用即结算”。
2.7. Security (安全指纹)
  • 防篡改：集成 Ed25519 数字签名，任何对逻辑的篡改都将导致签名验证失效。

​
3. 为什么选择 Runly Protocol？

特性传统 AI 开发模式Runly Protocol (RSS)
逻辑稳定性高度依赖 Prompt，易产生幻觉逻辑门限与强类型 Schema 强制约束
集成成本需为每个模型编写大量适配代码标准化 SDK，资产即插即用
人工核验需手动开发审批后台与状态机原生支持 HITL 挂起与断点续传
变现能力难以对“一段代码”进行定价协议内置分账逻辑，调用即结算

​
4. 开发者集成指南 (Step-by-Step)

第一步：初始化资产 (Init) 使用 CLI 创建符合 7 域标准的模板。 
runly-cli init expert_logic
第二步：编排拓扑与资源 (Orchestrate) 在 .runly 文件中声明技能引用与任务流。 
skills:
  - id: "market_api"
    config: { endpoint: "https://api.data.com" }

topology:
  nodes:
    - id: "analyze"
      type: "AI_TASK"
      on_success: "expert_gate"
    - id: "expert_gate"
      type: "HITL"
第三步：编译与签名 (Build) 使用专家私钥签署资产。 
runly-cli build expert_logic.runly
# 输出固化资产: dist.runly
第四步：发布与部署 (Deploy) 推送到 Hub 或通过 SDK 调用。 
runly-cli publish dist.runly

​
5. 报流协议：RSS Message (Packet Standard)

​
5.1. 请求报文 (Request Packet)

{
  "header": {
    "protocol_version": "v1.1",
    "trace_id": "req-8899-001",
    "timestamp": 1738746029
  },
  "asset": {
    "urn": "urn:runly:ecommerce:analyzer:v1",
    "signature": "ed25519:sig_data..."
  },
  "payload": {
    "current_node": "expert_gate",
    "state_data": { 
        "action": "RESUME", 
        "input_override": { "decision": "APPROVED" } 
    }, 
    "global_inputs": { "target_asin": "B08N5KXXXX" } 
  }
}

​
5.2. 返回报文 (Response Packet)

{
  "header": { "trace_id": "req-8899-001" },
  "status": {
    "code": 202,
    "state": "SUSPENDED",
    "node_id": "expert_gate",
    "message": "Awaiting expert authorization."
  },
  "result": {
    "artifacts": { "report_url": "https://cdn.runly.net/a/x8y2.html" }
  }
}

​
6. 开发者生态与支持

  • Runly Hub：在线的可视化协议编辑器与资产管理仓库，支持一键发布与版本管理。
  • Runly Executor：轻量级、高性能的逻辑执行引擎，支持云端部署与边缘部署。
  • Runly Me：专家的数字身份终端，用于接收 HITL 节点推送并进行安全签名决策。

​
7. 名词解释表 (Glossary)

术语通俗解释业务价值
MeID专家的“数字身份证”确保资产收益准确归属于创作者。
HITL“人工卡点”防止 AI 在高价值决策中跑偏，确保专家背书。
Artifact“数字产物”最终交付给客户的报告或数据成果（PDF/HTML/JSON）。
Royalty“逻辑版税”实现专家经验的“睡后收入”，调用即分账。
Snapshot“执行快照”流程挂起时保存的状态，允许跨设备无缝继续执行。