refactor: migrate account pages to client i18n (#7515)

* refactor: migrate account pages to client i18n

* fix(i18n): handle client namespace load failures

* fix(i18n): harden client resource loading

* refactor: remove promotion feature

* refactor(i18n): remove redundant modal fallback

* refactor: preserve app shell for client pages

* refactor: avoid duplicate user initialization

* fix(i18n): qualify permission labels

* refactor: stabilize client-only app shell

* fix(i18n): load fallback resources before rendering

* feat(i18n): make language switching atomic

* test(i18n): cover browser storage fallbacks

* fix(i18n): scope language cookie and renew expiry

* feat(i18n): forward client language with requests

* fix(i18n): isolate share language preferences

* fix(i18n): restore language after account navigation

* fix(i18n): initialize pages with system language

* refactor(i18n): use cookie for initial locale

* refactor(i18n): narrow default language sync

* perf(i18n): preload account route before navigation

* perf(i18n): avoid blocking on business namespaces

* i18n

* doc

Author: c121914yu

.agents/design/common/client-i18n-csr-migration.md

@@ -17,6 +17,7 @@ on:
       - 'eslint.config.mjs'
       - '.npmrc'
       - '.github/workflows/test-fastgpt.yaml'
+      - '.forgejo/workflows/test-fastgpt.yaml'
   workflow_dispatch:
 
     # Only one build per PR branch at a time
@@ -170,9 +171,40 @@ jobs:
             projects/app/coverage/coverage-final.json
             projects/app/coverage/coverage-summary.json
 
+  test-web:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.pull_request.head.ref || github.ref }}
+          repository: ${{ github.event.pull_request.head.repo.full_name ||
+            github.repository }}
+
+      - uses: pnpm/action-setup@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '24'
+          cache: 'pnpm'
+
+      - name: 'Install Deps'
+        run: pnpm install --frozen-lockfile
+
+      - name: 'Test Web'
+        run: pnpm --filter=@fastgpt/web test
+
+      - name: 'Upload Coverage (Web)'
+        if: always() && hashFiles('packages/web/coverage/coverage-summary.json') != ''
+        uses: forgejo/upload-artifact@v4
+        with:
+          name: coverage-web
+          path: |
+            packages/web/coverage/coverage-final.json
+            packages/web/coverage/coverage-summary.json
+
   report-coverage:
     runs-on: ubuntu-latest
-    needs: [test-global, test-service, test-app]
+    needs: [test-global, test-service, test-web, test-app]
     if: ${{ always() }}
     permissions:
       contents: read
@@ -191,6 +223,13 @@ jobs:
           path: coverage-artifacts/coverage-service
         continue-on-error: true
 
+      - name: 'Download Coverage Artifacts'
+        uses: forgejo/download-artifact@v4
+        with:
+          name: coverage-web
+          path: coverage-artifacts/coverage-web
+        continue-on-error: true
+
       - name: 'Download Coverage Artifacts'
         uses: forgejo/download-artifact@v4
         with:
