@66rpg/lumimaker 0.1.38 → 0.1.39

package/skill/lumimaker/SKILL.md

@@ -1,97 +1,97 @@
----
-name: lumimaker
-description: 命令操作与发布指引。用户询问如何登录、发布作品、发布试玩（demo）、发布模板或开源工程，或执行 lumimaker 相关命令行操作时使用。严禁使用 npm login 或 npm publish。
----
-
-# lumimaker CLI 命令操作指引
-
-本技能用于指导 Agent 正确执行幻光文游制作器的 `lumimaker` 命令，完成账号登录、作品发布、模板与数据包发布以及开源工程发布等操作。
-
----
-
-## 协作分工与边界
-
-为遵循单一可信源（SSOT）原则，各项职责明确划分如下：
-
-- **CLI 命令操作与交互规范**：由本技能（`lumimaker`）说明。
-- **模板工程规范协议**：查阅 `lumimaker-template-spec`（校验工程目录、`package.json` 字段与脚本、构建产物）。
-- **播放页 SDK 接入**：查阅 `lumimaker-play-sdk`（在作品代码中通过 `window.CgMakerSdk` 调用平台功能）。
-- **免费背景音乐和音效**：查阅 `lumimaker-free-audio`（按用户描述挑选，下载到工程里再用，不要把网上的音频地址写进作品）。
-
----
-
-## Agent 核心交互规范
-
-### 1. 坚持使用通俗大白话与用户沟通
-- 除非用户主动使用专业命令行术语，否则**不要向用户抛出底层技术黑话或内部字段名**（如 `qualified_name`、`revision_id`、`post_url` 等）。
-- CLI 返回需要用户确认或选择的内容时，将其转化为清晰易懂的日常口语进行询问。
-
-### 2. 禁止给命令加输出格式开关
-- **切勿为任何命令擅自追加 `--json` 或 `--format` 等输出格式开关**。
-- 正常执行成功时，终端输出均为给人阅读的中文卡片或中文文本，直接将其中的关键信息提取告知用户。
-- **只有在退出码为 10 / 11 / 12 时**，stdout 才是供 Agent 解析处理的 JSON 信封。
-
-### 3. 交互退出码处理机制
-
-当命令未直接执行成功并返回特定退出码时，严格按照下表流程处理，**严禁擅自做主或盲目猜测**：
-
-| 退出码 | 状态说明 | Agent 处置规范 |
-|---|---|---|
-| **10** | 检测到工具更新 (`update-available`) | 必须先询问用户，**禁止擅自 `--skip-update`**。列出推荐更新并口语询问：“检测到 lumimaker 有新版本，是否现在更新？”<br>• 用户同意：执行信封提供的更新命令（如 `npx lumimaker --apply-update`），成功后再原样重跑原命令。<br>• 用户拒绝：原命令追加 `--skip-update` 参数后重跑。 |
-| **11** | 缺少输入或待确认 (`need-input`) | 解析信封中的 `questions` 列表，用通俗口语逐一询问用户：<br>• **带有 `field` 属性**：将用户回答写回指定文件（如缺少 `version` / `data_ver` 时写入 `package.json` 对应字段），**写完后原样重跑命令**，不要擅自把 `--version` 等写进命令行。<br>• **带有 `flag` 属性**：将用户答案转化为对应命令行参数后重跑（例如现有 `package.json.name` 是 npm 包名时，信封会提供 `flag: --name`，此时不要覆盖该字段，转为 `--name` 参数重跑）。<br>• **待确认项**：见下方确认机制，严禁擅自加 `--yes`。 |
-| **12** | 未登录或凭据失效 (`login-required`) | 口语询问用户：“当前操作需要登录平台，是否现在打开浏览器登录？”<br>用户同意后执行 `npx lumimaker login`，等待用户在浏览器中完成登录后再重跑原命令。 |
-
-### 4. 正确理解发布结果与状态
-- **命令退出 0 仅代表本次提交操作完成**，绝对不等于作品或模板已经正式上线对外可见。
-- **发布状态以终端输出的中文标题为准**：
-  - 「发版成功」：表示该版本已通过审核并发布生效。
-  - 「已提交审核」：表示内容已上传成功，正在等待平台人工审核。
-  - 「审核被拒绝」：表示平台未予通过，须根据提示说明进行调整。
-- **帖子状态区分**：区分输出中的「帖子：...」（已公开可见）与「帖子（草稿，确认后才会公开）：...」（草稿状态，须创作者确认后公开）。
-- 直接将输出中的中文结果、帖子链接及他人拉取命令展示给用户，不要念底层的英文 JSON 键名，也不要向用户展示版本 ID、模板版本 ID 或关联帖 ID。不要展示正式版或试玩的作品地址（播放页、`lumimaker.66rpg.com` / `cg-maker.66rpg.com` 上的 `index.html`）。
-
----
-
-## 命令分类索引
-
-针对具体业务场景的详细执行流程与操作细则，请直接查阅对应子文件：
-
-1. [发布作品相关命令](references/publish-game.md)
-   - 发布正式版作品（`npx lumimaker publish`）
-   - 发布试玩版作品（`npx lumimaker publish --demo`）
-   - 前置构建要求、作品类型确认机制与横竖屏红线
-2. [发布模板与数据包相关命令](references/publish-template.md)
-   - 首次发布模板、续发模板版本（`publish-template`、`--with-assets`）
-   - 单独更新模板数据包（`publish-template-data`）
-   - 派生新模板（`--fork`）与「他人拉取」命令交付
-3. [发布开源工程相关命令](references/publish-project.md)
-   - 发布开源项目代码（`publish-project`）
-4. [常用基础与辅助命令](references/common-commands.md)
-   - 账号登录、身份查询与退出（`login`、`whoami`、`logout`）
-   - 规范检查（`validate-template`）与数据校验转调（`validate`）
-   - Agent 技能安装与同步（`skill`）
-
----
-
-## 全局红线与操作禁忌（绝对禁止）
-
-1. **托管与发布渠道**：
-   - 幻光文游社区托管的是作品、模板与开源工程，**严禁执行 `npm login` 或 `npm publish`**。
-2. **禁止跑废弃或不存在的管理命令**：
-   - **严禁执行 `npx lumimaker games`、`templates`、`projects` 或 `init` 等命令**（列表查询、版本查询、改名、改简介、上下架、更新说明等操作均不支持命令行，必须引导用户前往平台网页操作）。
-   - 发版时**严禁追加 `--changelog` 参数**（更新说明请引导用户到平台网页编辑）。
-3. **禁止在命令行传入属于配置文件的参数**：
-   - `version`、`data_ver` 必须写在 `package.json`，数据包目录固定为工程 `assets/`；**严禁将 `--version`、`--data-ver`、`--assets` 写进命令**。
-4. **禁止编造平台标识**：
-   - 模板 ID、作品 ID、数据包 ID、工程 ID 等均由平台服务端签发，并由工具自动维护在 `.lumimaker/` 目录下，**严禁人工猜测或手动编造**。
-5. **发布失败与防重复发红线**：
-   - **同一工程同一时刻只允许一条发布命令。** `publish`、`publish --demo`、`publish-template`、`publish-template-data`、`publish-project` 彼此互斥，禁止并行、禁止连发第二条。上一条还没结束（命令仍在跑、终端还没给出结果、或已超时但本机可能仍有 `lumimaker` 进程）时，**不要再发**。等这条真正结束后再决定下一步。
-   - **用户没说要试玩，不要跑 `publish --demo`，更不要和正式版一起发。** 用户没说只要试玩时，先跑不带 `--demo` 的 `publish`，按信封问这次发哪一种。
-   - 发布遇到失败、超时或用户要求“再发一次”时，**严禁立即使用相同版本号盲目重跑**，**严禁执行查询命令**。必须引导用户先到平台网页核对该版本是否已经存在；用户确认不存在后再修复重试，若已存在则须先修改版本号。
-6. **资源全本地化（严禁外链）**：
-   - 发布的产物与工程中**严禁引用任何在线 CDN 资源**（包括远程图片、字体、音视频、外链样式与脚本等），所有资源必须全部存放在工程本地。
-7. **源码纯净性**：
-   - 发布模板与开源工程时，上传内容为工程纯源码，**不得包含 `node_modules/`**。`package.json` 中的所有依赖包必须公开可用，版本号真实存在。
-8. **本地环境与隐私保护**：
-   - 本地 `.lumimaker/` 目录记录了工程在平台的身份，**须随项目提交至 git**；但登录凭据保存在本机安全密钥环中，**切勿提交登录凭据**。
-   - 严禁将内部私有 npm 镜像域名、内网 IP 地址写入回复、配置文件或命令行参数中；若用户反馈安装不上依赖，引导其联系官方客服，具体联系方式以 CLI 输出提示为准。
+---
+name: lumimaker
+description: 命令操作与发布指引。用户询问如何登录、发布作品、发布试玩（demo）、发布模板或开源工程，或执行 lumimaker 相关命令行操作时使用。严禁使用 npm login 或 npm publish。
+---
+
+# lumimaker CLI 命令操作指引
+
+本技能用于指导 Agent 正确执行幻光文游制作器的 `lumimaker` 命令，完成账号登录、作品发布、模板与数据包发布以及开源工程发布等操作。
+
+---
+
+## 协作分工与边界
+
+为遵循单一可信源（SSOT）原则，各项职责明确划分如下：
+
+- **CLI 命令操作与交互规范**：由本技能（`lumimaker`）说明。
+- **模板工程规范协议**：查阅 `lumimaker-template-spec`（校验工程目录、`package.json` 字段与脚本、构建产物）。
+- **播放页 SDK 接入**：查阅 `lumimaker-play-sdk`（在作品代码中通过 `window.CgMakerSdk` 调用平台功能）。
+- **免费背景音乐和音效**：查阅 `lumimaker-free-audio`（按用户描述挑选，下载到工程里再用，不要把网上的音频地址写进作品）。
+
+---
+
+## Agent 核心交互规范
+
+### 1. 坚持使用通俗大白话与用户沟通
+- 除非用户主动使用专业命令行术语，否则**不要向用户抛出底层技术黑话或内部字段名**（如 `qualified_name`、`revision_id`、`post_url` 等）。
+- CLI 返回需要用户确认或选择的内容时，将其转化为清晰易懂的日常口语进行询问。
+
+### 2. 禁止给命令加输出格式开关
+- **切勿为任何命令擅自追加 `--json` 或 `--format` 等输出格式开关**。
+- 正常执行成功时，终端输出均为给人阅读的中文卡片或中文文本，直接将其中的关键信息提取告知用户。
+- **只有在退出码为 10 / 11 / 12 时**，stdout 才是供 Agent 解析处理的 JSON 信封。
+
+### 3. 交互退出码处理机制
+
+当命令未直接执行成功并返回特定退出码时，严格按照下表流程处理，**严禁擅自做主或盲目猜测**：
+
+| 退出码 | 状态说明 | Agent 处置规范 |
+|---|---|---|
+| **10** | 检测到工具更新 (`update-available`) | 必须先询问用户，**禁止擅自 `--skip-update`**。列出推荐更新并口语询问：“检测到 lumimaker 有新版本，是否现在更新？”<br>• 用户同意：执行信封提供的更新命令（如 `npx lumimaker --apply-update`），成功后再原样重跑原命令。<br>• 用户拒绝：原命令追加 `--skip-update` 参数后重跑。 |
+| **11** | 缺少输入或待确认 (`need-input`) | 解析信封中的 `questions` 列表，用通俗口语逐一询问用户：<br>• **带有 `field` 属性**：将用户回答写回指定文件（如缺少 `version` / `data_ver` 时写入 `package.json` 对应字段），**写完后原样重跑命令**，不要擅自把 `--version` 等写进命令行。<br>• **带有 `flag` 属性**：将用户答案转化为对应命令行参数后重跑（例如现有 `package.json.name` 是 npm 包名时，信封会提供 `flag: --name`，此时不要覆盖该字段，转为 `--name` 参数重跑）。<br>• **待确认项**：见下方确认机制，严禁擅自加 `--yes`。 |
+| **12** | 未登录或凭据失效 (`login-required`) | 口语询问用户：“当前操作需要登录平台，是否现在打开浏览器登录？”<br>用户同意后执行 `npx lumimaker login`，等待用户在浏览器中完成登录后再重跑原命令。 |
+
+### 4. 正确理解发布结果与状态
+- **命令退出 0 仅代表本次提交操作完成**，绝对不等于作品或模板已经正式上线对外可见。
+- **发布状态以终端输出的中文标题为准**：
+  - 「发版成功」：表示该版本已通过审核并发布生效。
+  - 「已提交审核」：表示内容已上传成功，正在等待平台人工审核。
+  - 「审核被拒绝」：表示平台未予通过，须根据提示说明进行调整。
+- **帖子状态区分**：区分输出中的「帖子：...」（已公开可见）与「帖子（草稿，确认后才会公开）：...」（草稿状态，须创作者确认后公开）。
+- 直接将输出中的中文结果、帖子链接及他人拉取命令展示给用户，不要念底层的英文 JSON 键名，也不要向用户展示版本 ID、模板版本 ID 或关联帖 ID。不要展示正式版或试玩的作品地址（播放页、`lumimaker.66rpg.com` / `cg-maker.66rpg.com` 上的 `index.html`）。
+
+---
+
+## 命令分类索引
+
+针对具体业务场景的详细执行流程与操作细则，请直接查阅对应子文件：
+
+1. [发布作品相关命令](references/publish-game.md)
+   - 发布正式版作品（`npx lumimaker publish`）
+   - 发布试玩版作品（`npx lumimaker publish --demo`）
+   - 前置构建要求、作品类型确认机制与横竖屏红线
+2. [发布模板与数据包相关命令](references/publish-template.md)
+   - 首次发布模板、续发模板版本（`publish-template`、`--with-assets`）
+   - 单独更新模板数据包（`publish-template-data`）
+   - 派生新模板（`--fork`）与「他人拉取」命令交付
+3. [发布开源工程相关命令](references/publish-project.md)
+   - 发布开源项目代码（`publish-project`）
+4. [常用基础与辅助命令](references/common-commands.md)
+   - 账号登录、身份查询与退出（`login`、`whoami`、`logout`）
+   - 规范检查（`validate-template`）与数据校验转调（`validate`）
+   - Agent 技能安装与同步（`skill`）
+
+---
+
+## 全局红线与操作禁忌（绝对禁止）
+
+1. **托管与发布渠道**：
+   - 幻光文游社区托管的是作品、模板与开源工程，**严禁执行 `npm login` 或 `npm publish`**。
+2. **禁止跑废弃或不存在的管理命令**：
+   - **严禁执行 `npx lumimaker games`、`templates`、`projects` 或 `init` 等命令**（列表查询、版本查询、改名、改简介、上下架、更新说明等操作均不支持命令行，必须引导用户前往平台网页操作）。
+   - 发版时**严禁追加 `--changelog` 参数**（更新说明请引导用户到平台网页编辑）。
+3. **禁止在命令行传入属于配置文件的参数**：
+   - `version`、`data_ver` 必须写在 `package.json`，数据包目录固定为工程 `assets/`；**严禁将 `--version`、`--data-ver`、`--assets` 写进命令**。
+4. **禁止编造平台标识**：
+   - 模板 ID、作品 ID、数据包 ID、工程 ID 等均由平台服务端签发，并由工具自动维护在 `.lumimaker/` 目录下，**严禁人工猜测或手动编造**。
+5. **发布失败与防重复发红线**：
+   - **同一工程同一时刻只允许一条发布命令。** `publish`、`publish --demo`、`publish-template`、`publish-template-data`、`publish-project` 彼此互斥，禁止并行、禁止连发第二条。上一条还没结束（命令仍在跑、终端还没给出结果、或已超时但本机可能仍有 `lumimaker` 进程）时，**不要再发**。等这条真正结束后再决定下一步。
+   - **用户没说要试玩，不要跑 `publish --demo`，更不要和正式版一起发。** 用户没说只要试玩时，先跑不带 `--demo` 的 `publish`，按信封问这次发哪一种。
+   - 发布遇到失败、超时或用户要求“再发一次”时，**严禁立即使用相同版本号盲目重跑**，**严禁执行查询命令**。必须引导用户先到平台网页核对该版本是否已经存在；用户确认不存在后再修复重试，若已存在则须先修改版本号。
+6. **资源全本地化（严禁外链）**：
+   - 发布的产物与工程中**严禁引用任何在线 CDN 资源**（包括远程图片、字体、音视频、外链样式与脚本等），所有资源必须全部存放在工程本地。
+7. **源码纯净性**：
+   - 发布模板与开源工程时，上传内容为工程纯源码，**不得包含 `node_modules/`**，也不得包含 `package-lock.json`、`yarn.lock`、`pnpm-lock.yaml`、`npm-shrinkwrap.json`、`bun.lock`、`bun.lockb`（含子目录同名文件）。`package.json` 中的所有依赖包必须公开可用，版本号真实存在。
+8. **本地环境与隐私保护**：
+   - 本地 `.lumimaker/` 目录记录了工程在平台的身份，**须随项目提交至 git**；但登录凭据保存在本机安全密钥环中，**切勿提交登录凭据**。
+   - 严禁将内部私有 npm 镜像域名、内网 IP 地址写入回复、配置文件或命令行参数中；若用户反馈安装不上依赖，引导其联系官方客服，具体联系方式以 CLI 输出提示为准。

