feat(client/update): 启动自动检查 + App 内下载安装(不走浏览器)

参照 jiu 补齐,但比 jiu 多做了 Android 原生安装(jiu 的 App 内下载仅 Win/mac):
- 启动自动检查:update_provider 改 AsyncNotifier,build() 延迟 3s 首查 + 每小时
  轮询;home_shell watch 拉起、listen 弹更新框;_dismissed 防反复弹(轮询重置);
  强制更新走不可关闭弹窗。设置页「检查更新」改 forceCheck()。
- App 内下载(core/update/app_updater.dart,http 流式带进度框,不再 launchUrl):
  · Android:下 APK → open_filex 拉起系统安装器(+ REQUEST_INSTALL_PACKAGES)
  · Windows:下 exe → Process.start(detached) → exit(0) 覆盖安装
  · macOS :下 zip → open 解压 + 访达显示,提示手动拖入(带系统扩展不自动 swap)
  · iOS   :降级外链(TestFlight/App Store)
  失败降级浏览器下载。新增 6 语更新进度/失败/提示文案。
- 依赖 open_filex；flutter analyze 仅 2 个既有 withOpacity info。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013nMthbVEmQquxBRKb9Fj8u

.gitea/workflows/deploy-site.yml

@@ -29,3 +29,14 @@ jobs:
           CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
           CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
         run: bash scripts/ci/deploy-site.sh
+
+      # 用户中心(web/usercenter → CF Pages pangolin-usercenter / app.yanmeiai.com)。
+      # 与官网同一发版(site-v*),避免两处各自漂移。⚠️ 必须 http 模式构建(见脚本)。
+      - name: Compile (用户中心 Next.js)
+        run: bash scripts/ci/compile-usercenter.sh
+
+      - name: Deploy usercenter → Cloudflare Pages
+        env:
+          CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+          CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
+        run: bash scripts/ci/deploy-usercenter.sh

client/android/app/src/main/AndroidManifest.xml

@@ -23,6 +23,12 @@
     -->
     <uses-permission android:name="android.permission.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS" />
 
+    <!--
+      App 内更新:下载 APK 后拉起系统安装器(open_filex 内封 FileProvider)。
+      Android 8+ 首次安装会引导用户授予「允许安装未知应用」。
+    -->
+    <uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES" />
+
     <application
         android:label="穿山甲"
         android:name="${applicationName}"

client/lib/core/update/app_updater.dart

