flu-cli-core 1.0.4 → 1.1.0

package/dist/upgrade_snippets-BJ6CQY5Q.js

@@ -0,0 +1,9 @@
+import {
+  checkSnippetsVersion,
+  upgradeSnippets
+} from "./chunk-SW6YDKXI.js";
+import "./chunk-QGM4M3NI.js";
+export {
+  checkSnippetsVersion,
+  upgradeSnippets
+};

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "flu-cli-core",
-  "version": "1.0.4",
+  "version": "1.1.0",
   "description": "Core logic for flu-cli",
   "main": "dist/index.cjs",
-  "module": "dist/index.js",
+  "module": "dist/index.cjs",
   "types": "dist/index.d.ts",
   "type": "module",
   "files": [
@@ -15,7 +15,7 @@
     ".": {
       "import": {
         "types": "./dist/index.d.ts",
-        "default": "./dist/index.js"
+        "default": "./dist/index.cjs"
       },
       "require": {
         "types": "./dist/index.d.cts",
@@ -35,8 +35,13 @@
   ],
   "author": "火叶工作室",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://gitee.com/flu-cli/flu-cli.git",
+    "directory": "packages/core"
+  },
   "dependencies": {
-    "@huoye/app-ship": "^0.1.1",
+    "@huoye/app-ship": "^0.1.2",
     "axios": "^1.13.2",
     "chalk": "^4.1.2",
     "form-data": "^4.0.5",

package/templates/README.md

@@ -18,6 +18,15 @@ packages/core/templates/
 │   ├── widgets/          # 各种 Widget 变体
 │   └── ...
 │
+├── helpers/              # 🔹 可选 helper 模板
+│   ├── payment/          # 支付 helper 占位
+│   ├── webview/          # WebView helper 占位
+│   ├── permission/       # 权限 helper 占位
+│   └── image_picker/     # 图片选择 helper 占位
+├── template_lite/        # 🔹 Lite 模板源
+├── template_modular/     # 🔹 Modular 模板源
+├── template_clean/       # 🔹 Clean 模板源
+│
 └── README.md             # 本文档
 ```
 
@@ -99,6 +108,7 @@ Flu-CLI 采用 **"双层架构"** 设计，确保所有架构风格的项目都
 ### 1. Skeleton (骨架)
 
 即外层提供的 `template_lite`, `template_modular` 等项目基础包。它们只包含最基础的、编译通过的 Flutter 代码。
+当前三套模板源只保留最新结构文件，不再依赖旧版 `STRUCTURE.md` 作为项目说明。
 
 ### 2. Enrichment (增强) - 位于 `core_files/`
 
@@ -106,6 +116,8 @@ Flu-CLI 采用 **"双层架构"** 设计，确保所有架构风格的项目都
 
 - **Base 层**：所有模板（Lite/Modular/Clean）使用完全相同的 `BasePage` 和 `BaseViewModel`。
 - **Network 层**：由 CLI 任务驱动，自动处理依赖注入、代码复制与示例代码生成。
+- **Auth 层**：由 CLI 任务驱动，生成最小认证态工具和网络鉴权扩展。
+- **Helper 层**：由 CLI 任务驱动，把 payment / webview / permission / image_picker 这类非 Core 能力投影到 `lib/helpers/`。helper 依赖由统一策略处理，普通 Flutter 与 Harmony/ohos profile 必须可区分。
 - **Router 层**：包含动态路由扫描所需的基础骨架（如自动注入业务路由的 TODO 标记）。
 
 ## 📝 开发者指南

package/templates/core_files/auth/auth_middleware.dart.template

@@ -0,0 +1,33 @@
+import 'package:flutter/widgets.dart';
+
+import 'auth_service.dart';
+
+/// 提供最小认证守卫入口，供路由或页面进入前复用。
+class AuthMiddleware {
+  AuthMiddleware({
+    AuthService? authService,
+  }) : _authService = authService ?? const AuthService();
+
+  final AuthService _authService;
+
+  bool canActivate() {
+    return _authService.isLoggedIn;
+  }
+
+  String? redirectRoute({
+    required String loginRoute,
+  }) {
+    return canActivate() ? null : loginRoute;
+  }
+
+  Future<void> ensureLoggedIn({
+    required VoidCallback onAuthorized,
+    required VoidCallback onUnauthorized,
+  }) async {
+    if (canActivate()) {
+      onAuthorized();
+    } else {
+      onUnauthorized();
+    }
+  }
+}

package/templates/core_files/auth/auth_service.dart.template

@@ -0,0 +1,22 @@
+import '../storage/storage_util.dart';
+
+/// 统一封装认证态读写，避免业务层直接散落操作 token。
+class AuthService {
+  const AuthService();
+
+  static const String _tokenKey = 'auth_token';
+
+  Future<void> saveToken(String token) async {
+    await StorageUtil.setString(_tokenKey, token);
+  }
+
+  String getToken() {
+    return StorageUtil.getString(_tokenKey) ?? '';
+  }
+
+  bool get isLoggedIn => getToken().isNotEmpty;
+
+  Future<void> clear() async {
+    await StorageUtil.remove(_tokenKey);
+  }
+}

package/templates/core_files/auth/auth_viewmodel_mixin.dart.template

@@ -0,0 +1,9 @@
+import 'auth_service.dart';
+
+/// 为 ViewModel 提供统一认证态读取入口，避免每个页面自己拼 token 判断。
+mixin AuthViewModelMixin {
+  final AuthService authService = const AuthService();
+
+  bool get isLoggedIn => authService.isLoggedIn;
+  String get authToken => authService.getToken();
+}

package/templates/core_files/auth/index.dart.template

@@ -0,0 +1,4 @@
+// 导出认证能力 (按字母顺序排列)
+export 'auth_middleware.dart';
+export 'auth_service.dart';
+export 'auth_viewmodel_mixin.dart';

package/templates/core_files/base/base_service.dart.template

@@ -0,0 +1,12 @@
+{{#if_base_network_service}}
+import '../network/index.dart';
+
+/// Service 基类
+///
+/// 统一持有 AppHttp，业务 Service 默认继承后直接使用 http。
+abstract class BaseService {
+  final AppHttp http;
+
+  BaseService({AppHttp? http}) : http = http ?? AppHttp();
+}
+{{/if_base_network_service}}

package/templates/core_files/base/index.dart.template

@@ -2,4 +2,7 @@
 export 'base_list_page.dart';
 export 'base_list_viewmodel.dart';
 export 'base_page.dart';
+{{#if_base_network_service}}
+export 'base_service.dart';
+{{/if_base_network_service}}
 export 'base_viewmodel.dart';

package/templates/core_files/config/agreement_document_page.dart.template

@@ -0,0 +1,220 @@
+import 'package:flutter/material.dart';
+
+import 'app_env.dart';
+
+/// 协议文档类型。
+enum AgreementDocumentType {
+  userAgreement,
+  privacyPolicy,
+}
+
+/// 默认离线协议查看页。
+///
+/// 该页面属于默认合规基座，不依赖远程 Web 页面，保证用户在首次同意前也能查看完整文本。
+class AgreementDocumentPage extends StatelessWidget {
+  const AgreementDocumentPage({
+    super.key,
+    required this.type,
+  });
+
+  final AgreementDocumentType type;
+
+  bool get _isUserAgreement => type == AgreementDocumentType.userAgreement;
+
+  @override
+  Widget build(BuildContext context) {
+    final theme = Theme.of(context);
+    final title = _isUserAgreement ? '用户协议' : '隐私政策';
+    final onlineUrl =
+        _isUserAgreement ? EnvConfig.userAgreementUrl : EnvConfig.privacyPolicyUrl;
+
+    return Scaffold(
+      appBar: AppBar(
+        title: Text(title),
+      ),
+      body: SafeArea(
+        child: ListView(
+          padding: const EdgeInsets.fromLTRB(16, 16, 16, 24),
+          children: [
+            Container(
+              padding: const EdgeInsets.all(16),
+              decoration: BoxDecoration(
+                color: theme.colorScheme.surface,
+                borderRadius: BorderRadius.circular(18),
+                border: Border.all(color: theme.dividerColor),
+              ),
+              child: Column(
+                crossAxisAlignment: CrossAxisAlignment.start,
+                children: [
+                  Text(
+                    '${EnvConfig.appName}$title',
+                    style: theme.textTheme.titleMedium?.copyWith(
+                      fontWeight: FontWeight.w700,
+                    ),
+                  ),
+                  const SizedBox(height: 8),
+                  Text(
+                    '运营主体：${EnvConfig.appOperatorName}\n'
+                    '生效日期：${EnvConfig.agreementEffectiveDate}\n'
+                    '联系邮箱：${EnvConfig.privacyContactEmail}',
+                    style: theme.textTheme.bodySmall,
+                  ),
+                  const SizedBox(height: 12),
+                  Text(
+                    '该页面为应用内默认离线协议文本，便于用户在首次同意前直接查看完整内容。正式上线前，请根据你的真实业务、账号体系、第三方 SDK 与数据处理场景完成最终替换。',
+                    style: theme.textTheme.bodySmall?.copyWith(
+                      color: theme.colorScheme.primary,
+                    ),
+                  ),
+                ],
+              ),
+            ),
+            const SizedBox(height: 16),
+            SelectableText(
+              _isUserAgreement ? _defaultUserAgreement : _defaultPrivacyPolicy,
+              style: theme.textTheme.bodyMedium?.copyWith(height: 1.7),
+            ),
+            const SizedBox(height: 20),
+            Container(
+              padding: const EdgeInsets.all(16),
+              decoration: BoxDecoration(
+                color: theme.colorScheme.surface,
+                borderRadius: BorderRadius.circular(18),
+                border: Border.all(color: theme.dividerColor),
+              ),
+              child: Column(
+                crossAxisAlignment: CrossAxisAlignment.start,
+                children: [
+                  Text(
+                    '在线版本链接',
+                    style: theme.textTheme.titleSmall?.copyWith(
+                      fontWeight: FontWeight.w700,
+                    ),
+                  ),
+                  const SizedBox(height: 8),
+                  SelectableText(
+                    onlineUrl,
+                    style: theme.textTheme.bodySmall,
+                  ),
+                ],
+              ),
+            ),
+          ],
+        ),
+      ),
+    );
+  }
+}
+
+const String _defaultUserAgreement = '''
+一、协议说明
+
+1. 本协议由 ${EnvConfig.appOperatorName} 与 ${EnvConfig.appName} 用户共同缔结，用于说明你使用本应用服务时的基本权利义务。
+2. 在你使用本应用前，请认真阅读本协议及《隐私政策》。你点击“同意并继续”或继续使用本应用，即表示你已阅读、理解并接受本协议全部内容。
+3. 如你不同意本协议或《隐私政策》，请立即停止使用本应用，并选择“暂不使用”退出。
+
+二、服务内容
+
+1. 本应用为 Flutter 单包 Starter 默认生成的示例工程，可包含页面展示、网络请求、协议弹窗、本地存储、可选工具能力等基础功能。
+2. 具体业务能力、展示内容、账号体系、支付、消息推送、第三方登录、上传下载等功能，以上线版本真实配置为准。
+3. 本应用保留根据业务发展调整、升级、暂停或终止部分服务的权利。
+
+三、账号与使用规范
+
+1. 你应依法合规使用本应用，不得利用本应用从事违法违规活动。
+2. 你不得干扰本应用正常运行，不得尝试入侵、抓取、攻击、反编译或以其他方式破坏服务安全。
+3. 若你在使用过程中提交内容，应保证该内容合法、真实、完整，不侵犯第三方合法权益。
+
+四、知识产权
+
+1. 本应用界面、代码、文档、图标、设计稿、品牌标识及相关内容的知识产权归运营方或相关权利人所有。
+2. 未经书面许可，你不得擅自复制、修改、传播、出租、出售或用于其他商业用途。
+
+五、免责与责任限制
+
+1. 本应用将尽合理努力保障服务稳定，但不对因不可抗力、网络异常、系统故障、第三方服务异常等原因造成的服务中断承担超出法律规定的责任。
+2. 对于因你违反法律法规、本协议或操作不当而造成的损失，由你自行承担。
+3. 如法律法规另有强制规定的，从其规定。
+
+六、协议更新
+
+1. 本协议可能根据业务变化、法规要求或产品升级进行调整。
+2. 协议内容更新后，可通过应用内弹窗、应用内页面、官网公告等方式提示你。
+3. 若更新后的协议涉及你的重大权益变化，我们将以更显著方式提示。
+
+七、联系我们
+
+如你对本协议有任何疑问、意见或建议，请通过以下方式联系：
+
+运营主体：${EnvConfig.appOperatorName}
+联系邮箱：${EnvConfig.privacyContactEmail}
+生效日期：${EnvConfig.agreementEffectiveDate}
+''';
+
+const String _defaultPrivacyPolicy = '''
+一、引言
+
+1. 本隐私政策由 ${EnvConfig.appOperatorName} 制定，用于说明 ${EnvConfig.appName} 如何收集、使用、存储、共享与保护你的个人信息。
+2. 请在使用本应用前仔细阅读本政策，重点关注加粗或单独列示的内容。
+3. 你点击“同意并继续”后，本应用才会按照本政策说明处理你的个人信息。
+
+二、我们如何收集和使用个人信息
+
+1. 为保障基础功能运行，本应用可能处理以下信息：
+   - 设备基础信息：如设备型号、系统版本、应用版本、日志信息。
+   - 网络信息：如网络状态、请求结果、接口错误信息。
+   - 你主动提交的信息：如账号、昵称、反馈内容、业务表单内容。
+   - 你授权后提供的信息：如相机、相册、存储、位置信息、通知权限对应的数据。
+2. 我们仅在具备明确业务目的和合法基础时处理你的个人信息。
+3. 不同能力的处理范围以你实际启用和使用的功能为准。
+
+三、权限申请说明
+
+1. 本应用遵循“按业务场景、按需申请”的原则，不会在首次启动时一揽子申请所有权限。
+2. 相机、相册、麦克风、定位、通知等敏感权限，只有在你主动触发对应功能时才会请求授权。
+3. 若你拒绝授权，相关功能可能无法使用，但不影响其他无关功能。
+
+四、网络与第三方能力说明
+
+1. 本应用可能使用网络能力获取业务数据、静态资源或在线协议链接。
+2. 在你同意本政策前，默认协议查看页应优先使用应用内离线文本，不依赖在线页面完成首次阅读。
+3. 若项目后续接入统计、推送、崩溃分析、登录、支付、地图、客服等第三方 SDK，应在正式上线前补充其名称、目的、收集信息类型和隐私政策链接。
+
+五、信息存储与保护
+
+1. 我们会采取合理可行的安全措施保护你的个人信息，防止未经授权的访问、披露、篡改或丢失。
+2. 我们仅在实现处理目的所需的最短期限内保存你的个人信息，法律法规另有规定的除外。
+3. 当超出保存期限后，我们会删除或匿名化处理相关信息。
+
+六、信息共享、转让和公开披露
+
+1. 未经你的单独同意，我们不会向无关第三方共享你的个人信息，法律法规另有要求的除外。
+2. 若发生合并、分立、资产转让等情形导致信息转移，我们会要求承接方继续受本政策约束。
+3. 除法律法规规定或取得你的单独同意外，我们不会公开披露你的个人信息。
+
+七、你的权利
+
+你依法享有以下权利：
+
+1. 查阅、复制、更正、补充你的个人信息。
+2. 删除你的个人信息或撤回授权同意。
+3. 注销账号。
+4. 获取本政策说明和投诉反馈渠道。
+
+如你需要行使上述权利，请通过本政策提供的联系方式与我们联系。
+
+八、未成年人保护
+
+1. 若你是未满 14 周岁的未成年人，请在监护人陪同下阅读并决定是否同意本政策。
+2. 若我们发现未经监护人同意处理了未成年人个人信息，将依法尽快删除或匿名化处理。
+
+九、政策更新与联系我们
+
+1. 本政策可能因法规要求、业务变化或第三方能力调整而更新。
+2. 如更新影响你的重大权益，我们会通过弹窗、公告等显著方式提示。
+3. 你可通过以下方式联系我们：
+
+运营主体：${EnvConfig.appOperatorName}
+联系邮箱：${EnvConfig.privacyContactEmail}
+生效日期：${EnvConfig.agreementEffectiveDate}
+''';