@66rpg/cgmaker 0.1.23 → 0.1.24

package/README.md

@@ -1,25 +1,27 @@
-# @66rpg/cgmaker
-
-作者工程里的平台工具。Node.js 20+。不要全局安装。本期原生命令 **仅 Windows x64**（optional `@66rpg/cgmaker-win32-x64`）。
-
-`validate-template` / `validate` 走 TypeScript。`login` / `publish` 等转发 `cgmaker`。
-
-```bash
-npx cgmaker validate-template
-npx cgmaker login
-npx cgmaker publish --version 1.0.0
-npx cgmaker publish --demo --version 1.0.0
-npx cgmaker publish-template --name "..." --version 0.1.0
-npx cgmaker publish-template --version 0.1.0 --with-assets
-npx cgmaker publish-template --version 0.1.0 --with-assets --assets C:\path\to\assets
-npx cgmaker publish-template-data --data-ver 2
-npx cgmaker publish-template-data --data-ver 2 --assets C:\path\to\assets
-npx cgmaker publish-project --version 1.0.0
-npx cgmaker skill --platform cursor
-```
-
-Agent 调用请加 `--agent --json`（缺参退出 11、新版本退出 10、未登录退出 12）。人在终端里不要加 `--agent`；TTY 若检测到新版本会询问是否更新。`npx cgmaker publish` 上传前会列出基本信息并确认；脚本加 `--yes`。
-
-试玩是独立游戏。查询 / 发布用平台 `template_id`。开工程第一位置用网页给的 `用户名/模板名`（可 `@版本`），或模板 id / 版本 id。开工程下载素材用 `--with-assets <数据包ID>`（已不再支持 `--data-id`）。`publish-template` 首发必须有平台模板名（`--name` 或合法 `package.json.name`，不能含 `/` `@`）。`--version`（缺省 `package.json.version`）须 1–16 位，仅小写字母、数字、`.`、`-`；须以字母或数字开头和结尾，不能有连续符号。还没发布过时第一版不能绑数据包。再发一版默认不带数据包；该 `data_ver` 尚无包且本地有 `assets/` 则自动上传。再带包用 `--with-assets`（开关）。Fork 换绑已有包才用 `--data-id`。`--assets` 指定绝对路径（zip 内仍为 `assets/`），在 `publish-template` 上出现即视为要上传。只改资源、不发新代码版本用 `publish-template-data`（须已有 origin；未传 `--data-ver` 则读 `package.json`，不写回）。config 不随包：放到 `~/.cgmaker/config.json`。
-
-流程给人看：仓库 `docs/users.md`、`docs/play-sdk.md`。给 Agent：本包 `skill/cgmaker/SKILL.md`（怎么发）、`skill/cgmaker-identity/SKILL.md`（参数与配置指南）、`skill/cgmaker-play-sdk/SKILL.md`（宿主 SDK）。
+# @66rpg/cgmaker
+
+作者工程里的平台工具。Node.js 20+。不要全局安装。原生命令 **目前仅 Windows x64**。
+
+`validate-template` 检查工程是否符合模板规范。`validate` 转调工程里必有的 `npm run validate`（有独立试玩数据时同一条命令检查两份，不要 `validate:demo`）。`login` / `publish` 等走平台。
+
+```bash
+npx cgmaker validate-template
+npx cgmaker validate
+npx cgmaker login
+npx cgmaker publish
+npx cgmaker publish --demo
+npx cgmaker publish-template
+npx cgmaker publish-template --with-assets
+npx cgmaker publish-template --data-summary "..."
+npx cgmaker publish-template-data
+npx cgmaker publish-project
+npx cgmaker skill --platform cursor
+```
+
+人在终端走交互；编辑器里跑命令会自动补齐缺的信息。终端若检测到新版本会询问是否更新。`npx cgmaker publish` 上传前会列出基本信息并确认；不想询问时可加 `--no-interactive`。
+
+试玩是独立作品。开工程第一位置用网页给的 `用户名/slug`（可 `@版本`），或模板 id / 版本 id。不要用平台展示名去开工程。开工程下载素材用 `--with-assets <数据包ID>`。
+
+`publish-template` 首发必须有合法 `package.json.name`（不能含 `/` `@`）。空了会问你并写回；如果这个字段已经带 `@`，不要改它，发布时会再问展示名。模板 `package.json.version` 须 1–16 位，仅小写字母、数字、`.`、`-`；须以字母或数字开头和结尾，不能有连续符号。还没发布过时第一版不能绑数据包。再发一版默认不带数据包；该 `data_ver` 尚无包且本地有 `assets/` 则自动上传。再带包用 `--with-assets`（开关）。素材说明可用 `--data-summary`。素材目录固定工程 `assets/`。只改资源、不发新代码版本用 `publish-template-data`。派生用 `--fork <版本ID>`；要带本地包加 `--with-assets`。发版不传更新说明，请到网页改。
+
+流程给人看：仓库 `docs/users.md`、`docs/play-sdk.md`。给 Agent：本包 `skill/cgmaker/SKILL.md`（怎么发）、`skill/cgmaker-identity/SKILL.md`（参数与配置指南）、`skill/cgmaker-play-sdk/SKILL.md`（宿主 SDK）。