@ttmg/cli 0.4.6-vibe-beta.15 → 0.4.6-vibe-beta.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (9) hide show
  1. package/README.md +14 -40
  2. package/dist/index.js +270 -136
  3. package/dist/index.js.map +1 -1
  4. package/dist/package.json +2 -2
  5. package/dist/scripts/verify-agent-contract.js +3 -2
  6. package/dist/scripts/vibe-ppe-test-preload.cjs +1 -1
  7. package/dist/scripts/vibe-upload-smoke.js +53 -25
  8. package/package.json +2 -2
  9. package/vibe-upload.md +95 -272
package/README.md CHANGED
@@ -1,34 +1,30 @@
1
1
  ### @ttmg/cli
2
2
 
3
- Vibe 真实网页授权与上传：`ttmg upload --vibe --web --dir ./game --title "My game" --icon ./avatar.png --format ndjson`。只向用户收集标题和本地头像，并使用游戏目录或代码包；其他应用资料由 CLI 使用既有 PPE 试用默认值补齐，不需要用户填写。网页授权后，CLI 自动继续上传。见 [Vibe 接入说明](vibe-upload.md)。
3
+ `0.4.6-vibe-beta.17` 支持上传后扫码预览：`ttmg upload --vibe` 上传完成后继续查询同一任务，收到 `preview_url` 后在原页面显示预览二维码。等待期间保持进程运行；超时或查询失败仍保留上传成功状态，请勿直接重传。详见 [Vibe 接入说明](vibe-upload.md)。
4
4
 
5
- Vibe real web authorization and upload: use `--web` with the title, local icon and game directory or ZIP. Collect only the title and icon from the user; the CLI fills other app metadata with existing PPE trial defaults. Upload continues after browser authorization. See [Vibe integration](vibe-upload.md).
5
+ Version `0.4.6-vibe-beta.17`: `ttmg upload --vibe` keeps polling the same task after upload and shows a game preview QR on the original page when `preview_url` arrives. Keep the process running. A preview timeout or lookup failure preserves the upload receipt; do not upload again.
6
+
7
+ Vibe 手机扫码授权与上传：`ttmg upload --vibe --dir ./game --title "My game" --icon ./avatar.png --format ndjson`。用户在手机 TikTok 扫码授权后，原命令自动上传。只收集标题和本地头像，并使用游戏目录或代码包；其他应用资料由 CLI 补齐。页面展示标题、头像、描述、类型和子类型。见 [Vibe 接入说明](vibe-upload.md)。
8
+
9
+ 扫码上传使用 `0.4.6-vibe-beta.17`，安装后核对版本与能力声明。Snow Crew 已在 PPE 完成真实上传并取得预览链接，用户确认扫码预览跑通；正式环境未开放。
6
10
 
7
11
  `ttmg` is a command-line tool designed for managing and developing mini-game projects. It supports initialization, development, debugging, and packaging for both H5 and native mini-games.
8
12
  `ttmg` 是一款专为小游戏项目管理与开发设计的命令行工具，支持 H5 小游戏和原生小游戏的初始化、开发调试及打包构建。
9
13
 
10
14
  #### Installation 安装
11
15
 
12
- `0.4.6-vibe-beta.15`：Vibe 上传支持 Skill 传入 `--description "游戏描述"`。省略时默认使用 `Discover the fun of TikTok Mini Games.`；旧 `--app-info` 文件中的描述继续保留。详见 [Quick Start 与描述参数](vibe-upload.md)。
13
-
14
- `0.4.6-vibe-beta.15`: Vibe upload accepts `--description "Game description"` from a Skill. When omitted, it uses `Discover the fun of TikTok Mini Games.` or preserves the description from a legacy `--app-info` file. See [Quick Start and description usage](vibe-upload.md).
16
+ Vibe 版本支持手机扫码授权上传、可选 `--description`、分类查询及 `--category / --subcategory`。默认描述为 `Discover the fun of TikTok Mini Games.`，默认分类为 Other/Other。完整流程见 [Quick Start](vibe-upload.md)。
15
17
 
16
- `0.4.6-vibe-beta.14` 支持分类查询与可选上传分类参数。Skill 可用 `ttmg game categories --format json` 查询，再向 Vibe 上传传入 `--category Puzzle --subcategory Physics`。两个参数都省略时保留 Other/Other；详见 [分类用法](vibe-upload.md)。
17
-
18
- `0.4.6-vibe-beta.14` supports category discovery and optional upload classification. Query `ttmg game categories --format json`, then pass `--category Puzzle --subcategory Physics` to Vibe upload. Omitting both preserves Other/Other. See [category usage](vibe-upload.md).
19
-
20
- For Vibe Web authorization and upload, install the `vibe-beta` release:
21
- Vibe 网页授权上传安装 `vibe-beta` 版本：
18
+ 固定版本安装（发布标签为 `vibe-beta`）：
22
19
 
23
20
  ```bash
24
- npm install -g @ttmg/cli@vibe-beta
21
+ npm install -g @ttmg/cli@0.4.6-vibe-beta.17
25
22
  ttmg --version
26
23
  ttmg capabilities --format json
27
24
  ttmg upload --help
28
25
  ```
