cocos2d-cli 1.6.5 → 2.1.0

package/package.json

@@ -1,33 +1,40 @@
-{
-  "name": "cocos2d-cli",
-  "version": "1.6.5",
-  "description": "Command-line tools for AI to read and manipulate Cocos Creator 2.4.x project scenes",
-  "main": "bin/cocos2d-cli.js",
-  "bin": {
-    "cocos2d-cli": "bin/cocos2d-cli.js"
-  },
-  "files": [
-    "bin",
-    "src",
-    "data"
-  ],
-  "scripts": {
-    "test": "echo \"No tests specified\" && exit 1"
-  },
-  "keywords": [
-    "cocos",
-    "cocos-creator",
-    "cli",
-    "scene",
-    "fire",
-    "screenshot"
-  ],
-  "author": "",
-  "license": "MIT",
-  "engines": {
-    "node": ">=14.0.0"
-  },
-  "dependencies": {
-    "playwright": "^1.58.2"
-  }
-}
+{
+  "name": "cocos2d-cli",
+  "version": "2.1.0",
+  "description": "Command-line tools for AI to read and manipulate Cocos Creator 2.4.x project scenes",
+  "type": "module",
+  "main": "dist/bin/cocos2d-cli.js",
+  "bin": {
+    "cocos2d-cli": "dist/bin/cocos2d-cli.js"
+  },
+  "files": [
+    "dist",
+    "data"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "prepare": "npm run build",
+    "test": "echo \"No tests specified\" && exit 1"
+  },
+  "keywords": [
+    "cocos",
+    "cocos-creator",
+    "cli",
+    "scene",
+    "fire",
+    "screenshot"
+  ],
+  "author": "",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "playwright": "^1.58.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.17",
+    "typescript": "^5.9.3"
+  }
+}

package/bin/cocos2d-cli.js

@@ -1,152 +0,0 @@
-#!/usr/bin/env node
-/**       
- * Cocos Creator CLI
- * Command-line tools for AI to read and manipulate Cocos Creator 2.4.x project scenes
- */
-
-const path = require('path');
-
-// 命令映射
-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',
-    'screenshot': '../src/commands/screenshot'
-};
-
-// 帮助信息
-function showHelp() {
-    console.log(`
-Cocos Creator CLI - 场景/预制体操作工具集
-
-用法:
-  cocos2d-cli <command> [options]
-
-命令:
-  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    - 多层嵌套路径
-
-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 格式:
-  详见 SKILL.md 完整文档。简要示例：
-  {
-    "name": "Node",
-    "width": 400, "height": 300,
-    "x": 0, "y": 0,
-    "anchorX": 0, "color": "#336699",
-    "components": [
-      { "type": "label", "string": "Hello", "horizontalAlign": "left" },
-      { "type": "richText", "string": "<color=#3cb034>绿色</color>" }
-    ],
-    "children": [...]
-  }
-
-  提示：配合 anchorX + horizontalAlign 实现靠左/靠右布局（见 SKILL.md）
-
-示例:
-  cocos2d-cli tree assets/main.fire
-  cocos2d-cli get assets/main.fire Canvas/MidNode
-  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
-  cocos2d-cli remove assets/main.fire Canvas/MidNode
-
-  # 从 JSON 文件创建场景
-  cocos2d-cli create-scene scene.json assets/scene.fire
-
-  # 从 JSON 文件创建预制体
-  cocos2d-cli create-prefab panel.json assets/panel.prefab
-
-  # 创建默认预制体（不传JSON）
-  cocos2d-cli create-prefab assets/NewNode.prefab
-
-  # 截图
-  cocos2d-cli screenshot data.json
-  cocos2d-cli screenshot data.json -o ./screenshots --width 1080 --height 1920
-`);
-}
-
-// 解析参数
-const args = process.argv.slice(2);
-
-if (args.length === 0 || args[0] === '--help' || args[0] === '-h' || args[0] === 'help') {
-    showHelp();
-    process.exit(0);
-}
-
-const commandName = args[0];
-const commandPath = commands[commandName];
-
-if (!commandPath) {
-    console.error(`未知命令: ${commandName}`);
-    console.error('运行 cocos2d-cli --help 查看可用命令');
-    process.exit(1);
-}
-
-// 加载并执行命令
-try {
-    const command = require(commandPath);
-    command.run(args.slice(1));
-} catch (err) {
-    console.error(`命令执行失败: ${err.message}`);
-    process.exit(1);
-}

