Dev

.claude/skills/project-simplification/scripts/generate_root_readme.py

@@ -44,7 +44,7 @@
 
 ```bash
 git clone <repository-url>
-cd flutter_study
+cd flutter_forge
 ```
 
 2. **安装依赖**
@@ -101,7 +101,7 @@
 ## 📁 项目结构
 
 ```
-flutter_study/
+flutter_forge/
 ├── lib/
 │   ├── main.dart                 # 应用入口
 │   ├── app.dart                  # App 配置

.githooks/pre-commit

@@ -3,10 +3,10 @@
 set -euo pipefail
 
 echo "🔍 Running FlutterGuard static scan..."
-if ! dart run flutterguard_cli:flutterguard scan . --fail-on high; then
+if ! (cd apps/flutter_forge && dart run flutterguard_cli:flutterguard scan . --fail-on high); then
   echo ""
   echo "❌ FlutterGuard 检测到高优问题，提交被阻止。"
-  echo "   运行 'dart run flutterguard_cli:flutterguard scan' 查看详情。"
+  echo "   运行 'cd apps/flutter_forge && dart run flutterguard_cli:flutterguard scan . --fail-on high' 查看详情。"
   exit 1
 fi
 

.github/workflows/ci.yml

@@ -12,16 +12,6 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - name: Checkout pinned FlutterGuard
-        uses: actions/checkout@v4
-        with:
-          repository: lizy-coding/flutterguard
-          ref: 9f9be84a73dc4b99a956a8529b8c334849566b03
-          path: flutterguard
-
-      - name: Prepare sibling FlutterGuard dependency
-        run: mv flutterguard ../flutterguard
-
       - name: Setup Flutter
         uses: subosito/flutter-action@v2
         with:
@@ -59,6 +49,3 @@ jobs:
 
       - name: Tests
         run: bash tool/test_all.sh
-
-      - name: FlutterGuard scan
-        run: dart run flutterguard_cli:flutterguard scan . --fail-on high

.hermes/README.md

@@ -1,16 +1,16 @@
 # Hermes Agent 项目架构记录
 
-> flutter_study 项目 Hermes Agent 托管架构 — 完全托管模式
+> flutter_forge 项目 Hermes Agent 托管架构 — 完全托管模式
 > 里程碑: online_video_player_landed | 阶段: agent_managed | 更新: 2026-08-02
 
 ## 项目概述
 
-flutter_study 是一个 Flutter 模块化学习应用，涵盖基础机制、异步并发、状态管理、UI 动效、弹窗列表、网络平台六大分类共 18 个学习模块。通过 Dart Pub Workspace 管理 4 个内部共享包。
+flutter_forge 是一个 Flutter 模块化学习应用，涵盖基础机制、异步并发、状态管理、UI 动效、弹窗列表、网络平台六大分类共 18 个学习模块。通过 Dart Pub Workspace 管理 4 个内部共享包。
 
 ## Agent 文档体系
 
 ```
-flutter_study/
+flutter_forge/
 ├── AGENTS.md                          # Agent 行为契约（入口）
 ├── AI_ANALYSIS_SCHEMA.json            # 文档 schema 定义
 ├── AI_PROJECT_CONTEXT.md              # 项目架构上下文（JSON 机器契约）
