refactor: remove LocaleSwitcher component and update locale handling

- Removed LocaleSwitcher from NavUser, SiteHeader, and WorkbenchHeader components.
- Updated tests to reflect the removal of LocaleSwitcher.
- Changed default locale from "en-US" to "zh-CN" in i18n configuration.
- Refactored locale resolution logic to read configured locale without relying on browser language detection.
- Updated AgentDesk SDK to support language configuration from public API.
- Cleaned up unused auth options fetching in the auth API.

config/config.example.yaml

@@ -1,3 +1,5 @@
+language: zh-CN
+
 server:
   port: 8083
   cors:

docker/agent-desk-lancedb.yaml

@@ -1,3 +1,5 @@
+language: zh-CN
+
 server:
   port: 8083
   cors:

docker/agent-desk-sqlite-lancedb.yaml

@@ -1,3 +1,5 @@
+language: zh-CN
+
 server:
   port: 8083
   cors:

docker/agent-desk.yaml

@@ -1,3 +1,5 @@
+language: zh-CN
+
 server:
   port: 8083
   cors:

internal/bootstrap/init.go

@@ -4,6 +4,7 @@ import (
 	"agent-desk/internal/ai/rag/vectordb"
 	"agent-desk/internal/oidcclient"
 	"agent-desk/internal/pkg/config"
+	"agent-desk/internal/pkg/i18nx"
 	"agent-desk/internal/pkg/logx"
 	"agent-desk/internal/services/cronx"
 	"agent-desk/internal/wxwork"
@@ -20,6 +21,7 @@ func Init(configPath string) error {
 		return err
 	}
 	config.SetCurrent(cfg)
+	i18nx.SetDefaultLocale(cfg.LanguageOrDefault())
 
 	logx.Init(logx.Config{
 		Level:     cfg.Logger.Level,

internal/bootstrap/routes.go

@@ -11,7 +11,6 @@ import (
 func registerApiAuthRoutes(group *gin.RouterGroup) {
 	group.POST("/login", api.Login)
 	group.POST("/logout", api.Logout)
-	group.GET("/options", api.AuthOptions)
 	group.GET("/profile", api.Profile)
 	group.GET("/wxwork_callback", api.WxWorkCallback)
 	group.POST("/wxwork_exchange", api.WxWorkExchange)

internal/bootstrap/server.go

@@ -26,6 +26,7 @@ import (
 
 func NewServer() (*gin.Engine, error) {
 	cfg := config.Current()
+	i18nx.SetDefaultLocale(cfg.LanguageOrDefault())
 
 	gin.SetMode(gin.ReleaseMode)
 	printBanner()
@@ -156,6 +157,7 @@ func addRouter(app *gin.Engine) {
 
 	apiGroup := app.Group("/api")
 	apiGroup.GET("/health", api.Health)
+	apiGroup.GET("/config", api.PublicConfig)
 	registerApiAuthRoutes(apiGroup.Group("/auth"))
 	registerApiChannelRoutes(apiGroup.Group("/channel"))
 	registerApiCustomerRoutes(apiGroup.Group("/customer"))

internal/bootstrap/server_route_test.go

@@ -32,6 +32,7 @@ func TestNewServerRegistersGinRoutes(t *testing.T) {
 
 	expected := []string{
 		http.MethodPost + " /api/auth/login",
+		http.MethodGet + " /api/config",
 		http.MethodGet + " /api/health",
 		http.MethodGet + " /api/auth/oidc_login",
 		http.MethodGet + " /api/auth/oidc_callback",
@@ -93,8 +94,9 @@ func TestNewServerHealthEndpointIsPublic(t *testing.T) {
 	}
 }
 
-func TestNewServerExposesPublicAuthOptions(t *testing.T) {
+func TestNewServerExposesPublicConfig(t *testing.T) {
 	config.SetCurrent(&config.Config{
+		Language: "zh-CN",
 		Storage: config.StorageConfig{
 			Local: config.LocalStorageConfig{
 				Root:    "storage",
@@ -116,7 +118,7 @@ func TestNewServerExposesPublicAuthOptions(t *testing.T) {
 	}
 
 	rec := httptest.NewRecorder()
-	app.ServeHTTP(rec, httptest.NewRequest(http.MethodGet, "/api/auth/options", nil))
+	app.ServeHTTP(rec, httptest.NewRequest(http.MethodGet, "/api/config", nil))
 
 	if rec.Code != http.StatusOK {
 		t.Fatalf("status=%d want %d", rec.Code, http.StatusOK)
@@ -125,8 +127,9 @@ func TestNewServerExposesPublicAuthOptions(t *testing.T) {
 	var body struct {
 		Success bool `json:"success"`
 		Data    struct {
-			WxWorkEnabled bool `json:"wxworkEnabled"`
+			Language      string `json:"language"`
-			OIDCEnabled   bool `json:"oidcEnabled"`
+			WxWorkEnabled bool   `json:"wxworkEnabled"`
+			OIDCEnabled   bool   `json:"oidcEnabled"`
 		} `json:"data"`
 	}
 	if err := json.Unmarshal(rec.Body.Bytes(), &body); err != nil {
@@ -135,6 +138,9 @@ func TestNewServerExposesPublicAuthOptions(t *testing.T) {
 	if !body.Success {
 		t.Fatalf("success=false, body=%s", rec.Body.String())
 	}
+	if body.Data.Language != "zh-CN" {
+		t.Fatalf("language=%q want zh-CN", body.Data.Language)
+	}
 	if !body.Data.WxWorkEnabled {
 		t.Fatalf("wxworkEnabled=false want true")
 	}
@@ -146,6 +152,29 @@ func TestNewServerExposesPublicAuthOptions(t *testing.T) {
 	}
 }
 
+func TestNewServerDoesNotExposeLegacyAuthOptions(t *testing.T) {
+	config.SetCurrent(&config.Config{
+		Storage: config.StorageConfig{
+			Local: config.LocalStorageConfig{
+				Root:    "storage",
+				BaseURL: "/storage",
+			},
+		},
+	})
+
+	app, err := NewServer()
+	if err != nil {
+		t.Fatalf("NewServer() error = %v", err)
+	}
+
+	rec := httptest.NewRecorder()
+	app.ServeHTTP(rec, httptest.NewRequest(http.MethodGet, "/api/auth/options", nil))
+
+	if rec.Code != http.StatusNotFound {
+		t.Fatalf("status=%d want %d, body=%s", rec.Code, http.StatusNotFound, rec.Body.String())
+	}
+}
+
 func TestNewServerSeparatesAPIStaticAndSPA(t *testing.T) {
 	config.SetCurrent(&config.Config{
 		Storage: config.StorageConfig{

internal/handlers/api/auth_handler.go

@@ -30,9 +30,10 @@ func Login(ctx *gin.Context) {
 	httpx.WriteJSON(ctx, ret)
 }
 
-func AuthOptions(ctx *gin.Context) {
+func PublicConfig(ctx *gin.Context) {
 	cfg := config.Current()
-	httpx.WriteJSON(ctx, &response.AuthOptionsResponse{
+	httpx.WriteJSON(ctx, &response.PublicConfigResponse{
+		Language:      cfg.LanguageOrDefault(),
 		WxWorkEnabled: cfg.WxWork.Enabled,
 		OIDCEnabled:   cfg.OIDC.Enabled,
 	})

internal/pkg/config/config.go

@@ -9,6 +9,7 @@ import (
 )
 
 type Config struct {
+	Language        string                `yaml:"language"`
 	Server          ServerConfig          `yaml:"server"`
 	DB              DBConfig              `yaml:"db"`
 	Logger          LoggerConfig          `yaml:"logger"`
@@ -21,6 +22,17 @@ type Config struct {
 	CustomerSession CustomerSessionConfig `yaml:"customerSession"`
 }
 
+func (c Config) LanguageOrDefault() string {
+	switch strings.ToLower(strings.TrimSpace(c.Language)) {
+	case "zh", "zh-cn", "zh_cn", "zh-hans":
+		return "zh-CN"
+	case "en", "en-us", "en_us":
+		return "en-US"
+	default:
+		return "zh-CN"
+	}
+}
+
 type WxWorkNotifyConfig struct {
 	Enabled                bool    `yaml:"enabled"`
 	ToUsers                []int64 `yaml:"toUsers"`

internal/pkg/dto/response/auth_response.go

@@ -19,7 +19,8 @@ type LoginResponse struct {
 	Roles       []string          `json:"roles"`
 }
 
-type AuthOptionsResponse struct {
+type PublicConfigResponse struct {
-	WxWorkEnabled bool `json:"wxworkEnabled"`
+	Language      string `json:"language"`
-	OIDCEnabled   bool `json:"oidcEnabled"`
+	WxWorkEnabled bool   `json:"wxworkEnabled"`
+	OIDCEnabled   bool   `json:"oidcEnabled"`
 }

internal/pkg/errorsx/errors.go

@@ -86,7 +86,7 @@ func (e *I18nError) Error() string {
 	if e == nil {
 		return ""
 	}
-	return e.Message(i18nx.LocaleZhCN)
+	return e.Message(i18nx.DefaultLocale)
 }
 
 func (e *I18nError) Unwrap() error {

internal/pkg/i18nx/error.go

@@ -20,7 +20,7 @@ func (e *Error) Error() string {
 	if e == nil {
 		return ""
 	}
-	return e.Message(LocaleZhCN)
+	return e.Message(DefaultLocale)
 }
 
 func (e *Error) Message(locale string) string {

internal/pkg/i18nx/i18nx_test.go

@@ -9,27 +9,24 @@ import (
 )
 
 func TestNormalizeLocale(t *testing.T) {
-	t.Parallel()
-
 	tests := []struct {
 		name string
 		in   string
 		want string
 	}{
-		{name: "default for blank", in: "", want: LocaleEnUS},
+		{name: "default for blank", in: "", want: LocaleZhCN},
 		{name: "exact chinese", in: "zh-CN", want: LocaleZhCN},
 		{name: "underscore chinese", in: "zh_CN", want: LocaleZhCN},
 		{name: "short chinese", in: "zh", want: LocaleZhCN},
 		{name: "exact english", in: "en-US", want: LocaleEnUS},
 		{name: "underscore english", in: "en_US", want: LocaleEnUS},
 		{name: "short english", in: "en", want: LocaleEnUS},
-		{name: "unsupported falls back", in: "fr-FR", want: LocaleEnUS},
+		{name: "unsupported falls back", in: "fr-FR", want: LocaleZhCN},
 	}
 
 	for _, tt := range tests {
 		tt := tt
 		t.Run(tt.name, func(t *testing.T) {
-			t.Parallel()
 			if got := NormalizeLocale(tt.in); got != tt.want {
 				t.Fatalf("NormalizeLocale(%q) = %q, want %q", tt.in, got, tt.want)
 			}
@@ -37,36 +34,33 @@ func TestNormalizeLocale(t *testing.T) {
 	}
 }
 
-func TestResolveLocaleFromHeaders(t *testing.T) {
+func TestResolveLocaleUsesDefaultLocale(t *testing.T) {
-	t.Parallel()
+	SetDefaultLocale(LocaleZhCN)
-
 	req := httptest.NewRequest(http.MethodGet, "/api/dashboard/user/list", nil)
 	req.Header.Set("Accept-Language", "fr-FR, en-US;q=0.9, zh-CN;q=0.8")
 
-	if got := ResolveRequestLocale(req); got != LocaleEnUS {
+	if got := ResolveRequestLocale(req); got != LocaleZhCN {
-		t.Fatalf("ResolveRequestLocale() = %q, want %q", got, LocaleEnUS)
+		t.Fatalf("ResolveRequestLocale() = %q, want %q", got, LocaleZhCN)
 	}
 }
 
-func TestResolveLocalePrefersXLocale(t *testing.T) {
+func TestResolveLocaleIgnoresRequestLocaleHeaders(t *testing.T) {
-	t.Parallel()
+	SetDefaultLocale(LocaleZhCN)
-
 	req := httptest.NewRequest(http.MethodGet, "/api/dashboard/user/list", nil)
 	req.Header.Set("X-Locale", "en-US")
 	req.Header.Set("Accept-Language", "zh-CN")
 
-	if got := ResolveRequestLocale(req); got != LocaleEnUS {
+	if got := ResolveRequestLocale(req); got != LocaleZhCN {
-		t.Fatalf("ResolveRequestLocale() = %q, want %q", got, LocaleEnUS)
+		t.Fatalf("ResolveRequestLocale() = %q, want %q", got, LocaleZhCN)
 	}
 }
 
-func TestTranslateFallsBackToEnglish(t *testing.T) {
+func TestTranslateUsesConfiguredDefaultForUnsupportedLocale(t *testing.T) {
-	t.Parallel()
+	SetDefaultLocale(LocaleZhCN)
-
 	if got := TLocale(LocaleEnUS, "error.auth.expired"); got != "Your session has expired. Please sign in again." {
 		t.Fatalf("english translation = %q", got)
 	}
-	if got := TLocale("fr-FR", "error.auth.expired"); got != "Your session has expired. Please sign in again." {
+	if got := TLocale("fr-FR", "error.auth.expired"); got != "未登录或登录已过期" {
 		t.Fatalf("fallback translation = %q", got)
 	}
 }
@@ -143,6 +137,7 @@ func TestGetfFallsBackToKey(t *testing.T) {
 }
 
 func TestMiddlewareStoresLocale(t *testing.T) {
+	SetDefaultLocale(LocaleZhCN)
 	gin.SetMode(gin.TestMode)
 	router := gin.New()
 	router.Use(Middleware())
@@ -159,7 +154,7 @@ func TestMiddlewareStoresLocale(t *testing.T) {
 	if recorder.Code != http.StatusOK {
 		t.Fatalf("status = %d, want %d", recorder.Code, http.StatusOK)
 	}
-	if got := recorder.Body.String(); got != LocaleEnUS {
+	if got := recorder.Body.String(); got != LocaleZhCN {
-		t.Fatalf("middleware locale = %q, want %q", got, LocaleEnUS)
+		t.Fatalf("middleware locale = %q, want %q", got, LocaleZhCN)
 	}
 }

internal/pkg/i18nx/middleware.go

@@ -5,13 +5,11 @@ import (
 	"strings"
 
 	"github.com/gin-gonic/gin"
-	"golang.org/x/text/language"
 )
 
 const (
-	LocaleZhCN    = "zh-CN"
+	LocaleZhCN = "zh-CN"
-	LocaleEnUS    = "en-US"
+	LocaleEnUS = "en-US"
-	DefaultLocale = LocaleEnUS
 )
 
 var supportedLocales = map[string]string{
@@ -24,6 +22,12 @@ var supportedLocales = map[string]string{
 	"en_us":   LocaleEnUS,
 }
 
+var DefaultLocale = LocaleZhCN
+
+func SetDefaultLocale(locale string) {
+	DefaultLocale = NormalizeLocale(locale)
+}
+
 func NormalizeLocale(value string) string {
 	key := strings.ToLower(strings.TrimSpace(value))
 	if key == "" {
@@ -35,19 +39,7 @@ func NormalizeLocale(value string) string {
 	return DefaultLocale
 }
 
-func ResolveRequestLocale(req *http.Request) string {
+func ResolveRequestLocale(_ *http.Request) string {
-	if req == nil {
-		return DefaultLocale
-	}
-	if locale := normalizeSupportedLocale(req.Header.Get("X-Locale")); locale != "" {
-		return locale
-	}
-	if locale := resolveAcceptLanguage(req.Header.Get("Accept-Language")); locale != "" {
-		return locale
-	}
-	if locale := normalizeSupportedLocale(req.URL.Query().Get("locale")); locale != "" {
-		return locale
-	}
 	return DefaultLocale
 }
 
@@ -57,31 +49,3 @@ func Middleware() gin.HandlerFunc {
 		ctx.Next()
 	}
 }
-
-func normalizeSupportedLocale(value string) string {
-	key := strings.ToLower(strings.TrimSpace(value))
-	if key == "" {
-		return ""
-	}
-	if locale, ok := supportedLocales[key]; ok {
-		return locale
-	}
-	return ""
-}
-
-func resolveAcceptLanguage(value string) string {
-	tags, _, err := language.ParseAcceptLanguage(value)
-	if err != nil {
-		return ""
-	}
-	for _, tag := range tags {
-		if locale := normalizeSupportedLocale(tag.String()); locale != "" {
-			return locale
-		}
-		base, _ := tag.Base()
-		if locale := normalizeSupportedLocale(base.String()); locale != "" {
-			return locale
-		}
-	}
-	return ""
-}

web/app/dashboard/login/page.tsx

@@ -1,4 +1,3 @@
-import { LocaleSwitcher } from "@/components/locale-switcher"
 import { LoginForm } from "@/components/login-form"
 import { Suspense } from "react"
 
@@ -6,9 +5,6 @@ export default function LoginPage() {
   return (
     <div className="flex min-h-svh flex-col items-center justify-center bg-muted p-6 md:p-10">
       <div className="w-full max-w-sm md:max-w-4xl">
-        <div className="mb-4 flex justify-end">
-          <LocaleSwitcher />
-        </div>
         <Suspense fallback={<div className="min-h-96" />}>
           <LoginForm />
         </Suspense>

web/components/legal-document-page.tsx

@@ -3,7 +3,6 @@
 import Image from "next/image"
 import Link from "next/link"
 
-import { LocaleSwitcher } from "@/components/locale-switcher"
 import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card"
 import { useAppLocale, useI18n } from "@/i18n/provider"
 import enUSMessages from "@/messages/en-US.json"
@@ -39,7 +38,7 @@ export function LegalDocumentPage({ type }: { type: LegalPageType }) {
   return (
     <main className="min-h-svh bg-muted px-6 py-8 md:px-10">
       <div className="mx-auto flex w-full max-w-4xl flex-col gap-6">
-        <header className="flex items-center justify-between gap-4">
+        <header className="flex items-center gap-4">
           <div className="flex items-center gap-2 font-medium">
             <Image
               src="/images/logo.svg"
@@ -51,7 +50,6 @@ export function LegalDocumentPage({ type }: { type: LegalPageType }) {
             />
             <span>{t("app.brand")}</span>
           </div>
-          <LocaleSwitcher />
         </header>
 
         <Card className="bg-card/95">

web/components/locale-switcher.tsx

@@ -1,42 +0,0 @@
-"use client"
-
-import { LanguagesIcon } from "lucide-react"
-
-import { useAppLocale, useI18n } from "@/i18n/provider"
-import { SUPPORTED_LOCALES, type AppLocale } from "@/i18n/config"
-import { Button } from "@/components/ui/button"
-import {
-  DropdownMenu,
-  DropdownMenuContent,
-  DropdownMenuRadioGroup,
-  DropdownMenuRadioItem,
-  DropdownMenuTrigger,
-} from "@/components/ui/dropdown-menu"
-
-export function LocaleSwitcher() {
-  const t = useI18n()
-  const { locale, setLocale } = useAppLocale()
-
-  return (
-    <DropdownMenu>
-      <DropdownMenuTrigger
-        render={<Button variant="outline" size="sm" />}
-        aria-label={t("common.language")}
-      >
-        <LanguagesIcon />
-      </DropdownMenuTrigger>
-      <DropdownMenuContent align="end" className="w-40 min-w-40">
-        <DropdownMenuRadioGroup
-          value={locale}
-          onValueChange={(value) => setLocale(value as AppLocale)}
-        >
-          {SUPPORTED_LOCALES.map((option) => (
-            <DropdownMenuRadioItem key={option} value={option}>
-              {t(`locale.${option}`)}
-            </DropdownMenuRadioItem>
-          ))}
-        </DropdownMenuRadioGroup>
-      </DropdownMenuContent>
-    </DropdownMenu>
-  )
-}

web/components/login-form.tsx

@@ -7,7 +7,8 @@ import { startTransition, useEffect, useState } from "react"
 import { toast } from "sonner"
 
 import { useAuth } from "@/components/auth-provider"
-import { fetchAuthOptions, loginWithPassword, type AuthOptions } from "@/lib/api/auth"
+import { loginWithPassword } from "@/lib/api/auth"
+import { fetchPublicConfig, type PublicConfig } from "@/lib/api/config"
 import { useI18n } from "@/i18n/provider"
 import { cn } from "@/lib/utils"
 import { Button } from "@/components/ui/button"
@@ -40,15 +41,15 @@ export function LoginForm({
   const { session } = useAuth()
   const [isPending, setIsPending] = useState(false)
   const [isWxWorkEnv, setIsWxWorkEnv] = useState(false)
-  const [authOptions, setAuthOptions] = useState<AuthOptions | null>(null)
+  const [publicConfig, setPublicConfig] = useState<PublicConfig | null>(null)
-  const [authOptionsError, setAuthOptionsError] = useState<string | null>(null)
+  const [publicConfigError, setPublicConfigError] = useState<string | null>(null)
   const nextPath = searchParams.get("next")
   const wxworkError = searchParams.get("wxworkError")
   const oidcError = searchParams.get("oidcError")
   const redirectPath =
     nextPath && nextPath.startsWith("/") ? nextPath : "/dashboard"
   const enabledProviderCount =
-    Number(authOptions?.wxworkEnabled) + Number(authOptions?.oidcEnabled)
+    Number(publicConfig?.wxworkEnabled) + Number(publicConfig?.oidcEnabled)
 
   useEffect(() => {
     if (session) {
@@ -75,17 +76,17 @@ export function LoginForm({
   useEffect(() => {
     let cancelled = false
 
-    void fetchAuthOptions()
+    void fetchPublicConfig()
       .then((options) => {
         if (!cancelled) {
-          setAuthOptions(options)
+          setPublicConfig(options)
-          setAuthOptionsError(null)
+          setPublicConfigError(null)
         }
       })
       .catch((error) => {
         if (!cancelled) {
-          setAuthOptions(null)
+          setPublicConfig(null)
-          setAuthOptionsError(error instanceof Error ? error.message : "")
+          setPublicConfigError(error instanceof Error ? error.message : "")
         }
       })
 
@@ -115,7 +116,7 @@ export function LoginForm({
     }
   }
 
-  if (authOptionsError) {
+  if (publicConfigError) {
     return (
       <div className={cn("flex flex-col gap-6", className)} {...props}>
         <Card className="overflow-hidden p-0">
@@ -124,7 +125,7 @@ export function LoginForm({
             <div className="space-y-1">
               <h1 className="text-lg font-semibold">{t("auth.optionsLoadFailed")}</h1>
               <p className="text-sm text-muted-foreground">
-                {authOptionsError || t("api.requestFailed")}
+                {publicConfigError || t("api.requestFailed")}
               </p>
             </div>
           </CardContent>
@@ -133,7 +134,7 @@ export function LoginForm({
     )
   }
 
-  if (!authOptions) {
+  if (!publicConfig) {
     return (
       <div className={cn("flex flex-col gap-6", className)} {...props}>
         <Card className="overflow-hidden p-0">
@@ -206,7 +207,7 @@ export function LoginForm({
                       enabledProviderCount === 1 ? "grid-cols-1" : "grid-cols-2"
                     )}
                   >
-                    {authOptions.wxworkEnabled ? (
+                    {publicConfig.wxworkEnabled ? (
                       <Button
                         type="button"
                         variant="outline"
@@ -228,7 +229,7 @@ export function LoginForm({
                         <span>{t("auth.wxworkSignIn")}</span>
                       </Button>
                     ) : null}
-                    {authOptions.oidcEnabled ? (
+                    {publicConfig.oidcEnabled ? (
                       <Button
                         type="button"
                         variant="outline"

web/components/nav-user.tsx

@@ -6,7 +6,6 @@ import { useState } from "react"
 import { useAuth } from "@/components/auth-provider"
 import { useI18n } from "@/i18n/provider"
 import { ChangePasswordDialog } from "@/components/change-password-dialog"
-import { LocaleSwitcher } from "@/components/locale-switcher"
 import { useNotifications } from "@/components/notification-provider"
 import { PaletteToggle } from "@/components/palette-toggle"
 import { ThemeToggle } from "@/components/theme-toggle"
@@ -104,7 +103,6 @@ export function NavUser({
                   {t("nav.preferences")}
                 </DropdownMenuLabel>
                 <div className="flex items-center gap-2 px-2 pb-2">
-                  <LocaleSwitcher />
                   <PaletteToggle />
                   <ThemeToggle />
                 </div>

web/components/site-header.test.mjs

@@ -5,10 +5,10 @@ import { describe, it } from "node:test";
 const source = await readFile(new URL("./site-header.tsx", import.meta.url), "utf8");
 
 describe("site header preferences", () => {
-  it("renders locale, palette, and theme controls in the dashboard header", () => {
+  it("renders palette and theme controls without a locale switcher", () => {
-    assert.match(source, /import \{ LocaleSwitcher \} from "@\/components\/locale-switcher"/);
+    assert.doesNotMatch(source, /LocaleSwitcher/);
     assert.match(source, /import \{ PaletteToggle \} from "@\/components\/palette-toggle"/);
     assert.match(source, /import \{ ThemeToggle \} from "@\/components\/theme-toggle"/);
-    assert.match(source, /<LocaleSwitcher \/>[\s\S]*<PaletteToggle \/>[\s\S]*<ThemeToggle \/>/);
+    assert.match(source, /<PaletteToggle \/>[\s\S]*<ThemeToggle \/>/);
   });
 });

web/components/site-header.tsx

@@ -3,7 +3,6 @@
 import { useEffect, useRef } from "react"
 import { usePathname } from "next/navigation"
 
-import { LocaleSwitcher } from "@/components/locale-switcher"
 import { PaletteToggle } from "@/components/palette-toggle"
 import { RealtimeConnectionStatus } from "@/components/realtime-connection-status"
 import { ThemeToggle } from "@/components/theme-toggle"
@@ -78,7 +77,6 @@ export function SiteHeader() {
           </div>
         </div>
         <div className="flex shrink-0 items-center justify-end gap-2">
-          <LocaleSwitcher />
           <PaletteToggle />
           <ThemeToggle />
         </div>

web/components/workbench-header.tsx

@@ -5,7 +5,6 @@ import { useRouter } from "next/navigation"
 import { useState } from "react"
 
 import { ChangePasswordDialog } from "@/components/change-password-dialog"
-import { LocaleSwitcher } from "@/components/locale-switcher"
 import { PaletteToggle } from "@/components/palette-toggle"
 import { RealtimeConnectionStatus } from "@/components/realtime-connection-status"
 import { ThemeToggle } from "@/components/theme-toggle"
@@ -36,7 +35,6 @@ export function WorkbenchHeader() {
           <div className="hidden sm:block">
             <RealtimeConnectionStatus status={realtimeStatus} compact />
           </div>
-          <LocaleSwitcher />
           <PaletteToggle />
           <ThemeToggle />
           <WorkbenchUserMenu />

web/i18n/config.test.mjs

@@ -25,7 +25,7 @@ async function loadConfig() {
 test("normalizes supported locale aliases", async () => {
   const { DEFAULT_LOCALE, normalizeLocale } = await loadConfig()
 
-  assert.equal(DEFAULT_LOCALE, "en-US")
+  assert.equal(DEFAULT_LOCALE, "zh-CN")
   assert.equal(normalizeLocale("zh-CN"), "zh-CN")
   assert.equal(normalizeLocale("zh_CN"), "zh-CN")
   assert.equal(normalizeLocale("zh"), "zh-CN")
@@ -35,26 +35,11 @@ test("normalizes supported locale aliases", async () => {
   assert.equal(normalizeLocale("fr-FR"), DEFAULT_LOCALE)
 })
 
-test("resolves browser locale from stored value before navigator languages", async () => {
+test("reads the configured locale without browser language detection", async () => {
-  const { resolveBrowserLocale } = await loadConfig()
+  const { configureLocale, readStoredLocale } = await loadConfig()
 
-  assert.equal(
+  assert.equal(readStoredLocale(), "zh-CN")
-    resolveBrowserLocale({
+
-      storedLocale: "en-US",
+  configureLocale("en-US")
-      navigatorLanguages: ["zh-CN"],
+  assert.equal(readStoredLocale(), "en-US")
-    }),
-    "en-US"
-  )
-})
-
-test("falls back through navigator languages", async () => {
-  const { resolveBrowserLocale } = await loadConfig()
-
-  assert.equal(
-    resolveBrowserLocale({
-      storedLocale: "",
-      navigatorLanguages: ["fr-FR", "en"],
-    }),
-    "en-US"
-  )
 })

web/i18n/config.ts

@@ -1,8 +1,7 @@
 export const SUPPORTED_LOCALES = ["zh-CN", "en-US"] as const
 export type AppLocale = (typeof SUPPORTED_LOCALES)[number]
 
-export const DEFAULT_LOCALE: AppLocale = "en-US"
+export const DEFAULT_LOCALE: AppLocale = "zh-CN"
-export const LOCALE_STORAGE_KEY = "cs_ai_agent_locale"
 
 const LOCALE_ALIASES: Record<string, AppLocale> = {
   zh: "zh-CN",
@@ -37,40 +36,13 @@ export function isSupportedLocale(
   return SUPPORTED_LOCALES.includes(value as AppLocale)
 }
 
-export function resolveBrowserLocale({
+let configuredLocale: AppLocale = DEFAULT_LOCALE
-  storedLocale,
-  navigatorLanguages,
-}: {
-  storedLocale?: string | null
-  navigatorLanguages?: readonly string[] | null
-}): AppLocale {
-  if (isSupportedLocale(storedLocale)) {
-    return storedLocale
-  }
-
-  for (const locale of navigatorLanguages ?? []) {
-    const normalized = normalizeSupportedLocale(locale)
-    if (normalized) {
-      return normalized
-    }
-  }
-
-  return DEFAULT_LOCALE
-}
 
 export function readStoredLocale(): AppLocale {
-  if (typeof window === "undefined") {
+  return configuredLocale
-    return DEFAULT_LOCALE
-  }
-  return resolveBrowserLocale({
-    storedLocale: window.localStorage.getItem(LOCALE_STORAGE_KEY),
-    navigatorLanguages: window.navigator.languages,
-  })
 }
 
-export function writeStoredLocale(locale: AppLocale) {
+export function configureLocale(locale: string | null | undefined): AppLocale {
-  if (typeof window === "undefined") {
+  configuredLocale = normalizeLocale(locale)
-    return
+  return configuredLocale
-  }
-  window.localStorage.setItem(LOCALE_STORAGE_KEY, locale)
 }

web/i18n/provider.tsx

@@ -12,10 +12,10 @@ import {
 import {
   DEFAULT_LOCALE,
   type AppLocale,
-  readStoredLocale,
+  configureLocale,
-  writeStoredLocale,
 } from "@/i18n/config"
 import { translateMessage } from "@/i18n/messages"
+import { fetchPublicConfig } from "@/lib/api/config"
 
 type LocaleContextValue = {
   locale: AppLocale
@@ -34,11 +34,24 @@ export function AppI18nProvider({ children }: { children: ReactNode }) {
   const [isLocaleReady, setIsLocaleReady] = useState(false)
 
   useEffect(() => {
-    const storedLocale = readStoredLocale()
+    let cancelled = false
-    setLocaleState(storedLocale)
+
-    document.documentElement.lang = storedLocale
+    fetchPublicConfig()
-    document.title = translateMessage(storedLocale, "app.metadataTitle")
+      .then((config) => configureLocale(config.language))
-    setIsLocaleReady(true)
+      .catch(() => configureLocale(DEFAULT_LOCALE))
+      .then((configuredLocale) => {
+        if (cancelled) {
+          return
+        }
+        setLocaleState(configuredLocale)
+        document.documentElement.lang = configuredLocale
+        document.title = translateMessage(configuredLocale, "app.metadataTitle")
+        setIsLocaleReady(true)
+      })
+
+    return () => {
+      cancelled = true
+    }
   }, [])
 
   useEffect(() => {
@@ -49,12 +62,7 @@ export function AppI18nProvider({ children }: { children: ReactNode }) {
     () => ({
       locale,
       t: (key, values) => translateMessage(locale, key, values),
-      setLocale: (nextLocale) => {
+      setLocale: () => {},
-        setLocaleState(nextLocale)
-        writeStoredLocale(nextLocale)
-        document.documentElement.lang = nextLocale
-        document.title = translateMessage(nextLocale, "app.metadataTitle")
-      },
     }),
     [locale]
   )

web/lib/api/auth.ts

@@ -6,17 +6,6 @@ export type LoginRequest = {
   password: string
 }
 
-export type AuthOptions = {
-  wxworkEnabled: boolean
-  oidcEnabled: boolean
-}
-
-export async function fetchAuthOptions() {
-  return request<AuthOptions>("/api/auth/options", {
-    skipAuth: true,
-  })
-}
-
 export async function loginWithPassword(payload: LoginRequest) {
   const data = await request<AuthSession>("/api/auth/login", {
     method: "POST",

web/lib/api/client.ts

@@ -1,5 +1,4 @@
 import { expireSession, readSession } from "@/lib/auth"
-import { readStoredLocale } from "@/i18n/config"
 import { translateCurrentMessage } from "@/i18n/messages"
 
 const API_BASE_URL =
@@ -50,9 +49,6 @@ function buildRequestHeaders(headers: HeadersInit | undefined, skipAuth?: boolea
   ) {
     authHeaders.set("Content-Type", "application/json")
   }
-  const locale = readStoredLocale()
-  authHeaders.set("Accept-Language", locale)
-  authHeaders.set("X-Locale", locale)
   return authHeaders
 }
 

web/lib/sdk/agent-desk-sdk.test.mjs

@@ -50,14 +50,21 @@ async function loadSdk(config) {
   const sandbox = {
     URL,
     console,
-    fetch: async () => ({
+    fetch: async (url) => ({
-      json: async () => ({
+      json: async () =>
-        success: true,
+        String(url).endsWith("/api/config")
-        data: {
+          ? {
-          title: "\u5728\u7ebf\u5ba2\u670d",
+              success: true,
-          themeColor: "#2563eb",
+              data: {
-        },
+                language: "en-US",
-      }),
+              },
+            }
+          : {
+              success: true,
+              data: {
+                themeColor: "#2563eb",
+              },
+            },
     }),
     document: {
       body,
@@ -95,7 +102,7 @@ async function loadSdk(config) {
   return sandbox
 }
 
-async function flushPromises(count = 5) {
+async function flushPromises(count = 10) {
   for (let i = 0; i < count; i += 1) {
     await Promise.resolve()
   }
@@ -133,6 +140,7 @@ test("launcher click creates chat iframe with a freshly resolved userToken", asy
   )
 
   assert.ok(launcher)
+  assert.equal(launcher.children.at(-1)?.textContent, "Support")
 
   launcher.click()
   await flushPromises()

web/lib/sdk/agent-desk-sdk.ts

@@ -7,6 +7,7 @@ import type {
 type NormalizedAgentDeskConfig = AgentDeskConfig & {
   baseUrl: string
   channelId: string
+  language: string
   position: "left" | "right"
   themeColor: string
   width: string
@@ -38,22 +39,23 @@ type WidgetConfigResponse = {
   >>
 }
 
-function getWidgetLocale() {
+type PublicConfigResponse = {
-  try {
+  success?: boolean
-    const stored = window.localStorage?.getItem("cs_ai_agent_locale")
+  data?: {
-    const language = stored || document.documentElement.lang || window.navigator?.language || ""
+    language?: string
-    return language.toLowerCase().startsWith("zh") ? "zh-CN" : "en-US"
-  } catch {
-    return "en-US"
   }
 }
 
-function getDefaultWidgetTitle() {
+function normalizeWidgetLanguage(language: string | undefined) {
-  return getWidgetLocale() === "en-US" ? "Support" : "\u5728\u7ebf\u5ba2\u670d"
+  return String(language || "").toLowerCase().startsWith("en") ? "en-US" : "zh-CN"
 }
 
-function getLauncherText() {
+function getDefaultWidgetTitle(config?: NormalizedAgentDeskConfig | null) {
-  return getWidgetLocale() === "en-US" ? "Support" : "\u5ba2\u670d"
+  return normalizeWidgetLanguage(config?.language) === "en-US" ? "Support" : "\u5728\u7ebf\u5ba2\u670d"
+}
+
+function getLauncherText(config?: NormalizedAgentDeskConfig | null) {
+  return normalizeWidgetLanguage(config?.language) === "en-US" ? "Support" : "\u5ba2\u670d"
 }
 
 type FrameMessage =
@@ -65,8 +67,9 @@ type FrameMessage =
 (function () {
   const DEFAULT_CONFIG: Pick<
     NormalizedAgentDeskConfig,
-    "position" | "themeColor" | "width"
+    "language" | "position" | "themeColor" | "width"
   > = {
+    language: "zh-CN",
     position: "right",
     themeColor: "#0f6cbd",
     width: "380px",
@@ -103,6 +106,7 @@ type FrameMessage =
       delete merged.apiBaseUrl
     }
     merged.channelId = String(merged.channelId || "")
+    merged.language = normalizeWidgetLanguage(String(merged.language || "zh-CN"))
     if (merged.externalId) {
       merged.externalId = String(merged.externalId)
     }
@@ -209,6 +213,28 @@ type FrameMessage =
       .catch(() => config)
   }
 
+  function fetchPublicConfig(config: NormalizedAgentDeskConfig) {
+    const baseUrl = String(config.apiBaseUrl || config.baseUrl || "").replace(/\/$/, "")
+    if (!baseUrl || typeof fetch !== "function") {
+      return Promise.resolve(config)
+    }
+    return fetch(`${baseUrl}/api/config`, {
+      method: "GET",
+      cache: "no-store",
+    })
+      .then((response) => response.json() as Promise<PublicConfigResponse>)
+      .then((payload) => {
+        if (!payload || payload.success === false) {
+          return config
+        }
+        return normalizeConfig({
+          ...config,
+          language: payload.data?.language || config.language,
+        })
+      })
+      .catch(() => config)
+  }
+
   function clearFrameTimers() {
     if (state.frameHideTimer) {
       window.clearTimeout(state.frameHideTimer)
@@ -369,7 +395,7 @@ type FrameMessage =
 
     state.frame = document.createElement("iframe")
     state.frame.dataset.agentDeskWidget = "frame"
-    state.frame.title = state.config.title || getDefaultWidgetTitle()
+    state.frame.title = state.config.title || getDefaultWidgetTitle(state.config)
     state.frame.src = state.frameUrl.toString()
     applyFrameLayout()
     state.frame.style.display = "block"
@@ -435,7 +461,7 @@ type FrameMessage =
     const text = document.createElement("span")
     button.type = "button"
     button.dataset.agentDeskWidget = "launcher"
-    button.setAttribute("aria-label", config.title || getDefaultWidgetTitle())
+    button.setAttribute("aria-label", config.title || getDefaultWidgetTitle(config))
     icon.setAttribute("viewBox", "0 0 24 24")
     icon.setAttribute("fill", "none")
     icon.setAttribute("stroke", "currentColor")
@@ -451,7 +477,7 @@ type FrameMessage =
       path.setAttribute("d", pathData)
       icon.appendChild(path)
     })
-    text.textContent = getLauncherText()
+    text.textContent = getLauncherText(config)
     text.style.display = "block"
     button.style.position = "fixed"
     button.style.bottom = "24px"
@@ -504,15 +530,17 @@ type FrameMessage =
     }
 
     state.configLoading = true
-    fetchWidgetConfig(state.config).then((nextConfig) => {
+    fetchPublicConfig(state.config)
-      state.configLoading = false
+      .then((nextConfig) => fetchWidgetConfig(nextConfig))
-      state.config = normalizeConfig(nextConfig)
+      .then((nextConfig) => {
-      if (state.button?.parentNode) {
+        state.configLoading = false
-        state.button.parentNode.removeChild(state.button)
+        state.config = normalizeConfig(nextConfig)
-        state.button = null
+        if (state.button?.parentNode) {
-      }
+          state.button.parentNode.removeChild(state.button)
-      createLauncher()
+          state.button = null
-    })
+        }
+        createLauncher()
+      })
   }
 
   function destroy() {

web/lib/sdk/config-types.ts

@@ -11,6 +11,7 @@ export type AgentDeskConfig = {
   getUserToken?: () => string | Promise<string>
   title?: string
   subtitle?: string
+  language?: string
   position?: "left" | "right"
   themeColor?: string
   width?: string