package/src/commands/add-component.js

@@ -1,112 +0,0 @@
-/**
- * add-component 命令 - 添加组件
- */
-
-const path = require('path');
-const fs = require('fs');
-const { CCSceneAsset, CCPrefab, CCCanvas, CCWidget, CCSprite, CCLabel, CCButton, CCCamera } = require('../lib/cc');
-const { buildTree } = require('../lib/node-utils');
-const { loadScriptMap, isPrefab } = require('../lib/fire-utils');
-
-/**
- * 创建组件
- */
-function createComponent(type) {
-    switch (type.toLowerCase()) {
-        case 'canvas': return new CCCanvas();
-        case 'widget': return new CCWidget();
-        case 'sprite': return new CCSprite();
-        case 'label': return new CCLabel();
-        case 'button': return new CCButton();
-        case 'camera': return new CCCamera();
-        default: return null;
-    }
-}
-
-/**
- * 查找节点
- */
-function findNode(root, path) {
-    if (!path) return root;
-    
-    const parts = path.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 run(args) {
-    if (args.length < 3) {
-        console.log(JSON.stringify({ error: '用法: cocos2d-cli add-component <场景.fire|预制体.prefab> <节点路径> <组件类型>' }));
-        return;
-    }
-    
-    const filePath = args[0];
-    const nodePath = args[1];
-    const compType = args[2];
-    
-    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 = createComponent(compType);
-        if (!comp) {
-            console.log(JSON.stringify({ error: `不支持的组件类型: ${compType}` }));
-            return;
-        }
-        
-        comp.node = node;
-        node._components = node._components || [];
-        node._components.push(comp);
-        
-        // 保存
-        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/add.js

@@ -1,177 +0,0 @@
-/**
- * add 命令 - 添加节点
- */
-
-const path = require('path');
-const fs = require('fs');
-const { CCNode, CCSceneAsset, CCPrefab, CCCanvas, CCWidget, CCSprite, CCLabel, CCButton } = require('../lib/cc');
-const { buildTree } = require('../lib/node-utils');
-const { loadScriptMap, isPrefab } = require('../lib/fire-utils');
-const { generateCompressedUUID } = require('../lib/utils');
-
-/**
- * 解析命令行选项
- */
-function parseOptions(args, startIndex) {
-    const options = {};
-    for (let i = startIndex; i < args.length; i++) {
-        const arg = args[i];
-        if (arg.startsWith('--')) {
-            const eqIndex = arg.indexOf('=');
-            if (eqIndex > 0) {
-                const key = arg.substring(2, eqIndex);
-                let value = arg.substring(eqIndex + 1);
-                if (!isNaN(value) && value !== '') {
-                    value = parseFloat(value);
-                }
-                options[key] = value;
-            }
-        }
-    }
-    return options;
-}
-
-/**
- * 创建组件
- */
-function createComponent(type) {
-    switch (type.toLowerCase()) {
-        case 'canvas': return new CCCanvas();
-        case 'widget': return new CCWidget();
-        case 'sprite': return new CCSprite();
-        case 'label': return new CCLabel();
-        case 'button': return new CCButton();
-        default: return null;
-    }
-}
-
-/**
- * 查找节点
- */
-function findNode(root, path) {
-    if (!path) return root;
-    
-    const parts = path.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 run(args) {
-    if (args.length < 3) {
-        console.log(JSON.stringify({ error: '用法: cocos2d-cli add <场景.fire|预制体.prefab> <父节点路径> <节点名称> [--type=组件类型] [--x=N] [--y=N]' }));
-        return;
-    }
-    
-    const filePath = args[0];
-    const parentPath = args[1];
-    const nodeName = args[2];
-    const options = parseOptions(args, 3);
-    
-    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 parent = findNode(root, parentPath);
-        
-        if (!parent) {
-            console.log(JSON.stringify({ error: `父节点不存在: ${parentPath}` }));
-            return;
-        }
-        
-        // 创建节点
-        const node = new CCNode(nodeName);
-        
-        // 应用属性
-        if (options.x !== undefined) node._trs.array[0] = parseFloat(options.x);
-        if (options.y !== undefined) node._trs.array[1] = parseFloat(options.y);
-        if (options.width !== undefined) node._contentSize.width = parseFloat(options.width);
-        if (options.height !== undefined) node._contentSize.height = parseFloat(options.height);
-        if (options.scaleX !== undefined) node._trs.array[7] = parseFloat(options.scaleX);
-        if (options.scaleY !== undefined) node._trs.array[8] = parseFloat(options.scaleY);
-        if (options.rotation !== undefined) {
-            node._trs.array[5] = parseFloat(options.rotation) * Math.PI / 180;
-            node._eulerAngles.z = parseFloat(options.rotation);
-        }
-        if (options.active !== undefined) {
-            node._active = options.active !== 'false' && options.active !== false;
-        }
-        
-        // 添加组件
-        if (options.type) {
-            const comp = createComponent(options.type);
-            if (comp) {
-                comp.node = node;
-                node._components = [comp];
-                
-                // 组件特殊属性
-                if (options.type.toLowerCase() === 'label') {
-                    if (options.string) {
-                        comp._string = options.string;
-                        comp['_N$string'] = options.string;
-                    }
-                    if (options.fontSize) {
-                        comp._fontSize = parseInt(options.fontSize);
-                        comp._lineHeight = parseInt(options.fontSize);
-                    }
-                }
-            }
-        }
-        
-        // 添加节点到父节点
-        parent._children = parent._children || [];
-        parent._children.push(node);
-        node._parent = parent;
-        
-        // 场景节点需要 _id，预制体需要 PrefabInfo
-        if (ext === '.fire') {
-            node._id = generateCompressedUUID();
-        } else if (ext === '.prefab') {
-            const { CCPrefabInfo } = require('../lib/cc');
-            node._prefab = new CCPrefabInfo();
-        }
-        
-        // 保存
-        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/build.js

@@ -1,78 +0,0 @@
-/**
- * build 命令 - 构建组件映射
- */
-
-const fs = require('fs');
-const path = require('path');
-
-function run(args) {
-    if (args.length < 1) {
-        console.log(JSON.stringify({ error: '用法: cocos2d-cli build <项目目录>' }));
-        return;
-    }
-    
-    const projectDir = args[0];
-    const importsDir = path.join(projectDir, 'library', 'imports');
-    const outputFile = path.join(__dirname, '../../data/script_map.json');
-    
-    if (!fs.existsSync(importsDir)) {
-        console.log(JSON.stringify({ error: `imports 目录不存在: ${importsDir}` }));
-        return;
-    }
-    
-    const scriptMap = {};
-    let processedCount = 0;
-    
-    function scanDirectory(dir) {
-        const items = fs.readdirSync(dir);
-        
-        for (const item of items) {
-            const fullPath = path.join(dir, item);
-            const stat = fs.statSync(fullPath);
-            
-            if (stat.isDirectory()) {
-                scanDirectory(fullPath);
-            } else if (item.endsWith('.js')) {
-                try {
-                    const content = fs.readFileSync(fullPath, 'utf8');
-                    
-                    // 查找 cc._RF.push 调用
-                    const match = content.match(/cc\._RF\.push\(module,\s*['"]([^'"]+)['"],\s*['"]([^'"]+)['"]\)/);
-                    
-                    if (match) {
-                        const hash = match[1];
-                        const className = match[2];
-                        
-                        // 只存储脚本相关的哈希（不以 'cc.' 开头的）
-                        if (!className.startsWith('cc.')) {
-                            scriptMap[hash] = className;
-                            processedCount++;
-                        }
-                    }
-                } catch (err) {
-                    // 忽略读取错误
-                }
-            }
-        }
-    }
-    
-    scanDirectory(importsDir);
-    
-    // 确保输出目录存在
-    const outputDir = path.dirname(outputFile);
-    if (!fs.existsSync(outputDir)) {
-        fs.mkdirSync(outputDir, { recursive: true });
-    }
-    
-    // 写入输出文件
-    fs.writeFileSync(outputFile, JSON.stringify(scriptMap, null, 2), 'utf8');
-    
-    console.log(JSON.stringify({
-        success: true,
-        count: Object.keys(scriptMap).length,
-        outputFile,
-        message: `构建完成，共 ${Object.keys(scriptMap).length} 个脚本映射`
-    }, null, 2));
-}
-
-module.exports = { run };