feat: 添加起卦教程首次访问追踪和Agent时间上下文

- 后端 ProfileSettingsV1 添加 DivinationTutorialSettings 字段
- 前端三个起卦页面添加首次访问检测，自动弹出教程
- 教程展示后更新 settings 标记，避免重复弹出
- 使用本地状态管理避免并发更新覆盖问题
- Agent 系统提示添加时间上下文信息

apps/lib/features/divination/presentation/screens/divination_screen.dart

@@ -10,6 +10,7 @@ import '../../../../shared/widgets/gua_icon.dart';
 import '../../../../shared/widgets/divination/divination_shared_widgets.dart';
 import '../../../../shared/widgets/toast/toast.dart';
 import '../../../../shared/widgets/toast/toast_type.dart';
+import '../../../settings/data/models/profile_settings.dart';
 import '../../data/apis/divination_api.dart';
 import '../../data/models/divination_params.dart';
 import '../../data/models/divination_result.dart';
@@ -26,6 +27,8 @@ class DivinationScreen extends StatefulWidget {
     this.runServiceOverride,
     this.divinationApiOverride,
     this.allowVibration = true,
+    required this.profileSettings,
+    required this.onProfileSettingsChanged,
   });
 
   final SessionStore sessionStore;
@@ -34,6 +37,9 @@ class DivinationScreen extends StatefulWidget {
   final DivinationRunService? runServiceOverride;
   final DivinationApi? divinationApiOverride;
   final bool allowVibration;
+  final ProfileSettingsV1 profileSettings;
+  final Future<void> Function(ProfileSettingsV1 settings)
+  onProfileSettingsChanged;
 
   @override
   State<DivinationScreen> createState() => _DivinationScreenState();
@@ -44,6 +50,8 @@ class _DivinationScreenState extends State<DivinationScreen> {
   final TextEditingController _questionController = TextEditingController();
   late final DivinationApi _divinationApi;
   late final DivinationRunService _runService;
+  bool _tutorialChecked = false;
+  late DivinationTutorialSettings _localTutorialSettings;
 
   @override
   void initState() {
@@ -65,6 +73,47 @@ class _DivinationScreenState extends State<DivinationScreen> {
       userId: widget.userId,
     );
     _questionController.addListener(_syncQuestion);
+    _localTutorialSettings = widget.profileSettings.divinationTutorial;
+  }
+
+  @override
+  void didChangeDependencies() {
+    super.didChangeDependencies();
+    if (!_tutorialChecked) {
+      _tutorialChecked = true;
+      _checkFirstVisit();
+    }
+  }
+
+  void _checkFirstVisit() {
+    if (!_localTutorialSettings.divinationEntryShown) {
+      WidgetsBinding.instance.addPostFrameCallback((_) {
+        if (!mounted) return;
+        final l10n = AppLocalizations.of(context)!;
+        _showGuide(context, l10n);
+        _markTutorialShown('divination_entry');
+      });
+    }
+  }
+
+  Future<void> _markTutorialShown(String key) async {
+    setState(() {
+      _localTutorialSettings = _localTutorialSettings.copyWith(
+        divinationEntryShown: key == 'divination_entry'
+            ? true
+            : _localTutorialSettings.divinationEntryShown,
+        autoDivinationShown: key == 'auto_divination'
+            ? true
+            : _localTutorialSettings.autoDivinationShown,
+        manualDivinationShown: key == 'manual_divination'
+            ? true
+            : _localTutorialSettings.manualDivinationShown,
+      );
+    });
+    final updated = widget.profileSettings.copyWith(
+      divinationTutorial: _localTutorialSettings,
+    );
+    await widget.onProfileSettingsChanged(updated);
   }
 
   @override
@@ -161,6 +210,10 @@ class _DivinationScreenState extends State<DivinationScreen> {
       return;
     }
 
+    final updatedSettings = widget.profileSettings.copyWith(
+      divinationTutorial: _localTutorialSettings,
+    );
+
     if (_params.method == DivinationMethod.manual) {
       final nextParams = _params.copyWith(divinationTime: DateTime.now());
       Navigator.of(context).push(
@@ -170,6 +223,8 @@ class _DivinationScreenState extends State<DivinationScreen> {
             runService: _runService,
             divinationApi: _divinationApi,
             onCompleted: widget.onCompleted,
+            profileSettings: updatedSettings,
+            onProfileSettingsChanged: widget.onProfileSettingsChanged,
           ),
         ),
       );
@@ -187,6 +242,8 @@ class _DivinationScreenState extends State<DivinationScreen> {
           runService: _runService,
           divinationApi: _divinationApi,
           onCompleted: widget.onCompleted,
+          profileSettings: updatedSettings,
+          onProfileSettingsChanged: widget.onProfileSettingsChanged,
         ),
       ),
     );