@ttmg/cli 0.4.6-vibe-beta.22 → 0.4.6-vibe-beta.24

package/src/commands/common/game/categoryCatalog.json

@@ -0,0 +1,522 @@
+{
+  "catalogVersion": "sha256:f1d67b08cfbfb9396cba1ec246a84a4c1b6b2c9f077e236498c42e9c154b6900",
+  "source": "bundled",
+  "categories": [
+    {
+      "value": "Action",
+      "subcategories": [
+        {
+          "value": "Artillery Shooter",
+          "description": "Turn based tactics game in which players aim and shoot other players"
+        },
+        {
+          "value": "Asymmetric Battle",
+          "description": "Game in which different players have different roles and capabilities as well as win condition (e.g. Identity 5)"
+        },
+        {
+          "value": "Brawl",
+          "description": "Multiplayer battle where player controls a character in team deathmatch battle without aiming a gun"
+        },
+        {
+          "value": "Fighting",
+          "description": "A game where the player controls a character to fight against other characters"
+        },
+        {
+          "value": "MOBA",
+          "description": "Multiplayer battle arena where the player controls a character on a team to destroy an enemy base"
+        },
+        {
+          "value": "Music & Rhythm",
+          "description": "Games that feature music as the primary gameplay driver"
+        },
+        {
+          "value": "Open World",
+          "description": "Action game in which players can explore the world and attempt objectives freely"
+        },
+        {
+          "value": "Platformer",
+          "description": "A game where players complete stages by avoiding obstacles and jumping between platforms"
+        },
+        {
+          "value": "Royale Battle",
+          "description": "Battle royale game (many players compete but with a single winner) that is action based and not a shooter"
+        },
+        {
+          "value": "Run & Gun Platformer",
+          "description": "Action games similar to side-scrolling platformers, but players are typically battling an onslaught of enemies appearing in front or behind them"
+        },
+        {
+          "value": "Runner",
+          "description": "A game where the player automatically progresses and must avoid obstacles to continue"
+        },
+        {
+          "value": "Shark",
+          "description": "Game in which the player eats other objects in the game to grow or stay alive"
+        },
+        {
+          "value": "Shoot'em Up",
+          "description": "A game where a lone unit (usually a spaceship) shoots projectiles against a large number of other enemies. Generally in a 2D movement space"
+        },
+        {
+          "value": "Slicing (Slasher)",
+          "description": "Game in which the main objective is to cut objects into pieces using a swiping motion"
+        },
+        {
+          "value": "Stealth",
+          "description": "Game where the player attempts to sneak around a game world and achieve objectives or escape"
+        },
+        {
+          "value": "Adventure",
+          "description": "Focuses on the actions themselves (shooting, twitch combat, etc.) or exploration of the world instead (finding non-gameplay collectables, solving puzzles, etc.) - Super Mario"
+        },
+        {
+          "value": "Beat 'em up",
+          "description": "Featuring hand-to-hand combat between the protagonist and an improbably large number of opponents."
+        },
+        {
+          "value": "Other Action",
+          "description": "Other general action gameplay or games that feature arcade-style gameplay"
+        }
+      ]
+    },
+    {
+      "value": "Match",
+      "subcategories": [
+        {
+          "value": "Blast-Meta",
+          "description": "Blast-style game with a heavy emphasis on an investable meta game system"
+        },
+        {
+          "value": "Blast-Saga",
+          "description": "Game where primary mechanic involves blasting/removing adjacent like items with saga based progression"
+        },
+        {
+          "value": "Bubble Shooter",
+          "description": "Game where bubbles are shot at different angles clearing groups of bubbles arranged on top of screen"
+        },
+        {
+          "value": "Connect Tiles",
+          "description": "Game in which two like tiles are linked via a pathway on a board and removed from the board"
+        },
+        {
+          "value": "Line-Saga",
+          "description": "Game where a line is created between like items to remove them from the board with saga based progression"
+        },
+        {
+          "value": "M3-Meta",
+          "description": "Match 3 swapping game with a focus on some form of building in its meta game"
+        },
+        {
+          "value": "M3-Saga",
+          "description": "Primary gameplay mechanism is matching 3 items on screen and swapping matched items"
+        },
+        {
+          "value": "Merge-Saga",
+          "description": "Game with focus on merging like items to create more powerful units or items and utilizing saga based progression"
+        },
+        {
+          "value": "Other-Meta",
+          "description": "Other match style game with a heavy emphasis on an investable meta game system"
+        },
+        {
+          "value": "Other Match",
+          "description": "Other kind of matching game"
+        }
+      ]
+    },
+    {
+      "value": "Puzzle",
+      "subcategories": [
+        {
+          "value": "Block Puzzle",
+          "description": "Game in which players need to fit different shaped block pieces to fit onto a game board efficiently"
+        },
+        {
+          "value": "Brain Puzzle",
+          "description": "Knowledge or intelligence-based puzzle games"
+        },
+        {
+          "value": "Brick-crusher",
+          "description": "A bubble shooter game featuring many balls shot, high action, and real time (not turn based) gameplay"
+        },
+        {
+          "value": "Detective",
+          "description": "Game in which players must solve puzzles based on various clues and involves solving a narrative arc"
+        },
+        {
+          "value": "Hidden Object",
+          "description": "Games where the primary objective is identifying visual elements"
+        },
+        {
+          "value": "Hybrid Puzzle",
+          "description": "Puzzle game involving multiple types of puzzles instead of focusing on just one"
+        },
+        {
+          "value": "Jigsaw",
+          "description": "Jigsaw puzzle game"
+        },
+        {
+          "value": "Klotski",
+          "description": "A sliding block puzzle game"
+        },
+        {
+          "value": "Maze",
+          "description": "Game in which players must determine paths out of a maze"
+        },
+        {
+          "value": "Minesweeper",
+          "description": "Games similar to the classic Minesweeper game"
+        },
+        {
+          "value": "Nonogram",
+          "description": "Game in which cells in a grid are colored or left blank according to numbers on the side of a grid to reveal a hidden picture"
+        },
+        {
+          "value": "Physics",
+          "description": "Games that utilize a physics engine-based primary gameplay mechanism"
+        },
+        {
+          "value": "Room Escape",
+          "description": "Puzzles focused on progressing a player to escape from a room or building"
+        },
+        {
+          "value": "Spot the Difference",
+          "description": "Matching images and determining the difference between the images"
+        },
+        {
+          "value": "Sudoku",
+          "description": "Sudoku based game"
+        },
+        {
+          "value": "Tile-Matching",
+          "description": "Game in which tiles are matched to remove them from the game board (like Tetris)"
+        },
+        {
+          "value": "Word",
+          "description": "Word Games"
+        },
+        {
+          "value": "Other Puzzle",
+          "description": "Puzzle-based games that do not fall into the above categories"
+        }
+      ]
+    },
+    {
+      "value": "Racing",
+      "subcategories": [
+        {
+          "value": "Arcade Racing",
+          "description": "Casual and fun racing arcade type of game"
+        },
+        {
+          "value": "Competitive Racing",
+          "description": "PVP Racing that can use a variety of control schemes"
+        },
+        {
+          "value": "Simulation Racing",
+          "description": "Simulated game of realistic racing"
+        }
+      ]
+    },
+    {
+      "value": "RPG",
+      "subcategories": [
+        {
+          "value": "Empire Simulation RPG",
+          "description": "RPG game in which the player rules an empire or kingdom of some kind"
+        },
+        {
+          "value": "Idle RPG",
+          "description": "Squad based RPG that includes idle progression mechanics"
+        },
+        {
+          "value": "Location RPG",
+          "description": "Game where location plays a critical component in the core gameplay"
+        },
+        {
+          "value": "MMORPG",
+          "description": "Massively multiplayer online role-playing game typically featuring worlds or servers with hundreds or thousands of players online simultaneously"
+        },
+        {
+          "value": "Open World RPG",
+          "description": "RPG game where players traverse an open world relatively freely"
+        },
+        {
+          "value": "Puzzle RPG",
+          "description": "RPG games that utilize a puzzle system as the primary combat mechanism"
+        },
+        {
+          "value": "Roguelike ARPG",
+          "description": "ARPG with roguelike (sub-genre of role-playing games characterized by the exploration of randomly-generated dungeons and permanent death) gameplay elements (e.g. Hades)"
+        },
+        {
+          "value": "Survival",
+          "description": "RPG based game with a strong focus on crafting mechanics"
+        },
+        {
+          "value": "Tactics",
+          "description": "RPG game involving turn based movement of different characters on a tile-based map"
+        },
+        {
+          "value": "Team Battle",
+          "description": "RPG where you control multiple characters to advance the gameplay and story"
+        },
+        {
+          "value": "Tower Defense RPG",
+          "description": "Tower defense game with a strong emphasis on character collection and stateful upgrading"
+        },
+        {
+          "value": "Other RPG",
+          "description": "Other RPG Game"
+        }
+      ]
+    },
+    {
+      "value": "Shooting",
+      "subcategories": [
+        {
+          "value": "Battle Royale",
+          "description": "Shooter game in which battle royale is the primary game mode"
+        },
+        {
+          "value": "Cover-fire",
+          "description": "Shooting game where the player takes cover and shoots out of cover"
+        },
+        {
+          "value": "PvE Shooting",
+          "description": "Shooter game in which players primarily battle against computer generated, player-vs-environment enemies"
+        },
+        {
+          "value": "Sniper",
+          "description": "Shooting game focused on small number of accurate shots through a scope"
+        },
+        {
+          "value": "Team Deathmatch",
+          "description": "Shooter game in which team deathmatch is the primary gameplay mode"
+        }
+      ]
+    },
+    {
+      "value": "Simulation",
+      "subcategories": [
+        {
+          "value": "Animal Avatar",
+          "description": "Game in which players take the form and play as an animal in a virtual world"
+        },
+        {
+          "value": "Avatar Life",
+          "description": "Simulated life based on avatars in an alternate reality world"
+        },
+        {
+          "value": "Build Breed",
+          "description": "Games in which the player grows a city used to breed creatures for combat"
+        },
+        {
+          "value": "Building",
+          "description": "Games focused on building up a city with limited/no focus on combat"
+        },
+        {
+          "value": "Creative Sandbox",
+          "description": "Players have tools to create user generated levels or games shared with the overall game community"
+        },
+        {
+          "value": "Dress Up & Lifestyle",
+          "description": "Games built around dressing up avatars and simulated life-like experiences with emphasis on lifestyle"
+        },
+        {
+          "value": "Driving",
+          "description": "Games where the primary gameplay loop is centered around simulating driving or parking (non-competitive)."
+        },
+        {
+          "value": "Farming",
+          "description": "Farming-based simulation titles"
+        },
+        {
+          "value": "Home Design",
+          "description": "Games involving decorating homes"
+        },
+        {
+          "value": "Idle",
+          "description": "Games where game progression continues even when a player leaves the game session"
+        },
+        {
+          "value": "Idol Training Sim",
+          "description": "Game in which players train and level up Japanese style idols against different types of activities or professions"
+        },
+        {
+          "value": "Life Simulator",
+          "description": "Simulation of a virtual character from birth to death in which the player makes different life choices"
+        },
+        {
+          "value": "Manager",
+          "description": "Games simulating the management of a team or business"
+        },
+        {
+          "value": "Pet",
+          "description": "Games where the primary gameplay loop is centered around raising a pet (non-combat)"
+        },
+        {
+          "value": "Time Management",
+          "description": "Simulation games where players are challenged to complete tasks or quests within a specific (usually short) time frame"
+        },
+        {
+          "value": "Weapon Simulator",
+          "description": "Video game that focuses on simulating the experience of using various weapons. These games aim to provide players with a realistic or immersive representation of different types of firearms, melee weapons, or other tools used in combat"
+        },
+        {
+          "value": "Other Sim",
+          "description": "Other Sim/Management games"
+        }
+      ]
+    },
+    {
+      "value": "Sports",
+      "subcategories": [
+        {
+          "value": "Arcade Sports",
+          "description": "Sports games where gameplay focuses on non-realistic simulation of gameplay"
+        },
+        {
+          "value": "Simulation Sports",
+          "description": "Sports games where the gameplay focuses on realistic simulation of gameplay"
+        },
+        {
+          "value": "Team Manager",
+          "description": "Sports games where the player focuses on manage a team"
+        },
+        {
+          "value": "Other Sports",
+          "description": "Other Sports Games"
+        }
+      ]
+    },
+    {
+      "value": "Strategy",
+      "subcategories": [
+        {
+          "value": "4X March-Battle",
+          "description": "Games where player grows a city, builds an army that attacks through timed marches on a map"
+        },
+        {
+          "value": "Auto Chess",
+          "description": "Tactical strategy game with drafting and in which play is conducted PVP in multiple rounds"
+        },
+        {
+          "value": "Build-Battle",
+          "description": "Games focused on building troops that attack enemies and can be lost. City building is usually used to upgrade troops."
+        },
+        {
+          "value": "CCG-Battle",
+          "description": "Strategy game based on card decks typically associated with mana costs to play"
+        },
+        {
+          "value": "Lane-Battle",
+          "description": "Strategy game involving multiple lanes where units are sent down a specific lane to battle"
+        },
+        {
+          "value": "Legion Battle",
+          "description": "Game with a focus on building different types of army units and battling other players' armies"
+        },
+        {
+          "value": "Summon-Battle",
+          "description": "Games where units are summoned via some means (e.g., cards or mana) and then auto-battle"
+        },
+        {
+          "value": "Tower Defense Strategy",
+          "description": "Games where players establish defenses against NPC enemies that attack the player at regular intervals"
+        },
+        {
+          "value": "RTS",
+          "description": "Real-time Strategy is a strategy game that allow all users to play simultaneously instead of processing incrementally in turns"
+        },
+        {
+          "value": "Other Strategy",
+          "description": "Other strategy games"
+        }
+      ]
+    },
+    {
+      "value": "Party",
+      "subcategories": [
+        {
+          "value": "Guess Something",
+          "description": "Social game in which players must guess what another player has in mind from different kinds of hints or drawings"
+        },
+        {
+          "value": "Karaoke",
+          "description": "A Karaoke game is a type of video or computer game that simulates the experience of karaoke singing"
+        },
+        {
+          "value": "Dancing",
+          "description": "Video game that involves gameplay elements centered around dance and rhythm. These games often require players to mimic dance moves or follow on-screen prompts in synchronization with music."
+        },
+        {
+          "value": "Mafia/Betrayal",
+          "description": "Mafia based game"
+        },
+        {
+          "value": "Mini Games Collection",
+          "description": "Multiplayer social game in which players can choose to play from a collection of multiple minigames"
+        },
+        {
+          "value": "Party Royale",
+          "description": "Party based battle royale game"
+        },
+        {
+          "value": "Quiz",
+          "description": "Game involving trivia or quizzes"
+        },
+        {
+          "value": "Other Party",
+          "description": "Other party game"
+        }
+      ]
+    },
+    {
+      "value": "Tabletop",
+      "subcategories": [
+        {
+          "value": "Board Game",
+          "description": "Board game is a game that involves the movement of counters or other objects round a board."
+        },
+        {
+          "value": "Card Games",
+          "description": "[Non gambling] A card game is any game using playing cards as the primary device with which the game is played, be they traditional or game-specific"
+        },
+        {
+          "value": "Chess",
+          "description": "Chess is a board game for two players, called White and Black. It is sometimes called international chess or Western chess"
+        },
+        {
+          "value": "Dice",
+          "description": "Dice games are games that use or incorporate one or more dice as their sole or central component, usually as a random device"
+        },
+        {
+          "value": "Ludo",
+          "description": "Ludo is a strategy board game for two to four players, in which the players race their four tokens from start to finish according to the rolls of a single die"
+        },
+        {
+          "value": "Othello",
+          "description": "Game based on the classic Othello game"
+        },
+        {
+          "value": "Solitaire",
+          "description": "Solitaire games are card based games that can be played by a single player."
+        },
+        {
+          "value": "Other Tabletop",
+          "description": "Other tabletop game"
+        }
+      ]
+    },
+    {
+      "value": "Other",
+      "subcategories": [
+        {
+          "value": "Other",
+          "description": "Game that doesn't fit in any of the other categories"
+        }
+      ]
+    }
+  ]
+}

