@playcraft/cli 0.1.49-beta → 0.1.51

package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md

@@ -1,21 +1,23 @@
 # Image Generation Prompt Cookbook
 
-> 适用于 PlayCraft CLI `playcraft tools generate-image`。
+> 适用于 PlayCraft CLI (Command-Line Interface, 命令行工具) `playcraft tools generate-image` 及沙箱生图工具。
 > 所有模型均适用；gpt-image-2 类模型对英文 prompt 理解最准确，优先写英文。
 
+透明交付通过 `background: transparent` / `--background transparent` 或目标字段配置表达。用户未明确要求背景且字段没有明确不透明约束时，默认透明，包括卡牌、棋子和面板。下方常规前景模板描述主体、文字、风格、构图与材质；源图背景遵循主文第 2 节：Image 2.5 由后端组装，不追加背景后缀；明确选用其他模型时，首次请求需追加单一 `on a uniform solid pure white background for subsequent background removal`。不要同时要求透明、白底与色幕。用户或字段明确要求完整场景时可以描述背景内容；矩形本体的白色牌面属于前景，应在透明画布上保留。独立色幕流程见主文第 3 节，中间图必须关闭自动去背。
+
 ---
 
 ## 一、Prompt 万能公式
 
 ```
-[主体描述] + [风格/介质] + [构图/视角] + [背景] + [质量修饰词]
+[主体描述] + [风格/介质] + [构图/视角] + [场景内容（如需要）] + [质量修饰词]
 ```
 
 **示例**：
 
 ```
 A golden sword icon, flat 2D vector style, centered composition,
-white background, clean crisp edges, game UI asset, high quality
+isolated subject, clean crisp edges, game UI asset, high quality
 ```
 
 ---
@@ -26,12 +28,13 @@ white background, clean crisp edges, game UI asset, high quality
 
 ```
 A [物品名] icon, flat 2D vector illustration, bold outlines,
-vibrant colors, centered composition, white background,
+vibrant colors, centered composition, isolated subject,
 no shadow, no gradient, game UI style, sharp crisp edges
 ```
 
 - 关键词：`flat 2D` / `bold outlines` / `centered` / `no shadow` / `game UI style`
 - 避免：`3D` / `realistic` / `photographic` / `drop shadow`
+- 需要透明交付时传 `background: transparent` / `--background transparent`。
 
 ### 🃏 卡牌 / 棋子 / 方块（Rectangular Tiles）
 
@@ -50,12 +53,11 @@ sharp clean edges, centered on white background
 ```
 A [角色描述] character, full body visible, game sprite style,
 [艺术风格: pixel art / cartoon / chibi / realistic],
-isolated on solid bright green #00FF00 background,
+isolated subject,
 centered, facing forward / side view, clean silhouette
 ```
 
-- 需要透明背景 → **绿幕策略**，prompt 加 `"on solid bright green #00FF00 background, isolated"`
-- 后处理：`remove-background --tolerance 25`
+- 需要透明交付 → `background: transparent` / `--background transparent`，按主文第 2 节准备源图背景，由后端去背并完成验收。
 
 ### 🌄 场景背景（Backgrounds）
 
@@ -120,7 +122,7 @@ Grid layout, equal cell size, no borders between cells. Bold black ink for spade
 **图标集示例**（一批 9 个图标）：
 
 ```
-Sprite sheet grid, 3 columns × 3 rows. Flat 2D game icon style, white background.
+Sprite sheet grid, 3 columns × 3 rows. Flat 2D game icon style, isolated subjects.
 [Row1,Col1]: sword icon; [Row1,Col2]: shield icon; [Row1,Col3]: bow and arrow icon;
 [Row2,Col1]: magic staff icon; [Row2,Col2]: potion bottle icon; [Row2,Col3]: scroll icon;
 [Row3,Col1]: coin gold icon; [Row3,Col2]: gem diamond icon; [Row3,Col3]: key icon.
@@ -129,17 +131,18 @@ Each icon centered in its cell, bold outlines, vibrant colors, no shadow.
 
 **背景选择（重要！）**：
 
-| 素材类型                            | prompt 背景写法                                     | 切分后处理                         |
-| ----------------------------------- | --------------------------------------------------- | ---------------------------------- |
-| 独立元素（角色/车/道具/图标）需透明 | `isolated on solid bright green #00FF00 background` | `remove-background --tolerance 25` |
-| 卡牌/棋子/UI 面板（矩形本体）       | `white background, no shadow`                       | 直接 resize，不去背景              |
+| 素材类型                            | 交付要求                                              | 切分后处理                        |
+| ----------------------------------- | ----------------------------------------------------- | --------------------------------- |
+| 独立元素（角色/车/道具/图标）需透明 | `--background transparent`，按主文第 2 节准备源图背景 | 保留透明通道，验证每格前景与边缘  |
+| 卡牌/棋子/UI 面板（矩形本体）       | 默认 `--background transparent`，保留牌面与边框       | 验证本体外透明，按目标尺寸 resize |
+| 用户/字段明确要求保留背景的最终素材 | `--background opaque`，整张图片不透明                 | 保留背景，按目标尺寸 resize       |
 
 **注意事项**：
 
 - 每批最多 **4×4 = 16 个元素**，超过会出现混乱
 - 每个格的描述要精确，包含特征性视觉元素
 - 切分后用 `sprite-split --rows N --columns M` 按网格切分