29
26
 
30
- The package includes [vibe-upload.md](vibe-upload.md). Keep the Web upload process running during authorization and read NDJSON until a terminal event. The `beta` and `vibe-beta` tags point to different published versions.
31
- 安装包包含 [vibe-upload.md](vibe-upload.md)。授权期间保持原 Web 上传进程运行，持续读取 NDJSON，直到收到终态。`beta` 与 `vibe-beta` 指向不同发布版本。
27
+ 安装包包含 [vibe-upload.md](vibe-upload.md)。授权期间保持原上传进程运行，持续读取 NDJSON，直到收到终态。`beta` 与 `vibe-beta` 指向不同发布版本。
32
28
 
33
29
  For Agent and Monetization workflows, the published beta is:
34
30
  Agent、商业化流程的已发布 beta 为：
@@ -68,29 +64,17 @@ npm install @ttmg/cli --save-dev
68
64
 
69
65
  #### Login 登录
70
66
 
71
- To open an existing Vibe task in the system browser, use the `pageUrl` from its
72
- `waiting_authorization` event: `ttmg auth open --page-url <pageUrl> --format json`.
73
- Keep the upload process running; this command creates no task and reports only
74
- `open_requested`, not authorization success. It runs on the CLI computer.
75
-
76
- Skill 如需手动打开网页授权，读取上传进程 `waiting_authorization` 事件的 `pageUrl`，
67
+ Skill 如需重新打开二维码页，读取上传进程 `waiting_authorization` 事件的 `pageUrl`，
77
68
  执行 `ttmg auth open --page-url <pageUrl> --format json`。保持原上传进程运行；
78
69
  新命令在 CLI 所在电脑打开系统浏览器，不新建任务，`open_requested` 不代表授权成功。
79
- `--web` 已自动打开授权页；上述辅助命令只用于重新打开同一任务的授权页。
70
+ 该命令只打开同一任务的本地二维码页，用户仍需手机扫码。
80
71
 
81
- `ttmg upload --vibe --web` uses real browser authorization and uploads to PPE without a prior platform login or environment setup. `--mock` is a separate demo: task creation/polling are real, but authorization and material uploads are simulated. See [Vibe binding/upload](vibe-upload.md) for schema-v2 results.
82
- `ttmg upload --vibe --web` 无需预先平台登录或配置环境，使用真实浏览器授权并上传到 PPE。`--mock` 是独立演示：真实创建／查询任务，模拟授权和素材上传。详见 [Vibe 绑定上传](vibe-upload.md)。
83
-
84
- `--mock` 现在会真实创建 PPE 任务，不再表示全程离线；真实请求失败仍报错。
85
- 上线时由 CLI 发布版本去掉 PPE 路由，Skill 无需承担环境切换。
86
- `--mock` now creates real PPE tasks, not a fully offline run. Real request failures
87
- still fail. Production routing is a future CLI release change, not Skill configuration.
72
+ `ttmg upload --vibe` 无需预先平台登录或配置环境，使用手机 TikTok 扫码授权并上传到 PPE。详见 [Vibe 绑定上传](vibe-upload.md)。
88
73
 
89
74
  当前上传只需要标题、头像和游戏目录或代码包，其他应用资料由 CLI 使用既有 PPE 试用默认值补齐。Skill 读取 `inputRequirements`，不向用户索要额外资料；本地预检使用 `--dry-run`。
90
75
  Current uploads need only the title, icon and game directory or ZIP. The CLI fills other metadata with existing PPE trial defaults. Read `inputRequirements` and do not request extra fields. Use `--dry-run` for local preparation.
91
76
 
92
- For the existing authenticated platform workflow, log in first; Vibe Web upload uses its own browser authorization.
93
- 原有需要平台鉴权的流程仍先登录；Vibe Web 上传使用本次任务的浏览器授权。
77
+ 原有需要平台鉴权的流程仍先登录；Vibe 上传使用本次任务的手机扫码授权。
94
78
 
95
79
  ```
96
80
  ttmg login
@@ -109,16 +93,6 @@ ttmg login --implicit --email <email> --password <password>
109
93
  options when credentials are provided by the execution environment.
110
94
  执行环境也可以通过 `TTMG_LOGIN_EMAIL` 和 `TTMG_LOGIN_PASSWORD` 提供凭据。
111
95
 
112
- Inspect the reusable local session without exposing its Cookie. The status is
113
- local-only; it does not make a network request. `--require-auth` is useful for
114
- Agent preflight because it exits non-zero when login is missing.
115
- 可在不暴露 Cookie 的情况下读取本地会话是否可复用。该状态只检查本地配置，不发起网络请求；Agent 预检可增加 `--require-auth`，未登录时以非零状态退出。
116
-
117
- ```
118
- ttmg auth status --format json
119
- ttmg auth status --format json --require-auth
120
- ```
121
-
122
96
  Agents can discover the exact command and runtime capability surface before
123
97
  acting. Unsupported device and Runtime features are explicitly reported as
124
98
  `false`; commands that create a platform version are marked with