@playcraft/cli 0.1.64 → 0.1.66

package/project-template/.claude/skills/playcraft-build-optimizer/SKILL.md

@@ -30,11 +30,11 @@ triggers: 构建优化,build optimizer,压缩,compress,WebP,pngquant,文件大
 
 ```bash
 # 检查最终输出文件大小
-playcraft image info --input dist/index.html --json  # 不适用，用 shell
+playcraft image info --input dist/preview/index.html --json  # 不适用，用 shell
 
 # Shell 方法：检查文件大小（字节）
-du -sh dist/index.html
-ls -lh dist/index.html
+du -sh dist/preview/index.html
+ls -lh dist/preview/index.html
 
 # 计算：若当前原始资产总大小为 X MB
 # 预计最终 HTML 大小 ≈ X × 1.33（Base64 膨胀）
@@ -112,34 +112,31 @@ grep -r "\.play()" game/ --include="*.js" --include="*.ts"
 
 ## 2. playcraft build 优化参数
 
+- 产物固定为单文件 `dist/preview/index.html`，用于本地 review；在云工作区中它就是产物面板里的可玩预览。
+- 下列参数只影响这份本地预览。渠道包（Meta、Google、AppLovin 等）只能通过平台导出生成，导出不会读取本地 build 的参数，渠道体积以导出时的校验为准。
+
 ### 完整优化构建命令
 
 ```bash
-# 标准优化构建（Meta 平台）
+# 标准优化构建
 playcraft build . \
-  --platform facebook \
   --compress-images \
   --image-quality 85 \
   --convert-webp \
   --js-minify \
-  --css-minify \
-  --output dist/
+  --css-minify
 
 # 带 3D 模型压缩的构建
 playcraft build . \
-  --platform facebook \
   --compress-images \
   --image-quality 80 \
   --convert-webp \
   --compress-models \
   --model-compression draco \
-  --js-minify \
-  --output dist/
+  --js-minify
 
 # 分析体积占用（不构建，只分析）
-playcraft build . \
-  --platform facebook \
-  --analyze
+playcraft build . --analyze
 ```
 
 ### 图片优化参数
@@ -170,25 +167,6 @@ playcraft build . \
 | `--js-minify`  | 启用 JS 压缩（Terser + 混淆） |
 | `--css-minify` | 启用 CSS 压缩                 |
 
-### 多平台批量构建
-
-```bash
-# 同时构建多个平台版本
-playcraft build-all . \
-  --platforms facebook,google,applovin \
-  --compress-images \
-  --image-quality 85 \
-  --convert-webp \
-  --js-minify \
-  --output dist/
-
-# 或按平台组
-playcraft build-all . \
-  --group mainstream \   # 主流平台
-  --compress-images \
-  --convert-webp
-```
-
 ---
 
 ## 3. 正确的优化执行顺序
@@ -207,9 +185,11 @@ playcraft build-all . \
    ↓
 5. playcraft build --js-minify --css-minify — 代码压缩
    ↓
-6. 检查最终文件大小（必须 < 5 MB）
+6. 检查 dist/preview/index.html 大小（仅供参考，渠道体积以平台导出校验为准）
    ↓
 7. 合规验证清单（§1）
+   ↓
+8. 通过平台导出生成各渠道包
 ```
 
 **禁止行为**：
@@ -298,9 +278,9 @@ playcraft 3d optimize \
 
 ## 6. 常见审核被拒原因速查
 
-| 被拒原因          | 占比 | 检查方法                 | 修复方法                                                |
-| ----------------- | ---- | ------------------------ | ------------------------------------------------------- |
-| 文件大小超过 5 MB | 45%  | `ls -lh dist/index.html` | `--compress-images --convert-webp` 或降低 image-quality |
-| 包含外部请求      | 30%  | `grep -r "https://"`     | Developer 将外部资源内嵌                                |
-| CTA 未实现        | 15%  | `grep "FbPlayableAd"`    | Developer 添加平台 CTA API                              |
-| 音频自动播放      | 10%  | `grep "autoplay"`        | Developer 改为用户交互触发                              |
+| 被拒原因          | 占比 | 检查方法                         | 修复方法                                                |
+| ----------------- | ---- | -------------------------------- | ------------------------------------------------------- |
+| 文件大小超过 5 MB | 45%  | `ls -lh dist/preview/index.html` | `--compress-images --convert-webp` 或降低 image-quality |
+| 包含外部请求      | 30%  | `grep -r "https://"`             | Developer 将外部资源内嵌                                |
+| CTA 未实现        | 15%  | `grep "FbPlayableAd"`            | Developer 添加平台 CTA API                              |
+| 音频自动播放      | 10%  | `grep "autoplay"`                | Developer 改为用户交互触发                              |

