flu-cli 2.0.3 → 2.0.5

package/CHANGELOG.md

@@ -2,13 +2,35 @@
 
 本项目的所有主要更改都将记录在此文件中。
 
-## [2.0.3] - 2025-12-12
+## [2.0.4] - 2026-01-13
 
-### 更新内容
-- 新add 支持本地仓库
+### 新增特性
+
+- **网络层全架构适配**：统一的网络示例支持 Lite、Modular、Clean 三种架构模板
+- **智能网络层选择**：项目创建时可选择是否包含网络层，自动处理依赖注入和文件清理
+- **动态代码片段系统**：基于 VSCode Snippets 的智能代码生成，支持 8+ 种模板类型
+  - `flu.stPage` - Stateful 页面（使用 BasePage）
+  - `flu.lessPage` - Stateless 简单页面
+  - `flu.listPage` / `flu.listViewModel` - 列表页面和 ViewModel
+  - `flu.viewmodel` - 通用 ViewModel（使用 BaseViewModel）
+  - `flu.model` - 数据模型（含 JSON 序列化）
+  - `flu.service` - 服务层
+  - `flu.component` - 通用组件
+
+### 优化
+
+- **文件生成增强**：多入口支持（右键菜单、编辑器内、命令面板、快捷键），智能路径检测
+- **代码片段智能占位符**：支持 `${relative_core_path}` 等动态变量，根据项目架构自动替换导入路径
+- **网络示例统一维护**：通过占位符动态适配三种架构，避免代码重复
+- **Clean 架构导入优化**：示例代码使用统一的 `data/index.dart` 导出，符合分层原则
 
+### 修复
 
-## [未发布]
+- **修复 Default 状态管理器错误导入**：修复 Default 模式错误导入 provider 包的问题
+- **修复 Modular/Lite 架构导入**：修复网络示例缺少 services 导入的问题
 
-### 待更新
-- 下次发布时自动生成
+## [2.0.3] - 2025-12-12
+
+### 更新内容
+
+- 新add 支持本地仓库

package/CLI.md

@@ -41,6 +41,7 @@ flu-cli n [项目名称]  # 简写
 -   `-s, --state <type>` - 状态管理器: `default`, `provider`, `getx`, `riverpod`
 -   `-d, --dir <path>` - 项目存放目录（默认：当前目录）
 -   `--no-cache` - 不使用缓存，强制从 Git 拉取
+-   `--no-network` - 不包含网络层（默认包含）
 -   `--remote` - 使用远程 Gitee 模板（默认使用本地模板）
 
 **说明:**

package/README.md

@@ -1,19 +1,49 @@
-# flu-cli v2.0
+# flu-cli
 
-> 🚀 **活跃开发中** - Flutter MVVM 脚手架工具
+<p align="center">
+  <img src="https://gitee.com/flu-cli/flu-cli/raw/main/packages/vscode-extension/images/icon.png" width="120" alt="flu-cli logo">
+</p>
 
