@coze-arch/cli 0.0.38-alpha.da33e3 → 0.0.39-alpha.bdff32

package/lib/__templates__/phaser-static/src/utils/asset-loader.js

@@ -0,0 +1,267 @@
+import { AUDIOS, IMAGES, IMAGE_SEQUENCES, VIDEOS } from '../assets.js';
+
+const FRAME_KEY_MARKER = ':frame:';
+const MANIFEST_KEY_SUFFIX = ':manifest';
+
+const getFrameKey = (assetKey, frameIndex) =>
+  assetKey +
+  FRAME_KEY_MARKER +
+  String(frameIndex + 1).padStart(4, '0');
+
+const getManifestKey = assetKey => assetKey + MANIFEST_KEY_SUFFIX;
+
+const getFrameSource = (directory, frameIndex) =>
+  directory + '/frame_' + String(frameIndex + 1).padStart(4, '0') + '.png';
+
+export const resolveAssetUrl = source => new URL(source, document.baseURI).href;
+
+const isImageSequenceManifest = value => {
+  if (!value || typeof value !== 'object') {
+    return false;
+  }
+
+  return (
+    value.type === 'image_sequence' &&
+    typeof value.name === 'string' &&
+    typeof value.properties?.fps === 'number' &&
+    typeof value.properties.frame_count === 'number' &&
+    value.properties.frame_count > 0
+  );
+};
+
+const getImageSequenceManifest = (scene, assetKey) => {
+  const manifest = scene.cache.json.get(getManifestKey(assetKey));
+  if (!isImageSequenceManifest(manifest)) {
+    throw new Error('Invalid image sequence manifest: ' + assetKey);
+  }
+
+  return manifest;
+};
+
+const queueImageSequenceFrames = (scene, assetKey, directory, manifest) => {
+  Array.from(
+    { length: manifest.properties.frame_count },
+    (_value, frameIndex) => {
+      scene.load.image(
+        getFrameKey(assetKey, frameIndex),
+        resolveAssetUrl(getFrameSource(directory, frameIndex)),
+      );
+    },
+  );
+};
+
+const queueImages = (scene, images) => {
+  Object.entries(images).forEach(([assetKey, source]) => {
+    scene.load.image(assetKey, resolveAssetUrl(source));
+  });
+  return Object.keys(images).length;
+};
+
+const queueVideos = (scene, videos) => {
+  Object.entries(videos).forEach(([assetKey, source]) => {
+    scene.load.video(assetKey, resolveAssetUrl(source));
+  });
+  return Object.keys(videos).length;
+};
+
+const queueAudios = (scene, audios) => {
+  Object.entries(audios).forEach(([assetKey, source]) => {
+    scene.load.audio(assetKey, resolveAssetUrl(source));
+  });
+  return Object.keys(audios).length;
+};
+
+const queueImageSequences = (scene, imageSequences) =>
+  Object.entries(imageSequences).reduce(
+    (fileCount, [assetKey, directory]) => {
+      const manifestKey = getManifestKey(assetKey);
+      const cachedManifest = scene.cache.json.get(manifestKey);
+
+      if (isImageSequenceManifest(cachedManifest)) {
+        queueImageSequenceFrames(scene, assetKey, directory, cachedManifest);
+        return fileCount + cachedManifest.properties.frame_count;
+      }
+
+      scene.load.once(
+        'filecomplete-json-' + manifestKey,
+        (_key, _type, data) => {
+          if (!isImageSequenceManifest(data)) {
+            throw new Error('Invalid image sequence manifest: ' + assetKey);
+          }
+
+          queueImageSequenceFrames(scene, assetKey, directory, data);
+        },
+      );
+
+      scene.load.json(
+        manifestKey,
+        resolveAssetUrl(directory + '/manifest.json'),
+      );
+      return fileCount + 1;
+    },
+    0,
+  );
+
+export const loadAssets = (scene, collections) =>
+  queueImages(scene, collections.images ?? {}) +
+  queueImageSequences(scene, collections.imageSequences ?? {}) +
+  queueVideos(scene, collections.videos ?? {}) +
+  queueAudios(scene, collections.audios ?? {});
+
+export const getImageSequenceRuntimeKeys = assetKey => ({
+  texture: getFrameKey(assetKey, 0),
+  animation: assetKey + ':animation',
+});
+
+export const getAssetKeyFromFileKey = fileKey =>
+  fileKey.split(FRAME_KEY_MARKER)[0]?.replace(MANIFEST_KEY_SUFFIX, '') ??
+  fileKey;
+
+export const getAssetLabelFromFileKey = (fileKey, collections) => {
+  const assetKey = getAssetKeyFromFileKey(fileKey);
+
+  if (assetKey in (collections.images ?? {})) {
+    return '图片 ' + assetKey;
+  }
+  if (assetKey in (collections.imageSequences ?? {})) {
+    return '帧动画 ' + assetKey;
+  }
+  if (assetKey in (collections.videos ?? {})) {
+    return '视频 ' + assetKey;
+  }
+  if (assetKey in (collections.audios ?? {})) {
+    return '音频 ' + assetKey;
+  }
+
+  return assetKey;
+};
+
+export const registerImageSequenceAnimations = (scene, imageSequences) => {
+  Object.keys(imageSequences).forEach(assetKey => {
+    const manifest = getImageSequenceManifest(scene, assetKey);
+    const animationKey = getImageSequenceRuntimeKeys(assetKey).animation;
+    if (scene.anims.exists(animationKey)) {
+      return;
+    }
+
+    scene.anims.create({
+      key: animationKey,
+      frames: Array.from(
+        { length: manifest.properties.frame_count },
+        (_value, frameIndex) => ({ key: getFrameKey(assetKey, frameIndex) }),
+      ),
+      frameRate: manifest.properties.fps,
+      repeat: -1,
+    });
+  });
+};
+
+const findAsset = assetKey => {
+  const matches = [];
+
+  if (Object.hasOwn(IMAGES, assetKey)) {
+    matches.push({
+      collections: { images: { [assetKey]: IMAGES[assetKey] } },
+      loadedAsset: { kind: 'image', key: assetKey },
+    });
+  }
+  if (Object.hasOwn(IMAGE_SEQUENCES, assetKey)) {
+    matches.push({
+      collections: {
+        imageSequences: { [assetKey]: IMAGE_SEQUENCES[assetKey] },
+      },
+      loadedAsset: {
+        kind: 'image-sequence',
+        key: assetKey,
+        ...getImageSequenceRuntimeKeys(assetKey),
+      },
+    });
+  }
+  if (Object.hasOwn(VIDEOS, assetKey)) {
+    matches.push({
+      collections: { videos: { [assetKey]: VIDEOS[assetKey] } },
+      loadedAsset: { kind: 'video', key: assetKey },
+    });
+  }
+  if (Object.hasOwn(AUDIOS, assetKey)) {
+    matches.push({
+      collections: { audios: { [assetKey]: AUDIOS[assetKey] } },
+      loadedAsset: { kind: 'audio', key: assetKey },
+    });
+  }
+
+  if (matches.length === 0) {
+    throw new Error('Asset not found: ' + assetKey);
+  }
+  if (matches.length > 1) {
+    throw new Error('Duplicate asset key: ' + assetKey);
+  }
+
+  return matches[0];
+};
+
+const isAssetLoaded = (scene, loadedAsset) => {
+  switch (loadedAsset.kind) {
+    case 'image':
+      return scene.textures.exists(loadedAsset.key);
+    case 'image-sequence':
+      return scene.anims.exists(loadedAsset.animation);
+    case 'video':
+      return scene.cache.video.exists(loadedAsset.key);
+    case 'audio':
+      return scene.cache.audio.exists(loadedAsset.key);
+    default:
+      return false;
+  }
+};
+
+export const loadAsset = async (scene, assetKey) => {
+  const { collections, loadedAsset } = findAsset(assetKey);
+  if (isAssetLoaded(scene, loadedAsset)) {
+    return loadedAsset;
+  }
+
+  return new Promise((resolve, reject) => {
+    const cleanup = () => {
+      scene.load.off('complete', onComplete);
+      scene.load.off('loaderror', onLoadError);
+    };
+
+    const onComplete = () => {
+      cleanup();
+      try {
+        if (loadedAsset.kind === 'image-sequence') {
+          registerImageSequenceAnimations(
+            scene,
+            collections.imageSequences ?? {},
+          );
+        }
+        resolve(loadedAsset);
+      } catch (error) {
+        reject(error);
+      }
+    };
+
+    const onLoadError = file => {
+      if (getAssetKeyFromFileKey(file.key) !== assetKey) {
+        return;
+      }
+
+      cleanup();
+      reject(new Error('Failed to load asset: ' + assetKey));
+    };
+
+    scene.load.once('complete', onComplete);
+    scene.load.on('loaderror', onLoadError);
+
+    try {
+      loadAssets(scene, collections);
+      if (!scene.load.isLoading()) {
+        scene.load.start();
+      }
+    } catch (error) {
+      cleanup();
+      reject(error);
+    }
+  });
+};