package/project-templates/empty/AGENTS.md

@@ -59,13 +59,15 @@ Do not ask the user to choose reuse versus generation for every asset. Ask only
 - Durable generation: `playcraft assets estimate --request <request-file>` estimates a request. `assets generate --request <request-file> --client-request-id <stable-unique-id>` starts a workspace generation task for images, audio, sprites, frame animation, models, or video. Reuse that identifier for the same request after an uncertain outcome. `assets tasks`, `assets get <taskId>`, `assets wait <taskId>`, and `assets cancel <taskId>` manage existing tasks. `assets download <taskId> --output <new-path>` retrieves a completed result. Commands infer workspace and project directory from the current checkout; explicit `--workspace` and `--directory` must match it.
 - Generated task results can be saved to the shared library through `assets library-targets`, `assets library-save`, `assets library-saves`, and `assets library-retry`. `assets animation` reads and edits animation drafts, uploads frames, and creates export versions. Keep request files and receipts outside `dist/`.
 
-## Deliverable artifacts
+## Workspace artifacts
 
-The artifact panel shows final deliverables under `dist/` at the current project directory's root, including images, video, audio, models, documents, and playable builds. Keep working sources, input references, dependencies, receipts, and build intermediates outside `dist/`. Do not copy unrelated source files into it just to make them appear in the panel.
+The artifact panel shows what this workspace builds and generates, under `dist/` at the current project directory's root: generated images, video, audio, models and documents, and the `playcraft build` preview. Channel packages are packaged by platform export, not built here; they belong in the Delivery tab and never in `dist/`. Keep working sources, input references, dependencies, receipts, and build intermediates outside `dist/`. Do not copy unrelated source files into it just to make them appear in the panel.
 
-When a generated asset is ready for delivery, save or copy it into `dist/` with a stable relative path. Keep the resources required by a model or document within `dist/` and preserve their relative links. Reuse the same delivery path for a revised artifact so its versions remain grouped; the platform retains its history. Use different paths for independent candidates or deliverables.
+When a generated asset is ready, save or copy it into `dist/` with a stable relative path. Keep the resources required by a model or document within `dist/` and preserve their relative links. Reuse the same path for a revised artifact so its versions remain grouped; the platform retains its history. Use different paths for independent candidates or artifacts.
 
-Run playable builds from the project root (`playcraft build --mode full --platform playcraft --format html .`). In a workspace this command builds in an isolated copy, validates the result, and retains the playable at `dist/playable/index.html` while preserving other deliverables. A successful agent command or turn that writes a valid self-contained HTML (HyperText Markup Language, 超文本标记语言) file at this same path is collected as the same playable preview. No separate publish action is required to view it. A base build's `dist/index.html` can still require resource files and remains a document. The page's generate-preview action rebuilds the current project through the same validation. After a successful build the command also publishes the playable and prints `Public URL: <address>`; when you report the build, link that address as the playable instead of the sandbox path, since it opens directly and can be shared. If the command prints `Public URL unavailable`, report that the build succeeded without a public address and give the reason it printed. Temporary `.playcraft-preview-out/` and `.playcraft-temp/` files are not deliverables. Preserve other artifacts already in `dist/` when rebuilding a playable.
+Run playable builds from the project root with `playcraft build`. It takes no channel or format options and always produces the review build at `dist/preview/index.html`; channel packages come only from platform export. In a workspace this command builds in an isolated copy, validates the result, and retains the playable at `dist/preview/index.html` while preserving other artifacts. A successful agent command or turn that writes a valid self-contained HTML file at this same path is collected as the same playable preview. No separate publish action is required to view it. A base build's `dist/index.html` can still require resource files and remains a document. The page's generate-preview action rebuilds the current project through the same validation. After a successful build the command also publishes the playable and prints `Public URL: <address>`; when you report the build, link that address as the playable instead of the sandbox path, since it opens directly and can be shared. If the command prints `Public URL unavailable`, report that the build succeeded without a public address and give the reason it printed. Temporary `.playcraft-preview-out/` and `.playcraft-temp/` files are not artifacts. Preserve other artifacts already in `dist/` when rebuilding a playable.
+
+When reporting finished exports, tell the user the packages are in the Delivery tab and open it with `playcraft_open_delivery`.
 
 Keep this convention in `AGENTS.md`, the project's standard instruction filename. Do not create a separate `AGENT.md`.
 

package/project-templates/phaser/.claude/skills/playcraft-build-optimizer/SKILL.md