-- 模板：[gen-batch-sprite.template.mjs](gen-batch-sprite.template.mjs)
+- 模板：[gen-batch-sprite.template.mjs](gen-batch-sprite.template.mjs)：`backgroundMode='automatic'` 为常规流程，`removeBg` 表示最终是否透明。独立色幕需显式设 `backgroundMode='chroma'`、所选模型和色幕颜色；脚本关闭整板自动去背，切分后逐格去背。
 
 ---
 
@@ -183,7 +186,7 @@ gpt-image-2 是目前质量最高的文生图模型，prompt 套路略有不同
 - **英文 prompt 效果最佳**，中文理解也不错但英文更稳定
 - 对**复杂场景**、**细节描述**处理能力远超其他模型
 - 支持**图生图 edit 模式**（传 `--reference-image`），局部编辑能力强
-- 不支持透明 PNG 输出（ALPHA = no），需绿幕策略
+- 不支持原生透明 PNG (Portable Network Graphics, 便携式网络图形) 输出（ALPHA = no）；透明交付仍由工具后处理。明确选择独立色幕制作时再按主文第 3 节处理。
 
 ### prompt 格式建议
 
@@ -231,6 +234,7 @@ elements centered in each cell, no borders between cells.
 ```bash
 playcraft tools generate-image \
   --prompt "A sword icon, flat 2D..." \
+  --background transparent \
   --output assets/gen/sword \
   --count 4 \
   --image-model iegg-litellm/gpt-image-2
@@ -248,6 +252,7 @@ playcraft tools generate-image \
 # 一次 API 调用生成 4 个候选，选最好的（比 4 次独立调用更高效）
 playcraft tools generate-image \
   --prompt "..." \
+  --background "$BACKGROUND_MODE" \
   --output "test/concept" \
   --count 4 \
   --image-model iegg-litellm/gpt-image-2
@@ -270,6 +275,8 @@ playcraft tools generate-image \
 >
 > 注意：`figer_icon.aiimage`、`win_result_panel.aiimage` 等 atom Skills 提供了带参考图的生成配方，Game Designer `playcraft skills match` 能匹配到时优先使用。本节模板用于无对应 atom Skill 的场景。
 
+下方独立界面前景通过 `background: transparent` / `--background transparent` 要求最终透明；模板描述主体，调用前按主文第 2 节补充适用于所选模型的源图背景。
+
 ### 🟠 CTA 按钮（Call-to-Action Button）
 
 ```
@@ -280,13 +287,13 @@ Important details: [bright orange / gold / green] gradient fill,
   subtle drop shadow below button, glossy highlight on top edge,
   3px white inner border, corners rounded radius 24px
 Use case: Game ad install button, isolated asset, HTML5 playable ad
-Constraints: Transparent background, no extra elements, centered, clean crisp edges,
+Constraints: No extra elements, centered, clean crisp edges,
   no watermark
 ```
 
 - CTA 颜色必须是游戏画面中**最少使用**的颜色（对比稀缺性原则）
 - 触控目标区域 ≥ 48×48px，生成建议尺寸 360×120px（9:3 比例）
-- 后处理：不需要去背景（直接生成透明背景或用绿幕）
+- 后处理由工具完成，验证最终透明背景、文字与边缘。
 
 ---
 
@@ -299,7 +306,7 @@ Important details: [color] filled portion [80% of total width], unfilled portion
   rounded end caps, thin outer frame in [darker shade],
   optional inner glow on filled section
 Use case: Game HUD progress indicator, isolated UI element
-Constraints: Transparent background, horizontal orientation, no text labels,
+Constraints: Horizontal orientation, no text labels,
   clean edges, no watermark
 ```
 
@@ -317,8 +324,7 @@ Important details: warm skin tone, white sleeve cuff visible at wrist,
   soft drop shadow beneath finger tip, friendly approachable style,
   [optional: subtle animated glow ring around fingertip]
 Use case: Tutorial overlay tap gesture for playable ad, points toward target element
-Constraints: Transparent background, PNG with alpha channel,
-  no extra limbs or elements, finger pointing at bottom-center
+Constraints: No extra limbs or elements, finger pointing at bottom-center
 ```
 
 **箭头变体**（更简洁）：
@@ -328,7 +334,7 @@ Subject: Bold cartoon arrow pointing [down / right], game tutorial UI
 Style: flat 2D, thick outline 4px, rounded arrowhead
 Important details: [bright yellow / white] fill, [dark outline],
   slight perspective tilt for depth, attention-grabbing
-Constraints: Transparent background, single clean arrow shape, no text
+Constraints: Single clean arrow shape, no text
 ```
 
 ---
@@ -342,7 +348,7 @@ Important details: white or [light color] fill, [2–3px] dark outline,
   tail pointing [down-left / down-center], interior empty for text overlay,
   subtle inner shadow or gradient
 Use case: Game tutorial hint tooltip, isolated UI asset