-> 💡 **推荐**: 使用 VSCode 开发？试试我们的 [VSCode 插件](https://marketplace.visualstudio.com/items?itemName=huoye-studio.flu-cli-vscode)，支持右键生成代码，体验更丝滑！
+<p align="center">
+  <strong>为 Flutter 开发者打造的现代化 MVVM 脚手架工具</strong>
+</p>
 
-## ✨ 特性
+<p align="center">
+  <a href="https://www.npmjs.com/package/flu-cli">
+    <img src="https://img.shields.io/npm/v/flu-cli.svg" alt="npm version">
+  </a>
+  <a href="https://www.npmjs.com/package/flu-cli">
+    <img src="https://img.shields.io/npm/dt/flu-cli.svg" alt="npm downloads">
+  </a>
+  <a href="https://gitee.com/flu-cli/flu-cli/blob/main/LICENSE">
+    <img src="https://img.shields.io/npm/l/flu-cli.svg" alt="license">
+  </a>
+</p>
 
--   🎯 **交互式创建** - `flu new` 命令提供友好的交互式体验
--   🔧 **代码生成** - `flu add` 快速生成页面、组件、服务等（支持别名）
--   📦 **多种模板** - lite、modular、clean 三种架构模板
--   🎮 **状态管理** - 支持 default、provider、getx、riverpod
--   📝 **基于 Snippets** - 可自定义 VSCode 代码片段
--   🎨 **列表页支持** - `--list-page` 自动生成 Page/ViewModel/Model
--   🚀 **智能补全** - Shell 自动补全（Zsh/Bash）
--   🌏 **中文友好** - 全中文提示和文档
+<p align="center">
+  <a href="https://marketplace.visualstudio.com/items?itemName=huoye-studio.flu-cli-vscode">VSCode 插件</a> | 
+  <a href="http://huozhiye.cn/flu-cli/">官方文档</a> | 
+  <a href="#-加入社区">加入社区</a>
+</p>
+
+---
+
+## 🌟 为什么选择 Flu CLI
+
+Flu CLI 让 Flutter 项目创建和代码生成变得简单高效，从零到生产只需几分钟。
+
+### 核心亮点
+
+- **🎯 交互式向导**：现代化 CLI 交互体验，所有选择一目了然
+- **🏗 多架构模板**：Lite（轻量）、Modular（模块化）、Clean（整洁架构），开箱即用
+- **🌐 智能网络层**：可选集成 Dio + 网络工具 + 真实示例，按需引入
+- **🧩 多状态管理**：Provider、GetX 一键切换，自动配置
+- **⚡️ 快速生成**：Page、ViewModel、Widget、Service、Model 全覆盖
+- **🎨 资源管理**：可视化配置应用图标与启动图
+- **📝 代码片段**：内置 8+ 种智能模板，自动同步到 VSCode
+- **🔧 灵活定制**：支持 Git 仓库或本地文件夹作为自定义模板
+
+---
 
 ## 📦 安装
 
@@ -21,93 +51,135 @@
 npm install -g flu-cli
 ```
 
+> 要求：Node.js >= 14.0.0 + Flutter SDK
+
+---
+
 ## 🚀 快速开始
 
+### 1️⃣ 创建项目
+
 ```bash
-# 创建新项目
-flu-cli new my_app
-# 或使用别名
-flu n my_app
+flu new my_app
+```
+
+**向导会引导你选择**：
+
+- 架构模板（Lite / Modular / Clean / 自定义）
+- 状态管理（Provider / GetX）
+- 是否包含网络层（Dio + 示例代码）
 
-# 指定模板和状态管理
-flu n my_app -t modular -s getx
+### 2️⃣ 生成代码
 
-# 添加页面（自动生成 ViewModel）
-cd my_app
+```bash
+# 生成页面（包含 View + ViewModel）
 flu add page home
-# 或使用别名
-flu a p home
 
-# 添加列表页（自动生成 Page + ViewModel + Model）
-flu a p user_list --list-page
+# 生成列表页面（自动包含分页逻辑）
+flu add page user_list --list-page
 
-# 添加服务
-flu a s api --type api
+# 生成其他类型
+flu add widget button_widget
+flu add service user_service
+flu add model user
+```
 
-# 同步代码片段
-flu sync-snippets
+### 3️⃣ 配置现有项目
 
-# 生成自动补全脚本
-flu-cli completion >> ~/.zshrc && source ~/.zshrc
+```bash
+cd my_existing_project
+flu config init
 ```
 
-## 📚 命令别名
+自动检测项目结构，生成 `.flu-cli.json` 配置文件。
 
-### add 类型别名
+### 4️⃣ 自定义模板
 
--   `p` = page
--   `w` = widget
--   `c` = component
--   `v` = viewmodel
--   `s` = service
--   `m` = model
--   `mod` = module
+```bash
+# 添加 Git 仓库模板
+flu template add my-tpl https://github.com/my/template.git
 
-### 顶级命令别名
+# 添加本地模板
+flu template add local-tpl /path/to/template --local
 
--   `n` = new
--   `a` = add
--   `t` = templates
--   `u` = update-templates
--   `c` = cache
--   `sync` = sync-snippets
--   `comp` = completion
+# 使用自定义模板创建项目
+flu new my_app -t my-tpl
+```
 
-## ❓ 获取帮助
+---
 
-查看所有命令：
+## 📚 命令速查
+
+| 命令                          | 别名   | 说明           |
+| ----------------------------- | ------ | -------------- |
+| `flu new <name>`              | `n`    | 创建新项目     |
+| `flu add page <name>`         | `a p`  | 生成页面       |
+| `flu add widget <name>`       | `a w`  | 生成组件       |
+| `flu add service <name>`      | `a s`  | 生成服务       |
+| `flu add model <name>`        | `a m`  | 生成模型       |
+| `flu template add <id> <url>` | -      | 添加自定义模板 |
+| `flu template list`           | -      | 查看模板列表   |
+| `flu config init`             | `conf` | 初始化项目配置 |
+| `flu assets`                  | -      | 配置应用资源   |
+| `flu sync-snippets`           | `sync` | 同步代码片段   |
+
+> 使用 `flu <command> --help` 查看详细参数
+
+---
+
+## 🧩 推荐：VSCode 插件
+
+配合 **Flu CLI VSCode Extension** 使用，体验翻倍！
+
+**插件特性**：
+
+- ✨ 右键菜单快速生成代码
+- 🎨 可视化管理项目资源
+- ⌨️ 快捷键 `Cmd+Shift+G` (Mac) / `Ctrl+Shift+G` (Windows) 唤起生成面板
+- 📝 智能代码片段，根据架构动态适配
+
+👉 [点击安装 VSCode 插件](https://marketplace.visualstudio.com/items?itemName=huoye-studio.flu-cli-vscode)
+
+---
+
+## 💡 使用技巧
+
+### 快速创建带网络层的项目
 
 ```bash
-flu-cli --help
+flu new my_app
+# 选择 Lite 模板 → Provider → 包含网络层
+# 一分钟后，完整的 MVVM 项目就绪！
 ```
 
-查看特定命令的详细用法：
+### 同步最新代码片段
 
 ```bash
-flu add --help
-flu new --help
+flu sync-snippets
 ```
 
-## 📚 文档
+自动升级项目中的 VSCode 代码片段到最新版本（8+ 种智能模板）。
 
--   [CLI 命令参考](http://huozhiye.cn/flu-cli/reference/cli-reference.html) - 详细命令说明
--   [完整文档](http://huozhiye.cn/flu-cli/) - 主文档站
+### 查看所有模板
 
-## 💬 加入社区
+```bash
+flu template list
+```
 
-获取最新动态、反馈问题、定制化开发或与开发者直接交流，欢迎加入我们的微信群：
+---
+
+## 💬 加入社区
 
-> ![微信群二维码](https://gitee.com/flu-cli/flu-cli/raw/main/packages/vscode-extension/images/wechat-group.png)
+获取最新动态、反馈问题或与开发者交流：
 
-如果群二维码过期，请添加作者微信 `Huoye-TT` 备注 "flu-cli" 拉您入群。
+<p align="left">
+  <img src="https://gitee.com/flu-cli/flu-cli/raw/main/packages/vscode-extension/images/wechat-group.png" alt="微信二维码" width="200"/>
+</p>
 
-## 🔗 相关链接
+> 二维码过期请添加作者微信 `Huoye-TT`，备注 "flu-cli"
 
--   [模板对比](http://huozhiye.cn/flu-cli/guide/templates/template-comparison.html)
--   [最佳实践](http://huozhiye.cn/flu-cli/best-practices/custom-templates.html)
--   [从 V1 迁移](http://huozhiye.cn/flu-cli/examples/migration.html)
+---
 
- 
-## 📄 许可
+## 📄 License
 
-MIT License - Copyright © 2025 火叶工作室
+MIT License - Copyright © 2026 火叶工作室

package/config/templates.js

@@ -1,135 +1,13 @@
-/**
- * 模板配置文件
- * 定义所有可用的项目模板
- */
-
-export const TEMPLATES = {
-  lite: {
-    name: 'Lite',
-    displayName: 'Lite - 精简版',
-    description: '最小依赖，单文件结构，适合小型项目和快速原型',
-    local: true,
-    repo: 'https://gitee.com/flu-cli/template-lite.git',
-    branch: 'main',
-    complexity: 1,
-    teamSize: '1 人',
-    codeSize: '< 5k 行',
-    features: [
-      '✅ 最小依赖',
-      '✅ 单文件结构',
-      '✅ Material 3 设计',
-      '✅ 快速启动'
-    ],
-    structure: `
-lib/
-├── 📄 main.dart           # 应用入口
-├── 📄 app.dart            # 应用配置
-├── 📁 pages/              # 页面
-├── 📁 viewmodels/         # 视图模型
-├── 📁 widgets/            # 简单组件
-├── 📁 components/         # 复合组件
-├── 📁 services/           # 业务服务
-├── 📁 models/             # 数据模型
-├── 📁 config/             # 配置
-└── 📁 utils/              # 工具类
-    `
-  },
-
-  modular: {
-    name: 'Modular',
-    displayName: 'Modular - 模块化版',
-    description: '模块化结构，功能分组，适合中型项目',
-    local: true,
-    repo: 'https://gitee.com/flu-cli/template-modular.git',
-    branch: 'main',
-    complexity: 3,
-    teamSize: '2-5 人',
-    codeSize: '5k-20k 行',
-    features: [
-      '✅ 模块化结构',
-      '✅ 路由配置独立',
-      '✅ 主题配置独立',
-      '✅ 功能分组'
-    ],
-    structure: `
-lib/
-├── 📄 main.dart
-├── 📁 core/              # 核心基础设施
-│   ├── theme/            # 主题系统
-│   ├── router/           # 路由系统
-│   ├── constants/        # 常量定义
-│   └── base/             # 基础类（BaseViewModel, BasePage）
-├── 📁 shared/            # 跨模块共享
-│   ├── widgets/          # 通用简单组件
-│   ├── components/       # 通用复合组件
-│   ├── models/           # 通用数据模型
-│   └── utils/            # 通用工具类
-└── 📁 features/          # 业务功能模块
-    ├── hoem/             # 用户模块
-    │   ├── pages/
-    │   ├── viewmodels/
-    │   ├── widgets/
-    │   ├── services/
-    └── └── models/
-    `
-  },
+import { BUILTIN_TEMPLATES } from 'flu-cli-core';
 
-  clean: {
-    name: 'Clean',
-    displayName: 'Clean - 分层版',
-    description: '严格分层架构，清晰的目录结构，适合大型项目',
-    local: true,
-    repo: 'https://gitee.com/flu-cli/template-clean.git',
-    branch: 'main',
-    complexity: 5,
-    teamSize: '5+ 人',
-    codeSize: '> 20k 行',
-    features: [
-      '✅ 严格分层架构',
-      '✅ 清晰的目录结构',
-      '✅ 易于扩展和维护',
-      '✅ 适合团队协作'
-    ],
-    structure: `
-lib/
-├── 📄 main.dart                    # 应用入口
-├── 📄 app.dart                     # 应用配置
-├── 📁 core/                        # 核心层(最内层)
-│   ├── constants/                  # 常量定义
-│   ├── errors/                     # 错误和异常
-│   ├── usecases/                   # UseCase 基类
-│   ├── utils/                      # 工具类
-│   └── network/                    # 网络配置
-├── 📁 features/                    # 功能模块(按业务划分)
-│   └── home/                       # 示例:首页模块
-│       ├── data/                   # 数据层
-│       │   ├── datasources/        # 数据源(API/本地)
-│       │   ├── models/             # 数据模型(DTO)
-│       │   └── repositories/       # Repository 实现
-│       ├── domain/                 # 领域层
-│       │   ├── entities/           # 业务实体
-│       │   ├── repositories/       # Repository 接口
-│       │   └── usecases/           # 用例(业务逻辑)
-│       └── presentation/           # 表现层
-│           ├── pages/              # 页面
-│           ├── widgets/            # 模块专用组件
-│           └── viewmodels/         # 视图模型
-├── 📁 shared/                      # 共享资源
-│   ├── widgets/                    # 通用组件
-│   ├── components/                 # 通用复合组件
-│   └── extensions/                 # 扩展方法
-└── 📁 config/                      # 配置层
-    ├── routes/                     # 路由配置
-    └── theme/                      # 主题配置
-    `
-  }
-};
+export const TEMPLATES = BUILTIN_TEMPLATES;
 
 /**
  * 获取模板配置
  */
 export function getTemplate (name) {
-  return TEMPLATES[name];
+  if (!name) return undefined;
+  return TEMPLATES[name.toLowerCase()];
 }
 
 /**
@@ -143,5 +21,6 @@ export function getAllTemplates () {
  * 验证模板名称
  */
 export function isValidTemplate (name) {
-  return name in TEMPLATES;
+  if (!name) return false;
+  return name.toLowerCase() in TEMPLATES;
 }