cocos2d-cli 1.5.1 → 1.6.1

package/bin/cocos2d-cli.js

@@ -11,13 +11,15 @@ const commands = {
     tree: '../src/commands/tree',
     get: '../src/commands/get',
     set: '../src/commands/set',
+    'set-component': '../src/commands/set-component',
     add: '../src/commands/add',
     'add-component': '../src/commands/add-component',
     'remove-component': '../src/commands/remove-component',
     'remove': '../src/commands/remove',
     build: '../src/commands/build',
     'create-prefab': '../src/commands/prefab-create',
-    'create-scene': '../src/commands/create-scene'
+    'create-scene': '../src/commands/create-scene',
+    'screenshot': '../src/commands/screenshot'
 };
 
 // 帮助信息
@@ -29,42 +31,59 @@ Cocos Creator CLI - 场景/预制体操作工具集
   cocos2d-cli <command> [options]
 
 命令:
-  tree <场景.fire | 预制体.prefab>           查看节点树
-  get <场景.fire | 预制体.prefab> <节点路径>  获取节点属性
-  set <场景.fire | 预制体.prefab> <节点路径> [选项]  修改节点属性
-  add <场景.fire | 预制体.prefab> <父节点路径> <名称>  添加节点
-  add-component <文件> <节点路径> <类型>     给节点添加组件
-  remove-component <文件> <节点路径> <类型>  删除节点组件
-  remove <文件> <节点路径>                   删除节点
-  build <项目目录>                           构建组件映射
-  create-prefab [JSON文件] <输出.prefab>     创建预制体（不传JSON则创建默认）
-  create-scene [JSON文件] <输出.fire>        创建场景（不传JSON则创建默认）
+  tree <场景.fire | 预制体.prefab>              查看节点树
+  get <场景.fire | 预制体.prefab> <节点路径> [属性名|组件类型]  获取节点或组件属性
+  set <场景.fire | 预制体.prefab> <节点路径> <属性名> <值>     修改节点属性
+  set-component <文件> <节点路径> <组件类型> <属性名> <值>     修改组件属性
+  add <场景.fire | 预制体.prefab> <父节点路径> <名称>          添加节点
+  add-component <文件> <节点路径> <类型>        给节点添加组件
+  remove-component <文件> <节点路径> <类型>     删除节点组件
+  remove <文件> <节点路径>                      删除节点
+  build <项目目录>                              构建组件映射
+  create-prefab [JSON文件路径] <输出.prefab>    创建预制体（不传JSON则创建默认）
+  create-scene [JSON文件路径] <输出.fire>       创建场景（不传JSON则创建默认）
+  screenshot <json文件> [选项]                  渲染JSON并截图
 
 节点路径格式:
   Canvas                    - 根节点下的 Canvas
   Canvas/MidNode            - Canvas 下的 MidNode
   Canvas/GameScene/NodeA    - 多层嵌套路径
 
-选项:
-  --name=<名称>          修改节点名称
-  --active=true/false    修改激活状态
-  --x=<数值>             修改 X 坐标
-  --y=<数值>             修改 Y 坐标
-  --width=<数值>         修改宽度
-  --height=<数值>        修改高度
-  --anchorX=<0-1>        修改锚点 X
-  --anchorY=<0-1>        修改锚点 Y
-  --opacity=<0-255>      修改透明度
-  --color=<#RRGGBB>      修改颜色
-  --rotation=<角度>      修改旋转角度
-  --scaleX=<数值>        修改 X 缩放
-  --scaleY=<数值>        修改 Y 缩放
-  --string=<文字>        修改 Label 文字内容
-  --fontSize=<数值>      修改 Label 字体大小
-  --lineHeight=<数值>    修改 Label 行高
+set 支持的节点属性:
+  name          节点名称
+  active        激活状态 (true/false)
+  x             X 坐标
+  y             Y 坐标
+  width         宽度
+  height        高度
+  anchorX       锚点 X (0-1)
+  anchorY       锚点 Y (0-1)
+  opacity       透明度 (0-255)
+  scaleX        X 缩放
+  scaleY        Y 缩放
+  rotation      旋转角度
+
+set-component 示例:
+  cocos2d-cli set-component xxx.fire Canvas/Label Label string "Hello"
+  cocos2d-cli set-component xxx.fire Canvas/Label Label fontSize 32
+  cocos2d-cli set-component xxx.fire Canvas/Sprite Sprite sizeMode 0
+
+add 支持的选项:
+  --x=<数值>             设置 X 坐标
+  --y=<数值>             设置 Y 坐标
+  --width=<数值>         设置宽度
+  --height=<数值>        设置高度
+  --scaleX=<数值>        设置 X 缩放
+  --scaleY=<数值>        设置 Y 缩放
+  --rotation=<角度>      设置旋转角度
+  --active=true/false    设置激活状态
   --type=sprite/label/button  添加节点时指定组件类型
