uclawos-sdk (Rust)

U-ClawOS SDK (Rust) —— UCP 协议的官方 Rust 实现。 协议规范：docs/14-UCP协议规范.md License: MIT

这是什么

这个 crate 给三类使用者：

1. 虾盘管家（本仓库的 Tauri 应用）—— 通过 path 依赖直接用
2. 第三方 Orchestrator 实现者 —— 想在 UCP 之上做自己的桌面客户端
3. Agent adapter 作者 —— 想把自家 AI CLI 接入 U-ClawOS 时校验自己的 agent.toml

提供什么

模块	功能
model	UCP 数据模型（AgentManifest / Job / Step / Trigger 等 Rust struct）
parse	agent.toml / job.toml 解析器（serde + toml）
validate	JSON Schema 校验（feature validate）
install	跨平台装机执行器（feature runtime，调 PowerShell / bash 脚本）
health	健康检查（命令 / TCP 端口 / HTTP GET 三种）
error	统一错误类型

用法（草案 v0.1）

use uclawos_sdk::{parse_agent_manifest, AgentManifest};

fn main() -> anyhow::Result<()> {
    let toml_text = std::fs::read_to_string("agents/openclaw/agent.toml")?;
    let manifest: AgentManifest = parse_agent_manifest(&toml_text)?;

    println!("Agent: {} v{}", manifest.meta.id, manifest.meta.ucp_version);
    println!("Capabilities: {:?}", manifest.capabilities.tags);

    Ok(())
}

v0.1 范围

✅ model 完整 struct ✅ parse agent.toml → AgentManifest ✅ validate（自包含 schemas/agent.schema.json，feature validate） ✅ install runtime（feature runtime，跨平台 PowerShell / bash 装机） ✅ health（command / TCP / HTTP GET 三种检查） ✅ orchestrator dispatch 派单 ✅ 12+ 集成测试（含 reference adapter 全量校验）

引用方式

当前（monorepo）：

# 在 src-tauri/Cargo.toml
[dependencies]
uclawos-sdk = { path = "../sdk/sdk-rust", features = ["validate", "runtime"] }

计划（推 github.com/uclawos/sdk + crates.io 发布后）：

uclawos-sdk = { version = "0.1", features = ["validate", "runtime"] }
# 或：uclawos-sdk = { git = "https://github.com/uclawos/sdk", tag = "v0.1.0" }

协议版本

本 crate 实现 UCP v0.1。protocol_version() 返回 "0.1"。