@playcraft/cli 0.0.55 → 0.0.57

package/README.md

@@ -91,6 +91,24 @@ playcraft remix start \
   --open
 ```
 
+### 6. 将 Remix 源码 clone 到本地
+
+完整步骤（登录 → clone → commit → push）见：
+
+- [Remix 本地 Clone / Commit / Push](../../docs/cli/remix-local-clone-push.md)
+
+```bash
+playcraft login
+# 推荐：粘贴 Remix 详情页 / Editor / 工蜂分支页 URL
+playcraft remix clone '<remix-detail-or-editor-or-gongfeng-url>' --install
+
+cd <cloned-dir>
+npm run dev          # external 引擎
+git add -A && git commit -m "…"
+playcraft remix pull # 需要同步远端时
+playcraft remix push # 不要裸 git push/pull（尤其 Windows）
+```
+
 完整的 Remix 子命令、参数、图片传输、自动化输出及故障处理说明见：
 
 - [PlayCraft CLI Remix 完整命令参考](./REMIX.md)

package/REMIX.md

@@ -11,6 +11,7 @@ CLI (Command-Line Interface, 命令行界面) 的 Remix 工作流用于：
 - 向当前沙箱的 Agent 会话发送文本需求和参考图片。
 - 在交互式终端或自动化脚本中完成端到端创建流程。
 - 在本地项目中应用 Phaser 或 Three.js 引擎脚手架。
+- **经 PlayCraft Git 代理将 Remix 源码 clone 到本地、本地开发后 push 回 Remix 分支。**
 
 ## 1. 命令总览
 
@@ -22,18 +23,25 @@ playcraft remix create
 playcraft remix start
 playcraft remix prompt
 playcraft remix run
-```
-
-| 想完成的操作                 | 推荐命令                                                              |
-| ---------------------------- | --------------------------------------------------------------------- |
-| 查看当前账号所属团队         | `playcraft remix teams`                                               |
-| 查看团队内可作为模板的项目   | `playcraft remix templates --team-id <team-id>`                       |
-| 只创建 Remix，不启动沙箱     | `playcraft remix create` 或交互式 `playcraft remix run` 后留空 Prompt |
-| 启动已有 Remix 并打开 Editor | `playcraft remix start --project-id <id> --branch <branch> --open`    |
-| 向已有 Remix 发送需求        | `playcraft remix prompt`                                              |
-| 创建 Remix 并立即运行 Agent  | `playcraft remix run`                                                 |
-| 查询已有 Remix 列表          | `playcraft tools list-remixes`；当前没有 `playcraft remix list`       |
-| 给本地项目应用引擎模板       | `playcraft remix init-template`                                       |
+playcraft remix clone
+playcraft remix pull
+playcraft remix push
+playcraft git-credential
+```
+
+| 想完成的操作                 | 推荐命令                                                                        |
+| ---------------------------- | ------------------------------------------------------------------------------- |
+| 查看当前账号所属团队         | `playcraft remix teams`                                                         |
+| 查看团队内可作为模板的项目   | `playcraft remix templates --team-id <team-id>`                                 |
+| 只创建 Remix，不启动沙箱     | `playcraft remix create` 或交互式 `playcraft remix run` 后留空 Prompt           |
+| 启动已有 Remix 并打开 Editor | `playcraft remix start --project-id <id> --branch <branch> --open`              |
+| 向已有 Remix 发送需求        | `playcraft remix prompt`                                                        |
+| 创建 Remix 并立即运行 Agent  | `playcraft remix run`                                                           |
+| **Clone Remix 源码到本地**   | `playcraft remix clone <详情页/Editor/工蜂 URL>` 或 `--project-id` + `--branch` |
+| **Pull 远端 Remix**          | `playcraft remix pull`（推荐；Windows 勿直接 `git pull`）                       |
+| **Push 回 Remix 分支**       | `playcraft remix push`（推荐；Windows 勿直接 `git push`）                       |
+| 查询已有 Remix 列表          | `playcraft tools list-remixes`；当前没有 `playcraft remix list`                 |
+| 给本地项目应用引擎模板       | `playcraft remix init-template`                                                 |
 
 查看当前版本的帮助：
 
@@ -717,27 +725,115 @@ playcraft remix start --project-id <project-id> --branch <remix-branch> --open
 
 可以。`remix prompt` 会自动启动或复用沙箱。
 
-### 14.3 为什么 `prompt` 必须同时提供项目 ID 和分支？
+## 14. 本地 Clone / Push（Git 代理）
+
+登录后可将 Remix 源码经 **PlayCraft Backend Git Smart HTTP 代理**克隆到本机，无需工蜂凭据。平台服务账号 Token 不会下发到 CLI。
+
+> **上手文档（推荐先读）**：[Remix 本地 Clone / Commit / Push](../../docs/cli/remix-local-clone-push.md)
+
+### 14.1 Clone
+
+```bash
+playcraft login --url https://test-playcraft.aix.intlgame.com
+
+# 建议本地开发时 API 直连 backend（避免经前端 Next rewrite）
+export PLAYCRAFT_API_URL=http://localhost:3001
+
+# 推荐：直接粘贴 Remix 详情页或 Editor 地址
+playcraft remix clone \
+  'https://playcraft.aix.intlgame.com/projects/<uuid>/remixes/remix%2Fyour-branch' \
+  --install
+
+playcraft remix clone \
+  'https://playcraft.aix.intlgame.com/editor/remix/<uuid>?branch=remix%2Fyour-branch' \
+  --install
+
+# 也可粘贴详情页上的工蜂分支页（git.woa.com / git.tencent.com 互认）；仍走 PlayCraft 代理
+playcraft remix clone \
+  'https://git.woa.com/<group>/<repo>/tree/remix%2Fyour-branch' \
+  --install
+
+playcraft remix clone \
+  'https://git.tencent.com/<group>/<repo>/tree/remix%2Fyour-branch' \
+  --install
+
+# 兼容旧写法
+playcraft remix clone \
+  --project-id <project-id> \
+  --branch remix/your-branch \
+  --install
+```
+
+行为说明：
+
+- Clone URL 形如：`<api>/api/git/projects/<projectId>/branches/<urlencode(branch)>.git`
+- 固定浅克隆：`--single-branch --depth 1`
+- 鉴权使用已登录 PAT（`Authorization: Bearer`），remote URL **不含** Token
+- 仅 advertise / 允许操作 **URL 中指定的那条 Remix 分支**（不能拉同项目其它私有分支）
+- 克隆后写入 `.playcraft.json`（projectId / branch / cloneUrl），并配置 `credential.helper=!playcraft git-credential`
+- 工蜂地址会先调用 `GET /api/git/resolve-repo` 映射到 PlayCraft 项目，再经代理 clone（不会直连工蜂）
+
+### 14.2 本地运行
+
+- **external（Phaser / Three.js）**：`npm install && npm run dev`（可用 `--install` / `--dev`）
+- **PlayCanvas**：使用 `playcraft start --project <id>`，不是 Vite
+
+### 14.3 Pull / Push
+
+在克隆目录内：
+
+```bash
+# 同步远端（例如沙箱 Save 之后）
+playcraft remix pull
+
+# 本地改完并 commit 后写回
+git add -A
+git commit -m "local changes"
+playcraft remix push
+```
+
+**不要**依赖裸 `git pull` / `git push`（尤其 Windows + Git Credential Manager 会弹窗）。二者与 clone 一样注入 `Authorization: Bearer`，并禁用本命令的 credential helper。
+
+服务端强制（push）：
+
+- 只能 push 到 URL 对应的 Remix 分支
+- 禁止 push `main` / `master` / 项目默认分支
+- 禁止新建 / 删除分支、推 tag
+- Gallery 只读用户可以 clone，**不能** push（需 editor/owner 或该分支创建者）
+
+### 14.4 与云端沙箱同时写
+
+同一 Remix 分支若已在沙箱打开并 Save，本机 `playcraft remix push` 与沙箱 push 会互相覆盖。请避免两边同时写同一分支；需要合并远端时先 `playcraft remix pull`。push 成功后 backend 会 `BareRepoCache.invalidate`。
+
+### 14.5 `playcraft git-credential`
+
+clone 后仍可能写入仓库 `credential.helper`（兼容）。**日常请用 `playcraft remix pull` / `push`**，不要手动跑 `git-credential`。
+
+---
+
+## 15. 常见问题
+
+### 15.1 为什么 `prompt` 必须同时提供项目 ID 和分支？
 
 项目中可能存在多个 Remix 分支。显式指定二者可以避免需求落到 `main` 或其他 Remix。
 
-### 14.4 `--open` 与 URL 输出有什么区别？
+### 15.2 `--open` 与 URL 输出有什么区别？
 
 `--open` 会调用系统浏览器。没有 `--open` 时命令仍会返回或打印 Editor URL，适合远程终端和自动化环境。
 
-### 14.5 图片上传失败后是否仍会发送纯文本？
+### 15.3 图片上传失败后是否仍会发送纯文本？
 
 不会。附件校验或上传失败时，整个 Prompt 请求失败，避免 Agent 在缺少参考图的情况下继续执行。
 
-### 14.6 `--no-wait` 是否会取消 Agent？
+### 15.4 `--no-wait` 是否会取消 Agent？
 
 不会。它只让 CLI 在 Agent 接收请求后立即返回，远端任务继续运行。
 
-### 14.7 超时后 Agent 是否会停止？
+### 15.5 超时后 Agent 是否会停止？
 
 不保证。`--timeout` 限制 CLI 等待时间；当前命令不会因为本地等待超时而自动中止远端 Agent。
 
-### 14.8 如何避免测试环境和生产环境 Token 混用？
+### 15.6 如何避免测试环境和生产环境 Token 混用？
 
 登录时显式传入环境地址：
 
@@ -747,7 +843,7 @@ playcraft login --url https://test-playcraft.aix.intlgame.com
 
 CLI 只会在保存 Token 的环境与目标环境一致时复用它；浏览器重新授权会创建新 Token 并替换旧值。
 
-## 15. 版本与帮助
+## 16. 版本与帮助
 
 本文档描述当前源码中的命令。安装版本可能落后于仓库源码，排查参数差异时先检查：
 

package/dist/atom-tree/fusion-hints.js

@@ -21,9 +21,14 @@ const EMBEDDED_FUSION_EDGES = [
         label: 'C-Sequential, high risk → prefer pseudo-fusion',
     },
     {
-        from: 'match3_core.aigameplay',
-        to: 'arrow_escape_core.aigameplay',
-        label: 'C-Sequential, medium-high risk → prefer pseudo-fusion',
+        from: 'path_elimination_rules.aigameplay',
+        to: 'pick_and_match_rules.aigameplay',
+        label: 'B2-Active, low risk → prefer arrow_pick_match composite',
+    },
+    {
+        from: 'path_elimination_rules.aigameplay',
+        to: 'arrow_pick_match_rules.aigameplay',
+        label: 'B2-Active composite — use instead of stitching parents',
     },
 ];
 function fusionEdges() {

package/dist/atom-tree/fusion-intent.js

@@ -0,0 +1,62 @@
+/**
+ * Fusion intent detection and composite-skill helpers for skills match routing.
+ */
+const FUSION_KEYWORDS = [
+    '融合',
+    'fusion',
+    'hybrid',
+    'combine',
+    '组合',
+    'mix',
+    'mixed',
+    'plus',
+    '+',
+    '和',
+    '与',
+    '加',
+];
+const ELIMINATION_KEYWORDS = ['消除', 'elimination', 'eliminate', 'match-3', 'match3', '三消', 'match'];
+const ARROW_PATH_KEYWORDS = ['箭头', 'arrow', 'path', '路径', 'slide-out', 'slide'];
+/** True when user intent suggests combining multiple gameplay mechanics. */
+export function detectFusionIntent(intentTags, rawIntent = '') {
+    const blob = `${rawIntent} ${intentTags.join(' ')}`.toLowerCase();
+    if (FUSION_KEYWORDS.some((k) => blob.includes(k.toLowerCase())))
+        return true;
+    const hasElim = ELIMINATION_KEYWORDS.some((k) => blob.includes(k.toLowerCase()));
+    const hasArrow = ARROW_PATH_KEYWORDS.some((k) => blob.includes(k.toLowerCase()));
+    return hasElim && hasArrow;
+}
+/** Composite fusion skill: manifest declares ≥2 parent gameplay types. */
+export function isFusionCompositeManifest(manifest) {
+    const parents = manifest.pgs?.parentTypes;
+    if (Array.isArray(parents) && parents.length >= 2)
+        return true;
+    if (manifest.pgs?.fusionDescription)
+        return true;
+    const id = manifest.atomId ?? '';
+    if (id.includes('_pick_') || id.includes('_match_')) {
+        return id.includes('arrow') || id.includes('path');
+    }
+    return false;
+}
+export function getManifestParentTypes(manifest) {
+    return manifest.pgs?.parentTypes ?? [];
+}
+/** Bonus score when fusion intent matches a composite skill. */
+export function fusionCompositeScoreBoost(manifest, intentTags, rawIntent = '') {
+    if (!detectFusionIntent(intentTags, rawIntent))
+        return 0;
+    if (!isFusionCompositeManifest(manifest))
+        return 0;
+    return 25;
+}
+/** Penalize single-mechanic gameplay seeds when fusion intent is explicit. */
+export function fusionSingleMechanicPenalty(manifest, intentTags, rawIntent = '') {
+    if (!detectFusionIntent(intentTags, rawIntent))
+        return 0;
+    if (manifest.category !== 'gameplay' && manifest.bundleType !== 'aigameplay')
+        return 0;
+    if (isFusionCompositeManifest(manifest))
+        return 0;
+    return -8;
+}

package/dist/atom-tree/selection.js

@@ -327,7 +327,9 @@ export function collectPinnedDependencies(atomId, manifestIndex, engine, visited
         if (!imp.pinAtomId || visited.has(imp.pinAtomId))
             continue;
         deps.push(imp.pinAtomId);
-        deps.push(...collectPinnedDependencies(imp.pinAtomId, manifestIndex, engine, visited, depth + 1));
+        if (imp.edgeKind === 'requires') {
+            deps.push(...collectPinnedDependencies(imp.pinAtomId, manifestIndex, engine, visited, depth + 1));
+        }
     }
     return deps;
 }