mcpField
S
spacetimedb-cli

spacetimedb-cli

github.com/danmossa开发2166 次安装19 周前更新
代码仓库

关于 spacetimedb-cli

spacetimedb-cli 是用于 `spacetime` 命令行工作流的技能，涵盖模块初始化、构建、发布、代码生成、运行时检查和调试命令。

主要功能

  1. 01模块初始化与构建
  2. 02发布和迁移指引
  3. 03生成客户端绑定
  4. 04数据库调用与 SQL 查询
  5. 05日志和模块检查

适用场景

  1. 01使用 `spacetime dev` 启动本地开发
  2. 02构建并发布模块
  3. 03生成客户端语言绑定
  4. 04检查数据库状态和运行日志

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/danmossa/spacetimedb-skills --skill spacetimedb-cli

安装后在 Claude Code 中输入/spacetimedb-cli确认已加载。

附带文件references/cli-reference-standalone-config.mdreferences/cli-reference.md

详细介绍

将此技能用于 spacetime 命令行工作流。

核心模式

  • 本地迭代通常从 spacetime dev 开始；如果项目布局不是默认布局，请使用 --template、--client-lang、--module-path 和 --module-bindings-path。
  • 模块生命周期命令包括 spacetime init、spacetime build、spacetime publish 和 spacetime generate。
  • 运行时/调试命令包括 spacetime call [DATABASE] <FUNCTION> [ARGS...]、spacetime sql [DATABASE] "<QUERY>"、spacetime logs [DATABASE] 和 spacetime describe --json [DATABASE]。
  • spacetime generate 支持 --lang csharp|typescript|rust|unrealcpp、--out-dir、--module-path 和 --include-private。
  • spacetime publish [name|identity] 默认会进行构建。对于非默认主机，请使用 --server；使用 --break-clients 或 --delete-data 前，请先阅读迁移指南。
  • 数据库名称由小写 ASCII 单词组成，单词之间以连字符分隔。

常见命令形式

spacetime dev --template basic-ts
spacetime build --module-path spacetimedb
spacetime publish my-database
spacetime generate --lang typescript --out-dir client/src/module_bindings --module-path spacetimedb
spacetime call my-database add Alice
spacetime sql my-database "SELECT * FROM person"
spacetime logs my-database --follow --level info

参考索引

需求打开
命令语法和标志CLI 参考
独立服务端配置references/cli-reference-standalone-config.md

指南

  • 为不常见的选项编写最终命令时，优先使用参考文档中的准确 CLI 标志。
  • spacetime generate 的语言、输出目录和模块/数据库名称应与所用的客户端 SDK 保持一致。
  • 如果涉及架构变更，请将发布和迁移行为交由 spacetimedb-databases 处理。

评论

支持 Markdown