-Constraints: Transparent background, no text inside, clean edges,
+Constraints: No text inside, clean edges,
   no watermark, no extra decorations
 ```
 
@@ -362,7 +368,7 @@ Important details: [treasure chest]: lid slightly ajar, golden glow escaping fro
   [gold coins]: scattered pile, gleaming highlights, not neatly stacked (implies uncollected);
   [gem crystal]: large, brilliant facets, floating above ground, clearly valuable
 Use case: EndCard reward visual, creates FOMO and drives install
-Constraints: Transparent background, centered, isolated subject,
+Constraints: Centered, isolated subject,
   no CTA text (added separately), warm celebratory lighting
 ```
 
@@ -373,25 +379,19 @@ Constraints: Transparent background, centered, isolated subject,
 
 ### 📊 UI 元素背景处理规则速查
 
-| UI 元素类型      | prompt 背景写法                                 | 后处理                         |
-| ---------------- | ----------------------------------------------- | ------------------------------ |
-| CTA 按钮         | `transparent background` 或绿幕                 | floodfill 去背                 |
-| 进度条           | `transparent background` 或绿幕                 | floodfill 去背                 |
-| 引导手势         | `transparent background, PNG with alpha`        | floodfill 去背（tolerance 25） |
-| 对话气泡         | `transparent background` 或绿幕                 | floodfill 去背                 |
-| EndCard 奖励图标 | 绿幕（`solid bright green #00FF00 background`） | floodfill 去背（tolerance 25） |
+CTA 按钮、进度条、引导手势、对话气泡与 EndCard 奖励图标都通过 `background: transparent` / `--background transparent` 要求最终透明；主体内容使用上述模板，源图背景按主文第 2 节准备。交付后验证文字、完整前景及深浅背景上的边缘。独立色幕制作沿用主文第 3 节的单一背景与独立去背流程。
 
 ---
 
 ## 六、常见问题 & 修正方案
 
-| 问题               | 原因                 | 修正                                             |
-| ------------------ | -------------------- | ------------------------------------------------ |
-| 图标边缘有阴影     | 模型默认加立体效果   | 加 `no shadow, no drop shadow, flat 2D`          |
-| 构图不居中         | 没有明确指定         | 加 `centered composition, subject centered`      |
-| 背景不干净         | 背景描述不够明确     | 加 `solid white background, isolated` 或绿幕策略 |
-| 多个物体出现       | 主体不够明确         | 加 `a single [物体]`, `only one [物体]`          |
-| 文字拼写错误       | 所有模型通病         | 尝试 gpt-image-2（最好），或多生成几张           |
-| 风格不一致（批量） | 没用 reference image | Phase 2 必须加 `--reference-image`               |
-| 细节过于复杂       | 素材尺寸小但细节太多 | 加 `simple design, minimal details, bold shapes` |
-| 生成极慢/超时      | 模型负载高           | 换另一个 provider 或换模型                       |
+| 问题               | 原因                 | 修正                                                                     |
+| ------------------ | -------------------- | ------------------------------------------------------------------------ |
+| 图标边缘有阴影     | 模型默认加立体效果   | 加 `no shadow, no drop shadow, flat 2D`                                  |
+| 构图不居中         | 没有明确指定         | 加 `centered composition, subject centered`                              |
+| 背景不干净         | 交付要求或处理不匹配 | 核对背景开关、字段配置及模型对应的源图规则；检查最终验收，不混加背景要求 |
+| 多个物体出现       | 主体不够明确         | 加 `a single [物体]`, `only one [物体]`                                  |
+| 文字拼写错误       | 所有模型通病         | 尝试 gpt-image-2（最好），或多生成几张                                   |
+| 风格不一致（批量） | 没用 reference image | Phase 2 必须加 `--reference-image`                                       |
+| 细节过于复杂       | 素材尺寸小但细节太多 | 加 `simple design, minimal details, bold shapes`                         |
+| 生成极慢/超时      | 模型负载高           | 换另一个 provider 或换模型                                               |

package/SKILLS_REGISTRY.md

