cocos2d-cli 1.2.1 → 1.5.0

package/README.md

@@ -0,0 +1,142 @@
+# cocos2d-cli
+
+Cocos Creator 场景/预制体命令行操作工具，支持通过 CLI 或 AI 自动化创建和编辑游戏界面。
+
+## 功能
+
+- 创建场景和预制体
+- 添加/删除节点和组件
+- 修改节点和组件属性
+- 查看节点树结构
+- 从简化 JSON 创建复杂界面
+
+## 安装
+
+```bash
+npm install -g cocos2d-cli
+```
+
+## 使用
+
+```bash
+cocos2d-cli help          # 查看帮助
+cocos2d-cli --help        # 同上
+```
+
+### 创建预制体
+
+### 创建预制体
+
+```bash
+# 创建空预制体
+cocos2d-cli create-prefab ./MyPrefab.prefab
+
+# 从 JSON 创建预制体
+cocos2d-cli create-prefab ./ui.json ./MyPrefab.prefab
+```
+
+### 创建场景
+
+```bash
+# 创建默认场景（含 Canvas 和 Main Camera）
+cocos2d-cli create-scene ./MyScene.fire
+
+# 从 JSON 创建场景
+cocos2d-cli create-scene ./ui.json ./MyScene.fire
+```
+
+### 节点操作
+
+```bash
+# 添加节点
+cocos2d-cli add ./MyPrefab.prefab Root NewNode --type=sprite --width=100 --height=100
+
+# 删除节点
+cocos2d-cli remove ./MyPrefab.prefab Root/NewNode
+
+# 查看节点树
+cocos2d-cli tree ./MyPrefab.prefab
+```
+
+### 组件操作
+
+```bash
+# 添加组件
+cocos2d-cli add-component ./MyPrefab.prefab Root label
+
+# 删除组件
+cocos2d-cli remove-component ./MyPrefab.prefab Root label
+```
+
+### 属性操作
+
+```bash
+# 获取属性
+cocos2d-cli get ./MyPrefab.prefab Root width
+cocos2d-cli get ./MyPrefab.prefab Root label.string
+
+# 设置属性
+cocos2d-cli set ./MyPrefab.prefab Root width 200
+cocos2d-cli set ./MyPrefab.prefab Root label.string "Hello"
+```
+
+## 简化 JSON 格式
+
+AI 可以通过简化 JSON 描述界面结构：
+
+```json
+{
+  "name": "MyButton",
+  "width": 200,
+  "height": 60,
+  "components": ["sprite", "button"],
+  "children": [
+    {
+      "name": "Label",
+      "components": [
+        {
+          "type": "label",
+          "string": "Click Me",
+          "fontSize": 24
+        }
+      ]
+    }
+  ]
+}
+```
+
+### 支持的组件类型
+
+- `canvas` - Canvas
+- `widget` - Widget
+- `sprite` - Sprite
+- `label` - Label
+- `button` - Button
+- `camera` - Camera
+
+### 节点属性
+
+| 属性 | 说明 |
+|------|------|
+| `name` | 节点名称 |
+| `active` | 是否激活 |
+| `x`, `y` | 位置 |
+| `width`, `height` | 尺寸 |
+| `scaleX`, `scaleY` | 缩放 |
+| `rotation` | 旋转角度 |
+| `anchorX`, `anchorY` | 锚点 |
+| `opacity` | 透明度 |
+| `color` | 颜色 (十六进制如 "#ff0000") |
+
+## 架构
+
+```
+输入                      内存模型                    输出
+─────                     ────────                   ─────
+简化JSON ──→ json-parser ──→ CCNode树 ─┬─→ CCSceneAsset ──→ .fire
+编辑器文件 ──→ fromJSON ──→ CC对象树 ──┘─→ CCPrefab ──→ .prefab
+```
+
+## License
+
+MIT

package/bin/{cocos-cli.js → cocos2d-cli.js}

