cocos2d-cli 1.4.0 → 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/cocos2d-cli.js

@@ -13,6 +13,7 @@ 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',
     build: '../src/commands/build',
     'create-prefab': '../src/commands/prefab-create',
@@ -28,15 +29,21 @@ Cocos Creator CLI - 场景/预制体操作工具集
   cocos2d-cli <command> [options]
 
 命令:
-  tree <场景.fire | 预制体.prefab>           查看节点树（获取索引）
-  get <场景.fire | 预制体.prefab> <索引>     获取节点属性
-  set <场景.fire | 预制体.prefab> <索引> [选项]  修改节点属性
-  add <场景.fire | 预制体.prefab> <父索引> <名称>  添加节点
-  add-component <文件> <节点索引> <类型>     给节点添加组件
-  remove <文件> <索引> [--component|--node]  删除节点或组件（自动检测类型）
+  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文件创建场景
+  create-scene [JSON文件] <输出.fire>        创建场景（不传JSON则创建默认）
+
+节点路径格式:
+  Canvas                    - 根节点下的 Canvas
+  Canvas/MidNode            - Canvas 下的 MidNode
+  Canvas/GameScene/NodeA    - 多层嵌套路径
 
 选项:
   --name=<名称>          修改节点名称
@@ -56,7 +63,6 @@ Cocos Creator CLI - 场景/预制体操作工具集
   --fontSize=<数值>      修改 Label 字体大小
   --lineHeight=<数值>    修改 Label 行高
   --type=sprite/label/button  添加节点时指定组件类型
-  --at=<索引>            添加节点时插入到子节点的指定位置（0=第一个）
 
 JSON 格式 (create-prefab / create-scene):
   {
@@ -98,9 +104,12 @@ JSON 格式 (create-prefab / create-scene):
 
 示例:
   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 文件创建场景
   cocos2d-cli create-scene scene.json assets/scene.fire
@@ -116,7 +125,7 @@ JSON 格式 (create-prefab / create-scene):
 // 解析参数
 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);
 }

package/package.json

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

package/src/commands/add-component.js

@@ -1,119 +1,111 @@
 /**
- * add-component 命令 - 给已存在的节点添加组件
+ * add-component 命令 - 添加组件
  */
 
-const { loadScene, saveScene, buildMaps, findNodeIndex, refreshEditor } = require('../lib/fire-utils');
-const { outputError, outputSuccess, generateId } = require('../lib/utils');
-const { createComponent } = 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) {}
-    return {};
+/**
+ * 创建组件
+ */
+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 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;
     
-    return {
-        "__type__": typeName,
-        "_name": "",
-        "_objFlags": 0,
-        "node": { "__id__": nodeId },
-        "_enabled": true,
-        "_id": generateId()
-    };
+    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) {
-        outputError('用法: cocos2d-cli 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]) {
-            outputError(`找不到节点: ${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 ccType = 'cc.' + componentType.charAt(0).toUpperCase() + componentType.slice(1);
-        const existingComp = node._components?.find(comp => {
-            const compData = data[comp.__id__];
-            if (!compData) return false;
-            const compType = compData.__type__;
-            return compType === componentType || compType === ccType;
-        });
+        const node = findNode(root, nodePath);
         
-        if (existingComp) {
-            outputError(`节点 "${node._name}" 已有 ${componentType} 组件`);
+        if (!node) {
+            console.log(JSON.stringify({ error: `节点不存在: ${nodePath}` }));
             return;
         }
         
-        const compIndex = data.length;
-        let componentData;
-        
-        // 尝试使用内置组件
-        componentData = createComponent(componentType, nodeIndex);
-        
-        if (!componentData) {
-            // 自定义脚本组件
-            const projectPath = path.dirname(scenePath);
-            const scriptMap = loadScriptMap(projectPath);
-            
-            let scriptUuid = null;
-            for (const [uuid, info] of Object.entries(scriptMap)) {
-                if (info.name === componentType) {
-                    scriptUuid = uuid;
-                    break;
-                }
-            }
-            
-            const uuidRegex = /^[a-f0-9-]{36}$/i;
-            if (!scriptUuid && 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);
+        comp.node = node;
+        node._components = node._components || [];
+        node._components.push(comp);
         
-        if (!node._components) node._components = [];
-        node._components.push({ "__id__": compIndex });
+        // 保存
+        const data = asset.toJSON();
+        fs.writeFileSync(filePath, JSON.stringify(data, null, 2), 'utf8');
         
-        saveScene(scenePath, data);
-        refreshEditor(scenePath);
+        // 输出节点树
+        const scriptMap = loadScriptMap(filePath);
+        const prefab = isPrefab(data);
+        const startIndex = prefab ? 0 : 1;
+        console.log(buildTree(data, scriptMap, startIndex).trim());
         
-        outputSuccess({
-            componentIndex: compIndex,
-            componentType: componentData.__type__,
-            nodeIndex,
-            nodeName: node._name
-        });
     } catch (err) {
-        outputError(err.message);
+        console.log(JSON.stringify({ error: err.message }));
     }
 }