flu-cli-core 1.0.0 → 1.0.1

package/README.md

@@ -7,6 +7,7 @@
 从 V6.0 开始，核心生成器由传统的命令式逻辑转变为 **原子化任务流水线** 架构。
 
 ### 1. 乐高式搭建 (The Lego Model)
+
 `ProjectGenerator` 不再直接操作文件，而是作为一个 **Orchestrator (指挥官)**。它通过 `ProjectPipeline` 编排一系列 `IProjectTask`。
 
 ```mermaid
@@ -22,6 +23,7 @@ graph LR
 ```
 
 ### 2. 骨架 + 增强 (Skeleton + Enrichment)
+
 - **Skeleton (骨架)**: 从 Git 或本地加载的纯净 Flutter 代码模板。
 - **Enrichment (增强)**: CLI 通过任务流水线动态注入的功能层（如：`NetworkEnrichTask` 注入 Dio 封装，`StateManagerEnrichTask` 注入状态管理适配器）。
 
@@ -35,10 +37,13 @@ graph LR
 ## 🚀 核心组件
 
 ### 生成器 (Generators)
+
 - **ProjectGenerator**: 采用 Pipeline 模式的项目实例化引擎。
 - **Page/ViewModel/Model Generator**: 针对不同架构模板的高级代码生成器。
+- **Service Generator**: 智能服务层生成器，支持自动网络层检测与 Mock 降级。
 
 ### 任务体系 (Tasks)
+
 - `FlutterInitTask`: 确保原生 Flutter 环境就绪。
 - `TemplateCopyTask`: 智能处理模板复制与冗余清理。
 - `NetworkEnrichTask`: 声明式注入网络层基础设施。
@@ -48,6 +53,7 @@ graph LR
 ## 🛠 开发与扩展
 
 ### 如何添加一个新任务？
+
 1. 在 `src/generators/tasks/` 创建实现 `IProjectTask` 的类。
 2. 在 `ProjectGenerator.generate` 中通过 `.addTask()` 链式调用。
 

package/dist/index.cjs

@@ -1545,6 +1545,8 @@ function getTemplatesRootDir() {
         searchDirs.push((0, import_path6.join)(temp, "packages", "core", "templates"));
         searchDirs.push((0, import_path6.join)(temp, "templates"));
         searchDirs.push((0, import_path6.join)(temp, "..", "templates"));
+        searchDirs.push((0, import_path6.join)(temp, "dist", "templates"));
+        searchDirs.push((0, import_path6.join)(temp, "..", "dist", "templates"));
         temp = (0, import_path6.dirname)(temp);
         if (temp === (0, import_path6.dirname)(temp)) break;
       }
