docs(zh): 补全剩余文档的简体中文翻译，并新增 AI 翻译提示

sites/docs/lib/_sass/_site.scss

@@ -54,3 +54,6 @@
 // Must be imported last to ensure that
 // the print overrides take priority over earlier defined styles.
 @use 'base/print-overrides';
+
+// flutter.cn
+@use 'flutter-cn/alert-ai-translation';

sites/docs/lib/_sass/components/_alert.scss

@@ -65,4 +65,4 @@ aside.alert {
     border-color: var(--site-alert-error-color);
     --alert-title-color: var(--site-alert-error-color);
   }
-}
+}

sites/docs/lib/_sass/flutter-cn/_alert-ai-translation.scss

@@ -0,0 +1,59 @@
+aside.alert.alert-ai-translation {
+  display: flex;
+  align-items: flex-start;
+  gap: 0.75rem;
+  padding: 0.85rem 1rem;
+  border-left: solid 0.25rem transparent;
+  border-image: linear-gradient(160deg,
+      var(--site-alert-info-color),
+      var(--site-alert-tip-color)) 1;
+  background:
+    linear-gradient(120deg,
+      oklch(from var(--site-alert-info-color) l c h / 0.08),
+      oklch(from var(--site-alert-tip-color) l c h / 0.05));
+
+  .ai-translation-glyph {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    flex: none;
+    inline-size: 1.6rem;
+    block-size: 1.6rem;
+    border-radius: 50%;
+    background: linear-gradient(150deg,
+        var(--site-alert-info-color),
+        var(--site-alert-tip-color));
+
+    .material-symbols {
+      font-size: 0.9rem;
+      line-height: 1;
+      color: #fff;
+      user-select: none;
+    }
+  }
+
+  .ai-translation-body {
+    min-inline-size: 0;
+  }
+
+  .ai-translation-title {
+    margin: 0 0 0.15rem;
+    font-family: var(--site-ui-fontFamily);
+    font-size: 0.9rem;
+    font-weight: 500;
+    -webkit-font-smoothing: antialiased;
+    color: var(--site-base-fgColor);
+  }
+
+  .ai-translation-desc {
+    margin: 0;
+    font-size: 0.9rem;
+    line-height: 1.6;
+    color: var(--site-base-fgColor);
+
+    a {
+      font-weight: 500;
+      white-space: nowrap;
+    }
+  }
+}

sites/docs/lib/src/components/common/flutter_cn/ai_translation_notice.dart

@@ -0,0 +1,76 @@
+import 'package:jaspr/dom.dart';
+import 'package:jaspr/jaspr.dart';
+import 'package:jaspr_content/jaspr_content.dart';
+
+import '../../../utils/page_source_info.dart';
+
+/// A notice displayed at the top of pages whose Chinese translation
+/// was produced (in whole or in part) by AI.
+///
+/// It invites readers to review the translation and
+/// contribute improvements on GitHub.
+final class AiTranslationNotice extends StatelessComponent {
+  const AiTranslationNotice({super.key});
+
+  @override
+  Component build(BuildContext context) {
+    final page = context.page;
+    final sourceInfo = page.sourceInfo;
+    final issueUrl = sourceInfo.issueUrl;
+    final pageSource = sourceInfo.sourceUrl;
+
+    return aside(
+      classes: 'alert alert-ai-translation',
+      attributes: {'role': 'note', 'data-nosnippet': 'true'},
+      [
+        const span(
+          classes: 'ai-translation-glyph',
+          attributes: {'aria-hidden': 'true', 'translate': 'no'},
+          [
+            span(classes: 'material-symbols', [.text('auto_awesome')]),
+          ],
+        ),
+        div(classes: 'ai-translation-body', [
+          const p(classes: 'ai-translation-title', [
+            .text('本页内容由 AI 翻译'),
+          ]),
+          p(classes: 'ai-translation-desc', [
+            const .text('本页译文在人工校订的基础上借助 AI 完成。'),
+            const .text('如果你发现任何不准确或可以改进的地方，'),
+            if (pageSource case final pageSource?)
+              a(
+                href: pageSource,
+                target: Target.blank,
+                attributes: {
+                  'rel': 'noopener',
+                  'title': '在 GitHub 上查看并校阅本页译文',
+                },
+                [const .text('欢迎到 GitHub 参与校阅')],
+              )
+            else
+              const a(
+                href: 'https://github.com/cfug/flutter.cn',
+                target: Target.blank,
+                attributes: {
+                  'rel': 'noopener',
+                  'title': '在 GitHub 上参与文档校阅',
+                },
+                [.text('欢迎到 GitHub 参与校阅')],
+              ),
+            const .text(' 或者 '),
+            a(
+              href: issueUrl,
+              attributes: {
+                'title': '为本页面内容提出建议',
+                'target': '_blank',
+                'rel': 'noopener',
+              },
+              [.text(pageSource == null ? '为本页面内容提出建议' : '为本页面内容提出建议')],
+            ),
+            const .text('，与大家一起把它完善得更好。'),
+          ]),
+        ]),
+      ],
+    );
+  }
+}