@@ -208,6 +247,7 @@ jobs:
           const packages = [
             { name: 'Global', dir: 'coverage-global' },
             { name: 'Service', dir: 'coverage-service' },
+            { name: 'Web', dir: 'coverage-web' },
             { name: 'App', dir: 'coverage-app' }
           ];
           const formatPct = (value) => {

.forgejo/workflows/test-fastgpt.yaml

@@ -37,6 +37,7 @@ jobs:
     outputs:
       run_global: ${{ steps.scope.outputs.run_global }}
       run_service: ${{ steps.scope.outputs.run_service }}
+      run_web: ${{ steps.scope.outputs.run_web }}
       run_app: ${{ steps.scope.outputs.run_app }}
       should_report: ${{ steps.scope.outputs.should_report }}
 
@@ -46,17 +47,20 @@ jobs:
         uses: actions/github-script@v7
         with:
           script: |
-            const setOutputs = ({ global, service, app }) => {
-              const shouldReport = global || service || app;
+            const setOutputs = ({ global, service, web, app }) => {
+              const shouldReport = global || service || web || app;
               core.setOutput('run_global', global ? 'true' : 'false');
               core.setOutput('run_service', service ? 'true' : 'false');
+              core.setOutput('run_web', web ? 'true' : 'false');
               core.setOutput('run_app', app ? 'true' : 'false');
               core.setOutput('should_report', shouldReport ? 'true' : 'false');
-              core.info(`Test scopes selected: global=${global}, service=${service}, app=${app}`);
+              core.info(
+                `Test scopes selected: global=${global}, service=${service}, web=${web}, app=${app}`
+              );
             };
 
             if (context.eventName !== 'pull_request') {
-              setOutputs({ global: true, service: true, app: true });
+              setOutputs({ global: true, service: true, web: true, app: true });
               return;
             }
 
@@ -86,6 +90,7 @@ jobs:
 
             const runGlobal = affectsAll || hasPath(['packages/global']);
             const runService = affectsAll || hasPath(['packages/global', 'packages/service', 'sdk']);
+            const runWeb = affectsAll || hasPath(['packages/global', 'packages/web']);
             const runApp = affectsAll || hasPath([
               'packages/global',
               'packages/service',
@@ -94,7 +99,7 @@ jobs:
               'sdk'
             ]);
 
-            setOutputs({ global: runGlobal, service: runService, app: runApp });
+            setOutputs({ global: runGlobal, service: runService, web: runWeb, app: runApp });
 
   test-global:
     needs: detect-changes
@@ -197,9 +202,42 @@ jobs:
             projects/app/coverage/coverage-final.json
             projects/app/coverage/coverage-summary.json
 
+  test-web:
+    needs: detect-changes
+    if: ${{ needs.detect-changes.outputs.run_web == 'true' }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.pull_request.head.ref || github.ref }}
+          repository: ${{ github.event.pull_request.head.repo.full_name ||
+            github.repository }}
+
+      - uses: pnpm/action-setup@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '24'
+          cache: 'pnpm'
+
+      - name: 'Install Deps'
+        run: pnpm install --frozen-lockfile
+
+      - name: 'Test Web'
+        run: pnpm --filter=@fastgpt/web test
+
+      - name: 'Upload Coverage (Web)'
+        if: always() && hashFiles('packages/web/coverage/coverage-summary.json') != ''
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-web
+          path: |
+            packages/web/coverage/coverage-final.json
+            packages/web/coverage/coverage-summary.json
+
   report-coverage:
     runs-on: ubuntu-latest
-    needs: [detect-changes, test-global, test-service, test-app]
+    needs: [detect-changes, test-global, test-service, test-web, test-app]
     if: ${{ always() && needs.detect-changes.outputs.should_report == 'true' }}
     permissions:
       contents: read
@@ -225,6 +263,7 @@ jobs:
             const packages = [
               { name: 'Global', dir: 'coverage-global' },
               { name: 'Service', dir: 'coverage-service' },
+              { name: 'Web', dir: 'coverage-web' },
               { name: 'App', dir: 'coverage-app' }
             ];
 

.github/workflows/test-fastgpt.yaml

@@ -58,7 +58,7 @@ docker compose up -d
   可以使用[Docker](https://doc.fastgpt.io/self-host/deploy/docker)快速部署，也可以使用[Sealos Cloud](https://doc.fastgpt.io/self-host/deploy/sealos) 来一键部署FastGPT。
 
 - **商业版**  
-  如果你需要更完整的功能，或深度的服务支持，可以选择我们的[商业版](https://doc.fastgpt.io/guide/version/commercial)。我们除了提供完整的软件外，还提供相应的场景落地辅导，具体可提交[商业咨询](https://fael3z0zfze.feishu.cn/share/base/form/shrcnjJWtKqjOI9NbQTzhNyzljc?prefill_S=git&hide_S=1)
+  如果你需要更完整的功能，或深度的服务支持，可以选择我们的[商业版](https://doc.fastgpt.io/guide/version/commercial)。我们除了提供完整的软件外，还提供相应的场景落地辅导，具体可提交[商业咨询](https://fastgpt.cn/zh/contact?utm_source=github&utm_medium=referral&utm_campaign=github_home&utm_content=commercial_consultation)
 
 ## 💡 核心功能
 

README.md

@@ -58,7 +58,7 @@ If you encounter any issues, you can [view the complete Docker deployment tutori
   You can quickly deploy using [Docker](https://doc.fastgpt.io/self-host/deploy/docker) or use [Sealos Cloud](https://doc.fastgpt.io/self-host/deploy/sealos) to deploy FastGPT with one click.
 
 - **Commercial Version**  
-  If you need more complete features or in-depth service support, you can choose our [Commercial Version](https://doc.fastgpt.io/guide/version/commercial). In addition to providing complete software, we also offer implementation guidance for specific scenarios. You can submit a [commercial consultation](https://fael3z0zfze.feishu.cn/share/base/form/shrcnjJWtKqjOI9NbQTzhNyzljc?prefill_S=git&hide_S=1?prefill_S=git&hide_S=1).
+  If you need more complete features or in-depth service support, you can choose our [Commercial Version](https://doc.fastgpt.io/guide/version/commercial). In addition to providing complete software, we also offer implementation guidance for specific scenarios. You can submit a [commercial consultation](https://fastgpt.cn/en/contact?utm_source=github&utm_medium=referral&utm_campaign=github_home&utm_content=commercial_consultation).
 
 ## 💡 Core Features
 

README_en.md

@@ -58,7 +58,7 @@ Jika Anda menghadapi masalah, Anda dapat [melihat tutorial penyebaran Docker len
   Anda dapat menyebarkan dengan cepat menggunakan [Docker](https://doc.fastgpt.io/self-host/deploy/docker) atau menggunakan [Sealos Cloud](https://doc.fastgpt.io/self-host/deploy/sealos) untuk menyebarkan FastGPT dengan satu klik.
 
 - **Versi Komersial**  
-  Jika Anda membutuhkan fitur yang lebih lengkap atau dukungan layanan mendalam, Anda dapat memilih [Versi Komersial](https://doc.fastgpt.io/guide/version/commercial). Selain menyediakan perangkat lunak lengkap, kami juga menyediakan panduan implementasi untuk skenario tertentu. Anda dapat mengirimkan [konsultasi komersial](https://fael3z0zfze.feishu.cn/share/base/form/shrcnjJWtKqjOI9NbQTzhNyzljc?prefill_S=git&hide_S=1).
+  Jika Anda membutuhkan fitur yang lebih lengkap atau dukungan layanan mendalam, Anda dapat memilih [Versi Komersial](https://doc.fastgpt.io/guide/version/commercial). Selain menyediakan perangkat lunak lengkap, kami juga menyediakan panduan implementasi untuk skenario tertentu. Anda dapat mengirimkan [konsultasi komersial](https://fastgpt.cn/en/contact?utm_source=github&utm_medium=referral&utm_campaign=github_home&utm_content=commercial_consultation).
 
 ## 💡 Fitur Inti
 

README_id.md

@@ -58,7 +58,7 @@ docker compose up -d
   [Docker](https://doc.fastgpt.io/self-host/deploy/docker) で素早くデプロイするか、[Sealos Cloud](https://doc.fastgpt.io/self-host/deploy/sealos) でワンクリックデプロイが可能です。
 
 - **商用版**  
-  より完全な機能や深いサービスサポートが必要な場合は、[商用版](https://doc.fastgpt.io/guide/version/commercial)をお選びいただけます。完全なソフトウェアの提供に加え、シナリオに応じた導入ガイダンスも提供しています。[商用相談](https://fael3z0zfze.feishu.cn/share/base/form/shrcnjJWtKqjOI9NbQTzhNyzljc?prefill_S=git&hide_S=1)からお問い合わせください。
+  より完全な機能や深いサービスサポートが必要な場合は、[商用版](https://doc.fastgpt.io/guide/version/commercial)をお選びいただけます。完全なソフトウェアの提供に加え、シナリオに応じた導入ガイダンスも提供しています。[商用相談](https://fastgpt.cn/en/contact?utm_source=github&utm_medium=referral&utm_campaign=github_home&utm_content=commercial_consultation)からお問い合わせください。
 
 ## 💡 コア機能
 

README_ja.md

@@ -58,7 +58,7 @@ docker compose up -d
   คุณสามารถติดตั้งได้อย่างรวดเร็วโดยใช้ [Docker](https://doc.fastgpt.io/self-host/deploy/docker) หรือใช้ [Sealos Cloud](https://doc.fastgpt.io/self-host/deploy/sealos) เพื่อติดตั้ง FastGPT ด้วยคลิกเดียว
 
 - **เวอร์ชันพาณิชย์**  
-  หากคุณต้องการคุณสมบัติที่สมบูรณ์มากขึ้นหรือการสนับสนุนบริการเชิงลึก คุณสามารถเลือก [เวอร์ชันพาณิชย์](https://doc.fastgpt.io/guide/version/commercial) นอกจากการให้ซอฟต์แวร์ที่สมบูรณ์ เรายังให้คำแนะนำการนำไปใช้สำหรับสถานการณ์เฉพาะ คุณสามารถส่ง[ปรึกษาธุรกิจ](https://fael3z0zfze.feishu.cn/share/base/form/shrcnjJWtKqjOI9NbQTzhNyzljc?prefill_S=git&hide_S=1)
+  หากคุณต้องการคุณสมบัติที่สมบูรณ์มากขึ้นหรือการสนับสนุนบริการเชิงลึก คุณสามารถเลือก [เวอร์ชันพาณิชย์](https://doc.fastgpt.io/guide/version/commercial) นอกจากการให้ซอฟต์แวร์ที่สมบูรณ์ เรายังให้คำแนะนำการนำไปใช้สำหรับสถานการณ์เฉพาะ คุณสามารถส่ง[ปรึกษาธุรกิจ](https://fastgpt.cn/en/contact?utm_source=github&utm_medium=referral&utm_campaign=github_home&utm_content=commercial_consultation)
 
 ## 💡 คุณสมบัติหลัก
 

README_th.md

@@ -58,7 +58,7 @@ Nếu bạn gặp vấn đề, bạn có thể [xem hướng dẫn triển khai
   Bạn có thể triển khai nhanh chóng bằng [Docker](https://doc.fastgpt.io/self-host/deploy/docker) hoặc sử dụng [Sealos Cloud](https://doc.fastgpt.io/self-host/deploy/sealos) để triển khai FastGPT bằng một cú nhấp chuột.
 
 - **Phiên Bản Thương Mại**  
-  Nếu bạn cần các tính năng đầy đủ hơn hoặc hỗ trợ dịch vụ chuyên sâu, bạn có thể chọn [Phiên Bản Thương Mại](https://doc.fastgpt.io/guide/version/commercial). Ngoài việc cung cấp phần mềm đầy đủ, chúng tôi còn cung cấp hướng dẫn triển khai cho các kịch bản cụ thể. Bạn có thể gửi [tư vấn thương mại](https://fael3z0zfze.feishu.cn/share/base/form/shrcnjJWtKqjOI9NbQTzhNyzljc?prefill_S=git&hide_S=1).
+  Nếu bạn cần các tính năng đầy đủ hơn hoặc hỗ trợ dịch vụ chuyên sâu, bạn có thể chọn [Phiên Bản Thương Mại](https://doc.fastgpt.io/guide/version/commercial). Ngoài việc cung cấp phần mềm đầy đủ, chúng tôi còn cung cấp hướng dẫn triển khai cho các kịch bản cụ thể. Bạn có thể gửi [tư vấn thương mại](https://fastgpt.cn/en/contact?utm_source=github&utm_medium=referral&utm_campaign=github_home&utm_content=commercial_consultation).
 
 ## 💡 Tính Năng Cốt Lõi
 

README_vi.md

@@ -61,7 +61,7 @@ import FastGPTLink from '@/components/docs/linkFastGPT'; #FastGPT跳转链接组
 {
   "title": "FastGPT Docs",
   "root": true,
-  "pages": ["[Handshake][联系我们](https://fael3z0zfze.feishu.cn/share/base/form/shrcnjJWtKqjOI9NbQTzhNyzljc?prefill_S=doc&hide_S=1)","index","guide","development","FAQ","shopping_cart","community","hello"], #"hello"原本没有，此外，这里的顺序就是最后文档的展示顺序，现在"hello"文档将会在`introduction`的最后展示
+  "pages": ["[Handshake][联系我们](https://fastgpt.cn/zh/contact?utm_source=docs&utm_medium=referral&utm_campaign=docs_navigation&utm_content=business_consultation)","index","guide","development","FAQ","shopping_cart","community","hello"], #"hello"原本没有，此外，这里的顺序就是最后文档的展示顺序，现在"hello"文档将会在`introduction`的最后展示
   "order": 1
 }
 ```