+  --string=<文字>        Label 文字内容 (配合 --type=label)
+  --fontSize=<数值>      Label 字体大小 (配合 --type=label)
 
 JSON 格式 (create-prefab / create-scene):
+  注意: 参数必须是 JSON 文件路径，不支持直接传递 JSON 字符串
+
   {
     "name": "节点名称",
     "width": 400,
@@ -98,14 +117,14 @@ JSON 格式 (create-prefab / create-scene):
     camera   - 相机
     particle - 粒子效果
 
-  注意:
-    - color 写在节点或 label 组件均可
-    - button 需要配合 sprite 才能看见按钮外观
-
 示例:
   cocos2d-cli tree assets/main.fire
   cocos2d-cli get assets/main.fire Canvas/MidNode
-  cocos2d-cli set assets/main.fire Canvas/MidNode --x=100 --y=200 --color=#ff0000
+  cocos2d-cli get assets/main.fire Canvas/MidNode x
+  cocos2d-cli get assets/main.fire Canvas/MidNode Label
+  cocos2d-cli set assets/main.fire Canvas/MidNode x 100
+  cocos2d-cli set assets/main.fire Canvas/MidNode width 200
+  cocos2d-cli set-component assets/main.fire Canvas/Label Label string "Hello World"
   cocos2d-cli add assets/main.fire Canvas NewSprite --type=sprite --x=100
   cocos2d-cli add-component assets/main.fire Canvas/MidNode label
   cocos2d-cli remove-component assets/main.fire Canvas/MidNode label
@@ -119,6 +138,10 @@ JSON 格式 (create-prefab / create-scene):
 
   # 创建默认预制体（不传JSON）
   cocos2d-cli create-prefab assets/NewNode.prefab
+
+  # 截图
+  cocos2d-cli screenshot data.json
+  cocos2d-cli screenshot data.json -o ./screenshots -w 1080 -h 1920
 `);
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cocos2d-cli", 
-  "version": "1.5.1",
+  "version": "1.6.1",
   "description": "Command-line tools for AI to read and manipulate Cocos Creator 2.4.x project scenes",
   "main": "bin/cocos2d-cli.js",
   "bin": {
@@ -19,11 +19,15 @@
     "cocos-creator",
     "cli",
     "scene",
-    "fire"
+    "fire",
+    "screenshot"
   ],
   "author": "",
   "license": "MIT",
   "engines": {
     "node": ">=14.0.0"
+  },
+  "dependencies": {
+    "playwright": "^1.58.2"
   }
 }

package/src/commands/create-scene.js

@@ -82,8 +82,8 @@ function createDefaultScene(asset, resolution) {
     
     // Canvas 组件
     const canvasComp = new CCCanvas();
-    canvasComp.setDesignResolution(width, height);
-    canvasComp.node = canvas;
+    canvasComp._designResolution.set(width, height);
+    canvas.addChild(canvasComp);
     
     // Widget 组件
     const widget = new CCWidget();
@@ -95,11 +95,6 @@ function createDefaultScene(asset, resolution) {
     
     // 创建 Main Camera 节点
     const camera = new CCNode('Main Camera');
-    camera._contentSize.width = 0;
-    camera._contentSize.height = 0;
-    camera._anchorPoint.x = 0.5;
-    camera._anchorPoint.y = 0.5;
-    camera._is3DNode = false;
     camera._id = generateCompressedUUID();
     
     // Camera 组件

package/src/commands/get.js

@@ -9,10 +9,10 @@ const { CCSceneAsset, CCPrefab } = require('../lib/cc');
 /**
  * 查找节点
  */
-function findNode(root, path) {
-    if (!path) return root;
+function findNode(root, nodePath) {
+    if (!nodePath) return root;
     
-    const parts = path.split('/').filter(p => p);
+    const parts = nodePath.split('/').filter(p => p);
     if (parts.length === 0) return root;
     
     let current = root;
@@ -43,37 +43,15 @@ function findComponent(node, compType) {
     return node._components.find(c => c.__type__ === typeName);
 }
 
-/**
- * 获取节点属性值
- */
-function getNodeProp(node, prop) {
-    switch (prop.toLowerCase()) {
-        case 'name': return node._name;
-        case 'active': return node._active;
-        case 'x': return node._trs.array[0];
-        case 'y': return node._trs.array[1];
-        case 'width': return node._contentSize.width;
-        case 'height': return node._contentSize.height;
-        case 'scalex': return node._trs.array[7];
-        case 'scaley': return node._trs.array[8];
-        case 'rotation': return node._eulerAngles.z;
-        case 'anchorx': return node._anchorPoint.x;
-        case 'anchory': return node._anchorPoint.y;
-        case 'opacity': return node._opacity;
-        case 'color': return node._color;
-        default: return undefined;
-    }
-}
-
 function run(args) {
-    if (args.length < 3) {
-        console.log(JSON.stringify({ error: '用法: cocos2d-cli get <场景.fire|预制体.prefab> <节点路径> <属性名|组件.属性>' }));
+    if (args.length < 2) {
+        console.log(JSON.stringify({ error: '用法: cocos2d-cli get <场景.fire|预制体.prefab> <节点路径> [属性名|组件类型]' }));
         return;
     }
     
     const filePath = args[0];
     const nodePath = args[1];
-    const propPath = args[2];
+    const propOrComp = args[2];
     
     const ext = path.extname(filePath).toLowerCase();
     
@@ -99,33 +77,27 @@ function run(args) {
             return;
         }
         
-        // 检查是否是组件属性（格式: 组件.属性）
-        const parts = propPath.split('.');
+        // 没有指定属性或组件，返回节点所有属性
+        if (!propOrComp) {
+            const props = node.getProp ? node.getProp() : {};
+            console.log(JSON.stringify(props, null, 2));
+            return;
+        }
+        
+        // 检查是否是组件类型
+        const comp = findComponent(node, propOrComp);
+        if (comp) {
+            const props = comp.getProp ? comp.getProp() : {};
+            console.log(JSON.stringify(props, null, 2));
+            return;
+        }
         
-        if (parts.length === 2) {
-            // 组件属性
-            const comp = findComponent(node, parts[0]);
-            if (!comp) {
-                console.log(JSON.stringify({ error: `组件不存在: ${parts[0]}` }));
-                return;
-            }
-            
-            const value = comp[parts[1]];
-            if (value === undefined) {
-                console.log(JSON.stringify({ error: `属性不存在: ${parts[1]}` }));
-                return;
-            }
-            
-            console.log(JSON.stringify({ value }));
+        // 返回节点的单个属性
+        const nodeProps = node.getProp ? node.getProp() : {};
+        if (nodeProps[propOrComp] !== undefined) {
+            console.log(JSON.stringify({ [propOrComp]: nodeProps[propOrComp] }, null, 2));
         } else {
-            // 节点属性
-            const value = getNodeProp(node, propPath);
-            if (value === undefined) {
-                console.log(JSON.stringify({ error: `属性不存在: ${propPath}` }));
-                return;
-            }
-            
-            console.log(JSON.stringify({ value }));
+            console.log(JSON.stringify({ error: `属性不存在: ${propOrComp}` }));
         }
         
     } catch (err) {

package/src/commands/screenshot.js

@@ -0,0 +1,95 @@
+/**
+ * screenshot 命令
+ * 渲染 JSON 数据并截图
+ */
+
+const path = require('path');
+const { takeScreenshot } = require('../lib/screenshot-core');
+
+function showHelp() {
+    console.log(`
+用法:
+  cocos2d-cli screenshot <json文件> [选项]
+
+选项:
+  -o, --output <目录>     输出目录，默认当前目录
+  -w, --width <数值>      视口宽度，默认 750
+  -h, --height <数值>     视口高度，默认 1334
+  --full-page             全页截图（默认）
+  --no-full-page          仅视口截图
+  --timeout <毫秒>        页面加载超时，默认 30000
+  --wait <毫秒>           截图前等待时间，默认 1000
+
+示例:
+  cocos2d-cli screenshot data.json
+  cocos2d-cli screenshot data.json -o ./screenshots
+  cocos2d-cli screenshot data.json -w 1080 -h 1920
+  cocos2d-cli screenshot data.json --no-full-page
+`);
+}
+
+function parseArgs(args) {
+    const options = {
+        jsonPath: null,
+        outputDir: '.',
+        viewport: { width: 750, height: 1334 },
+        fullPage: true,
+        timeout: 30000,
+        waitTime: 1000
+    };
+
+    let i = 0;
+    while (i < args.length) {
+        const arg = args[i];
+        
+        if (arg === '--help' || arg === '-h') {
+            showHelp();
+            process.exit(0);
+        }
+        
+        if (arg === '-o' || arg === '--output') {
+            options.outputDir = args[++i];
+        } else if (arg === '-w' || arg === '--width') {
+            options.viewport.width = parseInt(args[++i], 10);
+        } else if (arg === '-h' || arg === '--height') {
+            options.viewport.height = parseInt(args[++i], 10);
+        } else if (arg === '--full-page') {
+            options.fullPage = true;
+        } else if (arg === '--no-full-page') {
+            options.fullPage = false;
+        } else if (arg === '--timeout') {
+            options.timeout = parseInt(args[++i], 10);
+        } else if (arg === '--wait') {
+            options.waitTime = parseInt(args[++i], 10);
+        } else if (!arg.startsWith('-')) {
+            options.jsonPath = arg;
+        }
+        
+        i++;
+    }
+
+    return options;
+}
+
+async function run(args) {
+    const options = parseArgs(args);
+
+    if (!options.jsonPath) {
+        console.error('错误: 请指定 JSON 文件路径');
+        showHelp();
+        process.exit(1);
+    }
+
+    options.jsonPath = path.resolve(options.jsonPath);
+    options.outputDir = path.resolve(options.outputDir);
+
+    try {
+        const result = await takeScreenshot(options);
+        console.log(`\n截图成功: ${result.screenshotPath}`);
+    } catch (error) {
+        console.error(`\n截图失败: ${error.message}`);
+        process.exit(1);
+    }
+}
+
+module.exports = { run };

package/src/commands/set-component.js

@@ -0,0 +1,119 @@
+/**
+ * set-component 命令 - 设置组件属性
+ */
+
+const path = require('path');
+const fs = require('fs');
+const { CCSceneAsset, CCPrefab } = require('../lib/cc');
+const { buildTree } = require('../lib/node-utils');
+const { loadScriptMap, isPrefab } = require('../lib/fire-utils');
+
+/**
+ * 查找节点
+ */
+function findNode(root, nodePath) {
+    if (!nodePath) return root;
+    
+    const parts = nodePath.split('/').filter(p => p);
+    if (parts.length === 0) return root;
+    
+    let current = root;
+    
+    if (parts[0] === root._name) {
+        parts.shift();
+    }
+    
+    for (const part of parts) {
+        if (!current._children || current._children.length === 0) return null;
+        const found = current._children.find(c => c._name === part);
+        if (!found) return null;
+        current = found;
+    }
+    
+    return current;
+}
+
+/**
+ * 查找组件
+ */
+function findComponent(node, compType) {
+    if (!node._components) return null;
+    
+    const type = compType.toLowerCase();
+    const typeName = 'cc.' + type.charAt(0).toUpperCase() + type.slice(1);
+    
+    return node._components.find(c => c.__type__ === typeName);
+}
+
+function run(args) {
+    if (args.length < 4) {
+        console.log(JSON.stringify({ 
+            error: '用法: cocos2d-cli set-component <场景.fire|预制体.prefab> <节点路径> <组件类型> <属性名> <值>' 
+        }));
+        return;
+    }
+    
+    const filePath = args[0];
+    const nodePath = args[1];
+    const compType = args[2];
+    const prop = args[3];
+    const value = args[4];
+    
+    const ext = path.extname(filePath).toLowerCase();
+    
+    try {
+        let root;
+        let asset;
+        const json = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+        
+        if (ext === '.fire') {
+            asset = CCSceneAsset.fromJSON(json);
+            root = asset._scene;
+        } else if (ext === '.prefab') {
+            asset = CCPrefab.fromJSON(json);
+            root = asset._root;
+        } else {
+            console.log(JSON.stringify({ error: '不支持的文件类型，仅支持 .fire 和 .prefab' }));
+            return;
+        }
+        
+        const node = findNode(root, nodePath);
+        
+        if (!node) {
+            console.log(JSON.stringify({ error: `节点不存在: ${nodePath}` }));
+            return;
+        }
+        
+        const comp = findComponent(node, compType);
+        
+        if (!comp) {
+            console.log(JSON.stringify({ error: `组件不存在: ${compType}` }));
+            return;
+        }
+        
+        // 调用组件的 setProp 方法
+        if (typeof comp.setProp !== 'function') {
+            console.log(JSON.stringify({ error: '组件不支持 setProp 方法' }));
+            return;
+        }
+        
+        // 构造属性对象并调用 setProp
+        const props = { [prop]: value };
+        comp.setProp(props);
+        
+        // 保存
+        const data = asset.toJSON();
+        fs.writeFileSync(filePath, JSON.stringify(data, null, 2), 'utf8');
+        
+        // 输出节点树
+        const scriptMap = loadScriptMap(filePath);
+        const prefab = isPrefab(data);
+        const startIndex = prefab ? 0 : 1;
+        console.log(buildTree(data, scriptMap, startIndex).trim());
+        
+    } catch (err) {
+        console.log(JSON.stringify({ error: err.message }));
+    }
+}
+
+module.exports = { run };

package/src/commands/set.js

@@ -1,5 +1,5 @@
 /**
- * set 命令 - 设置节点或组件属性
+ * set 命令 - 设置节点属性
  */
 
 const path = require('path');
@@ -11,10 +11,10 @@ const { loadScriptMap, isPrefab } = require('../lib/fire-utils');
 /**
  * 查找节点
  */
-function findNode(root, path) {
-    if (!path) return root;
+function findNode(root, nodePath) {
+    if (!nodePath) return root;
     
-    const parts = path.split('/').filter(p => p);
+    const parts = nodePath.split('/').filter(p => p);
     if (parts.length === 0) return root;
     
     let current = root;
@@ -33,51 +33,15 @@ function findNode(root, path) {
     return current;
 }
 
-/**
- * 查找组件
- */
-function findComponent(node, compType) {
-    if (!node._components) return null;
-    
-    const type = compType.toLowerCase();
-    const typeName = 'cc.' + type.charAt(0).toUpperCase() + type.slice(1);
-    
-    return node._components.find(c => c.__type__ === typeName);
-}
-
-/**
- * 设置节点属性值
- */
-function setNodeProp(node, prop, value) {
-    switch (prop.toLowerCase()) {
-        case 'name': node._name = value; return true;
-        case 'active': node._active = value === 'true' || value === true; return true;
-        case 'x': node._trs.array[0] = parseFloat(value); return true;
-        case 'y': node._trs.array[1] = parseFloat(value); return true;
-        case 'width': node._contentSize.width = parseFloat(value); return true;
-        case 'height': node._contentSize.height = parseFloat(value); return true;
-        case 'scalex': node._trs.array[7] = parseFloat(value); return true;
-        case 'scaley': node._trs.array[8] = parseFloat(value); return true;
-        case 'rotation':
-            node._trs.array[5] = parseFloat(value) * Math.PI / 180;
-            node._eulerAngles.z = parseFloat(value);
-            return true;
-        case 'anchorx': node._anchorPoint.x = parseFloat(value); return true;
-        case 'anchory': node._anchorPoint.y = parseFloat(value); return true;
-        case 'opacity': node._opacity = parseInt(value); return true;
-        default: return false;
-    }
-}
-
 function run(args) {
     if (args.length < 4) {
-        console.log(JSON.stringify({ error: '用法: cocos2d-cli set <场景.fire|预制体.prefab> <节点路径> <属性名|组件.属性> <值>' }));
+        console.log(JSON.stringify({ error: '用法: cocos2d-cli set <场景.fire|预制体.prefab> <节点路径> <属性名> <值>' }));
         return;
     }
     
     const filePath = args[0];
     const nodePath = args[1];
-    const propPath = args[2];
+    const prop = args[2];
     const value = args[3];
     
     const ext = path.extname(filePath).toLowerCase();
@@ -105,31 +69,26 @@ function run(args) {
             return;
         }
         
-        // 检查是否是组件属性（格式: 组件.属性）
-        const parts = propPath.split('.');
+        // 调用节点的 setProp 方法
+        if (typeof node.setProp !== 'function') {
+            console.log(JSON.stringify({ error: '节点不支持 setProp 方法' }));
+            return;
+        }
         
-        if (parts.length === 2) {
-            // 组件属性
-            const comp = findComponent(node, parts[0]);
-            if (!comp) {
-                console.log(JSON.stringify({ error: `组件不存在: ${parts[0]}` }));
-                return;
-            }
-            
-            if (comp[parts[1]] === undefined) {
-                console.log(JSON.stringify({ error: `属性不存在: ${parts[1]}` }));
-                return;
-            }
-            
-            comp[parts[1]] = value;
-        } else {
-            // 节点属性
-            if (!setNodeProp(node, propPath, value)) {
-                console.log(JSON.stringify({ error: `属性不存在: ${propPath}` }));
-                return;
-            }
+        // 转换数值类型
+        let parsedValue = value;
+        if (!isNaN(value) && value !== '') {
+            parsedValue = parseFloat(value);
+        } else if (value === 'true') {
+            parsedValue = true;
+        } else if (value === 'false') {
+            parsedValue = false;
         }
         
+        // 构造属性对象并调用 setProp
+        const props = { [prop]: parsedValue };
+        node.setProp(props);
+        
         // 保存
         const data = asset.toJSON();
         fs.writeFileSync(filePath, JSON.stringify(data, null, 2), 'utf8');

package/src/lib/cc/CCCanvas.js

@@ -8,35 +8,25 @@ class CCCanvas extends CCComponent {
     constructor() {
         super();
         this.__type__ = 'cc.Canvas';
-        
+
         this._designResolution = new CCSize(960, 640);
         this._fitWidth = false;
         this._fitHeight = true;
     }
 
-    /**
-     * 设置设计分辨率
-     */
-    setDesignResolution(width, height) {
-        this._designResolution.set(width, height);
-        return this;
-    }
-
-    /**
-     * 设置适配模式
-     */
-    setFit(fitWidth, fitHeight) {
-        this._fitWidth = fitWidth;
-        this._fitHeight = fitHeight;
+    setProp(props) {
+        super.setProp(props);
+        if (props.designResolution) {
+            this._designResolution = new CCSize(props.designResolution.width, props.designResolution.height);
+        }
+        if (props.fitWidth !== undefined) this._fitWidth = props.fitWidth;
+        if (props.fitHeight !== undefined) this._fitHeight = props.fitHeight;
         return this;
     }
 
-    /**
-     * 转换为属性面板显示格式
-     */
-    toPanelJSON() {
+    getProp() {
         return {
-            ...super.toPanelJSON(),
+            ...super.getProp(),
             designResolution: {
                 width: this._designResolution?.width ?? 960,
                 height: this._designResolution?.height ?? 640