@@ -30,11 +30,11 @@ triggers: 构建优化,build optimizer,压缩,compress,WebP,pngquant,文件大
 
 ```bash
 # 检查最终输出文件大小
-playcraft image info --input dist/index.html --json  # 不适用，用 shell
+playcraft image info --input dist/preview/index.html --json  # 不适用，用 shell
 
 # Shell 方法：检查文件大小（字节）
-du -sh dist/index.html
-ls -lh dist/index.html
+du -sh dist/preview/index.html
+ls -lh dist/preview/index.html
 
 # 计算：若当前原始资产总大小为 X MB
 # 预计最终 HTML 大小 ≈ X × 1.33（Base64 膨胀）
@@ -112,34 +112,31 @@ grep -r "\.play()" game/ --include="*.js" --include="*.ts"
 
 ## 2. playcraft build 优化参数
 
+- 产物固定为单文件 `dist/preview/index.html`，用于本地 review；在云工作区中它就是产物面板里的可玩预览。
+- 下列参数只影响这份本地预览。渠道包（Meta、Google、AppLovin 等）只能通过平台导出生成，导出不会读取本地 build 的参数，渠道体积以导出时的校验为准。
+
 ### 完整优化构建命令
 
 ```bash
-# 标准优化构建（Meta 平台）
+# 标准优化构建
 playcraft build . \
-  --platform facebook \
   --compress-images \
   --image-quality 85 \
   --convert-webp \
   --js-minify \
-  --css-minify \
-  --output dist/
+  --css-minify
 
 # 带 3D 模型压缩的构建
 playcraft build . \
-  --platform facebook \
   --compress-images \
   --image-quality 80 \
   --convert-webp \
   --compress-models \
   --model-compression draco \
-  --js-minify \
-  --output dist/
+  --js-minify
 
 # 分析体积占用（不构建，只分析）
-playcraft build . \
-  --platform facebook \
-  --analyze
+playcraft build . --analyze
 ```
 
 ### 图片优化参数
@@ -170,25 +167,6 @@ playcraft build . \
 | `--js-minify`  | 启用 JS 压缩（Terser + 混淆） |
 | `--css-minify` | 启用 CSS 压缩                 |
 
-### 多平台批量构建
-
-```bash
-# 同时构建多个平台版本
-playcraft build-all . \
-  --platforms facebook,google,applovin \
-  --compress-images \
-  --image-quality 85 \
-  --convert-webp \
-  --js-minify \
-  --output dist/
-
-# 或按平台组
-playcraft build-all . \
-  --group mainstream \   # 主流平台
-  --compress-images \
-  --convert-webp
-```
-
 ---
 
 ## 3. 正确的优化执行顺序
@@ -207,9 +185,11 @@ playcraft build-all . \
    ↓
 5. playcraft build --js-minify --css-minify — 代码压缩
    ↓
-6. 检查最终文件大小（必须 < 5 MB）
+6. 检查 dist/preview/index.html 大小（仅供参考，渠道体积以平台导出校验为准）
    ↓
 7. 合规验证清单（§1）
+   ↓
+8. 通过平台导出生成各渠道包
 ```
 
 **禁止行为**：
@@ -298,9 +278,9 @@ playcraft 3d optimize \
 
 ## 6. 常见审核被拒原因速查
 
-| 被拒原因          | 占比 | 检查方法                 | 修复方法                                                |
-| ----------------- | ---- | ------------------------ | ------------------------------------------------------- |
-| 文件大小超过 5 MB | 45%  | `ls -lh dist/index.html` | `--compress-images --convert-webp` 或降低 image-quality |
-| 包含外部请求      | 30%  | `grep -r "https://"`     | Developer 将外部资源内嵌                                |
-| CTA 未实现        | 15%  | `grep "FbPlayableAd"`    | Developer 添加平台 CTA API                              |
-| 音频自动播放      | 10%  | `grep "autoplay"`        | Developer 改为用户交互触发                              |
+| 被拒原因          | 占比 | 检查方法                         | 修复方法                                                |
+| ----------------- | ---- | -------------------------------- | ------------------------------------------------------- |
+| 文件大小超过 5 MB | 45%  | `ls -lh dist/preview/index.html` | `--compress-images --convert-webp` 或降低 image-quality |
+| 包含外部请求      | 30%  | `grep -r "https://"`             | Developer 将外部资源内嵌                                |
+| CTA 未实现        | 15%  | `grep "FbPlayableAd"`            | Developer 添加平台 CTA API                              |
+| 音频自动播放      | 10%  | `grep "autoplay"`                | Developer 改为用户交互触发                              |

package/project-templates/threejs/.claude/skills/playcraft-build-optimizer/SKILL.md

