@appthen/cli 1.2.1 → 1.2.3

package/dist/index.js

@@ -29,6 +29,7 @@ var prettier = require('prettier');
 var fs$2 = require('fs-extra');
 var io = require('socket.io-client');
 var fs$3 = require('fs/promises');
+var chokidar = require('chokidar');
 var whatwgUrl = require('whatwg-url');
 
 function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
@@ -80,6 +81,7 @@ var fs__default$1 = /*#__PURE__*/_interopDefaultLegacy(fs$2);
 var fs__namespace$1 = /*#__PURE__*/_interopNamespace(fs$2);
 var io__default = /*#__PURE__*/_interopDefaultLegacy(io);
 var fs__default$2 = /*#__PURE__*/_interopDefaultLegacy(fs$3);
+var chokidar__default = /*#__PURE__*/_interopDefaultLegacy(chokidar);
 var whatwgUrl__default = /*#__PURE__*/_interopDefaultLegacy(whatwgUrl);
 
 /******************************************************************************
@@ -285,6 +287,9 @@ function removeDir(_path) {
     }
 }
 
+let urlAlphabet =
+  'useandom-26T198340PX75pxJACKVERYMINDBUSHWOLF_GQZbfghjklqvwyzrict';
+
 const POOL_SIZE_MULTIPLIER = 128;
 let pool, poolOffset;
 let fillPool = bytes => {
@@ -319,6 +324,14 @@ let customRandom = (alphabet, defaultSize, getRandom) => {
 };
 let customAlphabet = (alphabet, size = 21) =>
   customRandom(alphabet, size, random);
+let nanoid$1 = (size = 21) => {
+  fillPool((size -= 0));
+  let id = '';
+  for (let i = poolOffset - size; i < poolOffset; i++) {
+    id += urlAlphabet[pool[i] & 63];
+  }
+  return id
+};
 
 require('base-64').encode;
 var svgToBase64 = function (svgString) {
@@ -329,49 +342,127 @@ var svgToBase64 = function (svgString) {
 var alphabet = '0123456789abcdefghijklmnopqrstuvwxyz';
 var nanoid = customAlphabet(alphabet, 6);
 /**
- * 清理文件名，移除无效字符
+ * 文件名管理器，确保全局唯一性
+ */
+var FileNameManager = /** @class */ (function () {
+    function FileNameManager() {
+        this.usedNames = new Set();
+        this.usedIdentifiers = new Set();
+        this.nameCounters = new Map();
+        this.identifierCounters = new Map();
+    }
+    /**
+     * 生成唯一的文件名
+     * @param baseName 基础文件名
+     * @param extension 文件扩展名（包含点号，如 '.png'）
+     * @returns 唯一的文件名
+     */
+    FileNameManager.prototype.generateUniqueFileName = function (baseName, extension) {
+        var cleanBaseName = this.sanitizeFileName(baseName);
+        var finalName = "".concat(cleanBaseName).concat(extension);
+        // 如果名称已存在，使用计数器生成唯一名称
+        if (this.usedNames.has(finalName.toLowerCase())) {
+            var counter = (this.nameCounters.get(cleanBaseName) || 0) + 1;
+            this.nameCounters.set(cleanBaseName, counter);
+            finalName = "".concat(cleanBaseName, "_").concat(counter).concat(extension);
+            // 如果计数器名称仍然存在，使用 nanoid 确保唯一性
+            while (this.usedNames.has(finalName.toLowerCase())) {
+                finalName = "".concat(cleanBaseName, "_").concat(counter, "_").concat(nanoid(4)).concat(extension);
+            }
+        }
+        this.usedNames.add(finalName.toLowerCase());
+        return finalName;
+    };
+    /**
+     * 生成唯一的 JavaScript 标识符名称
+     * @param baseName 基础标识符名
+     * @returns 唯一的标识符名称
+     */
+    FileNameManager.prototype.generateUniqueIdentifier = function (baseName) {
+        var cleanBaseName = this.sanitizeIdentifier(baseName);
+        var finalName = cleanBaseName;
+        // 如果标识符已存在，使用计数器生成唯一名称
+        if (this.usedIdentifiers.has(finalName.toLowerCase())) {
+            var counter = (this.identifierCounters.get(cleanBaseName) || 0) + 1;
+            this.identifierCounters.set(cleanBaseName, counter);
+            finalName = "".concat(cleanBaseName, "_").concat(counter);
+            // 如果计数器名称仍然存在，使用 nanoid 确保唯一性
+            while (this.usedIdentifiers.has(finalName.toLowerCase())) {
+                finalName = "".concat(cleanBaseName, "_").concat(counter, "_").concat(nanoid(4));
+            }
+        }
+        this.usedIdentifiers.add(finalName.toLowerCase());
+        return finalName;
+    };
+    /**
+     * 清理文件名，移除无效字符
+     * @param rawName 原始文件名
+     * @returns 清理后的文件名
+     */
+    FileNameManager.prototype.sanitizeFileName = function (rawName) {
+        if (!rawName)
+            return "file_".concat(nanoid(6));
+        var cleaned = rawName
+            // 移除或替换无效的文件名字符
+            .replace(/[<>:"/\\|?*]/g, '') // 移除文件系统不允许的字符
+            .replace(/\s+/g, '_') // 空格替换为下划线
+            .replace(/[^\w\-_.]/g, '') // 只保留字母、数字、下划线、连字符和点
+            .replace(/_{2,}/g, '_') // 多个连续下划线替换为单个
+            .replace(/^[_-]+|[_-]+$/g, '') // 移除开头和结尾的下划线和连字符
+            .substring(0, 30); // 限制长度
+        return cleaned || "file_".concat(nanoid(6));
+    };
+    /**
+     * 清理JavaScript标识符，确保符合变量命名规范
+     * @param rawName 原始标识符名
+     * @returns 清理后的标识符名
+     */
+    FileNameManager.prototype.sanitizeIdentifier = function (rawName) {
+        if (!rawName)
+            return "id_".concat(nanoid(6));
+        var cleaned = rawName
+            // 移除或替换无效的标识符字符
+            .replace(/[^\w]/g, '_') // 只保留字母、数字、下划线
+            .replace(/_{2,}/g, '_') // 多个连续下划线替换为单个
+            .replace(/^[_\d]+|[_]+$/g, '') // 移除开头的数字和下划线，结尾的下划线
+            .substring(0, 30); // 限制长度
+        return cleaned || "id_".concat(nanoid(6));
+    };
+    /**
+     * 重置管理器状态
+     */
+    FileNameManager.prototype.reset = function () {
+        this.usedNames.clear();
+        this.usedIdentifiers.clear();
+        this.nameCounters.clear();
+        this.identifierCounters.clear();
+    };
+    return FileNameManager;
+}());
+// 全局文件名管理器实例
+var fileNameManager = new FileNameManager();
+/**
+ * 清理文件名，移除无效字符（保持向后兼容）
  * @param rawName 原始文件名
  * @returns 清理后的文件名
  */
 function sanitizeFileName(rawName) {
-    if (!rawName)
-        return '';
-    return rawName
-        // 移除或替换无效的文件名字符
-        .replace(/[<>:"/\\|?*]/g, '') // 移除文件系统不允许的字符
-        .replace(/\s+/g, '_') // 空格替换为下划线
-        .replace(/[^\w\-_.]/g, '') // 只保留字母、数字、下划线、连字符和点
-        .replace(/_{2,}/g, '_') // 多个连续下划线替换为单个
-        .replace(/^[_-]+|[_-]+$/g, '') // 移除开头和结尾的下划线和连字符
-        .substring(0, 50) // 限制长度
-        || "fallback_".concat(nanoid(6)); // 如果清理后为空，使用fallback名称
-}
-/**
- * 清理JavaScript标识符，确保符合变量命名规范
- * @param rawName 原始标识符名
- * @returns 清理后的标识符名
- */
-function sanitizeIdentifier(rawName) {
-    if (!rawName)
-        return "id_".concat(nanoid(6));
-    return rawName
-        // 移除或替换无效的标识符字符
-        .replace(/[^\w]/g, '_') // 只保留字母、数字、下划线
-        .replace(/_{2,}/g, '_') // 多个连续下划线替换为单个
-        .replace(/^[_\d]+|[_]+$/g, '') // 移除开头的数字和下划线，结尾的下划线
-        .substring(0, 30) // 限制长度
-        || "id_".concat(nanoid(6)); // 如果清理后为空，使用fallback名称
+    return fileNameManager['sanitizeFileName'](rawName);
 }
 var transformJsx = function (file, solution, outputPath) {
     // const componentsDeps: string[] = [];
     var images = [];
     var svgs = [];
+    // 重置文件名管理器，确保每次转换都从干净状态开始
+    fileNameManager.reset();
     // 全局数据相关状态追踪
     var hasGlobalDataDecorator = false;
     var usesGlobalData = false;
     var classDeclarationPath = null;
     // 简单判断组件还是页面
-    var componentType = file.path.includes('/src/components/') ? 'Component' : 'Page';
+    var componentType = file.path.includes('/src/components/')
+        ? 'Component'
+        : 'Page';
     var source = fs__namespace.readFileSync(file.path + '/' + file.fileName, 'utf-8');
     // 检测源码中是否使用了 this.globalData
     if (source.includes('this.globalData')) {
@@ -401,7 +492,8 @@ var transformJsx = function (file, solution, outputPath) {
             var decorators = path.node.decorators;
             if (decorators) {
                 var hasGlobalDataDec = decorators.some(function (decorator) {
-                    if (t__namespace.isDecorator(decorator) && t__namespace.isIdentifier(decorator.expression)) {
+                    if (t__namespace.isDecorator(decorator) &&
+                        t__namespace.isIdentifier(decorator.expression)) {
                         return decorator.expression.name === 'GlobalDataDecorator';
                     }
                     return false;
@@ -462,12 +554,18 @@ var transformJsx = function (file, solution, outputPath) {
                 body.splice(lastImportIndex + 2, 0, importDeclaration);
             }
             if (componentType === 'Page' && solution === 'vite') {
-                var importDeclaration = t__namespace.importDeclaration([t__namespace.importSpecifier(t__namespace.identifier('withRouter'), t__namespace.identifier('withRouter'))], t__namespace.stringLiteral('@/utils/router'));
+                var importDeclaration = t__namespace.importDeclaration([
+                    t__namespace.importSpecifier(t__namespace.identifier('withRouter'), t__namespace.identifier('withRouter')),
+                ], t__namespace.stringLiteral('@/utils/router'));
                 body.splice(lastImportIndex + (haveChildren ? 3 : 2), 0, importDeclaration);
             }
             if (usesGlobalData && !hasGlobalDataDecorator) {
-                var globalDataImport = t__namespace.importDeclaration([t__namespace.importSpecifier(t__namespace.identifier('GlobalDataDecorator'), t__namespace.identifier('GlobalDataDecorator'))], t__namespace.stringLiteral('@/utils'));
-                body.splice(lastImportIndex + (haveChildren ? 3 : 2) + (componentType === 'Page' && solution === 'vite' ? 1 : 0), 0, globalDataImport);
+                var globalDataImport = t__namespace.importDeclaration([
+                    t__namespace.importSpecifier(t__namespace.identifier('GlobalDataDecorator'), t__namespace.identifier('GlobalDataDecorator')),
+                ], t__namespace.stringLiteral('@/utils'));
+                body.splice(lastImportIndex +
+                    (haveChildren ? 3 : 2) +
+                    (componentType === 'Page' && solution === 'vite' ? 1 : 0), 0, globalDataImport);
             }
         },
         ImportDeclaration: function (path) {
@@ -540,7 +638,7 @@ var transformJsx = function (file, solution, outputPath) {
             if (nodePath.parent.name.name === 'AtIcon' &&
                 nodePath.node.name.name === 'svg' &&
                 ((_a = nodePath.node) === null || _a === void 0 ? void 0 : _a.value.type) === 'StringLiteral') {
-                var fileName_1 = '';
+                var fileName = '';
                 var color = '';
                 if (Array.isArray(nodePath.container)) {
                     var valueNode = nodePath.container.find(function (item) { return item.name.name === 'value'; });
@@ -549,25 +647,18 @@ var transformJsx = function (file, solution, outputPath) {
                         // @ts-ignore
                         )) === null || _b === void 0 ? void 0 : _b.value) === null || _c === void 0 ? void 0 : _c.value) || '';
                     if (valueNode) {
-                        fileName_1 = "svg_".concat(((_d = valueNode === null || valueNode === void 0 ? void 0 : valueNode.value) === null || _d === void 0 ? void 0 : _d.value) || nanoid(6));
-                        //   const classNameArr = fileName.split('__');
-                        //   fileName =
-                        //     (classNameArr.length > 0
-                        //       ? classNameArr[classNameArr.length - 1]
-                        //       : fileName) + '.png';
+                        var baseName = "svg_".concat(((_d = valueNode === null || valueNode === void 0 ? void 0 : valueNode.value) === null || _d === void 0 ? void 0 : _d.value) || nanoid(6));
+                        fileName = fileNameManager.generateUniqueFileName(baseName, '');
                     }
                 }
-                if (!fileName_1) {
-                    fileName_1 = "svg_".concat(nanoid(6));
-                }
-                // 文件名去重
-                if (svgs.findIndex(function (item) { return item.fileName === fileName_1; }) > -1) {
-                    fileName_1 = "".concat(fileName_1, "_").concat(nanoid(6));
+                if (!fileName) {
+                    var baseName = "svg_".concat(nanoid(6));
+                    fileName = fileNameManager.generateUniqueFileName(baseName, '');
                 }
                 // 替换
                 var node = nodePath.node;
                 var svgStr = node.value.value;
-                if (fileName_1 && svgStr) {
+                if (fileName && svgStr) {
                     // 替换颜色
                     if (svgStr && color) {
                         svgStr = svgStr.replace(/currentColor/g, color);
@@ -577,54 +668,50 @@ var transformJsx = function (file, solution, outputPath) {
                         svgStr = svgStr.replace(/width="100%"/g, '');
                         svgStr = svgStr.replace(/height="100%"/g, '');
                     }
-                    nodePath.replaceWith(t__namespace.jsxAttribute(t__namespace.jsxIdentifier('svg'), t__namespace.jsxExpressionContainer(t__namespace.memberExpression(t__namespace.identifier('ICONS'), t__namespace.stringLiteral(fileName_1), true))));
+                    nodePath.replaceWith(t__namespace.jsxAttribute(t__namespace.jsxIdentifier('svg'), t__namespace.jsxExpressionContainer(t__namespace.memberExpression(t__namespace.identifier('ICONS'), t__namespace.stringLiteral(fileName), true))));
                     svgs.push({
                         svgStr: svgStr,
-                        fileName: fileName_1,
+                        fileName: fileName,
                     });
                 }
             }
             if (nodePath.parent.name.name === 'Image' &&
                 nodePath.node.name.name === 'src' &&
                 ((_e = nodePath.node) === null || _e === void 0 ? void 0 : _e.value.type) === 'StringLiteral') {
-                var fileName_2 = '';
+                var fileName = '';
                 if (Array.isArray(nodePath.container)) {
                     var classNameNode = nodePath.container.find(function (item) { return item.name.name === 'className'; });
                     if (classNameNode) {
                         var rawClassName = (_f = classNameNode === null || classNameNode === void 0 ? void 0 : classNameNode.value) === null || _f === void 0 ? void 0 : _f.value;
                         if (rawClassName) {
                             // 处理 Tailwind CSS 类名和其他复杂类名
-                            fileName_2 = sanitizeFileName(rawClassName);
-                            var classNameArr = fileName_2.split('__');
-                            fileName_2 =
-                                (classNameArr.length > 0
-                                    ? classNameArr[classNameArr.length - 1]
-                                    : fileName_2) + '.png';
+                            var cleanedName = sanitizeFileName(rawClassName);
+                            var classNameArr = cleanedName.split('__');
+                            var baseName = classNameArr.length > 0
+                                ? classNameArr[classNameArr.length - 1]
+                                : cleanedName;
+                            fileName = fileNameManager.generateUniqueFileName(baseName, '.png');
                         }
                     }
                 }
                 // 如果没有从className获取到有效文件名，使用随机名称
-                if (!fileName_2) {
-                    fileName_2 = "image_".concat(nanoid(6), ".png");
-                }
-                // 文件名去重
-                if (images.findIndex(function (item) { return item.fileName === fileName_2.toLowerCase(); }) >
-                    -1) {
-                    fileName_2 = "r".concat(images.length, "_").concat(fileName_2.toLowerCase());
+                if (!fileName) {
+                    var baseName = "image_".concat(nanoid(6));
+                    fileName = fileNameManager.generateUniqueFileName(baseName, '.png');
                 }
                 // 替换
                 var node = nodePath.node;
                 var imageSrc = node.value.value;
-                var staticFileName = fileName_2.toLowerCase();
-                var staticInentifierName = "static_".concat(sanitizeIdentifier(staticFileName.split('.')[0]));
-                if (fileName_2 && imageSrc) {
+                var staticFileName = fileName.toLowerCase();
+                var staticInentifierName = fileNameManager.generateUniqueIdentifier("static_".concat(staticFileName.split('.')[0]));
+                if (fileName && imageSrc) {
                     var func = t__namespace.jSXExpressionContainer(t__namespace.identifier(staticInentifierName));
                     // const func = t.jSXExpressionContainer(
                     //   t.callExpression(t.identifier('require'), [
                     //     t.stringLiteral(`./images/${staticFileName}`),
                     //   ])
                     // );
-                    nodePath.node.value = fileName_2 ? func : null;
+                    nodePath.node.value = fileName ? func : null;
                     images.push({
                         url: imageSrc,
                         fileName: staticFileName,
@@ -674,10 +761,12 @@ var transformJsx = function (file, solution, outputPath) {
             if (componentType === 'Page' && solution === 'vite') {
                 var declaration = path.node.declaration;
                 // @ts-ignore
-                var withRouterCall = t__namespace.callExpression(t__namespace.identifier('withRouter'), [declaration]);
+                var withRouterCall = t__namespace.callExpression(t__namespace.identifier('withRouter'), [
+                    declaration,
+                ]);
                 path.node.declaration = withRouterCall;
             }
-        }
+        },
     });
     // 处理装饰器自动添加
     if (usesGlobalData && !hasGlobalDataDecorator && classDeclarationPath) {
@@ -730,7 +819,7 @@ var transformJsx = function (file, solution, outputPath) {
                     var base64String = svgToBase64(node.value);
                     path.replaceWith(t__namespace.stringLiteral(base64String));
                 }
-            }
+            },
         });
         if (isHaveSvg_1)
             code = generate__default["default"](astTree).code;
@@ -19537,7 +19626,7 @@ var createDataSourceCode = function (dataSourceConfig) {
             },
         }), ";\n");
     }
-    var code = "\n// \u517C\u5BB9\u6027\uFF1A\u4FDD\u7559\u65E7\u7684\u5168\u5C40\u6570\u636E API\uFF0C\u4F46\u4F7F\u7528\u65B0\u7684\u5168\u5C40\u6570\u636E\u5B58\u50A8\nimport { globalDataStore } from './globalData';\n".concat(dataSourceConfigCode, "\n// \u517C\u5BB9\u65E7\u7248\u672C\u7684 API\nexport const setGlobalData = (key, value) => globalDataStore.set(key, value);\nexport const getGlobalData = (key) => globalDataStore.get(key);\nexport const reloadGlobalData = (key, options) => globalDataStore.load(key, options);\nexport const globalDataSourceMap = globalDataStore.dataSourceMap;\n    ");
+    var code = "\n// \u517C\u5BB9\u6027\uFF1A\u4FDD\u7559\u65E7\u7684\u5168\u5C40\u6570\u636E API\uFF0C\u4F46\u4F7F\u7528\u65B0\u7684\u5168\u5C40\u6570\u636E\u5B58\u50A8\nimport { globalDataStore } from './globalData';\n".concat(dataSourceConfigCode, "\n// \u517C\u5BB9\u65E7\u7248\u672C\u7684 API\nexport const setGlobalData = (key, value) => globalDataStore.set(key, value);\nexport const getGlobalData = (key) => globalDataStore.get(key);\nexport const reloadGlobalData = (key, options) => globalDataStore.loadDataSource(key, options);\nexport const globalDataSourceMap = globalDataStore.dataSourceMap;\n    ");
     return code;
 };
 function wrapAsFunction$1(value, scope) {
@@ -19702,7 +19791,10 @@ var transformUtils = function (file, schema, project, solution, outputPath) {
             globalFunctionNames.add('getGlobalData');
             globalFunctionNames.add('reloadGlobalData');
             globalFunctionNames.add('globalDataSourceMap');
-            utilsFunctionNames.add('dataSource');
+            globalFunctionNames.add('renderComponent');
+            globalFunctionNames.add('showComponentModal');
+            globalFunctionNames.add('dataSource');
+            globalFunctionNames.add('_');
             body.splice(1, 0, t__namespace.importDeclaration(Array.from(utilsFunctionNames)
                 .filter(function (name) {
                 return !globalFunctionNames.has(name) &&
@@ -19711,9 +19803,7 @@ var transformUtils = function (file, schema, project, solution, outputPath) {
             })
                 .map(function (name) {
                 return t__namespace.importSpecifier(t__namespace.identifier(name), t__namespace.identifier(name));
-            }), t__namespace.stringLiteral(solution === 'vite'
-                ? '@appthen/utils'
-                : 'cross-ui/utils')));
+            }), t__namespace.stringLiteral(solution === 'vite' ? '@appthen/utils' : 'cross-ui/utils')));
             body.splice(2, 0, t__namespace.importDeclaration(['requestHandle'].map(function (name) {
                 return t__namespace.importSpecifier(t__namespace.identifier(name), t__namespace.identifier(name));
             }), t__namespace.stringLiteral('./dataSource')));
@@ -19739,7 +19829,9 @@ var transformUtils = function (file, schema, project, solution, outputPath) {
                         // 创建 VariableDeclarator 节点，表示 const Fuck = constants.Fuck
                         var variableDeclarator = t__namespace.variableDeclarator(t__namespace.identifier(util.name), memberExpression);
                         // 创建 VariableDeclaration 节点，表示 const Fuck 的声明
-                        var variableDeclaration = t__namespace.variableDeclaration('const', [variableDeclarator]);
+                        var variableDeclaration = t__namespace.variableDeclaration('const', [
+                            variableDeclarator,
+                        ]);
                         // 创建 ExportNamedDeclaration 节点，表示 export const Fuck
                         var exportNamedDeclaration = t__namespace.exportNamedDeclaration(variableDeclaration);
                         body.splice(4 + index, 0, exportNamedDeclaration);
@@ -19794,7 +19886,8 @@ var transformUtils = function (file, schema, project, solution, outputPath) {
     if (extendsCodes.length > 0) {
         code = extendsCodes.join('\n') + '\n' + code;
     }
-    code = code + "\n\nexport {\n  addPortal,\n  removePortal,\n  registerPartalComponent,\n  showComponentModal,\n  renderComponentPortal,\n  renderComponent,\n} from '@appthen/react';\n";
+    code =
+        "import {\n  addPortal,\n  removePortal,\n  registerPartalComponent,\n  showComponentModal,\n  renderComponentPortal,\n  renderComponent\n} from '@appthen/react';\n\nexport {\n  addPortal,\n  removePortal,\n  registerPartalComponent,\n  showComponentModal,\n  renderComponentPortal,\n  renderComponent,\n} from '@appthen/react';\n" + code;
     fs__namespace.writeFileSync(file.path + '/' + file.fileName, code);
     return { code: code };
 };
@@ -32909,30 +33002,21 @@ var createRouter = function (project) {
     if (!router || ((_a = router.routes) === null || _a === void 0 ? void 0 : _a.length) === 0) {
         return;
     }
-    // const router = {
-    //   routes: [
-    //     {
-    //       path: '/',
-    //       page: 'antdBackgroundManagementSystem',
-    //       children: [
-    //         {
-    //           path: '/dashboard',
-    //           page: 'dashboard',
-    //         },
-    //       ],
-    //     },
-    //     {
-    //       path: '/admin',
-    //       redirect: '/admin/fuck',
-    //     },
-    //     {
-    //       path: '/antdBackgroundManagementSystem',
-    //       page: 'antdBackgroundManagementSystem',
-    //     },
-    //   ],
-    // };
+    console.log('router: ', router.routes[0]);
+    console.log('🔍 原始路由数据:', JSON.stringify(router.routes, null, 2));
+    // 保存调试数据到文件
+    var fs = require('fs');
+    try {
+        fs.writeFileSync('./router-debug.json', JSON.stringify({
+            routes: router.routes,
+            timestamp: new Date().toISOString(),
+        }, null, 2));
+        console.log('📝 路由调试数据已保存到 router-debug.json');
+    }
+    catch (error) {
+        console.log('⚠️ 无法保存调试数据:', error.message);
+    }
     var allPages = [];
-    // const routeElements: any[] = [];
     // 遍历router.routes，生成路由
     var checkRoutes = function (routes) {
         routes.forEach(function (route) {
@@ -32945,7 +33029,8 @@ var createRouter = function (project) {
         });
     };
     checkRoutes(router.routes);
-    var routeElements = router.routes.map(function (route) { return createNestedRoutes(route); });
+    // 处理路由结构，正确处理布局和嵌套路由
+    var routeElements = processRoutesWithLayout(router.routes);
     var fileLazyImports = allPages.map(function (_) {
         return createLazyImport(_, "./pages/".concat(_));
     });
@@ -32954,6 +33039,68 @@ var createRouter = function (project) {
         routeElements: routeElements,
     };
 };
+// 处理路由结构，正确处理布局和嵌套路由
+function processRoutesWithLayout(routes) {
+    var e_1, _a, e_2, _b;
+    var result = [];
+    console.log('🔧 开始处理路由结构...');
+    try {
+        for (var routes_1 = __values(routes), routes_1_1 = routes_1.next(); !routes_1_1.done; routes_1_1 = routes_1.next()) {
+            var route = routes_1_1.value;
+            console.log("\uD83D\uDCCD \u5904\u7406\u8DEF\u7531: ".concat(route.path, ", page: ").concat(route.page));
+            // 检查是否为独立路由
+            if (route.noLayout) {
+                console.log("  \uD83D\uDEAA \u72EC\u7ACB\u8DEF\u7531");
+                var routeElement = createNestedRoutesWithLayout(route);
+                result.push(routeElement);
+                continue;
+            }
+            // 检查是否为布局组件（有 children）
+            var isLayoutRoute = route.children && route.children.length > 0;
+            if (isLayoutRoute) {
+                console.log("  \uD83C\uDFE0 \u8BC6\u522B\u4E3A\u5E03\u5C40\u8DEF\u7531\uFF0C\u5B50\u8DEF\u7531\u6570\u91CF: ".concat(route.children.length));
+                // 创建布局路由，包含子路由
+                var layoutChildren = route.children
+                    .filter(function (child) { return !child.noLayout; }) // 过滤掉 noLayout 的子路由
+                    .map(function (child) { return createNestedRoutesWithLayout(child); });
+                var layoutElement = createNestedRoutesWithLayout(route, layoutChildren);
+                result.push(layoutElement);
+                // 处理 noLayout 的子路由，作为独立路由
+                var independentChildren = route.children.filter(function (child) { return child.noLayout; });
+                try {
+                    for (var independentChildren_1 = (e_2 = void 0, __values(independentChildren)), independentChildren_1_1 = independentChildren_1.next(); !independentChildren_1_1.done; independentChildren_1_1 = independentChildren_1.next()) {
+                        var independentChild = independentChildren_1_1.value;
+                        console.log("  \uD83D\uDEAA \u5904\u7406\u72EC\u7ACB\u5B50\u8DEF\u7531: ".concat(independentChild.path));
+                        var childElement = createNestedRoutesWithLayout(independentChild);
+                        result.push(childElement);
+                    }
+                }
+                catch (e_2_1) { e_2 = { error: e_2_1 }; }
+                finally {
+                    try {
+                        if (independentChildren_1_1 && !independentChildren_1_1.done && (_b = independentChildren_1.return)) _b.call(independentChildren_1);
+                    }
+                    finally { if (e_2) throw e_2.error; }
+                }
+            }
+            else {
+                // 普通路由
+                console.log("  \uD83D\uDCC4 \u5904\u7406\u666E\u901A\u8DEF\u7531");
+                var routeElement = createNestedRoutesWithLayout(route);
+                result.push(routeElement);
+            }
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (routes_1_1 && !routes_1_1.done && (_a = routes_1.return)) _a.call(routes_1);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    console.log("\u2705 \u8DEF\u7531\u5904\u7406\u5B8C\u6210\uFF0C\u751F\u6210 ".concat(result.length, " \u4E2A\u8DEF\u7531\u5143\u7D20"));
+    return result;
+}
 // Create a component with lazy loading
 function createLazyImport(varName, source) {
     var _varName = varName.slice(0, 1).toUpperCase() + varName.slice(1);
@@ -32965,17 +33112,18 @@ function createLazyImport(varName, source) {
 }
 // const indexLazyImport = createLazyImport('index', './pages/index');
 // 助手函数，用于创建<Route> JSX元素
-function createRoute(path, componentName, exact, children) {
+function createRoute(path, componentName, exact, children, isLayout) {
     if (exact === void 0) { exact = false; }
     if (children === void 0) { children = null; }
+    if (isLayout === void 0) { isLayout = false; }
     var props = [
         t__namespace.jsxAttribute(t__namespace.jsxIdentifier('path'), t__namespace.stringLiteral(path)),
     ];
     if (exact) {
         props.push(t__namespace.jsxAttribute(t__namespace.jsxIdentifier('exact')));
     }
-    var openingElement = t__namespace.jsxOpeningElement(t__namespace.jsxIdentifier('Route'), props, !children);
-    if (!componentName && !children) {
+    var openingElement = t__namespace.jsxOpeningElement(t__namespace.jsxIdentifier('Route'), props, !children && !isLayout);
+    if (!componentName && !children && !isLayout) {
         return t__namespace.jsxElement(openingElement, t__namespace.jsxClosingElement(t__namespace.jsxIdentifier('Route')), [], false);
     }
     // 添加component属性如果存在
@@ -33001,21 +33149,61 @@ function codeToAST(code) {
         return null;
     }
 }
-// 递归函数，为每个路由创建JSX节点，包括嵌套的子路由
-function createNestedRoutes(route) {
-    var children = [];
-    if (route.children) {
-        children = route.children.map(function (childRoute) {
-            return createNestedRoutes(childRoute);
-        });
-    }
+// 新的路由创建函数，处理实际的数据格式
+function createNestedRoutesWithLayout(route, children) {
+    console.log("  \uD83D\uDD27 \u521B\u5EFA\u8DEF\u7531\u5143\u7D20: ".concat(route.path, ", page: ").concat(route.page));
+    // 处理重定向路由
     if (route.redirect) {
+        console.log("    \u21AA\uFE0F \u91CD\u5B9A\u5411\u8DEF\u7531: ".concat(route.path, " -> ").concat(route.redirect));
         return codeToAST("<Route path=\"".concat(route.path, "\" element={<Navigate to=\"").concat(route.redirect, "\"/>}></Route>"));
-        // return createRedirect(route.redirect);
     }
-    return createRoute(route.path, route.page, route.exact, children);
+    // 如果传入了 children，说明这是一个布局路由
+    if (children && children.length > 0) {
+        console.log("    \uD83C\uDFE0 \u5E03\u5C40\u8DEF\u7531\uFF0C\u5305\u542B ".concat(children.length, " \u4E2A\u5B50\u8DEF\u7531"));
+        return createRoute(route.path, route.page || '', route.exact, children, true // isLayout = true
+        );
+    }
+    // 普通页面路由
+    console.log("    \uD83D\uDCC4 \u666E\u901A\u9875\u9762\u8DEF\u7531");
+    return createRoute(route.path, route.page || '', route.exact, null, false);
 }
 
+/**
+ * 创建详细的错误信息，包含代码片段和位置信息
+ */
+function createDetailedError(error, context) {
+    var operation = context.operation, _a = context.filePath, filePath = _a === void 0 ? './src/App.jsx' : _a, code = context.code, suggestion = context.suggestion;
+    var errorMessage = "".concat(operation, "\u5931\u8D25: ").concat(error.message);
+    if (error.loc) {
+        errorMessage += " (\u7B2C".concat(error.loc.line, "\u884C\u7B2C").concat(error.loc.column, "\u5217)");
+    }
+    console.error("\u274C ".concat(operation, "\u5931\u8D25:"), {
+        filePath: filePath,
+        error: error.message,
+        type: error.name || 'Error',
+        position: error.loc
+            ? "\u7B2C".concat(error.loc.line, "\u884C\u7B2C").concat(error.loc.column, "\u5217")
+            : '未知位置',
+        snippet: error.loc && code
+            ? (function () {
+                var lines = code.split('\n');
+                var errorLine = error.loc.line - 1;
+                var start = Math.max(0, errorLine - 2);
+                var end = Math.min(lines.length, errorLine + 3);
+                return lines
+                    .slice(start, end)
+                    .map(function (line, index) {
+                    var lineNum = start + index + 1;
+                    var marker = lineNum === error.loc.line ? '>>> ' : '    ';
+                    return "".concat(marker).concat(lineNum.toString().padStart(3), ": ").concat(line);
+                })
+                    .join('\n');
+            })()
+            : '无法获取代码片段',
+        suggestion: suggestion || '请检查代码语法和结构是否正确',
+    });
+    return new Error(errorMessage);
+}
 function manageImports(ast, imports) {
     // 记录需要处理的导入名称和包
     var targetImports = new Map(imports.map(function (imp) { return [imp.name, imp]; }));
@@ -33049,14 +33237,16 @@ function manageImports(ast, imports) {
             }
             // 移除原有的目标包导入声明
             path.remove();
-        }
+        },
     });
     // 添加新的导入到对应的包
     imports.forEach(function (imp) {
         if (!packageImports.has(imp.from)) {
             packageImports.set(imp.from, new Set());
         }
-        packageImports.get(imp.from).add(t__namespace.importSpecifier(t__namespace.identifier(imp.as || imp.name), t__namespace.identifier(imp.name)));
+        packageImports
+            .get(imp.from)
+            .add(t__namespace.importSpecifier(t__namespace.identifier(imp.as || imp.name), t__namespace.identifier(imp.name)));
     });
     // 第二遍：添加新的导入
     traverse__default["default"](ast, {
@@ -33066,21 +33256,49 @@ function manageImports(ast, imports) {
                 var _b = __read(_a, 2), source = _b[0], specifiers = _b[1];
                 if (specifiers.size > 0) {
                     // 找到第一个导入声明
-                    var firstImport = path.node.body.find(function (node) { return t__namespace.isImportDeclaration(node); });
-                    var insertIndex = firstImport ? path.node.body.indexOf(firstImport) : 0;
+                    var firstImport = path.node.body.find(function (node) {
+                        return t__namespace.isImportDeclaration(node);
+                    });
+                    var insertIndex = firstImport
+                        ? path.node.body.indexOf(firstImport)
+                        : 0;
                     path.node.body.splice(insertIndex, 0, t__namespace.importDeclaration(Array.from(specifiers), t__namespace.stringLiteral(source)));
                 }
             });
-        }
+        },
     });
 }
 var createAppFile = function (project, solution, outputPath) {
-    var _a, _b, _c, _d;
-    var appFile = fs__namespace.readFileSync('./src/App.jsx', 'utf8');
-    var astTree = parser__namespace.parse("".concat(appFile), {
-        sourceType: 'module',
-        plugins: ['jsx', 'typescript', 'decorators-legacy'],
-    });
+    var _a, _b, _c, _d, _e;
+    var appFile;
+    var astTree;
+    try {
+        appFile = fs__namespace.readFileSync('./src/App.jsx', 'utf8');
+    }
+    catch (error) {
+        console.error('❌ 读取 App.jsx 文件失败:', {
+            filePath: './src/App.jsx',
+            error: error.message,
+            suggestion: '请确保 src/App.jsx 文件存在且可读',
+        });
+        throw new Error("\u65E0\u6CD5\u8BFB\u53D6 App.jsx \u6587\u4EF6: ".concat(error.message));
+    }
+    try {
+        astTree = parser__namespace.parse("".concat(appFile), {
+            sourceType: 'module',
+            plugins: ['jsx', 'typescript', 'decorators-legacy'],
+        });
+    }
+    catch (error) {
+        throw createDetailedError(error, {
+            operation: 'App.jsx 文件解析',
+            code: appFile,
+            suggestion: '请检查 App.jsx 文件的语法是否正确，特别注意：\n' +
+                '- 是否有未闭合的标签或括号\n' +
+                '- 是否有未完成的变量声明（const/let/var）\n' +
+                '- 是否有语法错误的 JSX 表达式',
+        });
+    }
     astTree.program.body = astTree.program.body.filter(function (item) {
         var _a, _b, _c, _d;
         var isPageFile = item.type === 'VariableDeclaration' &&
@@ -33089,110 +33307,167 @@ var createAppFile = function (project, solution, outputPath) {
         return !isPageFile;
     });
     // 添加路由
-    var router = createRouter(project);
-    if (router) {
-        var fileLazyImports_1 = router.fileLazyImports, routeElements_1 = router.routeElements;
-        traverse__default["default"](astTree, {
-            Program: function (nodePath) {
-                var body = nodePath.node.body;
-                var componentIndex = body.findIndex(function (item) { return item.type === 'ExportDefaultDeclaration'; });
-                body.splice.apply(body, __spreadArray([componentIndex, 0], __read(fileLazyImports_1), false));
-            },
-            JSXElement: function (nodePath) {
-                var _a, _b;
-                var node = nodePath.node;
-                // @ts-ignore
-                if (((_b = (_a = node.openingElement) === null || _a === void 0 ? void 0 : _a.name) === null || _b === void 0 ? void 0 : _b.name) === 'Routes') {
-                    node.children = routeElements_1;
-                }
-            },
+    try {
+        var router = createRouter(project);
+        if (router) {
+            var fileLazyImports_1 = router.fileLazyImports, routeElements_1 = router.routeElements;
+            traverse__default["default"](astTree, {
+                Program: function (nodePath) {
+                    var body = nodePath.node.body;
+                    var componentIndex = body.findIndex(function (item) { return item.type === 'ExportDefaultDeclaration'; });
+                    body.splice.apply(body, __spreadArray([componentIndex, 0], __read(fileLazyImports_1), false));
+                },
+                JSXElement: function (nodePath) {
+                    var _a, _b;
+                    var node = nodePath.node;
+                    // @ts-ignore
+                    if (((_b = (_a = node.openingElement) === null || _a === void 0 ? void 0 : _a.name) === null || _b === void 0 ? void 0 : _b.name) === 'Routes') {
+                        node.children = routeElements_1;
+                    }
+                },
+            });
+            console.log('✅ 路由配置已添加');
+        }
+    }
+    catch (error) {
+        console.error('❌ 路由处理失败:', {
+            error: error.message,
+            type: error.name || 'RouterError',
+            suggestion: '请检查项目配置中的路由信息是否正确',
         });
+        throw new Error("\u8DEF\u7531\u5904\u7406\u5931\u8D25: ".concat(error.message));
     }
     // 增加全局配置
     var schema = project.schema;
     var config = schema.config;
     if ((_a = config === null || config === void 0 ? void 0 : config.layout) === null || _a === void 0 ? void 0 : _a.componentName) {
-        var _e = config.layout, componentName = _e.componentName, props_1 = _e.props;
-        var code_1 = "\n      <".concat(componentName, "\n        ").concat(Object.keys(props_1 || {})
-            .map(function (k) {
-            var valueStr = '';
-            if (typeof props_1[k] === 'string') {
-                valueStr = "'".concat(props_1[k], "'");
-            }
-            else if (typeof props_1[k] === 'number') {
-                valueStr = "".concat(props_1[k]);
-            }
-            else if (typeof props_1[k] === 'object') {
-                valueStr = "{".concat(JSON.stringify(props_1[k]), "}");
-            }
-            return "".concat(k, "=").concat(valueStr);
-        })
-            .join('\n'), "\n      ><AntdApp></AntdApp></").concat(componentName, ">\n    ");
-        var layoutAstNode = codeToAST(code_1);
-        var elNode_1 = layoutAstNode.expression;
-        /**
-         * 找到 AntdApp 下的 HashRouter 节点
-         */
-        var routerNode_1;
-        traverse__default["default"](astTree, {
-            JSXElement: function (nodePath) {
-                var _a, _b;
-                var node = nodePath.node;
-                // @ts-ignore
-                if (((_b = (_a = node.openingElement) === null || _a === void 0 ? void 0 : _a.name) === null || _b === void 0 ? void 0 : _b.name) === 'HashRouter') {
-                    routerNode_1 = nodePath;
+        try {
+            var _f = config.layout, componentName = _f.componentName, props_1 = _f.props;
+            var code = "\n        <".concat(componentName, "\n          ").concat(Object.keys(props_1 || {})
+                .map(function (k) {
+                var valueStr = '';
+                if (typeof props_1[k] === 'string') {
+                    valueStr = "'".concat(props_1[k], "'");
                 }
-            },
-        });
-        var once_1 = false;
-        traverse__default["default"](astTree, {
-            JSXElement: function (nodePath) {
-                var _a, _b, _c, _d;
-                var node = nodePath.node;
-                // @ts-ignore
-                if (((_b = (_a = node.openingElement) === null || _a === void 0 ? void 0 : _a.name) === null || _b === void 0 ? void 0 : _b.name) === 'ConfigProvider' && !once_1) {
-                    if (appFile.includes('<AntdApp>') && routerNode_1) {
-                        // @ts-ignore
-                        elNode_1.children[0].children = routerNode_1.parent.children;
+                else if (typeof props_1[k] === 'number') {
+                    valueStr = "".concat(props_1[k]);
+                }
+                else if (typeof props_1[k] === 'object') {
+                    valueStr = "{".concat(JSON.stringify(props_1[k]), "}");
+                }
+                return "".concat(k, "=").concat(valueStr);
+            })
+                .join('\n'), "\n        ><AntdApp></AntdApp></").concat(componentName, ">\n      ");
+            var layoutAstNode = codeToAST(code);
+            var elNode_1 = layoutAstNode.expression;
+            /**
+             * 找到 AntdApp 下的 HashRouter 节点
+             */
+            var routerNode_1;
+            traverse__default["default"](astTree, {
+                JSXElement: function (nodePath) {
+                    var _a, _b;
+                    var node = nodePath.node;
+                    // @ts-ignore
+                    if (((_b = (_a = node.openingElement) === null || _a === void 0 ? void 0 : _a.name) === null || _b === void 0 ? void 0 : _b.name) === 'HashRouter') {
+                        routerNode_1 = nodePath;
                     }
-                    else {
-                        // @ts-ignore
-                        elNode_1.children[0].children = node.children;
+                },
+            });
+            var once_1 = false;
+            traverse__default["default"](astTree, {
+                JSXElement: function (nodePath) {
+                    var _a, _b, _c, _d;
+                    var node = nodePath.node;
+                    // @ts-ignore
+                    if (((_b = (_a = node.openingElement) === null || _a === void 0 ? void 0 : _a.name) === null || _b === void 0 ? void 0 : _b.name) === 'ConfigProvider' && !once_1) {
+                        if (appFile.includes('<AntdApp>') && routerNode_1) {
+                            // @ts-ignore
+                            elNode_1.children[0].children = routerNode_1.parent.children;
+                        }
+                        else {
+                            // @ts-ignore
+                            elNode_1.children[0].children = node.children;
+                        }
+                        nodePath.replaceWith(elNode_1);
+                        once_1 = true;
                     }
-                    nodePath.replaceWith(elNode_1);
-                    once_1 = true;
-                }
-                // @ts-ignore
-                if (((_d = (_c = node.openingElement) === null || _c === void 0 ? void 0 : _c.name) === null || _d === void 0 ? void 0 : _d.name) === 'HashRouter' && !once_1) {
                     // @ts-ignore
-                    elNode_1.children[0].children = [node];
-                    nodePath.replaceWith(elNode_1);
-                    once_1 = true;
-                }
-            },
-        });
+                    if (((_d = (_c = node.openingElement) === null || _c === void 0 ? void 0 : _c.name) === null || _d === void 0 ? void 0 : _d.name) === 'HashRouter' && !once_1) {
+                        // @ts-ignore
+                        elNode_1.children[0].children = [node];
+                        nodePath.replaceWith(elNode_1);
+                        once_1 = true;
+                    }
+                },
+            });
+            console.log('✅ 布局配置已添加');
+        }
+        catch (error) {
+            console.error('❌ 布局配置处理失败:', {
+                error: error.message,
+                type: error.name || 'LayoutError',
+                componentName: (_b = config === null || config === void 0 ? void 0 : config.layout) === null || _b === void 0 ? void 0 : _b.componentName,
+                suggestion: '请检查布局组件配置是否正确，包括组件名称和属性',
+            });
+            throw new Error("\u5E03\u5C40\u914D\u7F6E\u5904\u7406\u5931\u8D25: ".concat(error.message));
+        }
     }
     // 处理导入语句
-    if ((_d = (_c = (_b = project.schema) === null || _b === void 0 ? void 0 : _b.config) === null || _c === void 0 ? void 0 : _c.layout) === null || _d === void 0 ? void 0 : _d.componentName) {
-        var requiredImports = [
-            {
-                name: 'App',
-                as: 'AntdApp',
-                from: 'antd',
-                priority: 2,
-                protected: true // App 必须从 antd 导入
-            },
-            {
-                name: 'ConfigProvider',
-                from: '@appthen/antd',
-                priority: 1
-            }
-        ];
-        manageImports(astTree, requiredImports);
+    if ((_e = (_d = (_c = project.schema) === null || _c === void 0 ? void 0 : _c.config) === null || _d === void 0 ? void 0 : _d.layout) === null || _e === void 0 ? void 0 : _e.componentName) {
+        try {
+            var requiredImports = [
+                {
+                    name: 'App',
+                    as: 'AntdApp',
+                    from: 'antd',
+                    priority: 2,
+                    protected: true, // App 必须从 antd 导入
+                },
+                {
+                    name: 'ConfigProvider',
+                    from: '@appthen/antd',
+                    priority: 1,
+                },
+            ];
+            manageImports(astTree, requiredImports);
+            console.log('✅ 导入语句已处理');
+        }
+        catch (error) {
+            console.error('❌ 导入语句处理失败:', {
+                error: error.message,
+                type: error.name || 'ImportError',
+                suggestion: '请检查导入配置是否正确，确保相关包已安装',
+            });
+            throw new Error("\u5BFC\u5165\u8BED\u53E5\u5904\u7406\u5931\u8D25: ".concat(error.message));
+        }
+    }
+    var generatedCode;
+    try {
+        var result = generate__default["default"](astTree);
+        generatedCode = result.code;
+    }
+    catch (error) {
+        console.error('❌ 代码生成失败:', {
+            error: error.message,
+            type: error.name || 'GenerateError',
+            suggestion: '请检查 AST 结构是否正确，可能是在处理过程中产生了无效的 AST 节点',
+        });
+        throw new Error("\u4EE3\u7801\u751F\u6210\u5931\u8D25: ".concat(error.message));
+    }
+    try {
+        // 删除之前的字符串处理逻辑
+        fs__namespace.writeFileSync('./src/App.jsx', generatedCode, 'utf8');
+        console.log('✅ App.jsx 文件已成功更新');
+    }
+    catch (error) {
+        console.error('❌ 写入 App.jsx 文件失败:', {
+            filePath: './src/App.jsx',
+            error: error.message,
+            suggestion: '请确保有写入权限，且磁盘空间充足',
+        });
+        throw new Error("\u5199\u5165 App.jsx \u6587\u4EF6\u5931\u8D25: ".concat(error.message));
     }
-    var code = generate__default["default"](astTree).code;
-    // 删除之前的字符串处理逻辑
-    fs__namespace.writeFileSync('./src/App.jsx', code, 'utf8');
 };
 
 var writePackageJSON = function (packageJSON) {
@@ -36715,11 +36990,11 @@ var lastTimeKey$1 = '$__cacheTime';
  * @returns {Promise<number>} 错误码
  */
 function run(args, options) {
-    var _a, _b, _c, _d;
+    var _a, _b, _c, _d, _e, _f;
     return __awaiter(this, void 0, void 0, function () {
-        var cacheDirPath, keyCacheDirPath, currentLastTimeKey, cacheTime, afterTime, result, schema, project, documents, componentDocs, packageJSON, projectDocuments, projectDocumentNames_1, subPageDocumentNames_1, clientType, isWeb, solution, outputPath_1, builder, envInfoItem, generatedSourceCodes, publisher, subPageRoot_1, subPagePath, subPagePathIsExist, getPageUrl_1, transformFilePath, existFiles, existSubFiles, _e, files, syncMap, _loop_1, i, indexPage_1, indexPageUrl_1, globalStyle, globalStyleWithoutFirstLine, globalStyle, globalStyleWithoutFirstLine, appContent, appContentWithImport, portalImportCode, haveUpdate, installCmd, e_1;
-        return __generator(this, function (_f) {
-            switch (_f.label) {
+        var cacheDirPath, keyCacheDirPath, currentLastTimeKey, cacheTime, afterTime, result, schema, project, documents, componentDocs, packageJSON, projectDocuments, projectDocumentNames_1, subPageDocumentNames_1, clientType, isWeb, solution, outputPath_1, builder, envInfoItem, schemaStr, generatedSourceCodes, publisher, subPageRoot_1, subPagePath, subPagePathIsExist, getPageUrl_1, transformFilePath, existFiles, existSubFiles, _g, files, syncMap, _loop_1, i, indexPage_1, indexPageUrl_1, globalStyle, globalStyleWithoutFirstLine, globalStyle, globalStyleWithoutFirstLine, appContent, appContentWithImport, utilsFilePath, portalImportCode, haveUpdate, installCmd, e_1;
+        return __generator(this, function (_h) {
+            switch (_h.label) {
                 case 0:
                     cacheDirPath = path__default["default"].join(os__default["default"].homedir(), '.cache', 'mengti_temp');
                     keyCacheDirPath = path__default["default"].join(os__default["default"].homedir(), '.cache', 'mengti_translate');
@@ -36728,9 +37003,9 @@ function run(args, options) {
                         removeDir(keyCacheDirPath);
                     }
                     currentLastTimeKey = path__default["default"].join(process.cwd() + '/' + (options.output || '')) + lastTimeKey$1;
-                    _f.label = 1;
+                    _h.label = 1;
                 case 1:
-                    _f.trys.push([1, 15, , 16]);
+                    _h.trys.push([1, 15, , 16]);
                     cacheTime = cache$1.getKey(currentLastTimeKey);
                     console.log('[最后同步时间] ', cacheTime ? new Date(Number(cacheTime)).toLocaleString() : '无');
                     afterTime = cacheTime && !options.clear ? Number(cacheTime) : 0;
@@ -36746,13 +37021,16 @@ function run(args, options) {
                             afterTime: afterTime,
                         })];
                 case 2:
-                    result = _f.sent();
+                    result = _h.sent();
                     console.log('[INFO] 项目下载完成... ');
                     schema = result.schema;
+                    console.log('🔍 原始路由数据:', 
+                    // @ts-ignore
+                    JSON.stringify((_a = schema.router) === null || _a === void 0 ? void 0 : _a.routes, null, 2));
                     project = result.project, documents = result.documents, componentDocs = result.componentDocs, packageJSON = result.packageJSON;
                     projectDocuments = project.documents || [];
                     projectDocumentNames_1 = projectDocuments.map(function (_) { return _.fileName; });
-                    subPageDocumentNames_1 = ((_a = project.appConfig) === null || _a === void 0 ? void 0 : _a.subPages) || [];
+                    subPageDocumentNames_1 = ((_b = project.appConfig) === null || _b === void 0 ? void 0 : _b.subPages) || [];
                     clientType = options.frame || (project === null || project === void 0 ? void 0 : project.type);
                     isWeb = clientType === 'web';
                     solution = isWeb ? 'vite' : 'taro';
@@ -36761,7 +37039,7 @@ function run(args, options) {
                     return [4 /*yield*/, updateProjectTemplate(solution)];
                 case 3:
                     // 更新项目模板
-                    _f.sent();
+                    _h.sent();
                     console.log('[INFO] 项目模板更新完成... ');
                     // 检查是否有文件需要更新
                     if (!project || documents.length === 0) {
@@ -36777,20 +37055,21 @@ function run(args, options) {
                     console.log('[INFO] 创建项目构建器... ');
                     // 处理环境配置
                     if (options.env) {
-                        envInfoItem = (_c = (_b = project.envInfo) === null || _b === void 0 ? void 0 : _b.list) === null || _c === void 0 ? void 0 : _c.find(function (_) { return _.alias === options.env; });
+                        envInfoItem = (_d = (_c = project.envInfo) === null || _c === void 0 ? void 0 : _c.list) === null || _d === void 0 ? void 0 : _d.find(function (_) { return _.alias === options.env; });
                         if (envInfoItem) {
                             schema.constants = __assign(__assign({}, schema.constants), getPureValue(envInfoItem.data));
                         }
                     }
                     console.log('[INFO] 处理环境配置... ');
-                    // const schemaStr = JSON.stringify(schema);
+                    schemaStr = JSON.stringify((_e = schema.componentsTree) === null || _e === void 0 ? void 0 : _e.slice(0, 20).map(function (item) { return item.fileName; }));
+                    console.log('schemaStr: ', schemaStr);
                     // const isHaveCheckicon = schemaStr.indexOf('icon.style');
                     // console.log('isHaveCheck', schemaStr.slice(isHaveCheckicon - 20000, isHaveCheckicon + 20000));
                     // 生成代码
                     console.log('[INFO] 开始生成代码... ');
-                    return [4 /*yield*/, builder.generateProject(schema)];
+                    return [4 /*yield*/, builder.generateProject(JSON.parse(JSON.stringify(schema)))];
                 case 4:
-                    generatedSourceCodes = _f.sent();
+                    generatedSourceCodes = _h.sent();
                     console.log('[INFO] 代码生成完成... ');
                     generatedSourceCodes.files = generatedSourceCodes.files.filter(function (item) { return item.ext === 'css' || item.ext === 'jsx'; });
                     console.log('[INFO] 过滤代码... ');
@@ -36807,7 +37086,7 @@ function run(args, options) {
                             createProjectFolder: false,
                         })];
                 case 5:
-                    _f.sent();
+                    _h.sent();
                     console.log('[INFO] 代码生成完成... ');
                     if (!fs.existsSync("./".concat(outputPath_1, "/"))) {
                         fs.mkdirSync("./".concat(outputPath_1, "/"), {
@@ -36833,27 +37112,29 @@ function run(args, options) {
                         return "".concat(pagesPath, "/").concat(file.name, "/index");
                     };
                     transformFilePath = function (file) {
-                        if (subPageRoot_1 && file.path.includes('pages') && subPageDocumentNames_1.includes(file.name)) {
+                        if (subPageRoot_1 &&
+                            file.path.includes('pages') &&
+                            subPageDocumentNames_1.includes(file.name)) {
                             return file.path.replace('pages', subPageRoot_1);
                         }
                         return file.path;
                     };
                     return [4 /*yield*/, getAllFile("./".concat(outputPath_1, "/"))];
                 case 6:
-                    existFiles = _f.sent();
+                    existFiles = _h.sent();
                     if (!subPagePathIsExist) return [3 /*break*/, 8];
                     return [4 /*yield*/, getAllFile(subPagePath)];
                 case 7:
-                    _e = _f.sent();
+                    _g = _h.sent();
                     return [3 /*break*/, 9];
                 case 8:
-                    _e = [];
-                    _f.label = 9;
+                    _g = [];
+                    _h.label = 9;
                 case 9:
-                    existSubFiles = _e;
+                    existSubFiles = _g;
                     return [4 /*yield*/, getAllFile(cacheDirPath + '/')];
                 case 10:
-                    files = _f.sent();
+                    files = _h.sent();
                     syncMap = {
                         components: existFiles
                             .filter(function (_) { return ['tsx', 'jsx'].includes(_.ext) && _.path.includes('components'); })
@@ -36905,12 +37186,17 @@ function run(args, options) {
                             .map(function (_) { return getPageUrl_1(_, subPageRoot_1); }),
                     };
                     _loop_1 = function (i) {
-                        var file, fileName_1, extName, cssFilePath, cssStr, doc, _g, code, images, svgs, configJsCode, iconsFile, iconsConsts, index, svg, index, image, e_2, realFilePath;
-                        return __generator(this, function (_h) {
-                            switch (_h.label) {
+                        var file, fileName_1, extName, cssFilePath, cssStr, doc, _j, code, images, svgs, configJsCode, iconsFile, iconsConsts, index, svg, index, image, e_2, realFilePath;
+                        return __generator(this, function (_k) {
+                            switch (_k.label) {
                                 case 0:
                                     file = files[i];
-                                    console.log('[BUILD FILE]', file.name);
+                                    if (process.env.DEV) {
+                                        console.log('[BUILD FILE]', file);
+                                    }
+                                    else {
+                                        console.log('[BUILD FILE]', file.name);
+                                    }
                                     if (!!file.path.includes('/BasicLayout/')) return [3 /*break*/, 10];
                                     fileName_1 = file.name;
                                     extName = file.ext;
@@ -36919,8 +37205,8 @@ function run(args, options) {
                                     if (!(file.fileName === 'utils.js')) return [3 /*break*/, 2];
                                     return [4 /*yield*/, transformUtils(file, schema, project, solution)];
                                 case 1:
-                                    _h.sent();
-                                    _h.label = 2;
+                                    _k.sent();
+                                    _k.label = 2;
                                 case 2:
                                     if (extName === 'css' || extName === 'scss') {
                                         cssFilePath = file.path + '/' + file.fileName;
@@ -36945,15 +37231,18 @@ function run(args, options) {
                                     }
                                     if (!(extName === 'jsx' || extName === 'tsx')) return [3 /*break*/, 10];
                                     doc = documents.concat(componentDocs).find(function (_) {
+                                        console.log('fileName: ', fileName_1, _.fileName);
                                         return _.fileName.toLowerCase() === fileName_1.toLowerCase();
                                     });
                                     // 判断是否是页面
                                     if ((doc === null || doc === void 0 ? void 0 : doc.type) === 'Page') {
-                                        if (!syncMap.pages.includes(fileName_1) && !subPageDocumentNames_1.includes(fileName_1)) {
+                                        if (!syncMap.pages.includes(fileName_1) &&
+                                            !subPageDocumentNames_1.includes(fileName_1)) {
                                             syncMap.pages.push(fileName_1);
                                             syncMap.pageUrls.push(getPageUrl_1(file));
                                         }
-                                        if (!syncMap.subPages.includes(fileName_1) && subPageDocumentNames_1.includes(fileName_1)) {
+                                        if (!syncMap.subPages.includes(fileName_1) &&
+                                            subPageDocumentNames_1.includes(fileName_1)) {
                                             syncMap.subPages.push(fileName_1);
                                             syncMap.subPageUrls.push(getPageUrl_1(file, subPageRoot_1));
                                         }
@@ -36966,7 +37255,7 @@ function run(args, options) {
                                     }
                                     return [4 /*yield*/, transformJsx(file, solution, outputPath_1)];
                                 case 3:
-                                    _g = _h.sent(), code = _g.code, images = _g.images, svgs = _g.svgs;
+                                    _j = _k.sent(), code = _j.code, images = _j.images, svgs = _j.svgs;
                                     console.log('[BUILD SUCCESS]', file.name);
                                     // 写入暂存文件夹
                                     fs.writeFileSync(file.path + '/' + file.fileName, code);
@@ -37012,30 +37301,32 @@ function run(args, options) {
                                             .join('\n'));
                                     }
                                     index = 0;
-                                    _h.label = 4;
+                                    _k.label = 4;
                                 case 4:
                                     if (!(index < images.length)) return [3 /*break*/, 9];
                                     image = images[index];
                                     if (!(image.url && image.fileName)) return [3 /*break*/, 8];
-                                    _h.label = 5;
+                                    _k.label = 5;
                                 case 5:
-                                    _h.trys.push([5, 7, , 8]);
+                                    _k.trys.push([5, 7, , 8]);
                                     if (!fs.existsSync(file.path + '/images')) {
                                         fs.mkdirSync(file.path + '/images');
                                     }
                                     return [4 /*yield*/, downloadFile(image.url, file.path + '/images/' + image.fileName)];
                                 case 6:
-                                    _h.sent();
+                                    _k.sent();
                                     return [3 /*break*/, 8];
                                 case 7:
-                                    e_2 = _h.sent();
+                                    e_2 = _k.sent();
                                     console.log('[downloadFile Error] ', e_2);
                                     return [3 /*break*/, 8];
                                 case 8:
                                     index++;
                                     return [3 /*break*/, 4];
                                 case 9:
-                                    realFilePath = "./".concat(subPageDocumentNames_1.includes(file.name) ? outputPath_1 === null || outputPath_1 === void 0 ? void 0 : outputPath_1.replace('pages', subPageRoot_1) : outputPath_1, "/").concat(file.name);
+                                    realFilePath = "./".concat(subPageDocumentNames_1.includes(file.name)
+                                        ? outputPath_1 === null || outputPath_1 === void 0 ? void 0 : outputPath_1.replace('pages', subPageRoot_1)
+                                        : outputPath_1, "/").concat(file.name);
                                     if ((doc === null || doc === void 0 ? void 0 : doc.type) === 'Component') {
                                         realFilePath = "./".concat(outputPath_1, "/components/").concat(file.name);
                                     }
@@ -37043,32 +37334,35 @@ function run(args, options) {
                                     if (fs.existsSync(realFilePath)) {
                                         removeDir(realFilePath);
                                     }
+                                    console.log('realFilePath: ', realFilePath, doc === null || doc === void 0 ? void 0 : doc.fileName, doc === null || doc === void 0 ? void 0 : doc.type);
                                     if ((doc === null || doc === void 0 ? void 0 : doc.type) === 'Page') {
-                                        fs.copySync("".concat(cacheDirPath, "/src/pages/").concat(file.name), realFilePath);
+                                        console.log('realFilePath: ', realFilePath);
+                                        fs.copySync("".concat(cacheDirPath, "/src/pages/").concat(file.name), realFilePath.replace(file.name, doc.fileName));
                                     }
                                     if ((doc === null || doc === void 0 ? void 0 : doc.type) === 'Component') {
-                                        fs.copySync("".concat(cacheDirPath, "/src/components/").concat(file.name), realFilePath);
+                                        console.log('realFilePath1: ', realFilePath);
+                                        fs.copySync("".concat(cacheDirPath, "/src/components/").concat(file.name), realFilePath.replace(file.name, doc.fileName));
                                     }
-                                    _h.label = 10;
+                                    _k.label = 10;
                                 case 10: return [2 /*return*/];
                             }
                         });
                     };
                     i = 0;
-                    _f.label = 11;
+                    _h.label = 11;
                 case 11:
                     if (!(i < files.length)) return [3 /*break*/, 14];
                     return [5 /*yield**/, _loop_1(i)];
                 case 12:
-                    _f.sent();
-                    _f.label = 13;
+                    _h.sent();
+                    _h.label = 13;
                 case 13:
                     i++;
                     return [3 /*break*/, 11];
                 case 14:
                     // 更新同步时间
                     cache$1.setKey(currentLastTimeKey, String(Date.now()));
-                    indexPage_1 = (_d = project.appConfig) === null || _d === void 0 ? void 0 : _d.indexPage;
+                    indexPage_1 = (_f = project.appConfig) === null || _f === void 0 ? void 0 : _f.indexPage;
                     if (indexPage_1) {
                         // 首页排序
                         syncMap.pages = syncMap.pages.sort(function (a, b) {
@@ -37120,11 +37414,21 @@ function run(args, options) {
                             fs.writeFileSync('./src/app.tsx', appContentWithImport);
                         }
                     }
+                    utilsFilePath = "".concat(cacheDirPath, "/src/utils.js");
+                    if (process.env.DEV) {
+                        console.log('[utilsFilePath]', utilsFilePath);
+                    }
                     // 生成 utils & constants
-                    fs.copyFileSync("".concat(cacheDirPath, "/src/utils.js"), './src/utils/utils.js');
+                    fs.copyFileSync(utilsFilePath, './src/utils/utils.js');
                     fs.copyFileSync("".concat(cacheDirPath, "/src/constants.js"), './src/utils/constants.js');
+                    if (process.env.DEV) {
+                        console.log('[Start CreatePartalImport]');
+                    }
                     portalImportCode = createPartalImport(project, outputPath_1, solution);
                     fs.writeFileSync('./src/utils/portal.js', portalImportCode);
+                    if (process.env.DEV) {
+                        console.log('[End CreatePartalImport]');
+                    }
                     if (!isWeb) {
                         // 小程序配置
                         genAppConfig(options.frame || project.type, project, syncMap);
@@ -37132,6 +37436,9 @@ function run(args, options) {
                     else {
                         createAppFile(project);
                     }
+                    if (process.env.DEV) {
+                        console.log('[End GenAppConfig]');
+                    }
                     haveUpdate = writePackageJSON(packageJSON);
                     if (haveUpdate) {
                         console.log('[INFO] package.json 文件已更新，将重新安装依赖');
@@ -37146,7 +37453,7 @@ function run(args, options) {
                     console.log("[INFO ".concat(new Date().toLocaleString(), "] \u4EE3\u7801\u589E\u91CF\u540C\u6B65\u5B8C\u6210"));
                     return [2 /*return*/, 0];
                 case 15:
-                    e_1 = _f.sent();
+                    e_1 = _h.sent();
                     console.log(chalk__default["default"].red(getErrorMessage(e_1) || "Unexpected error: ".concat(e_1)));
                     // 保存缓存
                     cache$1.removeKey(currentLastTimeKey);
@@ -40385,6 +40692,10 @@ function regExpEscape (s) {
 var ShadowSpace = /** @class */ (function () {
     function ShadowSpace(config) {
         this.contentCache = new Map(); // 内容缓存
+        // 🆕 文件监听相关
+        this.watcher = null;
+        this.changeListeners = new Set();
+        this.isWatching = false;
         this.config = __assign({ spaceId: 'default', ignorePatterns: [
                 'node_modules/**',
                 '.git/**',
@@ -40425,6 +40736,8 @@ var ShadowSpace = /** @class */ (function () {
                 '.php',
                 '.rb',
                 '.swift',
+                '.flow',
+                '.draw',
                 '.kt',
                 '.data', // 添加 .data 扩展名支持
             ] }, config);
@@ -40504,7 +40817,7 @@ var ShadowSpace = /** @class */ (function () {
     ShadowSpace.prototype.syncFromEditor = function (projectFiles) {
         var _a;
         return __awaiter(this, void 0, void 0, function () {
-            var newFiles, projectFiles_1, projectFiles_1_1, file, localHash, size, now, e_1_1, _b, _c, _d, filePath, fileEntry, allFiles, totalFilesCount, totalSizeSum;
+            var newFiles, projectFiles_1, projectFiles_1_1, file, size, now, fullPath, writtenContent, localHash, remoteHash, e_1_1, _b, _c, _d, filePath, fileEntry, allFiles, totalFilesCount, totalSizeSum;
             var e_1, _e, e_2, _f;
             return __generator(this, function (_g) {
                 switch (_g.label) {
@@ -40513,61 +40826,69 @@ var ShadowSpace = /** @class */ (function () {
                         newFiles = {};
                         _g.label = 1;
                     case 1:
-                        _g.trys.push([1, 6, 7, 8]);
+                        _g.trys.push([1, 7, 8, 9]);
                         projectFiles_1 = __values(projectFiles), projectFiles_1_1 = projectFiles_1.next();
                         _g.label = 2;
                     case 2:
-                        if (!!projectFiles_1_1.done) return [3 /*break*/, 5];
+                        if (!!projectFiles_1_1.done) return [3 /*break*/, 6];
                         file = projectFiles_1_1.value;
                         if (this.shouldIgnoreFile(file.path)) {
                             console.log("[ShadowSpace] \u6587\u4EF6\u88AB\u5FFD\u7565: ".concat(file.path));
-                            return [3 /*break*/, 4];
+                            return [3 /*break*/, 5];
                         }
-                        localHash = this.calculateHash(file.content);
                         size = Buffer.byteLength(file.content, 'utf8');
                         now = Date.now();
                         // 记录空内容文件
                         if (file.content === '') {
                             console.log("[ShadowSpace] \u68C0\u6D4B\u5230\u7A7A\u5185\u5BB9\u6587\u4EF6: ".concat(file.path, " (size: ").concat(size, ")"));
                         }
+                        // 写入本地文件
+                        return [4 /*yield*/, this.writeLocalFile(file.path, file.content)];
+                    case 3:
+                        // 写入本地文件
+                        _g.sent();
+                        fullPath = path__default["default"].join(this.config.projectRoot, file.path);
+                        return [4 /*yield*/, fs__default$1["default"].readFile(fullPath, 'utf8')];
+                    case 4:
+                        writtenContent = _g.sent();
+                        localHash = this.calculateHash(writtenContent);
+                        remoteHash = file.hash || localHash;
                         newFiles[file.path] = {
                             path: file.path,
                             hash: localHash,
-                            remoteHash: file.hash || localHash,
+                            remoteHash: remoteHash,
                             size: size,
                             lastSyncTime: now,
                             lastModified: file.modify || now,
                             version: ((_a = this.state.files[file.path]) === null || _a === void 0 ? void 0 : _a.version) + 1 || 1,
                             mtime: now,
+                            remoteModified: true,
+                            remoteModifiedTime: now,
                         };
                         console.log("[ShadowSpace] \u540C\u6B65\u6587\u4EF6: ".concat(file.path), {
+                            remoteHash: remoteHash.substring(0, 16),
                             localHash: localHash.substring(0, 16),
-                            remoteHash: (file.hash || localHash).substring(0, 16),
                             size: size,
+                            version: newFiles[file.path].version,
                         });
-                        // 写入本地文件
-                        return [4 /*yield*/, this.writeLocalFile(file.path, file.content)];
-                    case 3:
-                        // 写入本地文件
-                        _g.sent();
                         // 缓存内容用于diff
-                        this.contentCache.set(file.path, file.content);
-                        _g.label = 4;
-                    case 4:
+                        this.contentCache.set(file.path, writtenContent);
+                        _g.label = 5;
+                    case 5:
                         projectFiles_1_1 = projectFiles_1.next();
                         return [3 /*break*/, 2];
-                    case 5: return [3 /*break*/, 8];
-                    case 6:
+                    case 6: return [3 /*break*/, 9];
+                    case 7:
                         e_1_1 = _g.sent();
                         e_1 = { error: e_1_1 };
-                        return [3 /*break*/, 8];
-                    case 7:
+                        return [3 /*break*/, 9];
+                    case 8:
                         try {
                             if (projectFiles_1_1 && !projectFiles_1_1.done && (_e = projectFiles_1.return)) _e.call(projectFiles_1);
                         }
                         finally { if (e_1) throw e_1.error; }
                         return [7 /*endfinally*/];
-                    case 8:
+                    case 9:
                         try {
                             // 合并文件记录，而不是替换
                             for (_b = __values(Object.entries(newFiles)), _c = _b.next(); !_c.done; _c = _b.next()) {
@@ -40593,11 +40914,11 @@ var ShadowSpace = /** @class */ (function () {
                         console.log("[ShadowSpace] \u66F4\u65B0\u540E\u7684\u6587\u4EF6\u7EDF\u8BA1:", {
                             totalFiles: totalFilesCount,
                             totalSize: totalSizeSum,
-                            fileList: Object.keys(this.state.files),
+                            // fileList: Object.keys(this.state.files),
                         });
                         this.state.lastUpdateTime = Date.now();
                         return [4 /*yield*/, this.saveState()];
-                    case 9:
+                    case 10:
                         _g.sent();
                         console.log("\u5F71\u5B50\u7A7A\u95F4\u540C\u6B65\u5B8C\u6210: ".concat(this.state.metadata.totalFiles, " \u4E2A\u6587\u4EF6"));
                         return [2 /*return*/];
@@ -40696,54 +41017,62 @@ var ShadowSpace = /** @class */ (function () {
      * 检测本地文件系统与影子空间的差异
      */
     ShadowSpace.prototype.detectChanges = function () {
+        var _a;
         return __awaiter(this, void 0, void 0, function () {
-            var changes, _a, _b, _c, filePath, shadowEntry, localFilePath, localContent, localHash, _d, _e, _f, shadowContent, _g, _h, error_2, shadowContent, e_3_1, localFiles, localFiles_1, localFiles_1_1, localFile;
-            var e_3, _j, _k, _l, e_4, _m;
-            return __generator(this, function (_o) {
-                switch (_o.label) {
+            var changes, _b, _c, _d, filePath, shadowEntry, localFilePath, localContent, localHash, _e, _f, _g, shadowContent, _h, _j, error_2, shadowContent, e_3_1, localFiles, localFiles_1, localFiles_1_1, localFile;
+            var e_3, _k, _l, _m, e_4, _o;
+            return __generator(this, function (_p) {
+                switch (_p.label) {
                     case 0:
                         changes = [];
-                        _o.label = 1;
+                        _p.label = 1;
                     case 1:
-                        _o.trys.push([1, 16, 17, 18]);
-                        _a = __values(Object.entries(this.state.files)), _b = _a.next();
-                        _o.label = 2;
+                        _p.trys.push([1, 16, 17, 18]);
+                        _b = __values(Object.entries(this.state.files)), _c = _b.next();
+                        _p.label = 2;
                     case 2:
-                        if (!!_b.done) return [3 /*break*/, 15];
-                        _c = __read(_b.value, 2), filePath = _c[0], shadowEntry = _c[1];
+                        if (!!_c.done) return [3 /*break*/, 15];
+                        _d = __read(_c.value, 2), filePath = _d[0], shadowEntry = _d[1];
                         localFilePath = path__default["default"].join(this.config.projectRoot, filePath);
-                        _o.label = 3;
+                        _p.label = 3;
                     case 3:
-                        _o.trys.push([3, 11, , 14]);
+                        _p.trys.push([3, 11, , 14]);
                         return [4 /*yield*/, fs__default$1["default"].readFile(localFilePath, 'utf8')];
                     case 4:
-                        localContent = _o.sent();
+                        localContent = _p.sent();
                         localHash = this.calculateHash(localContent);
                         if (!(localHash !== shadowEntry.hash)) return [3 /*break*/, 10];
+                        console.log("[ShadowSpace] \u68C0\u6D4B\u5230\u6587\u4EF6\u53D8\u66F4: ".concat(filePath), {
+                            localHash: localHash.substring(0, 16),
+                            shadowHash: shadowEntry.hash.substring(0, 16),
+                            remoteHash: ((_a = shadowEntry.remoteHash) === null || _a === void 0 ? void 0 : _a.substring(0, 16)) || 'undefined',
+                            remoteModified: shadowEntry.remoteModified || false,
+                            version: shadowEntry.version,
+                        });
                         if (!shadowEntry.remoteModified) return [3 /*break*/, 7];
                         // 如果是远程修改，先更新影子空间记录并清除远程修改标记
                         console.log("\u68C0\u6D4B\u5230\u8FDC\u7A0B\u4FEE\u6539\u6587\u4EF6\u7684\u672C\u5730\u53D8\u5316: ".concat(filePath));
                         // 更新影子空间记录
-                        _d = this.state.files;
-                        _e = filePath;
-                        _f = [__assign({}, shadowEntry)];
-                        _k = { hash: localHash };
+                        _e = this.state.files;
+                        _f = filePath;
+                        _g = [__assign({}, shadowEntry)];
+                        _l = { hash: localHash };
                         return [4 /*yield*/, fs__default$1["default"].stat(localFilePath)];
                     case 5:
-                        _k.size = (_o.sent()).size, _k.lastSyncTime = Date.now(), _k.version = shadowEntry.version + 1;
+                        _l.size = (_p.sent()).size, _l.lastSyncTime = Date.now(), _l.version = shadowEntry.version + 1;
                         return [4 /*yield*/, fs__default$1["default"].stat(localFilePath)];
                     case 6:
                         // 更新影子空间记录
-                        _d[_e] = __assign.apply(void 0, _f.concat([(_k.mtime = (_o.sent()).mtimeMs, _k.remoteModified = false, _k)]));
+                        _e[_f] = __assign.apply(void 0, _g.concat([(_l.mtime = (_p.sent()).mtimeMs, _l.remoteModified = false, _l)]));
                         // 如果本地内容与最初的远程内容不同，则认为是本地修改
                         // 这里我们简化处理：任何在远程修改基础上的本地变化都视为本地修改
                         console.log("\u6587\u4EF6 ".concat(filePath, " \u5728\u8FDC\u7A0B\u4FEE\u6539\u57FA\u7840\u4E0A\u53D1\u751F\u4E86\u672C\u5730\u53D8\u5316\uFF0C\u6807\u8BB0\u4E3A\u672C\u5730\u4FEE\u6539"));
-                        _o.label = 7;
+                        _p.label = 7;
                     case 7: return [4 /*yield*/, this.getShadowContent(filePath)];
                     case 8:
-                        shadowContent = _o.sent();
-                        _h = (_g = changes).push;
-                        _l = {
+                        shadowContent = _p.sent();
+                        _j = (_h = changes).push;
+                        _m = {
                             id: this.generateId(),
                             action: 'modify',
                             path: filePath,
@@ -40751,21 +41080,21 @@ var ShadowSpace = /** @class */ (function () {
                         };
                         return [4 /*yield*/, fs__default$1["default"].stat(localFilePath)];
                     case 9:
-                        _h.apply(_g, [(_l.timestamp = (_o.sent()).mtime.getTime(),
-                                _l.diff = {
+                        _j.apply(_h, [(_m.timestamp = (_p.sent()).mtime.getTime(),
+                                _m.diff = {
                                     before: shadowContent,
                                     after: localContent,
                                 },
-                                _l.projectId = this.state.projectId,
-                                _l)]);
-                        _o.label = 10;
+                                _m.projectId = this.state.projectId,
+                                _m)]);
+                        _p.label = 10;
                     case 10: return [3 /*break*/, 14];
                     case 11:
-                        error_2 = _o.sent();
+                        error_2 = _p.sent();
                         if (!(error_2.code === 'ENOENT')) return [3 /*break*/, 13];
                         return [4 /*yield*/, this.getShadowContent(filePath)];
                     case 12:
-                        shadowContent = _o.sent();
+                        shadowContent = _p.sent();
                         changes.push({
                             id: this.generateId(),
                             action: 'delete',
@@ -40778,25 +41107,25 @@ var ShadowSpace = /** @class */ (function () {
                             },
                             projectId: this.state.projectId,
                         });
-                        _o.label = 13;
+                        _p.label = 13;
                     case 13: return [3 /*break*/, 14];
                     case 14:
-                        _b = _a.next();
+                        _c = _b.next();
                         return [3 /*break*/, 2];
                     case 15: return [3 /*break*/, 18];
                     case 16:
-                        e_3_1 = _o.sent();
+                        e_3_1 = _p.sent();
                         e_3 = { error: e_3_1 };
                         return [3 /*break*/, 18];
                     case 17:
                         try {
-                            if (_b && !_b.done && (_j = _a.return)) _j.call(_a);
+                            if (_c && !_c.done && (_k = _b.return)) _k.call(_b);
                         }
                         finally { if (e_3) throw e_3.error; }
                         return [7 /*endfinally*/];
                     case 18: return [4 /*yield*/, this.scanLocalFiles()];
                     case 19:
-                        localFiles = _o.sent();
+                        localFiles = _p.sent();
                         try {
                             for (localFiles_1 = __values(localFiles), localFiles_1_1 = localFiles_1.next(); !localFiles_1_1.done; localFiles_1_1 = localFiles_1.next()) {
                                 localFile = localFiles_1_1.value;
@@ -40819,7 +41148,7 @@ var ShadowSpace = /** @class */ (function () {
                         catch (e_4_1) { e_4 = { error: e_4_1 }; }
                         finally {
                             try {
-                                if (localFiles_1_1 && !localFiles_1_1.done && (_m = localFiles_1.return)) _m.call(localFiles_1);
+                                if (localFiles_1_1 && !localFiles_1_1.done && (_o = localFiles_1.return)) _o.call(localFiles_1);
                             }
                             finally { if (e_4) throw e_4.error; }
                         }
@@ -40949,38 +41278,40 @@ var ShadowSpace = /** @class */ (function () {
      * 当编辑器通过WebSocket修改文件后调用此方法
      */
     ShadowSpace.prototype.markAsRemoteModified = function (filePaths) {
+        var _a;
         return __awaiter(this, void 0, void 0, function () {
-            var now, hasChanges, filePaths_1, filePaths_1_1, filePath, fullPath, stats, content, hash, existingFile, error_4, e_6_1;
-            var e_6, _a;
-            return __generator(this, function (_b) {
-                switch (_b.label) {
+            var now, hasChanges, filePaths_1, filePaths_1_1, filePath, fullPath, stats, content, hash, existingFile, remoteHash, error_4, e_6_1;
+            var e_6, _b;
+            return __generator(this, function (_c) {
+                switch (_c.label) {
                     case 0:
                         now = Date.now();
                         hasChanges = false;
-                        _b.label = 1;
+                        _c.label = 1;
                     case 1:
-                        _b.trys.push([1, 9, 10, 11]);
+                        _c.trys.push([1, 9, 10, 11]);
                         filePaths_1 = __values(filePaths), filePaths_1_1 = filePaths_1.next();
-                        _b.label = 2;
+                        _c.label = 2;
                     case 2:
                         if (!!filePaths_1_1.done) return [3 /*break*/, 8];
                         filePath = filePaths_1_1.value;
                         fullPath = path__default["default"].resolve(this.config.projectRoot, filePath);
-                        _b.label = 3;
+                        _c.label = 3;
                     case 3:
-                        _b.trys.push([3, 6, , 7]);
+                        _c.trys.push([3, 6, , 7]);
                         return [4 /*yield*/, fs__default$1["default"].stat(fullPath)];
                     case 4:
-                        stats = _b.sent();
+                        stats = _c.sent();
                         return [4 /*yield*/, fs__default$1["default"].readFile(fullPath, 'utf8')];
                     case 5:
-                        content = _b.sent();
+                        content = _c.sent();
                         hash = this.calculateHash(content);
                         existingFile = this.state.files[filePath];
+                        remoteHash = (existingFile === null || existingFile === void 0 ? void 0 : existingFile.remoteHash) || hash;
                         this.state.files[filePath] = {
                             path: filePath,
                             hash: hash,
-                            remoteHash: (existingFile === null || existingFile === void 0 ? void 0 : existingFile.remoteHash) || hash,
+                            remoteHash: remoteHash,
                             size: stats.size,
                             lastSyncTime: now,
                             lastModified: now,
@@ -40990,10 +41321,16 @@ var ShadowSpace = /** @class */ (function () {
                             remoteModifiedTime: now,
                         };
                         hasChanges = true;
-                        console.log("\u6807\u8BB0\u8FDC\u7A0B\u4FEE\u6539: ".concat(filePath, " (\u7248\u672C ").concat(this.state.files[filePath].version, ")"));
+                        console.log("[ShadowSpace] \u6807\u8BB0\u8FDC\u7A0B\u4FEE\u6539: ".concat(filePath), {
+                            版本: this.state.files[filePath].version,
+                            hash: hash.substring(0, 16),
+                            remoteHash: remoteHash.substring(0, 16),
+                            旧remoteHash: ((_a = existingFile === null || existingFile === void 0 ? void 0 : existingFile.remoteHash) === null || _a === void 0 ? void 0 : _a.substring(0, 16)) || 'undefined',
+                            remoteHashChanged: (existingFile === null || existingFile === void 0 ? void 0 : existingFile.remoteHash) !== remoteHash,
+                        });
                         return [3 /*break*/, 7];
                     case 6:
-                        error_4 = _b.sent();
+                        error_4 = _c.sent();
                         console.warn("\u6807\u8BB0\u8FDC\u7A0B\u4FEE\u6539\u5931\u8D25 ".concat(filePath, ":"), error_4);
                         return [3 /*break*/, 7];
                     case 7:
@@ -41001,12 +41338,12 @@ var ShadowSpace = /** @class */ (function () {
                         return [3 /*break*/, 2];
                     case 8: return [3 /*break*/, 11];
                     case 9:
-                        e_6_1 = _b.sent();
+                        e_6_1 = _c.sent();
                         e_6 = { error: e_6_1 };
                         return [3 /*break*/, 11];
                     case 10:
                         try {
-                            if (filePaths_1_1 && !filePaths_1_1.done && (_a = filePaths_1.return)) _a.call(filePaths_1);
+                            if (filePaths_1_1 && !filePaths_1_1.done && (_b = filePaths_1.return)) _b.call(filePaths_1);
                         }
                         finally { if (e_6) throw e_6.error; }
                         return [7 /*endfinally*/];
@@ -41015,9 +41352,9 @@ var ShadowSpace = /** @class */ (function () {
                         this.updateMetadata();
                         return [4 /*yield*/, this.saveState()];
                     case 12:
-                        _b.sent();
+                        _c.sent();
                         console.log("\u5DF2\u6807\u8BB0 ".concat(filePaths.length, " \u4E2A\u6587\u4EF6\u4E3A\u8FDC\u7A0B\u4FEE\u6539"));
-                        _b.label = 13;
+                        _c.label = 13;
                     case 13: return [2 /*return*/];
                 }
             });
@@ -41320,44 +41657,27 @@ var ShadowSpace = /** @class */ (function () {
         return "change_".concat(Date.now(), "_").concat(Math.random().toString(36).substr(2, 9));
     };
     ShadowSpace.prototype.shouldIgnoreFile = function (filePath) {
+        // console.log(`[ShadowSpace] shouldIgnoreFile 检查: "${filePath}"`);
         var e_10, _a;
-        console.log("[ShadowSpace] shouldIgnoreFile \u68C0\u67E5: ".concat(filePath), {
-            ignorePatterns: this.config.ignorePatterns,
-            includeExtensions: this.config.includeExtensions,
-        });
         // 特殊处理：过滤掉特定的系统文件
         var fileName = filePath.split('/').pop() || '';
         if (fileName === '.dirty_files.json') {
-            console.log("[ShadowSpace] \u7CFB\u7EDF\u6587\u4EF6\u88AB\u5FFD\u7565: ".concat(filePath));
             return true;
         }
         if (fileName === 'assets.json') {
-            console.log("[ShadowSpace] \u7CFB\u7EDF\u6587\u4EF6\u88AB\u5FFD\u7565: ".concat(filePath));
             return true;
         }
         if (fileName === 'project.json') {
-            console.log("[ShadowSpace] \u7CFB\u7EDF\u6587\u4EF6\u88AB\u5FFD\u7565: ".concat(filePath));
             return true;
         }
         if (fileName.endsWith('.doc')) {
-            console.log("[ShadowSpace] .doc\u6587\u4EF6\u88AB\u5FFD\u7565: ".concat(filePath));
             return true;
         }
-        // 目录白名单检查：只同步指定的目录
+        // 🔥 目录白名单检查：简化逻辑，允许 src/ 和 docs/ 下的所有文件
+        var isInSrc = filePath.startsWith('src/');
         var isInDocs = filePath.startsWith('docs/');
-        var isInSrcPages = filePath.startsWith('src/pages/');
-        var isInSrcModules = filePath.startsWith('src/modules/');
-        var isInSrcTypes = filePath.startsWith('src/types/');
-        var isInSrcUtils = filePath.startsWith('src/utils/');
-        var isInSrcComponents = filePath.startsWith('src/components/');
         var isRootConfig = filePath.match(/^[^\/]+\.(json|md|yml|yaml|toml|js|ts|py|go|rs)$/);
-        if (!isInDocs &&
-            !isInSrcPages &&
-            !isInSrcModules &&
-            !isInSrcTypes &&
-            !isInSrcUtils &&
-            !isInSrcComponents &&
-            !isRootConfig) {
+        if (!isInSrc && !isInDocs && !isRootConfig) {
             console.log("[ShadowSpace] \u6587\u4EF6\u4E0D\u5728\u767D\u540D\u5355\u76EE\u5F55\u4E2D: ".concat(filePath));
             return true;
         }
@@ -41392,7 +41712,7 @@ var ShadowSpace = /** @class */ (function () {
                 return true;
             }
         }
-        console.log("[ShadowSpace] \u6587\u4EF6\u901A\u8FC7\u5FFD\u7565\u68C0\u67E5: ".concat(filePath));
+        // console.log(`[ShadowSpace] 文件通过忽略检查: ${filePath}`);
         return false;
     };
     ShadowSpace.prototype.writeLocalFile = function (filePath, content) {
@@ -41557,15 +41877,328 @@ var ShadowSpace = /** @class */ (function () {
         var i = Math.floor(Math.log(bytes) / Math.log(k));
         return parseFloat((bytes / Math.pow(k, i)).toFixed(2)) + ' ' + sizes[i];
     };
+    // ==================== 🆕 文件监听功能 ====================
+    /**
+     * 启动文件监听
+     */
+    ShadowSpace.prototype.startWatching = function () {
+        var _this = this;
+        if (this.isWatching) {
+            console.log('[ShadowSpace] 文件监听已经在运行中');
+            return;
+        }
+        console.log('[ShadowSpace] 启动文件监听...');
+        console.log('[ShadowSpace] 监听目录:', this.config.projectRoot);
+        try {
+            // 🔥 使用轮询模式 + ignored 函数过滤
+            this.watcher = chokidar__default["default"].watch(this.config.projectRoot, {
+                ignored: function (filePath) {
+                    var relativePath = path__default["default"].relative(_this.config.projectRoot, filePath);
+                    // 忽略根目录本身
+                    if (!relativePath || relativePath === '.') {
+                        return true;
+                    }
+                    // 使用白名单过滤
+                    return _this.shouldIgnoreFile(relativePath);
+                },
+                persistent: true,
+                ignoreInitial: true,
+                usePolling: true,
+                interval: 2000,
+                binaryInterval: 3000,
+                depth: 99,
+                awaitWriteFinish: {
+                    stabilityThreshold: 500,
+                    pollInterval: 100,
+                },
+            });
+            console.log('[ShadowSpace] chokidar.watch 已调用，等待 ready 事件...');
+        }
+        catch (error) {
+            console.error('[ShadowSpace] 创建文件监听器失败:', error);
+            return;
+        }
+        this.watcher
+            .on('change', function (filePath) {
+            _this.onFileChanged(filePath);
+        })
+            .on('add', function (filePath) {
+            _this.onFileAdded(filePath);
+        })
+            .on('unlink', function (filePath) {
+            _this.onFileDeleted(filePath);
+        })
+            .on('error', function (error) {
+            console.error('[ShadowSpace] 文件监听错误:', error);
+        })
+            .on('ready', function () {
+            _this.isWatching = true;
+            console.log('[ShadowSpace] 文件监听已启动，正在监听:', _this.config.projectRoot);
+            console.log('[ShadowSpace] 监听配置: 轮询模式 (interval: 2s)');
+        });
+    };
+    /**
+     * 停止文件监听
+     */
+    ShadowSpace.prototype.stopWatching = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (!this.isWatching || !this.watcher) {
+                            console.log('[ShadowSpace] 文件监听未运行');
+                            return [2 /*return*/];
+                        }
+                        console.log('[ShadowSpace] 停止文件监听...');
+                        return [4 /*yield*/, this.watcher.close()];
+                    case 1:
+                        _a.sent();
+                        this.watcher = null;
+                        this.isWatching = false;
+                        console.log('[ShadowSpace] 文件监听已停止');
+                        return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /**
+     * 添加变更事件监听器
+     */
+    ShadowSpace.prototype.addChangeListener = function (listener) {
+        this.changeListeners.add(listener);
+    };
+    /**
+     * 移除变更事件监听器
+     */
+    ShadowSpace.prototype.removeChangeListener = function (listener) {
+        this.changeListeners.delete(listener);
+    };
+    /**
+     * 触发变更事件
+     */
+    ShadowSpace.prototype.emitChangeEvent = function (event) {
+        console.log('[ShadowSpace] 触发变更事件:', event);
+        this.changeListeners.forEach(function (listener) {
+            try {
+                listener(event);
+            }
+            catch (error) {
+                console.error('[ShadowSpace] 变更事件监听器执行失败:', error);
+            }
+        });
+    };
+    /**
+     * 文件变更处理
+     */
+    ShadowSpace.prototype.onFileChanged = function (filePath) {
+        return __awaiter(this, void 0, void 0, function () {
+            var relativePath, shadowEntry, content, hash, stats, error_13;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        relativePath = path__default["default"].relative(this.config.projectRoot, filePath);
+                        console.log("[ShadowSpace] \u68C0\u6D4B\u5230\u6587\u4EF6\u53D8\u66F4: ".concat(relativePath));
+                        shadowEntry = this.state.files[relativePath];
+                        if (!(shadowEntry === null || shadowEntry === void 0 ? void 0 : shadowEntry.remoteModified)) return [3 /*break*/, 2];
+                        console.log("[ShadowSpace] \u8DF3\u8FC7\u8FDC\u7A0B\u4FEE\u6539\u7684\u6587\u4EF6: ".concat(relativePath));
+                        shadowEntry.remoteModified = false; // 清除标记
+                        return [4 /*yield*/, this.saveState()];
+                    case 1:
+                        _a.sent();
+                        return [2 /*return*/];
+                    case 2:
+                        _a.trys.push([2, 5, , 6]);
+                        return [4 /*yield*/, fs__default$1["default"].readFile(filePath, 'utf8')];
+                    case 3:
+                        content = _a.sent();
+                        hash = this.calculateHash(content);
+                        return [4 /*yield*/, fs__default$1["default"].stat(filePath)];
+                    case 4:
+                        stats = _a.sent();
+                        // 🔑 推送变更事件
+                        this.emitChangeEvent({
+                            path: relativePath,
+                            action: 'modify',
+                            timestamp: Date.now(),
+                            source: 'local',
+                            hash: hash,
+                            size: stats.size,
+                        });
+                        return [3 /*break*/, 6];
+                    case 5:
+                        error_13 = _a.sent();
+                        console.error("[ShadowSpace] \u5904\u7406\u6587\u4EF6\u53D8\u66F4\u5931\u8D25: ".concat(relativePath), error_13);
+                        return [3 /*break*/, 6];
+                    case 6: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /**
+     * 文件新增处理
+     */
+    ShadowSpace.prototype.onFileAdded = function (filePath) {
+        return __awaiter(this, void 0, void 0, function () {
+            var relativePath, content, hash, stats, error_14;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        relativePath = path__default["default"].relative(this.config.projectRoot, filePath);
+                        console.log("[ShadowSpace] \u68C0\u6D4B\u5230\u6587\u4EF6\u65B0\u589E: ".concat(relativePath));
+                        _a.label = 1;
+                    case 1:
+                        _a.trys.push([1, 4, , 5]);
+                        return [4 /*yield*/, fs__default$1["default"].readFile(filePath, 'utf8')];
+                    case 2:
+                        content = _a.sent();
+                        hash = this.calculateHash(content);
+                        return [4 /*yield*/, fs__default$1["default"].stat(filePath)];
+                    case 3:
+                        stats = _a.sent();
+                        // 🔑 推送变更事件
+                        this.emitChangeEvent({
+                            path: relativePath,
+                            action: 'add',
+                            timestamp: Date.now(),
+                            source: 'local',
+                            hash: hash,
+                            size: stats.size,
+                        });
+                        return [3 /*break*/, 5];
+                    case 4:
+                        error_14 = _a.sent();
+                        console.error("[ShadowSpace] \u5904\u7406\u6587\u4EF6\u65B0\u589E\u5931\u8D25: ".concat(relativePath), error_14);
+                        return [3 /*break*/, 5];
+                    case 5: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /**
+     * 文件删除处理
+     */
+    ShadowSpace.prototype.onFileDeleted = function (filePath) {
+        return __awaiter(this, void 0, void 0, function () {
+            var relativePath, shadowEntry;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        relativePath = path__default["default"].relative(this.config.projectRoot, filePath);
+                        console.log("[ShadowSpace] \u68C0\u6D4B\u5230\u6587\u4EF6\u5220\u9664: ".concat(relativePath));
+                        shadowEntry = this.state.files[relativePath];
+                        if (!(shadowEntry === null || shadowEntry === void 0 ? void 0 : shadowEntry.remoteModified)) return [3 /*break*/, 2];
+                        console.log("[ShadowSpace] \u8DF3\u8FC7\u8FDC\u7A0B\u5220\u9664\u7684\u6587\u4EF6: ".concat(relativePath));
+                        shadowEntry.remoteModified = false; // 清除标记
+                        return [4 /*yield*/, this.saveState()];
+                    case 1:
+                        _a.sent();
+                        return [2 /*return*/];
+                    case 2:
+                        // 🔑 推送变更事件
+                        this.emitChangeEvent({
+                            path: relativePath,
+                            action: 'delete',
+                            timestamp: Date.now(),
+                            source: 'local',
+                        });
+                        return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /**
+     * 获取监听状态
+     */
+    ShadowSpace.prototype.isFileWatching = function () {
+        return this.isWatching;
+    };
     return ShadowSpace;
 }());
 
+/**
+ * 变更聚合器
+ * 将短时间内的多个文件变更聚合为一次批量推送，减少网络开销
+ */
+var ChangeAggregator = /** @class */ (function () {
+    function ChangeAggregator(spaceId, userId, handler, debounceMs) {
+        if (debounceMs === void 0) { debounceMs = 500; }
+        this.pendingChanges = new Map();
+        this.timer = null;
+        this.spaceId = spaceId;
+        this.userId = userId;
+        this.handler = handler;
+        this.debounceMs = debounceMs;
+    }
+    /**
+     * 添加变更
+     */
+    ChangeAggregator.prototype.addChange = function (change) {
+        var _this = this;
+        console.log("[ChangeAggregator] \u6DFB\u52A0\u53D8\u66F4: ".concat(change.path, " (").concat(change.action, ")"));
+        // 使用文件路径作为 key，相同文件的多次变更只保留最后一次
+        this.pendingChanges.set(change.path, change);
+        // 防抖：重置定时器
+        if (this.timer) {
+            clearTimeout(this.timer);
+        }
+        this.timer = setTimeout(function () {
+            _this.flush();
+        }, this.debounceMs);
+    };
+    /**
+     * 立即推送所有待处理的变更
+     */
+    ChangeAggregator.prototype.flush = function () {
+        if (this.pendingChanges.size === 0) {
+            return;
+        }
+        var changes = Array.from(this.pendingChanges.values());
+        this.pendingChanges.clear();
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        console.log("[ChangeAggregator] \u63A8\u9001\u6279\u91CF\u53D8\u66F4: ".concat(changes.length, " \u4E2A\u6587\u4EF6"));
+        // 调用处理器
+        try {
+            this.handler({
+                spaceId: this.spaceId,
+                userId: this.userId,
+                changes: changes,
+                timestamp: Date.now(),
+            });
+        }
+        catch (error) {
+            console.error('[ChangeAggregator] 批量变更处理失败:', error);
+        }
+    };
+    /**
+     * 清理资源
+     */
+    ChangeAggregator.prototype.destroy = function () {
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        this.pendingChanges.clear();
+    };
+    /**
+     * 获取待处理变更数量
+     */
+    ChangeAggregator.prototype.getPendingCount = function () {
+        return this.pendingChanges.size;
+    };
+    return ChangeAggregator;
+}());
+
 /**
  * 影子空间WebSocket指令处理器
  */
 var ShadowSpaceCommandHandler = /** @class */ (function () {
     function ShadowSpaceCommandHandler(shadowSpace, socketStore) {
         this.currentUserId = null;
+        // 🆕 变更聚合器
+        this.changeAggregator = null;
         this.shadowSpace = shadowSpace;
         this.socketStore = socketStore;
     }
@@ -41580,11 +42213,11 @@ var ShadowSpaceCommandHandler = /** @class */ (function () {
      * 处理WebSocket消息
      */
     ShadowSpaceCommandHandler.prototype.handleMessage = function (data) {
-        var _a, _b, _c, _d, _e, _f;
+        var _a, _b, _c, _d, _e, _f, _g;
         return __awaiter(this, void 0, void 0, function () {
-            var action, messageId, message, spaceInfo, requestSpaceId, result, _g, error_1, errorMessage;
-            return __generator(this, function (_h) {
-                switch (_h.label) {
+            var action, messageId, message, spaceInfo, requestSpaceId, result, _h, error_1, errorMessage;
+            return __generator(this, function (_j) {
+                switch (_j.label) {
                     case 0:
                         action = data.action, messageId = data.messageId, message = data.message;
                         console.log("[ShadowSpaceCommandHandler] \u6536\u5230\u6D88\u606F: ".concat(action), {
@@ -41610,12 +42243,12 @@ var ShadowSpaceCommandHandler = /** @class */ (function () {
                             // 不发送响应，让其他CLI实例处理
                             return [2 /*return*/];
                         }
-                        _h.label = 1;
+                        _j.label = 1;
                     case 1:
-                        _h.trys.push([1, 26, , 27]);
+                        _j.trys.push([1, 28, , 29]);
                         result = void 0;
-                        _g = action;
-                        switch (_g) {
+                        _h = action;
+                        switch (_h) {
                             case 'shadow-space-get-changes': return [3 /*break*/, 2];
                             case 'shadow-space-get-file-content': return [3 /*break*/, 4];
                             case 'shadow-space-get-files-content': return [3 /*break*/, 6];
@@ -41627,12 +42260,13 @@ var ShadowSpaceCommandHandler = /** @class */ (function () {
                             case 'shadow-space-mark-remote-modified': return [3 /*break*/, 18];
                             case 'shadow-space-clear-remote-flags': return [3 /*break*/, 20];
                             case 'shadow-space-detect-changes': return [3 /*break*/, 22];
+                            case 'shadow-space-discard-changes': return [3 /*break*/, 24];
                         }
-                        return [3 /*break*/, 24];
+                        return [3 /*break*/, 26];
                     case 2: return [4 /*yield*/, this.getChanges()];
                     case 3:
-                        result = _h.sent();
-                        return [3 /*break*/, 25];
+                        result = _j.sent();
+                        return [3 /*break*/, 27];
                     case 4:
                         console.log('[ShadowSpaceCommandHandler] 获取文件内容 - message:', JSON.stringify(message, null, 2));
                         console.log('[ShadowSpaceCommandHandler] 获取文件内容 - message.path:', message.path);
@@ -41640,57 +42274,61 @@ var ShadowSpaceCommandHandler = /** @class */ (function () {
                         return [4 /*yield*/, this.getFileContent(((_c = message.message) === null || _c === void 0 ? void 0 : _c.path) || message.path)];
                     case 5:
                         // 🆕 修复：路径在 message.message.path 中
-                        result = _h.sent();
-                        return [3 /*break*/, 25];
+                        result = _j.sent();
+                        return [3 /*break*/, 27];
                     case 6: return [4 /*yield*/, this.getFilesContent(((_d = message.message) === null || _d === void 0 ? void 0 : _d.paths) || message.paths)];
                     case 7:
                         // 🆕 修复：路径在 message.message.paths 中
-                        result = _h.sent();
-                        return [3 /*break*/, 25];
+                        result = _j.sent();
+                        return [3 /*break*/, 27];
                     case 8: return [4 /*yield*/, this.applyChanges(message.changes)];
                     case 9:
-                        result = _h.sent();
-                        return [3 /*break*/, 25];
+                        result = _j.sent();
+                        return [3 /*break*/, 27];
                     case 10: return [4 /*yield*/, this.resetShadowSpace()];
                     case 11:
-                        result = _h.sent();
-                        return [3 /*break*/, 25];
+                        result = _j.sent();
+                        return [3 /*break*/, 27];
                     case 12: return [4 /*yield*/, this.getSpaceInfo()];
                     case 13:
-                        result = _h.sent();
-                        return [3 /*break*/, 25];
+                        result = _j.sent();
+                        return [3 /*break*/, 27];
                     case 14: return [4 /*yield*/, this.syncFromEditor(message.message.files)];
                     case 15:
-                        result = _h.sent();
-                        return [3 /*break*/, 25];
+                        result = _j.sent();
+                        return [3 /*break*/, 27];
                     case 16: return [4 /*yield*/, this.deleteFile(message.filePath)];
                     case 17:
-                        result = _h.sent();
-                        return [3 /*break*/, 25];
+                        result = _j.sent();
+                        return [3 /*break*/, 27];
                     case 18: return [4 /*yield*/, this.markRemoteModified(message.filePaths)];
                     case 19:
-                        result = _h.sent();
-                        return [3 /*break*/, 25];
+                        result = _j.sent();
+                        return [3 /*break*/, 27];
                     case 20: return [4 /*yield*/, this.clearRemoteFlags(message.filePaths)];
                     case 21:
-                        result = _h.sent();
-                        return [3 /*break*/, 25];
+                        result = _j.sent();
+                        return [3 /*break*/, 27];
                     case 22: return [4 /*yield*/, this.detectEditorChanges(((_e = message.message) === null || _e === void 0 ? void 0 : _e.spaceId) || message.spaceId, ((_f = message.message) === null || _f === void 0 ? void 0 : _f.files) || message.files)];
                     case 23:
-                        result = _h.sent();
-                        return [3 /*break*/, 25];
-                    case 24: throw new Error("Unknown shadow space action: ".concat(action));
+                        result = _j.sent();
+                        return [3 /*break*/, 27];
+                    case 24: return [4 /*yield*/, this.discardChanges(((_g = message.message) === null || _g === void 0 ? void 0 : _g.filePaths) || message.filePaths)];
                     case 25:
+                        result = _j.sent();
+                        return [3 /*break*/, 27];
+                    case 26: throw new Error("Unknown shadow space action: ".concat(action));
+                    case 27:
                         // 发送成功响应
                         this.sendResponse(action, messageId, true, result);
-                        return [3 /*break*/, 27];
-                    case 26:
-                        error_1 = _h.sent();
+                        return [3 /*break*/, 29];
+                    case 28:
+                        error_1 = _j.sent();
                         errorMessage = error_1 instanceof Error ? error_1.message : String(error_1);
                         console.error("Shadow space command error [".concat(action, "]:"), errorMessage);
                         this.sendResponse(action, messageId, false, undefined, errorMessage);
-                        return [3 /*break*/, 27];
-                    case 27: return [2 /*return*/];
+                        return [3 /*break*/, 29];
+                    case 29: return [2 /*return*/];
                 }
             });
         });
@@ -41959,9 +42597,10 @@ var ShadowSpaceCommandHandler = /** @class */ (function () {
         return __awaiter(this, void 0, void 0, function () {
             var info;
             return __generator(this, function (_a) {
-                console.log('[ShadowSpace] 获取空间信息...');
                 info = this.shadowSpace.getSpaceInfo();
-                console.log("[ShadowSpace] \u7A7A\u95F4\u4FE1\u606F: ".concat(info.fileCount, " \u4E2A\u6587\u4EF6, ").concat(info.totalSize));
+                // console.log(
+                //   `[ShadowSpace] 空间信息: ${info.fileCount} 个文件, ${info.totalSize}`
+                // );
                 return [2 /*return*/, info];
             });
         });
@@ -41971,14 +42610,14 @@ var ShadowSpaceCommandHandler = /** @class */ (function () {
      */
     ShadowSpaceCommandHandler.prototype.syncFromEditor = function (files) {
         return __awaiter(this, void 0, void 0, function () {
-            var filePaths, result;
+            var result;
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
                         console.log('[ShadowSpace] syncFromEditor 接收到的参数:', {
                             filesType: typeof files,
                             isArray: Array.isArray(files),
-                            filesValue: files,
+                            // filesValue: files,
                             filesLength: files === null || files === void 0 ? void 0 : files.length,
                         });
                         if (!Array.isArray(files)) {
@@ -41988,11 +42627,6 @@ var ShadowSpaceCommandHandler = /** @class */ (function () {
                         return [4 /*yield*/, this.shadowSpace.syncFromEditor(files)];
                     case 1:
                         _a.sent();
-                        filePaths = files.map(function (f) { return f.path; });
-                        return [4 /*yield*/, this.shadowSpace.markAsRemoteModified(filePaths)];
-                    case 2:
-                        _a.sent();
-                        console.log("[ShadowSpace] \u5DF2\u6807\u8BB0 ".concat(filePaths.length, " \u4E2A\u6587\u4EF6\u4E3A\u8FDC\u7A0B\u4FEE\u6539"));
                         result = {
                             message: 'Sync from editor completed',
                             fileCount: files.length,
@@ -42128,10 +42762,12 @@ var ShadowSpaceCommandHandler = /** @class */ (function () {
                             var actualMessage = (data === null || data === void 0 ? void 0 : data.message) || data;
                             var actualMessageId = actualMessage === null || actualMessage === void 0 ? void 0 : actualMessage.messageId;
                             var actualAction = actualMessage === null || actualMessage === void 0 ? void 0 : actualMessage.action;
-                            console.log("[ShadowSpace] \u68C0\u67E5\u54CD\u5E94: action=".concat(actualAction, ", messageId=").concat(actualMessageId, ", \u671F\u671B=").concat(messageId));
+                            // console.log(
+                            //   `[ShadowSpace] 检查响应: action=${actualAction}, messageId=${actualMessageId}, 期望=${messageId}`
+                            // );
                             if (actualMessageId === messageId &&
                                 actualAction === 'editor-state-response') {
-                                console.log("[ShadowSpace] \u6536\u5230\u7F16\u8F91\u5668\u72B6\u6001\u54CD\u5E94");
+                                // console.log(`[ShadowSpace] 收到编辑器状态响应`);
                                 clearTimeout(timeout);
                                 if ((_a = actualMessage.message) === null || _a === void 0 ? void 0 : _a.success) {
                                     resolve(actualMessage.message.data);
@@ -42149,7 +42785,9 @@ var ShadowSpaceCommandHandler = /** @class */ (function () {
                                 originalOnMessage(data);
                             }
                         };
-                        console.log("[ShadowSpace] \u4E34\u65F6\u76D1\u542C\u5668\u5DF2\u8BBE\u7F6E\uFF0C\u53D1\u9001\u7F16\u8F91\u5668\u72B6\u6001\u8BF7\u6C42: ".concat(messageId));
+                        // console.log(
+                        //   `[ShadowSpace] 临时监听器已设置，发送编辑器状态请求: ${messageId}`
+                        // );
                         // 发送请求
                         _this.socketStore.sendMessage({
                             action: 'request-editor-state',
@@ -42160,7 +42798,7 @@ var ShadowSpaceCommandHandler = /** @class */ (function () {
                         });
                         // 恢复原始处理器（在超时时间之后）
                         setTimeout(function () {
-                            console.log("[ShadowSpace] \u6062\u590D\u539F\u59CB\u76D1\u542C\u5668: ".concat(messageId));
+                            // console.log(`[ShadowSpace] 恢复原始监听器: ${messageId}`);
                             _this.socketStore.onmsg = originalOnMessage;
                         }, 31000);
                     })];
@@ -42172,23 +42810,20 @@ var ShadowSpaceCommandHandler = /** @class */ (function () {
      */
     ShadowSpaceCommandHandler.prototype.detectEditorChanges = function (spaceId, editorSnapshots) {
         return __awaiter(this, void 0, void 0, function () {
-            var safeEditorSnapshots, spaceSnapshots, snapshotCount, changes, summary, error_2;
+            var safeEditorSnapshots, spaceSnapshots, changes, summary, error_2;
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
                         _a.trys.push([0, 3, , 4]);
-                        console.log('editorSnapshots: ', editorSnapshots);
                         safeEditorSnapshots = Array.isArray(editorSnapshots)
                             ? editorSnapshots
                             : [];
-                        console.log("[ShadowSpace] \u5F00\u59CB\u68C0\u6D4B\u53D8\u66F4: \u7A7A\u95F4=".concat(spaceId, ", \u7F16\u8F91\u5668\u6587\u4EF6=").concat(safeEditorSnapshots.length, "\u4E2A"));
                         return [4 /*yield*/, this.shadowSpace.getSpaceSnapshots(spaceId)];
                     case 1:
                         spaceSnapshots = _a.sent();
-                        snapshotCount = Array.isArray(spaceSnapshots)
+                        Array.isArray(spaceSnapshots)
                             ? spaceSnapshots.length
                             : 0;
-                        console.log("[ShadowSpace] \u7A7A\u95F4\u5FEB\u7167: ".concat(snapshotCount, "\u4E2A\u6587\u4EF6"));
                         return [4 /*yield*/, this.compareSnapshots(safeEditorSnapshots, spaceSnapshots)];
                     case 2:
                         changes = _a.sent();
@@ -42197,7 +42832,9 @@ var ShadowSpaceCommandHandler = /** @class */ (function () {
                             needPush: changes.filter(function (c) { return c.side === 'editor'; }).length,
                             needPull: changes.filter(function (c) { return c.side === 'space'; }).length,
                         };
-                        console.log("[ShadowSpace] \u53D8\u66F4\u68C0\u6D4B\u5B8C\u6210: \u603B\u8BA1".concat(summary.total, "\u4E2A\u53D8\u66F4, \u9700\u63A8\u9001").concat(summary.needPush, "\u4E2A, \u9700\u62C9\u53D6").concat(summary.needPull, "\u4E2A"));
+                        // console.log(
+                        //   `[ShadowSpace] 变更检测完成: 总计${summary.total}个变更, 需推送${summary.needPush}个, 需拉取${summary.needPull}个`
+                        // );
                         return [2 /*return*/, {
                                 success: true,
                                 data: {
@@ -42224,10 +42861,11 @@ var ShadowSpaceCommandHandler = /** @class */ (function () {
      * 比对编辑器和空间快照
      */
     ShadowSpaceCommandHandler.prototype.compareSnapshots = function (editorSnapshots, spaceSnapshots) {
+        var _a, _b, _c;
         return __awaiter(this, void 0, void 0, function () {
-            var changes, safeEditorSnapshots, safeSpaceSnapshots, editorMap, spaceMap, editorMap_1, editorMap_1_1, _a, path, editorFile, spaceFile, spaceMap_1, spaceMap_1_1, _b, path, spaceFile, editorFile;
-            var e_2, _c, e_3, _d;
-            return __generator(this, function (_e) {
+            var changes, safeEditorSnapshots, safeSpaceSnapshots, editorMap, spaceMap, editorMap_1, editorMap_1_1, _d, path, editorFile, spaceFile, spaceMap_1, spaceMap_1_1, _e, path, spaceFile, editorFile;
+            var e_2, _f, e_3, _g;
+            return __generator(this, function (_h) {
                 changes = [];
                 safeEditorSnapshots = Array.isArray(editorSnapshots)
                     ? editorSnapshots
@@ -42240,7 +42878,7 @@ var ShadowSpaceCommandHandler = /** @class */ (function () {
                 try {
                     // 检测编辑器的变更（新增、修改）
                     for (editorMap_1 = __values(editorMap), editorMap_1_1 = editorMap_1.next(); !editorMap_1_1.done; editorMap_1_1 = editorMap_1.next()) {
-                        _a = __read(editorMap_1_1.value, 2), path = _a[0], editorFile = _a[1];
+                        _d = __read(editorMap_1_1.value, 2), path = _d[0], editorFile = _d[1];
                         spaceFile = spaceMap.get(path);
                         if (!spaceFile) {
                             // 编辑器新增的文件
@@ -42257,9 +42895,11 @@ var ShadowSpaceCommandHandler = /** @class */ (function () {
                         else if (editorFile.hash !== spaceFile.remoteHash) {
                             // 编辑器修改的文件（基于云端哈希比对）
                             console.log("[ShadowSpace] \u68C0\u6D4B\u5230\u7F16\u8F91\u5668\u4FEE\u6539: ".concat(path), {
-                                editorHash: editorFile.hash,
-                                spaceRemoteHash: spaceFile.remoteHash,
-                                spaceLocalHash: spaceFile.hash,
+                                editorHash: (_a = editorFile.hash) === null || _a === void 0 ? void 0 : _a.substring(0, 16),
+                                spaceRemoteHash: (_b = spaceFile.remoteHash) === null || _b === void 0 ? void 0 : _b.substring(0, 16),
+                                spaceLocalHash: (_c = spaceFile.hash) === null || _c === void 0 ? void 0 : _c.substring(0, 16),
+                                editorHashFull: editorFile.hash,
+                                spaceRemoteHashFull: spaceFile.remoteHash,
                             });
                             changes.push({
                                 action: 'modify',
@@ -42276,14 +42916,14 @@ var ShadowSpaceCommandHandler = /** @class */ (function () {
                 catch (e_2_1) { e_2 = { error: e_2_1 }; }
                 finally {
                     try {
-                        if (editorMap_1_1 && !editorMap_1_1.done && (_c = editorMap_1.return)) _c.call(editorMap_1);
+                        if (editorMap_1_1 && !editorMap_1_1.done && (_f = editorMap_1.return)) _f.call(editorMap_1);
                     }
                     finally { if (e_2) throw e_2.error; }
                 }
                 try {
                     // 检测空间的变更（删除、空间独有的修改）
                     for (spaceMap_1 = __values(spaceMap), spaceMap_1_1 = spaceMap_1.next(); !spaceMap_1_1.done; spaceMap_1_1 = spaceMap_1.next()) {
-                        _b = __read(spaceMap_1_1.value, 2), path = _b[0], spaceFile = _b[1];
+                        _e = __read(spaceMap_1_1.value, 2), path = _e[0], spaceFile = _e[1];
                         editorFile = editorMap.get(path);
                         if (!editorFile) {
                             // 空间独有的文件（编辑器已删除）
@@ -42303,7 +42943,7 @@ var ShadowSpaceCommandHandler = /** @class */ (function () {
                 catch (e_3_1) { e_3 = { error: e_3_1 }; }
                 finally {
                     try {
-                        if (spaceMap_1_1 && !spaceMap_1_1.done && (_d = spaceMap_1.return)) _d.call(spaceMap_1);
+                        if (spaceMap_1_1 && !spaceMap_1_1.done && (_g = spaceMap_1.return)) _g.call(spaceMap_1);
                     }
                     finally { if (e_3) throw e_3.error; }
                 }
@@ -42311,12 +42951,132 @@ var ShadowSpaceCommandHandler = /** @class */ (function () {
             });
         });
     };
+    /**
+     * 放弃本地变更
+     * 将影子空间的状态更新为编辑器的版本，不再提示这些文件有变更
+     */
+    ShadowSpaceCommandHandler.prototype.discardChanges = function (filePaths) {
+        return __awaiter(this, void 0, void 0, function () {
+            var editorState, editorFiles;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (!filePaths || filePaths.length === 0) {
+                            throw new Error('No file paths provided');
+                        }
+                        console.log("[ShadowSpace] \u653E\u5F03\u53D8\u66F4: ".concat(filePaths.length, " \u4E2A\u6587\u4EF6"));
+                        return [4 /*yield*/, this.requestEditorState()];
+                    case 1:
+                        editorState = _a.sent();
+                        if (!editorState || !editorState.files) {
+                            throw new Error('Failed to get editor state');
+                        }
+                        editorFiles = editorState.files.filter(function (f) {
+                            return filePaths.includes(f.path);
+                        });
+                        console.log("[ShadowSpace] \u4ECE\u7F16\u8F91\u5668\u83B7\u53D6\u5230 ".concat(editorFiles.length, " \u4E2A\u6587\u4EF6"));
+                        if (editorFiles.length === 0) {
+                            throw new Error('No matching files found in editor');
+                        }
+                        // 同步到影子空间（覆盖本地变更）
+                        return [4 /*yield*/, this.shadowSpace.syncFromEditor(editorFiles)];
+                    case 2:
+                        // 同步到影子空间（覆盖本地变更）
+                        _a.sent();
+                        // 标记为远程修改，避免再次检测
+                        return [4 /*yield*/, this.shadowSpace.markAsRemoteModified(filePaths)];
+                    case 3:
+                        // 标记为远程修改，避免再次检测
+                        _a.sent();
+                        console.log("[ShadowSpace] \u6210\u529F\u653E\u5F03 ".concat(filePaths.length, " \u4E2A\u6587\u4EF6\u7684\u53D8\u66F4"));
+                        return [2 /*return*/, {
+                                message: 'Changes discarded successfully',
+                                fileCount: filePaths.length,
+                                discardedFiles: filePaths,
+                                timestamp: Date.now(),
+                            }];
+                }
+            });
+        });
+    };
     /**
      * 生成消息ID
      */
     ShadowSpaceCommandHandler.prototype.generateMessageId = function () {
         return "msg_".concat(Date.now(), "_").concat(Math.random().toString(36).substr(2, 9));
     };
+    // ==================== 🆕 文件监听功能 ====================
+    /**
+     * 启动文件监听
+     */
+    ShadowSpaceCommandHandler.prototype.startFileWatching = function () {
+        var _this = this;
+        if (!this.currentUserId) {
+            console.error('[ShadowSpace] 无法启动文件监听：用户ID未设置');
+            return;
+        }
+        var spaceInfo = this.shadowSpace.getSpaceInfo();
+        console.log('[ShadowSpace] 启动文件监听和变更聚合...');
+        // 创建变更聚合器
+        this.changeAggregator = new ChangeAggregator(spaceInfo.spaceId, spaceInfo.userId, function (event) { return _this.handleBatchChange(event); }, 500 // 500ms 防抖
+        );
+        // 添加变更监听器
+        this.shadowSpace.addChangeListener(function (change) {
+            if (_this.changeAggregator) {
+                _this.changeAggregator.addChange(change);
+            }
+        });
+        // 启动文件监听
+        this.shadowSpace.startWatching();
+        console.log('[ShadowSpace] 文件监听和变更聚合已启动');
+    };
+    /**
+     * 停止文件监听
+     */
+    ShadowSpaceCommandHandler.prototype.stopFileWatching = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        console.log('[ShadowSpace] 停止文件监听和变更聚合...');
+                        // 停止文件监听
+                        return [4 /*yield*/, this.shadowSpace.stopWatching()];
+                    case 1:
+                        // 停止文件监听
+                        _a.sent();
+                        // 销毁变更聚合器
+                        if (this.changeAggregator) {
+                            this.changeAggregator.destroy();
+                            this.changeAggregator = null;
+                        }
+                        console.log('[ShadowSpace] 文件监听和变更聚合已停止');
+                        return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /**
+     * 处理批量变更
+     */
+    ShadowSpaceCommandHandler.prototype.handleBatchChange = function (event) {
+        console.log("[ShadowSpace] \u63A8\u9001\u6279\u91CF\u53D8\u66F4\u4E8B\u4EF6: ".concat(event.changes.length, " \u4E2A\u6587\u4EF6"));
+        // 推送批量变更事件到编辑器
+        this.socketStore.sendMessage({
+            action: 'shadow-space-batch-changed',
+            message: {
+                spaceId: event.spaceId,
+                userId: event.userId,
+                changes: event.changes,
+                timestamp: event.timestamp,
+            },
+        });
+    };
+    /**
+     * 获取监听状态
+     */
+    ShadowSpaceCommandHandler.prototype.isWatching = function () {
+        return this.shadowSpace.isFileWatching();
+    };
     return ShadowSpaceCommandHandler;
 }());
 
@@ -42456,11 +43216,31 @@ function startConnecting(options) {
                     log("[\u8FDB\u7A0B ".concat(process.pid, "] \u6587\u4EF6\u64CD\u4F5C\u5904\u7406\u5668\u5DF2\u521D\u59CB\u5316\uFF0C\u57FA\u7840\u76EE\u5F55: ").concat(fileOperationConfig.baseDir));
                     shadowSpace_1 = null;
                     shadowSpaceHandler_1 = null;
-                    cleanup_1 = function () {
-                        log("[\u8FDB\u7A0B ".concat(process.pid, "] \u6B63\u5728\u6E05\u7406..."));
-                        removePidFile();
-                        process.exit(0);
-                    };
+                    cleanup_1 = function () { return __awaiter(_this, void 0, void 0, function () {
+                        return __generator(this, function (_a) {
+                            switch (_a.label) {
+                                case 0:
+                                    log("[\u8FDB\u7A0B ".concat(process.pid, "] \u6B63\u5728\u6E05\u7406..."));
+                                    if (!shadowSpaceHandler_1) return [3 /*break*/, 4];
+                                    _a.label = 1;
+                                case 1:
+                                    _a.trys.push([1, 3, , 4]);
+                                    return [4 /*yield*/, shadowSpaceHandler_1.stopFileWatching()];
+                                case 2:
+                                    _a.sent();
+                                    log("[\u8FDB\u7A0B ".concat(process.pid, "] \u5F71\u5B50\u7A7A\u95F4\u6587\u4EF6\u76D1\u542C\u5DF2\u505C\u6B62"));
+                                    return [3 /*break*/, 4];
+                                case 3:
+                                    _a.sent();
+                                    log("[\u8FDB\u7A0B ".concat(process.pid, "] \u505C\u6B62\u6587\u4EF6\u76D1\u542C\u5931\u8D25:"));
+                                    return [3 /*break*/, 4];
+                                case 4:
+                                    removePidFile();
+                                    process.exit(0);
+                                    return [2 /*return*/];
+                            }
+                        });
+                    }); };
                     process.on('SIGINT', cleanup_1);
                     process.on('SIGTERM', cleanup_1);
                     process.on('uncaughtException', function (error) {
@@ -42492,6 +43272,9 @@ function startConnecting(options) {
                                             // 初始化影子空间指令处理器
                                             shadowSpaceHandler_1 = new ShadowSpaceCommandHandler(shadowSpace_1, currentSocket);
                                             shadowSpaceHandler_1.setCurrentUserId(account);
+                                            // 🆕 启动文件监听
+                                            shadowSpaceHandler_1.startFileWatching();
+                                            log("[\u8FDB\u7A0B ".concat(process.pid, "] \u5F71\u5B50\u7A7A\u95F4\u6587\u4EF6\u76D1\u542C\u5DF2\u542F\u52A8"));
                                             return [3 /*break*/, 3];
                                         case 2:
                                             log("[\u8FDB\u7A0B ".concat(process.pid, "] \u8DF3\u8FC7\u5F71\u5B50\u7A7A\u95F4\u521D\u59CB\u5316\uFF08\u672A\u542F\u7528workspace\u6A21\u5F0F\uFF09"));
@@ -42517,13 +43300,11 @@ function startConnecting(options) {
                                 }, 5000);
                             },
                             onmsg: function (data) { return __awaiter(_this, void 0, void 0, function () {
-                                var action, message, extracted, normalizedData, result, _a, error_2, error_3, userId, current, cwd, type, change, filePath;
+                                var action, message, extracted, normalizedData, result, _a, error_3, error_4, userId, current, cwd, type, change, filePath;
                                 var _b, _c;
                                 return __generator(this, function (_d) {
                                     switch (_d.label) {
                                         case 0:
-                                            // if (DEV_MODE) {
-                                            log("[\u8FDB\u7A0B ".concat(process.pid, "] \u6536\u5230\u6D88\u606F: ").concat(JSON.stringify(data)));
                                             if (data === null || data === void 0 ? void 0 : data.action) {
                                                 // 直接格式
                                                 action = data.action;
@@ -42596,8 +43377,8 @@ function startConnecting(options) {
                                             log("[\u8FDB\u7A0B ".concat(process.pid, "] \u5F71\u5B50\u7A7A\u95F4\u5DF2\u6807\u8BB0\u8FDC\u7A0B\u4FEE\u6539: ").concat(message.message.path));
                                             return [3 /*break*/, 11];
                                         case 10:
-                                            error_2 = _d.sent();
-                                            log("[\u8FDB\u7A0B ".concat(process.pid, "] \u5F71\u5B50\u7A7A\u95F4\u6807\u8BB0\u8FDC\u7A0B\u4FEE\u6539\u5931\u8D25: ").concat(error_2));
+                                            error_3 = _d.sent();
+                                            log("[\u8FDB\u7A0B ".concat(process.pid, "] \u5F71\u5B50\u7A7A\u95F4\u6807\u8BB0\u8FDC\u7A0B\u4FEE\u6539\u5931\u8D25: ").concat(error_3));
                                             return [3 /*break*/, 11];
                                         case 11: return [3 /*break*/, 23];
                                         case 12: return [4 /*yield*/, fileHandler_1.readFile(message.path, message.encoding)];
@@ -42639,13 +43420,13 @@ function startConnecting(options) {
                                             });
                                             return [3 /*break*/, 25];
                                         case 24:
-                                            error_3 = _d.sent();
-                                            log("[\u8FDB\u7A0B ".concat(process.pid, "] \u6587\u4EF6\u64CD\u4F5C\u9519\u8BEF: ").concat(error_3));
+                                            error_4 = _d.sent();
+                                            log("[\u8FDB\u7A0B ".concat(process.pid, "] \u6587\u4EF6\u64CD\u4F5C\u9519\u8BEF: ").concat(error_4));
                                             currentSocket === null || currentSocket === void 0 ? void 0 : currentSocket.sendMessage({
                                                 action: "".concat(action, "-response"),
                                                 message: {
                                                     success: false,
-                                                    error: error_3 instanceof Error ? error_3.message : String(error_3),
+                                                    error: error_4 instanceof Error ? error_4.message : String(error_4),
                                                 },
                                             });
                                             return [3 /*break*/, 25];
@@ -48004,6 +48785,1155 @@ function cleanupOldLogs(logDir, debugDir) {
     });
 }
 
+/**
+ * AI 工具配置
+ */
+var AI_TOOLS = [
+    {
+        name: '🤖 Claude Code (Anthropic 官方)',
+        value: 'claude-code',
+        description: '支持 Hooks 和 TSX 检查器',
+    },
+    {
+        name: '🎯 Cursor (AI-first IDE)',
+        value: 'cursor',
+        description: '支持 Rules 和自定义指令',
+    },
+    {
+        name: '🌊 Windsurf (Codeium)',
+        value: 'windsurf',
+        description: '支持 Cascade 配置',
+    },
+    {
+        name: '☁️  阿里云 Coder',
+        value: 'coder',
+        description: '支持模板配置',
+    },
+    {
+        name: '🔧 Augment (VSCode 插件)',
+        value: 'augment',
+        description: '支持上下文配置',
+    },
+    {
+        name: '⏭️  其他 / 跳过',
+        value: 'other',
+        description: '只生成基础配置',
+    },
+];
+
+/**
+ * 基础生成器 - 生成通用的 Space 配置文件
+ */
+var BaseGenerator = /** @class */ (function () {
+    function BaseGenerator(cwd, config, verbose) {
+        this.cwd = cwd;
+        this.config = config;
+        this.verbose = verbose;
+    }
+    /**
+     * 生成基础配置文件
+     */
+    BaseGenerator.prototype.generate = function (skipPrompts) {
+        return __awaiter(this, void 0, void 0, function () {
+            var files, appthenDir, configFile, gitignoreFile, promptFiles, error_1;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        files = [];
+                        _a.label = 1;
+                    case 1:
+                        _a.trys.push([1, 6, , 7]);
+                        appthenDir = path__namespace.join(this.cwd, '.appthen');
+                        this.ensureDirectory(appthenDir);
+                        return [4 /*yield*/, this.createSpaceConfig(appthenDir)];
+                    case 2:
+                        configFile = _a.sent();
+                        files.push(configFile);
+                        return [4 /*yield*/, this.createGitignore(appthenDir)];
+                    case 3:
+                        gitignoreFile = _a.sent();
+                        files.push(gitignoreFile);
+                        if (!!skipPrompts) return [3 /*break*/, 5];
+                        return [4 /*yield*/, this.createPrompts(appthenDir)];
+                    case 4:
+                        promptFiles = _a.sent();
+                        files.push.apply(files, __spreadArray([], __read(promptFiles), false));
+                        _a.label = 5;
+                    case 5: return [2 /*return*/, {
+                            success: true,
+                            files: files,
+                            message: 'Base configuration created successfully',
+                        }];
+                    case 6:
+                        error_1 = _a.sent();
+                        return [2 /*return*/, {
+                                success: false,
+                                files: [],
+                                error: error_1.message,
+                            }];
+                    case 7: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /**
+     * 确保目录存在
+     */
+    BaseGenerator.prototype.ensureDirectory = function (dir) {
+        if (!fs__namespace.existsSync(dir)) {
+            fs__namespace.mkdirSync(dir, { recursive: true });
+            if (this.verbose) {
+                console.log("\uD83D\uDCC1 \u521B\u5EFA\u76EE\u5F55: ".concat(dir));
+            }
+        }
+    };
+    /**
+     * 创建 space-config.json
+     */
+    BaseGenerator.prototype.createSpaceConfig = function (appthenDir) {
+        return __awaiter(this, void 0, void 0, function () {
+            var configPath, configContent;
+            return __generator(this, function (_a) {
+                configPath = path__namespace.join(appthenDir, 'space-config.json');
+                configContent = __assign(__assign({}, this.config), { 
+                    // 添加一些额外的配置
+                    settings: {
+                        autoSync: true,
+                        watchPatterns: ['src/**/*', 'docs/**/*'],
+                        ignorePatterns: [
+                            'node_modules/**',
+                            'dist/**',
+                            'build/**',
+                            '.git/**',
+                            '*.log',
+                        ],
+                    } });
+                fs__namespace.writeFileSync(configPath, JSON.stringify(configContent, null, 2));
+                if (this.verbose) {
+                    console.log("\uD83D\uDCDD \u521B\u5EFA\u914D\u7F6E\u6587\u4EF6: ".concat(configPath));
+                }
+                return [2 /*return*/, configPath];
+            });
+        });
+    };
+    /**
+     * 创建 .gitignore
+     */
+    BaseGenerator.prototype.createGitignore = function (appthenDir) {
+        return __awaiter(this, void 0, void 0, function () {
+            var gitignorePath, gitignoreContent;
+            return __generator(this, function (_a) {
+                gitignorePath = path__namespace.join(appthenDir, '.gitignore');
+                gitignoreContent = "# Shadow Space \u6587\u4EF6\nshadow-space-*.json\n\n# \u65E5\u5FD7\u6587\u4EF6\n*.log\n\n# \u4E34\u65F6\u6587\u4EF6\n*.tmp\n.DS_Store\n\n# \u7F16\u8F91\u5668\u914D\u7F6E\uFF08\u53EF\u9009\uFF09\n# .vscode/\n# .idea/\n";
+                fs__namespace.writeFileSync(gitignorePath, gitignoreContent);
+                if (this.verbose) {
+                    console.log("\uD83D\uDCDD \u521B\u5EFA .gitignore: ".concat(gitignorePath));
+                }
+                return [2 /*return*/, gitignorePath];
+            });
+        });
+    };
+    /**
+     * 创建提示词目录和文件
+     */
+    BaseGenerator.prototype.createPrompts = function (appthenDir) {
+        return __awaiter(this, void 0, void 0, function () {
+            var files, promptsDir, readmeFile, templateFiles;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        files = [];
+                        promptsDir = path__namespace.join(appthenDir, 'prompts');
+                        this.ensureDirectory(promptsDir);
+                        return [4 /*yield*/, this.createPromptsReadme(promptsDir)];
+                    case 1:
+                        readmeFile = _a.sent();
+                        files.push(readmeFile);
+                        return [4 /*yield*/, this.copyTemplateFiles(promptsDir)];
+                    case 2:
+                        templateFiles = _a.sent();
+                        files.push.apply(files, __spreadArray([], __read(templateFiles), false));
+                        return [2 /*return*/, files];
+                }
+            });
+        });
+    };
+    /**
+     * 创建提示词 README
+     */
+    BaseGenerator.prototype.createPromptsReadme = function (promptsDir) {
+        return __awaiter(this, void 0, void 0, function () {
+            var readmePath, readmeContent;
+            return __generator(this, function (_a) {
+                readmePath = path__namespace.join(promptsDir, 'README.md');
+                readmeContent = "# Agent+ Space \u63D0\u793A\u8BCD\n\n\u8FD9\u4E2A\u76EE\u5F55\u5305\u542B\u4E86\u7528\u4E8E AI \u7F16\u7801\u5DE5\u5177\u7684\u63D0\u793A\u8BCD\u6A21\u677F\uFF0C\u5E2E\u52A9 AI \u7406\u89E3\u9879\u76EE\u89C4\u8303\u5E76\u751F\u6210\u7B26\u5408\u8981\u6C42\u7684\u4EE3\u7801\u3002\n\n## \uD83D\uDCDA \u63D0\u793A\u8BCD\u6587\u4EF6\u8BF4\u660E\n\n### \u6838\u5FC3\u6587\u6863\n\n1. **project-guide.md** - \u9879\u76EE\u5F00\u53D1\u603B\u6307\u5357 \u2B50\n   - \u9879\u76EE\u6982\u8FF0\u548C\u7ED3\u6784\n   - \u5F00\u53D1\u89C4\u8303\u548C\u6D41\u7A0B\n   - \u5FEB\u901F\u5F00\u59CB\u6307\u5357\n   - \u6700\u4F73\u5B9E\u8DF5\n\n2. **tsx-generation.md** - TSX \u4EE3\u7801\u751F\u6210\u89C4\u8303 \u2B50\u2B50\u2B50\n   - \u5B8C\u6574\u7684\u6587\u4EF6\u7ED3\u6784\u8981\u6C42\n   - \u4E25\u683C\u7684 render() \u65B9\u6CD5\u7EA6\u675F\n   - TypeScript \u8BED\u6CD5\u9650\u5236\n   - JSX \u4F4D\u7F6E\u9650\u5236\n   - \u5B8C\u6574\u793A\u4F8B\u4EE3\u7801\n   - \u5E38\u89C1\u9519\u8BEF\u548C\u4FEE\u590D\n\n3. **decision-tree.md** - AI \u51B3\u7B56\u6811 \u2B50\u2B50\n   - \u5E2E\u52A9 AI \u505A\u51FA\u6B63\u786E\u51B3\u7B56\n   - \u5173\u952E\u51B3\u7B56\u70B9\u8BF4\u660E\n   - \u5E38\u89C1\u9519\u8BEF\u51B3\u7B56\u5206\u6790\n   - \u62D2\u7EDD\u751F\u6210\u7684\u6807\u51C6\u54CD\u5E94\n\n4. **validation-checklist.md** - \u9A8C\u8BC1\u6E05\u5355 \u2B50\u2B50\n   - \u8BE6\u7EC6\u7684\u9A8C\u8BC1\u6D41\u7A0B\n   - 8 \u4E2A\u9636\u6BB5\u7684\u68C0\u67E5\u9879\n   - \u5E38\u89C1\u9519\u8BEF\u68C0\u67E5\n   - \u9A8C\u8BC1\u5DE5\u5177\u4F7F\u7528\n\n5. **code-review.md** - \u4EE3\u7801\u5BA1\u67E5\u6307\u5357\n   - \u5BA1\u67E5\u68C0\u67E5\u6E05\u5355\n   - \u5E38\u89C1\u95EE\u9898\u8BC6\u522B\n   - \u53CD\u9988\u6A21\u677F\n\n6. **refactoring.md** - \u91CD\u6784\u6307\u5357\n   - \u91CD\u6784\u539F\u5219\n   - \u5E38\u89C1\u91CD\u6784\u6A21\u5F0F\n   - \u6027\u80FD\u4F18\u5316\u6280\u5DE7\n\n## \uD83D\uDE80 \u4F7F\u7528\u65B9\u6CD5\n\n### \u5BF9\u4E8E\u5F00\u53D1\u8005\n\n1. **\u9996\u6B21\u5F00\u53D1\u524D**\uFF1A\u9605\u8BFB `project-guide.md` \u4E86\u89E3\u9879\u76EE\u6982\u51B5\n2. **\u7F16\u5199 TSX \u4EE3\u7801\u524D**\uFF1A\u8BE6\u7EC6\u9605\u8BFB `tsx-generation.md`\n3. **\u4EE3\u7801\u9A8C\u8BC1**\uFF1A\u4F7F\u7528 `validation-checklist.md` \u8FDB\u884C\u81EA\u67E5\n4. **\u4EE3\u7801\u5BA1\u67E5**\uFF1A\u53C2\u8003 `code-review.md` \u8FDB\u884C\u5BA1\u67E5\n\n### \u5BF9\u4E8E AI \u5DE5\u5177\n\n\u6839\u636E\u4F60\u4F7F\u7528\u7684 AI \u5DE5\u5177\uFF0C\u5C06\u63D0\u793A\u8BCD\u6DFB\u52A0\u5230\u5BF9\u5E94\u7684\u914D\u7F6E\u4E2D\uFF1A\n\n#### Claude Code\n\u5728\u5BF9\u8BDD\u4E2D\u76F4\u63A5\u5F15\u7528\u8FD9\u4E9B\u63D0\u793A\u8BCD\uFF0C\u6216\u8005\u6DFB\u52A0\u5230\u9879\u76EE\u7684 `.claude/` \u914D\u7F6E\u4E2D\u3002\n\n#### Cursor\n\u5C06\u63D0\u793A\u8BCD\u5185\u5BB9\u6DFB\u52A0\u5230 `.cursor/rules.md` \u6587\u4EF6\u4E2D\u3002\n\n#### Windsurf\n\u5C06\u63D0\u793A\u8BCD\u6DFB\u52A0\u5230 Cascade \u914D\u7F6E\u4E2D\u3002\n\n#### \u963F\u91CC\u4E91 Coder\n\u5728 Coder \u7684\u8BBE\u7F6E\u4E2D\u6DFB\u52A0\u81EA\u5B9A\u4E49\u63D0\u793A\u8BCD\u3002\n\n#### Augment\n\u5C06\u63D0\u793A\u8BCD\u6DFB\u52A0\u5230 `.augment/context/` \u76EE\u5F55\u4E2D\u3002\n\n## \u26A0\uFE0F \u91CD\u8981\u63D0\u793A\n\n### TSX \u4EE3\u7801\u5FC5\u987B\u7B26\u5408\u89C4\u8303\n- \u4E0D\u7B26\u5408\u89C4\u8303\u7684\u4EE3\u7801\u65E0\u6CD5\u5728\u4F4E\u4EE3\u7801\u7CFB\u7EDF\u4E2D\u5BFC\u5165\n- \u5FC5\u987B\u4F7F\u7528 `appthen check-tsx` \u8FDB\u884C\u9A8C\u8BC1\n- \u7981\u6B62\u4F7F\u7528\u6807\u51C6\u7684 lint/format \u5DE5\u5177\n\n### AI \u5DE5\u5177\u914D\u7F6E\n- \u5C06\u8FD9\u4E9B\u63D0\u793A\u8BCD\u6587\u4EF6\u6DFB\u52A0\u5230 AI \u5DE5\u5177\u7684\u4E0A\u4E0B\u6587\u4E2D\n- \u786E\u4FDD AI \u7406\u89E3\u5E76\u9075\u5B88\u6240\u6709\u7EA6\u675F\n- \u5F53\u4E0D\u786E\u5B9A\u65F6\uFF0CAI \u5E94\u8BE5\u62D2\u7EDD\u751F\u6210\u800C\u4E0D\u662F\u5192\u9669\n\n## \uD83D\uDEE0\uFE0F \u81EA\u5B9A\u4E49\u63D0\u793A\u8BCD\n\n\u4F60\u53EF\u4EE5\u6839\u636E\u9879\u76EE\u9700\u6C42\u6DFB\u52A0\u81EA\u5B9A\u4E49\u63D0\u793A\u8BCD\u6587\u4EF6\uFF1A\n\n- `api-design.md`: API \u8BBE\u8BA1\u89C4\u8303\n- `testing.md`: \u6D4B\u8BD5\u7F16\u5199\u6307\u5357\n- `styling.md`: \u6837\u5F0F\u7F16\u5199\u89C4\u8303\n- `performance.md`: \u6027\u80FD\u4F18\u5316\u6307\u5357\n- `backend-guide.md`: \u540E\u7AEF\u5F00\u53D1\u6307\u5357\uFF08midwayjs\uFF09\n\n## \uD83D\uDD04 \u66F4\u65B0\u63D0\u793A\u8BCD\n\n\u63D0\u793A\u8BCD\u4F1A\u968F\u7740\u9879\u76EE\u89C4\u8303\u7684\u6F14\u8FDB\u800C\u66F4\u65B0\uFF1A\n- \u5B9A\u671F\u68C0\u67E5\u5E76\u66F4\u65B0\u8FD9\u4E9B\u6587\u4EF6\n- \u6839\u636E\u5B9E\u9645\u95EE\u9898\u8865\u5145\u65B0\u7684\u89C4\u5219\n- \u8BB0\u5F55\u5E38\u89C1\u9519\u8BEF\u548C\u89E3\u51B3\u65B9\u6848\n\n## \uD83D\uDCAC \u53CD\u9988\u548C\u6539\u8FDB\n\n\u5982\u679C\u4F60\u53D1\u73B0\u63D0\u793A\u8BCD\u6709\u95EE\u9898\u6216\u6709\u6539\u8FDB\u5EFA\u8BAE\uFF1A\n- \u5728\u9879\u76EE\u4E2D\u521B\u5EFA Issue\n- \u76F4\u63A5\u4FEE\u6539\u63D0\u793A\u8BCD\u6587\u4EF6\u5E76\u63D0\u4EA4 PR\n- \u4E0E\u56E2\u961F\u5206\u4EAB\u4F60\u7684\u7ECF\u9A8C\n\n---\n\n**\u8BB0\u4F4F\uFF1A\u9075\u5B88\u89C4\u8303\u662F\u6210\u529F\u7684\u5173\u952E\uFF01** \uD83C\uDFAF\n";
+                fs__namespace.writeFileSync(readmePath, readmeContent);
+                if (this.verbose) {
+                    console.log("\uD83D\uDCDD \u521B\u5EFA\u63D0\u793A\u8BCD README: ".concat(readmePath));
+                }
+                return [2 /*return*/, readmePath];
+            });
+        });
+    };
+    /**
+     * 复制模板文件到提示词目录
+     */
+    BaseGenerator.prototype.copyTemplateFiles = function (promptsDir) {
+        return __awaiter(this, void 0, void 0, function () {
+            var files, projectGuidePath, projectGuideContent, tsxGenerationPath, tsxGenerationContent, decisionTreePath, decisionTreeContent, validationPath, validationContent, codeReviewPath, codeReviewContent, refactoringPath, refactoringContent;
+            return __generator(this, function (_a) {
+                files = [];
+                projectGuidePath = path__namespace.join(promptsDir, 'project-guide.md');
+                projectGuideContent = this.getProjectGuideTemplate();
+                fs__namespace.writeFileSync(projectGuidePath, projectGuideContent);
+                files.push(projectGuidePath);
+                if (this.verbose) {
+                    console.log("\uD83D\uDCDD \u521B\u5EFA\u6A21\u677F\u6587\u4EF6: project-guide.md");
+                }
+                tsxGenerationPath = path__namespace.join(promptsDir, 'tsx-generation.md');
+                tsxGenerationContent = this.getTsxGenerationTemplate();
+                fs__namespace.writeFileSync(tsxGenerationPath, tsxGenerationContent);
+                files.push(tsxGenerationPath);
+                if (this.verbose) {
+                    console.log("\uD83D\uDCDD \u521B\u5EFA\u6A21\u677F\u6587\u4EF6: tsx-generation.md");
+                }
+                decisionTreePath = path__namespace.join(promptsDir, 'decision-tree.md');
+                decisionTreeContent = this.getDecisionTreeTemplate();
+                fs__namespace.writeFileSync(decisionTreePath, decisionTreeContent);
+                files.push(decisionTreePath);
+                if (this.verbose) {
+                    console.log("\uD83D\uDCDD \u521B\u5EFA\u6A21\u677F\u6587\u4EF6: decision-tree.md");
+                }
+                validationPath = path__namespace.join(promptsDir, 'validation-checklist.md');
+                validationContent = this.getValidationChecklistTemplate();
+                fs__namespace.writeFileSync(validationPath, validationContent);
+                files.push(validationPath);
+                if (this.verbose) {
+                    console.log("\uD83D\uDCDD \u521B\u5EFA\u6A21\u677F\u6587\u4EF6: validation-checklist.md");
+                }
+                codeReviewPath = path__namespace.join(promptsDir, 'code-review.md');
+                codeReviewContent = this.getCodeReviewTemplate();
+                fs__namespace.writeFileSync(codeReviewPath, codeReviewContent);
+                files.push(codeReviewPath);
+                if (this.verbose) {
+                    console.log("\uD83D\uDCDD \u521B\u5EFA\u6A21\u677F\u6587\u4EF6: code-review.md");
+                }
+                refactoringPath = path__namespace.join(promptsDir, 'refactoring.md');
+                refactoringContent = this.getRefactoringTemplate();
+                fs__namespace.writeFileSync(refactoringPath, refactoringContent);
+                files.push(refactoringPath);
+                if (this.verbose) {
+                    console.log("\uD83D\uDCDD \u521B\u5EFA\u6A21\u677F\u6587\u4EF6: refactoring.md");
+                }
+                return [2 /*return*/, files];
+            });
+        });
+    };
+    /**
+     * 获取项目开发总指南模板内容
+     */
+    BaseGenerator.prototype.getProjectGuideTemplate = function () {
+        return "# Appthen \u9879\u76EE\u5F00\u53D1\u89C4\u8303\n\n## \uD83D\uDCCB \u9879\u76EE\u6982\u8FF0\n\n\u672C\u9879\u76EE\u662F **Appthen \u4F4E\u4EE3\u7801\u5E73\u53F0**\uFF0C\u652F\u6301\u7528\u9AD8\u4EE3\u7801\u5F00\u53D1\u4F4E\u4EE3\u7801\u7CFB\u7EDF\u4E2D\u7684 React \u9875\u9762\u548C\u7EC4\u4EF6\u3002\n\n### \u9879\u76EE\u7ED3\u6784\n\n- **app/** - \u524D\u7AEF\u4EE3\u7801\uFF08\u540C\u6B65\u81EA\u4F4E\u4EE3\u7801\u4EA7\u54C1 Appthen\uFF09\n  - \u4F7F\u7528\u7279\u6B8A\u89C4\u8303\u7684 TSX \u5B9E\u73B0 React \u9875\u9762\u548C\u7EC4\u4EF6\n  - \u4EE3\u7801\u4F1A\u88AB\u4F4E\u4EE3\u7801\u7CFB\u7EDF\u89E3\u6790\u548C\u5BFC\u5165\n- **server/** - \u540E\u7AEF\u4EE3\u7801\uFF08\u57FA\u4E8E cool-admin \u548C midwayjs\uFF09\n  - \u4F7F\u7528 midwayjs \u6846\u67B6\u5F00\u53D1\u540E\u7AEF\u670D\u52A1\n  - \u63D0\u4F9B\u63A5\u53E3\u3001\u6570\u636E\u5B57\u6BB5\u3001\u4E1A\u52A1\u6D41\u7A0B\u7B49\u4FE1\u606F\n\n---\n\n## \uD83D\uDEA8 \u91CD\u8981\uFF1A\u5F00\u53D1\u524D\u5FC5\u8BFB\n\n### \u524D\u7AEF\u5F00\u53D1\u89C4\u8303\n\n**[\u5173\u952E] \u5F00\u53D1 React \u9875\u9762\u548C\u7EC4\u4EF6\uFF08TSX \u6587\u4EF6\uFF09\u65F6\uFF1A**\n\n1. **\u5FC5\u987B\u5148\u9605\u8BFB** `.appthen/prompts/tsx-generation.md`\n   - \u4E86\u89E3\u7279\u6B8A\u7684 TSX \u8BED\u6CD5\u89C4\u8303\n   - \u4E25\u683C\u9075\u5B88\u975E\u5E38\u89C4\u7684 TSX/JSX \u8BED\u6CD5\u8981\u6C42\n\n2. **\u5FC5\u987B\u8FDB\u884C\u9A8C\u8BC1**\n   - \u8BFB\u5199 TSX \u6587\u4EF6\u540E\uFF0C\u8C03\u7528\u547D\u4EE4\u9A8C\u8BC1\u8BED\u6CD5\uFF1A\n     ```bash\n     appthen check-tsx -f \"app/src/pages/YourPage.tsx\"\n     ```\n   - \u5982\u4E0D\u7B26\u5408\u89C4\u8303\uFF0C\u6839\u636E\u9A8C\u8BC1\u7ED3\u679C\u8FDB\u884C\u4FEE\u6B63\n\n3. **\u7981\u6B62\u4F7F\u7528\u6807\u51C6\u5DE5\u5177**\n   - \u274C \u4E0D\u8981\u8FD0\u884C `eslint`\u3001`prettier`\u3001`tsc` \u7B49\u6807\u51C6\u5DE5\u5177\n   - \u274C \u8FD9\u4E9B\u5DE5\u5177\u4F1A\u7834\u574F\u6211\u4EEC\u7684\u7279\u6B8A TSX \u8BED\u6CD5\n   - \u2705 \u53EA\u4F7F\u7528 `appthen check-tsx` \u8FDB\u884C\u9A8C\u8BC1\n\n---\n\n## \uD83C\uDFAF \u4E1A\u52A1\u5F00\u53D1\u6D41\u7A0B\n\n### 1. \u83B7\u53D6\u63A5\u53E3\u4FE1\u606F\n\n\u4ECE server \u7AEF\u83B7\u53D6\u63A5\u53E3\u5BF9\u63A5\u6240\u9700\u7684\u76F8\u5173\u4FE1\u606F\uFF1A\n- \u63A5\u53E3\u5730\u5740\u548C\u53C2\u6570\n- \u6570\u636E\u5B57\u6BB5\u5B9A\u4E49\n- \u4E1A\u52A1\u6D41\u7A0B\u8BF4\u660E\n\n### 2. \u5F00\u53D1\u524D\u7AEF\u754C\u9762\n\n\u6839\u636E\u63A5\u53E3\u4FE1\u606F\u5F00\u53D1\u524D\u7AEF\u754C\u9762\uFF1A\n- \u4F7F\u7528 TSX \u7279\u6B8A\u8BED\u6CD5\n- \u9075\u5B88\u4E25\u683C\u7684 render() \u65B9\u6CD5\u7EA6\u675F\n- \u4F7F\u7528 @DataSource \u88C5\u9970\u5668\u5BF9\u63A5\u63A5\u53E3\n\n### 3. \u9A8C\u8BC1\u548C\u6D4B\u8BD5\n\n- \u4F7F\u7528 `appthen check-tsx` \u9A8C\u8BC1\u8BED\u6CD5\n- \u5728\u4F4E\u4EE3\u7801\u7CFB\u7EDF\u4E2D\u5BFC\u5165\u6D4B\u8BD5\n- \u786E\u4FDD\u529F\u80FD\u6B63\u5E38\n\n---\n\n## \uD83D\uDCDA \u76F8\u5173\u6587\u6863\n\n- **tsx-generation.md** - TSX \u4EE3\u7801\u751F\u6210\u5B8C\u6574\u89C4\u8303\n- **decision-tree.md** - AI \u51B3\u7B56\u6811\uFF08\u5E2E\u52A9 AI \u505A\u51FA\u6B63\u786E\u51B3\u7B56\uFF09\n- **validation-checklist.md** - \u4EE3\u7801\u9A8C\u8BC1\u6E05\u5355\n- **code-review.md** - \u4EE3\u7801\u5BA1\u67E5\u6307\u5357\n- **refactoring.md** - \u4EE3\u7801\u91CD\u6784\u6307\u5357\n\n---\n\n## \u26A0\uFE0F \u7279\u522B\u6CE8\u610F\n\n### TSX \u8BED\u6CD5\u7684\u7279\u6B8A\u6027\n\n\u6211\u4EEC\u7684 TSX \u8BED\u6CD5\u4E0E\u6807\u51C6 React/TypeScript \u4E0D\u540C\uFF1A\n\n1. **render() \u65B9\u6CD5\u7EA6\u675F**\n   - \u4E0D\u80FD\u6709\u4EFB\u4F55\u53D8\u91CF\u58F0\u660E\n   - \u4E0D\u80FD\u6709\u4EFB\u4F55\u903B\u8F91\u8BED\u53E5\n   - \u53EA\u80FD\u76F4\u63A5\u8BBF\u95EE this.state \u548C this.props\n\n2. **TypeScript \u8BED\u6CD5\u9650\u5236**\n   - \u65B9\u6CD5\u4E0D\u80FD\u6709\u7C7B\u578B\u6CE8\u89E3\n   - \u53EA\u5728 IProps/IState \u4E2D\u4F7F\u7528\u7C7B\u578B\n   - \u4E0D\u80FD\u4F7F\u7528\u6CDB\u578B\uFF08\u9664\u4E86 React.Component\uFF09\n\n3. **JSX \u4F4D\u7F6E\u9650\u5236**\n   - \u53EA\u6709 render() \u65B9\u6CD5\u53EF\u4EE5\u5305\u542B JSX\n   - \u5176\u4ED6\u65B9\u6CD5\u548C\u5C5E\u6027\u4E0D\u80FD\u6709 JSX\n\n### \u4E3A\u4EC0\u4E48\u6709\u8FD9\u4E9B\u9650\u5236\uFF1F\n\n\u8FD9\u4E9B\u9650\u5236\u662F\u4E3A\u4E86\u8BA9\u4F4E\u4EE3\u7801\u7CFB\u7EDF\u80FD\u591F\uFF1A\n- \u89E3\u6790\u548C\u7406\u89E3\u4EE3\u7801\u7ED3\u6784\n- \u63D0\u53D6\u6570\u636E\u6A21\u578B\u548C\u63A5\u53E3\u5B9A\u4E49\n- \u5728\u53EF\u89C6\u5316\u7F16\u8F91\u5668\u4E2D\u7F16\u8F91\n- \u751F\u6210\u7B26\u5408\u89C4\u8303\u7684\u4EE3\u7801\n\n**\u8FDD\u53CD\u89C4\u8303 = \u65E0\u6CD5\u5BFC\u5165\u4F4E\u4EE3\u7801\u7CFB\u7EDF\uFF01**\n\n---\n\n## \uD83D\uDE80 \u5FEB\u901F\u5F00\u59CB\n\n### \u521B\u5EFA\u65B0\u9875\u9762\n\n```bash\n# 1. \u67E5\u770B TSX \u751F\u6210\u89C4\u8303\ncat .appthen/prompts/tsx-generation.md\n\n# 2. \u521B\u5EFA\u9875\u9762\u6587\u4EF6\n# \u4F7F\u7528 AI \u5DE5\u5177\u751F\u6210\uFF0C\u786E\u4FDD\u9075\u5B88\u89C4\u8303\n\n# 3. \u9A8C\u8BC1\u8BED\u6CD5\nappthen check-tsx -f \"app/src/pages/NewPage.tsx\"\n\n# 4. \u4FEE\u6B63\u9519\u8BEF\uFF08\u5982\u679C\u6709\uFF09\n# \u6839\u636E\u9A8C\u8BC1\u7ED3\u679C\u4FEE\u6B63\u4EE3\u7801\n\n# 5. \u5728\u4F4E\u4EE3\u7801\u7CFB\u7EDF\u4E2D\u5BFC\u5165\u6D4B\u8BD5\n```\n\n### \u4FEE\u6539\u73B0\u6709\u9875\u9762\n\n```bash\n# 1. \u67E5\u770B\u73B0\u6709\u4EE3\u7801\ncat app/src/pages/ExistingPage.tsx\n\n# 2. \u4FEE\u6539\u4EE3\u7801\uFF08\u9075\u5B88\u89C4\u8303\uFF09\n\n# 3. \u9A8C\u8BC1\u8BED\u6CD5\nappthen check-tsx -f \"app/src/pages/ExistingPage.tsx\"\n\n# 4. \u6D4B\u8BD5\u529F\u80FD\n```\n\n---\n\n## \uD83D\uDCA1 \u6700\u4F73\u5B9E\u8DF5\n\n1. **\u59CB\u7EC8\u5148\u9605\u8BFB\u89C4\u8303** - \u4E0D\u8981\u51ED\u7ECF\u9A8C\u5199\u4EE3\u7801\n2. **\u9891\u7E41\u9A8C\u8BC1** - \u6BCF\u6B21\u4FEE\u6539\u540E\u90FD\u8FD0\u884C check-tsx\n3. **\u53C2\u8003\u793A\u4F8B** - \u67E5\u770B\u73B0\u6709\u9875\u9762\u7684\u5B9E\u73B0\u65B9\u5F0F\n4. **\u4F7F\u7528 AI \u8F85\u52A9** - \u8BA9 AI \u9075\u5B88\u89C4\u8303\u751F\u6210\u4EE3\u7801\n5. **\u6D4B\u8BD5\u5BFC\u5165** - \u786E\u4FDD\u80FD\u5728\u4F4E\u4EE3\u7801\u7CFB\u7EDF\u4E2D\u6B63\u5E38\u5BFC\u5165\n\n---\n\n## \uD83C\uDD98 \u9047\u5230\u95EE\u9898\uFF1F\n\n1. **\u8BED\u6CD5\u9A8C\u8BC1\u5931\u8D25** \u2192 \u67E5\u770B validation-checklist.md\n2. **\u4E0D\u77E5\u9053\u5982\u4F55\u5B9E\u73B0** \u2192 \u67E5\u770B tsx-generation.md \u4E2D\u7684\u793A\u4F8B\n3. **AI \u751F\u6210\u9519\u8BEF\u4EE3\u7801** \u2192 \u67E5\u770B decision-tree.md \u4E86\u89E3 AI \u51B3\u7B56\u6D41\u7A0B\n4. **\u9700\u8981\u91CD\u6784\u4EE3\u7801** \u2192 \u67E5\u770B refactoring.md\n\n---\n\n**\u8BB0\u4F4F\uFF1A\u9075\u5B88\u89C4\u8303\u662F\u6210\u529F\u7684\u5173\u952E\uFF01** \uD83C\uDFAF\n";
+    };
+    /**
+     * 获取 TSX 生成模板内容
+     */
+    BaseGenerator.prototype.getTsxGenerationTemplate = function () {
+        return "# TSX \u4EE3\u7801\u751F\u6210\u89C4\u8303\n\n\u751F\u6210\u7B26\u5408\u5E73\u53F0\u89C4\u8303\u7684 TSX \u4EE3\u7801\u65F6\uFF0C\u8BF7\u9075\u5FAA\u4EE5\u4E0B\u89C4\u5219\uFF1A\n\n## 1. \u6587\u4EF6\u7ED3\u6784\n\n```typescript\n/**\n * @type Page|Component\n * @description \u7EC4\u4EF6\u63CF\u8FF0\n */\n\nimport React from 'react';\n\nclass IProps {\n  // Props \u5B9A\u4E49\n}\n\nclass IState {\n  // State \u5B9A\u4E49\n}\n\nclass Document extends React.Component<IProps, IState> {\n  render() {\n    return (\n      // JSX\n    );\n  }\n}\n\nexport default Document;\n```\n\n## 2. \u5173\u952E\u89C4\u5219\n\n- \u2705 \u5FC5\u987B\u5305\u542B JSDoc \u5143\u6570\u636E\u6CE8\u91CA\n- \u2705 \u4F7F\u7528 class IProps \u548C class IState\n- \u2705 render() \u65B9\u6CD5\u53EA\u5305\u542B return \u8BED\u53E5\n- \u2705 \u4F7F\u7528 && \u8FD0\u7B97\u7B26\u8FDB\u884C\u6761\u4EF6\u6E32\u67D3\n- \u274C \u907F\u514D\u5728 render() \u4E2D\u4F7F\u7528\u4E09\u5143\u8868\u8FBE\u5F0F\n- \u274C \u907F\u514D\u5728\u65B9\u6CD5\u4E2D\u4F7F\u7528 TypeScript \u7C7B\u578B\u6CE8\u89E3\n\n\u8BE6\u7EC6\u89C4\u8303\u8BF7\u53C2\u8003\u9879\u76EE\u6587\u6863\u3002\n";
+    };
+    /**
+     * 获取决策树模板内容
+     */
+    BaseGenerator.prototype.getDecisionTreeTemplate = function () {
+        return "# AI \u51B3\u7B56\u6811 - TSX \u4EE3\u7801\u751F\u6210\u51B3\u7B56\u6307\u5357\n\n## \uD83C\uDFAF \u76EE\u7684\n\n\u5E2E\u52A9 AI \u5728\u751F\u6210 TSX \u4EE3\u7801\u65F6\u505A\u51FA\u6B63\u786E\u7684\u51B3\u7B56\uFF0C\u907F\u514D\u5E38\u89C1\u9519\u8BEF\u3002\n\n---\n\n## \uD83D\uDCCA \u51B3\u7B56\u6D41\u7A0B\u56FE\n\n```\n\u7528\u6237\u8BF7\u6C42\n    \u2193\n\u662F\u5426\u6D89\u53CA TSX \u6587\u4EF6\uFF1F\n    \u251C\u2500 \u5426 \u2192 \u6B63\u5E38\u5904\u7406\n    \u2514\u2500 \u662F \u2192 \u8FDB\u5165 TSX \u51B3\u7B56\u6D41\u7A0B\n         \u2193\n    \u662F\u5426\u662F\"\u521B\u5EFA\u9875\u9762/\u7EC4\u4EF6\"\uFF1F\n         \u251C\u2500 \u662F \u2192 [\u9AD8\u5EA6\u8B66\u6212] \u8FDB\u5165\u9875\u9762/\u7EC4\u4EF6\u751F\u6210\u6D41\u7A0B\n         \u2502        \u2193\n         \u2502   \u6267\u884C\u9884\u751F\u6210\u9A8C\u8BC1\u6E05\u5355\n         \u2502        \u2193\n         \u2502   \u6240\u6709\u68C0\u67E5\u901A\u8FC7\uFF1F\n         \u2502        \u251C\u2500 \u5426 \u2192 \u62D2\u7EDD\u751F\u6210\uFF0C\u8FD4\u56DE\u9519\u8BEF\u63D0\u793A\n         \u2502        \u2514\u2500 \u662F \u2192 \u751F\u6210\u5B8C\u6574 TSX \u6587\u4EF6\n         \u2502                \u2193\n         \u2502           \u5305\u542B\u6240\u6709\u5FC5\u9700\u7ED3\u6784\uFF1F\n         \u2502                \u251C\u2500 \u5426 \u2192 \u62D2\u7EDD\u751F\u6210\n         \u2502                \u2514\u2500 \u662F \u2192 \u8FD4\u56DE\u4EE3\u7801\n         \u2502\n         \u2514\u2500 \u5426 \u2192 \u662F\u5426\u4FEE\u6539\u73B0\u6709 TSX\uFF1F\n                  \u251C\u2500 \u662F \u2192 \u68C0\u67E5\u4FEE\u6539\u5185\u5BB9\n                  \u2502        \u2193\n                  \u2502   \u662F\u5426\u4FEE\u6539 render() \u65B9\u6CD5\uFF1F\n                  \u2502        \u251C\u2500 \u662F \u2192 [\u9AD8\u5EA6\u8B66\u6212] \u68C0\u67E5\u7EA6\u675F\n                  \u2502        \u2502        \u2193\n                  \u2502        \u2502   \u662F\u5426\u8FDD\u53CD\u7EA6\u675F\uFF1F\n                  \u2502        \u2502        \u251C\u2500 \u662F \u2192 \u62D2\u7EDD\u4FEE\u6539\n                  \u2502        \u2502        \u2514\u2500 \u5426 \u2192 \u5141\u8BB8\u4FEE\u6539\n                  \u2502        \u2514\u2500 \u5426 \u2192 \u6B63\u5E38\u4FEE\u6539\n                  \u2502\n                  \u2514\u2500 \u5426 \u2192 \u5176\u4ED6\u64CD\u4F5C\uFF08\u67E5\u770B\u3001\u5206\u6790\u7B49\uFF09\n```\n\n---\n\n## \uD83D\uDEA8 \u5173\u952E\u51B3\u7B56\u70B9\n\n### \u51B3\u7B56\u70B9 1\uFF1A\u8BC6\u522B TSX \u64CD\u4F5C\n\n**\u89E6\u53D1\u8BCD\u6C47\uFF1A**\n- \"\u521B\u5EFA\u9875\u9762\" / \"\u751F\u6210\u9875\u9762\" / \"\u5199\u4E2A\u9875\u9762\"\n- \"\u521B\u5EFA\u7EC4\u4EF6\" / \"\u751F\u6210\u7EC4\u4EF6\" / \"\u5199\u4E2A\u7EC4\u4EF6\"\n- \"\u4FEE\u6539 XXX.tsx\" / \"\u66F4\u65B0\u9875\u9762\"\n- \"\u6DFB\u52A0\u529F\u80FD\u5230\u9875\u9762\"\n\n**\u51B3\u7B56\uFF1A**\n- \u5982\u679C\u5305\u542B\u4EE5\u4E0A\u8BCD\u6C47 \u2192 \u8FDB\u5165 TSX \u51B3\u7B56\u6D41\u7A0B\n- \u5426\u5219 \u2192 \u6B63\u5E38\u5904\u7406\n\n---\n\n### \u51B3\u7B56\u70B9 2\uFF1A\u9875\u9762/\u7EC4\u4EF6\u751F\u6210\n\n**\u5224\u65AD\u6807\u51C6\uFF1A**\n- \u7528\u6237\u660E\u786E\u8981\u6C42\"\u521B\u5EFA\"\u6216\"\u751F\u6210\"\n- \u6CA1\u6709\u6307\u5B9A\u73B0\u6709\u6587\u4EF6\n\n**\u51B3\u7B56\uFF1A**\n- \u662F\u9875\u9762/\u7EC4\u4EF6\u751F\u6210 \u2192 \u6267\u884C\u5B8C\u6574\u9A8C\u8BC1\u6E05\u5355\n- \u5426 \u2192 \u8FDB\u5165\u4E0B\u4E00\u4E2A\u51B3\u7B56\u70B9\n\n**\u5FC5\u987B\u6267\u884C\u7684\u68C0\u67E5\uFF1A**\n1. \u2705 \u6211\u662F\u5426\u8981\u751F\u6210\u5B8C\u6574\u7684 TSX \u6587\u4EF6\uFF1F\n2. \u2705 \u6211\u662F\u5426\u5305\u542B\u4E86\u6240\u6709\u5FC5\u9700\u7ED3\u6784\uFF1F\n3. \u2705 \u6211\u662F\u5426\u9075\u5B88\u4E86 render() \u65B9\u6CD5\u7EA6\u675F\uFF1F\n4. \u2705 \u6211\u662F\u5426\u907F\u514D\u4E86 TypeScript \u7C7B\u578B\u6CE8\u89E3\uFF1F\n5. \u2705 \u6211\u662F\u5426\u53EA\u5728 render() \u4E2D\u4F7F\u7528 JSX\uFF1F\n\n**\u5982\u679C\u4EFB\u4F55\u4E00\u9879\u4E0D\u786E\u5B9A \u2192 \u62D2\u7EDD\u751F\u6210\uFF01**\n\n---\n\n### \u51B3\u7B56\u70B9 3\uFF1Arender() \u65B9\u6CD5\u4FEE\u6539\n\n**\u5224\u65AD\u6807\u51C6\uFF1A**\n- \u4FEE\u6539\u6D89\u53CA render() \u65B9\u6CD5\u5185\u90E8\n\n**\u51B3\u7B56\uFF1A**\n- \u662F render() \u4FEE\u6539 \u2192 \u6267\u884C\u4E25\u683C\u7EA6\u675F\u68C0\u67E5\n- \u5426 \u2192 \u6B63\u5E38\u4FEE\u6539\n\n**\u4E25\u683C\u7EA6\u675F\u68C0\u67E5\uFF1A**\n1. \u274C \u662F\u5426\u6DFB\u52A0\u4E86\u53D8\u91CF\u58F0\u660E\uFF1F \u2192 \u62D2\u7EDD\n2. \u274C \u662F\u5426\u6DFB\u52A0\u4E86\u89E3\u6784\u8D4B\u503C\uFF1F \u2192 \u62D2\u7EDD\n3. \u274C \u662F\u5426\u6DFB\u52A0\u4E86\u903B\u8F91\u8BED\u53E5\uFF1F \u2192 \u62D2\u7EDD\n4. \u274C \u662F\u5426\u6DFB\u52A0\u4E86\u51FD\u6570\u8C03\u7528\uFF1F \u2192 \u62D2\u7EDD\n5. \u2705 \u662F\u5426\u53EA\u662F\u4FEE\u6539 JSX \u7ED3\u6784\uFF1F \u2192 \u5141\u8BB8\n6. \u2705 \u662F\u5426\u53EA\u662F\u4FEE\u6539 this.state \u8BBF\u95EE\uFF1F \u2192 \u5141\u8BB8\n\n---\n\n### \u51B3\u7B56\u70B9 4\uFF1ATypeScript \u8BED\u6CD5\u4F7F\u7528\n\n**\u5224\u65AD\u6807\u51C6\uFF1A**\n- \u4EE3\u7801\u4E2D\u662F\u5426\u4F7F\u7528\u4E86 TypeScript \u8BED\u6CD5\n\n**\u51B3\u7B56\u89C4\u5219\uFF1A**\n\n| \u4F4D\u7F6E | \u5141\u8BB8\u7684 TS \u8BED\u6CD5 | \u7981\u6B62\u7684 TS \u8BED\u6CD5 |\n|------|---------------|---------------|\n| IProps \u63A5\u53E3 | \u2705 string?, number?, any[] | \u274C \u6CDB\u578B Array<T> |\n| IState \u7C7B | \u2705 string?, number?, any[] | \u274C \u6CDB\u578B Array<T> |\n| defaultProps | \u2705 \u7EAF JS \u503C | \u274C \u4EFB\u4F55\u7C7B\u578B\u6CE8\u89E3 |\n| \u7C7B\u65B9\u6CD5 | \u274C \u4EFB\u4F55\u7C7B\u578B\u6CE8\u89E3 | \u274C \u53C2\u6570\u7C7B\u578B\u3001\u8FD4\u56DE\u7C7B\u578B |\n| render() | \u274C \u4EFB\u4F55 TS \u8BED\u6CD5 | \u274C \u6240\u6709 TS \u8BED\u6CD5 |\n| React.Component | \u2705 <IProps, IState> | \u274C \u5176\u4ED6\u6CDB\u578B |\n\n**\u51B3\u7B56\uFF1A**\n- \u5982\u679C\u5728\u7981\u6B62\u4F4D\u7F6E\u4F7F\u7528 TS \u8BED\u6CD5 \u2192 \u62D2\u7EDD\n- \u5982\u679C\u5728\u5141\u8BB8\u4F4D\u7F6E\u6B63\u786E\u4F7F\u7528 \u2192 \u5141\u8BB8\n\n---\n\n### \u51B3\u7B56\u70B9 5\uFF1AJSX \u4F4D\u7F6E\u68C0\u67E5\n\n**\u5224\u65AD\u6807\u51C6\uFF1A**\n- \u4EE3\u7801\u4E2D\u662F\u5426\u5728\u975E render() \u4F4D\u7F6E\u4F7F\u7528 JSX\n\n**\u51B3\u7B56\u89C4\u5219\uFF1A**\n\n| \u4F4D\u7F6E | \u662F\u5426\u5141\u8BB8 JSX | \u793A\u4F8B |\n|------|-------------|------|\n| render() \u65B9\u6CD5 | \u2705 \u5141\u8BB8 | `return <div>...</div>` |\n| \u5176\u4ED6\u65B9\u6CD5 | \u274C \u7981\u6B62 | `handleClick() { return <div>...</div>; }` |\n| \u7C7B\u5C5E\u6027 | \u274C \u7981\u6B62 | `item = <div>...</div>` |\n| \u7BAD\u5934\u51FD\u6570\u5C5E\u6027 | \u274C \u7981\u6B62 | `renderItem = () => <div>...</div>` |\n\n**\u51B3\u7B56\uFF1A**\n- \u5982\u679C\u5728\u7981\u6B62\u4F4D\u7F6E\u4F7F\u7528 JSX \u2192 \u62D2\u7EDD\n- \u5982\u679C\u53EA\u5728 render() \u4E2D\u4F7F\u7528 \u2192 \u5141\u8BB8\n\n---\n\n## \uD83D\uDEE1\uFE0F \u5B89\u5168\u68C0\u67E5\u6E05\u5355\n\n### \u751F\u6210\u4EE3\u7801\u524D\u5FC5\u987B\u56DE\u7B54\u7684\u95EE\u9898\uFF1A\n\n1. **\u7ED3\u6784\u5B8C\u6574\u6027**\n   - [ ] \u662F\u5426\u5305\u542B JSDoc \u5143\u6570\u636E\u6CE8\u91CA\uFF1F\n   - [ ] \u662F\u5426\u5305\u542B IProps \u63A5\u53E3\uFF1F\n   - [ ] \u662F\u5426\u5305\u542B IState \u7C7B\uFF1F\n   - [ ] \u662F\u5426\u5305\u542B Document \u7C7B\uFF1F\n   - [ ] \u662F\u5426\u5305\u542B export default\uFF1F\n\n2. **render() \u65B9\u6CD5\u7EA6\u675F**\n   - [ ] render() \u7B2C\u4E00\u884C\u662F return ( \u5417\uFF1F\n   - [ ] render() \u5185\u90E8\u6CA1\u6709\u53D8\u91CF\u58F0\u660E\u5417\uFF1F\n   - [ ] render() \u5185\u90E8\u6CA1\u6709\u903B\u8F91\u8BED\u53E5\u5417\uFF1F\n   - [ ] render() \u53EA\u8BBF\u95EE this.state/this.props \u5417\uFF1F\n\n3. **TypeScript \u8BED\u6CD5\u9650\u5236**\n   - [ ] \u65B9\u6CD5\u6CA1\u6709\u53C2\u6570\u7C7B\u578B\u6CE8\u89E3\u5417\uFF1F\n   - [ ] \u65B9\u6CD5\u6CA1\u6709\u8FD4\u56DE\u7C7B\u578B\u6CE8\u89E3\u5417\uFF1F\n   - [ ] \u53D8\u91CF\u6CA1\u6709\u7C7B\u578B\u6CE8\u89E3\u5417\uFF1F\n   - [ ] \u6CA1\u6709\u4F7F\u7528\u6CDB\u578B\uFF08\u9664 React.Component\uFF09\u5417\uFF1F\n\n4. **JSX \u4F4D\u7F6E\u9650\u5236**\n   - [ ] JSX \u53EA\u5728 render() \u65B9\u6CD5\u4E2D\u5417\uFF1F\n   - [ ] \u5176\u4ED6\u65B9\u6CD5\u6CA1\u6709 JSX \u5417\uFF1F\n   - [ ] \u7C7B\u5C5E\u6027\u6CA1\u6709 JSX \u5417\uFF1F\n\n5. **\u5BF9\u8C61\u8BBF\u95EE\u5B89\u5168**\n   - [ ] \u5D4C\u5957\u5BF9\u8C61\u4F7F\u7528\u53EF\u9009\u94FE ?. \u5417\uFF1F\n   - [ ] \u6570\u7EC4\u8BBF\u95EE\u524D\u68C0\u67E5\u4E86\u5B58\u5728\u6027\u5417\uFF1F\n\n**\u5982\u679C\u4EFB\u4F55\u4E00\u9879\u56DE\u7B54\"\u5426\" \u2192 \u4E0D\u8981\u751F\u6210\u4EE3\u7801\uFF01**\n\n---\n\n## \uD83D\uDC80 \u5E38\u89C1\u9519\u8BEF\u51B3\u7B56\n\n### \u9519\u8BEF\u51B3\u7B56 1\uFF1A\u8BA4\u4E3A\u53EF\u4EE5\u4F18\u5316 render()\n\n**\u9519\u8BEF\u60F3\u6CD5\uFF1A**\n> \"render() \u65B9\u6CD5\u592A\u957F\u4E86\uFF0C\u6211\u53EF\u4EE5\u63D0\u53D6\u4E00\u4E9B\u53D8\u91CF\u6765\u7B80\u5316\"\n\n**\u6B63\u786E\u51B3\u7B56\uFF1A**\n\u274C **\u7EDD\u5BF9\u4E0D\u884C\uFF01** render() \u65B9\u6CD5\u4E0D\u80FD\u6709\u4EFB\u4F55\u53D8\u91CF\u58F0\u660E\u3002\n\u2705 \u5982\u679C\u9700\u8981\u7B80\u5316\uFF0C\u5E94\u8BE5\u63D0\u53D6\u5230\u7C7B\u65B9\u6CD5\u4E2D\uFF0C\u7136\u540E\u5728 render() \u4E2D\u8C03\u7528\u3002\n\n---\n\n### \u9519\u8BEF\u51B3\u7B56 2\uFF1A\u8BA4\u4E3A TypeScript \u7C7B\u578B\u6CE8\u89E3\u66F4\u597D\n\n**\u9519\u8BEF\u60F3\u6CD5\uFF1A**\n> \"\u6DFB\u52A0\u7C7B\u578B\u6CE8\u89E3\u53EF\u4EE5\u63D0\u9AD8\u4EE3\u7801\u8D28\u91CF\u548C\u7C7B\u578B\u5B89\u5168\"\n\n**\u6B63\u786E\u51B3\u7B56\uFF1A**\n\u274C **\u4E0D\u9002\u7528\u4E8E\u6211\u4EEC\u7684\u67B6\u6784\uFF01** \u65B9\u6CD5\u4E0D\u80FD\u6709\u7C7B\u578B\u6CE8\u89E3\u3002\n\u2705 \u53EA\u5728 IProps/IState \u4E2D\u4F7F\u7528\u7C7B\u578B\u5B9A\u4E49\u3002\n\n---\n\n### \u9519\u8BEF\u51B3\u7B56 3\uFF1A\u8BA4\u4E3A\u53EF\u4EE5\u5728\u65B9\u6CD5\u4E2D\u8FD4\u56DE JSX\n\n**\u9519\u8BEF\u60F3\u6CD5\uFF1A**\n> \"\u6211\u53EF\u4EE5\u521B\u5EFA\u4E00\u4E2A renderItem() \u65B9\u6CD5\u6765\u6E32\u67D3\u5217\u8868\u9879\"\n\n**\u6B63\u786E\u51B3\u7B56\uFF1A**\n\u274C **\u7EDD\u5BF9\u4E0D\u884C\uFF01** \u53EA\u6709 render() \u65B9\u6CD5\u53EF\u4EE5\u5305\u542B JSX\u3002\n\u2705 \u5982\u679C\u9700\u8981\u590D\u6742\u6E32\u67D3\uFF0C\u5728 render() \u4E2D\u4F7F\u7528\u5185\u8054 map\u3002\n\n---\n\n### \u9519\u8BEF\u51B3\u7B56 4\uFF1A\u8BA4\u4E3A\u53EF\u4EE5\u8FD0\u884C lint \u5DE5\u5177\n\n**\u9519\u8BEF\u60F3\u6CD5\uFF1A**\n> \"\u4EE3\u7801\u6709\u4E00\u4E9B\u683C\u5F0F\u95EE\u9898\uFF0C\u6211\u8FD0\u884C eslint --fix \u4FEE\u590D\u4E00\u4E0B\"\n\n**\u6B63\u786E\u51B3\u7B56\uFF1A**\n\u274C **\u7EDD\u5BF9\u4E0D\u884C\uFF01** lint \u5DE5\u5177\u4F1A\u7834\u574F\u6211\u4EEC\u7684\u7279\u6B8A\u8BED\u6CD5\u3002\n\u2705 \u53EA\u4F7F\u7528 `appthen check-tsx` \u8FDB\u884C\u9A8C\u8BC1\u3002\n\n---\n\n## \uD83C\uDFAF \u51B3\u7B56\u4F18\u5148\u7EA7\n\n### \u4F18\u5148\u7EA7 1\uFF1A\u5B89\u5168\u6027\uFF08\u6700\u9AD8\uFF09\n- \u4E0D\u7834\u574F\u73B0\u6709\u89C4\u8303\n- \u4E0D\u751F\u6210\u8FDD\u53CD\u7EA6\u675F\u7684\u4EE3\u7801\n- \u4E0D\u6267\u884C\u5371\u9669\u547D\u4EE4\n\n### \u4F18\u5148\u7EA7 2\uFF1A\u5B8C\u6574\u6027\n- \u751F\u6210\u5B8C\u6574\u7684\u6587\u4EF6\u7ED3\u6784\n- \u5305\u542B\u6240\u6709\u5FC5\u9700\u5143\u7D20\n- \u9075\u5B88\u6240\u6709\u7EA6\u675F\n\n### \u4F18\u5148\u7EA7 3\uFF1A\u529F\u80FD\u6027\n- \u5B9E\u73B0\u7528\u6237\u9700\u6C42\n- \u63D0\u4F9B\u6B63\u786E\u7684\u529F\u80FD\n- \u4F18\u5316\u7528\u6237\u4F53\u9A8C\n\n**\u5F53\u4F18\u5148\u7EA7\u51B2\u7A81\u65F6\uFF0C\u5B89\u5168\u6027 > \u5B8C\u6574\u6027 > \u529F\u80FD\u6027**\n\n---\n\n## \uD83D\uDEAB \u62D2\u7EDD\u751F\u6210\u7684\u6807\u51C6\u54CD\u5E94\n\n\u5F53\u51B3\u7B56\u7ED3\u679C\u662F\"\u62D2\u7EDD\"\u65F6\uFF0C\u4F7F\u7528\u4EE5\u4E0B\u54CD\u5E94\u6A21\u677F\uFF1A\n\n```\n\uD83D\uDEA8 **\u65E0\u6CD5\u751F\u6210\u4EE3\u7801** \uD83D\uDEA8\n\n**\u539F\u56E0**: [\u5177\u4F53\u8BF4\u660E\u8FDD\u53CD\u4E86\u54EA\u4E2A\u7EA6\u675F]\n\n**\u95EE\u9898**: [\u8BE6\u7EC6\u63CF\u8FF0\u95EE\u9898]\n\n**\u6B63\u786E\u505A\u6CD5**:\n[\u63D0\u4F9B\u6B63\u786E\u7684\u5B9E\u73B0\u65B9\u5F0F\u6216\u66FF\u4EE3\u65B9\u6848]\n\n**\u793A\u4F8B**:\n[\u63D0\u4F9B\u6B63\u786E\u7684\u4EE3\u7801\u793A\u4F8B]\n\n\u8BF7\u6309\u7167\u6B63\u786E\u505A\u6CD5\u4FEE\u6539\u9700\u6C42\uFF0C\u7136\u540E\u91CD\u65B0\u63D0\u4EA4\u3002\n```\n\n---\n\n## \uD83D\uDCDA \u76F8\u5173\u6587\u6863\n\n- **tsx-generation.md** - \u5B8C\u6574\u7684 TSX \u751F\u6210\u89C4\u8303\n- **validation-checklist.md** - \u8BE6\u7EC6\u7684\u9A8C\u8BC1\u6E05\u5355\n- **project-guide.md** - \u9879\u76EE\u5F00\u53D1\u603B\u6307\u5357\n\n---\n\n**\u8BB0\u4F4F\uFF1A\u5F53\u4E0D\u786E\u5B9A\u65F6\uFF0C\u9009\u62E9\u62D2\u7EDD\u800C\u4E0D\u662F\u5192\u9669\uFF01** \uD83D\uDEE1\uFE0F\n";
+    };
+    /**
+     * 获取验证清单模板内容
+     */
+    BaseGenerator.prototype.getValidationChecklistTemplate = function () {
+        return "# TSX \u4EE3\u7801\u9A8C\u8BC1\u6E05\u5355\n\n## \uD83C\uDFAF \u76EE\u7684\n\n\u63D0\u4F9B\u8BE6\u7EC6\u7684\u9A8C\u8BC1\u6E05\u5355\uFF0C\u786E\u4FDD\u751F\u6210\u7684 TSX \u4EE3\u7801\u7B26\u5408\u6240\u6709\u89C4\u8303\u8981\u6C42\u3002\n\n---\n\n## \u2705 \u9A8C\u8BC1\u6D41\u7A0B\n\n### \u9636\u6BB5 1\uFF1A\u7ED3\u6784\u9A8C\u8BC1\uFF08\u5FC5\u987B\u5168\u90E8\u901A\u8FC7\uFF09\n\n- [ ] **\u6587\u4EF6\u5934\u90E8\u5143\u6570\u636E**\n  - [ ] \u5305\u542B JSDoc \u6CE8\u91CA\n  - [ ] \u5305\u542B @type Page \u6216 @type Component\n  - [ ] \u6807\u9898\u63CF\u8FF0\u6E05\u6670\n\n- [ ] **\u5BFC\u5165\u8BED\u53E5**\n  - [ ] \u5305\u542B `import React from 'react';`\n  - [ ] \u5176\u4ED6\u5BFC\u5165\u8BED\u53E5\u6B63\u786E\n\n- [ ] **IProps \u63A5\u53E3**\n  - [ ] \u4F7F\u7528 `interface IProps` \u5B9A\u4E49\n  - [ ] \u5C5E\u6027\u4F7F\u7528\u53EF\u9009\u7C7B\u578B\uFF08?\uFF09\n  - [ ] \u53EA\u4F7F\u7528\u57FA\u7840\u7C7B\u578B\uFF08string, number, boolean, any[], Function\uFF09\n\n- [ ] **IState \u7C7B**\n  - [ ] \u4F7F\u7528 `class IState` \u5B9A\u4E49\n  - [ ] \u5C5E\u6027\u4F7F\u7528\u53EF\u9009\u7C7B\u578B\uFF08?\uFF09\n  - [ ] \u5305\u542B\u5FC5\u8981\u7684\u6CE8\u91CA\u8BF4\u660E\n  - [ ] @DataSource \u88C5\u9970\u5668\u914D\u7F6E\u6B63\u786E\uFF08\u5982\u679C\u6709\uFF09\n\n- [ ] **Document \u7C7B**\n  - [ ] \u4F7F\u7528 `class Document extends React.Component<IProps, IState>`\n  - [ ] \u5305\u542B static defaultProps\uFF08\u5982\u679C\u9700\u8981\uFF09\n  - [ ] \u5305\u542B state \u521D\u59CB\u5316\n  - [ ] \u5305\u542B render() \u65B9\u6CD5\n\n- [ ] **\u5BFC\u51FA\u8BED\u53E5**\n  - [ ] \u5305\u542B `export default Document;`\n\n---\n\n### \u9636\u6BB5 2\uFF1Arender() \u65B9\u6CD5\u9A8C\u8BC1\uFF08\u96F6\u5BB9\u5FCD\uFF09\n\n- [ ] **\u7ED3\u6784\u68C0\u67E5**\n  - [ ] \u7B2C\u4E00\u884C\u662F `return (`\n  - [ ] \u6700\u540E\u4E00\u884C\u662F `);`\n  - [ ] \u6CA1\u6709\u5176\u4ED6\u8BED\u53E5\n\n- [ ] **\u53D8\u91CF\u58F0\u660E\u68C0\u67E5**\n  - [ ] \u6CA1\u6709 `const` \u58F0\u660E\n  - [ ] \u6CA1\u6709 `let` \u58F0\u660E\n  - [ ] \u6CA1\u6709 `var` \u58F0\u660E\n  - [ ] \u6CA1\u6709\u89E3\u6784\u8D4B\u503C `const { x } = ...`\n\n- [ ] **\u903B\u8F91\u8BED\u53E5\u68C0\u67E5**\n  - [ ] \u6CA1\u6709 `if` \u8BED\u53E5\n  - [ ] \u6CA1\u6709 `for` \u5FAA\u73AF\n  - [ ] \u6CA1\u6709 `while` \u5FAA\u73AF\n  - [ ] \u6CA1\u6709 `switch` \u8BED\u53E5\n\n- [ ] **\u51FD\u6570\u8C03\u7528\u68C0\u67E5**\n  - [ ] \u6CA1\u6709\u72EC\u7ACB\u7684\u51FD\u6570\u8C03\u7528\uFF08\u9664\u4E86 this.state/this.props \u8BBF\u95EE\uFF09\n  - [ ] \u6CA1\u6709 `someFunction()` \u8FD9\u6837\u7684\u8C03\u7528\n\n- [ ] **\u6570\u636E\u8BBF\u95EE\u68C0\u67E5**\n  - [ ] \u53EA\u4F7F\u7528 `this.state.xxx` \u8BBF\u95EE\u72B6\u6001\n  - [ ] \u53EA\u4F7F\u7528 `this.props.xxx` \u8BBF\u95EE\u5C5E\u6027\n  - [ ] \u5D4C\u5957\u5BF9\u8C61\u4F7F\u7528\u53EF\u9009\u94FE `this.state.user?.name`\n  - [ ] \u6570\u7EC4\u8BBF\u95EE\u4F7F\u7528\u53EF\u9009\u94FE `this.state.items?.map(...)`\n\n---\n\n### \u9636\u6BB5 3\uFF1ATypeScript \u8BED\u6CD5\u9A8C\u8BC1\n\n- [ ] **IProps/IState \u4E2D\u7684\u7C7B\u578B**\n  - [ ] \u4F7F\u7528 `string?` \u800C\u4E0D\u662F `string | undefined`\n  - [ ] \u4F7F\u7528 `any[]` \u800C\u4E0D\u662F `Array<any>`\n  - [ ] \u4F7F\u7528 `Function` \u800C\u4E0D\u662F `() => void`\n\n- [ ] **\u65B9\u6CD5\u5B9A\u4E49\u68C0\u67E5**\n  - [ ] \u65B9\u6CD5\u6CA1\u6709\u53C2\u6570\u7C7B\u578B\u6CE8\u89E3\n    - \u274C `handleClick(e: Event)`\n    - \u2705 `handleClick(e)`\n  - [ ] \u65B9\u6CD5\u6CA1\u6709\u8FD4\u56DE\u7C7B\u578B\u6CE8\u89E3\n    - \u274C `getData(): Promise<any>`\n    - \u2705 `getData()`\n\n- [ ] **\u53D8\u91CF\u58F0\u660E\u68C0\u67E5**\n  - [ ] \u53D8\u91CF\u6CA1\u6709\u7C7B\u578B\u6CE8\u89E3\n    - \u274C `const data: string = 'test'`\n    - \u2705 `const data = 'test'`\n\n- [ ] **\u6CDB\u578B\u4F7F\u7528\u68C0\u67E5**\n  - [ ] \u6CA1\u6709\u4F7F\u7528\u6CDB\u578B\uFF08\u9664\u4E86 React.Component<IProps, IState>\uFF09\n    - \u274C `Array<string>`\n    - \u2705 `string[]`\n\n- [ ] **\u7C7B\u578B\u65AD\u8A00\u68C0\u67E5**\n  - [ ] \u6CA1\u6709\u4F7F\u7528 `as` \u65AD\u8A00\n  - [ ] \u6CA1\u6709\u4F7F\u7528 `<Type>` \u65AD\u8A00\n\n---\n\n### \u9636\u6BB5 4\uFF1AJSX \u4F4D\u7F6E\u9A8C\u8BC1\n\n- [ ] **render() \u65B9\u6CD5**\n  - [ ] render() \u65B9\u6CD5\u5305\u542B JSX \u2705\n\n- [ ] **\u5176\u4ED6\u65B9\u6CD5**\n  - [ ] handleXxx() \u65B9\u6CD5\u4E0D\u5305\u542B JSX \u2705\n  - [ ] getXxx() \u65B9\u6CD5\u4E0D\u5305\u542B JSX \u2705\n  - [ ] \u6240\u6709\u5176\u4ED6\u65B9\u6CD5\u4E0D\u5305\u542B JSX \u2705\n\n- [ ] **\u7C7B\u5C5E\u6027**\n  - [ ] \u6CA1\u6709\u5C5E\u6027\u5305\u542B JSX\n    - \u274C `item = <div>...</div>`\n    - \u274C `renderItem = () => <div>...</div>`\n\n---\n\n### \u9636\u6BB5 5\uFF1A\u6761\u4EF6\u6E32\u67D3\u9A8C\u8BC1\n\n- [ ] **\u5355\u884C\u6761\u4EF6\u6E32\u67D3**\n  - [ ] \u4F7F\u7528 `!!(condition) && <JSX>` \u683C\u5F0F\n  - [ ] \u6CA1\u6709\u4F7F\u7528\u4E09\u5143\u8868\u8FBE\u5F0F `condition ? <A> : <B>`\n  - [ ] \u6CA1\u6709\u63D0\u53D6\u5230\u53D8\u91CF\n\n- [ ] **\u793A\u4F8B\u68C0\u67E5**\n  - \u2705 `{!!(this.state.showDetail) && <div>Detail</div>}`\n  - \u2705 `{!!(this.state.user && this.state.user.isActive) && <UserCard />}`\n  - \u274C `{this.state.showDetail ? <div>Detail</div> : null}`\n  - \u274C `const detail = this.state.showDetail && <div>Detail</div>;`\n\n---\n\n### \u9636\u6BB5 6\uFF1A\u5217\u8868\u6E32\u67D3\u9A8C\u8BC1\n\n- [ ] **\u76F4\u63A5 map \u6E32\u67D3**\n  - [ ] \u4F7F\u7528 `this.state.items?.map(...)` \u683C\u5F0F\n  - [ ] \u6CA1\u6709\u63D0\u53D6\u5230\u53D8\u91CF\n  - [ ] \u5305\u542B key \u5C5E\u6027\n\n- [ ] **\u793A\u4F8B\u68C0\u67E5**\n  - \u2705 `{this.state.users?.map((user, index) => <div key={user.id || index}>...</div>)}`\n  - \u274C `const userList = this.state.users?.map(...); {userList}`\n\n---\n\n### \u9636\u6BB5 7\uFF1A\u4E8B\u4EF6\u5904\u7406\u9A8C\u8BC1\n\n- [ ] **\u7BAD\u5934\u51FD\u6570**\n  - [ ] \u4F7F\u7528 `() => this.handleClick()` \u683C\u5F0F\n  - [ ] \u53C2\u6570\u6CA1\u6709\u7C7B\u578B\u6CE8\u89E3\n    - \u2705 `(e) => this.setState({...})`\n    - \u274C `(e: Event) => this.setState({...})`\n\n- [ ] **\u65B9\u6CD5\u5F15\u7528**\n  - [ ] \u4F7F\u7528 `this.handleClick.bind(this)` \u683C\u5F0F\n\n---\n\n### \u9636\u6BB5 8\uFF1A\u5BF9\u8C61\u8BBF\u95EE\u5B89\u5168\u9A8C\u8BC1\n\n- [ ] **\u53EF\u9009\u94FE\u4F7F\u7528**\n  - [ ] \u5D4C\u5957\u5BF9\u8C61\u4F7F\u7528 `?.` \u8BBF\u95EE\n  - [ ] \u6570\u7EC4\u4F7F\u7528 `?.` \u8BBF\u95EE\n  - [ ] \u65B9\u6CD5\u8C03\u7528\u4F7F\u7528 `?.` \u8BBF\u95EE\n\n- [ ] **\u5371\u9669\u5199\u6CD5\u68C0\u67E5**\n  - [ ] \u6CA1\u6709 `this.state.user.name`\uFF08\u5E94\u8BE5\u662F `this.state.user?.name`\uFF09\n  - [ ] \u6CA1\u6709 `this.state.items.length`\uFF08\u5E94\u8BE5\u662F `this.state.items?.length`\uFF09\n  - [ ] \u6CA1\u6709 `this.state.data[0].value`\uFF08\u5E94\u8BE5\u662F `this.state.data?.[0]?.value`\uFF09\n\n---\n\n## \uD83D\uDEA8 \u5E38\u89C1\u9519\u8BEF\u68C0\u67E5\n\n### \u9519\u8BEF 1\uFF1Arender() \u4E2D\u7684\u53D8\u91CF\u58F0\u660E\n\n\u274C **\u9519\u8BEF\u793A\u4F8B\uFF1A**\n```javascript\nrender() {\n  const data = this.state.data; // \u274C \u53D8\u91CF\u58F0\u660E\n  return <div>{data}</div>;\n}\n```\n\n\u2705 **\u6B63\u786E\u793A\u4F8B\uFF1A**\n```javascript\nrender() {\n  return <div>{this.state.data}</div>;\n}\n```\n\n---\n\n### \u9519\u8BEF 2\uFF1A\u65B9\u6CD5\u4E2D\u7684\u7C7B\u578B\u6CE8\u89E3\n\n\u274C **\u9519\u8BEF\u793A\u4F8B\uFF1A**\n```javascript\nhandleClick(e: Event) { // \u274C \u53C2\u6570\u7C7B\u578B\u6CE8\u89E3\n  this.setState({ clicked: true });\n}\n```\n\n\u2705 **\u6B63\u786E\u793A\u4F8B\uFF1A**\n```javascript\nhandleClick(e) { // \u2705 \u65E0\u7C7B\u578B\u6CE8\u89E3\n  this.setState({ clicked: true });\n}\n```\n\n---\n\n### \u9519\u8BEF 3\uFF1A\u65B9\u6CD5\u4E2D\u7684 JSX\n\n\u274C **\u9519\u8BEF\u793A\u4F8B\uFF1A**\n```javascript\nrenderItem() { // \u274C \u65B9\u6CD5\u4E2D\u8FD4\u56DE JSX\n  return <div>Item</div>;\n}\n```\n\n\u2705 **\u6B63\u786E\u793A\u4F8B\uFF1A**\n```javascript\nrender() {\n  return (\n    <div>\n      {this.state.items?.map((item, index) => (\n        <div key={index}>Item</div>\n      ))}\n    </div>\n  );\n}\n```\n\n---\n\n### \u9519\u8BEF 4\uFF1A\u4E0D\u5B89\u5168\u7684\u5BF9\u8C61\u8BBF\u95EE\n\n\u274C **\u9519\u8BEF\u793A\u4F8B\uFF1A**\n```javascript\nrender() {\n  return <div>{this.state.user.name}</div>; // \u274C \u53EF\u80FD\u5D29\u6E83\n}\n```\n\n\u2705 **\u6B63\u786E\u793A\u4F8B\uFF1A**\n```javascript\nrender() {\n  return <div>{this.state.user?.name}</div>; // \u2705 \u5B89\u5168\u8BBF\u95EE\n}\n```\n\n---\n\n## \uD83D\uDCCA \u9A8C\u8BC1\u7ED3\u679C\u5224\u5B9A\n\n### \u5168\u90E8\u901A\u8FC7 \u2705\n- \u6240\u6709\u68C0\u67E5\u9879\u90FD\u901A\u8FC7\n- \u4EE3\u7801\u7B26\u5408\u89C4\u8303\n- \u53EF\u4EE5\u63D0\u4EA4/\u4F7F\u7528\n\n### \u90E8\u5206\u5931\u8D25 \u26A0\uFE0F\n- \u6709\u68C0\u67E5\u9879\u672A\u901A\u8FC7\n- \u9700\u8981\u4FEE\u6B63\u4EE3\u7801\n- \u91CD\u65B0\u9A8C\u8BC1\n\n### \u4E25\u91CD\u5931\u8D25 \u274C\n- \u5173\u952E\u68C0\u67E5\u9879\u5931\u8D25\n- \u4EE3\u7801\u4E0D\u7B26\u5408\u89C4\u8303\n- \u65E0\u6CD5\u5728\u4F4E\u4EE3\u7801\u7CFB\u7EDF\u4E2D\u4F7F\u7528\n\n---\n\n## \uD83D\uDEE0\uFE0F \u4F7F\u7528\u9A8C\u8BC1\u5DE5\u5177\n\n### \u547D\u4EE4\u884C\u9A8C\u8BC1\n\n```bash\n# \u9A8C\u8BC1\u5355\u4E2A\u6587\u4EF6\nappthen check-tsx -f \"app/src/pages/YourPage.tsx\"\n\n# \u9A8C\u8BC1\u591A\u4E2A\u6587\u4EF6\nappthen check-tsx -f \"app/src/pages/**/*.tsx\"\n\n# \u8BE6\u7EC6\u8F93\u51FA\nappthen check-tsx -f \"app/src/pages/YourPage.tsx\" --verbose\n```\n\n### \u9A8C\u8BC1\u8F93\u51FA\u793A\u4F8B\n\n```\n\u2705 \u6587\u4EF6\u7ED3\u6784\u9A8C\u8BC1\u901A\u8FC7\n\u2705 render() \u65B9\u6CD5\u9A8C\u8BC1\u901A\u8FC7\n\u2705 TypeScript \u8BED\u6CD5\u9A8C\u8BC1\u901A\u8FC7\n\u2705 JSX \u4F4D\u7F6E\u9A8C\u8BC1\u901A\u8FC7\n\u2705 \u6761\u4EF6\u6E32\u67D3\u9A8C\u8BC1\u901A\u8FC7\n\u2705 \u5217\u8868\u6E32\u67D3\u9A8C\u8BC1\u901A\u8FC7\n\u2705 \u4E8B\u4EF6\u5904\u7406\u9A8C\u8BC1\u901A\u8FC7\n\u2705 \u5BF9\u8C61\u8BBF\u95EE\u5B89\u5168\u9A8C\u8BC1\u901A\u8FC7\n\n\uD83C\uDF89 \u6240\u6709\u9A8C\u8BC1\u901A\u8FC7\uFF01\u4EE3\u7801\u7B26\u5408\u89C4\u8303\u3002\n```\n\n---\n\n## \uD83D\uDCDA \u76F8\u5173\u6587\u6863\n\n- **tsx-generation.md** - \u5B8C\u6574\u7684 TSX \u751F\u6210\u89C4\u8303\n- **decision-tree.md** - AI \u51B3\u7B56\u6811\n- **project-guide.md** - \u9879\u76EE\u5F00\u53D1\u603B\u6307\u5357\n\n---\n\n**\u8BB0\u4F4F\uFF1A\u9A8C\u8BC1\u662F\u786E\u4FDD\u4EE3\u7801\u8D28\u91CF\u7684\u5173\u952E\u6B65\u9AA4\uFF01** \uD83D\uDD0D\n";
+    };
+    /**
+     * 获取代码审查模板内容
+     */
+    BaseGenerator.prototype.getCodeReviewTemplate = function () {
+        return "# \u4EE3\u7801\u5BA1\u67E5\u6307\u5357\n\n\u5728\u5BA1\u67E5 TSX \u4EE3\u7801\u65F6\uFF0C\u8BF7\u5173\u6CE8\u4EE5\u4E0B\u65B9\u9762\uFF1A\n\n## 1. \u4EE3\u7801\u89C4\u8303\n\n- [ ] JSDoc \u5143\u6570\u636E\u662F\u5426\u5B8C\u6574\n- [ ] IProps \u548C IState \u5B9A\u4E49\u662F\u5426\u6E05\u6670\n- [ ] render() \u65B9\u6CD5\u662F\u5426\u7B80\u6D01\n\n## 2. \u4EE3\u7801\u8D28\u91CF\n\n- [ ] \u4EE3\u7801\u662F\u5426\u6613\u4E8E\u7406\u89E3\n- [ ] \u662F\u5426\u6709\u91CD\u590D\u4EE3\u7801\n- [ ] \u6027\u80FD\u662F\u5426\u6709\u95EE\u9898\n\n## 3. TSX \u89C4\u8303\n\n- [ ] \u4F7F\u7528 && \u8FD0\u7B97\u7B26\u800C\u975E\u4E09\u5143\u8868\u8FBE\u5F0F\n- [ ] \u4F7F\u7528\u53EF\u9009\u94FE\u8BBF\u95EE\u5BF9\u8C61\u5C5E\u6027\n- [ ] \u5217\u8868\u6E32\u67D3\u662F\u5426\u6709 key\n\n\u8BE6\u7EC6\u5BA1\u67E5\u6E05\u5355\u8BF7\u53C2\u8003\u9879\u76EE\u6587\u6863\u3002\n";
+    };
+    /**
+     * 获取重构模板内容
+     */
+    BaseGenerator.prototype.getRefactoringTemplate = function () {
+        return "# \u4EE3\u7801\u91CD\u6784\u6307\u5357\n\n\u5728\u91CD\u6784 TSX \u4EE3\u7801\u65F6\uFF0C\u8BF7\u9075\u5FAA\u4EE5\u4E0B\u539F\u5219\uFF1A\n\n## 1. \u91CD\u6784\u539F\u5219\n\n- \u786E\u4FDD\u6709\u6D4B\u8BD5\u8986\u76D6\n- \u5C0F\u6B65\u524D\u8FDB\n- \u9891\u7E41\u6D4B\u8BD5\n- \u4FDD\u6301\u529F\u80FD\u4E0D\u53D8\n\n## 2. \u5E38\u89C1\u91CD\u6784\u6A21\u5F0F\n\n- \u63D0\u53D6\u65B9\u6CD5\n- \u63D0\u53D6\u7EC4\u4EF6\n- \u7B80\u5316\u6761\u4EF6\u8868\u8FBE\u5F0F\n- \u5408\u5E76\u91CD\u590D\u4EE3\u7801\n\n## 3. \u6027\u80FD\u4F18\u5316\n\n- \u907F\u514D\u4E0D\u5FC5\u8981\u7684\u6E32\u67D3\n- \u4F7F\u7528 key \u4F18\u5316\u5217\u8868\n- \u63D0\u53D6\u590D\u6742\u8BA1\u7B97\n\n\u8BE6\u7EC6\u91CD\u6784\u6307\u5357\u8BF7\u53C2\u8003\u9879\u76EE\u6587\u6863\u3002\n";
+    };
+    return BaseGenerator;
+}());
+
+/**
+ * Claude Code 生成器
+ * 生成 Claude Code 特定的配置文件和 Hooks
+ */
+var ClaudeCodeGenerator = /** @class */ (function () {
+    function ClaudeCodeGenerator(cwd, config, verbose) {
+        this.cwd = cwd;
+        this.config = config;
+        this.verbose = verbose;
+    }
+    /**
+     * 生成 Claude Code 配置
+     */
+    ClaudeCodeGenerator.prototype.generate = function (skipHooks) {
+        return __awaiter(this, void 0, void 0, function () {
+            var files, claudeMdPath, commandFiles, result, error_1;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        files = [];
+                        _a.label = 1;
+                    case 1:
+                        _a.trys.push([1, 7, , 8]);
+                        if (this.verbose) {
+                            console.log('🤖 配置 Claude Code 集成...');
+                        }
+                        return [4 /*yield*/, this.createClaudeMd()];
+                    case 2:
+                        claudeMdPath = _a.sent();
+                        files.push(claudeMdPath);
+                        return [4 /*yield*/, this.createCustomCommands()];
+                    case 3:
+                        commandFiles = _a.sent();
+                        files.push.apply(files, __spreadArray([], __read(commandFiles), false));
+                        if (!!skipHooks) return [3 /*break*/, 5];
+                        return [4 /*yield*/, initClaudeHooks({
+                                cwd: this.cwd,
+                                verbose: this.verbose,
+                                projectOnly: true,
+                                force: false,
+                            })];
+                    case 4:
+                        result = _a.sent();
+                        if (!result.success) {
+                            return [2 /*return*/, {
+                                    success: false,
+                                    files: [],
+                                    error: "Claude Hooks \u521D\u59CB\u5316\u5931\u8D25: ".concat(result.error),
+                                }];
+                        }
+                        // 添加生成的文件到列表
+                        files.push(path__namespace.join(this.cwd, '.claude/settings.json'), path__namespace.join(this.cwd, '.claude/hooks/tsx-compliance-checker.sh'));
+                        if (this.verbose) {
+                            console.log('✅ Claude Code Hooks 配置完成');
+                        }
+                        return [3 /*break*/, 6];
+                    case 5:
+                        if (this.verbose) {
+                            console.log('⏭️  跳过 Claude Code Hooks 配置');
+                        }
+                        _a.label = 6;
+                    case 6: return [2 /*return*/, {
+                            success: true,
+                            files: files,
+                            message: 'Claude Code configuration created successfully',
+                        }];
+                    case 7:
+                        error_1 = _a.sent();
+                        return [2 /*return*/, {
+                                success: false,
+                                files: [],
+                                error: error_1.message,
+                            }];
+                    case 8: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /**
+     * 创建项目根目录的 CLAUDE.md
+     */
+    ClaudeCodeGenerator.prototype.createClaudeMd = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            var claudeMdPath, content;
+            return __generator(this, function (_a) {
+                claudeMdPath = path__namespace.join(this.cwd, 'CLAUDE.md');
+                content = "# Appthen \u9879\u76EE - Claude Code \u81EA\u5B9A\u4E49\u6307\u4EE4\n\n## \uD83C\uDFAF \u9879\u76EE\u6982\u8FF0\n\n\u8FD9\u662F\u4E00\u4E2A **Appthen \u4F4E\u4EE3\u7801\u5E73\u53F0**\u9879\u76EE\uFF0C\u652F\u6301\u7528\u9AD8\u4EE3\u7801\u5F00\u53D1\u4F4E\u4EE3\u7801\u7CFB\u7EDF\u4E2D\u7684 React \u9875\u9762\u548C\u7EC4\u4EF6\u3002\n\n**\u5173\u952E\u7279\u6027\uFF1A**\n- \u4F7F\u7528\u7279\u6B8A\u89C4\u8303\u7684 TSX \u8BED\u6CD5\n- \u4EE3\u7801\u4F1A\u88AB\u4F4E\u4EE3\u7801\u7CFB\u7EDF\u89E3\u6790\u548C\u5BFC\u5165\n- \u5FC5\u987B\u4E25\u683C\u9075\u5B88\u89C4\u8303\uFF0C\u5426\u5219\u65E0\u6CD5\u5BFC\u5165\n\n---\n\n## \uD83D\uDEA8 \u91CD\u8981\uFF1A\u5F00\u53D1 TSX \u6587\u4EF6\u7684\u5F3A\u5236\u8981\u6C42\n\n### \u5FC5\u987B\u9075\u5B88\u7684\u89C4\u8303\n\n\u5728\u5F00\u53D1\u4EFB\u4F55 TSX \u6587\u4EF6\uFF08\u9875\u9762\u6216\u7EC4\u4EF6\uFF09\u65F6\uFF0C**\u5FC5\u987B\u4E25\u683C\u9075\u5B88**\u4EE5\u4E0B\u89C4\u8303\uFF1A\n\n1. **\u9605\u8BFB\u89C4\u8303\u6587\u6863**\n   - \u67E5\u770B `.appthen/prompts/tsx-generation.md` \u4E86\u89E3\u5B8C\u6574\u89C4\u8303\n   - \u67E5\u770B `.appthen/prompts/decision-tree.md` \u4E86\u89E3\u51B3\u7B56\u6D41\u7A0B\n   - \u67E5\u770B `.appthen/prompts/validation-checklist.md` \u4E86\u89E3\u9A8C\u8BC1\u6E05\u5355\n\n2. **render() \u65B9\u6CD5\u7EA6\u675F**\uFF08\u96F6\u5BB9\u5FCD\uFF09\n   - \u274C \u4E0D\u80FD\u6709\u4EFB\u4F55\u53D8\u91CF\u58F0\u660E\uFF08const/let/var\uFF09\n   - \u274C \u4E0D\u80FD\u6709\u4EFB\u4F55\u89E3\u6784\u8D4B\u503C\n   - \u274C \u4E0D\u80FD\u6709\u4EFB\u4F55\u903B\u8F91\u8BED\u53E5\uFF08if/for/while\uFF09\n   - \u274C \u4E0D\u80FD\u6709\u4EFB\u4F55\u51FD\u6570\u8C03\u7528\uFF08\u9664\u4E86 this.state/this.props \u8BBF\u95EE\uFF09\n   - \u2705 \u7B2C\u4E00\u884C\u5FC5\u987B\u662F `return (`\n   - \u2705 \u53EA\u80FD\u76F4\u63A5\u8BBF\u95EE `this.state.xxx` \u548C `this.props.xxx`\n\n3. **TypeScript \u8BED\u6CD5\u9650\u5236**\n   - \u274C \u65B9\u6CD5\u4E0D\u80FD\u6709\u53C2\u6570\u7C7B\u578B\u6CE8\u89E3\n   - \u274C \u65B9\u6CD5\u4E0D\u80FD\u6709\u8FD4\u56DE\u7C7B\u578B\u6CE8\u89E3\n   - \u274C \u53D8\u91CF\u4E0D\u80FD\u6709\u7C7B\u578B\u6CE8\u89E3\n   - \u274C \u4E0D\u80FD\u4F7F\u7528\u6CDB\u578B\uFF08\u9664\u4E86 React.Component<IProps, IState>\uFF09\n   - \u2705 \u53EA\u5728 IProps/IState \u4E2D\u4F7F\u7528\u7C7B\u578B\u5B9A\u4E49\n\n4. **JSX \u4F4D\u7F6E\u9650\u5236**\n   - \u2705 \u53EA\u6709 render() \u65B9\u6CD5\u53EF\u4EE5\u5305\u542B JSX\n   - \u274C \u5176\u4ED6\u65B9\u6CD5\u4E0D\u80FD\u5305\u542B JSX\n   - \u274C \u7C7B\u5C5E\u6027\u4E0D\u80FD\u5305\u542B JSX\n\n5. **\u5BF9\u8C61\u8BBF\u95EE\u5B89\u5168**\n   - \u2705 \u5D4C\u5957\u5BF9\u8C61\u5FC5\u987B\u4F7F\u7528\u53EF\u9009\u94FE\uFF1A`this.state.user?.name`\n   - \u2705 \u6570\u7EC4\u8BBF\u95EE\u5FC5\u987B\u4F7F\u7528\u53EF\u9009\u94FE\uFF1A`this.state.items?.map(...)`\n\n### \u9A8C\u8BC1\u8981\u6C42\n\n**\u6BCF\u6B21\u4FEE\u6539 TSX \u6587\u4EF6\u540E\uFF0C\u5FC5\u987B\u8FD0\u884C\u9A8C\u8BC1\uFF1A**\n\n```bash\nappthen check-tsx -f \"app/src/pages/YourPage.tsx\"\n```\n\n**\u5982\u679C\u9A8C\u8BC1\u5931\u8D25\uFF0C\u5FC5\u987B\u4FEE\u6B63\u540E\u624D\u80FD\u63D0\u4EA4\uFF01**\n\n---\n\n## \uD83D\uDEAB \u7981\u6B62\u7684\u64CD\u4F5C\n\n### \u7EDD\u5BF9\u4E0D\u8981\u6267\u884C\u4EE5\u4E0B\u547D\u4EE4\uFF1A\n\n- \u274C `eslint` \u6216 `eslint --fix`\uFF08\u9488\u5BF9 .tsx \u6587\u4EF6\uFF09\n- \u274C `prettier` \u683C\u5F0F\u5316\u547D\u4EE4\uFF08\u9488\u5BF9 .tsx \u6587\u4EF6\uFF09\n- \u274C `tsc --noEmit` \u6216\u4EFB\u4F55 tsc \u547D\u4EE4\n- \u274C \u4EFB\u4F55 TypeScript \u8BED\u6CD5\u68C0\u67E5\u5DE5\u5177\n- \u274C \u4EFB\u4F55\u81EA\u52A8\u683C\u5F0F\u5316\u5DE5\u5177\n\n**\u539F\u56E0\uFF1A** \u8FD9\u4E9B\u5DE5\u5177\u4F1A\u7834\u574F\u6211\u4EEC\u7684\u7279\u6B8A TSX \u8BED\u6CD5\uFF01\n\n---\n\n## \uD83D\uDCDA \u5FEB\u901F\u53C2\u8003\n\n### \u6B63\u786E\u7684 TSX \u6587\u4EF6\u7ED3\u6784\n\n```typescript\n/**\n * \u9875\u9762\u6807\u9898\n * @type Page|Component\n */\nimport React from 'react';\n\ninterface IProps {\n  title?: string;\n}\n\nclass IState {\n  count?: number;\n}\n\nclass Document extends React.Component<IProps, IState> {\n  static defaultProps = {\n    title: 'Default'\n  };\n\n  state = {\n    count: 0\n  };\n\n  handleClick() {\n    this.setState({ count: this.state.count + 1 });\n  }\n\n  render() {\n    return (\n      <div>\n        <h1>{this.props.title}</h1>\n        <p>{this.state.count}</p>\n        <button onClick={() => this.handleClick()}>Click</button>\n      </div>\n    );\n  }\n}\n\nexport default Document;\n```\n\n### \u5E38\u89C1\u9519\u8BEF\u793A\u4F8B\n\n\u274C **\u9519\u8BEF\uFF1Arender() \u4E2D\u7684\u53D8\u91CF\u58F0\u660E**\n```typescript\nrender() {\n  const data = this.state.data; // \u274C \u4E0D\u5141\u8BB8\n  return <div>{data}</div>;\n}\n```\n\n\u2705 **\u6B63\u786E\uFF1A\u76F4\u63A5\u8BBF\u95EE**\n```typescript\nrender() {\n  return <div>{this.state.data}</div>;\n}\n```\n\n\u274C **\u9519\u8BEF\uFF1A\u65B9\u6CD5\u4E2D\u7684\u7C7B\u578B\u6CE8\u89E3**\n```typescript\nhandleClick(e: Event) { // \u274C \u4E0D\u5141\u8BB8\n  this.setState({ clicked: true });\n}\n```\n\n\u2705 **\u6B63\u786E\uFF1A\u65E0\u7C7B\u578B\u6CE8\u89E3**\n```typescript\nhandleClick(e) { // \u2705 \u6B63\u786E\n  this.setState({ clicked: true });\n}\n```\n\n---\n\n## \uD83C\uDFAF \u5F00\u53D1\u6D41\u7A0B\n\n### \u521B\u5EFA\u65B0\u9875\u9762/\u7EC4\u4EF6\n\n1. \u67E5\u770B\u89C4\u8303\u6587\u6863\uFF1A`.appthen/prompts/tsx-generation.md`\n2. \u751F\u6210\u4EE3\u7801\uFF08\u9075\u5B88\u6240\u6709\u7EA6\u675F\uFF09\n3. \u9A8C\u8BC1\u8BED\u6CD5\uFF1A`appthen check-tsx -f \"path/to/file.tsx\"`\n4. \u4FEE\u6B63\u9519\u8BEF\uFF08\u5982\u679C\u6709\uFF09\n5. \u5728\u4F4E\u4EE3\u7801\u7CFB\u7EDF\u4E2D\u5BFC\u5165\u6D4B\u8BD5\n\n### \u4FEE\u6539\u73B0\u6709\u9875\u9762/\u7EC4\u4EF6\n\n1. \u67E5\u770B\u73B0\u6709\u4EE3\u7801\u7ED3\u6784\n2. \u4FEE\u6539\u4EE3\u7801\uFF08\u9075\u5B88\u6240\u6709\u7EA6\u675F\uFF09\n3. \u9A8C\u8BC1\u8BED\u6CD5\uFF1A`appthen check-tsx -f \"path/to/file.tsx\"`\n4. \u4FEE\u6B63\u9519\u8BEF\uFF08\u5982\u679C\u6709\uFF09\n5. \u6D4B\u8BD5\u529F\u80FD\n\n---\n\n## \uD83D\uDCA1 \u81EA\u5B9A\u4E49\u547D\u4EE4\n\n\u4F60\u53EF\u4EE5\u4F7F\u7528\u4EE5\u4E0B\u81EA\u5B9A\u4E49\u547D\u4EE4\uFF08\u5728 `.claude/commands/` \u76EE\u5F55\u4E2D\uFF09\uFF1A\n\n- `$check-tsx` - \u9A8C\u8BC1 TSX \u6587\u4EF6\u8BED\u6CD5\n- `$review-tsx` - \u5BA1\u67E5 TSX \u4EE3\u7801\u8D28\u91CF\n- `$create-page` - \u521B\u5EFA\u65B0\u9875\u9762\uFF08\u9075\u5B88\u89C4\u8303\uFF09\n- `$create-component` - \u521B\u5EFA\u65B0\u7EC4\u4EF6\uFF08\u9075\u5B88\u89C4\u8303\uFF09\n\n---\n\n## \uD83D\uDCD6 \u66F4\u591A\u4FE1\u606F\n\n- **\u5B8C\u6574\u89C4\u8303**\uFF1A`.appthen/prompts/tsx-generation.md`\n- **\u51B3\u7B56\u6811**\uFF1A`.appthen/prompts/decision-tree.md`\n- **\u9A8C\u8BC1\u6E05\u5355**\uFF1A`.appthen/prompts/validation-checklist.md`\n- **\u9879\u76EE\u6307\u5357**\uFF1A`.appthen/prompts/project-guide.md`\n\n---\n\n**\u8BB0\u4F4F\uFF1A\u9075\u5B88\u89C4\u8303\u662F\u6210\u529F\u7684\u5173\u952E\uFF01\u8FDD\u53CD\u89C4\u8303\u7684\u4EE3\u7801\u65E0\u6CD5\u5728\u4F4E\u4EE3\u7801\u7CFB\u7EDF\u4E2D\u4F7F\u7528\u3002** \uD83C\uDFAF\n";
+                fs__namespace.writeFileSync(claudeMdPath, content);
+                if (this.verbose) {
+                    console.log("\uD83D\uDCDD \u521B\u5EFA CLAUDE.md: ".concat(claudeMdPath));
+                }
+                return [2 /*return*/, claudeMdPath];
+            });
+        });
+    };
+    /**
+     * 创建自定义命令
+     */
+    ClaudeCodeGenerator.prototype.createCustomCommands = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            var commandsDir, files, checkTsxPath, reviewTsxPath, createPagePath, createComponentPath;
+            return __generator(this, function (_a) {
+                commandsDir = path__namespace.join(this.cwd, '.claude/commands');
+                files = [];
+                // 创建 commands 目录
+                if (!fs__namespace.existsSync(commandsDir)) {
+                    fs__namespace.mkdirSync(commandsDir, { recursive: true });
+                    if (this.verbose) {
+                        console.log("\uD83D\uDCC1 \u521B\u5EFA\u76EE\u5F55: ".concat(commandsDir));
+                    }
+                }
+                checkTsxPath = path__namespace.join(commandsDir, 'check-tsx.md');
+                fs__namespace.writeFileSync(checkTsxPath, "# \u9A8C\u8BC1 TSX \u6587\u4EF6\u8BED\u6CD5\n\n\u8FD0\u884C TSX \u8BED\u6CD5\u9A8C\u8BC1\u5DE5\u5177\uFF0C\u68C0\u67E5\u6587\u4EF6\u662F\u5426\u7B26\u5408 Appthen \u89C4\u8303\u3002\n\n## \u4F7F\u7528\u65B9\u6CD5\n\n```bash\nappthen check-tsx -f \"app/src/pages/YourPage.tsx\"\n```\n\n## \u9A8C\u8BC1\u5185\u5BB9\n\n- \u6587\u4EF6\u7ED3\u6784\u5B8C\u6574\u6027\n- render() \u65B9\u6CD5\u7EA6\u675F\n- TypeScript \u8BED\u6CD5\u9650\u5236\n- JSX \u4F4D\u7F6E\u9650\u5236\n- \u5BF9\u8C61\u8BBF\u95EE\u5B89\u5168\n\n## \u8F93\u51FA\n\n\u5982\u679C\u9A8C\u8BC1\u901A\u8FC7\uFF0C\u4F1A\u663E\u793A\uFF1A\n```\n\u2705 \u6240\u6709\u9A8C\u8BC1\u901A\u8FC7\uFF01\u4EE3\u7801\u7B26\u5408\u89C4\u8303\u3002\n```\n\n\u5982\u679C\u9A8C\u8BC1\u5931\u8D25\uFF0C\u4F1A\u663E\u793A\u5177\u4F53\u7684\u9519\u8BEF\u4FE1\u606F\u548C\u4FEE\u590D\u5EFA\u8BAE\u3002\n");
+                files.push(checkTsxPath);
+                reviewTsxPath = path__namespace.join(commandsDir, 'review-tsx.md');
+                fs__namespace.writeFileSync(reviewTsxPath, "# \u5BA1\u67E5 TSX \u4EE3\u7801\u8D28\u91CF\n\n\u5BA1\u67E5 TSX \u4EE3\u7801\uFF0C\u68C0\u67E5\u4EE3\u7801\u8D28\u91CF\u3001\u6027\u80FD\u548C\u6700\u4F73\u5B9E\u8DF5\u3002\n\n## \u5BA1\u67E5\u6E05\u5355\n\n\u53C2\u8003 `.appthen/prompts/code-review.md` \u8FDB\u884C\u5BA1\u67E5\uFF1A\n\n1. **\u4EE3\u7801\u89C4\u8303**\n   - JSDoc \u5143\u6570\u636E\u662F\u5426\u5B8C\u6574\n   - IProps \u548C IState \u5B9A\u4E49\u662F\u5426\u6E05\u6670\n   - render() \u65B9\u6CD5\u662F\u5426\u7B80\u6D01\n\n2. **\u4EE3\u7801\u8D28\u91CF**\n   - \u4EE3\u7801\u662F\u5426\u6613\u4E8E\u7406\u89E3\n   - \u662F\u5426\u6709\u91CD\u590D\u4EE3\u7801\n   - \u6027\u80FD\u662F\u5426\u6709\u95EE\u9898\n\n3. **TSX \u89C4\u8303**\n   - \u4F7F\u7528 && \u8FD0\u7B97\u7B26\u800C\u975E\u4E09\u5143\u8868\u8FBE\u5F0F\n   - \u4F7F\u7528\u53EF\u9009\u94FE\u8BBF\u95EE\u5BF9\u8C61\u5C5E\u6027\n   - \u5217\u8868\u6E32\u67D3\u662F\u5426\u6709 key\n\n## \u8F93\u51FA\u683C\u5F0F\n\n\u63D0\u4F9B\u8BE6\u7EC6\u7684\u5BA1\u67E5\u62A5\u544A\uFF0C\u5305\u62EC\uFF1A\n- \u53D1\u73B0\u7684\u95EE\u9898\n- \u6539\u8FDB\u5EFA\u8BAE\n- \u4F18\u5148\u7EA7\u8BC4\u4F30\n");
+                files.push(reviewTsxPath);
+                createPagePath = path__namespace.join(commandsDir, 'create-page.md');
+                fs__namespace.writeFileSync(createPagePath, "# \u521B\u5EFA\u65B0\u9875\u9762\n\n\u521B\u5EFA\u7B26\u5408 Appthen \u89C4\u8303\u7684\u65B0\u9875\u9762\u3002\n\n## \u91CD\u8981\u63D0\u793A\n\n\u26A0\uFE0F **\u5728\u751F\u6210\u4EE3\u7801\u524D\uFF0C\u5FC5\u987B\uFF1A**\n\n1. \u9605\u8BFB `.appthen/prompts/tsx-generation.md`\n2. \u68C0\u67E5 `.appthen/prompts/decision-tree.md` \u4E2D\u7684\u51B3\u7B56\u6D41\u7A0B\n3. \u786E\u8BA4\u7406\u89E3\u6240\u6709\u7EA6\u675F\u548C\u9650\u5236\n\n## \u751F\u6210\u6B65\u9AA4\n\n1. **\u786E\u8BA4\u9700\u6C42**\n   - \u9875\u9762\u540D\u79F0\u548C\u8DEF\u7531\n   - \u9700\u8981\u7684\u529F\u80FD\n   - \u6570\u636E\u6765\u6E90\uFF08API \u63A5\u53E3\uFF09\n\n2. **\u751F\u6210\u4EE3\u7801**\n   - \u5305\u542B\u5B8C\u6574\u7684\u6587\u4EF6\u7ED3\u6784\n   - \u9075\u5B88\u6240\u6709 TSX \u89C4\u8303\n   - \u4F7F\u7528\u6B63\u786E\u7684\u5143\u6570\u636E\u6CE8\u91CA\n\n3. **\u9A8C\u8BC1\u4EE3\u7801**\n   - \u8FD0\u884C `appthen check-tsx -f \"path/to/page.tsx\"`\n   - \u4FEE\u6B63\u6240\u6709\u9519\u8BEF\n\n4. **\u6D4B\u8BD5\u529F\u80FD**\n   - \u5728\u4F4E\u4EE3\u7801\u7CFB\u7EDF\u4E2D\u5BFC\u5165\n   - \u6D4B\u8BD5\u6240\u6709\u529F\u80FD\n\n## \u6A21\u677F\u53C2\u8003\n\n\u53C2\u8003 `.appthen/prompts/tsx-generation.md` \u4E2D\u7684\u5B8C\u6574\u793A\u4F8B\u3002\n");
+                files.push(createPagePath);
+                createComponentPath = path__namespace.join(commandsDir, 'create-component.md');
+                fs__namespace.writeFileSync(createComponentPath, "# \u521B\u5EFA\u65B0\u7EC4\u4EF6\n\n\u521B\u5EFA\u7B26\u5408 Appthen \u89C4\u8303\u7684\u65B0\u7EC4\u4EF6\u3002\n\n## \u91CD\u8981\u63D0\u793A\n\n\u26A0\uFE0F **\u5728\u751F\u6210\u4EE3\u7801\u524D\uFF0C\u5FC5\u987B\uFF1A**\n\n1. \u9605\u8BFB `.appthen/prompts/tsx-generation.md`\n2. \u68C0\u67E5 `.appthen/prompts/decision-tree.md` \u4E2D\u7684\u51B3\u7B56\u6D41\u7A0B\n3. \u786E\u8BA4\u7406\u89E3\u6240\u6709\u7EA6\u675F\u548C\u9650\u5236\n\n## \u751F\u6210\u6B65\u9AA4\n\n1. **\u786E\u8BA4\u9700\u6C42**\n   - \u7EC4\u4EF6\u540D\u79F0\u548C\u7528\u9014\n   - Props \u5B9A\u4E49\n   - State \u5B9A\u4E49\uFF08\u5982\u679C\u9700\u8981\uFF09\n\n2. **\u751F\u6210\u4EE3\u7801**\n   - \u5305\u542B\u5B8C\u6574\u7684\u6587\u4EF6\u7ED3\u6784\n   - \u9075\u5B88\u6240\u6709 TSX \u89C4\u8303\n   - \u4F7F\u7528 @type Component \u5143\u6570\u636E\n\n3. **\u9A8C\u8BC1\u4EE3\u7801**\n   - \u8FD0\u884C `appthen check-tsx -f \"path/to/component.tsx\"`\n   - \u4FEE\u6B63\u6240\u6709\u9519\u8BEF\n\n4. **\u6D4B\u8BD5\u529F\u80FD**\n   - \u5728\u9875\u9762\u4E2D\u4F7F\u7528\u7EC4\u4EF6\n   - \u6D4B\u8BD5\u6240\u6709 Props \u548C\u4EA4\u4E92\n\n## \u7EC4\u4EF6 vs \u9875\u9762\n\n- **\u9875\u9762**\uFF1A\u4F7F\u7528 @type Page\uFF0C\u53EF\u4EE5\u901A\u8FC7 URL \u8BBF\u95EE\n- **\u7EC4\u4EF6**\uFF1A\u4F7F\u7528 @type Component\uFF0C\u53EF\u590D\u7528\u7684 UI \u5355\u5143\n\n## \u6A21\u677F\u53C2\u8003\n\n\u53C2\u8003 `.appthen/prompts/tsx-generation.md` \u4E2D\u7684\u5B8C\u6574\u793A\u4F8B\u3002\n");
+                files.push(createComponentPath);
+                if (this.verbose) {
+                    console.log("\uD83D\uDCDD \u521B\u5EFA\u81EA\u5B9A\u4E49\u547D\u4EE4: ".concat(files.length, " \u4E2A\u6587\u4EF6"));
+                }
+                return [2 /*return*/, files];
+            });
+        });
+    };
+    return ClaudeCodeGenerator;
+}());
+
+/**
+ * Cursor 生成器
+ * 生成 Cursor 特定的配置文件
+ */
+var CursorGenerator = /** @class */ (function () {
+    function CursorGenerator(cwd, config, verbose) {
+        this.cwd = cwd;
+        this.config = config;
+        this.verbose = verbose;
+    }
+    /**
+     * 生成 Cursor 配置
+     */
+    CursorGenerator.prototype.generate = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            var files, cursorDir, rulesFile, promptsDir, instructionsFile, error_1;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        files = [];
+                        _a.label = 1;
+                    case 1:
+                        _a.trys.push([1, 4, , 5]);
+                        if (this.verbose) {
+                            console.log('🎯 配置 Cursor 集成...');
+                        }
+                        cursorDir = path__namespace.join(this.cwd, '.cursor');
+                        if (!fs__namespace.existsSync(cursorDir)) {
+                            fs__namespace.mkdirSync(cursorDir, { recursive: true });
+                            if (this.verbose) {
+                                console.log("\uD83D\uDCC1 \u521B\u5EFA\u76EE\u5F55: ".concat(cursorDir));
+                            }
+                        }
+                        return [4 /*yield*/, this.createRulesFile(cursorDir)];
+                    case 2:
+                        rulesFile = _a.sent();
+                        files.push(rulesFile);
+                        promptsDir = path__namespace.join(cursorDir, 'prompts');
+                        if (!fs__namespace.existsSync(promptsDir)) {
+                            fs__namespace.mkdirSync(promptsDir, { recursive: true });
+                        }
+                        return [4 /*yield*/, this.createCustomInstructions(promptsDir)];
+                    case 3:
+                        instructionsFile = _a.sent();
+                        files.push(instructionsFile);
+                        if (this.verbose) {
+                            console.log('✅ Cursor 配置完成');
+                        }
+                        return [2 /*return*/, {
+                                success: true,
+                                files: files,
+                                message: 'Cursor configuration created successfully',
+                            }];
+                    case 4:
+                        error_1 = _a.sent();
+                        return [2 /*return*/, {
+                                success: false,
+                                files: [],
+                                error: error_1.message,
+                            }];
+                    case 5: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /**
+     * 创建 Cursor Rules 文件
+     */
+    CursorGenerator.prototype.createRulesFile = function (cursorDir) {
+        return __awaiter(this, void 0, void 0, function () {
+            var rulesPath, rulesContent;
+            return __generator(this, function (_a) {
+                rulesPath = path__namespace.join(cursorDir, 'rules.md');
+                rulesContent = "# Cursor Rules for ".concat(this.config.projectName, "\n\n## TSX \u4EE3\u7801\u751F\u6210\u89C4\u8303\n\n### \u6587\u4EF6\u7ED3\u6784\u8981\u6C42\n\n\u6240\u6709 TSX \u6587\u4EF6\u5FC5\u987B\u9075\u5FAA\u4EE5\u4E0B\u7ED3\u6784\uFF1A\n\n```typescript\n/**\n * @type Page|Component\n * @description \u7EC4\u4EF6\u63CF\u8FF0\n */\n\nimport React from 'react';\n\nclass IProps {\n  // Props \u5B9A\u4E49\n}\n\nclass IState {\n  // State \u5B9A\u4E49\n}\n\nclass Document extends React.Component<IProps, IState> {\n  render() {\n    return (\n      // JSX\n    );\n  }\n}\n\nexport default Document;\n```\n\n### \u5173\u952E\u89C4\u5219\n\n1. **\u5FC5\u987B\u5305\u542B JSDoc \u5143\u6570\u636E**\n   - \u4F7F\u7528 `@type Page` \u6216 `@type Component`\n   - \u4F7F\u7528 `@description` \u63CF\u8FF0\u7EC4\u4EF6\u7528\u9014\n\n2. **\u4F7F\u7528 class \u5B9A\u4E49\u63A5\u53E3**\n   - Props: `class IProps { }`\n   - State: `class IState { }`\n\n3. **render() \u65B9\u6CD5\u89C4\u8303**\n   - \u53EA\u5305\u542B `return` \u8BED\u53E5\u548C JSX\n   - \u4E0D\u5305\u542B\u590D\u6742\u903B\u8F91\n   - \u590D\u6742\u903B\u8F91\u63D0\u53D6\u5230\u5355\u72EC\u65B9\u6CD5\n\n4. **\u6761\u4EF6\u6E32\u67D3**\n   - \u2705 \u4F7F\u7528: `{condition && <Component />}`\n   - \u274C \u907F\u514D: `{condition ? <A /> : <B />}`\n\n5. **\u53EF\u9009\u94FE**\n   - \u2705 \u4F7F\u7528: `user?.profile?.name`\n   - \u274C \u907F\u514D: `user.profile.name`\n\n6. **\u7C7B\u578B\u6CE8\u89E3**\n   - \u274C \u4E0D\u8981\u5728\u65B9\u6CD5\u53C2\u6570\u4E2D\u4F7F\u7528 TypeScript \u7C7B\u578B\u6CE8\u89E3\n   - \u7C7B\u578B\u4FE1\u606F\u5E94\u8BE5\u5728 IProps \u548C IState \u4E2D\u5B9A\u4E49\n\n### \u4EE3\u7801\u793A\u4F8B\n\n```typescript\n/**\n * @type Page\n * @description \u7528\u6237\u5217\u8868\u9875\u9762\n */\n\nimport React from 'react';\n\nclass IProps {\n  users: Array<{ id: string; name: string }>;\n  onUserClick: (userId: string) => void;\n}\n\nclass IState {\n  loading: boolean;\n  searchText: string;\n}\n\nclass Document extends React.Component<IProps, IState> {\n  constructor(props: IProps) {\n    super(props);\n    this.state = {\n      loading: false,\n      searchText: '',\n    };\n  }\n\n  getFilteredUsers() {\n    const { users } = this.props;\n    const { searchText } = this.state;\n    \n    if (!searchText) return users;\n    \n    return users.filter(u =>\n      u?.name?.toLowerCase().includes(searchText.toLowerCase())\n    );\n  }\n\n  render() {\n    const { onUserClick } = this.props;\n    const { loading, searchText } = this.state;\n    const filteredUsers = this.getFilteredUsers();\n\n    return (\n      <div>\n        <input\n          value={searchText}\n          onChange={(e) => this.setState({ searchText: e.target.value })}\n        />\n        \n        {loading && <div>\u52A0\u8F7D\u4E2D...</div>}\n        \n        {!loading && filteredUsers.length === 0 && (\n          <div>\u6682\u65E0\u6570\u636E</div>\n        )}\n        \n        {!loading && filteredUsers.length > 0 && (\n          <ul>\n            {filteredUsers.map(user => (\n              <li key={user.id} onClick={() => onUserClick(user.id)}>\n                {user?.name}\n              </li>\n            ))}\n          </ul>\n        )}\n      </div>\n    );\n  }\n}\n\nexport default Document;\n```\n\n## \u9879\u76EE\u7279\u5B9A\u89C4\u5219\n\n- \u9879\u76EE\u540D\u79F0: ").concat(this.config.projectName, "\n- \u7A7A\u95F4ID: ").concat(this.config.spaceId, "\n- \u521B\u5EFA\u65F6\u95F4: ").concat(this.config.createdAt, "\n\n## \u66F4\u591A\u4FE1\u606F\n\n\u8BE6\u7EC6\u7684\u63D0\u793A\u8BCD\u548C\u89C4\u8303\u8BF7\u67E5\u770B `.appthen/prompts/` \u76EE\u5F55\u3002\n");
+                fs__namespace.writeFileSync(rulesPath, rulesContent);
+                if (this.verbose) {
+                    console.log("\uD83D\uDCDD \u521B\u5EFA Cursor Rules: ".concat(rulesPath));
+                }
+                return [2 /*return*/, rulesPath];
+            });
+        });
+    };
+    /**
+     * 创建自定义指令文件
+     */
+    CursorGenerator.prototype.createCustomInstructions = function (promptsDir) {
+        return __awaiter(this, void 0, void 0, function () {
+            var instructionsPath, instructionsContent;
+            return __generator(this, function (_a) {
+                instructionsPath = path__namespace.join(promptsDir, 'custom-instructions.md');
+                instructionsContent = "# Custom Instructions for ".concat(this.config.projectName, "\n\n## \u4EE3\u7801\u751F\u6210\u6307\u4EE4\n\n\u5F53\u751F\u6210 TSX \u4EE3\u7801\u65F6\uFF1A\n\n1. \u59CB\u7EC8\u9075\u5FAA `.cursor/rules.md` \u4E2D\u5B9A\u4E49\u7684\u89C4\u8303\n2. \u786E\u4FDD\u5305\u542B\u5B8C\u6574\u7684 JSDoc \u5143\u6570\u636E\n3. \u4F7F\u7528 class \u5B9A\u4E49 IProps \u548C IState\n4. render() \u65B9\u6CD5\u4FDD\u6301\u7B80\u6D01\n5. \u4F7F\u7528 && \u8FD0\u7B97\u7B26\u8FDB\u884C\u6761\u4EF6\u6E32\u67D3\n6. \u4F7F\u7528\u53EF\u9009\u94FE\u8BBF\u95EE\u5BF9\u8C61\u5C5E\u6027\n\n## \u4EE3\u7801\u5BA1\u67E5\u6307\u4EE4\n\n\u5F53\u5BA1\u67E5\u4EE3\u7801\u65F6\uFF1A\n\n1. \u68C0\u67E5\u662F\u5426\u7B26\u5408 TSX \u89C4\u8303\n2. \u8BC6\u522B\u6F5C\u5728\u7684\u6027\u80FD\u95EE\u9898\n3. \u68C0\u67E5\u8FB9\u754C\u60C5\u51B5\u5904\u7406\n4. \u9A8C\u8BC1\u9519\u8BEF\u5904\u7406\u903B\u8F91\n5. \u8BC4\u4F30\u4EE3\u7801\u53EF\u7EF4\u62A4\u6027\n\n## \u91CD\u6784\u6307\u4EE4\n\n\u5F53\u91CD\u6784\u4EE3\u7801\u65F6\uFF1A\n\n1. \u4FDD\u6301\u529F\u80FD\u4E0D\u53D8\n2. \u63D0\u53D6\u91CD\u590D\u4EE3\u7801\n3. \u7B80\u5316\u590D\u6742\u903B\u8F91\n4. \u63D0\u9AD8\u4EE3\u7801\u53EF\u8BFB\u6027\n5. \u4F18\u5316\u6027\u80FD\n\n## \u53C2\u8003\u8D44\u6599\n\n- TSX \u751F\u6210\u89C4\u8303: `.appthen/prompts/tsx-generation.md`\n- \u4EE3\u7801\u5BA1\u67E5\u6307\u5357: `.appthen/prompts/code-review.md`\n- \u91CD\u6784\u6307\u5357: `.appthen/prompts/refactoring.md`\n");
+                fs__namespace.writeFileSync(instructionsPath, instructionsContent);
+                if (this.verbose) {
+                    console.log("\uD83D\uDCDD \u521B\u5EFA\u81EA\u5B9A\u4E49\u6307\u4EE4: ".concat(instructionsPath));
+                }
+                return [2 /*return*/, instructionsPath];
+            });
+        });
+    };
+    return CursorGenerator;
+}());
+
+/**
+ * Windsurf 生成器
+ * 生成 Windsurf (Codeium) 特定的配置文件
+ */
+var WindsurfGenerator = /** @class */ (function () {
+    function WindsurfGenerator(cwd, config, verbose) {
+        this.cwd = cwd;
+        this.config = config;
+        this.verbose = verbose;
+    }
+    /**
+     * 生成 Windsurf 配置
+     */
+    WindsurfGenerator.prototype.generate = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            var files, windsurfDir, cascadeFile, rulesFile, error_1;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        files = [];
+                        _a.label = 1;
+                    case 1:
+                        _a.trys.push([1, 4, , 5]);
+                        if (this.verbose) {
+                            console.log('🌊 配置 Windsurf 集成...');
+                        }
+                        windsurfDir = path__namespace.join(this.cwd, '.windsurf');
+                        if (!fs__namespace.existsSync(windsurfDir)) {
+                            fs__namespace.mkdirSync(windsurfDir, { recursive: true });
+                            if (this.verbose) {
+                                console.log("\uD83D\uDCC1 \u521B\u5EFA\u76EE\u5F55: ".concat(windsurfDir));
+                            }
+                        }
+                        return [4 /*yield*/, this.createCascadeConfig(windsurfDir)];
+                    case 2:
+                        cascadeFile = _a.sent();
+                        files.push(cascadeFile);
+                        return [4 /*yield*/, this.createRulesFile(windsurfDir)];
+                    case 3:
+                        rulesFile = _a.sent();
+                        files.push(rulesFile);
+                        if (this.verbose) {
+                            console.log('✅ Windsurf 配置完成');
+                        }
+                        return [2 /*return*/, {
+                                success: true,
+                                files: files,
+                                message: 'Windsurf configuration created successfully',
+                            }];
+                    case 4:
+                        error_1 = _a.sent();
+                        return [2 /*return*/, {
+                                success: false,
+                                files: [],
+                                error: error_1.message,
+                            }];
+                    case 5: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /**
+     * 创建 Cascade 配置文件
+     */
+    WindsurfGenerator.prototype.createCascadeConfig = function (windsurfDir) {
+        return __awaiter(this, void 0, void 0, function () {
+            var cascadePath, cascadeConfig;
+            return __generator(this, function (_a) {
+                cascadePath = path__namespace.join(windsurfDir, 'cascade.json');
+                cascadeConfig = {
+                    name: this.config.projectName,
+                    description: "Agent+ Space configuration for ".concat(this.config.projectName),
+                    version: '1.0.0',
+                    rules: {
+                        tsx: {
+                            enabled: true,
+                            strictMode: true,
+                            checkMetadata: true,
+                            checkClassDefinitions: true,
+                            checkRenderMethod: true,
+                            enforceConditionalRendering: true,
+                            enforceOptionalChaining: true,
+                        },
+                    },
+                    prompts: {
+                        codeGeneration: '.appthen/prompts/tsx-generation.md',
+                        codeReview: '.appthen/prompts/code-review.md',
+                        refactoring: '.appthen/prompts/refactoring.md',
+                    },
+                    workspace: {
+                        root: this.cwd,
+                        include: ['src/**/*', 'docs/**/*'],
+                        exclude: [
+                            'node_modules/**',
+                            'dist/**',
+                            'build/**',
+                            '.git/**',
+                            '*.log',
+                        ],
+                    },
+                };
+                fs__namespace.writeFileSync(cascadePath, JSON.stringify(cascadeConfig, null, 2));
+                if (this.verbose) {
+                    console.log("\uD83D\uDCDD \u521B\u5EFA Cascade \u914D\u7F6E: ".concat(cascadePath));
+                }
+                return [2 /*return*/, cascadePath];
+            });
+        });
+    };
+    /**
+     * 创建 Rules 文件
+     */
+    WindsurfGenerator.prototype.createRulesFile = function (windsurfDir) {
+        return __awaiter(this, void 0, void 0, function () {
+            var rulesPath, rulesContent;
+            return __generator(this, function (_a) {
+                rulesPath = path__namespace.join(windsurfDir, 'rules.md');
+                rulesContent = "# Windsurf Rules for ".concat(this.config.projectName, "\n\n## TSX \u4EE3\u7801\u89C4\u8303\n\n### \u57FA\u672C\u8981\u6C42\n\n1. **\u6587\u4EF6\u7ED3\u6784**\n   - JSDoc \u5143\u6570\u636E\u6CE8\u91CA\uFF08@type, @description\uFF09\n   - class IProps \u548C class IState \u5B9A\u4E49\n   - class Document extends React.Component\n   - render() \u65B9\u6CD5\u53EA\u5305\u542B return \u8BED\u53E5\n\n2. **\u6761\u4EF6\u6E32\u67D3**\n   - \u4F7F\u7528 && \u8FD0\u7B97\u7B26\n   - \u907F\u514D\u4E09\u5143\u8868\u8FBE\u5F0F\n\n3. **\u5BF9\u8C61\u8BBF\u95EE**\n   - \u4F7F\u7528\u53EF\u9009\u94FE\uFF08?.\uFF09\n   - \u907F\u514D\u76F4\u63A5\u5C5E\u6027\u8BBF\u95EE\n\n### \u4EE3\u7801\u751F\u6210\u6A21\u677F\n\n```typescript\n/**\n * @type Page|Component\n * @description [\u63CF\u8FF0]\n */\n\nimport React from 'react';\n\nclass IProps {\n  // Props \u5B9A\u4E49\n}\n\nclass IState {\n  // State \u5B9A\u4E49\n}\n\nclass Document extends React.Component<IProps, IState> {\n  render() {\n    return (\n      // JSX\n    );\n  }\n}\n\nexport default Document;\n```\n\n### \u6700\u4F73\u5B9E\u8DF5\n\n- \u4FDD\u6301 render() \u65B9\u6CD5\u7B80\u6D01\n- \u590D\u6742\u903B\u8F91\u63D0\u53D6\u5230\u5355\u72EC\u65B9\u6CD5\n- \u4F7F\u7528\u6709\u610F\u4E49\u7684\u53D8\u91CF\u540D\n- \u6DFB\u52A0\u5FC5\u8981\u7684\u6CE8\u91CA\n- \u5904\u7406\u8FB9\u754C\u60C5\u51B5\n\n### \u53C2\u8003\u8D44\u6599\n\n\u8BE6\u7EC6\u89C4\u8303\u8BF7\u67E5\u770B\uFF1A\n- `.appthen/prompts/tsx-generation.md`\n- `.appthen/prompts/code-review.md`\n- `.appthen/prompts/refactoring.md`\n\n## \u9879\u76EE\u4FE1\u606F\n\n- \u9879\u76EE: ").concat(this.config.projectName, "\n- \u7A7A\u95F4ID: ").concat(this.config.spaceId, "\n- \u5DE5\u5177: Windsurf (Codeium)\n");
+                fs__namespace.writeFileSync(rulesPath, rulesContent);
+                if (this.verbose) {
+                    console.log("\uD83D\uDCDD \u521B\u5EFA Rules \u6587\u4EF6: ".concat(rulesPath));
+                }
+                return [2 /*return*/, rulesPath];
+            });
+        });
+    };
+    return WindsurfGenerator;
+}());
+
+/**
+ * 阿里云 Coder 生成器
+ * 生成阿里云 Coder 特定的配置文件
+ */
+var CoderGenerator = /** @class */ (function () {
+    function CoderGenerator(cwd, config, verbose) {
+        this.cwd = cwd;
+        this.config = config;
+        this.verbose = verbose;
+    }
+    /**
+     * 生成阿里云 Coder 配置
+     */
+    CoderGenerator.prototype.generate = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            var files, coderDir, configFile, templatesDir, templateFile, error_1;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        files = [];
+                        _a.label = 1;
+                    case 1:
+                        _a.trys.push([1, 4, , 5]);
+                        if (this.verbose) {
+                            console.log('☁️  配置阿里云 Coder 集成...');
+                        }
+                        coderDir = path__namespace.join(this.cwd, '.coder');
+                        if (!fs__namespace.existsSync(coderDir)) {
+                            fs__namespace.mkdirSync(coderDir, { recursive: true });
+                            if (this.verbose) {
+                                console.log("\uD83D\uDCC1 \u521B\u5EFA\u76EE\u5F55: ".concat(coderDir));
+                            }
+                        }
+                        return [4 /*yield*/, this.createConfig(coderDir)];
+                    case 2:
+                        configFile = _a.sent();
+                        files.push(configFile);
+                        templatesDir = path__namespace.join(coderDir, 'templates');
+                        if (!fs__namespace.existsSync(templatesDir)) {
+                            fs__namespace.mkdirSync(templatesDir, { recursive: true });
+                        }
+                        return [4 /*yield*/, this.createTsxTemplate(templatesDir)];
+                    case 3:
+                        templateFile = _a.sent();
+                        files.push(templateFile);
+                        if (this.verbose) {
+                            console.log('✅ 阿里云 Coder 配置完成');
+                        }
+                        return [2 /*return*/, {
+                                success: true,
+                                files: files,
+                                message: 'Coder configuration created successfully',
+                            }];
+                    case 4:
+                        error_1 = _a.sent();
+                        return [2 /*return*/, {
+                                success: false,
+                                files: [],
+                                error: error_1.message,
+                            }];
+                    case 5: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /**
+     * 创建配置文件
+     */
+    CoderGenerator.prototype.createConfig = function (coderDir) {
+        return __awaiter(this, void 0, void 0, function () {
+            var configPath, config;
+            return __generator(this, function (_a) {
+                configPath = path__namespace.join(coderDir, 'config.json');
+                config = {
+                    projectName: this.config.projectName,
+                    spaceId: this.config.spaceId,
+                    version: '1.0.0',
+                    codeGeneration: {
+                        tsx: {
+                            enabled: true,
+                            template: 'templates/tsx-template.md',
+                            rules: {
+                                requireMetadata: true,
+                                requireClassDefinitions: true,
+                                enforceRenderStructure: true,
+                                useConditionalOperator: true,
+                                useOptionalChaining: true,
+                            },
+                        },
+                    },
+                    prompts: {
+                        generation: '../.appthen/prompts/tsx-generation.md',
+                        review: '../.appthen/prompts/code-review.md',
+                        refactoring: '../.appthen/prompts/refactoring.md',
+                    },
+                    workspace: {
+                        include: ['src/**/*', 'docs/**/*'],
+                        exclude: [
+                            'node_modules/**',
+                            'dist/**',
+                            'build/**',
+                            '.git/**',
+                            '*.log',
+                        ],
+                    },
+                };
+                fs__namespace.writeFileSync(configPath, JSON.stringify(config, null, 2));
+                if (this.verbose) {
+                    console.log("\uD83D\uDCDD \u521B\u5EFA\u914D\u7F6E\u6587\u4EF6: ".concat(configPath));
+                }
+                return [2 /*return*/, configPath];
+            });
+        });
+    };
+    /**
+     * 创建 TSX 模板
+     */
+    CoderGenerator.prototype.createTsxTemplate = function (templatesDir) {
+        return __awaiter(this, void 0, void 0, function () {
+            var templatePath, templateContent;
+            return __generator(this, function (_a) {
+                templatePath = path__namespace.join(templatesDir, 'tsx-template.md');
+                templateContent = "# TSX \u4EE3\u7801\u6A21\u677F - ".concat(this.config.projectName, "\n\n## \u57FA\u7840\u6A21\u677F\n\n```typescript\n/**\n * @type [Page|Component]\n * @description [\u7EC4\u4EF6\u63CF\u8FF0]\n */\n\nimport React from 'react';\n\nclass IProps {\n  // TODO: \u5B9A\u4E49 Props\n}\n\nclass IState {\n  // TODO: \u5B9A\u4E49 State\n}\n\nclass Document extends React.Component<IProps, IState> {\n  constructor(props: IProps) {\n    super(props);\n    this.state = {\n      // TODO: \u521D\u59CB\u5316 State\n    };\n  }\n\n  render() {\n    return (\n      <div>\n        {/* TODO: \u5B9E\u73B0 JSX */}\n      </div>\n    );\n  }\n}\n\nexport default Document;\n```\n\n## \u9875\u9762\u6A21\u677F\n\n```typescript\n/**\n * @type Page\n * @description [\u9875\u9762\u63CF\u8FF0]\n */\n\nimport React from 'react';\n\nclass IProps {\n  // \u9875\u9762 Props\n}\n\nclass IState {\n  loading: boolean;\n  data: any;\n  error: string | null;\n}\n\nclass Document extends React.Component<IProps, IState> {\n  constructor(props: IProps) {\n    super(props);\n    this.state = {\n      loading: false,\n      data: null,\n      error: null,\n    };\n  }\n\n  componentDidMount() {\n    this.loadData();\n  }\n\n  async loadData() {\n    this.setState({ loading: true, error: null });\n    \n    try {\n      // TODO: \u52A0\u8F7D\u6570\u636E\n      const data = await fetchData();\n      this.setState({ data, loading: false });\n    } catch (error) {\n      this.setState({ error: error.message, loading: false });\n    }\n  }\n\n  render() {\n    const { loading, data, error } = this.state;\n\n    return (\n      <div className=\"page\">\n        {loading && <div>\u52A0\u8F7D\u4E2D...</div>}\n        \n        {error && <div className=\"error\">{error}</div>}\n        \n        {!loading && !error && data && (\n          <div className=\"content\">\n            {/* TODO: \u6E32\u67D3\u6570\u636E */}\n          </div>\n        )}\n      </div>\n    );\n  }\n}\n\nexport default Document;\n```\n\n## \u7EC4\u4EF6\u6A21\u677F\n\n```typescript\n/**\n * @type Component\n * @description [\u7EC4\u4EF6\u63CF\u8FF0]\n */\n\nimport React from 'react';\n\nclass IProps {\n  // \u7EC4\u4EF6 Props\n}\n\nclass IState {\n  // \u7EC4\u4EF6 State\n}\n\nclass Document extends React.Component<IProps, IState> {\n  render() {\n    const { } = this.props;\n    \n    return (\n      <div className=\"component\">\n        {/* TODO: \u5B9E\u73B0\u7EC4\u4EF6 */}\n      </div>\n    );\n  }\n}\n\nexport default Document;\n```\n\n## \u4F7F\u7528\u8BF4\u660E\n\n1. \u9009\u62E9\u5408\u9002\u7684\u6A21\u677F\uFF08\u57FA\u7840/\u9875\u9762/\u7EC4\u4EF6\uFF09\n2. \u66FF\u6362 TODO \u6CE8\u91CA\u4E2D\u7684\u5185\u5BB9\n3. \u786E\u4FDD\u9075\u5FAA TSX \u89C4\u8303\uFF1A\n   - \u5305\u542B JSDoc \u5143\u6570\u636E\n   - \u4F7F\u7528 class \u5B9A\u4E49 IProps \u548C IState\n   - render() \u53EA\u5305\u542B return \u8BED\u53E5\n   - \u4F7F\u7528 && \u8FD0\u7B97\u7B26\u8FDB\u884C\u6761\u4EF6\u6E32\u67D3\n   - \u4F7F\u7528\u53EF\u9009\u94FE\u8BBF\u95EE\u5BF9\u8C61\u5C5E\u6027\n\n## \u53C2\u8003\u8D44\u6599\n\n- \u8BE6\u7EC6\u89C4\u8303: `.appthen/prompts/tsx-generation.md`\n- \u4EE3\u7801\u5BA1\u67E5: `.appthen/prompts/code-review.md`\n- \u91CD\u6784\u6307\u5357: `.appthen/prompts/refactoring.md`\n");
+                fs__namespace.writeFileSync(templatePath, templateContent);
+                if (this.verbose) {
+                    console.log("\uD83D\uDCDD \u521B\u5EFA TSX \u6A21\u677F: ".concat(templatePath));
+                }
+                return [2 /*return*/, templatePath];
+            });
+        });
+    };
+    return CoderGenerator;
+}());
+
+/**
+ * Augment 生成器
+ * 生成 Augment (VSCode 插件) 特定的配置文件
+ */
+var AugmentGenerator = /** @class */ (function () {
+    function AugmentGenerator(cwd, config, verbose) {
+        this.cwd = cwd;
+        this.config = config;
+        this.verbose = verbose;
+    }
+    /**
+     * 生成 Augment 配置
+     */
+    AugmentGenerator.prototype.generate = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            var files, augmentDir, configFile, contextDir, contextFile, error_1;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        files = [];
+                        _a.label = 1;
+                    case 1:
+                        _a.trys.push([1, 4, , 5]);
+                        if (this.verbose) {
+                            console.log('🔧 配置 Augment 集成...');
+                        }
+                        augmentDir = path__namespace.join(this.cwd, '.augment');
+                        if (!fs__namespace.existsSync(augmentDir)) {
+                            fs__namespace.mkdirSync(augmentDir, { recursive: true });
+                            if (this.verbose) {
+                                console.log("\uD83D\uDCC1 \u521B\u5EFA\u76EE\u5F55: ".concat(augmentDir));
+                            }
+                        }
+                        return [4 /*yield*/, this.createConfig(augmentDir)];
+                    case 2:
+                        configFile = _a.sent();
+                        files.push(configFile);
+                        contextDir = path__namespace.join(augmentDir, 'context');
+                        if (!fs__namespace.existsSync(contextDir)) {
+                            fs__namespace.mkdirSync(contextDir, { recursive: true });
+                        }
+                        return [4 /*yield*/, this.createProjectContext(contextDir)];
+                    case 3:
+                        contextFile = _a.sent();
+                        files.push(contextFile);
+                        if (this.verbose) {
+                            console.log('✅ Augment 配置完成');
+                        }
+                        return [2 /*return*/, {
+                                success: true,
+                                files: files,
+                                message: 'Augment configuration created successfully',
+                            }];
+                    case 4:
+                        error_1 = _a.sent();
+                        return [2 /*return*/, {
+                                success: false,
+                                files: [],
+                                error: error_1.message,
+                            }];
+                    case 5: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /**
+     * 创建配置文件
+     */
+    AugmentGenerator.prototype.createConfig = function (augmentDir) {
+        return __awaiter(this, void 0, void 0, function () {
+            var configPath, config;
+            return __generator(this, function (_a) {
+                configPath = path__namespace.join(augmentDir, 'config.json');
+                config = {
+                    projectName: this.config.projectName,
+                    spaceId: this.config.spaceId,
+                    version: '1.0.0',
+                    context: {
+                        enabled: true,
+                        files: ['context/project-context.md'],
+                        prompts: [
+                            '../.appthen/prompts/tsx-generation.md',
+                            '../.appthen/prompts/code-review.md',
+                            '../.appthen/prompts/refactoring.md',
+                        ],
+                    },
+                    codeGeneration: {
+                        tsx: {
+                            enabled: true,
+                            strictMode: true,
+                            autoFormat: true,
+                        },
+                    },
+                    workspace: {
+                        include: ['src/**/*', 'docs/**/*'],
+                        exclude: [
+                            'node_modules/**',
+                            'dist/**',
+                            'build/**',
+                            '.git/**',
+                            '*.log',
+                        ],
+                    },
+                };
+                fs__namespace.writeFileSync(configPath, JSON.stringify(config, null, 2));
+                if (this.verbose) {
+                    console.log("\uD83D\uDCDD \u521B\u5EFA\u914D\u7F6E\u6587\u4EF6: ".concat(configPath));
+                }
+                return [2 /*return*/, configPath];
+            });
+        });
+    };
+    /**
+     * 创建项目上下文文件
+     */
+    AugmentGenerator.prototype.createProjectContext = function (contextDir) {
+        return __awaiter(this, void 0, void 0, function () {
+            var contextPath, contextContent;
+            return __generator(this, function (_a) {
+                contextPath = path__namespace.join(contextDir, 'project-context.md');
+                contextContent = "# Project Context - ".concat(this.config.projectName, "\n\n## \u9879\u76EE\u4FE1\u606F\n\n- **\u9879\u76EE\u540D\u79F0**: ").concat(this.config.projectName, "\n- **\u7A7A\u95F4ID**: ").concat(this.config.spaceId, "\n- **\u521B\u5EFA\u65F6\u95F4**: ").concat(this.config.createdAt, "\n- **AI \u5DE5\u5177**: Augment (VSCode)\n\n## TSX \u4EE3\u7801\u89C4\u8303\n\n### \u6587\u4EF6\u7ED3\u6784\n\n\u6240\u6709 TSX \u6587\u4EF6\u5FC5\u987B\u9075\u5FAA\u4EE5\u4E0B\u7ED3\u6784\uFF1A\n\n```typescript\n/**\n * @type Page|Component\n * @description \u7EC4\u4EF6\u63CF\u8FF0\n */\n\nimport React from 'react';\n\nclass IProps {\n  // Props \u5B9A\u4E49\n}\n\nclass IState {\n  // State \u5B9A\u4E49\n}\n\nclass Document extends React.Component<IProps, IState> {\n  render() {\n    return (\n      // JSX\n    );\n  }\n}\n\nexport default Document;\n```\n\n### \u5173\u952E\u89C4\u5219\n\n1. **JSDoc \u5143\u6570\u636E**\n   - \u5FC5\u987B\u5305\u542B `@type` \u548C `@description`\n   - `@type` \u503C\u4E3A `Page` \u6216 `Component`\n\n2. **\u7C7B\u5B9A\u4E49**\n   - \u4F7F\u7528 `class IProps` \u5B9A\u4E49 Props\n   - \u4F7F\u7528 `class IState` \u5B9A\u4E49 State\n   - \u7EC4\u4EF6\u7C7B\u7EE7\u627F `React.Component<IProps, IState>`\n\n3. **render() \u65B9\u6CD5**\n   - \u53EA\u5305\u542B `return` \u8BED\u53E5\u548C JSX\n   - \u4E0D\u5305\u542B\u590D\u6742\u903B\u8F91\n   - \u590D\u6742\u903B\u8F91\u63D0\u53D6\u5230\u5355\u72EC\u65B9\u6CD5\n\n4. **\u6761\u4EF6\u6E32\u67D3**\n   - \u2705 \u4F7F\u7528: `{condition && <Component />}`\n   - \u274C \u907F\u514D: `{condition ? <A /> : <B />}`\n\n5. **\u5BF9\u8C61\u8BBF\u95EE**\n   - \u2705 \u4F7F\u7528: `user?.profile?.name`\n   - \u274C \u907F\u514D: `user.profile.name`\n\n6. **\u7C7B\u578B\u6CE8\u89E3**\n   - \u274C \u4E0D\u8981\u5728\u65B9\u6CD5\u53C2\u6570\u4E2D\u4F7F\u7528 TypeScript \u7C7B\u578B\u6CE8\u89E3\n   - \u7C7B\u578B\u4FE1\u606F\u5728 IProps \u548C IState \u4E2D\u5B9A\u4E49\n\n### \u4EE3\u7801\u793A\u4F8B\n\n```typescript\n/**\n * @type Page\n * @description \u7528\u6237\u5217\u8868\u9875\u9762\n */\n\nimport React from 'react';\n\nclass IProps {\n  users: Array<{ id: string; name: string }>;\n}\n\nclass IState {\n  loading: boolean;\n}\n\nclass Document extends React.Component<IProps, IState> {\n  constructor(props: IProps) {\n    super(props);\n    this.state = {\n      loading: false,\n    };\n  }\n\n  render() {\n    const { users } = this.props;\n    const { loading } = this.state;\n\n    return (\n      <div>\n        {loading && <div>\u52A0\u8F7D\u4E2D...</div>}\n        \n        {!loading && users.length === 0 && (\n          <div>\u6682\u65E0\u6570\u636E</div>\n        )}\n        \n        {!loading && users.length > 0 && (\n          <ul>\n            {users.map(user => (\n              <li key={user.id}>{user?.name}</li>\n            ))}\n          </ul>\n        )}\n      </div>\n    );\n  }\n}\n\nexport default Document;\n```\n\n## \u5F00\u53D1\u5DE5\u4F5C\u6D41\n\n1. **\u4EE3\u7801\u751F\u6210**\n   - \u4F7F\u7528 Augment \u751F\u6210\u7B26\u5408\u89C4\u8303\u7684 TSX \u4EE3\u7801\n   - \u53C2\u8003 `.appthen/prompts/tsx-generation.md`\n\n2. **\u4EE3\u7801\u5BA1\u67E5**\n   - \u68C0\u67E5\u662F\u5426\u7B26\u5408 TSX \u89C4\u8303\n   - \u53C2\u8003 `.appthen/prompts/code-review.md`\n\n3. **\u4EE3\u7801\u91CD\u6784**\n   - \u63D0\u53D6\u91CD\u590D\u4EE3\u7801\n   - \u7B80\u5316\u590D\u6742\u903B\u8F91\n   - \u53C2\u8003 `.appthen/prompts/refactoring.md`\n\n## \u53C2\u8003\u8D44\u6599\n\n- **TSX \u751F\u6210\u89C4\u8303**: `.appthen/prompts/tsx-generation.md`\n- **\u4EE3\u7801\u5BA1\u67E5\u6307\u5357**: `.appthen/prompts/code-review.md`\n- **\u91CD\u6784\u6307\u5357**: `.appthen/prompts/refactoring.md`\n\n## \u6CE8\u610F\u4E8B\u9879\n\n- \u59CB\u7EC8\u9075\u5FAA TSX \u89C4\u8303\n- \u4FDD\u6301\u4EE3\u7801\u7B80\u6D01\u6613\u8BFB\n- \u5904\u7406\u8FB9\u754C\u60C5\u51B5\n- \u6DFB\u52A0\u5FC5\u8981\u7684\u6CE8\u91CA\n- \u4F7F\u7528\u6709\u610F\u4E49\u7684\u53D8\u91CF\u540D\n");
+                fs__namespace.writeFileSync(contextPath, contextContent);
+                if (this.verbose) {
+                    console.log("\uD83D\uDCDD \u521B\u5EFA\u9879\u76EE\u4E0A\u4E0B\u6587: ".concat(contextPath));
+                }
+                return [2 /*return*/, contextPath];
+            });
+        });
+    };
+    return AugmentGenerator;
+}());
+
+/**
+ * 初始化 Agent+ Space
+ */
+function initSpace(options) {
+    if (options === void 0) { options = {}; }
+    return __awaiter(this, void 0, void 0, function () {
+        var _a, force, _b, verbose, _c, cwd, _d, skipPrompts, _e, skipHooks, configPath, tool, projectName, spaceId, spaceConfig, baseGenerator, baseResult, toolResult, allFiles, error_1;
+        return __generator(this, function (_f) {
+            switch (_f.label) {
+                case 0:
+                    _a = options.force, force = _a === void 0 ? false : _a, _b = options.verbose, verbose = _b === void 0 ? false : _b, _c = options.cwd, cwd = _c === void 0 ? process.cwd() : _c, _d = options.skipPrompts, skipPrompts = _d === void 0 ? false : _d, _e = options.skipHooks, skipHooks = _e === void 0 ? false : _e;
+                    _f.label = 1;
+                case 1:
+                    _f.trys.push([1, 6, , 7]);
+                    configPath = path__namespace.join(cwd, '.appthen/space-config.json');
+                    if (fs__namespace.existsSync(configPath) && !force) {
+                        console.log('');
+                        console.log('⚠️  Space 已经初始化');
+                        console.log("   \u914D\u7F6E\u6587\u4EF6: ".concat(configPath));
+                        console.log('');
+                        console.log('💡 提示:');
+                        console.log('   - 使用 --force 强制重新初始化');
+                        console.log('   - 使用 appthen connect 连接到编辑器');
+                        console.log('');
+                        return [2 /*return*/, { success: false, error: 'Already initialized' }];
+                    }
+                    tool = options.tool;
+                    if (!!tool) return [3 /*break*/, 3];
+                    return [4 /*yield*/, promptForTool()];
+                case 2:
+                    tool = _f.sent();
+                    _f.label = 3;
+                case 3:
+                    projectName = options.name || path__namespace.basename(cwd);
+                    spaceId = "".concat(projectName, "-").concat(nanoid$1(8));
+                    spaceConfig = {
+                        spaceId: spaceId,
+                        projectId: options.projectId,
+                        projectName: projectName,
+                        projectRoot: cwd,
+                        tool: tool,
+                        createdAt: new Date().toISOString(),
+                        version: '1.0.0',
+                    };
+                    console.log('');
+                    console.log('🚀 初始化 Agent+ Space...');
+                    console.log('');
+                    if (verbose) {
+                        console.log("   \u5DE5\u5177: ".concat(getToolName(tool)));
+                        console.log("   \u9879\u76EE: ".concat(projectName));
+                        console.log("   \u7A7A\u95F4ID: ".concat(spaceId));
+                        console.log('');
+                    }
+                    baseGenerator = new BaseGenerator(cwd, spaceConfig, verbose);
+                    return [4 /*yield*/, baseGenerator.generate(skipPrompts)];
+                case 4:
+                    baseResult = _f.sent();
+                    if (!baseResult.success) {
+                        console.error('❌ 基础配置生成失败:', baseResult.error);
+                        return [2 /*return*/, baseResult];
+                    }
+                    return [4 /*yield*/, generateToolSpecificFiles(tool, cwd, spaceConfig, verbose, skipHooks)];
+                case 5:
+                    toolResult = _f.sent();
+                    if (!toolResult.success) {
+                        console.error('❌ 工具配置生成失败:', toolResult.error);
+                        return [2 /*return*/, toolResult];
+                    }
+                    // 7. 输出成功信息
+                    console.log('');
+                    console.log('🎉 Agent+ Space 初始化完成！');
+                    console.log('');
+                    console.log('📋 已创建的文件:');
+                    allFiles = __spreadArray(__spreadArray([], __read(baseResult.files), false), __read(toolResult.files), false);
+                    allFiles.forEach(function (file) {
+                        var relativePath = path__namespace.relative(cwd, file);
+                        console.log("   \u2713 ".concat(relativePath));
+                    });
+                    console.log('');
+                    console.log('🚀 下一步:');
+                    console.log("   cd ".concat(cwd));
+                    console.log('   appthen connect');
+                    console.log('');
+                    console.log('📖 更多信息:');
+                    console.log('   - 查看 .appthen/prompts/README.md 了解提示词使用');
+                    if (tool === 'claude-code') {
+                        console.log('   - 查看 .claude/settings.json 了解 Hooks 配置');
+                    }
+                    else if (tool === 'cursor') {
+                        console.log('   - 查看 .cursor/rules.md 了解 Cursor Rules');
+                    }
+                    else if (tool === 'windsurf') {
+                        console.log('   - 查看 .windsurf/cascade.json 了解 Cascade 配置');
+                    }
+                    else if (tool === 'coder') {
+                        console.log('   - 查看 .coder/config.json 了解配置选项');
+                    }
+                    else if (tool === 'augment') {
+                        console.log('   - 查看 .augment/context/project-context.md 了解项目上下文');
+                    }
+                    console.log('');
+                    return [2 /*return*/, {
+                            success: true,
+                            message: 'Space initialized successfully',
+                            spaceId: spaceId,
+                            files: allFiles,
+                        }];
+                case 6:
+                    error_1 = _f.sent();
+                    console.error('');
+                    console.error('❌ 初始化失败:', error_1.message);
+                    console.error('');
+                    if (verbose) {
+                        console.error('错误详情:', error_1);
+                    }
+                    return [2 /*return*/, {
+                            success: false,
+                            error: error_1.message,
+                        }];
+                case 7: return [2 /*return*/];
+            }
+        });
+    });
+}
+/**
+ * 提示用户选择 AI 工具
+ */
+function promptForTool() {
+    return __awaiter(this, void 0, void 0, function () {
+        var inquirer, answer;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    _a.trys.push([0, 3, , 4]);
+                    return [4 /*yield*/, Promise.resolve().then(function () { return /*#__PURE__*/_interopNamespace(require('inquirer')); })];
+                case 1:
+                    inquirer = _a.sent();
+                    return [4 /*yield*/, inquirer.default.prompt([
+                            {
+                                type: 'list',
+                                name: 'tool',
+                                message: '请选择你使用的 AI 编码工具：',
+                                choices: AI_TOOLS.map(function (tool) { return ({
+                                    name: tool.name,
+                                    value: tool.value,
+                                }); }),
+                            },
+                        ])];
+                case 2:
+                    answer = _a.sent();
+                    return [2 /*return*/, answer.tool];
+                case 3:
+                    _a.sent();
+                    // 如果 inquirer 不可用，提供友好的错误提示
+                    console.log('');
+                    console.log('⚠️  无法启动交互式选择');
+                    console.log('');
+                    console.log('💡 请使用 --tool 参数指定 AI 工具：');
+                    console.log('');
+                    console.log('   appthen init-space --tool claude-code   # Claude Code');
+                    console.log('   appthen init-space --tool cursor        # Cursor');
+                    console.log('   appthen init-space --tool windsurf      # Windsurf');
+                    console.log('   appthen init-space --tool coder         # 阿里云 Coder');
+                    console.log('   appthen init-space --tool augment       # Augment');
+                    console.log('   appthen init-space --tool other         # 其他/跳过');
+                    console.log('');
+                    throw new Error('需要指定 --tool 参数');
+                case 4: return [2 /*return*/];
+            }
+        });
+    });
+}
+/**
+ * 根据工具生成特定文件
+ */
+function generateToolSpecificFiles(tool, cwd, config, verbose, skipHooks) {
+    return __awaiter(this, void 0, void 0, function () {
+        var _a, generator, generator, generator, generator, generator;
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0:
+                    _a = tool;
+                    switch (_a) {
+                        case 'claude-code': return [3 /*break*/, 1];
+                        case 'cursor': return [3 /*break*/, 3];
+                        case 'windsurf': return [3 /*break*/, 5];
+                        case 'coder': return [3 /*break*/, 7];
+                        case 'augment': return [3 /*break*/, 9];
+                        case 'other': return [3 /*break*/, 11];
+                    }
+                    return [3 /*break*/, 11];
+                case 1:
+                    generator = new ClaudeCodeGenerator(cwd, config, verbose);
+                    return [4 /*yield*/, generator.generate(skipHooks)];
+                case 2: return [2 /*return*/, _b.sent()];
+                case 3:
+                    generator = new CursorGenerator(cwd, config, verbose);
+                    return [4 /*yield*/, generator.generate()];
+                case 4: return [2 /*return*/, _b.sent()];
+                case 5:
+                    generator = new WindsurfGenerator(cwd, config, verbose);
+                    return [4 /*yield*/, generator.generate()];
+                case 6: return [2 /*return*/, _b.sent()];
+                case 7:
+                    generator = new CoderGenerator(cwd, config, verbose);
+                    return [4 /*yield*/, generator.generate()];
+                case 8: return [2 /*return*/, _b.sent()];
+                case 9:
+                    generator = new AugmentGenerator(cwd, config, verbose);
+                    return [4 /*yield*/, generator.generate()];
+                case 10: return [2 /*return*/, _b.sent()];
+                case 11:
+                    {
+                        // 只生成基础配置，不生成工具特定文件
+                        if (verbose) {
+                            console.log('⏭️  跳过工具特定配置');
+                        }
+                        return [2 /*return*/, {
+                                success: true,
+                                files: [],
+                                message: 'No tool-specific configuration generated',
+                            }];
+                    }
+                case 12: return [2 /*return*/];
+            }
+        });
+    });
+}
+/**
+ * 获取工具的显示名称
+ */
+function getToolName(tool) {
+    var toolChoice = AI_TOOLS.find(function (t) { return t.value === tool; });
+    return toolChoice ? toolChoice.name : tool;
+}
+
 exports.ShadowSpace = ShadowSpace;
 exports.ShadowSpaceDebugger = ShadowSpaceDebugger;
 exports.TSXComplianceChecker = TSXComplianceChecker;
@@ -48022,6 +49952,7 @@ exports.generateFixSuggestions = generateFixSuggestions;
 exports.getPureValue = getPureValue;
 exports.initClaudeHooks = initClaudeHooks;
 exports.initSolution = initSolution;
+exports.initSpace = initSpace;
 exports.isFileCompliant = isFileCompliant;
 exports.releaseMaterial = releaseMaterial;
 exports.run = run;