package/skill/lumimaker/references/common-commands.md

@@ -54,7 +54,7 @@ npx @66rpg/lumimaker-create@latest <用户名/slug@版本> --with-assets <数据
    - **禁止** `mkdir` / `cd` / `Set-Location` 建目录或切到自选目录再开工程
    - **禁止**为开工程而删除、清空当前文件夹里已有的文件
    - **禁止**把网页旧示例里的 `[目录]` 抄进命令
-   - 当前工作目录为空就在这里执行；里面已有文件时命令会退出，把提示告诉用户，请换到空文件夹后再执行。目录不空退出后，**禁止**改问文件夹名、**禁止**带目录重跑
+   - 当前工作目录为空就在这里执行。里面已有文件时立刻退出，告知用户自己准备一个空文件夹作为工作目录。**拒绝自动新建文件夹，拒绝以「会被 CLI 拦下」为由新建子目录再执行。** 目录不空退出后，**禁止**改问文件夹名、**禁止**带目录重跑
 2. **禁止擅自指定技能平台**：未指定 `--skill-platform` 时，CLI 会自动探测当前编辑器（如 Cursor、VSCode 等）并返回信封。不要擅自加上 `--skill-platform cursor`，遵循 CLI 探测结果。
 3. **未登录时的续跑保护**：若遇到未登录（退出码 12），脚手架已留在当前文件夹，**切勿更换文件夹，严禁删除已建立的目录**！引导用户执行 `npx lumimaker login` 完成登录后，在同一文件夹再执行刚才的开工程命令。
