跳转到主要内容

​
1. 安装与初始化

首先，确保您的开发环境已安装 Runly 工具链。 
# 使用 npm 或 curl 安装
curl -fsSL https://get.runly.pro/install.sh | sh

# 验证安装
runly-cli --version

​
2. 身份认证 (创建专家身份)

在部署协议前，您需要一个 Runly Me 身份及对应的 ED25519 密钥对。 
# 生成新的开发者密钥对
runly-cli keys generate --name my_expert_key

# 这将生成：
# 1. my_expert_key.pub (公钥，需填入协议 manifest 域)
# 2. my_expert_key.key (私钥，严格保密，用于部署签名)

​
3. 协议预检 (Pre-flight Check)

在正式发布前，CLI 会模拟执行引擎对 dictionary 和 topology 进行静态语法检查，防止因变量引用错误或循环依赖导致部署失败。 
# 执行静态检查
runly-cli check HelloWorld.runly

# 输出示例：
# [SUCCESS] Manifest validation passed.
# [SUCCESS] Topology DAG is valid. No circular dependencies found.
# [SUCCESS] All step references in Dictionary are resolved.

​
4. 编译与签名 (Build & Sign)

这是最关键的一步。CLI 会将 YAML 源码编译成二进制格式，并使用您的私钥对全文件进行哈希签名，生成最终的协议资产。 
# 编译并签名
runly-cli build HelloWorld.runly \\
    --key ./my_expert_key.key \\
    --output selection_expert.runly

# 注意：此时生成的 .runly 文件已包含 manifest.signature，不可篡改。

​
5. 部署至分布式仓库 (Publish)

将资产发布到 Runly Store 或私有 Hub，使其具备全球可调用性。 
# 发布协议
runly-cli publish selection_expert.runly

# 部署成功后，你会获得：
# 资产 URL: <https://store.runly.net/assets/urn:runly:ecommerce:selection-starter:v1:8892>

​
6. 模拟调用 (Test Invocation)

在集成到 SDK 之前，你可以直接在命令行模拟一次调用，测试 inputs 准入和 AI_TASK 逻辑。 
# 模拟运行
runly-cli run selection_expert.runly \\
    --input '{"target_asin": "B08N5KXXXX"}' \\
    --env '{"API_TOKEN": "sk_test_123"}'

# 你将看到节点逐个运行的 Trace 日志，以及最终生成的 Artifact URL。

​
7. 常用速查指令

命令用途备注
runly-cli keys管理身份密钥资产确权的核心
runly-cli check静态语法校验部署前的最后一道防线
runly-cli build编译并签名将源码转为加密资产
runly-cli run本地沙箱执行调试逻辑流与变量映射
runly-cli logs追踪云端执行日志配合 trace_id 排查线上问题