@@ -1,149 +0,0 @@
-# 远程技能管理
-
-`playcraft skills registry` 管理已部署注册表中的技能、不可变版本和发行审核。它与现有离线 `skills list/match/read`、项目 `skills project` 命令并存。服务端需要提供 `/api/agent/skill-registry/managed` 路由。
-
-网页管理复用现有技能控制台的“发布与更新”页签：系统管理入口为 `/admin/system?tab=agentSkills`，技能工作台入口为 `/agent/skills?view=management`。不新增 Skills 一级导航，旧 `/skills` 仅保留兼容重定向。
-
-2026-10-15 已在当前开发配置指定的目标数据库执行并验证 0186 和 [0187_add_skill_scope_governance.sql](../backend-business-server/drizzle/migrations/0187_add_skill_scope_governance.sql)。其他环境启用前仍须应用对应迁移，并部署配套服务与客户端。本次目标数据库升级不代表生产已上线或命令包已发行。
-
-## 登录与目标环境
-
-```bash
-playcraft login --url 'https://playcraft.example.com/__env/test-a'
-playcraft skills registry list --scope private --json
-```
-
-命令复用登录保存的 PAT (Personal Access Token, 个人访问令牌)。所有命令支持 `--url`、`--token`、`--json`、`--scope private|team|platform` 和 `--team <teamId>`。环境地址顺序为 `--url`、`PLAYCRAFT_API_URL`、`PLAYCRAFT_URL`、已保存地址、默认云端。令牌优先使用 `--token` 或 `PLAYCRAFT_TOKEN`，否则仅使用该环境保存的凭据。环境路径前缀完整保留，向其他环境不会自动发送原环境令牌。
-
-`private` 是默认范围；`team` 必须明确传入 `--team`，其他范围不能携带 `--team`。`--json` 成功时只输出一个结果对象，运行错误时只输出一个 `error` 对象并以非零状态退出。未知参数或缺少必填参数由命令解析器报告到标准错误。
-
-## 查询与下载
-
-```bash
-playcraft skills registry list --scope private --query video --limit 20 --json
-playcraft skills registry list --scope team --team '<teamId>' --cursor '<nextCursor>' --json
-playcraft skills registry list --scope platform --json
-playcraft skills registry info author/video-helper@1.2.0 --files --json
-playcraft skills registry info author/video-helper --versions --json
-playcraft skills registry pull author/video-helper@1.2.0 --out ./downloaded-skill --json
-```
-
-`list` 支持关键词、1–100 条分页和返回的 `nextCursor`；不会自动取完所有页面。`info` 默认省略正文与文件清单，`--files` 返回文件清单，`--versions` 返回可访问版本。查询与下载可省略版本，此时先解析所选发行范围的当前版本，再按其精确版本标识下载。
-
-`pull` 同时验证元数据、响应头和压缩包的 SHA-256 (Secure Hash Algorithm 256-bit, 256 位安全散列算法) 摘要。包内已声明的 `skillRef/version` 必须匹配；历史制品可缺少声明，仍按服务端精确版本与摘要校验，不重写原制品。内容先写入临时目录，校验完成后原子落地；目标须不存在或为空，路径不能包含符号链接。拉取不会执行资源中的脚本，不修改项目声明、锁或运行时绑定。`.playcraft-skill.json` 保存环境、身份、版本和摘要，不含凭据；再次打包时自动排除。
-
-## 上传与发布
-
-技能目录必须包含非空 `SKILL.md`，可包含 `manifest.json`、`references/`、`scripts/`、`assets/` 等完整资源。`manifest.json` 可直接声明 `skillRef/version`；否则通过参数明确提供。标识必须是小写 `namespace/slug`，以字母或数字开头，允许连字符和下划线，slug 还允许点号。版本目前支持无前导零的精确 `x.y.z`，最多 32 字符；不支持预发行、构建后缀、`latest` 或版本范围。
-
-首期上传接受 Markdown 技能包（`bundleType: "markdown"`），Atom 技能的查询与下载可用，上传管理尚未开放。正式发行还要求有效名称和描述，建议在 `SKILL.md` 的 frontmatter 中声明 `name` 与 `description`，或在清单中声明。平台发行还要求上传时通过 `--changelog` 提供变更说明，并完成平台评估与管理员审核。
-
-```bash
-# 只登记草稿，不发布
-playcraft skills registry push ./my-skill --ref author/video-helper --version 1.2.0 --json
-
-# 上传后发布到本人范围；本人发布与更新免管理员审核
-playcraft skills registry publish ./my-skill --ref author/video-helper --version 1.2.0 --scope private --json
-
-# 上传新版本，明确旧版本；先同步修改清单中的 version（若已声明）
-playcraft skills registry update author/video-helper --from ./my-skill --version 1.3.0 --base-version 1.2.0 --changelog 'Improve examples' --json
-playcraft skills registry publish author/video-helper@1.3.0 --scope private --json
-
-# 同一精确版本推广到团队或平台，不重新分配身份
-playcraft skills registry publish author/video-helper@1.3.0 --scope team --team '<teamId>' --json
-playcraft skills registry publish author/video-helper@1.3.0 --scope platform --json
-```
-
-目录打包仅在内存中补充缺失的清单字段，不改动源目录。显式参数与现有清单身份或版本冲突时拒绝上传。`publish <ref>@<version>` 只发布已上传版本，不能同时传入目录上传参数 `--ref`、`--version`、`--base-version` 或 `--changelog`。排除根目录 `.git`、`node_modules` 和拉取回执；其他文件按目录完整收录，发布前应确保目录只包含需要分享的技能资源。拒绝符号链接、硬链接、不安全路径及大小超限：最多 512 个文件，单文件 16 MiB (Mebibyte, 二进制兆字节)，内容总量与压缩包各 64 MiB。清单中的文件引用和显式摘要必须匹配实际文件。
-
-全平台同一 `skillRef@version` 唯一；同内容重传复用版本，改内容必须增加版本号。已有命名空间占用或所有权冲突不会转换为更新他人技能。平台保留标识和新建平台归属技能由服务端管理员权限控制，普通作者可先上传本人技能，再向平台发行提审。
-
-`push/update` 返回 `published: false`。`publish` 先检查当前发行指针，再携带该指针提交；并发发行变更由服务端拒绝。本人发行免审核；团队发行须目标团队管理员批准；平台发行须平台管理员批准。没有有效批准时，发布返回 `status: "review_pending"`、`published: false` 和审核标识。以返回字段为准，命令成功不代表已经发行。
-
-## 审核、历史与回滚
-
-```bash
-playcraft skills registry publish-check author/video-helper@1.3.0 --scope team --team '<teamId>' --json
-playcraft skills registry review submit author/video-helper@1.3.0 --scope team --team '<teamId>' --json
-playcraft skills registry review list --scope team --team '<teamId>' --json
-playcraft skills registry review approve '<reviewId>' --json
-playcraft skills registry review reject '<reviewId>' --reason 'Add usage examples' --json
-
-# 审核后显式发布相同版本、相同目标范围
-playcraft skills registry publish author/video-helper@1.3.0 --scope team --team '<teamId>' --json
-playcraft skills registry history author/video-helper --scope team --team '<teamId>' --json
-playcraft skills registry rollback author/video-helper@1.2.0 --scope team --team '<teamId>' --reason 'Regression in 1.3.0' --json
-```
-
-审核决定只批准或拒绝指定申请，不自动执行发布。审核授权与申请目标范围由服务端校验。`publish-check` 显示硬性问题、评估问题、审核要求和当前发行指针；检查通过仍可能因发布时权限或指针改变而失败。回滚只移动选定范围的发行指针，复用已有精确版本，仍受该范围授权、审核和并发检查约束，不重写旧项目锁。
-
-## 中断与恢复
-
-修改请求不自动重试。命令在发出请求前将请求键及 `pending` 状态写入 `~/.playcraft/registry-requests/`，收到明确结果后记录 `completed/rejected`；回执不保存令牌或技能内容。发布与回滚同时保存操作目标、精确版本、摘要和首次检查得到的发行指针。超时、断线或响应无法确认目标时保留 `pending`；相同环境、凭据和操作的重试复用原请求键及原发行指针，不重新检查后覆盖其他人后来发布的版本。已明确完成或拒绝后，再次执行属于新的操作，会重新检查并分配请求键。服务端精确版本、内容摘要及发行指针是最终事实来源。上传后发布中断时，也可运行 `info <ref>@<version>`、`publish-check` 和 `history` 核对，再继续精确版本发布。
-
-## 原生平台视频技能首次登记
-
-云工作区默认使用的两个引用是 `remix/playcraft-video-understanding` 和 `remix/playcraft-replica-validation`。它们必须通过 `platform push` 登记，服务端会创建 `kind=platform`、`source=platform` 的原生身份。普通 `push --scope platform` 创建的是托管工作区技能，不能替代这一入口。
-
-```bash
-playcraft skills registry platform push ./playcraft-video-understanding-1.0.1.tar.gz --changelog '更新视频理解指引与评估用例' --json
-playcraft skills registry platform push ./playcraft-replica-validation-1.0.1.tar.gz --changelog '更新复刻验收指引与评估用例' --json
-```
-
-`platform push <source>` 接受完整目录或已准备的压缩包。目录必须已含原生 `manifest.json`；命令保留其文件内容，不补充托管技能默认字段。已有压缩包原样发送，不重打包。可选的 `--ref`、`--version` 必须与清单一致；可用 `--evaluation-template <templateId>` 指定初始评估模板。原生入口当前仅接受上述两个引用，要求平台类型、单一 `sandbox-agent` surface、对齐的名称与版本、无 imports/relationships；服务端执行完整校验与摘要归一化，并返回最终 `artifactHash`。登记不会自动评估、审核或发布。
-
-此入口要求具有平台管理权限的真实账号凭据；命令复用目标环境登录，不发送本地身份模拟请求头。服务端需已部署允许真实管理员个人访问令牌访问原生登记和评估接口的版本。
-
-## 真实评估
-
-评估会使用指定工作区的模型和配置，在服务端评估执行器中实际运行用例。命令不构造通过记录，也不调用内部执行步骤接口。评估队列、执行器、模型和证据存储均须可用。先明确目标环境、工作区以及精确 `ref@version`，再选择模板和模型：
-
-```bash
-playcraft skills registry evaluation templates list --json
-playcraft skills registry evaluation models --workspace '<workspaceId>' --json
-playcraft skills registry evaluation config get remix/playcraft-video-understanding@1.0.1 --scope platform --json
-```
-
-没有可用模板时，管理员可创建并启用模板：
-
-```bash
-playcraft skills registry evaluation templates create --input ./evaluation-template.json --json
-playcraft skills registry evaluation templates enable '<templateId>' --json
-# 停用模板会使相关发布检查不再接受该模板
-playcraft skills registry evaluation templates disable '<templateId>' --json
-```
-
-模板输入文件只接受 `{ "key": "...", "name": "...", "spec": { ... } }`。`spec` 使用现有评估模板字段：`executor`、`dockerImage`、`cloudTemplateId`、`nodeVersion`、`opencodeVersion`、`modelConfigId`、`graderVersion`、`caseTimeoutSeconds`、`runTimeoutSeconds`、`globalConcurrency`。填写实际运行镜像与工具版本；使用本地 Docker 时不要填写虚构的云模板标识。运行平台如何选择执行器由部署配置决定，命令不会自动切换。模板创建会分配新修订，**不保证请求键幂等**；若响应丢失，先用 `templates list` 核对，再决定是否重试。
-
-配置输入文件只接受 `{ "templateId": "...", "expectedRevision": 0, "spec": { ... } }`。`expectedRevision` 使用 `config get` 返回的修订号；`spec` 包含 `modelConfigId`、`caseTimeoutSeconds`、`cases`。用例结构及断言种类见 [共享评估类型](../common/src/skill-evaluation.ts)。填写有意义的真实提示词、输入文件、断言和必要的模型评审要求；服务端校验完整性、运行证据与发布条件。
-
-```bash
-playcraft skills registry evaluation config set remix/playcraft-video-understanding@1.0.1 --scope platform --input ./video-evaluation-config.json --json
-playcraft skills registry evaluation run remix/playcraft-video-understanding@1.0.1 --scope platform --workspace '<workspaceId>' --config '<configId>' --request-key 'video-1-0-1-run-001' --wait --timeout 1800 --interval 3 --json
-```
-
-`--config` 必须是保存返回的精确配置标识；工作区标识不要求是通用唯一标识符。请求键允许 8–128 位字母、数字、下划线或连字符；重新执行一次评估需新键，断线恢复同一次评估需复用原键及全部原参数。`--compare` 可同时评估当前稳定版作为基线。省略 `--wait` 时返回已创建评估；带 `--wait` 时只有 `phase=completed` 且 `verdict=passed` 才成功退出，失败或取消会返回包含评估记录的结构化错误并非零退出。
-
-```bash
-playcraft skills registry evaluation status '<runId>' --json
-playcraft skills registry evaluation runs remix/playcraft-video-understanding@1.0.1 --scope platform --workspace '<workspaceId>' --json
-playcraft skills registry evaluation wait '<runId>' --timeout 1800 --interval 3 --json
-playcraft skills registry evaluation evidence '<runId>' --case '<caseResultId>' --json
-playcraft skills registry evaluation cancel '<runId>' --json
-```
-
-`--case` 使用状态结果中的 `results[].id`，不是逻辑用例名 `normal/boundary/regression`。状态含用例结果和检查项；`evidence` 读取对应归档证据。轮询默认最多 600 秒、间隔 3 秒；超时只停止等待，不取消后台评估，也不自动重新发起。修改请求不自动重试；配置写入使用预期修订号，断线后先读取配置确认实际结果。
-
-## 同一原生版本的正式发布
-
-应用治理迁移后，原生平台身份也使用托管注册表的审核、检查和发布命令；不要调用旧发布接口。评估配置变化会使旧配置的审核和证据失效。完成真实评估后，对同一精确版本提交审核、查看证据并由有权限的管理员批准，然后发布：
-
-```bash
-playcraft skills registry review submit remix/playcraft-video-understanding@1.0.1 --scope platform --json
-playcraft skills registry review approve '<reviewId>' --json
-playcraft skills registry publish-check remix/playcraft-video-understanding@1.0.1 --scope platform --json
-playcraft skills registry publish remix/playcraft-video-understanding@1.0.1 --scope platform --json
-playcraft skills registry history remix/playcraft-video-understanding --scope platform --json
-```
-
-对 `remix/playcraft-replica-validation@1.0.1` 独立完成同样流程。检查必须没有硬性或评估问题；最终核对 `published: true`、返回的精确版本与摘要，以及发行历史。命令没有例外发布选项，不跳过真实评估或审核。这里描述的是操作流程，新增命令的自动测试通过不代表任一环境已完成真实评估或正式发布。工作区预览绑定仍不属于本命令组。