@@ -13,8 +13,8 @@ const commands = {
     set: '../src/commands/set',
     add: '../src/commands/add',
     'add-component': '../src/commands/add-component',
+    'remove-component': '../src/commands/remove-component',
     'remove': '../src/commands/remove',
-    delete: '../src/commands/delete',
     build: '../src/commands/build',
     'create-prefab': '../src/commands/prefab-create',
     'create-scene': '../src/commands/create-scene'
@@ -29,16 +29,21 @@ Cocos Creator CLI - 场景/预制体操作工具集
   cocos2d-cli <command> [options]
 
 命令:
-  tree <场景.fire | 预制体.prefab>           查看节点树（获取索引）
-  get <场景.fire | 预制体.prefab> <索引>     获取节点属性
-  set <场景.fire | 预制体.prefab> <索引> [选项]  修改节点属性
-  add <场景.fire | 预制体.prefab> <父索引> <名称>  添加节点
-  add-component <文件> <节点索引> <类型>     给节点添加组件
-  remove <文件> <索引>                       删除节点或组件
-  delete <文件> <节点索引>                   删除节点
+  tree <场景.fire | 预制体.prefab>           查看节点树
+  get <场景.fire | 预制体.prefab> <节点路径>  获取节点属性
+  set <场景.fire | 预制体.prefab> <节点路径> [选项]  修改节点属性
+  add <场景.fire | 预制体.prefab> <父节点路径> <名称>  添加节点
+  add-component <文件> <节点路径> <类型>     给节点添加组件
+  remove-component <文件> <节点路径> <类型>  删除节点组件
+  remove <文件> <节点路径>                   删除节点
   build <项目目录>                           构建组件映射
-  create-prefab <输出.prefab>               从 stdin(JSON) 创建预制体
-  create-scene <输出.fire>                   从 stdin(JSON) 创建场景
+  create-prefab [JSON文件] <输出.prefab>     创建预制体（不传JSON则创建默认）
+  create-scene [JSON文件] <输出.fire>        创建场景（不传JSON则创建默认）
+
+节点路径格式:
+  Canvas                    - 根节点下的 Canvas
+  Canvas/MidNode            - Canvas 下的 MidNode
+  Canvas/GameScene/NodeA    - 多层嵌套路径
 
 选项:
   --name=<名称>          修改节点名称
@@ -58,7 +63,6 @@ Cocos Creator CLI - 场景/预制体操作工具集
   --fontSize=<数值>      修改 Label 字体大小
   --lineHeight=<数值>    修改 Label 行高
   --type=sprite/label/button  添加节点时指定组件类型
-  --at=<索引>            添加节点时插入到子节点的指定位置（0=第一个）
 
 JSON 格式 (create-prefab / create-scene):
   {
@@ -79,8 +83,13 @@ JSON 格式 (create-prefab / create-scene):
 
   节点属性: name, width, height, x, y, color, opacity, anchorX, anchorY, rotation, scaleX, scaleY, active
 
+  组件写法:
+    简写: "sprite" 或 "label"
+    完整: { "type": "sprite", "sizeMode": 1 }
+    完整: { "type": "label", "string": "文本", "fontSize": 32, "color": "#fff" }
+
   组件类型:
-    sprite   - 精灵���默认白色方块，节点设置什么颜色就显示什么颜色
+    sprite   - 精灵（默认白色方块，节点设置什么颜色就显示什么颜色）
     label    - 文本，支持 string, fontSize, color(兼容)
     button   - 按钮，通常配合 sprite 使用才能看见
     widget   - 对齐，支持 top, bottom, left, right
@@ -92,26 +101,31 @@ JSON 格式 (create-prefab / create-scene):
   注意:
     - color 写在节点或 label 组件均可
     - button 需要配合 sprite 才能看见按钮外观
-    - 必须通过 JSON 文件输入: type panel.json | cocos2d-cli create-prefab xxx.prefab
 
 示例:
   cocos2d-cli tree assets/main.fire
-  cocos2d-cli get assets/main.fire 5
-  cocos2d-cli set assets/main.fire 8 --x=100 --y=200 --color=#ff0000
-  cocos2d-cli add assets/main.fire 5 NewSprite --type=sprite --x=100
+  cocos2d-cli get assets/main.fire Canvas/MidNode
+  cocos2d-cli set assets/main.fire Canvas/MidNode --x=100 --y=200 --color=#ff0000
+  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 创建场景
-  type scene.json | cocos2d-cli create-scene assets/scene.fire
+  # 从 JSON 文件创建场景
+  cocos2d-cli create-scene scene.json assets/scene.fire
 
-  # 从 JSON 创建预制体
-  type panel.json | cocos2d-cli create-prefab assets/panel.prefab
+  # 从 JSON 文件创建预制体
+  cocos2d-cli create-prefab panel.json assets/panel.prefab
+
+  # 创建默认预制体（不传JSON）
+  cocos2d-cli create-prefab assets/NewNode.prefab
 `);
 }
 
 // 解析参数
 const args = process.argv.slice(2);
 
-if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
+if (args.length === 0 || args[0] === '--help' || args[0] === '-h' || args[0] === 'help') {
     showHelp();
     process.exit(0);
 }
@@ -132,4 +146,4 @@ try {
 } catch (err) {
     console.error(`命令执行失败: ${err.message}`);
     process.exit(1);
-}
+}

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "cocos2d-cli", 
-  "version": "1.2.1",
+  "version": "1.5.0",
   "description": "Command-line tools for AI to read and manipulate Cocos Creator 2.4.x project scenes",
-  "main": "bin/cocos-cli.js",
+  "main": "bin/cocos2d-cli.js",
   "bin": {
-    "cocos2d-cli": "./bin/cocos-cli.js"
+    "cocos2d-cli": "./bin/cocos2d-cli.js"
   },
   "files": [
     "bin",

package/src/commands/add-component.js

@@ -1,151 +1,112 @@
 /**
- * add-component 命令 - 给已存在的节点添加组件
+ * add-component 命令 - 添加组件
  */
 
-const { loadScene, saveScene, buildMaps, findNodeIndex, refreshEditor } = require('../lib/fire-utils');
-const { Components, generateId } = require('../lib/components');
-const fs = require('fs');
 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 loadScriptMap(projectPath) {
-    const mapPath = path.join(projectPath, 'data', 'script_map.json');
-    try {
-        if (fs.existsSync(mapPath)) {
-            return JSON.parse(fs.readFileSync(mapPath, 'utf-8'));
-        }
-    } catch (e) {
-        // 忽略错误
+/**
+ * 创建组件
+ */
+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;
     }
-    return {};
 }
 
-// 创建自定义脚本组件
-function createScriptComponent(scriptUuid, nodeId, scriptMap) {
-    const scriptInfo = scriptMap[scriptUuid];
-    const typeName = scriptInfo ? scriptInfo.name : scriptUuid;
+/**
+ * 查找节点
+ */
+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();
+    }
     
-    return {
-        "__type__": typeName,
-        "_name": "",
-        "_objFlags": 0,
-        "node": { "__id__": nodeId },
-        "_enabled": true,
-        "_id": generateId()
-    };
+    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: '用法: cocos2.4 add-component <场景文件路径> <节点路径> <组件类型>' 
-        }));
+        console.log(JSON.stringify({ error: '用法: cocos2d-cli add-component <场景.fire|预制体.prefab> <节点路径> <组件类型>' }));
         return;
     }
     
-    const scenePath = args[0];
-    const nodeRef = args[1];
-    const componentType = args[2];
+    const filePath = args[0];
+    const nodePath = args[1];
+    const compType = args[2];
+    
+    const ext = path.extname(filePath).toLowerCase();
     
     try {
-        const data = loadScene(scenePath);
-        const { indexMap } = buildMaps(data);
+        let root;
+        let asset;
+        const json = JSON.parse(fs.readFileSync(filePath, 'utf8'));
         
-        // 查找节点
-        const nodeIndex = findNodeIndex(data, indexMap, nodeRef);
-        
-        if (nodeIndex === null || !data[nodeIndex]) {
-            console.log(JSON.stringify({ error: `找不到节点: ${nodeRef}` }));
+        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 = data[nodeIndex];
-        
-        // 检查是否已有该类型组件
-        const existingComp = node._components?.find(comp => {
-            const compData = data[comp.__id__];
-            if (!compData) return false;
-            const compType = compData.__type__;
-            return compType === componentType || compType === 'cc.' + componentType.charAt(0).toUpperCase() + componentType.slice(1);
-        });
+        const node = findNode(root, nodePath);
         
-        if (existingComp) {
-            console.log(JSON.stringify({ 
-                error: `节点 "${node._name}" 已有 ${componentType} 组件`,
-                nodeIndex,
-                nodeName: node._name
-            }));
+        if (!node) {
+            console.log(JSON.stringify({ error: `节点不存在: ${nodePath}` }));
             return;
         }
         
-        // 加载脚本映射（从场景文件所在项目的 data 目录）
-        const projectPath = path.dirname(scenePath);
-        const scriptMap = loadScriptMap(projectPath);
-        
         // 创建组件
-        let componentData;
-        const compIndex = data.length;
-        
-        // 检查是否是内置组件
-        const builtInTypes = ['sprite', 'label', 'button', 'layout', 'widget', 'camera', 'canvas', 'particleSystem'];
-        
-        if (builtInTypes.includes(componentType.toLowerCase())) {
-            // 内置组件
-            const typeKey = componentType.toLowerCase();
-            componentData = Components[typeKey]?.(nodeIndex);
-            
-            if (!componentData) {
-                console.log(JSON.stringify({ error: `不支持的组件类型: ${componentType}` }));
-                return;
-            }
-        } else {
-            // 自定义脚本组件 - 查找脚本UUID
-            let scriptUuid = null;
-            
-            // 在 scriptMap 中查找
-            for (const [uuid, info] of Object.entries(scriptMap)) {
-                if (info.name === componentType) {
-                    scriptUuid = uuid;
-                    break;
-                }
-            }
-            
-            // 如果没找到，尝试直接使用 componentType 作为类型名
-            if (!scriptUuid) {
-                // 检查是否是有效的 UUID 格式
-                const uuidRegex = /^[a-f0-9-]{36}$/i;
-                if (uuidRegex.test(componentType)) {
-                    scriptUuid = componentType;
-                }
-            }
-            
-            componentData = createScriptComponent(scriptUuid || componentType, nodeIndex, scriptMap);
+        const comp = createComponent(compType);
+        if (!comp) {
+            console.log(JSON.stringify({ error: `不支持的组件类型: ${compType}` }));
+            return;
         }
         
-        // 添加组件到数组
-        data.push(componentData);
-        
-        // 更新节点的 _components
-        if (!node._components) node._components = [];
-        node._components.push({ "__id__": compIndex });
+        comp.node = node;
+        node._components = node._components || [];
+        node._components.push(comp);
         
-        // 保存场景
-        saveScene(scenePath, data);
+        // 保存
+        const data = asset.toJSON();
+        fs.writeFileSync(filePath, JSON.stringify(data, null, 2), 'utf8');
         
-        // 触发编辑器刷新（传入场景路径以重新打开场景）
-        refreshEditor(scenePath);
+        // 输出节点树
+        const scriptMap = loadScriptMap(filePath);
+        const prefab = isPrefab(data);
+        const startIndex = prefab ? 0 : 1;
+        console.log(buildTree(data, scriptMap, startIndex).trim());
         
-        console.log(JSON.stringify({
-            success: true,
-            componentIndex: compIndex,
-            componentType: componentData.__type__,
-            nodeIndex,
-            nodeName: node._name,
-            message: `组件 "${componentData.__type__}" 已添加到节点 "${node._name}"`
-        }, null, 2));
     } catch (err) {
         console.log(JSON.stringify({ error: err.message }));
     }
 }
 
-module.exports = { run };
+module.exports = { run };