用途:帮助使用 spacetime 命令行工具完成 SpacetimeDB 项目的初始化、模块构建、数据库发布、数据查询与服务器管理,并排查 CLI 问题。
主要能力:项目初始化与开发(spacetime init my-project --lang rust|csharp|typescript|cpp,spacetime build,spacetime dev 自动重建与发布并生成绑定,spacetime generate 生成客户端绑定);发布与部署(spacetime publish my-database --yes,可指定 --server local 或 --clear-database);数据库交互(spacetime sql 执行 SQL 或进入交互模式,spacetime call 调用 reducer,spacetime subscribe 订阅变更,spacetime logs 查看日志,spacetime describe 查看 schema);数据库管理(list、delete、rename);服务器管理(server list/add/set-default/ping、start、server clear);认证(login、login --token、login show、logout)。
使用方式:默认服务器为 maincloud,本地为 http://127.0.0.1:3000。常用标志包括 --server/-s、--yes/-y、--anonymous、--module-path/-p。典型流程为先 spacetime login,再 init 项目,然后 dev 或 build 后 publish,最后用 sql 查询。脚本中建议加 --yes 避免交互提示。
适用场景:SpacetimeDB 模块开发、本地调试、发布到云端或本地服务器、生成客户端绑定、查询与订阅数据。
限制:许多命令标记为 UNSTABLE,可能变化;模块语言支持 Rust、C#、TypeScript、C++,客户端 SDK 支持 TypeScript、C#、Rust、Python、Unreal Engine,CLI 生成目标为 TypeScript、C#、Rust、Unreal C++;Rust 模块需 wasm32-unknown-unknown 目标。具体收费、价格与平台细节暂未提供。