flu-cli-core

核心逻辑库，支持 Flutter 项目全生命周期管理：代码生成、项目初始化、资源管理、构建、以及多平台应用商店上传。

🎯 核心功能

1. 项目生成与初始化 (Task Pipeline)

采用 原子化任务流水线 架构，支持 4 种模板：Lite、Modular、Clean、Native。

ProjectGenerator 作为 Orchestrator (指挥官)，通过 ProjectPipeline 编排一系列 IProjectTask：

ProjectGenerator
  ├─ FlutterInitTask (确保环境就绪)
  ├─ TemplateCopyTask (智能模板复制)
  ├─ VariablesReplaceTask (变量替换)
  ├─ NetworkEnrichTask (网络层注入)
  ├─ RouteMappingTask (路由自动扫描)
  ├─ HomePatchTask (首页示例注入)
  └─ CleanupTask (清理冗余)

2. 多平台应用商店上传 ✨

本模块提供了高效的应用包信息解析与处理能力。

主要功能

• 包体解析：解析 Android (APK/AAB)、iOS (IPA) 和鸿蒙 (HAP) 的包名、版本、图标等信息。
• 权限分析：自动扫描安装包中的敏感权限声明。
• 构建适配：支持针对不同平台的构建参数优化。

更多详情请查阅 官方文档。

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 自动构建

6. AI + SKILL（规则投影）

通过 .flu-cli.json（单一事实来源）投影生成多份 AI 可读规则文件，保证 AI/CLI/VSCode 产出一致：

• .cursor/rules/flu-project.mdc
• CLAUDE.md
• AI_RULES.md
• .agent/skills/<slug>/SKILL.md

💡 架构优势

• 极简核心 — ProjectGenerator.ts 从 1500 行精简至 100 行
• 高可扩展 — 新增功能只需实现 IProjectTask 并加入流水线
• 高度解耦 — 各 Task 职责单一，互不干扰
• 声明式 — 清晰可见每一个项目生成步骤

📦 三种使用方式

| 方式 | 工具 | 用途 | | ---------- | ------------ | ----------------- | | 命令行 | flu-cli (v2) | CI/CD、自动化发版 | | 可视化 | VSCode 插件 | IDE 内点击操作 |

🔗 相关资源

• 分发模块引用 — 核心工具链集成
• VSCode 扩展 — 可视化发布中心
• CLI v2 — 命令行工具
• 官方文档 — 完整指南

🚀 核心组件

生成器

• ProjectGenerator — Pipeline 模式的项目实例化引擎
• Page/ViewModel/Model Generator — 针对不同架构的代码生成
• Service Generator — 智能服务层生成，支持网络层检测

任务体系

• FlutterInitTask — 确保原生 Flutter 环境就绪
• TemplateCopyTask — 智能处理模板复制与冗余清理
• NetworkEnrichTask — 声明式注入网络层基础设施
• RouteMappingTask — 自动扫描业务路径并注册路由表
• HomePatchTask — 自动化首页示例入口

🛠 开发与扩展

添加新任务

1. 在 src/generators/tasks/ 创建实现 IProjectTask 的类
2. 在 ProjectGenerator.generate 中通过 .addTask() 链式调用

pipeline.addTask(new YourAwesomeTask())

📜 许可证

MIT - Copyright © 2025 火叶工作室