@@ -2015,19 +2017,16 @@ class ${namePascal} extends StatelessWidget {
 }
 function getSimpleModel(namePascal) {
   return `class ${namePascal} {
-  // TODO: Add properties
 
   ${namePascal}();
 
   factory ${namePascal}.fromJson(Map<String, dynamic> json) {
     return ${namePascal}(
-      // TODO: Map json to properties
     );
   }
 
   Map<String, dynamic> toJson() {
     return {
-      // TODO: Map properties to json
     };
   }
 }
@@ -2830,7 +2829,8 @@ async function generateService(name, options = {}, customLogger) {
     }
     const templateType = selectTemplate(outputDir, serviceConfig);
     let content = null;
-    const snippetKey = serviceConfig?.snippetKey || "flu.service";
+    const defaultSnippetKey = templateType === "network" ? "flu.service.network" : "flu.service";
+    const snippetKey = serviceConfig?.snippetKey || defaultSnippetKey;
     content = getSnippetContent(outputDir, snippetKey, {
       Name: namePascal,
       snake_name: nameSnake,
@@ -2892,6 +2892,7 @@ class ${namePascal}Service {
     int page = 1,
     int pageSize = 10,
   }) async {
+    // \u964D\u7EA7\u4E0E Mock \u5904\u7406
     if (AppConfig.I.useMockData) {
       return _loadMockData(page, pageSize);
     }
@@ -2901,28 +2902,26 @@ class ${namePascal}Service {
       queryParameters: {'page': page, 'pageSize': pageSize},
     );
 
-    // \u964D\u7EA7\u5904\u7406\uFF1A\u8BF7\u6C42\u5931\u8D25\u65F6\u8FD4\u56DE Mock \u6570\u636E
+    // \u6210\u529F\u5904\u7406
     if (response.isSuccess && response.data is List) {
       return response.data as List;
     }
 
+    // \u5931\u8D25\u56DE\u9000
     return _loadMockData(page, pageSize);
   }
 
   /// \u6839\u636E ID \u83B7\u53D6\u8BE6\u60C5
   Future<dynamic> fetchById(String id) async {
     if (AppConfig.I.useMockData) {
-      return null; // \u8FD4\u56DE Mock \u6570\u636E
+      return null;
     }
 
     final response = await _http.get('/${nameSnake}/$id');
     return response.isSuccess ? response.data : null;
   }
 
-  /// Mock \u6570\u636E\u52A0\u8F7D
   List<dynamic> _loadMockData(int page, int pageSize) {
-    // \u6A21\u62DF\u6570\u636E\u52A0\u8F7D\u903B\u8F91
-    // \u793A\u4F8B: \u8FD4\u56DE\u6D4B\u8BD5\u6570\u636E\u6216\u4ECE\u672C\u5730\u5B58\u50A8\u8BFB\u53D6
     return [];
   }
 }

package/dist/index.js

@@ -931,6 +931,8 @@ function getTemplatesRootDir() {
         searchDirs.push(join6(temp, "packages", "core", "templates"));
         searchDirs.push(join6(temp, "templates"));
         searchDirs.push(join6(temp, "..", "templates"));
+        searchDirs.push(join6(temp, "dist", "templates"));
+        searchDirs.push(join6(temp, "..", "dist", "templates"));
         temp = dirname(temp);
         if (temp === dirname(temp)) break;
       }
@@ -1399,19 +1401,16 @@ class ${namePascal} extends StatelessWidget {
 }
 function getSimpleModel(namePascal) {
   return `class ${namePascal} {
-  // TODO: Add properties
 
   ${namePascal}();
 
   factory ${namePascal}.fromJson(Map<String, dynamic> json) {
     return ${namePascal}(
-      // TODO: Map json to properties
     );
   }
 
   Map<String, dynamic> toJson() {
     return {
-      // TODO: Map properties to json
     };
   }
 }
@@ -2210,7 +2209,8 @@ async function generateService(name, options = {}, customLogger) {
     }
     const templateType = selectTemplate(outputDir, serviceConfig);
     let content = null;
-    const snippetKey = serviceConfig?.snippetKey || "flu.service";
+    const defaultSnippetKey = templateType === "network" ? "flu.service.network" : "flu.service";
+    const snippetKey = serviceConfig?.snippetKey || defaultSnippetKey;
     content = getSnippetContent(outputDir, snippetKey, {
       Name: namePascal,
       snake_name: nameSnake,
@@ -2272,6 +2272,7 @@ class ${namePascal}Service {
     int page = 1,
     int pageSize = 10,
   }) async {
+    // \u964D\u7EA7\u4E0E Mock \u5904\u7406
     if (AppConfig.I.useMockData) {
       return _loadMockData(page, pageSize);
     }
@@ -2281,28 +2282,26 @@ class ${namePascal}Service {
       queryParameters: {'page': page, 'pageSize': pageSize},
     );
 
-    // \u964D\u7EA7\u5904\u7406\uFF1A\u8BF7\u6C42\u5931\u8D25\u65F6\u8FD4\u56DE Mock \u6570\u636E
+    // \u6210\u529F\u5904\u7406
     if (response.isSuccess && response.data is List) {
       return response.data as List;
     }
 
+    // \u5931\u8D25\u56DE\u9000
     return _loadMockData(page, pageSize);
   }
 
   /// \u6839\u636E ID \u83B7\u53D6\u8BE6\u60C5
   Future<dynamic> fetchById(String id) async {
     if (AppConfig.I.useMockData) {
-      return null; // \u8FD4\u56DE Mock \u6570\u636E
+      return null;
     }
 
     final response = await _http.get('/${nameSnake}/$id');
     return response.isSuccess ? response.data : null;
   }
 
-  /// Mock \u6570\u636E\u52A0\u8F7D
   List<dynamic> _loadMockData(int page, int pageSize) {
-    // \u6A21\u62DF\u6570\u636E\u52A0\u8F7D\u903B\u8F91
-    // \u793A\u4F8B: \u8FD4\u56DE\u6D4B\u8BD5\u6570\u636E\u6216\u4ECE\u672C\u5730\u5B58\u50A8\u8BFB\u53D6
     return [];
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "flu-cli-core",
-    "version": "1.0.0",
+    "version": "1.0.1",
     "description": "Core logic for flu-cli",
     "main": "dist/index.cjs",
     "module": "dist/index.js",
@@ -49,4 +49,4 @@
         "tsup": "^8.0.1",
         "typescript": "^5.3.3"
     }
-}
+}

package/templates/snippets/flu-cli.code-snippets

@@ -245,6 +245,58 @@
       ""
     ]
   },
+  "flu.service.network": {
+    "prefix": "serviceNetwork",
+    "description": "Service (Network Enabled)",
+    "body": [
+      "import '${relative_core_path}';",
+      "",
+      "class ${1:Name}Service {",
+      "  final AppHttp _http;",
+      "",
+      "  ${1:Name}Service({AppHttp? http}) : _http = http ?? AppHttp();",
+      "",
+      "  /// 获取列表数据",
+      "  Future<List<dynamic>> fetchList({",
+      "    int page = 1,",
+      "    int pageSize = 10,",
+      "  }) async {",
+      "    // 降级与 Mock 处理",
+      "    if (AppConfig.I.useMockData) {",
+      "      return _loadMockData(page, pageSize);",
+      "    }",
+      "",
+      "    final response = await _http.get(",
+      "      '/${snake_name}/list',",
+      "      queryParameters: {'page': page, 'pageSize': pageSize},",
+      "    );",
+      "",
+      "    // 成功处理",
+      "    if (response.isSuccess && response.data is List) {",
+      "      return response.data as List;",
+      "    }",
+      "",
+      "    // 失败回退",
+      "    return _loadMockData(page, pageSize);",
+      "  }",
+      "",
+      "  /// 根据 ID 获取详情",
+      "  Future<dynamic> fetchById(String id) async {",
+      "    if (AppConfig.I.useMockData) {",
+      "      return null;",
+      "    }",
+      "",
+      "    final response = await _http.get('/${snake_name}/$id');",
+      "    return response.isSuccess ? response.data : null;",
+      "  }",
+      "",
+      "  List<dynamic> _loadMockData(int page, int pageSize) {",
+      "    return [];",
+      "  }",
+      "}",
+      ""
+    ]
+  },
   "flu.component": {
     "prefix": "component",
     "description": "通用组件",