sites/docs/lib/src/layouts/doc_layout.dart

@@ -6,6 +6,7 @@ import 'package:jaspr/dom.dart';
 import 'package:jaspr/jaspr.dart';
 import 'package:jaspr_content/jaspr_content.dart';
 
+import '../components/common/flutter_cn/ai_translation_notice.dart';
 import '../components/common/page_header.dart';
 import '../components/common/prev_next.dart';
 import '../components/layout/banner.dart';
@@ -52,6 +53,10 @@ class DocLayout extends FlutterDocsLayout {
 
     final pageTitle = pageData['title'] as String;
     final pageDescription = (pageData['description'] as String?)?.trim();
+    final aiTranslated =
+        (pageData['ai-translated'] as bool?) ??
+        (pageData['aiTranslated'] as bool?) ??
+        false;
     final showBanner =
         (pageData['showBanner'] as bool?) ??
         (siteData['showBanner'] as bool?) ??
@@ -96,6 +101,9 @@ class DocLayout extends FlutterDocsLayout {
                     (pageData['showBreadcrumbs'] as bool? ?? true),
               ),
 
+              /// flutter.cn
+              if (aiTranslated) const AiTranslationNotice(),
+
               child,
 
               PrevNext(

sites/docs/src/_includes/docs/add-to-app/android-initial-route-cached-engine.md

@@ -1,17 +1,28 @@
 The concept of an initial route is available when configuring a
 `FlutterActivity` or a `FlutterFragment` with a new `FlutterEngine`.
+
+在配置带有新 `FlutterEngine` 的 `FlutterActivity` 或 `FlutterFragment` 时，
+可以使用 initial route（初始路由）这一概念。
+
 However, `FlutterActivity` and `FlutterFragment` don't offer the
 concept of an initial route when using a cached engine.
+
+但是，在使用缓存 engine 时，`FlutterActivity` 和 `FlutterFragment` 不提供 initial route 这一概念。
+
 This is because a cached engine is expected to already be
 running Dart code, which means it's too late to configure the
 initial route.
 
+这是因为缓存 engine 预期已经在运行 Dart 代码，这意味着配置 initial route 为时已晚。
+
 Developers that would like their cached engine to begin
 with a custom initial route can configure their cached
 `FlutterEngine` to use a custom initial route just before
 executing the Dart entrypoint. The following example
 demonstrates the use of an initial route with a cached engine:
 
+希望缓存 engine 以自定义 initial route 开始的开发者，可以在执行 Dart entrypoint 之前，为缓存的 `FlutterEngine` 配置自定义 initial route。以下示例演示了如何在缓存 engine 中使用 initial route：
+
 <Tabs key="android-language">
 <Tab name="Kotlin">
 
@@ -67,9 +78,16 @@ By setting the initial route of the navigation channel, the associated
 `FlutterEngine` displays the desired route upon initial execution of the
 `runApp()` Dart function.
 
+通过设置 navigation channel 的 initial route，
+关联的 `FlutterEngine` 会在首次执行 `runApp()` Dart 函数时显示所需路由。
+
 Changing the initial route property of the navigation channel
 after the initial execution of `runApp()` has no effect.
 Developers who would like to use the same `FlutterEngine`
 between different `Activity`s and `Fragment`s and switch
 the route between those displays need to set up a method channel and
 explicitly instruct their Dart code to change `Navigator` routes.
+
+在首次执行 `runApp()` 之后更改 navigation channel 的 initial route 属性不会生效。
+如果开发者希望在不同的 `Activity` 和 `Fragment` 之间复用同一个 `FlutterEngine`，
+并在这些界面之间切换路由，则需要设置 method channel，并显式指示 Dart 代码更改 `Navigator` 路由。