@taptap/instant-games-open-mcp 1.23.2 → 2.0.0

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.
package/dist/proxy.js CHANGED
@@ -29137,7 +29137,7 @@ var LogWriter = class {
29137
29137
  };
29138
29138
 
29139
29139
  // src/mcp-proxy/proxy.ts
29140
- var VERSION = true ? "1.23.2" : "dev";
29140
+ var VERSION = true ? "2.0.0" : "dev";
29141
29141
  var TapTapMCPProxy = class {
29142
29142
  constructor(config2) {
29143
29143
  this.connected = false;
package/dist/server.js CHANGED
@@ -6078,7 +6078,7 @@ class MultiplayerManager {
6078
6078
  // 导出
6079
6079
  // export default MultiplayerManager;
6080
6080
  // module.exports = MultiplayerManager;
6081
- // window.MultiplayerManager = MultiplayerManager;`}]}}};var ws;ws="1.23.2";async function MRe(){return Go(Rm,"api_event_relations")}async function NRe(){return Go(Rm,"protocol_template")}async function SD(){return Go(Rm,"complete_example")}async function jRe(){return`# TapTap 多人联机集成指南
6081
+ // window.MultiplayerManager = MultiplayerManager;`}]}}};var ws;ws="2.0.0";async function MRe(){return Go(Rm,"api_event_relations")}async function NRe(){return Go(Rm,"protocol_template")}async function SD(){return Go(Rm,"complete_example")}async function jRe(){return`# TapTap 多人联机集成指南
6082
6082
 
6083
6083
  ---
6084
6084
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@taptap/instant-games-open-mcp",
3
- "version": "1.23.2",
3
+ "version": "2.0.0",
4
4
  "type": "module",
5
5
  "description": "TapTap Open API MCP Server - Documentation and Management APIs for TapTap Minigame and H5 Games (Leaderboard, and more features coming)",
6
6
  "main": "dist/server.js",
@@ -5,8 +5,8 @@ description: Explain the local TapTap Maker AI dev kit installed during Maker pr
5
5
 
6
6
  # TapTap Maker AI Dev Kit
7
7
 
8
- Use this skill to orient the local AI/Agent after `maker_clone_to_current_directory` installs the
9
- AI dev kit into a Maker project directory.
8
+ Use this skill to orient the local AI/Agent after `taptap-maker init` installs the AI dev kit into a
9
+ Maker project directory.
10
10
 
11
11
  ## What To Tell The Local Agent
12
12
 
@@ -30,9 +30,9 @@ When a user asks to develop or modify a Maker project after clone:
30
30
  4. Use `templates/` when creating new game files or scaffolding.
31
31
  5. Use `urhox-libs/` when engine API behavior or capability names are needed.
32
32
 
33
- If these entries are missing in a bound Maker project, call `maker_status` with the actual project
34
- directory as `target_dir`. The status tool will report dev-kit state and restore missing local
35
- dev-kit entries when possible.
33
+ If these entries are missing in a bound Maker project, read `maker://status` or call
34
+ `maker_status_lite` with the actual project directory as `target_dir` to confirm state, then run
35
+ `taptap-maker dev-kit update` in that project directory to restore missing local dev-kit entries.
36
36
 
37
37
  These files are local development aids. Do not submit them to Maker Git unless the user explicitly
38
38
  asks and understands they are local environment files.
@@ -41,10 +41,11 @@ asks and understands they are local environment files.
41
41
 
42
42
  Keep validation simple for Maker users. 用户可以直接说“提交”或“构建”:
43
43
 
44
- - If the user says “提交”, use the Maker submit flow so local changes are committed, pushed, and
45
- built by the Maker MCP tools.
46
- - If the user says “构建”, use the Maker build flow. If the tool reports local changes, follow the
47
- options returned by the tool instead of inventing a separate build script.
44
+ - If the user says “提交”, “推送”, “构建”, “预览”, or “跑一下”, use
45
+ `maker_build_current_directory`. The tool commits when needed, pushes to Maker remote, and then
46
+ runs the remote build.
47
+ - If push fails, do not start a separate build or generic Git push. Explain the returned recovery
48
+ details, resolve pull/rebase/conflict with user approval, then retry `maker_build_current_directory`.
48
49
  - After submit or build finishes, tell the user to open the TapMaker 网页端查看结果.
49
50
 
50
51
  Do not create local-only test scripts just to verify Maker changes. The expected validation path is
@@ -5,18 +5,19 @@ description: Guide TapTap Maker local development workflows. Use when a user ask
5
5
 
6
6
  # TapTap Maker Local Workflow
7
7
 
8
- Use this skill as the workflow layer for Maker local development. MCP tools provide machine
9
- capabilities; this skill decides the sequence, asks the user for choices, and explains local
10
- state in plain language.
8
+ Use this skill as the workflow layer for Maker local development. The Maker CLI owns one-time
9
+ initialization; MCP tools own the high-frequency development loop. This skill decides the sequence,
10
+ asks the user for choices, and explains local state in plain language.
11
11
 
12
12
  ## Scope
13
13
 
14
14
  This skill covers:
15
15
 
16
16
  - initialize local Maker development
17
+ - run the Maker CLI initialization flow
17
18
  - prepare local AI dev kit before project binding
18
19
  - clone a Maker project
19
- - choose a Maker app from the app list
20
+ - choose a Maker app from the CLI app list
20
21
  - explain PAT, Git, project binding, and editor reloads
21
22
  - inspect local changes
22
23
  - pull remote changes
@@ -24,30 +25,30 @@ This skill covers:
24
25
  - push local commits
25
26
  - explain and resolve conflicts with user approval
26
27
 
27
- Build behavior still belongs to the existing Maker MCP build tool. Do not remove or bypass the
28
- current MCP tools.
28
+ Build, submit, push, preview, and verify behavior belongs to the single Maker MCP build tool.
29
29
 
30
30
  ## Responsibilities
31
31
 
32
32
  Keep this split clear:
33
33
 
34
34
  - Skill: user intent, step order, whether to ask the user, friendly explanations, failure recovery.
35
- - MCP tools: save PAT, fetch app list, clone, submit, build, inspect Maker status.
36
- - CLI: install MCP config and install bundled skills.
35
+ - CLI: save PAT, fetch app list, prepare dev kit, clone, install MCP config, verify local setup.
36
+ - MCP tools/resources: inspect Maker status and run the combined commit/push/build path.
37
37
 
38
- Do not reimplement Maker API calls or Git authentication in shell when a Maker MCP tool exists.
38
+ Do not reimplement Maker API calls or Git authentication in shell when the Maker CLI or MCP tool
39
+ exists.
39
40
 
40
41
  ## Main Intent Table
41
42
 
42
43
  | User intent | Required workflow |
43
44
  | --------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
44
- | initialize / configure / continue Maker local development | Follow "Initialization Workflow". |
45
+ | initialize / configure / continue Maker local development | Run the Maker CLI initialization workflow. |
45
46
  | clone / download Maker project locally | Follow "Initialization Workflow"; do not ask for app_id directly. |
46
- | status / is Maker ready | Call `maker_status` for the user's current project directory, then explain missing prerequisites and dev-kit status. |
47
- | submit / commit / push to Maker | Inspect local Git state, summarize changed files, then call `maker_submit_current_directory` unless blocked. |
47
+ | status / is Maker ready | Read `maker://status`, call `maker_status_lite` if resources are unavailable, or run `taptap-maker doctor`. |
48
+ | submit / commit / push to Maker | Inspect local Git state, summarize changed files, then call `maker_build_current_directory` unless blocked. |
48
49
  | pull / update from remote | Inspect local changes first; if dirty, explain options before pulling. |
49
50
  | conflict / merge failed | Explain why the conflict happened, list conflict files, inspect conflict hunks, propose a resolution plan, and ask before editing. |
50
- | build / preview / run / verify | Use `maker_build_current_directory`; if it reports local changes, ask using the exact options returned by the tool. |
51
+ | build / preview / run / verify | Use `maker_build_current_directory`; it commits/pushes before build unless the user explicitly requests remote-only build. |
51
52
 
52
53
  ## Project Detection
53
54
 
@@ -81,8 +82,9 @@ calling Maker tools. If there are multiple attached workspaces, show the paths a
81
82
  which one is the Maker project directory. Do not treat the dialogue/session directory as the Maker
82
83
  project directory, and do not ask the user to clone an app into that directory.
83
84
 
84
- If `maker_status` returns `AI client workspace selection`, follow that hint: choose an attached
85
- workspace first, then call `maker_status(target_dir="<attached project directory>")`.
85
+ If status output returns `AI client workspace selection`, follow that hint: choose an attached
86
+ workspace first, then read `maker://status` or call `maker_status_lite` with the attached project
87
+ directory.
86
88
 
87
89
  ## Initialization Workflow
88
90
 
@@ -100,43 +102,43 @@ Trigger phrases include:
100
102
 
101
103
  Workflow:
102
104
 
103
- 1. Call `maker_status`. If the MCP process cwd differs from the user's current project directory,
104
- pass the user's current project directory as `target_dir`.
105
- 2. If `maker_status` reports the current directory is already bound to a Maker project, stop the
105
+ 1. Run `taptap-maker doctor` for the user's intended Maker directory, or read `maker://status` when
106
+ the MCP server is already available.
107
+ 2. If the status reports the current directory is already bound to a Maker project, stop the
106
108
  initialization/clone path. Continue with the user's current intent in that bound project. Do not
107
109
  ask which app to clone unless the user explicitly asks to switch or re-clone.
108
110
  3. If Git is missing, stop. Tell the user Git is required for clone/submit/build-side Git work.
109
- 4. If `maker_status` lists bundled skill documents, just tell the user which skills are available.
110
- Do not run editor-specific CLI install commands.
111
- 5. If PAT is missing, ask the user to open the PAT page shown by `maker_status`, create a PAT, and send it back.
112
- 6. When the user provides PAT, call `maker_exchange_pat(manual_pat)`.
113
- 7. If the current directory is still unbound, show every returned Maker app entry to the user and
114
- ask the user to choose. Do not summarize the list as only a count, category, or stage. Do not
115
- auto-select, even if there is only one app.
116
- 8. Run the working directory compliance check below, including the parent Git repository warning.
117
- 9. After the user chooses an app, call `maker_clone_to_current_directory(app_id)`. The clone
118
- tool prepares the AI dev kit automatically before project checkout.
119
- 10. After clone succeeds, call `maker_status` again or explain that `.maker-mcp/config.json` now binds the directory to the Maker project.
120
- 11. Tell the local AI/Agent to use the `taptap-maker-dev-kit-guide` skill for the installed dev-kit
121
- resources, especially `CLAUDE.md`, `examples/`, `templates/`, and `urhox-libs/`.
111
+ 4. Run `taptap-maker init` in the user's intended Maker directory. The CLI will request PAT if
112
+ missing, fetch TapTap token, list every available app, ask the user to choose, prepare the AI dev
113
+ kit, clone the Maker project, and install/verify MCP config.
114
+ Tell the user that the first Maker clone can take 20+ seconds because the server may be
115
+ preparing the repository, and that they should keep the command running while the CLI retries
116
+ transient 503/5xx failures.
117
+ 5. If the CLI reports ordinary local files or parent Git repository risk, explain the warning and
118
+ ask whether the user wants to continue in this directory or switch to a clean independent one.
119
+ 6. After clone succeeds, run `taptap-maker doctor` again or explain that `.maker-mcp/config.json`
120
+ now binds the directory to the Maker project.
121
+ 7. Tell the local AI/Agent to use the `taptap-maker-dev-kit-guide` skill for the installed dev-kit
122
+ resources, especially `CLAUDE.md`, `examples/`, `templates/`, and `urhox-libs/`.
122
123
 
123
124
  Keep the user-facing explanation short:
124
125
 
125
126
  ```text
126
- 我会先检查本机 Git、PAT 和当前目录是否已绑定 Maker 项目。
127
- 如果还没有 PAT,我会让你去页面创建一个;拿到项目列表后你选游戏,我再拉代码。
127
+ 我会先用 Maker CLI 检查本机 Git、PAT 和当前目录是否已绑定 Maker 项目。
128
+ 如果还没有 PAT,CLI 会让你去页面创建一个;拿到项目列表后你选游戏,我再拉代码。
128
129
  ```
129
130
 
130
131
  ## AI Dev Kit Preparation
131
132
 
132
- `maker_clone_to_current_directory` prepares local development environment files in the current
133
- working directory before it checks out the Maker project.
133
+ `taptap-maker init` prepares local development environment files in the current working directory
134
+ before it checks out the Maker project.
134
135
 
135
- `maker_status` checks the dev-kit top-level entries for an already bound Maker project. If
136
- `CLAUDE.md`, `examples/`, `templates/`, or `urhox-libs/` are missing, the tool restores the dev kit
137
- without overwriting existing local files and refreshes the managed `.gitignore` block.
136
+ `taptap-maker doctor` and `maker://status` check the dev-kit top-level entries for an already bound
137
+ Maker project. If `CLAUDE.md`, `examples/`, `templates/`, or `urhox-libs/` are missing, run
138
+ `taptap-maker dev-kit update` to restore the dev kit without overwriting existing local files and
139
+ refresh the managed `.gitignore` block.
138
140
 
139
- The clone tool downloads and installs:
141
+ The CLI downloads and installs:
140
142
 
141
143
  ```text
142
144
  https://urhox-demo-platform.spark.xd.com/ai-dev-kit/pd/stable/ai-dev-kit.zip
@@ -150,7 +152,7 @@ resources to the local AI/Agent:
150
152
  - `templates/` contains reusable templates.
151
153
  - `urhox-libs/` contains engine APIs and capability references.
152
154
 
153
- The clone tool is responsible for deterministic file operations:
155
+ The CLI is responsible for deterministic file operations:
154
156
 
155
157
  - extract the ZIP into the current directory
156
158
  - skip the ZIP top-level `scripts` directory because it conflicts with Maker project code
@@ -159,18 +161,29 @@ The clone tool is responsible for deterministic file operations:
159
161
  - after Maker clone succeeds, merge that block into the checked-out `.gitignore`
160
162
  - keep the dev-kit files local-only so they are not submitted to Maker Git
161
163
 
162
- Do not hand-write a custom download/unzip script while this MCP clone tool is available.
164
+ Do not hand-write a custom download/unzip script while this CLI command is available.
163
165
 
164
166
  If clone fails because dev-kit network access is unavailable, explain that the Maker project can
165
167
  still be cloned, but local AI development docs/API/demo support may be incomplete. Ask whether
166
168
  the user wants to retry or continue without the dev kit.
167
169
 
170
+ If clone or fetch fails with Maker Git output, inspect the returned error fields instead of asking
171
+ the user to delete local files immediately. Treat `retryable: yes`, `classification:
172
+ remote_transient`, or retry reasons such as `remote_http_5xx`, `network_or_timeout`, and
173
+ `connection_interrupted` as temporary service/network failures. For first clone, explain that 503
174
+ often means the Maker server is still preparing the repository and can take more than 20 seconds.
175
+ The CLI already retried these automatically; if it still fails, tell the user they can retry
176
+ `taptap-maker init` later or switch to a cleaner independent directory after repeated failures. Do
177
+ not retry for auth, permission, repository-not-found, remote-rejected, local file conflict, or local
178
+ permission errors until the reported cause is fixed.
179
+
168
180
  ## PAT Handling
169
181
 
170
- If the user pastes a token-like string while the initialization flow is waiting for PAT, call
171
- `maker_exchange_pat(manual_pat)` and continue only if the current directory is unbound. Do not just
172
- say "received". If the directory is already bound, treat the returned app list as account reference
173
- only and continue the user's current bound-project task.
182
+ If the user pastes a token-like string while the initialization flow is waiting for PAT, let the
183
+ running `taptap-maker init` prompt consume it, or run `taptap-maker pat set` and paste the PAT into
184
+ the prompt. Do not put PAT directly in argv unless the user explicitly accepts the ps/shell-history
185
+ exposure. Do not just say "received". If the directory is already bound, treat `taptap-maker apps`
186
+ output as account reference only and continue the user's current bound-project task.
174
187
 
175
188
  If PAT exchange fails:
176
189
 
@@ -183,9 +196,9 @@ If PAT exchange fails:
183
196
  Use app selection only when the current directory is unbound and the user is initializing or cloning
184
197
  a Maker project, or when the user explicitly asks to switch or re-clone.
185
198
 
186
- If the current directory is already bound, app lists from `maker_exchange_pat`, `maker_list_apps`, or
187
- `maker_status` are reference only. Do not ask which app to clone. Continue operating on the current
188
- bound project unless the user explicitly requests a different project.
199
+ If the current directory is already bound, app lists from `taptap-maker apps` are reference only. Do
200
+ not ask which app to clone. Continue operating on the current bound project unless the user
201
+ explicitly requests a different project.
189
202
 
190
203
  When app selection is needed, display every app entry from the tool result and ask the user to
191
204
  choose by index, app id, or name. Do not replace the list with a summary such as "10 apps are
@@ -197,17 +210,18 @@ Do not auto-select:
197
210
  - the most recent app
198
211
  - the only app
199
212
 
200
- After the user chooses, pass the concrete `app_id` to `maker_clone_to_current_directory`.
213
+ After the user chooses, let `taptap-maker init` continue with the selected app. Do not ask the user
214
+ to manually provide app_id unless the CLI is being run non-interactively.
201
215
 
202
216
  ## Working Directory Compliance Check
203
217
 
204
- Before every clone attempt, call `maker_status(target_dir)` for the user's intended Maker
205
- development directory. Use that result as the source of truth for Git availability, existing Maker
206
- binding, outer Git repository detection, and AI dev-kit status.
218
+ Before every clone attempt, run `taptap-maker doctor` for the user's intended Maker development
219
+ directory. Use that result as the source of truth for Git availability, existing Maker binding,
220
+ outer Git repository detection, and AI dev-kit status.
207
221
 
208
222
  ### Directory Suitability Decision
209
223
 
210
- After `maker_status(target_dir)`, decide whether the directory is suitable for clone:
224
+ After `taptap-maker doctor`, decide whether the directory is suitable for clone:
211
225
 
212
226
  - If the directory is already bound to a Maker project, do not clone again unless the user
213
227
  explicitly asks to switch or re-clone.
@@ -244,16 +258,16 @@ user before clone:
244
258
  - A Maker project can live under that directory only if the Maker directory gets its own `.git`.
245
259
  - Recommend a completely independent directory, such as `~/MakerProjects/<game-name>`, for safer
246
260
  local development.
247
- - If the user explicitly continues, call `maker_clone_to_current_directory`; the MCP clone tool
248
- must initialize an independent Maker Git repository in the target directory and must not modify
249
- the outer repository remote.
261
+ - If the user explicitly continues, continue `taptap-maker init`; the CLI must initialize an
262
+ independent Maker Git repository in the target directory and must not modify the outer repository
263
+ remote.
250
264
 
251
265
  Do not delete, move, or overwrite user files during this check.
252
266
 
253
267
  ## Clone Directory Safety
254
268
 
255
- Before clone, the Maker MCP clone tool checks local files and reports conflicts. The AI dev kit
256
- may create local-only files before clone, so explain this in non-technical terms:
269
+ Before clone, the Maker CLI checks local files and reports conflicts. The AI dev kit may create
270
+ local-only files before clone, so explain this in non-technical terms:
257
271
 
258
272
  - existing local config folders such as `.claude`, `.mcp`, `.skill`, `.config`, `.ini` are kept
259
273
  - normal local files are kept unless they conflict with files from the Maker project
@@ -262,15 +276,14 @@ may create local-only files before clone, so explain this in non-technical terms
262
276
 
263
277
  Do not delete or overwrite user files to make clone work unless the user explicitly asks.
264
278
 
265
- If `maker_clone_to_current_directory` fails and the tool returns `partial_state`, explain the
266
- state in plain language:
279
+ If `taptap-maker init` fails and returns `partial_state`, explain the state in plain language:
267
280
 
268
281
  - `project_bound: no` usually means clone did not finish; retrying clone is allowed.
269
282
  - `git_initialized: yes` with `project_bound: no` means the directory may contain a partial local
270
283
  Git setup; retry once, and if it fails again recommend a fresh independent directory.
271
284
  - `ai_dev_kit_present: yes` means local AI docs/examples may already be present even though Maker
272
285
  project checkout failed.
273
- - `project_bound: yes` means the directory already has Maker binding; run `maker_status` before
286
+ - `project_bound: yes` means the directory already has Maker binding; run `taptap-maker doctor` before
274
287
  attempting anything else.
275
288
 
276
289
  Do not delete partial files automatically. For novice users, prefer recommending a new independent
@@ -278,9 +291,9 @@ directory over manual cleanup.
278
291
 
279
292
  ### `.gitignore` Merge During Clone
280
293
 
281
- The Maker clone tool stages the dev-kit managed ignore block in
294
+ The Maker CLI stages the dev-kit managed ignore block in
282
295
  `.gitignore.dev-kit-before-clone` instead of writing `.gitignore` before checkout. After Maker
283
- clone succeeds, the clone tool merges that managed block into the checked-out `.gitignore` and
296
+ clone succeeds, the CLI merges that managed block into the checked-out `.gitignore` and
284
297
  removes the temporary file.
285
298
 
286
299
  If clone still reports conflicts for files other than `.gitignore.dev-kit-before-clone`, do not
@@ -292,8 +305,8 @@ submitted to Maker Git.
292
305
 
293
306
  ## Bundled Skills
294
307
 
295
- When `maker_status` reports TapTap bundled workflow skills, show the skill names and document
296
- paths. Do not install or register skills automatically.
308
+ When `taptap-maker doctor`, `maker://status`, or `maker_status_lite` reports TapTap bundled workflow
309
+ skills, show the skill names and document paths. Do not install or register skills automatically.
297
310
 
298
311
  `taptap-maker-local` covers Maker local workflow. `taptap-maker-dev-kit-guide` explains the local
299
312
  AI dev-kit resources installed during clone. `update-taptap-mcp` covers local TapTap MCP cache
@@ -330,27 +343,28 @@ mean:
330
343
  commit + push + Maker build
331
344
  ```
332
345
 
333
- Use `maker_submit_current_directory` for this path. Do not use generic Git task-id,
346
+ Use `maker_build_current_directory` for this path. Do not use generic Git task-id,
334
347
  branch-creation, or PR rules inside Maker project repositories.
335
348
 
336
- If `maker_submit_current_directory` returns a build failure after a successful push, report both:
349
+ If `maker_build_current_directory` returns a build failure after a successful push, report both:
337
350
 
338
351
  - submit/push succeeded
339
352
  - build failed, with the concrete build error
340
353
 
341
354
  If submit created a local commit but push failed because the Maker remote was temporarily
342
- unavailable, do not run a manual generic `git push`. Tell the user to retry
343
- `maker_submit_current_directory`, or use `maker_build_current_directory` with
344
- `submit_local_changes_before_build=true` when the user is retrying build. Maker MCP will detect
345
- committed-but-unpushed local commits and push them before build.
355
+ unavailable, do not run a manual generic `git push`. Fix the reported cause if needed, then retry
356
+ `maker_build_current_directory`. Maker MCP will detect committed-but-unpushed local commits and push
357
+ them before build.
358
+
359
+ For push failures, use the returned `classification`, `retryable`, `retry_reason`, and
360
+ `retry_attempts` fields. Temporary 5xx/network/timeout failures may be retried with the Maker build
361
+ tool; rejected remote updates require pull/rebase first; auth failures require refreshing PAT.
346
362
 
347
363
  When a Maker tool output contains `push_recovery`, follow it exactly:
348
364
 
349
365
  - Tell the user the local commit is preserved but not yet on Maker remote.
350
366
  - Do not ask for permission to run a generic `git push`.
351
- - Retry with `maker_submit_current_directory` for submit requests.
352
- - Retry with `maker_build_current_directory(submit_local_changes_before_build=true)` for build
353
- requests.
367
+ - Retry with `maker_build_current_directory` for submit and build requests.
354
368
  - If the failure is `remote_rejected`, ask before pull/rebase; do not create a new branch or PR.
355
369
 
356
370
  ## Pull And Conflict Handling
@@ -75,7 +75,7 @@ foreach ($f in $projectConfigPaths) {
75
75
  ## Step 1:对比远端和本地版本
76
76
 
77
77
  ```powershell
78
- npm view '@taptap/instant-games-open-mcp@beta' version
78
+ npm view '@taptap/instant-games-open-mcp' version
79
79
  $NpxDir = Join-Path (npm config get cache) '_npx'
80
80
  Get-ChildItem $NpxDir -Directory -ErrorAction SilentlyContinue | ForEach-Object {
81
81
  $p = Join-Path $_.FullName 'node_modules\@taptap\instant-games-open-mcp\package.json'
@@ -98,17 +98,11 @@ Get-ChildItem $NpxDir -Directory -ErrorAction SilentlyContinue | ForEach-Object
98
98
 
99
99
  ## Step 3:预热下载
100
100
 
101
- 根据用户 MCP 配置选默认 bin 或指定 bin(`taptap-maker`)。下例以 `taptap-maker` 为例,默认 bin 去掉 `'-p','@taptap/instant-games-open-mcp@beta','taptap-maker'`,改成单独一个 `'@taptap/instant-games-open-mcp@beta'`。
101
+ 预热正式 npm 包,并验证 `taptap-maker` binary 可以启动。
102
102
 
103
103
  ```powershell
104
- $env:TAPTAP_MCP_ENV = 'rnd'
105
104
  $log = Join-Path $env:TEMP 'taptap-mcp-warmup.log'
106
- $proc = Start-Process -FilePath npx `
107
- -ArgumentList '-y','-p','@taptap/instant-games-open-mcp@beta','taptap-maker' `
108
- -RedirectStandardOutput $log -RedirectStandardError "$log.err" `
109
- -WindowStyle Hidden -PassThru
110
- Start-Sleep -Seconds 25
111
- Stop-Process -Id $proc.Id -Force -ErrorAction SilentlyContinue
105
+ npx -y -p '@taptap/instant-games-open-mcp' taptap-maker help > $log 2> "$log.err"
112
106
  ```
113
107
 
114
108
  ## Step 4:验证
@@ -124,7 +118,7 @@ claude mcp list 2>&1 | Select-String -Pattern 'taptap|Warning'
124
118
 
125
119
  ## Step 5:提示用户重启客户端
126
120
 
127
- 更新完成后提醒用户重启 MCP 客户端,或新开 Claude Code / Codex / Cursor 窗口。当前会话通常不会热加载新 MCP;重启后以 `maker_status` 是否可调用作为最终生效标准。
121
+ 更新完成后提醒用户重启 MCP 客户端,或新开 Claude Code / Codex / Cursor 窗口。当前会话通常不会热加载新 MCP;重启后以能读取 `maker://status` 作为首选生效标准;如果客户端不支持 MCP Resources,则以 `maker_status_lite` 是否可调用作为兜底标准。
128
122
 
129
123
  ---
130
124
 
@@ -165,7 +159,7 @@ done
165
159
  ## Step 1:对比远端和本地版本
166
160
 
167
161
  ```bash
168
- npm view @taptap/instant-games-open-mcp@beta version
162
+ npm view @taptap/instant-games-open-mcp version
169
163
  NPX_DIR="$(npm config get cache)/_npx"
170
164
  for d in "$NPX_DIR"/*/; do
171
165
  p="$d/node_modules/@taptap/instant-games-open-mcp/package.json"
@@ -186,12 +180,11 @@ done
186
180
 
187
181
  ## Step 3:预热下载
188
182
 
189
- 根据用户 MCP 配置选默认 bin 或指定 bin(`taptap-maker`)。下例以 `taptap-maker` 为例,默认 bin 去掉 `-p ... taptap-maker`,直接写 `@taptap/instant-games-open-mcp@beta`。
183
+ 预热正式 npm 包,并验证 `taptap-maker` binary 可以启动。
190
184
 
191
185
  ```bash
192
- TAPTAP_MCP_ENV=rnd npx -y -p @taptap/instant-games-open-mcp@beta taptap-maker \
193
- < /dev/null > /tmp/taptap-mcp-warmup.log 2>&1 &
194
- PID=$!; sleep 25; kill $PID 2>/dev/null; wait 2>/dev/null
186
+ npx -y -p @taptap/instant-games-open-mcp taptap-maker help \
187
+ > /tmp/taptap-mcp-warmup.log 2>&1
195
188
  ```
196
189
 
197
190
  ## Step 4:验证
@@ -207,4 +200,4 @@ claude mcp list 2>&1 | grep -E "taptap|Warning"
207
200
 
208
201
  ## Step 5:提示用户重启客户端
209
202
 
210
- 更新完成后提醒用户重启 MCP 客户端,或新开 Claude Code / Codex / Cursor 窗口。当前会话通常不会热加载新 MCP;重启后以 `maker_status` 是否可调用作为最终生效标准。
203
+ 更新完成后提醒用户重启 MCP 客户端,或新开 Claude Code / Codex / Cursor 窗口。当前会话通常不会热加载新 MCP;重启后以能读取 `maker://status` 作为首选生效标准;如果客户端不支持 MCP Resources,则以 `maker_status_lite` 是否可调用作为兜底标准。