@@ -0,0 +1,236 @@
+// app_updater.dart — App 内下载并安装更新(不再开浏览器)。
+//
+// 对照 jiu core/update/app_updater_io.dart,但补上了 jiu 没有的 Android 原生安装:
+//   - Android:http 流式下 APK 到临时目录 → open_filex 拉起系统安装器
+//              (open_filex 内部封装 FileProvider;manifest 需 REQUEST_INSTALL_PACKAGES)
+//   - Windows:下 exe → Process.start(detached) 起安装 → exit(0) 让其覆盖
+//   - macOS :下 zip → open 解压 + 访达显示,提示手动拖入「应用程序」
+//            (本 app 带系统扩展,不自动替换 bundle,避免破坏 sysext)
+//   - iOS   :不能 App 内装 → 外链(TestFlight/App Store)
+// 进度用本地 ValueNotifier 驱动一个不可关闭的进度对话框;失败降级浏览器下载。
+import 'dart:async';
+import 'dart:io';
+
+import 'package:flutter/material.dart';
+import 'package:http/http.dart' as http;
+import 'package:open_filex/open_filex.dart';
+import 'package:path_provider/path_provider.dart';
+import 'package:url_launcher/url_launcher.dart';
+
+import '../../l10n/app_text.dart';
+import '../../pangolin_theme.dart';
+import '../../state/update_provider.dart';
+import '../../widgets/pangolin_icons.dart';
+
+/// 更新对话框「下载更新」入口:按平台 App 内下载并安装;iOS/无直链降级浏览器。
+Future<void> startInAppUpdate(BuildContext context, AppText t, AppUpdateInfo info) async {
+  final url = platformDownloadUrl(info.downloadUrls);
+  if (url == null || url.isEmpty) return;
+
+  // iOS 不允许 App 内安装 → 外链(download_urls['ios'] 应为 TestFlight/App Store)。
+  if (Platform.isIOS) {
+    await _openInBrowser(url);
+    return;
+  }
+
+  final progress = ValueNotifier<double>(0);
+  final installing = ValueNotifier<bool>(false);
+  var dialogOpen = true;
+  void closeDialog() {
+    if (context.mounted && dialogOpen) {
+      dialogOpen = false;
+      Navigator.of(context, rootNavigator: true).pop();
+    }
+  }
+
+  // 不可关闭的进度框。
+  unawaited(showDialog<void>(
+    context: context,
+    barrierDismissible: false,
+    builder: (_) => PopScope(
+      canPop: false,
+      child: _ProgressDialog(t: t, progress: progress, installing: installing),
+    ),
+  ));
+
+  try {
+    final savePath = await _savePath(url);
+    await _download(url, savePath, (p) => progress.value = p);
+    installing.value = true;
+    await _install(savePath); // Win/macOS 可能在此 exit(0),不再返回
+    closeDialog();
+    if (Platform.isMacOS && context.mounted) {
+      await _showInfo(context, t, t.lang.updateMacReveal);
+    }
+  } catch (_) {
+    closeDialog();
+    if (context.mounted) await _showFailed(context, t, url);
+  } finally {
+    progress.dispose();
+    installing.dispose();
+  }
+}
+
+/// 各平台下载文件的落盘路径。
+Future<String> _savePath(String url) async {
+  final tmp = await getTemporaryDirectory();
+  if (Platform.isWindows) return '${tmp.path}${Platform.pathSeparator}pangolin-update-setup.exe';
+  if (Platform.isMacOS) {
+    // 下到「下载」目录便于用户在访达里操作;取不到则回退临时目录。
+    final dl = await getDownloadsDirectory();
+    final dir = dl ?? tmp;
+    return '${dir.path}/pangolin-update.zip';
+  }
+  return '${tmp.path}/pangolin-update.apk'; // Android
+}
+
+/// http 流式下载 + 进度回调。失败抛异常(由调用方降级)。
+Future<void> _download(String url, String savePath, void Function(double) onProgress) async {
+  final client = http.Client();
+  try {
+    final req = http.Request('GET', Uri.parse(url));
+    final resp = await client.send(req);
+    if (resp.statusCode != 200) {
+      throw HttpException('HTTP ${resp.statusCode}', uri: Uri.parse(url));
+    }
+    final total = resp.contentLength ?? 0;
+    final file = File(savePath);
+    final sink = file.openWrite();
+    var received = 0;
+    try {
+      await for (final chunk in resp.stream) {
+        received += chunk.length;
+        sink.add(chunk);
+        if (total > 0) onProgress(received / total);
+      }
+      await sink.flush();
+    } finally {
+      await sink.close();
+    }
+  } finally {
+    client.close();
+  }
+}
+
+/// 下载后触发安装/打开。
+Future<void> _install(String path) async {
+  if (Platform.isAndroid) {
+    await OpenFilex.open(path); // 系统安装器(open_filex 内封 FileProvider)
+    return;
+  }
+  if (Platform.isWindows) {
+    await Process.start(path, const [], mode: ProcessStartMode.detached);
+    await Future<void>.delayed(const Duration(milliseconds: 400));
+    exit(0); // 退出让安装器覆盖
+  }
+  if (Platform.isMacOS) {
+    // 不自动替换 bundle(带系统扩展,风险高):解压 + 访达高亮,提示手动拖入。
+    await Process.run('open', <String>[path]); // Archive Utility 解压
+    await Process.run('open', <String>['-R', path]); // 访达定位
+  }
+}
+
+Future<void> _openInBrowser(String url) async {
+  final uri = Uri.parse(url);
+  if (await canLaunchUrl(uri)) {
+    await launchUrl(uri, mode: LaunchMode.externalApplication);
+  }
+}
+
+Future<void> _showInfo(BuildContext context, AppText t, String msg) {
+  final c = context.pangolin;
+  return showDialog<void>(
+    context: context,
+    builder: (ctx) => AlertDialog(
+      backgroundColor: c.surface,
+      shape: RoundedRectangleBorder(borderRadius: BorderRadius.circular(PangolinRadius.xl)),
+      content: Text(msg, style: PangolinText.sm.copyWith(color: c.fg2, height: 1.5)),
+      actions: [
+        TextButton(
+          onPressed: () => Navigator.of(ctx).pop(),
+          child: Text('OK', style: PangolinText.sm.copyWith(color: c.accent, fontWeight: FontWeight.w700)),
+        ),
+      ],
+    ),
+  );
+}
+
+Future<void> _showFailed(BuildContext context, AppText t, String url) {
+  final c = context.pangolin;
+  return showDialog<void>(
+    context: context,
+    builder: (ctx) => AlertDialog(
+      backgroundColor: c.surface,
+      shape: RoundedRectangleBorder(borderRadius: BorderRadius.circular(PangolinRadius.xl)),
+      content: Text(t.lang.updateDownloadFailed, style: PangolinText.sm.copyWith(color: c.fg2, height: 1.5)),
+      actions: [
+        TextButton(
+          onPressed: () => Navigator.of(ctx).pop(),
+          child: Text(t.lang.updateCancelBtn, style: PangolinText.sm.copyWith(color: c.fg2, fontWeight: FontWeight.w600)),
+        ),
+        TextButton(
+          onPressed: () async {
+            Navigator.of(ctx).pop();
+            await _openInBrowser(url);
+          },
+          child: Text(t.lang.updateOpenBrowser, style: PangolinText.sm.copyWith(color: c.accent, fontWeight: FontWeight.w700)),
+        ),
+      ],
+    ),
+  );
+}
+
+class _ProgressDialog extends StatelessWidget {
+  const _ProgressDialog({required this.t, required this.progress, required this.installing});
+  final AppText t;
+  final ValueNotifier<double> progress;
+  final ValueNotifier<bool> installing;
+
+  @override
+  Widget build(BuildContext context) {
+    final c = context.pangolin;
+    return AlertDialog(
+      backgroundColor: c.surface,
+      shape: RoundedRectangleBorder(borderRadius: BorderRadius.circular(PangolinRadius.xl)),
+      title: Row(children: [
+        Container(
+          width: 34,
+          height: 34,
+          decoration: BoxDecoration(color: c.accentSubtle, shape: BoxShape.circle),
+          child: Icon(PangolinIcons.zap, size: 18, color: c.accent),
+        ),
+        const SizedBox(width: 12),
+        Expanded(
+          child: Text(t.updateDownload,
+              style: PangolinText.body.copyWith(color: c.fg1, fontWeight: FontWeight.w700)),
+        ),
+      ]),
+      content: ValueListenableBuilder<bool>(
+        valueListenable: installing,
+        builder: (_, inst, __) => ValueListenableBuilder<double>(
+          valueListenable: progress,
+          builder: (_, p, __) => Column(
+            mainAxisSize: MainAxisSize.min,
+            crossAxisAlignment: CrossAxisAlignment.stretch,
+            children: [
+              ClipRRect(
+                borderRadius: BorderRadius.circular(PangolinRadius.full),
+                child: LinearProgressIndicator(
+                  value: inst || p <= 0 ? null : p,
+                  minHeight: 6,
+                  backgroundColor: c.bgSubtle,
+                  valueColor: AlwaysStoppedAnimation<Color>(c.accent),
+                ),
+              ),
+              const SizedBox(height: 12),
+              Text(
+                inst ? t.lang.updateInstalling : t.lang.updateDownloadingPercent((p * 100).clamp(0, 100).round()),
+                style: PangolinText.sm.copyWith(color: c.fg2),
+              ),
+            ],
+          ),
+        ),
+      ),
+    );
+  }
+}

client/lib/l10n/app_text.dart

@@ -34,6 +34,282 @@ extension AppLangLabel on AppLang {
   }
 }
 