package/lib/__templates__/phaser-static/src/utils/index.js

@@ -0,0 +1,2 @@
+export * from './asset-loader.js';
+export * from './mark-editable.js';

package/lib/__templates__/phaser-static/src/utils/mark-editable.js

@@ -0,0 +1,3 @@
+export const markEditable = (locator, gameObject, options) =>
+  window.PhaserBridge?.markEditable?.(locator, gameObject, options) ??
+  gameObject;

package/lib/__templates__/phaser-static/template.config.js

@@ -0,0 +1,35 @@
+
+
+
+
+
+
+
+
+export const paramsSchema = {
+  type: 'object',
+  properties: {
+    appName: {
+      type: 'string',
+      minLength: 1,
+      pattern: '^[a-z0-9-]+$',
+      description:
+        'Application name (lowercase, alphanumeric and hyphens only)',
+    },
+  },
+  required: [],
+  additionalProperties: false,
+};
+
+const config = {
+  description:
+    'Phaser Static（纯静态 2D 游戏）：coze-dev init ${COZE_WORKSPACE_PATH} --template phaser-static\n' +
+    '- 适用：浏览器原生 JavaScript ESM 的 Phaser 3 游戏。\n' +
+    '- Phaser 与 Phaser Bridge 从 CDN 加载；无需 npm、Vite 或 TypeScript。',
+  paramsSchema,
+  defaultParams: {
+    appName: 'phaser-static-game',
+  },
+};
+
+export default config;

