flu-cli-core 1.0.2 → 1.0.3

package/README.md

@@ -1,64 +1,110 @@
-# @flu-cli/core (V6.0)
+# flu-cli-core
 
-核心逻辑库，遵循 **Task Pipeline (任务流水线)** 架构，为 flu-cli 和 VSCode 扩展提供标准化的 Flutter 代码生成与增强能力。
+核心逻辑库，支持 Flutter 项目全生命周期管理：代码生成、项目初始化、资源管理、构建、以及多平台应用商店上传。
 
-## 🏗 核心架构：Task Pipeline
+## 🎯 核心功能
 
-从 V6.0 开始，核心生成器由传统的命令式逻辑转变为 **原子化任务流水线** 架构。
+### 1. 项目生成与初始化 (Task Pipeline)
 
-### 1. 乐高式搭建 (The Lego Model)
+采用 **原子化任务流水线** 架构，支持 4 种模板：Lite、Modular、Clean、Native。
 
-`ProjectGenerator` 不再直接操作文件，而是作为一个 **Orchestrator (指挥官)**。它通过 `ProjectPipeline` 编排一系列 `IProjectTask`。
+`ProjectGenerator` 作为 **Orchestrator (指挥官)**，通过 `ProjectPipeline` 编排一系列 `IProjectTask`：
 
-```mermaid
-graph LR
-    A[ProjectGenerator] --> B(ProjectPipeline)
-    B --> T1[FlutterInitTask]
-    B --> T2[TemplateCopyTask]
-    B --> T3[VariablesReplaceTask]
-    B --> T4[NetworkEnrichTask]
-    B --> T5[RouteMappingTask]
-    B --> T6[HomePatchTask]
-    B --> T7[CleanupTask]
 ```
