开始使用 Sine Kits
打开获准的工作区、理解计费边界,并用当前 CLI 开发独立 Kit。
打开工作区
通过导航中的「我的 Kits」进入控制台,使用平台账户登录。当前安装属于发布者沙箱,不是购买结果:你需要是开发者项目的所有者或平台测试管理员,所选环境还必须有可用发行版本与已就绪部署。production 安装另外要求发行版本已获批准。
如果没有相应访问权,平台订阅或已下载的 Skill 都不能绕过检查。当前预览不是公开的付费 Kit 市场。
从控制台打开可用安装,并在专属子站中完成授权。子站通过平台授权流程获得绑定安装的访问权,不共享平台登录 Cookie。授权过期后应重新授权,不要把令牌复制到 URL 或配置文件中。
完成首次 Game Dev Kit 操作
- 打开已获授权的 Game Dev Kit 安装。
- 在项目工作区填写项目名称与简介。
- 提交创建操作,在操作视图中查看对应任务。
- 任务成功后回到项目列表,查看持久化的
game-project记录。 - 使用资源与任务视图,查看同一安装内的文件与操作历史。
projects.create 保存项目记录,不生成游戏或模型。任务已受理不等于结果已完成。失败时先检查可用的错误和日志,再决定是否重新提交。取消任务不会撤销已写入的数据,也不保证第三方服务已经停止。
安装、连接与授权
Installation(安装) 确定私人工作区和发行版本;Entitlement(权益) 描述使用 Kit 的权利;Connection(连接) 标识第三方服务账户;Grant(授权) 限定 Agent 可以做什么。它们是独立的检查项,不是可互相替代的成功状态。
当前 Game Dev Kit 的项目记录操作不需要模型供应商连接。不要为了开启 3D 生成而配置或付费购买连接,因为该能力尚未提供。下载的 Skills 是操作说明,不含凭证,也不会自行建立通用 Agent 授权流程。
计费与访问权
| 项目 | 当前含义 |
|---|---|
| 平台订阅 | 定价页所说明的平台服务套餐;不是购买源码,也不是所有 Kit 的通行证 |
| 平台积分 | 用于支持计量的平台操作的余额;不代表无限算力、存储或第三方服务用量 |
| Kit 权益 | 使用某个具体 Kit 的独立权利;不能把当前发布者沙箱访问权说成付费市场权益 |
| 第三方服务费用 | 你连接的服务账户产生的费用;供应商可能另行向你收费 |
执行前请查看具体操作及其展示的计费规则。不要假定所有连接调用都会扣平台积分,也不要认为订阅后就获得所有操作权限。preview 部署、开发者登录或构建成功都不是购买。Kit 定价、市场开放、退款与数据保留条款需要明确提供后才能据此使用;本指南不承诺终身访问或无限资源。
开发独立 Kit
准备工具链
使用 Node.js 24.15.0、pnpm 9.4.0、获准的平台账户,以及包含版本化 @sine-kits 包的 registry。当前 SDK/contracts/UI 版本为 0.1.0,CLI 为 0.1.2。已验证的分发流程使用本地 registry,不要假定这些包已经发布到公开 npm。
先在用户级 .npmrc 配置提供给你的 scoped registry 及所需认证。下面的 --registry 参数只配置新项目,不负责配置下载 CLI 本身的 registry。将尖括号参数替换为当前环境的真实值。
pnpm dlx @sine-kits/kit-cli@0.1.2 create my-game-kit --registry <registry-url>
cd my-game-kit
pnpm install --frozen-lockfile
pnpm exec sine-kit --platform <backend-origin> login --web <web-origin>
pnpm exec sine-kit --platform <backend-origin> project create --name my-game-kit
pnpm exec sine-kit --platform <backend-origin> link --project <project-id> --env development使用 project create 返回的项目 ID;已有匹配项目时,用 project list 查找后直接关联。平台本地默认 web 为 http://localhost:7101,backend 为 http://localhost:7103。CLI 默认已注册回调为 http://127.0.0.1:7203/callback。登录使用浏览器授权码与 PKCE;--no-open 只关闭自动打开浏览器,不绕过授权。
项目拥有独立的 manifest、Skills、输入/输出 schema、本地化子站、操作、包版本与锁文件。请放在平台仓库之外,不要链接平台源码,也不要导入私有数据库、认证或 worker 库。
开发、构建与本地预览
pnpm dev该命令启动本地子站与操作 runner,连接真实的 development 安装。默认子站与 runner 端口分别为 7201、7202。按 Ctrl+C 停止前台进程后,再执行:
pnpm check
pnpm build
pnpm previewpreview 提供已构建产物,不是源码开发服务器。dev 与本地 preview 都要求关联 development。运行本地 Kit 代码时,它拥有启动者的操作系统权限;这不是运行不可信代码的安全沙箱。
发布预览并检查状态
停止本地 preview 后发布:
pnpm publish:kit
pnpm exec sine-kit status <deployment-id>
pnpm exec sine-kit logs --deployment <deployment-id>
pnpm exec sine-kit releases list
pnpm exec sine-kit releases inspect <release-id>publish:kit 调用 sine-kit publish --env preview。使用返回的部署与发行 ID。上传完成不等于部署就绪:应通过状态与日志确认部署 ready,或查看明确的失败原因。发行内容不可变,并绑定 digest;发布不同内容的新版本前,先更新 manifest 版本。
审核与受控晋级
pnpm exec sine-kit releases submit <release-id>
pnpm exec sine-kit env list
pnpm exec sine-kit promote <deployment-id> --env production --expected-revision <revision> --confirm-production晋级需要独立审核批准、项目权限、已就绪部署,以及 env list 返回的当前 production 环境 revision。作者不能批准自己的版本。production 是环境名称,不代表公开生产基础设施或商业销售已经验收。
回滚或撤回前,明确选择环境并重新读取该环境的当前 revision:
pnpm exec sine-kit rollback --to <deployment-id> --env preview --expected-revision <revision>
pnpm exec sine-kit unpublish <deployment-id> --env preview --expected-revision <revision> --reason <reason>production 变更还需要 --confirm-production。回滚不会撤销第三方副作用;撤回部署也不等于删除用户数据或将市场商品下架。
继续阅读 SDK 与 API 边界 及 Game Dev Kit 预览范围。