+/// 少量「拿不到 AppText 实例的场景」(model / 非 Consumer 的 tile,只有 AppLang)
+/// 用到的零散文案。exhaustive switch 保证 6 语全覆盖,不会漏译回退英文。
+/// 仍归属 l10n 层(scan-redline 覆盖本文件),不违反「文案集中」铁律。
+extension AppLangMisc on AppLang {
+  /// 节点不可用(agent 离线)。
+  String get unavailable {
+    switch (this) {
+      case AppLang.zh:
+        return '不可用';
+      case AppLang.en:
+        return 'Unavailable';
+      case AppLang.ja:
+        return '利用不可';
+      case AppLang.ko:
+        return '사용 불가';
+      case AppLang.ru:
+        return 'Недоступно';
+      case AppLang.es:
+        return 'No disponible';
+    }
+  }
+
+  /// 节点标签:流媒体优化。
+  String get tagStreaming {
+    switch (this) {
+      case AppLang.zh:
+        return '流媒体优化';
+      case AppLang.en:
+        return 'Streaming';
+      case AppLang.ja:
+        return 'ストリーミング最適化';
+      case AppLang.ko:
+        return '스트리밍 최적화';
+      case AppLang.ru:
+        return 'Оптимизация стриминга';
+      case AppLang.es:
+        return 'Optimización de streaming';
+    }
+  }
+
+  /// 节点尚未就绪(列表加载中/为空)。
+  String get nodesNotReady {
+    switch (this) {
+      case AppLang.zh:
+        return '节点尚未就绪,请稍候重试';
+      case AppLang.en:
+        return 'Nodes not ready, please retry';
+      case AppLang.ja:
+        return 'ノードの準備ができていません。しばらくして再試行してください';
+      case AppLang.ko:
+        return '노드가 아직 준비되지 않았습니다. 잠시 후 다시 시도하세요';
+      case AppLang.ru:
+        return 'Узлы не готовы, повторите попытку';
+      case AppLang.es:
+        return 'Nodos no listos, inténtalo de nuevo';
+    }
+  }
+
+  /// 连接失败(通用兜底)。
+  String get connectFailed {
+    switch (this) {
+      case AppLang.zh:
+        return '连接失败,请重试';
+      case AppLang.en:
+        return 'Connection failed, please retry';
+      case AppLang.ja:
+        return '接続に失敗しました。再試行してください';
+      case AppLang.ko:
+        return '연결에 실패했습니다. 다시 시도하세요';
+      case AppLang.ru:
+        return 'Не удалось подключиться, повторите попытку';
+      case AppLang.es:
+        return 'Error de conexión, inténtalo de nuevo';
+    }
+  }
+
+  /// 数据加载失败。
+  String get loadFailedRetry {
+    switch (this) {
+      case AppLang.zh:
+        return '加载失败,请重试';
+      case AppLang.en:
+        return 'Failed to load, retry';
+      case AppLang.ja:
+        return '読み込みに失敗しました。再試行してください';
+      case AppLang.ko:
+        return '불러오기에 실패했습니다. 다시 시도하세요';
+      case AppLang.ru:
+        return 'Не удалось загрузить, повторите';
+      case AppLang.es:
+        return 'Error al cargar, reintentar';
+    }
+  }
+
+  /// 无已登录设备。
+  String get noDevices {
+    switch (this) {
+      case AppLang.zh:
+        return '暂无已登录设备';
+      case AppLang.en:
+        return 'No devices yet';
+      case AppLang.ja:
+        return 'ログイン済みのデバイスはありません';
+      case AppLang.ko:
+        return '로그인된 기기가 없습니다';
+      case AppLang.ru:
+        return 'Пока нет устройств';
+      case AppLang.es:
+        return 'Aún no hay dispositivos';
+    }
+  }
+
+  /// 「改邮箱」按钮短标签。
+  String get changeEmail {
+    switch (this) {
+      case AppLang.zh:
+        return '改邮箱';
+      case AppLang.en:
+        return 'Change';
+      case AppLang.ja:
+        return '変更';
+      case AppLang.ko:
+        return '변경';
+      case AppLang.ru:
+        return 'Изменить';
+      case AppLang.es:
+        return 'Cambiar';
+    }
+  }
+
+  /// 相对时间(设备最后在线):刚刚 / X 分钟前 / X 小时前 / X 天前。
+  String relativeTime(Duration d) {
+    final m = d.inMinutes, h = d.inHours, days = d.inDays;
+    switch (this) {
+      case AppLang.zh:
+        if (m < 1) return '刚刚';
+        if (m < 60) return '$m 分钟前';
+        if (h < 24) return '$h 小时前';
+        return '$days 天前';
+      case AppLang.en:
+        if (m < 1) return 'just now';
+        if (m < 60) return '$m min ago';
+        if (h < 24) return '${h}h ago';
+        return '${days}d ago';
+      case AppLang.ja:
+        if (m < 1) return 'たった今';
+        if (m < 60) return '$m 分前';
+        if (h < 24) return '$h 時間前';
+        return '$days 日前';
+      case AppLang.ko:
+        if (m < 1) return '방금';
+        if (m < 60) return '$m분 전';
+        if (h < 24) return '$h시간 전';
+        return '$days일 전';
+      case AppLang.ru:
+        if (m < 1) return 'только что';
+        if (m < 60) return '$m мин назад';
+        if (h < 24) return '$h ч назад';
+        return '$days дн назад';
+      case AppLang.es:
+        if (m < 1) return 'ahora mismo';
+        if (m < 60) return 'hace $m min';
+        if (h < 24) return 'hace $h h';
+        return 'hace $days d';
+    }
+  }
+
+  /// 更新下载进度:「正在下载 X%」。
+  String updateDownloadingPercent(int pct) {
+    switch (this) {
+      case AppLang.zh:
+        return '正在下载 $pct%';
+      case AppLang.en:
+        return 'Downloading $pct%';
+      case AppLang.ja:
+        return 'ダウンロード中 $pct%';
+      case AppLang.ko:
+        return '다운로드 중 $pct%';
+      case AppLang.ru:
+        return 'Загрузка $pct%';
+      case AppLang.es:
+        return 'Descargando $pct%';
+    }
+  }
+
+  /// 下载完成、正在安装。
+  String get updateInstalling {
+    switch (this) {
+      case AppLang.zh:
+        return '下载完成,正在安装…';
+      case AppLang.en:
+        return 'Downloaded, installing…';
+      case AppLang.ja:
+        return 'ダウンロード完了、インストール中…';
+      case AppLang.ko:
+        return '다운로드 완료, 설치 중…';
+      case AppLang.ru:
+        return 'Загружено, установка…';
+      case AppLang.es:
+        return 'Descargado, instalando…';
+    }
+  }
+
+  /// 下载失败。
+  String get updateDownloadFailed {
+    switch (this) {
+      case AppLang.zh:
+        return '下载失败,请重试或改用浏览器下载。';
+      case AppLang.en:
+        return 'Download failed. Retry or download in your browser.';
+      case AppLang.ja:
+        return 'ダウンロードに失敗しました。再試行するかブラウザでダウンロードしてください。';
+      case AppLang.ko:
+        return '다운로드에 실패했습니다. 다시 시도하거나 브라우저로 다운로드하세요.';
+      case AppLang.ru:
+        return 'Не удалось загрузить. Повторите или скачайте в браузере.';
+      case AppLang.es:
+        return 'Error de descarga. Reintenta o descarga en el navegador.';
+    }
+  }
+
+  /// macOS:已下载,提示手动拖入应用程序。
+  String get updateMacReveal {
+    switch (this) {
+      case AppLang.zh:
+        return '已下载并解压。请在访达中将 Pangolin 拖入「应用程序」文件夹替换旧版,然后重新打开。';
+      case AppLang.en:
+        return 'Downloaded and extracted. In Finder, drag Pangolin into your Applications folder to replace the old version, then reopen.';
+      case AppLang.ja:
+        return 'ダウンロードと展開が完了しました。Finder で Pangolin を「アプリケーション」フォルダにドラッグして置き換え、再度開いてください。';
+      case AppLang.ko:
+        return '다운로드 및 압축 해제 완료. Finder에서 Pangolin을 「응용 프로그램」 폴더로 드래그해 이전 버전을 교체한 뒤 다시 여세요.';
+      case AppLang.ru:
+        return 'Загружено и распаковано. В Finder перетащите Pangolin в папку «Программы», заменив старую версию, затем откройте заново.';
+      case AppLang.es:
+        return 'Descargado y extraído. En Finder, arrastra Pangolin a tu carpeta de Aplicaciones para reemplazar la versión anterior y vuelve a abrir.';
+    }
+  }
+
+  /// 失败对话框:改用浏览器下载。
+  String get updateOpenBrowser {
+    switch (this) {
+      case AppLang.zh:
+        return '浏览器下载';
+      case AppLang.en:
+        return 'Open in browser';
+      case AppLang.ja:
+        return 'ブラウザで開く';
+      case AppLang.ko:
+        return '브라우저에서 열기';
+      case AppLang.ru:
+        return 'Открыть в браузере';
+      case AppLang.es:
+        return 'Abrir en el navegador';
+    }
+  }
+
+  /// 通用「取消」。
+  String get updateCancelBtn {
+    switch (this) {
+      case AppLang.zh:
+        return '取消';
+      case AppLang.en:
+        return 'Cancel';
+      case AppLang.ja:
+        return 'キャンセル';
+      case AppLang.ko:
+        return '취소';
+      case AppLang.ru:
+        return 'Отмена';
+      case AppLang.es:
+        return 'Cancelar';
+    }
+  }
+}
+
 /// 全部界面文案的抽象契约。zh / en 各实现一份。
 abstract class AppText {
   const AppText();

client/lib/models/node.dart

@@ -66,7 +66,7 @@ class Node {
   String localizedSub(AppLang lang) {
     switch (tag) {
       case NodeTag.streaming:
-        return lang == AppLang.zh ? '流媒体优化' : 'Streaming';
+        return lang.tagStreaming;
       case NodeTag.p2p:
         return 'P2P';
       case NodeTag.none:

client/lib/screens/account_page.dart

@@ -75,7 +75,7 @@ class AccountPage extends ConsumerWidget {
           _CustomRow(
             icon: PangolinIcons.globe,
             title: t.language,
-            trailing: _LangSwitch(lang: lang, onChange: (l) => ref.read(localeProvider.notifier).state = l),
+            trailing: _LangSwitch(lang: lang, onChange: (l) => ref.read(localeProvider.notifier).set(l)),
           ),
           Divider(height: 1, color: c.border),
           _CustomRow(

client/lib/screens/nodes_page.dart

@@ -267,7 +267,7 @@ class _NodeGridTile extends StatelessWidget {
   Widget build(BuildContext context) {
     final c = context.pangolin;
     final down = node.isDown; // 节点不可用(agent 离线):置灰 + 「不可用」+ 禁选。
-    final unavail = lang == AppLang.zh ? '不可用' : 'Unavailable';
+    final unavail = lang.unavailable;
     return Opacity(
       opacity: down ? 0.55 : 1.0,
       child: Material(

client/lib/screens/settings_page.dart

@@ -20,7 +20,7 @@ import '../widgets/update_dialog.dart';
 /// 「检查更新」手动触发:拉取 `$kApiBaseUrl/version`,失败/无更新走轻提示,
 /// 有更新则弹 [showUpdateDialog]。
 Future<void> _checkForUpdate(BuildContext context, WidgetRef ref, AppText t) async {
-  final info = await ref.read(updateCheckerProvider).check();
+  final info = await ref.read(updateProvider.notifier).forceCheck();
   if (!context.mounted) return;
   if (info == null) {
     showPangolinToast(context, t.updateCheckFailed);
@@ -72,7 +72,7 @@ class SettingsPage extends ConsumerWidget {
           const SizedBox(height: 16),
           // 配置组
           _Card(children: [
-            _Row(title: t.language, right: _LangSwitch(lang: lang, onPick: (l) => ref.read(localeProvider.notifier).state = l)),
+            _Row(title: t.language, right: _LangSwitch(lang: lang, onPick: (l) => ref.read(localeProvider.notifier).set(l))),
             _Row(
               title: t.darkAppearance,
               sub: isDark ? t.stateOn : t.followLight,

client/lib/shell/home_shell.dart

@@ -8,6 +8,9 @@ import 'package:flutter_riverpod/flutter_riverpod.dart';
 
 import '../core/responsive/form_factor.dart';
 import '../pangolin_theme.dart';
+import '../state/app_providers.dart';
+import '../state/update_provider.dart';
+import '../widgets/update_dialog.dart';
 import 'desktop_shell.dart';
 import 'mobile_shell.dart';
 import 'tablet_shell.dart';
@@ -18,6 +21,23 @@ class HomeShell extends ConsumerWidget {
   @override
   Widget build(BuildContext context, WidgetRef ref) {
     final c = context.pangolin;
+
+    // 启动自动检查更新:watch 惰性拉起 updateProvider(延迟 3s→查→1h 轮询);
+    // 有新版且本次会话未忽略时弹更新对话框。非强制更新弹前即标 dismiss,避免
+    // rebuild 重复弹(下轮轮询会重置);强制更新走不可关闭弹窗。
+    ref.listen<AsyncValue<AppUpdateInfo?>>(updateProvider, (prev, next) {
+      final info = next.valueOrNull;
+      if (info == null || !info.hasUpdate) return;
+      final notifier = ref.read(updateProvider.notifier);
+      if (notifier.isDismissed) return;
+      if (!info.forceUpdate) notifier.dismiss();
+      WidgetsBinding.instance.addPostFrameCallback((_) {
+        if (!context.mounted) return;
+        showUpdateDialog(context, ref.read(appTextProvider), info);
+      });
+    });
+    ref.watch(updateProvider); // 激活 provider(惰性 build)
+
     final Widget body = switch (context.formFactor) {
       FormFactor.desktop => const DesktopShell(),
       FormFactor.tablet => const TabletShell(),

client/lib/state/app_providers.dart

@@ -1,6 +1,7 @@
 // app_providers.dart — 语言 / 主题 / 套餐视角等基础状态(Riverpod)
 import 'package:flutter/material.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:shared_preferences/shared_preferences.dart';
 
 import '../l10n/app_text.dart';
 import '../l10n/strings_en.dart';
@@ -12,12 +13,10 @@ import '../l10n/strings_zh.dart';
 import 'account_providers.dart';
 import 'auth_provider.dart';
 
-/// 当前语言(单显)。设置/账户页切换。默认英文(国际化默认语种)。
-final localeProvider = StateProvider<AppLang>((ref) => AppLang.en);
-
-/// 由语言派生的文案资源——UI 一律通过它取文案,不写死字面量。
-final appTextProvider = Provider<AppText>((ref) {
-  switch (ref.watch(localeProvider)) {
+/// AppLang → 文案资源实例。供 [appTextProvider] 与「拿不到 Consumer 的场景」
+/// (model / 非 Consumer 的 tile,只有 AppLang)复用,避免各处重写 switch。
+AppText appTextFor(AppLang lang) {
+  switch (lang) {
     case AppLang.zh:
       return const StringsZh();
     case AppLang.en:
@@ -31,7 +30,48 @@ final appTextProvider = Provider<AppText>((ref) {
     case AppLang.es:
       return const StringsEs();
   }
-});
+}
+
+/// 当前语言(单显)。默认英文(国际化默认语种);用户选择持久化到
+/// shared_preferences(key `pg_lang`,存枚举 name),重启保留 —— 原来无持久化,
+/// 切了语言重启会丢。设置/账户页经 `.notifier).set(lang)` 切换。
+class LocaleNotifier extends StateNotifier<AppLang> {
+  LocaleNotifier() : super(AppLang.en) {
+    _load();
+  }
+  static const _key = 'pg_lang';
+
+  Future<void> _load() async {
+    try {
+      final saved = (await SharedPreferences.getInstance()).getString(_key);
+      if (saved != null) {
+        for (final l in AppLang.values) {
+          if (l.name == saved) {
+            state = l;
+            break;
+          }
+        }
+      }
+    } catch (_) {
+      /* 读失败保持默认 en */
+    }
+  }
+
+  Future<void> set(AppLang lang) async {
+    state = lang;
+    try {
+      await (await SharedPreferences.getInstance()).setString(_key, lang.name);
+    } catch (_) {
+      /* 持久化失败忽略,本次会话仍生效 */
+    }
+  }
+}
+
+final localeProvider =
+    StateNotifierProvider<LocaleNotifier, AppLang>((ref) => LocaleNotifier());
+
+/// 由语言派生的文案资源——UI 一律通过它取文案,不写死字面量。
+final appTextProvider = Provider<AppText>((ref) => appTextFor(ref.watch(localeProvider)));
 
 /// 主题模式。默认跟随系统;设置页可显式切深色。
 final themeModeProvider = StateProvider<ThemeMode>((ref) => ThemeMode.system);

client/lib/state/connection_provider.dart

@@ -203,7 +203,8 @@ class ConnectionController extends StateNotifier<ConnectionState> {
     state = const ConnectionState(phase: VpnPhase.connecting);
 
     final node = _ref.read(effectiveNodeProvider);
-    final zh = _ref.read(localeProvider) == AppLang.zh;
+    final lang = _ref.read(localeProvider);
+    final zh = lang == AppLang.zh; // 仅用于服务端 e.messageZh/En 的二选一(下方)
     logLine('Connect', '_connect node=${node.code} uuid=${node.uuid.isEmpty ? "EMPTY" : "ok"} '
         'selected=${_ref.read(selectedNodeCodeProvider)} nodes=${(_ref.read(nodesProvider).valueOrNull ?? const []).length}');
 
@@ -212,7 +213,7 @@ class ConnectionController extends StateNotifier<ConnectionState> {
       if (mounted) {
         state = ConnectionState(
           phase: VpnPhase.off,
-          error: zh ? '节点尚未就绪,请稍候重试' : 'Nodes not ready, please retry',
+          error: lang.nodesNotReady,
         );
       }
       return;
@@ -244,7 +245,7 @@ class ConnectionController extends StateNotifier<ConnectionState> {
       if (mounted) {
         state = ConnectionState(
           phase: VpnPhase.off,
-          error: zh ? '连接失败,请重试' : 'Connection failed, please retry',
+          error: lang.connectFailed,
         );
       }
     }

client/lib/state/update_provider.dart

@@ -1,11 +1,12 @@
-// update_provider.dart — 应用更新检查(轻量版,无后台轮询)。
+// update_provider.dart — 应用更新检查(启动自动检查 + 定时轮询)。
 //
-// 手动触发(设置页「检查更新」)向控制面 GET $kApiBaseUrl/version 拉取最新版本信息,
-// 与本地版本(package_info_plus)做语义比较;有更新则由调用方(settings_page)弹窗
-// 展示(见 widgets/update_dialog.dart)。检查失败静默返回 null,不影响主流程。
+// 对照 jiu client/lib/providers/update_provider.dart:用 AsyncNotifier 的惰性
+// build() 做「启动后延迟首查 + 每小时轮询」;shell 里 watch 一次即拉起整条流程。
+// `_dismissed` 是本次进程内存标志(用户点「稍后」置真,防反复弹),每轮轮询重置。
+// 强制更新(force_update)不受 dismiss 影响,由 UI 走不可关闭弹窗。
 //
-// 对照 jiu client/lib/providers/update_provider.dart,去掉了定时轮询 Timer 与
-// dismiss 状态——按需求这里只做「手动检查」,启动期自动检查留作后续 TODO。
+// 拿到更新后,下载安装走 core/update/app_updater.dart(App 内下载,不再开浏览器)。
+import 'dart:async';
 import 'dart:convert';
 import 'dart:io';
 
@@ -15,6 +16,15 @@ import 'package:package_info_plus/package_info_plus.dart';
 
 import '../services/api_config.dart';
 
+/// 启动后首次检查的延迟(避开登录/首屏竞争)。
+const _kInitialDelay = Duration(seconds: 3);
+
+/// 轮询间隔。
+const _kPollInterval = Duration(hours: 1);
+
+/// 单次检查网络超时。
+const _kCheckTimeout = Duration(seconds: 8);
+
 /// 一次更新检查的结果。
 class AppUpdateInfo {
   const AppUpdateInfo({
@@ -34,18 +44,43 @@ class AppUpdateInfo {
   final bool hasUpdate;
 }
 
-/// 无状态更新检查服务,供设置页「检查更新」按钮直接调用。
-final updateCheckerProvider = Provider<UpdateChecker>((ref) => const UpdateChecker());
+/// 更新检查 Notifier。build() 惰性触发:延迟首查 + 每小时轮询。
+class UpdateNotifier extends AsyncNotifier<AppUpdateInfo?> {
+  Timer? _timer;
+  bool _dismissed = false;
 
-class UpdateChecker {
-  const UpdateChecker();
+  /// 本次会话是否已被用户「稍后」忽略(强制更新不看这个)。
+  bool get isDismissed => _dismissed;
+
+  @override
+  Future<AppUpdateInfo?> build() async {
+    ref.onDispose(() => _timer?.cancel());
+    await Future<void>.delayed(_kInitialDelay);
+    final first = await _check();
+    _timer = Timer.periodic(_kPollInterval, (_) async {
+      _dismissed = false; // 新一轮允许再次提示
+      state = AsyncValue.data(await _check());
+    });
+    return first;
+  }
+
+  /// 用户点「稍后」——本次会话内不再自动弹(直到下轮轮询)。
+  void dismiss() => _dismissed = true;
+
+  /// 设置页「检查更新」手动触发:立即查一次并回结果(不受 dismiss 影响)。
+  Future<AppUpdateInfo?> forceCheck() async {
+    _dismissed = false;
+    final info = await _check();
+    state = AsyncValue.data(info);
+    return info;
+  }
 
   /// 拉取 `$kApiBaseUrl/version` 并与本地版本比较。网络/解析失败返回 null(静默)。
-  Future<AppUpdateInfo?> check() async {
+  Future<AppUpdateInfo?> _check() async {
     try {
       final resp = await http
           .get(Uri.parse('$kApiBaseUrl/version'))
-          .timeout(const Duration(seconds: 8));
+          .timeout(_kCheckTimeout);
       if (resp.statusCode != 200) return null;
       final data = jsonDecode(resp.body) as Map<String, dynamic>;
 
@@ -56,8 +91,8 @@ class UpdateChecker {
       final rawUrls = data['download_urls'] as Map<String, dynamic>? ?? const {};
       final downloadUrls = rawUrls.map((k, v) => MapEntry(k, v?.toString() ?? ''));
 
-      final info = await PackageInfo.fromPlatform();
-      final hasUpdate = _isNewer(latestVersion, info.version);
+      final pkg = await PackageInfo.fromPlatform();
+      final hasUpdate = _isNewer(latestVersion, pkg.version);
 
       return AppUpdateInfo(
         latestVersion: latestVersion,
@@ -95,6 +130,9 @@ class UpdateChecker {
   }
 }
 
+final updateProvider =
+    AsyncNotifierProvider<UpdateNotifier, AppUpdateInfo?>(UpdateNotifier.new);
+
 /// 按当前平台从服务端 download_urls 里取对应下载直链。
 String? platformDownloadUrl(Map<String, String> downloadUrls) {
   if (Platform.isMacOS) return downloadUrls['macos'];

client/lib/widgets/account_screens.dart

@@ -98,7 +98,7 @@ class PlansScreen extends ConsumerWidget {
     Widget body() => plansAsync.when(
           loading: () => const Center(child: Padding(padding: EdgeInsets.all(40), child: CircularProgressIndicator())),
           error: (_, __) => Center(
-              child: Padding(padding: const EdgeInsets.all(40), child: Text(t.lang == AppLang.zh ? '加载失败,请重试' : 'Failed to load, retry', style: PangolinText.body.copyWith(color: c.fg3)))),
+              child: Padding(padding: const EdgeInsets.all(40), child: Text(t.lang.loadFailedRetry, style: PangolinText.body.copyWith(color: c.fg3)))),
           data: (plans) => ListView(
             padding: const EdgeInsets.fromLTRB(20, 14, 20, 24),
             children: [
@@ -140,13 +140,8 @@ class DevicesScreen extends ConsumerWidget {
 
   // 相对时间(最后登录);null → 从未登录。
   String _rel(DateTime? ts) {
-    final zh = t.lang == AppLang.zh;
     if (ts == null) return t.devNeverLogin;
-    final d = DateTime.now().difference(ts.toLocal());
-    if (d.inMinutes < 1) return zh ? '刚刚' : 'just now';
-    if (d.inMinutes < 60) return zh ? '${d.inMinutes} 分钟前' : '${d.inMinutes} min ago';
-    if (d.inHours < 24) return zh ? '${d.inHours} 小时前' : '${d.inHours}h ago';
-    return zh ? '${d.inDays} 天前' : '${d.inDays}d ago';
+    return t.lang.relativeTime(DateTime.now().difference(ts.toLocal()));
   }
 
   @override
@@ -158,12 +153,12 @@ class DevicesScreen extends ConsumerWidget {
     Widget content() => devicesAsync.when(
           loading: () => const Center(child: Padding(padding: EdgeInsets.all(40), child: CircularProgressIndicator())),
           error: (_, __) => Center(
-              child: Padding(padding: const EdgeInsets.all(40), child: Text(t.lang == AppLang.zh ? '加载失败,请重试' : 'Failed to load, retry', style: PangolinText.body.copyWith(color: c.fg3)))),
+              child: Padding(padding: const EdgeInsets.all(40), child: Text(t.lang.loadFailedRetry, style: PangolinText.body.copyWith(color: c.fg3)))),
           data: (devices) => ListView(padding: const EdgeInsets.fromLTRB(20, 4, 20, 24), children: [
             Text(t.devicesSub, style: PangolinText.caption.copyWith(color: c.fg3, fontWeight: FontWeight.w400)),
             const SizedBox(height: 12),
             if (devices.isEmpty)
-              Text(t.lang == AppLang.zh ? '暂无已登录设备' : 'No devices yet',
+              Text(t.lang.noDevices,
                   style: PangolinText.sm.copyWith(color: c.fg3))
             else
               Container(

client/lib/widgets/auth_screen.dart

@@ -39,7 +39,7 @@ class _AuthScreenState extends ConsumerState<AuthScreen>
   bool _sent = false;
   bool _loading = false;
   bool _pwVisible = false;
-  String? _errorZh;
+  String? _error;
 
   final _email = TextEditingController();
   final _code = TextEditingController();
@@ -90,17 +90,17 @@ class _AuthScreenState extends ConsumerState<AuthScreen>
   // ── 认证操作（逻辑不变）──────────────────────────────────────────
 
   Future<void> _sendCode() async {
-    setState(() { _loading = true; _errorZh = null; });
+    setState(() { _loading = true; _error = null; });
     try {
       await _api.sendCode(_email.text.trim());
       if (mounted) setState(() { _sent = true; _loading = false; });
     } on AuthApiException catch (e) {
-      if (mounted) setState(() { _errorZh = e.messageZh; _loading = false; });
+      if (mounted) setState(() { _error = widget.t.lang == AppLang.zh ? e.messageZh : e.messageEn; _loading = false; });
     }
   }
 
   Future<void> _doRegister() async {
-    setState(() { _loading = true; _errorZh = null; });
+    setState(() { _loading = true; _error = null; });
     try {
       final device = (await ref.read(deviceIdentityProvider).meta()).toJson();
       final tokens = await _api.register(
@@ -113,12 +113,12 @@ class _AuthScreenState extends ConsumerState<AuthScreen>
       await ref.read(authProvider.notifier).saveTokens(tokens);
       if (mounted) widget.onDone();
     } on AuthApiException catch (e) {
-      if (mounted) setState(() { _errorZh = e.messageZh; _loading = false; });
+      if (mounted) setState(() { _error = widget.t.lang == AppLang.zh ? e.messageZh : e.messageEn; _loading = false; });
     }
   }
 
   Future<void> _doLogin() async {
-    setState(() { _loading = true; _errorZh = null; });
+    setState(() { _loading = true; _error = null; });
     try {
       final device = (await ref.read(deviceIdentityProvider).meta()).toJson();
       final tokens = await _api.login(
@@ -132,7 +132,7 @@ class _AuthScreenState extends ConsumerState<AuthScreen>
       ref.read(deviceLimitProvider.notifier).state = tokens.deviceLimit;
       if (mounted) widget.onDone();
     } on AuthApiException catch (e) {
-      if (mounted) setState(() { _errorZh = e.messageZh; _loading = false; });
+      if (mounted) setState(() { _error = widget.t.lang == AppLang.zh ? e.messageZh : e.messageEn; _loading = false; });
     }
   }
 
@@ -167,7 +167,7 @@ class _AuthScreenState extends ConsumerState<AuthScreen>
         _mode = m;
         _step = 0;
         _sent = false;
-        _errorZh = null;
+        _error = null;
       });
 
   // ── UI ──────────────────────────────────────────────────────
@@ -278,7 +278,7 @@ class _AuthScreenState extends ConsumerState<AuthScreen>
         child: Column(children: [
           _segTabs(c, t),
           const SizedBox(height: 22),
-          if (_errorZh != null) ...[
+          if (_error != null) ...[
             Container(
               padding: const EdgeInsets.symmetric(horizontal: 14, vertical: 10),
               decoration: BoxDecoration(
@@ -289,7 +289,7 @@ class _AuthScreenState extends ConsumerState<AuthScreen>
               child: Row(children: [
                 Icon(PangolinIcons.x, size: 16, color: c.danger),
                 const SizedBox(width: 8),
-                Expanded(child: Text(_errorZh!, style: PangolinText.sm.copyWith(color: c.danger))),
+                Expanded(child: Text(_error!, style: PangolinText.sm.copyWith(color: c.danger))),
               ]),
             ),
             const SizedBox(height: 14),
@@ -457,7 +457,7 @@ class _AuthScreenState extends ConsumerState<AuthScreen>
               style: PangolinText.sm.copyWith(color: c.fg1, fontWeight: FontWeight.w600))),
           GestureDetector(
             onTap: () => setState(() => _step = 0),
-            child: Text(t.lang == AppLang.zh ? '改邮箱' : 'Change',
+            child: Text(t.lang.changeEmail,
                 style: PangolinText.caption.copyWith(color: c.accent, fontWeight: FontWeight.w600, fontSize: 13)),
           ),
         ]),

client/lib/widgets/server_tile.dart

@@ -44,7 +44,7 @@ class ServerTile extends StatelessWidget {
   Widget build(BuildContext context) {
     final c = context.pangolin;
     final down = node.isDown; // 节点不可用(agent 离线):置灰 + 「不可用」+ 禁选。
-    final unavail = lang == AppLang.zh ? '不可用' : 'Unavailable';
+    final unavail = lang.unavailable;
     return InkWell(
       onTap: down ? null : onTap,
       child: Opacity(

client/lib/widgets/update_dialog.dart

@@ -1,11 +1,13 @@
 // update_dialog.dart — 「发现新版本」更新提示弹窗。
 //
-// 只做「展示 + 引导下载」:点「下载更新」用 url_launcher 打开对应平台的下载直链
-// (浏览器下载),不做应用内静默安装/自动重启。force_update=true 时不可关闭
-// (无「稍后」按钮、点遮罩/返回也关不掉)。
-import 'package:flutter/material.dart';
-import 'package:url_launcher/url_launcher.dart';
+// 点「下载更新」走 App 内下载安装(core/update/app_updater.dart,带进度框,不再开
+// 浏览器);Android 装 APK、Windows 跑安装包、macOS 解压提示拖入、iOS 降级外链。
+// force_update=true 时不可关闭(无「稍后」按钮、点遮罩/返回也关不掉)。
+import 'dart:async';
 
+import 'package:flutter/material.dart';
+
+import '../core/update/app_updater.dart';
 import '../l10n/app_text.dart';
 import '../pangolin_theme.dart';
 import '../state/update_provider.dart';
@@ -63,15 +65,12 @@ class _UpdateDialog extends StatelessWidget {
             child: Text(t.updateLater, style: PangolinText.sm.copyWith(color: c.fg2, fontWeight: FontWeight.w600)),
           ),
         TextButton(
-          onPressed: () async {
-            final url = platformDownloadUrl(info.downloadUrls);
-            if (url != null && url.isNotEmpty) {
-              final uri = Uri.parse(url);
-              if (await canLaunchUrl(uri)) {
-                await launchUrl(uri, mode: LaunchMode.externalApplication);
-              }
-            }
-            if (context.mounted) Navigator.of(context).pop();
+          onPressed: () {
+            // 先关本弹窗,用 Navigator 自身 context(关后仍挂载)启动 App 内下载
+            // (它自带进度框)。
+            final nav = Navigator.of(context);
+            nav.pop();
+            unawaited(startInAppUpdate(nav.context, t, info));
           },
           child: Text(t.updateDownload, style: PangolinText.sm.copyWith(color: c.accent, fontWeight: FontWeight.w700)),
         ),

client/pubspec.yaml

@@ -20,7 +20,8 @@ dependencies:
   flutter_secure_storage: ^9.2.2  # JWT token 安全存储 + 稳定 device_id 持久化
   shared_preferences: ^2.5.5
   package_info_plus: ^9.0.1
-  url_launcher: ^6.3.0        # 打开外部链接(用户中心 SSO 免登 / 更新下载页)
+  url_launcher: ^6.3.0        # 打开外部链接(用户中心 SSO 免登 / iOS 更新降级外链)
+  open_filex: ^4.5.0          # App 内更新:下载后拉起系统安装器(Android APK / 打开文件)
   device_info_plus: ^11.2.0  # 设备名/平台(「我的设备」上报)
   uuid: ^4.5.1               # 客户端生成稳定 device_id (UUID v4)
   launch_at_startup: ^0.5.1

scripts/ci/compile-usercenter.sh

@@ -0,0 +1,22 @@
+#!/usr/bin/env bash
+# compile-usercenter.sh — build the Next.js 用户中心 (web/usercenter) as a static
+# export (output: web/usercenter/out/). Deployed to Cloudflare Pages
+# (project pangolin-usercenter, 自定义域 app.yanmeiai.com) by deploy-usercenter.sh.
+#
+# ⚠️ 必须以「真实 API」模式构建:NEXT_PUBLIC_API_MODE=http。否则 lib/api/client.ts
+# 默认落到 mock(内存假数据),部署上去登录/订阅全是演示数据。API 域名是公开信息
+# (非密钥,经 CF Tunnel 暴露的控制面),故此处内置默认值;可用同名 env 覆盖。
+#
+# 由 .gitea/workflows/deploy-site.yml 在 ubuntu runner 上调用,从 repo 根运行。
+set -euo pipefail
+
+export NEXT_PUBLIC_API_MODE="${NEXT_PUBLIC_API_MODE:-http}"
+export NEXT_PUBLIC_API_DOMAINS="${NEXT_PUBLIC_API_DOMAINS:-https://api.yanmeiai.com}"
+echo "==> compile-usercenter: API_MODE=${NEXT_PUBLIC_API_MODE} API_DOMAINS=${NEXT_PUBLIC_API_DOMAINS}"
+
+cd web/usercenter
+npm ci
+npm run build
+
+echo "==> compile-usercenter: done — out/ contents:"
+ls -lh out/ | head

scripts/ci/deploy-usercenter.sh

@@ -0,0 +1,28 @@
+#!/usr/bin/env bash
+# deploy-usercenter.sh — 部署 Next.js 用户中心 (web/usercenter/out/) 到 Cloudflare
+# Pages(项目 pangolin-usercenter,自定义域 app.yanmeiai.com)。纯静态导出,全程
+# HTTPS,不落 VPS,与节点 :443(sing-box)无冲突。
+#
+# 需环境变量:
+#   CLOUDFLARE_API_TOKEN   带 Account > Cloudflare Pages > Edit 权限的 CF token
+#   CLOUDFLARE_ACCOUNT_ID  CF 账户 ID
+# 由 compile-usercenter.sh 先产出 web/usercenter/out/;从 repo 根调用。
+set -euo pipefail
+
+if [ ! -d web/usercenter/out ]; then
+  echo "==> deploy-usercenter: web/usercenter/out/ 不存在 — 拒绝部署" >&2
+  exit 1
+fi
+if ! find web/usercenter/out -mindepth 1 -print -quit | grep -q .; then
+  echo "==> deploy-usercenter: web/usercenter/out/ 为空 — 拒绝部署" >&2
+  exit 1
+fi
+
+: "${CLOUDFLARE_API_TOKEN:?deploy-usercenter: CLOUDFLARE_API_TOKEN 未设(需带 Pages:Edit)}"
+: "${CLOUDFLARE_ACCOUNT_ID:?deploy-usercenter: CLOUDFLARE_ACCOUNT_ID 未设}"
+
+echo "==> deploy-usercenter: wrangler pages deploy → project pangolin-usercenter (branch main)"
+npx --yes wrangler@4 pages deploy web/usercenter/out \
+  --project-name=pangolin-usercenter --branch=main --commit-dirty=true
+
+echo "==> deploy-usercenter: done"