package/lib/__templates__/pi-agent/package.json

@@ -22,7 +22,7 @@
     "@mariozechner/pi-ai": "^0.63.2",
     "@mariozechner/pi-coding-agent": "^0.63.2",
     "@sinclair/typebox": "^0.34.48",
-    "coze-coding-dev-sdk": "^0.7.17",
+    "coze-coding-dev-sdk": "^0.7.25",
     "@radix-ui/react-select": "^2.2.6",
     "@radix-ui/react-slot": "^1.2.4",
     "@streamdown/code": "^1.1.1",

package/lib/__templates__/pi-agent/pnpm-lock.yaml

@@ -36,8 +36,8 @@ importers:
         specifier: ^2.1.1
         version: 2.1.1
       coze-coding-dev-sdk:
-        specifier: ^0.7.17
-        version: 0.7.20(openai@6.34.0(ws@8.20.0)(zod@4.3.6))(ws@8.20.0)
+        specifier: ^0.7.25
+        version: 0.7.25(openai@6.34.0(ws@8.20.0)(zod@4.3.6))(ws@8.20.0)
       express:
         specifier: ^4.21.2
         version: 4.22.1
@@ -2085,8 +2085,8 @@ packages:
   cose-base@2.2.0:
     resolution: {integrity: sha512-AzlgcsCbUMymkADOJtQm3wO9S3ltPfYOFD5033keQn9NJzIbtnZj+UdBJe7DYml/8TdbtHJW3j58SOnKhWY/5g==}
 