+ProjectGenerator
+  ├─ FlutterInitTask (确保环境就绪)
+  ├─ TemplateCopyTask (智能模板复制)
+  ├─ VariablesReplaceTask (变量替换)
+  ├─ NetworkEnrichTask (网络层注入)
+  ├─ RouteMappingTask (路由自动扫描)
+  ├─ HomePatchTask (首页示例注入)
+  └─ CleanupTask (清理冗余)
+```
+
+### 2. 多平台应用商店上传 ✨
+
+独立的 **@huoye/app-ship** 上传引擎，**8 个平台全部实测通过**：
+
+- ✅ 蒲公英 (Pgyer) — 内测分发
+- ✅ 华为 AppGallery — 国内商店
+- ✅ 小米应用商店 — RSA 签名认证
+- ✅ OPPO 应用商店 — HMAC-SHA256
+- ✅ vivo 应用商店 — 一站式直传
+- ✅ 腾讯应用宝 — COS 直传
+- ✅ App Store — Transporter/altool
+- ✅ 鸿蒙应用市场 — 华为 API 复用
+
+详见 [@huoye/app-ship 文档](https://gitee.com/flu-cli/flu-cli/blob/main/packages/app-ship/README.md)。
+
+### 3. 代码生成
+
+支持 7 种代码生成器：
+
+- **Page** — 页面生成
+- **ViewModel** — 状态管理类
+- **Widget** — 组件
+- **Component** — 复用组件
+- **Service** — 服务层
+- **Model** — 数据模型
+- **Module** — 功能模块
+
+### 4. 应用资源管理
+
+- **App Icon** — 一张图自动适配全平台（iOS、Android、Harmony）
+- **启动图** — Logo + 背景色，自动配置 `flutter_native_splash`
+
+### 5. 构建管理
+
+- **Android**: APK / AAB 自动构建
+- **iOS**: IPA 自动构建
+
+## 💡 架构优势
+
+- **极简核心** — `ProjectGenerator.ts` 从 1500 行精简至 100 行
+- **高可扩展** — 新增功能只需实现 `IProjectTask` 并加入流水线
+- **高度解耦** — 各 Task 职责单一，互不干扰
+- **声明式** — 清晰可见每一个项目生成步骤
 
-### 2. 骨架 + 增强 (Skeleton + Enrichment)
+## 📦 三种使用方式
 
-- **Skeleton (骨架)**: 从 Git 或本地加载的纯净 Flutter 代码模板。
-- **Enrichment (增强)**: CLI 通过任务流水线动态注入的功能层（如：`NetworkEnrichTask` 注入 Dio 封装，`StateManagerEnrichTask` 注入状态管理适配器）。
+| 方式       | 工具         | 用途              |
+| ---------- | ------------ | ----------------- |
+| **命令行** | flu-cli (v2) | CI/CD、自动化发版 |
+| **可视化** | VSCode 插件  | IDE 内点击操作    |
+| **编程**   | @huoye/app-ship npm | 自建发布系统      |
 
-## 💡 为什么这么牛？
+## 🔗 相关资源
 
-- **极简核心**: `ProjectGenerator.ts` 从 1500 行精简至 100 行，逻辑高度内聚于各个 Task。
-- **高可扩展性**: 想要支持一个新的功能（如 Sentry 监控、WeChat SDK）？只需编写一个新的 `EnrichTask` 并加入流水线。
-- **高度解耦**: 状态管理、路由注册、环境修复各司其职，互不干扰。
-- **声明式配置**: 开发者可以清晰地看到项目生成的每一个步骤。
+- [@huoye/app-ship 独立上传库](https://gitee.com/flu-cli/flu-cli/blob/main/packages/app-ship/README.md) — 多平台上传引擎
+- [VSCode 扩展](https://gitee.com/flu-cli/flu-cli/blob/main/packages/vscode-extension/README.md) — 可视化发布中心
+- [CLI v2](https://gitee.com/flu-cli/flu-cli/blob/main/packages/v2/README.md) — 命令行工具
+- [官方文档](http://huozhiye.cn/flu-cli/) — 完整指南
 
 ## 🚀 核心组件
 
-### 生成器 (Generators)
+### 生成器
 
-- **ProjectGenerator**: 采用 Pipeline 模式的项目实例化引擎。
-- **Page/ViewModel/Model Generator**: 针对不同架构模板的高级代码生成器。
-- **Service Generator**: 智能服务层生成器，支持自动网络层检测与 Mock 降级。
+- **ProjectGenerator** — Pipeline 模式的项目实例化引擎
+- **Page/ViewModel/Model Generator** — 针对不同架构的代码生成
+- **Service Generator** — 智能服务层生成，支持网络层检测
 
-### 任务体系 (Tasks)
+### 任务体系
 
-- `FlutterInitTask`: 确保原生 Flutter 环境就绪。
-- `TemplateCopyTask`: 智能处理模板复制与冗余清理。
-- `NetworkEnrichTask`: 声明式注入网络层基础设施。
-- `RouteMappingTask`: 自动扫描业务路径并注册路由表。
-- `HomePatchTask`: 自动化首页示例入口侵入。
+- `FlutterInitTask` — 确保原生 Flutter 环境就绪
+- `TemplateCopyTask` — 智能处理模板复制与冗余清理
+- `NetworkEnrichTask` — 声明式注入网络层基础设施
+- `RouteMappingTask` — 自动扫描业务路径并注册路由表
+- `HomePatchTask` — 自动化首页示例入口
 
 ## 🛠 开发与扩展
 
-### 如何添加一个新任务？
+### 添加新任务
 
-1. 在 `src/generators/tasks/` 创建实现 `IProjectTask` 的类。
-2. 在 `ProjectGenerator.generate` 中通过 `.addTask()` 链式调用。
+1. 在 `src/generators/tasks/` 创建实现 `IProjectTask` 的类
+2. 在 `ProjectGenerator.generate` 中通过 `.addTask()` 链式调用
 
 ```typescript
