SuperAPI AI 工具集

deepspace

部署与运维

查看项目

更新于 10-16 05:06

技能介绍

用途:DeepSpace 是一个用于在 Cloudflare Workers 上构建实时协作应用的包,提供认证、RBAC、同步记录、消息、集成、支付等能力,并部署到 <name>.app.space。本技能是引导层,说明如何开始、如何操作以及如何查阅文档;https://docs.deep.space 是其余一切内容的权威来源,其建议应作为默认做法。

主要能力与用法:每个应用只有一个 Git 权威来源(DeepSpace 源或 GitHub 源),首次产生源的操作会永久锁定其一,之后不可手动声明或转移;在 GitHub 认领后,DeepSpace 源相关命令会以 source_managed_by_github 拒绝。协作与所有权转移(deepspace app collaborators、deepspace app transfer)会改变部署、读取密钥与所有权,执行前应阅读 app-identity 指南并交由用户决定。

查阅文档:每个任务区域先取一次索引 https://docs.deep.space/llms.txt,选 1–2 页在 URL 后加 .md 获取 Markdown;若不足,用 https://docs.deep.space/llms-full.txt 全文检索确认主题是否存在;类型签名以已安装包 node_modules/deepspace/dist/*.d.ts 为准。MCP 提供 documentation_search 与 documentation_read,仅在用户要求时配置。

操作流程:先认证(npx deepspace auth whoami --json,必要时 npx deepspace auth login),登录为浏览器 OAuth 并轮询最多十分钟,容器或 CI 环境按 auth login --help 指定的环境变量处理,切勿在命令行放置密码。用 npm create deepspace@latest <app-name> 脚手架,需受支持的 Node 版本与 npm 11.6+。应用 id 在首次需要 id 的命令时由服务端生成,执行前先确认登录账号。用 npx deepspace add --list、integrations list 等检查目录后再手工实现功能。测试用 npx deepspace test run(或 all),部署用 npx deepspace deploy。

部署后运维:npx deepspace logs --follow --json、activity、releases、app usage 查看运行情况;升级 SDK 用 npx deepspace@latest app update --json;自定义域名、移动端(npx deepspace add mobile)、下线(deepspace app undeploy)等各有专门指南。

限制与注意:命令拒绝以稳定代码与退出码表达(退出 1 表示修正原因,退出 2 表示尚有本地步骤或判断),应据代码分支而非文字;无附带可执行动作时不要猜测补救。记录字段位于 record.data,put(id, patch) 服务端合并;写入控件需等 useMutations().ready;数据与认证钩子需 (app)/ provider 边界;保留脚手架必需的 users schema;应用密钥放 deepspace secrets;调用者身份仅来自已验证 JWT。活跃应用占用配额槽位,拒绝时由用户选择释放或升级。资料未提供具体收费与价格信息。