Sine Kits
Sine Kits
Sine Kits
Sine Kits
首页文档博客我的 Kits开发者Sine Kits 产品指南
开始使用 Sine Kits
快速开始

开始使用 Sine Kits

打开获准的工作区、理解计费边界,并用当前 CLI 开发独立 Kit。

打开工作区

通过导航中的「我的 Kits」进入控制台,使用平台账户登录。当前安装属于发布者沙箱,不是购买结果:你需要是开发者项目的所有者或平台测试管理员,所选环境还必须有可用发行版本与已就绪部署。production 安装另外要求发行版本已获批准。

如果没有相应访问权,平台订阅或已下载的 Skill 都不能绕过检查。当前预览不是公开的付费 Kit 市场。

从控制台打开可用安装,并在专属子站中完成授权。子站通过平台授权流程获得绑定安装的访问权,不共享平台登录 Cookie。授权过期后应重新授权,不要把令牌复制到 URL 或配置文件中。

完成首次 Game Dev Kit 操作

  1. 打开已获授权的 Game Dev Kit 安装。
  2. 在项目工作区填写项目名称与简介。
  3. 提交创建操作,在操作视图中查看对应任务。
  4. 任务成功后回到项目列表,查看持久化的 game-project 记录。
  5. 使用资源与任务视图,查看同一安装内的文件与操作历史。

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 preview

preview 提供已构建产物,不是源码开发服务器。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 预览范围。

Sine Kits 产品指南

理解 Kit、私人工作区、授权边界与当前开发者预览的实际能力。

Kit SDK 与 API 边界

当前真实的安装范围浏览器 API、隔离操作能力与开发者控制面。

On this page

打开工作区完成首次 Game Dev Kit 操作安装、连接与授权准备工具链开发、构建与本地预览发布预览并检查状态审核与受控晋级