@@ -30,11 +30,11 @@ triggers: 构建优化,build optimizer,压缩,compress,WebP,pngquant,文件大
 
 ```bash
 # 检查最终输出文件大小
-playcraft image info --input dist/index.html --json  # 不适用，用 shell
+playcraft image info --input dist/preview/index.html --json  # 不适用，用 shell
 
 # Shell 方法：检查文件大小（字节）
-du -sh dist/index.html
-ls -lh dist/index.html
+du -sh dist/preview/index.html
+ls -lh dist/preview/index.html
 
 # 计算：若当前原始资产总大小为 X MB
 # 预计最终 HTML 大小 ≈ X × 1.33（Base64 膨胀）
@@ -112,34 +112,31 @@ grep -r "\.play()" game/ --include="*.js" --include="*.ts"
 
 ## 2. playcraft build 优化参数
 
+- 产物固定为单文件 `dist/preview/index.html`，用于本地 review；在云工作区中它就是产物面板里的可玩预览。
+- 下列参数只影响这份本地预览。渠道包（Meta、Google、AppLovin 等）只能通过平台导出生成，导出不会读取本地 build 的参数，渠道体积以导出时的校验为准。
+
 ### 完整优化构建命令
 
 ```bash
-# 标准优化构建（Meta 平台）
+# 标准优化构建
 playcraft build . \
-  --platform facebook \
   --compress-images \
   --image-quality 85 \
   --convert-webp \
   --js-minify \
-  --css-minify \
-  --output dist/
+  --css-minify
 
 # 带 3D 模型压缩的构建
 playcraft build . \
-  --platform facebook \
   --compress-images \
   --image-quality 80 \
   --convert-webp \
   --compress-models \
   --model-compression draco \
-  --js-minify \
-  --output dist/
+  --js-minify
 
 # 分析体积占用（不构建，只分析）
-playcraft build . \
-  --platform facebook \
-  --analyze
+playcraft build . --analyze
 ```
 
 ### 图片优化参数
@@ -170,25 +167,6 @@ playcraft build . \
 | `--js-minify`  | 启用 JS 压缩（Terser + 混淆） |
 | `--css-minify` | 启用 CSS 压缩                 |
 
-### 多平台批量构建
-
-```bash
-# 同时构建多个平台版本
-playcraft build-all . \
-  --platforms facebook,google,applovin \
-  --compress-images \
-  --image-quality 85 \
-  --convert-webp \
-  --js-minify \
-  --output dist/
-
-# 或按平台组
-playcraft build-all . \
-  --group mainstream \   # 主流平台
-  --compress-images \
-  --convert-webp
-```
-
 ---
 
 ## 3. 正确的优化执行顺序
@@ -207,9 +185,11 @@ playcraft build-all . \
    ↓
 5. playcraft build --js-minify --css-minify — 代码压缩
    ↓
-6. 检查最终文件大小（必须 < 5 MB）
+6. 检查 dist/preview/index.html 大小（仅供参考，渠道体积以平台导出校验为准）
    ↓
 7. 合规验证清单（§1）
+   ↓
+8. 通过平台导出生成各渠道包
 ```
 
 **禁止行为**：
@@ -298,9 +278,9 @@ playcraft 3d optimize \
 
 ## 6. 常见审核被拒原因速查
 
-| 被拒原因          | 占比 | 检查方法                 | 修复方法                                                |
-| ----------------- | ---- | ------------------------ | ------------------------------------------------------- |
-| 文件大小超过 5 MB | 45%  | `ls -lh dist/index.html` | `--compress-images --convert-webp` 或降低 image-quality |
-| 包含外部请求      | 30%  | `grep -r "https://"`     | Developer 将外部资源内嵌                                |
-| CTA 未实现        | 15%  | `grep "FbPlayableAd"`    | Developer 添加平台 CTA API                              |
-| 音频自动播放      | 10%  | `grep "autoplay"`        | Developer 改为用户交互触发                              |
+| 被拒原因          | 占比 | 检查方法                         | 修复方法                                                |
+| ----------------- | ---- | -------------------------------- | ------------------------------------------------------- |
+| 文件大小超过 5 MB | 45%  | `ls -lh dist/preview/index.html` | `--compress-images --convert-webp` 或降低 image-quality |
+| 包含外部请求      | 30%  | `grep -r "https://"`             | Developer 将外部资源内嵌                                |
+| CTA 未实现        | 15%  | `grep "FbPlayableAd"`            | Developer 添加平台 CTA API                              |
+| 音频自动播放      | 10%  | `grep "autoplay"`                | Developer 改为用户交互触发                              |