package/vibe-upload.md

@@ -2,9 +2,9 @@
 
 `ttmg upload --vibe` 将本地小游戏上传到 TikTok Mini Games。用户提供游戏标题和头像，在手机 TikTok 扫码授权后，CLI 自动完成头像、应用资料和代码包上传。Skill 负责准备工程、调用命令和读取结果；CLI 负责素材校验、打包、授权轮询及上传。
 
-`0.4.6-vibe-beta.22` 支持手机授权、自动上传、同任务轮询和双二维码预览，并兼容后端返回的 TikTok 客户端授权地址。NDJSON 模式下，即使 Skill 将 stdout 保存到文件，控制台仍会在扫码页就绪时显示 `page: <url>`。左侧保留原码用于「查看进度」，右侧从加载态切换为「扫码预览」。页面按浏览器语言显示中英文。当前为 PPE 测试链路，上传完成不代表审核通过或正式发布。
+`0.4.6-vibe-beta.24` 支持手机授权、自动上传、同任务轮询和双二维码预览，并兼容后端返回的 TikTok 客户端授权地址。NDJSON 模式下，即使 Skill 将 stdout 保存到文件，控制台仍会在扫码页就绪时显示 `page: <url>`。左侧保留原码用于「查看进度」，右侧从加载态切换为「扫码预览」。页面按浏览器语言显示中英文。当前为 PPE 测试链路，上传完成不代表审核通过或正式发布。
 