-  coze-coding-dev-sdk@0.7.20:
-    resolution: {integrity: sha512-f3UeZcYB/udyWrlFrsOViM47PCW+Nk0I4FcXEGzcjEfaQsa1CPBpf/y5UbBM6GIZ1v+lnuh/MiBlAaALFeMTqw==}
+  coze-coding-dev-sdk@0.7.25:
+    resolution: {integrity: sha512-5683ngikMdsRW0slGTE2OAZ1Fyj0lhkC4fGNOwsqKc35e68/gtg9KmmtK9CK9SZ+5/oIn/4wLoHXFB0gHJtO2A==}
     engines: {node: '>=18.0.0'}
     hasBin: true
 
@@ -6120,7 +6120,7 @@ snapshots:
     dependencies:
       layout-base: 2.0.1
 
-  coze-coding-dev-sdk@0.7.20(openai@6.34.0(ws@8.20.0)(zod@4.3.6))(ws@8.20.0):
+  coze-coding-dev-sdk@0.7.25(openai@6.34.0(ws@8.20.0)(zod@4.3.6))(ws@8.20.0):
     dependencies:
       '@langchain/core': 1.1.40(openai@6.34.0(ws@8.20.0)(zod@4.3.6))(ws@8.20.0)
       '@langchain/openai': 1.4.3(@langchain/core@1.1.40(openai@6.34.0(ws@8.20.0)(zod@4.3.6))(ws@8.20.0))(ws@8.20.0)

package/lib/__templates__/taro/.coze

@@ -5,12 +5,18 @@ project_type = "miniprogram"
 
 [dev]
 build = ["bash", ".cozeproj/scripts/dev_build.sh"]
+build_win = ["powershell.exe", "-NoProfile", "-ExecutionPolicy", "Bypass", "-File", ".cozeproj/scripts/dev_build.ps1"]
 run = ["bash", ".cozeproj/scripts/dev_run.sh"]
+run_win = ["powershell.exe", "-NoProfile", "-ExecutionPolicy", "Bypass", "-File", ".cozeproj/scripts/dev_run.ps1"]
 deps = ["git"] # -> apt install git
 pack = ["bash", ".cozeproj/scripts/pack.sh"]
+pack_win = ["powershell.exe", "-NoProfile", "-ExecutionPolicy", "Bypass", "-File", ".cozeproj/scripts/pack.ps1"]
 validate = ["bash", ".cozeproj/scripts/validate.sh"]
+validate_win = ["powershell.exe", "-NoProfile", "-ExecutionPolicy", "Bypass", "-File", ".cozeproj/scripts/validate.ps1"]
 
 [deploy]
 build = ["bash", ".cozeproj/scripts/deploy_build.sh"]
+build_win = ["powershell.exe", "-NoProfile", "-ExecutionPolicy", "Bypass", "-File", ".cozeproj/scripts/deploy_build.ps1"]
 run = ["bash", ".cozeproj/scripts/deploy_run.sh"]
+run_win = ["powershell.exe", "-NoProfile", "-ExecutionPolicy", "Bypass", "-File", ".cozeproj/scripts/deploy_run.ps1"]
 deps = ["git"] # -> apt install git

package/lib/__templates__/taro/.cozeproj/scripts/deploy_build.ps1

@@ -0,0 +1,10 @@
+$ErrorActionPreference = "Stop"
+
+$workspace = if ($env:COZE_WORKSPACE_PATH) { $env:COZE_WORKSPACE_PATH } else { (Get-Location).Path }
+Set-Location $workspace
+
+& pnpm install
+if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }
+
+& pnpm build
+exit $LASTEXITCODE

package/lib/__templates__/taro/.cozeproj/scripts/deploy_run.ps1

@@ -0,0 +1,8 @@
+$ErrorActionPreference = "Stop"
+
+$workspace = if ($env:COZE_WORKSPACE_PATH) { $env:COZE_WORKSPACE_PATH } else { (Get-Location).Path }
+$port = if ($env:DEPLOY_RUN_PORT) { $env:DEPLOY_RUN_PORT } else { <%= serverPort %> }
+
+Set-Location (Join-Path $workspace "server/dist")
+& node ./main.js -p "$port"
+exit $LASTEXITCODE

package/lib/__templates__/taro/.cozeproj/scripts/deploy_run.sh