-4. **网页命令数据包对齐**：网页复制出的开工程命令如果没有 `--with-assets` 参数，**切勿自行补齐数据包编号**。
+4. **网页命令数据包对齐**：没有 `--with-assets` 时不要自己编数据包编号。CLI 会下载该模板版本绑定的数据包；命令里已有编号则原样带上。

package/skill/lumimaker/references/publish-project.md

@@ -21,7 +21,7 @@ npx lumimaker publish-project
    - 开源工程直接打包发布整套源码（包含工程内的资源），**没有独立的数据包通道**。
    - **切勿**添加 `--with-assets`、`--fork` 等模板专用的参数。
 2. **纯源码与依赖真实可用**：
-   - 上传的工程代码会自动排除 `node_modules/` 与 `dist/` 等中间文件。
+   - 上传的工程代码会自动排除 `node_modules/`、`dist/` 等中间文件，以及 `package-lock.json`、`yarn.lock`、`pnpm-lock.yaml`、`npm-shrinkwrap.json`、`bun.lock`、`bun.lockb`。
    - `package.json` 中的依赖包必须公开可用，版本真实存在。
    - 工程运行时所有素材与依赖必须使用工程本地文件，严禁使用外部 CDN 链接。
 3. **本地身份记录**：

package/skill/lumimaker/references/publish-template.md

@@ -22,7 +22,7 @@
    - 模板代码发布前，建议先执行 `npx lumimaker validate-template`，确保工程目录、脚本与基础配置符合 [模板规范协议](../lumimaker-template-spec/references/protocol.md)。
    - 建议执行 `npm run validate` 检查数据包内部数据的合规性。CLI 在发布模板时不会自动执行这些检查，作者或 Agent 须在发版前自行确认。
 2. **纯源码与依赖真实可用**：
-   - 发布的模板代码 zip 中**绝对不包含 `node_modules/`**。
+   - 发布的模板代码 zip 中**绝对不包含 `node_modules/`**，也不包含 `package-lock.json`、`yarn.lock`、`pnpm-lock.yaml`、`npm-shrinkwrap.json`、`bun.lock`、`bun.lockb`（含子目录同名文件）。
    - `package.json` 中的依赖包必须是公开可安装的稳定版本，严禁写入未发布的本地私有包或不存在的版本号。
    - 模板运行时所有资源必须全部存放在工程本地（`assets/` 或源码内），严禁依赖在线 CDN 外链。