Python SDK

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

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

定位

Python SDK 将提供与 Node.js TokUIBuilder 对齐的链式 API，用于在 Python 服务端生成 TokUI DSL 字符串，配合 SSE 推送到前端。

拟议用法

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

from tokui import TokUIBuilder

b = TokUIBuilder()
b.card(tt="卡片").h2("内容").p("描述").end()
print(b.to_string())
# [card tt:卡片][h2 内容][p 描述][/card]

分块输出配合 SSE 推流：

chunks = b.reset().card(tt="卡片").p("内容").end().to_chunks()
for chunk in chunks:
    yield chunk

能力范围（对齐 Node.js 版）

• 链式调用：自闭合 / 容器（open / end）
• to_string() 一次性输出、to_chunks() 分块数组
• 自动闭合未关闭容器
• 命名避让：row_layout() / col_layout()

进度

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

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