refactor: 简化 i18n 数据逻辑和协议处理

- toggle.js: 从 localStorage (app-lang) 读取语言状态，与 BaseI18n 共享数据源
- shared-actions.js: 移除过时的 status/success 协议兼容层，改为警告日志
- shared-i18n-base.js: ready() 方法改为纯 Promise 风格，移除回调参数支持
- popup.js: 简化 i18n ready 调用逻辑

Author: ChuwuYo

background.js

@@ -319,7 +319,7 @@ const updateHeaderRulesInternal = async (
 				? backgroundI18n.t("auto_switch_skip_duplicate", { language })
 				: backgroundI18n.t("language_already_set", { language });
 			sendBackgroundLog(logMessage, "info");
-			return { status: "unchanged", language };
+			return { changed: false, language };
 		}
 
 		sendBackgroundLog(
@@ -375,7 +375,7 @@ const updateHeaderRulesInternal = async (
 			`${backgroundI18n.t("rules_updated_successfully", { language })}${isAutoSwitch ? ` (${backgroundI18n.t("auto_switch")})` : ""} (${duration}ms)`,
 			"success",
 		);
-		return { status: "success", language };
+		return { changed: true, language };
 	} catch (error) {
 		sendBackgroundLog(
 			`${backgroundI18n.t("update_rules_failed")}: ${error.message}`,
@@ -591,17 +591,17 @@ const handleUpdateRulesRequest = async (request) => {
 
 		const result = await updateHeaderRules(language);
 		sendBackgroundLog(
-			`${backgroundI18n.t("rules_update_completed")}: ${result.status}`,
+			`${backgroundI18n.t("rules_update_completed")}: ${result.changed ? "changed" : "unchanged"}`,
 			"info",
 		);
 
 		await chrome.storage.local.set({ currentLanguage: language });
 
 		// 只在状态发生变化时才通知UI更新
-		if (result.status === "success") {
+		if (result.changed) {
 			notifyPopupUIUpdate(autoSwitchEnabled, result.language);
 		}
-		return { status: result.status, language: result.language };
+		return { changed: result.changed, language: result.language };
 	} catch (error) {
 		// 记录错误日志并重新抛出，让上层统一处理
 		const errorMessage = error?.message || String(error);
@@ -1079,7 +1079,7 @@ chrome.tabs.onUpdated.addListener(async (_tabId, changeInfo, tab) => {
 					"info",
 				);
 				const result = await updateHeaderRules(targetLanguage, 0, true);
-				if (result.status === "success") {
+				if (result.changed) {
 					notifyPopupUIUpdate(true, targetLanguage);
 				}
 			} else {
@@ -1100,7 +1100,7 @@ chrome.tabs.onUpdated.addListener(async (_tabId, changeInfo, tab) => {
 						"info",
 					);
 					const result = await updateHeaderRules(fallbackLanguage, 0, true);
-					if (result.status === "success") {
+					if (result.changed) {
 						notifyPopupUIUpdate(true, fallbackLanguage);
 					}
 				}

docs/TODO.md

@@ -1,8 +1,8 @@
 ## 🔧 TODO
 
-#### 性能优化
+### 性能优化
 
-## 1. 全局变量耦合严重
+## [] 1. 全局变量耦合严重
 **文件**: `shared-i18n-base.js`, `domain-rules-manager.js`, `popup.js` 等
 
 组件通过全局变量通信（如 `domainManagerI18n`, `popupI18n`, `sendDebugLog`），而不是通过依赖注入或参数传递：
@@ -16,14 +16,18 @@ ensureI18n() {
 }
 ```
 
-## 2. 重复的语言状态管理
+**验证结果**: ✅ 问题存在于 [`domain-rules-manager.js:22`](domain-rules-manager.js:22)，使用全局变量 `domainManagerI18n`
+
+## [x] 2. 重复的语言状态管理
 **文件**: `toggle.js` 和 `shared-i18n-base.js`
 
 两个独立的语言管理逻辑：
 - `LanguageToggle` 类自己管理 `currentLang` 和 localStorage
 - `BaseI18n` 也管理 `currentLang` 和 localStorage
 
-## 3. 环境判断方式过时
+**验证结果**: ✅ 问题存在于 [`toggle.js:7`](toggle.js:7) 和 [`shared-i18n-base.js:23`](shared/shared-i18n-base.js:23)，两者都管理 `currentLang`
+
+## [] 3. 环境判断方式过时
 **文件**: `shared-i18n-base.js`
 
 ```73:91:shared-i18n-base.js
@@ -36,7 +40,9 @@ _detectLanguage() {
 
 现代做法应该分离 Service Worker 和浏览器环境的代码，而不是用标志位判断。
 
-## 4. 动态脚本加载方式过时
+**验证结果**: ✅ 问题存在于 [`shared-i18n-base.js:75`](shared/shared-i18n-base.js:75)
+
+## [] 4. 动态脚本加载方式过时
 **文件**: `shared-i18n-base.js`
 
 ```138:160:shared-i18n-base.js
@@ -52,7 +58,9 @@ _loadScriptForBrowser(src) {
 
 应该使用 ES Module 动态导入 `import()` 替代创建 script 标签。
 
-## 5. 协议兼容层说明历史债务
+**验证结果**: ✅ 问题存在于 [`shared-i18n-base.js:138-160`](shared/shared-i18n-base.js:138)
+
+## [x] 5. 协议兼容层说明历史债务
 **文件**: `shared-actions.js`
 
 ```27:51:shared-actions.js
@@ -65,7 +73,9 @@ if (response?.status === "success") return response;
 if (response?.success === true) return response;
 ```
 
-## 6. i18n 回调风格设计过时
+**验证结果**: ✅ 问题存在于 [`shared-actions.js:27-51`](shared/shared-actions.js:27)
+
+## [x] 6. i18n 回调风格设计过时
 **文件**: `shared-i18n-base.js`
 
 ```207:213:shared-i18n-base.js
@@ -80,7 +90,9 @@ ready(callback) {
 
 现代 JS 直接使用 Promise，不需要回调风格。
 
-## 7. 单例模式过度使用
+**验证结果**: ✅ 问题存在于 [`shared-i18n-base.js:207-213`](shared/shared-i18n-base.js:207)
+
+## [] 7. 单例模式过度使用
 **文件**: `domain-rules-manager.js`, `background.js`
 
 ```279:281:domain-rules-manager.js
@@ -89,15 +101,22 @@ const domainRulesManager = new DomainRulesManager();
 
 单例难以测试，且导出的是实例而非类，限制了灵活性。
 
-## 8. 状态分散管理
+**验证结果**: ✅ 问题存在于 [`domain-rules-manager.js:281`](domain-rules-manager.js:281)
+
+## [] 8. 状态分散管理
 全局状态分散在各处：
 - `background.js`: `autoSwitchEnabled`, `isInitialized`
 - `popup.js`: `updateCheckInProgress`, `updateCheckController`
 - `domain-rules-manager.js`: `domainCache`
 
 没有统一的状态管理方案。
 
-#### i18n 系统重构（待完成）
+**验证结果**: ✅ 问题存在于:
+- [`background.js:69-70`](background.js:69) - `autoSwitchEnabled`, `isInitialized`
+- [`popup.js:9-10`](popup.js:9) - `updateCheckInProgress`, `updateCheckController`
+- [`domain-rules-manager.js:10`](domain-rules-manager.js:10) - `domainCache`
+
+### i18n 系统重构（待完成）
 - [ ] **统一 i18n 实例命名**：将 `debugI18n`/`popupI18n`/`detectI18n`/`backgroundI18n` 统一为 `appI18n`
   - **原因**：简化 `getFallbackTranslation` 中的实例检测逻辑，去除多层 typeof 判断
   - **涉及文件**：

popup.js

@@ -964,13 +964,9 @@ const debouncedUIUpdate = (updateFn, delay = 16) => {
 // --- 扩展初始化 ---
 document.addEventListener("DOMContentLoaded", async () => {
 	// 等待翻译系统加载完成
-	await new Promise((resolve) => {
-		if (popupI18n.isReady) {
-			resolve();
-		} else {
-			popupI18n.ready(resolve);
-		}
-	});
+	if (!popupI18n.isReady) {
+		await popupI18n.ready();
+	}
 
 	// 获取DOM元素
 	const languageSelect = getEl("languageSelect");

shared/md5.js

@@ -184,7 +184,7 @@ function md5(string) {
 	}
 
 	function str2rstrUTF8(input) {
-        // 使用 decodeURIComponent 替代已弃用的 unescape
+		// 使用 decodeURIComponent 替代已弃用的 unescape
 		return decodeURIComponent(encodeURIComponent(input));
 	}
 

shared/shared-actions.js

@@ -38,16 +38,8 @@ const requestBackground = async (type, payload = {}) => {
 		throw err;
 	}
 
-	// 兼容旧协议：status/success 字段混用，统一转换为返回或抛错
-	if (response?.status === "success") return response;
-	if (response?.status === "error") {
-		throw new Error(response?.message || "Background error");
-	}
-	if (response?.success === true) return response;
-	if (response?.success === false) {
-		throw new Error(response?.error || "Background error");
-	}
-
+	// 协议格式不符：返回原始响应但记警告
+	console.warn("requestBackground: unexpected response format", response);
 	return response;
 };
 

shared/shared-i18n-base.js

@@ -201,15 +201,10 @@ class BaseI18n {
 
 	/**
 	 * 允许外部代码等待翻译系统准备就绪。
-	 * @param {Function} [callback] - (可选) 准备就绪后执行的回调函数。
 	 * @returns {Promise<void>}
 	 */
-	ready(callback) {
-		const promise = this._initPromise || this.init();
-		if (typeof callback === "function") {
-			promise.then(callback);
-		}
-		return promise;
+	ready() {
+		return this._initPromise || this.init();
 	}
 
 	/**

toggle.js

@@ -3,8 +3,10 @@
 // 语言切换功能（复用共享工具函数）
 class LanguageToggle {
 	constructor() {
-		// 通过 window 对象访问全局函数（因为 toggle.js 是 module）
-		this.currentLang = window.detectCurrentLanguage();
+		// 语言状态从 localStorage (app-lang) 读取，与 BaseI18n 共享同一数据源
+		this.currentLang =
+			localStorage.getItem("app-lang") ||
+			(navigator.language.startsWith("zh") ? "zh" : "en");
 	}
 
 	/**