@@ -4,7 +4,7 @@ set -Eeuo pipefail
 start_service() {
     cd "${COZE_WORKSPACE_PATH}/server/dist"
 
-    local port="${DEPLOY_RUN_PORT:-3000}"
+    local port="${DEPLOY_RUN_PORT:-<%= serverPort %>}"
     echo "Starting Static File Server on port ${port} for deploy..."
 
     node ./main.js -p "${port}"

package/lib/__templates__/taro/.cozeproj/scripts/dev_build.ps1

@@ -0,0 +1,3 @@
+$ErrorActionPreference = "Stop"
+
+Write-Host "Taro development build does not require a separate step."

package/lib/__templates__/taro/.cozeproj/scripts/dev_run.ps1

@@ -0,0 +1,62 @@
+$ErrorActionPreference = "Stop"
+
+function Stop-ProcessTree([int] $processId) {
+  if ($processId -gt 0 -and (Get-Process -Id $processId -ErrorAction SilentlyContinue)) {
+    & taskkill.exe /PID $processId /T /F *> $null
+  }
+}
+
+function Stop-ListeningProcess([int] $port) {
+  Get-NetTCPConnection -LocalPort $port -State Listen -ErrorAction SilentlyContinue |
+    Select-Object -ExpandProperty OwningProcess -Unique |
+    ForEach-Object { Stop-ProcessTree $_ }
+}
+
+function Start-DevProcess([string] $workingDirectory, [string] $logFile, [hashtable] $environment) {
+  $previousEnvironment = @{}
+  foreach ($key in $environment.Keys) {
+    $previousEnvironment[$key] = [Environment]::GetEnvironmentVariable($key, 'Process')
+    [Environment]::SetEnvironmentVariable($key, $environment[$key], 'Process')
+  }
+
+  try {
+    return Start-Process -FilePath "pnpm.cmd" -ArgumentList @("dev") -WorkingDirectory $workingDirectory -RedirectStandardOutput $logFile -RedirectStandardError "$logFile.error" -PassThru
+  } finally {
+    foreach ($key in $environment.Keys) {
+      [Environment]::SetEnvironmentVariable($key, $previousEnvironment[$key], 'Process')
+    }
+  }
+}
+
+$workspace = if ($env:COZE_WORKSPACE_PATH) { $env:COZE_WORKSPACE_PATH } else { (Get-Location).Path }
+$port = if ($env:DEPLOY_RUN_PORT) { [int] $env:DEPLOY_RUN_PORT } elseif ($env:PORT) { [int] $env:PORT } else { <%= port %> }
+$serverPort = if ($env:SERVER_PORT) { [int] $env:SERVER_PORT } else { <%= serverPort %> }
+$logDirectory = if ($env:COZE_LOG_DIR) { $env:COZE_LOG_DIR } else { Join-Path $workspace "logs" }
+$logFile = Join-Path $logDirectory "dev.log"
+$pidFile = Join-Path $logDirectory "dev.pid"
+New-Item -ItemType Directory -Force -Path $logDirectory | Out-Null
+
+if (Test-Path $pidFile) {
+  Stop-ProcessTree ([int] (Get-Content $pidFile -Raw))
+  Remove-Item $pidFile -Force
+}
+Stop-ListeningProcess $port
+Stop-ListeningProcess $serverPort
+
+$environment = @{ PORT = "$port"; SERVER_PORT = "$serverPort" }
+if ($env:COZE_PROJECT_DOMAIN_DEFAULT) {
+  $environment.PROJECT_DOMAIN = $env:COZE_PROJECT_DOMAIN_DEFAULT
+}
+
+$process = Start-DevProcess $workspace $logFile $environment
+$process.Id | Set-Content $pidFile
+Start-Sleep -Seconds 1
+if ($process.HasExited) {
+  Get-Content "$logFile.error" -Tail 20 -ErrorAction SilentlyContinue
+  Remove-Item $pidFile -Force -ErrorAction SilentlyContinue
+  exit 1
+}
+
+Write-Host "Taro H5 and NestJS services started. PID: $($process.Id)"
+Write-Host "Web port: $port; server port: $serverPort"
+Write-Host "Log file: $logFile"