@taptap/instant-games-open-mcp 1.24.5 → 1.24.7-beta.1

package/README.md

@@ -18,11 +18,10 @@
 - **🤖 智能引导** - AI Agent 自动验证前置条件，主动询问用户选择
 
 **NPM**: [@taptap/instant-games-open-mcp](https://www.npmjs.com/package/@taptap/instant-games-open-mcp)
-**Maker NPM**: [@taptap/maker](https://www.npmjs.com/package/@taptap/maker)
 
 ## 🦞 OpenClaw Plugin（实验中）
 
-仓库内提供了一个可独立使用的 OpenClaw plugin 子包：
+仓库内提供了一个可独立发布的 OpenClaw plugin 子包：
 
 - [`packages/openclaw-dc-plugin`](packages/openclaw-dc-plugin)
 
@@ -42,17 +41,18 @@
 详见：
 
 - [OpenClaw Plugin 说明](docs/OPENCLAW_PLUGIN.md)
+- 维护者发布方式：`npm run openclaw:pack` / `npm run openclaw:publish`
 
 ## 🛠️ TapTap Maker 本地开发（CLI-first）
 
 Maker 本地开发按“初始化用 CLI，开发循环用 MCP”拆分。首次配置推荐直接运行：
 
 ```bash
-npx -y @taptap/maker init
+npx -y -p @taptap/instant-games-open-mcp taptap-maker init
 ```
 
-CLI 负责一次性流程：Git 检查、PAT 保存、TapTap token 换取、app 列表选择、Maker Git
-clone、AI dev kit 准备、MCP 配置写入与基础验证。安装或修改 MCP 配置后，Claude Code /
+CLI 负责一次性流程：Git 检查、PAT 保存、TapTap token 换取、app 列表选择、AI dev kit
+准备、Maker Git clone、MCP 配置写入与基础验证。安装或修改 MCP 配置后，Claude Code /
 Codex / Cursor 通常需要重启会话、刷新 MCP 或新开窗口才会出现新的 MCP tools；但当前终端
 里的 CLI 初始化流程可以继续完成到 PAT 鉴权和项目绑定。
 
@@ -63,15 +63,14 @@ taptap-maker init
 taptap-maker doctor
 taptap-maker apps --json
 taptap-maker pat set
-taptap-maker install --ide codex,cursor,claude
+taptap-maker mcp install --ide codex,cursor,claude
 taptap-maker mcp verify
 taptap-maker dev-kit update
 ```
 
 `taptap-maker pat set` 默认通过交互式 prompt 接收 PAT，避免把 PAT 写进
 `ps` 进程列表或 shell history；自动化场景可用 `--pat-stdin` 从标准输入读取。
-`taptap-maker install` 是 `taptap-maker mcp install` 的快捷别名，二者都会写入 AI 客户端
-MCP 配置。`taptap-maker mcp verify` 默认验证 `mcp install` 写入 AI 客户端配置的 npx 启动命令；
+`taptap-maker mcp verify` 默认验证 `mcp install` 写入 AI 客户端配置的 npx 启动命令；
 本地开发只想验证当前 CLI 时可加 `--mode self`。如果验证输出 `status: null` 或
 `failure_type`，说明本地 Node/npm/npx 启动命令还没正常跑通，Maker MCP server
 尚未启动；这不是 PAT、app 选择或 Maker 业务接口报错。先按输出里的 command
@@ -103,7 +102,8 @@ Maker 远端但构建失败。只有用户明确说“不提交，只构建云
 读取 `runtime_logs.state_file`。
 
 `maker_pull_runtime_logs` 只做固定的一次性业务流：调用远端 `query_runtime_logs`，默认只拉
-`user_script`（客户端 Lua 脚本）和 `server_user_script`（服务端 Lua 脚本）。本地只追加写入一份
+`engine`、`user_script`（客户端 Lua 脚本）和 `server_user_script`（服务端 Lua 脚本）。
+本地只追加写入一份
 `.maker/logs/runtime/runtime.log`，保持 server 日志行格式（`t/topic/level/msg/userId` 等），
 但去掉无用的 `id` 字段，也不再补 `time/message` 重复字段；`.maker/logs/runtime/state.json`
 保存下一次查询游标和 watcher 心跳状态，包括最近轮询时间、最近成功时间、最近写入条数、
@@ -130,11 +130,11 @@ Maker 现在同时内置三个工作流 skill：
 
 - `taptap-maker-local`：把 Maker 初始化转交 CLI，并让本地 AI/Agent 按 push 失败分类处理 pull/rebase、切回 main、移除禁止路径、鉴权刷新、冲突和构建失败恢复。
 - `taptap-maker-dev-kit-guide`：介绍 clone 时安装到项目目录的 AI dev kit，明确 `CLAUDE.md`、`examples/`、`templates/`、`urhox-libs/` 的用途。
-- `update-taptap-mcp`：引导用户更新本地 npx 缓存里的 `@taptap/maker`，并提醒 Maker MCP 推荐安装到 user/global scope。
+- `update-taptap-mcp`：引导用户更新本地 npx 缓存里的 `@taptap/instant-games-open-mcp`，并提醒 Maker MCP 推荐安装到 user/global scope。
 
-初始化流程里，PAT 验证通过、用户选择 app 后，`taptap-maker init` 会先完成 Maker Git checkout，再自动准备本地 AI dev kit。
+初始化流程里，PAT 验证通过、用户选择 app 后，`taptap-maker init` 会自动准备本地 AI dev kit。
 
-CLI 会根据 `TAPTAP_MCP_ENV` 自动选择下载源：`production`（默认）使用 `https://urhox-demo-platform.spark.xd.com/ai-dev-kit/pd/stable/ai-dev-kit.zip`，`rnd` 使用 `https://urhox-demo-platform.spark.xd.com/ai-dev-kit/rnd/latest/ai-dev-kit.zip`，checkout 后解压开发环境文档、引擎 API、demo、Lua 工具和本地 AI skills 到当前目录，并用 dev kit 覆盖同名本地辅助文件；解压复制完成后会自动运行 `tools/install-skills.sh all`（Linux/macOS）或 `tools/install-skills.ps1 all`（Windows），把 dev kit skills 安装到各 Agent 的发现目录。CLI 会先输出 `AI skills install started: <script>`，完成后输出 `AI skills install result: claude=N, codex=N, cursor=N, gemini=N`；脚本缺失、跳过或失败时也会输出原因，失败会带上平台、脚本、命令、stdout 和 stderr，方便 AI 与用户直接判断安装情况。流程会跳过 ZIP 里的顶层 `scripts` 目录并删除下载 ZIP，避免和 Maker 项目代码冲突。dev-kit 准备阶段会生成 `.gitignore.dev-kit-before-clone` 临时 block，准备成功后自动合并到远端 `.gitignore`，防止这些本地开发环境文件、Agent skill 目录和 `.maker/` 本地运行状态被提交到 Maker Git。
+CLI 会根据 `TAPTAP_MCP_ENV` 自动选择下载源：`production`（默认）使用 `https://urhox-demo-platform.spark.xd.com/ai-dev-kit/pd/stable/ai-dev-kit.zip`，`rnd` 使用 `https://urhox-demo-platform.spark.xd.com/ai-dev-kit/rnd/latest/ai-dev-kit.zip`，解压开发环境文档、引擎 API、demo、Lua 工具和本地 AI skills 到当前目录；解压复制完成后会自动运行 `tools/install-skills.sh all`（Linux/macOS）或 `tools/install-skills.ps1 all`（Windows），把 dev kit skills 安装到各 Agent 的发现目录。CLI 会先输出 `AI skills install started: <script>`，完成后输出 `AI skills install result: claude=N, codex=N, cursor=N, gemini=N`；脚本缺失、跳过或失败时也会输出原因，失败会带上平台、脚本、命令、stdout 和 stderr，方便 AI 与用户直接判断安装情况。流程会跳过 ZIP 里的顶层 `scripts` 目录并删除下载 ZIP，避免和 Maker 项目代码冲突。dev kit 准备成功后会刷新项目根 `.gitignore`，防止这些本地开发环境文件、Agent skill 目录和 `.maker/` 本地运行状态被提交到 Maker Git；`.gitignore` 本身是 Maker 项目必要文件，首次 init 生成后应随游戏代码提交。
 
 `maker://status` 和 `maker_status_lite` 会输出已随包内置的 skill 名称和文档路径：`taptap-maker-local`、`taptap-maker-dev-kit-guide` 与 `update-taptap-mcp`。Maker 操作目标是用户当前项目目录；若 MCP 进程 cwd 是临时对话目录，Agent 应把用户当前项目目录作为 `target_dir` 传入，不扫描其他项目。已绑定项目会检查 `CLAUDE.md`、`examples/`、`templates/`、`urhox-libs/`，并输出 `skill_install_status` 和 `skill_install_summary` 说明 `.claude/.codex/.cursor/.gemini` 下的 skill 安装状态；缺失时用 `taptap-maker dev-kit update` 恢复本地 AI dev kit 并刷新 `.gitignore` 管理块。
 
@@ -535,8 +535,36 @@ graph LR
 - **[docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)** - 架构文档
 - **[docs/DEPLOYMENT.md](docs/DEPLOYMENT.md)** - 部署指南（本地、Docker、开发者测试）
 - **[docs/PROXY.md](docs/PROXY.md)** - MCP Proxy 开发指南（面向 TapCode 等平台）
+- **[docs/CI_CD.md](docs/CI_CD.md)** - CI/CD 和自动化发布流程
 - **[docs/PATH_RESOLUTION.md](docs/PATH_RESOLUTION.md)** - 路径解析系统
 
+## 🔄 CI/CD
+
+基于 Conventional Commits 的完全自动化发布：
+
+```bash
+# 创建功能分支
+git checkout -b feat/awesome-feature
+
+# 提交代码
+git commit -m "feat: add awesome feature"
+
+# 创建 PR 并合并
+gh pr create && gh pr merge
+
+# 自动发布到 npm（版本：1.4.13 → 1.5.0）
+```
+
+**发布流程**：
+
+1. PR 合并 → 触发 Actions
+2. 分析 commits 确定版本号
+3. 发布到 npm
+4. 自动创建版本 PR 并合并
+5. 创建 GitHub Release
+
+详见: [docs/CI_CD.md](docs/CI_CD.md)
+
 ## 🤝 贡献
 
 欢迎贡献！请遵循：

package/bin/taptap-maker

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+
+/**
+ * TapTap Maker MCP
+ * Entry point for CLI subcommands and MCP server mode.
+ */
+
+import { join, dirname } from 'node:path';
+import { existsSync } from 'node:fs';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const packageRoot = join(__dirname, '..');
+const distPath = join(packageRoot, 'dist', 'maker.js');
+const distUrl = pathToFileURL(distPath).href;
+
+if (existsSync(distPath)) {
+  import(distUrl).catch((error) => {
+    console.error('❌ Failed to start TapTap Maker MCP:', error);
+    process.exit(1);
+  });
+} else {
+  console.error('❌ Maker MCP bundle not found. Please build the project first:');
+  console.error('   npm run build');
+  process.exit(1);
+}