package/dist/auth/account-activation.js

@@ -1,157 +0,0 @@
-import { existsSync, readFileSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-import { loadGlobalConfig } from '../config.js';
-import { accountActivationMessage } from './messages.js';
-export const ACCOUNT_PENDING_ACTIVATION = 'account_pending_activation';
-export class AccountActivationError extends Error {
-    code;
-    status;
-    retryable = false;
-    constructor(code, message, status) {
-        super(message);
-        this.code = code;
-        this.status = status;
-        this.name = 'AccountActivationError';
-    }
-}
-export function responseErrorCode(payload) {
-    if (!payload || typeof payload !== 'object')
-        return undefined;
-    const { error, code } = payload;
-    return typeof error?.code === 'string' ? error.code : typeof code === 'string' ? code : undefined;
-}
-export function pendingAccountActivationError(status, payload) {
-    return status === 403 && responseErrorCode(payload) === ACCOUNT_PENDING_ACTIVATION
-        ? new AccountActivationError(ACCOUNT_PENDING_ACTIVATION, `${ACCOUNT_PENDING_ACTIVATION}: ${accountActivationMessage('pending')}`, status)
-        : undefined;
-}
-export function parseErrorPayload(text) {
-    try {
-        return JSON.parse(text);
-    }
-    catch {
-        return undefined;
-    }
-}
-function localActivationConfig() {
-    for (const path of [
-        join(process.cwd(), '.playcraft.json'),
-        '/project/.playcraft.json',
-        join(homedir(), '.playcraft.json'),
-    ]) {
-        if (!existsSync(path))
-            continue;
-        try {
-            const config = JSON.parse(readFileSync(path, 'utf8'));
-            if (config && typeof config === 'object' && !Array.isArray(config))
-                return config;
-        }
-        catch {
-            // Follow the existing local credential lookup when a file is unreadable.
-        }
-    }
-    return {};
-}
-function stringValue(value) {
-    return typeof value === 'string' && value ? value : undefined;
-}
-function activationBaseUrl(raw) {
-    try {
-        const url = new URL(raw);
-        if (!['http:', 'https:'].includes(url.protocol) ||
-            url.username ||
-            url.password ||
-            url.search ||
-            url.hash)
-            throw new Error();
-        url.pathname = url.pathname.replace(/\/+$/, '').replace(/\/api$/, '');
-        return url.toString().replace(/\/+$/, '');
-    }
-    catch {
-        throw new AccountActivationError('INVALID_ACTIVATION_TARGET', accountActivationMessage('invalidTarget'));
-    }
-}
-function savedTokenForTarget(config, rawUrl, target, environment) {
-    if (!rawUrl || (stringValue(config.env)?.trim() || '') !== environment)
-        return undefined;
-    try {
-        return activationBaseUrl(rawUrl) === target ? stringValue(config.token) : undefined;
-    }
-    catch {
-        return undefined;
-    }
-}
-function normalizedSavedUrl(raw) {
-    try {
-        return raw ? activationBaseUrl(raw) : undefined;
-    }
-    catch {
-        return undefined;
-    }
-}
-export async function activateAccount(options, defaultBaseUrl) {
-    const local = localActivationConfig();
-    const global = loadGlobalConfig();
-    const localUrl = stringValue(local.apiUrl);
-    const globalUrl = stringValue(global.backendUrl) || stringValue(global.url);
-    const explicitUrl = options.url || process.env.PLAYCRAFT_API_URL || process.env.PLAYCRAFT_URL;
-    const target = activationBaseUrl(explicitUrl || localUrl || globalUrl || defaultBaseUrl);
-    const explicitToken = options.token || process.env.PLAYCRAFT_TOKEN || process.env.PLAYCRAFT_SANDBOX_TOKEN;
-    const savedUrls = [normalizedSavedUrl(localUrl), normalizedSavedUrl(globalUrl)].filter(Boolean);
-    const savedTokens = [stringValue(local.token), stringValue(global.token)].filter(Boolean);
-    const environmentsConflict = savedUrls.length === 2 &&
-        savedUrls[0] === savedUrls[1] &&
-        (stringValue(local.env)?.trim() || '') !== (stringValue(global.env)?.trim() || '');
-    const environmentTokensConflict = process.env.PLAYCRAFT_TOKEN &&
-        process.env.PLAYCRAFT_SANDBOX_TOKEN &&
-        process.env.PLAYCRAFT_TOKEN !== process.env.PLAYCRAFT_SANDBOX_TOKEN;
-    const environmentUrlsConflict = process.env.PLAYCRAFT_API_URL &&
-        process.env.PLAYCRAFT_URL &&
-        normalizedSavedUrl(process.env.PLAYCRAFT_API_URL) !==
-            normalizedSavedUrl(process.env.PLAYCRAFT_URL);
-    if ((!explicitUrl && new Set(savedUrls).size > 1) ||
-        (!explicitToken && new Set(savedTokens).size > 1) ||
-        (environmentsConflict && !process.env.PLAYCRAFT_ENV) ||
-        (environmentTokensConflict && !options.token) ||
-        (environmentUrlsConflict && !options.url)) {
-        throw new AccountActivationError('AMBIGUOUS_ACTIVATION_TARGET', accountActivationMessage('ambiguous'));
-    }
-    const environment = (process.env.PLAYCRAFT_ENV ||
-        (!explicitUrl ? (localUrl ? stringValue(local.env) : stringValue(global.env)) : '') ||
-        '').trim();
-    const token = explicitToken ||
-        savedTokenForTarget(local, localUrl, target, environment) ||
-        savedTokenForTarget(global, globalUrl, target, environment);
-    if (!token)
-        throw new AccountActivationError('AUTH_REQUIRED', accountActivationMessage('missingToken'));
-    if (!/^playcraft_pat_[A-Za-z0-9_-]{32}$/.test(token)) {
-        throw new AccountActivationError('INVALID_ACTIVATION_TOKEN', accountActivationMessage('invalidToken'));
-    }
-    let response;
-    try {
-        response = await fetch(`${target}/api/settings/personal-access-tokens/activate`, {
-            method: 'POST',
-            redirect: 'error',
-            signal: AbortSignal.timeout(30_000),
-            headers: {
-                Authorization: `Bearer ${token}`,
-                ...(environment ? { 'playcraft-env': environment } : {}),
-            },
-        });
-    }
-    catch {
-        throw new AccountActivationError('ACTIVATION_UNCONFIRMED', accountActivationMessage('unavailable'));
-    }
-    if (!response.ok) {
-        await response.body?.cancel().catch(() => { });
-        throw new AccountActivationError('ACTIVATION_FAILED', accountActivationMessage('failed'), response.status);
-    }
-    const result = await response.json().catch(() => undefined);
-    if (!result ||
-        typeof result !== 'object' ||
-        result.accountStatus !== 'active') {
-        throw new AccountActivationError('ACTIVATION_UNCONFIRMED', accountActivationMessage('unavailable'), response.status);
-    }
-    console.log(accountActivationMessage('success'));
-}

package/dist/auth/messages.js

@@ -1,30 +0,0 @@
-const messages = {
-    en: {
-        activateOption: 'Explicitly activate the account using the current personal access token',
-        tokenOption: 'Personal access token for --activate (or use PLAYCRAFT_TOKEN)',
-        pending: 'Account activation is required. Run `playcraft login --activate` with the same token and target environment, then rerun your command.',
-        success: 'Account activated. Rerun your original command to continue.',
-        missingToken: 'No personal access token matches this target environment. Provide PLAYCRAFT_TOKEN or log in to this environment first.',
-        invalidToken: 'Account activation requires a personal access token. A sandbox token cannot activate an account.',
-        ambiguous: 'Activation credentials or target environments conflict. Specify --url, PLAYCRAFT_ENV when needed, and an explicit personal access token using --token or PLAYCRAFT_TOKEN.',
-        invalidTarget: 'Use a web service base address (http:// or https://) without credentials, a query, or a fragment.',
-        failed: 'Account activation failed. Check the target environment and token before trying again.',
-        unavailable: 'Account activation could not be confirmed. Check your account status before explicitly trying again.',
-    },
-    zh: {
-        activateOption: '明确使用当前个人访问令牌激活账号',
-        tokenOption: '用于 --activate 的个人访问令牌（也可使用 PLAYCRAFT_TOKEN）',
-        pending: '账号需要激活。请使用同一令牌和目标环境主动运行 `playcraft login --activate`，然后重新执行原命令。',
-        success: '账号已激活，请重新执行原命令继续。',
-        missingToken: '没有与目标环境匹配的个人访问令牌。请提供 PLAYCRAFT_TOKEN，或先登录此环境。',
-        invalidToken: '激活账号需要个人访问令牌，沙箱令牌不能用于激活账号。',
-        ambiguous: '激活凭据或目标环境存在冲突。请明确指定 --url、所需的 PLAYCRAFT_ENV，并通过 --token 或 PLAYCRAFT_TOKEN 提供个人访问令牌。',
-        invalidTarget: '激活目标必须是网页服务基址（http:// 或 https://），不能包含凭据、查询参数或片段。',
-        failed: '账号激活失败，请检查目标环境和令牌后再尝试。',
-        unavailable: '无法确认账号是否已激活。请先检查账号状态，再主动决定是否重试。',
-    },
-};
-export function accountActivationMessage(key) {
-    const locale = process.env.PLAYCRAFT_LANGUAGE || process.env.LANG || 'en';
-    return messages[locale.startsWith('zh') ? 'zh' : 'en'][key];
-}

package/dist/commands/build-temp.js

@@ -1,26 +0,0 @@
-import { randomUUID } from 'node:crypto';
-import { mkdir, rm } from 'node:fs/promises';
-import path from 'node:path';
-export async function createBuildTempDirectory(projectPath) {
-    const parent = path.join(projectPath, '.playcraft-temp');
-    await mkdir(parent, { recursive: true });
-    const directory = path.join(parent, `base-build-${randomUUID()}`);
-    // mkdir 继承工程的共享组和权限掩码；mkdtemp 固定使用 0700。
-    await mkdir(directory);
-    return directory;
-}
-export async function cleanupBuildTempDirectory(directory) {
-    if (!directory)
-        return;
-    if (process.env.PLAYCRAFT_KEEP_BUILD_TEMP === '1') {
-        console.log(`构建临时目录保留在: ${directory}`);
-        return;
-    }
-    try {
-        // 只删除本次创建的目录，保留并发构建与用户输入；父目录不做递归清理。
-        await rm(directory, { recursive: true, force: true });
-    }
-    catch (error) {
-        console.warn(`清理构建临时目录失败: ${error instanceof Error ? error.message : String(error)}`);
-    }
-}

package/dist/commands/platform-skills.generated.js

@@ -1,19 +0,0 @@
-// 此文件由 scripts/generate-platform-skills.mjs 生成，请勿手改。
-// 重新生成：pnpm --filter @playcraft/cli generate:platform-skills
-/** `@playcraft/skills/playcraft-skills/` 下的 Platform Skill 目录名。 */
-export const PLATFORM_SKILL_DIRS = [
-    'playcraft-3d-flip-sprite',
-    'playcraft-asset-management',
-    'playcraft-build',
-    'playcraft-code-editor',
-    'playcraft-create-remix',
-    'playcraft-deploy',
-    'playcraft-iteration-methodology',
-    'playcraft-platform-intro',
-    'playcraft-prefab',
-    'playcraft-project-management',
-    'playcraft-remix-workflow',
-    'playcraft-save',
-    'playcraft-template-upgrade-merge',
-    'sound-effects',
-];