-Version `0.4.6-vibe-beta.22` supports phone authorization, automatic upload, same-task polling and two QR codes, including TikTok client authorization URLs returned by the backend. In NDJSON mode, the console shows `page: <url>` when the scan page is ready, even if the Skill saves stdout to a file. Check progress remains on the left, and the preview loader or QR appears on the right. This is a PPE trial; upload success is not review approval or production release.
+Version `0.4.6-vibe-beta.24` supports phone authorization, automatic upload, same-task polling and two QR codes, including TikTok client authorization URLs returned by the backend. In NDJSON mode, the console shows `page: <url>` when the scan page is ready, even if the Skill saves stdout to a file. Check progress remains on the left, and the preview loader or QR appears on the right. This is a PPE trial; upload success is not review approval or production release.
 
 ## Quick Start
 
@@ -38,10 +38,10 @@ ttmg upload --vibe --dir ./game --title "星环守卫" --icon ./avatar.png --for
 
 在独立 Tool 工程目录调用：`ttmg upload --vibe --minis-type MINI_TOOL --dir ./tool --title "Focus Timer" --icon ./icon.png --format ndjson`。工程身份首次创建后固定类型，不要复用小游戏的 `.ttmg/vibe-project.json`。
 
-安装后确认版本为 `0.4.6-vibe-beta.22`。能力声明中 `authorizationMode=qr`、`previewQr=true`，预览主码用途为 `game_preview`（Tool 为 `tool_preview`），原码仍保留。支持 Node.js 20.19.1–20.x 或 22 及以上版本。
+安装后确认版本为 `0.4.6-vibe-beta.24`。能力声明中 `authorizationMode=qr`、`previewQr=true`，预览主码用途为 `game_preview`（Tool 为 `tool_preview`），原码仍保留。支持 Node.js 20.19.1–20.x 或 22 及以上版本。
 
 ```sh
-npm install -g @ttmg/cli@0.4.6-vibe-beta.22
+npm install -g @ttmg/cli@0.4.6-vibe-beta.24
 ttmg --version
 ttmg capabilities --format json
 ```