@@ -160,4 +160,4 @@ bash tool/quality_gate.sh
 4. 门禁: bash tool/quality_gate.sh
 5. 禁止: 提交/推送/合并（除非用户明确授权）
 6. 禁止: 手改 AI_MODULE_INDEX.md / AI_PROJECT_CONTEXT.md / REFACTOR_PLAN.md / packages/*/AI_ANALYSIS.md
-7. 任务提词: 写入 .hermes/<task>.codex.json（schema: flutter_study.agent_task.v1），Codex 只执行提词，Hermes 独立验收
+7. 任务提词: 写入 .hermes/<task>.codex.json（schema: flutter_forge.agent_task.v1），Codex 只执行提词，Hermes 独立验收

.hermes/online-video-player-macos.codex.json

@@ -1,17 +1,20 @@
 {
-  "schema": "flutter_study.agent_task.v1",
+  "schema": "flutter_forge.agent_task.v1",
   "task_id": "FEAT-20260802-online-video-player-macos",
   "objective": "macos_first_online_video_player_module",
   "scope": "macos_only",
   "agent_role": "code_executor",
   "background": {
-    "repo": "/Users/forest/code/flutter_study",
+    "repo": "/Users/forest/code/langGraph/flutter_forge",
     "branch": "dev",
     "host": "macos",
     "flutter": "3.44.6",
     "macos_deployment_target": "10.15",
     "workspace": "pub_workspace, 4 internal packages",
-    "existing_platform_modules": ["dio_interceptor", "usb_detector"],
+    "existing_platform_modules": [
+      "dio_interceptor",
+      "usb_detector"
+    ],
     "reference_module": "lib/modules/platform/usb_detector",
     "learning_package": "packages/flutter_study_learning (exports LearningScaffold, LearningObjectives, ConceptChips, CodeSnippetCard, CommonPitfalls, ExerciseCard)",
     "plugin_decision": "media_kit ^1.2.6 + media_kit_video ^2.0.1 + media_kit_libs_video ^1.0.7. NOT flutter official video_player (no first-class macOS support).",
@@ -31,7 +34,14 @@
     "difficulty": "intermediate",
     "title": "在线视频播放",
     "subtitle": "使用 media_kit 播放在线 HTTP 视频流并操控播放参数",
-    "concepts": ["media_kit", "libmpv", "HTTP 流", "播放控制", "倍速", "Player 生命周期"],
+    "concepts": [
+      "media_kit",
+      "libmpv",
+      "HTTP 流",
+      "播放控制",
+      "倍速",
+      "Player 生命周期"
+    ],
     "estimatedMinutes": 35,
     "status": "ready",
     "required_files": [

.run/Flutter_Forge_macOS.run.xml

@@ -0,0 +1,6 @@
+<component name="ProjectRunConfigurationManager">
+  <configuration default="false" name="Flutter Forge macOS" type="FlutterRunConfigurationType" factoryName="Flutter">
+    <option name="filePath" value="$PROJECT_DIR$/apps/flutter_forge/lib/main.dart" />
+    <method v="2" />
+  </configuration>
+</component>

AI_ANALYSIS.md

@@ -2,9 +2,9 @@
   "schema": "vibecoding.harness.ai_analysis.v2",
   "mode": "index",
   "node": {
-    "id": "flutter_study.root",
+    "id": "flutter_forge.root",
     "kind": "workspace_index",
-    "package": "main_app",
+    "package": "flutter_forge_app",
     "path": ".",
     "status": "active"
   },

AI_ANALYSIS_SCHEMA.json

@@ -1,5 +1,5 @@
 {
-  "schema": "flutter_study.agent_docs.schema.v2",
+  "schema": "flutter_forge.agent_docs.schema.v2",
   "syntax": "json_config",
   "prose": "forbidden",
   "markdown": "forbidden",

AI_PROJECT_CONTEXT.md

@@ -1,8 +1,8 @@
 {
-  "schema": "flutter_study.agent_docs.project_context.v1",
+  "schema": "flutter_forge.agent_docs.project_context.v1",
   "consumer": "coding_agent",
   "package": {
-    "name": "main_app",
+    "name": "flutter_forge_app",
     "type": "flutter_modular_learning_app",
     "sdk": [
       "flutter_3",
@@ -74,7 +74,7 @@
       "url": "https://github.com/lizy-coding/flutterguard.git",
       "ref": "9f9be84a73dc4b99a956a8529b8c334849566b03",
       "immutable": true,
-      "lock_status": "active"
+      "lock_status": "git_pinned"
     }
   ],
   "layers": [

README.md

@@ -1,7 +1,7 @@
 # Flutter 学习实验室
 
 本项目是面向 Flutter 初学者的学习项目集合，所有学习模块位于 `lib/modules/` 目录下，按主题分类，通过路由切换进入不同模块。项目同时维护 `app/` 应用壳、`module_registry/` 模块元数据和 `shared/` 共享能力，让示例既能独立学习，也能按真实工程方式演进。
-![demo](https://raw.githubusercontent.com/lizy-coding/flutter_study/master/assets/demo.gif)
+![demo](https://raw.githubusercontent.com/lizy-coding/flutter_forge/master/assets/demo.gif)
 
 Full video: https://github.com/user-attachments/assets/6af279c0-7d82-42bc-81b1-624071b0e2ea
 

REFACTOR_PLAN.md

@@ -1,5 +1,5 @@
 {
-  "schema": "flutter_study.agent_docs.refactor_plan.v1",
+  "schema": "flutter_forge.agent_docs.refactor_plan.v1",
   "objective": "android_readiness_after_architecture_convergence",
   "active_phase": "agent_managed",
   "completed_milestones": [
@@ -27,7 +27,7 @@
       "url": "https://github.com/lizy-coding/flutterguard.git",
       "ref": "9f9be84a73dc4b99a956a8529b8c334849566b03",
       "immutable": true,
-      "lock_status": "active"
+      "lock_status": "git_pinned"
     }
   },
   "work_queue": [

lib/AI_ANALYSIS.md → apps/flutter_forge/lib/AI_ANALYSIS.md

@@ -2,9 +2,9 @@
   "schema": "vibecoding.harness.ai_analysis.v2",
   "mode": "index",
   "node": {
-    "id": "main_app.lib",
+    "id": "flutter_forge_app.lib",
     "kind": "source_index",
-    "package": "main_app",
+    "package": "flutter_forge_app",
     "path": "lib",
     "status": "active"
   },

lib/AI_MODULE_INDEX.md → apps/flutter_forge/lib/AI_MODULE_INDEX.md

@@ -1,5 +1,5 @@
 {
-  "schema": "flutter_study.agent_docs.module_index.v1",
+  "schema": "flutter_forge.agent_docs.module_index.v1",
   "registry": "lib/app/router/app_route_table.dart",
   "count": 20,
   "modules": [
@@ -262,8 +262,7 @@
       "status": "ready",
       "depends": [
         "flutter_study_learning",
-        "media_kit",
-        "media_kit_video",
+        "video_player",
         "module_registry"
       ],
       "analysis": "lib/modules/platform/online_video_player/AI_ANALYSIS.md"

lib/app/AI_ANALYSIS.md → apps/flutter_forge/lib/app/AI_ANALYSIS.md

@@ -2,9 +2,9 @@
   "schema": "vibecoding.harness.ai_analysis.v2",
   "mode": "index",
   "node": {
-    "id": "main_app.app",
+    "id": "flutter_forge_app.app",
     "kind": "app_index",
-    "package": "main_app",
+    "package": "flutter_forge_app",
     "path": "lib/app",
     "status": "active"
   },

lib/app/app.dart → apps/flutter_forge/lib/app/app.dart

@@ -9,7 +9,7 @@ class App extends StatelessWidget {
   Widget build(BuildContext context) {
     return MaterialApp.router(
       routerConfig: AppRouter.router,
-      title: 'Flutter 学习实验室',
+      title: 'Flutter Forge',
       theme: ThemeData(
         colorScheme: ColorScheme.fromSeed(seedColor: Colors.blue),
         useMaterial3: true,

lib/app/app_bootstrap.dart → apps/flutter_forge/lib/app/app_bootstrap.dart

@@ -1,16 +1,14 @@
 import 'package:desktop_multi_window/desktop_multi_window.dart';
 import 'package:flutter/material.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
-import 'package:media_kit/media_kit.dart';
 
 import '../shared/multi_window/multi_window_manager.dart';
 import 'app.dart';
 import 'category_window_app.dart';
 
 /// Resolves the host-specific application shell before mounting Flutter.
-Future<void> bootstrapFlutterStudyApp() async {
+Future<void> bootstrapFlutterForgeApp() async {
   WidgetsFlutterBinding.ensureInitialized();
-  MediaKit.ensureInitialized();
 
   Widget root = const App();
   if (MultiWindowManager.isSupported) {

lib/app/router/AI_ANALYSIS.md → apps/flutter_forge/lib/app/router/AI_ANALYSIS.md

@@ -2,9 +2,9 @@
   "schema": "vibecoding.harness.ai_analysis.v2",
   "mode": "index",
   "node": {
-    "id": "main_app.app.router",
+    "id": "flutter_forge_app.app.router",
     "kind": "router_index",
-    "package": "main_app",
+    "package": "flutter_forge_app",
     "path": "lib/app/router",
     "status": "active"
   },

lib/app/router/app_route_table.dart → apps/flutter_forge/lib/app/router/app_route_table.dart

@@ -1,3 +1,5 @@
+// GENERATED by tool/generate_agent_indexes.js - DO NOT EDIT
+
 import 'package:go_router/go_router.dart';
 
 import '../module_home_page.dart';
@@ -300,10 +302,17 @@ final List<ModuleEntry> _modules = [
   ModuleEntry(
     title: '在线视频播放',
     path: '/online-video-player',
-    subtitle: '使用 media_kit 播放在线 HTTP 视频流并操控播放参数',
+    subtitle: '使用 video_player 播放在线 HTTP 视频流并操控播放参数',
     category: ModuleCategory.platform,
     difficulty: Difficulty.intermediate,
-    concepts: ['media_kit', 'libmpv', 'HTTP 流', '播放控制', '倍速', 'Player 生命周期'],
+    concepts: [
+      'video_player',
+      '平台播放器',
+      'HTTP 流',
+      '播放控制',
+      '倍速',
+      'Controller 生命周期',
+    ],
     estimatedMinutes: 35,
     status: ModuleStatus.ready,
     builder: (context) => const OnlineVideoPlayerEntry(),

apps/flutter_forge/lib/main.dart

@@ -0,0 +1,3 @@
+import 'app/app_bootstrap.dart';
+
+Future<void> main() => bootstrapFlutterForgeApp();

lib/module_registry/AI_ANALYSIS.md → apps/flutter_forge/lib/module_registry/AI_ANALYSIS.md

@@ -2,9 +2,9 @@
   "schema": "vibecoding.harness.ai_analysis.v2",
   "mode": "index",
   "node": {
-    "id": "main_app.module_registry",
+    "id": "flutter_forge_app.module_registry",
     "kind": "registry_index",
-    "package": "main_app",
+    "package": "flutter_forge_app",
     "path": "lib/module_registry",
     "status": "active"
   },

lib/modules/AI_ANALYSIS.md → apps/flutter_forge/lib/modules/AI_ANALYSIS.md

@@ -2,9 +2,9 @@
   "schema": "vibecoding.harness.ai_analysis.v2",
   "mode": "index",
   "node": {
-    "id": "main_app.modules",
+    "id": "flutter_forge_app.modules",
     "kind": "modules_index",
-    "package": "main_app",
+    "package": "flutter_forge_app",
     "path": "lib/modules",
     "status": "active"
   },

lib/modules/async/AI_ANALYSIS.md → apps/flutter_forge/lib/modules/async/AI_ANALYSIS.md

@@ -2,9 +2,9 @@
   "schema": "vibecoding.harness.ai_analysis.v2",
   "mode": "index",
   "node": {
-    "id": "main_app.modules.async",
+    "id": "flutter_forge_app.modules.async",
     "kind": "module_category_index",
-    "package": "main_app",
+    "package": "flutter_forge_app",
     "path": "lib/modules/async",
     "status": "active"
   },

lib/modules/async/isolate_basic/AI_ANALYSIS.md → apps/flutter_forge/lib/modules/async/isolate_basic/AI_ANALYSIS.md

@@ -2,9 +2,9 @@
   "schema": "vibecoding.harness.ai_analysis.v2",
   "mode": "module_contract",
   "node": {
-    "id": "main_app.modules.async.isolate_basic",
+    "id": "flutter_forge_app.modules.async.isolate_basic",
     "kind": "learning_module",
-    "package": "main_app",
+    "package": "flutter_forge_app",
     "path": "lib/modules/async/isolate_basic",
     "status": "ready"
   },

lib/modules/async/isolate_basic/with_isolate_page.dart → apps/flutter_forge/lib/modules/async/isolate_basic/with_isolate_page.dart

@@ -118,7 +118,7 @@ class _WithIsolatePageState extends State<WithIsolatePage>
           ),
         ),
       ),
-      sections: [
+      sections: const [
         LearningObjectives(
           objectives: [
             '理解 Isolate 在 Flutter 中的工作原理',

lib/modules/async/isolate_basic/without_isolate_page.dart → apps/flutter_forge/lib/modules/async/isolate_basic/without_isolate_page.dart

@@ -117,7 +117,7 @@ class _WithoutIsolatePageState extends State<WithoutIsolatePage>
           ),
         ),
       ),
-      sections: [
+      sections: const [
         LearningObjectives(
           objectives: [
             '理解主 Isolate 被阻塞时界面卡顿的原理',

lib/modules/async/isolate_task_manager/AI_ANALYSIS.md → apps/flutter_forge/lib/modules/async/isolate_task_manager/AI_ANALYSIS.md

@@ -2,9 +2,9 @@
   "schema": "vibecoding.harness.ai_analysis.v2",
   "mode": "module_contract",
   "node": {
-    "id": "main_app.modules.async.isolate_task_manager",
+    "id": "flutter_forge_app.modules.async.isolate_task_manager",
     "kind": "learning_module",
-    "package": "main_app",
+    "package": "flutter_forge_app",
     "path": "lib/modules/async/isolate_task_manager",
     "status": "ready"
   },

lib/modules/async/stream_subscription/AI_ANALYSIS.md → apps/flutter_forge/lib/modules/async/stream_subscription/AI_ANALYSIS.md

@@ -2,9 +2,9 @@
   "schema": "vibecoding.harness.ai_analysis.v2",
   "mode": "module_contract",
   "node": {
-    "id": "main_app.modules.async.stream_subscription",
+    "id": "flutter_forge_app.modules.async.stream_subscription",
     "kind": "learning_module",
-    "package": "main_app",
+    "package": "flutter_forge_app",
     "path": "lib/modules/async/stream_subscription",
     "status": "recommended"
   },