-pipeline.addTask(new YourAwesomeTask());
+pipeline.addTask(new YourAwesomeTask())
 ```
 
 ## 📜 许可证

package/dist/chunk-3RG5ZIWI.js

@@ -0,0 +1,10 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+export {
+  __require
+};

package/dist/{chunk-FOMWV2YP.js → chunk-ANN4MX7M.js}

@@ -18,10 +18,7 @@ var ProviderAdapter = class {
   }
   getImports(relativeCorePath) {
     if (this.name === "provider") {
-      return [
-        `import 'package:provider/provider.dart';`,
-        `import '${relativeCorePath}';`
-      ];
+      return [`import 'package:provider/provider.dart';`, `import '${relativeCorePath}';`];
     }
     return [`import '${relativeCorePath}';`];
   }
@@ -143,9 +140,7 @@ class BaseViewModel extends GetxController {
     return isListPage ? "BaseListViewModel" : "BaseViewModel";
   }
   getImports(relativeCorePath) {
-    return [
-      `import '${relativeCorePath}';`
-    ];
+    return [`import '${relativeCorePath}';`];
   }
   /**
    * 修改 app.dart
@@ -173,7 +168,10 @@ class BaseViewModel extends GetxController {
       raw = raw.replace(/navigatorKey:\s*NavigatorUtil\.navigatorKey\s*,?/g, "");
     }
     if (raw.includes("scaffoldMessengerKey: NavigatorUtil.scaffoldMessengerKey")) {
-      raw = raw.replace(/scaffoldMessengerKey:\s*NavigatorUtil\.scaffoldMessengerKey\s*,?\s*\n?/g, "");
+      raw = raw.replace(
+        /scaffoldMessengerKey:\s*NavigatorUtil\.scaffoldMessengerKey\s*,?\s*\n?/g,
+        ""
+      );
     }
     return raw;
   }
@@ -268,8 +266,13 @@ var RiverpodAdapter = class {
     const { projectPath } = context;
     const baseDir = join(projectPath, "lib", "core", "base");
     await fsx.ensureDir(baseDir);
-    await fsx.writeFile(join(baseDir, "view_state.dart"), "enum ViewState { idle, loading, success, error }\n");
-    await fsx.writeFile(join(baseDir, "base_state.dart"), `
+    await fsx.writeFile(
+      join(baseDir, "view_state.dart"),
+      "enum ViewState { idle, loading, success, error }\n"
+    );
+    await fsx.writeFile(
+      join(baseDir, "base_state.dart"),
+      `
 import 'view_state.dart';
 
 class BaseState {
@@ -296,8 +299,11 @@ class BaseState {
   bool get isError => state == ViewState.error;
   bool get isIdle => state == ViewState.idle;
 }
-`);
-    await fsx.writeFile(join(baseDir, "base_notifier.dart"), `
+`
+    );
+    await fsx.writeFile(
+      join(baseDir, "base_notifier.dart"),
+      `
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import 'view_state.dart';
 import 'base_state.dart';
@@ -322,8 +328,11 @@ abstract class BaseNotifier<T extends BaseState> extends Notifier<T> {
     }
   }
 }
-`);
-    await fsx.writeFile(join(baseDir, "base_page_riverpod.dart"), `
+`
+    );
+    await fsx.writeFile(
+      join(baseDir, "base_page_riverpod.dart"),
+      `
 import 'package:flutter/material.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import 'base_state.dart';
@@ -353,7 +362,8 @@ class BasePageRiverpod<TState extends BaseState, TNotifier extends Notifier<TSta
     );
   }
 }
-`);
+`
+    );
   }
 };
 

package/dist/{factory-6DDXZYQP.js → factory-W73G7NBW.js}

@@ -1,6 +1,7 @@
 import {
   StateManagerAdapterFactory
-} from "./chunk-FOMWV2YP.js";
+} from "./chunk-ANN4MX7M.js";
+import "./chunk-3RG5ZIWI.js";
 export {
   StateManagerAdapterFactory
 };