@@ -152,6 +152,8 @@ ttmg auth open --page-url <pageUrl> --format json
 
 输出 schema 为 `"2"`。每行 NDJSON 是同一 `operationId` 的状态快照；只有最后一行 `terminal=true`。`--format ndjson` 在 `waiting_authorization` 时另向 stderr 输出一行 `page: <url>`，即使 stdout 重定向到文件也能在控制台看到本地二维码页地址。`--format json` 仅在结束时向 stdout 输出一个对象，等待授权的本地页面地址写到 stderr。不要解析中文／英文文案判断状态。
 
+排查平台请求时可增加 `--verbose`。CLI 会向 stderr 逐行输出 JSON 格式的 `http_request`、`http_response` 或 `http_error` 记录，包括请求序号、方法、URL、请求头、入参、状态码、返回值和耗时；stdout 的 JSON/NDJSON 协议保持不变。token、Cookie、Authorization、邮箱及 URL 中的 token 会显示为 `[REDACTED]`，上传文件只显示类型、文件名和字节数。
+
 - `precheck / packaging / prepared`：正在检查或准备素材；dry-run 的 prepared 为终态。
 
 - `creating_task`：正在准备授权绑定。
@@ -194,7 +196,7 @@ CLI 执行本地项目检查和 ZIP 打包，并按 PNG/JPEG、1024×1024、5 Mi
 
 准备完成后固定本次素材字节，授权期间不会重新读取。打包排除 .ttmg、.env\*、PEM 和 KEY 等文件，但不保证识别所有业务秘密。
 
-CLI 在工程目录的 `.ttmg/vibe-project.json` 保存并复用非敏感 source_project_id；使用 --package 时保存在 ZIP 所在目录。不要将多个独立游戏的 ZIP 放在同一身份目录。dry-run 不创建此文件。每次运行使用新的 task_idempotency_id，当前不支持中断续传。凭证只驻留进程内存，不进入事件、文件、日志或错误信息。
+CLI 在工程目录的 `.ttmg/vibe-project.json` 保存并复用非敏感 source_project_id；使用 --package 时保存在 ZIP 所在目录。不要将多个独立游戏的 ZIP 放在同一身份目录。dry-run 不创建此文件。同一游戏再次上传时保留 source_project_id，但每次创建任务前单独生成新的 task_idempotency_id；平台返回本次 task_id 后，本次轮询和素材上传只使用该 task_id。task_id 由平台生成，CLI 不自行指定，当前不支持中断续传。凭证只驻留进程内存，不进入事件、文件、日志或错误信息。
 
 ## HTTP 适配边界