Skip to content

Rust SDK

🚧 正在迭代开发中 · 状态:规划中

本页描述的 API 尚在设计中,尚未实现。如有意向参与或反馈需求,欢迎在 GitHub Issues 留言。

定位

Rust SDK 将提供与 Node.js TokUIBuilder 对齐的链式 API,用于在 Rust 服务端生成 TokUI DSL 字符串,配合 SSE 推送到前端。强调零依赖与高性能流式输出。

拟议用法

以下为设计草案,最终 API 可能调整。

rust
use tokui::TokUIBuilder;

let mut b = TokUIBuilder::new();
b.card(tt("卡片")).h2("内容").p("描述").end();
println!("{}", b.to_string());
// [card tt:卡片][h2 内容][p 描述][/card]

分块输出配合 SSE 推流:

rust
let chunks: Vec<String> = b.reset()
    .card(tt("卡片"))
    .p("内容")
    .end()
    .to_chunks();
for chunk in chunks {
    // SSE 推流
}

能力范围(对齐 Node.js 版)

  • 链式调用:自闭合 / 容器(open / end
  • to_string() 一次性输出、to_chunks() 分块 Vec<String>
  • 自动闭合未关闭容器
  • 命名避让:row_layout() / col_layout()

进度

  • [ ] 核心链式 API
  • [ ] 自动闭合 / 分块输出
  • [ ] 与 Node.js 版的输出一致性测试
  • [ ] crates.io 发布

完整能力参考见 Node.js Builder 文档