develop (#68)

* docs(AGENTS.md): 添加 Git Commit 必须使用中文描述的规范
* docs: 更新测试数据生成器功能设计文档
* refactor: 删除死代码
* docs: 统一测试数据生成器文档，移除 SQL/TypeScript 导出，修复接口命名不一致
* feat: 实现测试数据生成器功能
* docs: 更新 README 和 AGENTS 文档，补充测试数据生成器模块说明

.github/copilot-instructions.md

@@ -0,0 +1,141 @@
+# Copilot 指令
+
+基于 WXT 框架的浏览器扩展项目（React 19 + TypeScript），为开发者和测试人员提供效率工具：时间戳转换、存储清理、JWT 解析、JSON 工具、二维码、Base64、Markdown 等。
+
+## 核心命令
+
+```bash
+npm run dev              # Chrome 开发模式（支持 HMR）
+npm run dev:firefox      # Firefox 开发模式
+npm run build            # Chrome 生产构建
+npm run build:firefox    # Firefox 生产构建
+npm run zip              # 打包 Chrome 扩展（.output/*.zip）
+npm run zip:firefox      # 打包 Firefox 扩展
+npm run lint             # ESLint 检查（--max-warnings=0）
+npm run typecheck        # TypeScript 类型检查（tsc --noEmit）
+npm run test             # 运行全部单元测试（vitest run）
+npm run test:watch       # Vitest 监视模式
+npm run test:coverage    # 带覆盖率的测试
+```
+
+运行单个测试文件：`npx vitest run path/to/file.test.ts`
+
+修改 `package.json` 后需运行 `npm install`（会自动触发 `postinstall` → `wxt prepare` 重新生成 `.wxt/` 类型声明）。
+
+## CI 流水线（GitHub Actions）
+
+严格顺序门控，任一步骤失败则终止：
+
+1. **setup** — 安装依赖，缓存 `node_modules`
+2. **lint**、**typecheck**、**test** — 三者并行运行，全部通过才继续
+3. **build** — Chrome + Firefox 矩阵构建（仅当步骤 2 全部通过时执行）
+
+Pre-commit 钩子（`.husky/pre-commit` → `lint-staged`）：
+
+1. 代码文件（`*.{ts,tsx,js,jsx,mjs}`）：运行 `eslint --fix --max-warnings=0`
+2. 同一代码文件：运行 `prettier --write`
+3. 其他文件（`*.{json,css,scss,md}`）：运行 `prettier --write`
+
+## 项目架构
+
+### 路由（不使用 React Router）
+
+路由完全通过 `config/features.tsx` 中的 `FEATURES` 数组管理。每个功能定义一个 `key`（类型为 `types/storage.d.ts` 中的 `PageType`）和三个懒加载组件，分别对应 `popup`、`sidepanel`、`tab` 三种渲染模式。`providers/RouterProvider.tsx` 中的 `RouterProvider` 根据存储状态渲染当前页面。
+
+存在三套独立的路由作用域：`app/popupRoute`、`app/sidepanelRoute`、`app/tabRoute`，各自维护独立的可见页面列表和页面排序。
+
+### 存储
+
+所有 Chrome Storage 键必须在 `types/storage.d.ts` 的 `StorageSchema` 中声明，键名使用 kebab-case 格式（如 `app/currentRoute`）。使用 `utils/chromeStorage.ts` 中的类型安全封装（`storageUtil.get/set/remove`）。
+
+Router 同时使用 `chrome.storage.local` 持久化和 `localStorage` 快照来消除首屏闪烁。
+
+### 扩展通信
+
+使用 `@webext-core/messaging`。通信协议在 `utils/messages.ts` 中通过 `ProtocolMap` 定义。使用该模块导出的 `sendMessage` / `onMessage`，不要直接使用原生 `chrome.runtime.sendMessage`。
+
+### 页面组件模式
+
+功能页面遵循 **UI + Hook 分离** 模式，详见 [CODING_STANDARDS.md § 11](./CODING_STANDARDS.md#11-页面开发规范)：
+
+```
+pages/FeatureName/
+├── index.tsx              # UI 组件（纯展示，使用 shadcn/ui 组件）
+├── useFeatureName.ts      # 业务逻辑 Hook（状态管理 + 转换逻辑）
+└── constants.ts           # 常量定义（可选）
+```
+
+- 页面组件调用 `useI18n('featureName')` 获取翻译函数
+- Hook 负责所有状态管理，通过返回值暴露给页面
+- 子组件可进一步拆分（如 `LiveClock.tsx`、`ResultView.tsx`）
+
+### 新功能开发清单
+
+1. 在 `types/storage.d.ts` 的 `PageType` 联合类型中添加新成员
+2. 在 `config/features.tsx` 的 `FEATURES` 数组中添加配置（key、翻译键、图标、三种渲染模式组件）
+3. 在 `pages/` 目录创建页面组件（懒加载）：
+   - `index.tsx` — 使用 `useLazyTranslation` 的 UI 组件
+   - `useFeatureName.ts` — 业务逻辑 Hook
+   - `constants.ts` — 常量（可选）
+4. 在 `i18n/locales/{zh,en}/features.json` 添加翻译（复杂功能可新建独立 JSON 文件）
+5. 如需新权限，更新 `wxt.config.ts` 的 `manifest.permissions`
+6. 添加对应的单元测试
+
+## 关键规范
+
+> 完整的代码编写规范详见 [CODING_STANDARDS.md](./CODING_STANDARDS.md)。
+
+### 浏览器 API
+
+始终使用 `wxt/browser` 导出的 `browser` 对象，而非原生 `chrome` API，以确保跨浏览器兼容性。
+
+### 路径别名
+
+`@/` 映射到项目根目录（已在 tsconfig 和 vitest.config 中配置）。跨目录导入使用 `@/` 绝对别名，同目录导入使用 `./` 相对路径。
+
+### UI 组件
+
+- 使用 `components/ui/` 下的 shadcn/ui 组件（button、dialog、select、input 等）
+- 图标：`lucide-react`
+- 样式：Tailwind CSS + `@/lib/utils` 中的 `cn()` 工具函数（clsx + tailwind-merge）
+- 主题：使用 shadcn/ui 语义化 token（`bg-background`、`text-foreground`、`border-border` 等），禁止硬编码颜色
+
+### 代码分割
+
+`wxt.config.ts` 通过 `manualChunksForHtmlOnly()` 自动分组 vendor 依赖（vendor-react、vendor-i18n、vendor-qr、vendor-dnd），无需手动配置。
+
+### 代码风格
+
+- 禁止使用 `any`（测试文件除外）
+- 未使用的变量/参数：使用 `_` 前缀（如 `_unused`）
+- Prettier：100 字符宽、单引号、尾逗号 all、LF 换行
+- ESLint 使用 `typescript-eslint` 的 `projectService: true`
+- 导出模式：页面组件 default export，工具函数/Hook 命名导出，UI 组件 forwardRef + 命名导出
+
+### 测试
+
+- 环境：jsdom
+- 全局变量：`vitest/globals`（describe、it、expect 等无需导入）
+- Setup 文件：`vitest.setup.ts` 自动 mock 以下内容：
+  - `chrome.*` / `browser.*` API（storage、tabs、runtime、cookies 等）
+  - `react-i18next`（返回 key 作为翻译）
+  - `@/utils/useLazyTranslation`（返回 `ns:key` 格式）
+  - `window.matchMedia`
+- 测试文件命名：`__tests__/*.test.{ts,tsx}` 或 `*.test.{ts,tsx}`
+- 使用 `vi.mock()` 进行模块级 mock；避免重复 mock `vitest.setup.ts` 中已有的内容
+- 测试工具：`@testing-library/react` + `@testing-library/user-event`
+
+### 国际化（i18n）
+
+- 命名空间：`common`（默认）、`features`
+- 翻译键格式：`namespace:key`（如 `features:timestamp.title`）
+- 语言：`zh`（默认）、`en`
+- 翻译文件：`i18n/locales/{zh,en}/{common,features}.json` + 各功能独立 JSON 文件
+- 使用 `useLazyTranslation` Hook 加载功能专属翻译
+- 回退策略：缺失的翻译键回退到 `zh`，若仍缺失则返回占位格式 `namespace:key`
+
+### WXT 生成文件
+
+- `.wxt/` 目录由 `postinstall`（`wxt prepare`）自动生成，包含 TypeScript 类型声明和扩展 tsconfig
+- 生产构建输出到 `.output/` 目录
+- `tsconfig.json` 继承自 `./.wxt/tsconfig.json`

.github/workflows/ci.yml

@@ -13,8 +13,6 @@ concurrency:
   cancel-in-progress: true
 
 jobs:
-  # 💡 1. 提速核心：前置基建节点（Infrastructure Initialization）
-  # 专门负责锁死环境、同步下载并缓存 node_modules，下游节点直接满血复用！
   setup:
     name: Prepare Dependencies
     runs-on: ubuntu-latest
@@ -29,7 +27,6 @@ jobs:
         with:
           node-version: '22'
 
-      # 建立基于 package-lock.json 唯一哈希的缓存大闸
       - name: Cache Node Modules
         id: cache-nodemodules
         uses: actions/cache@v4
@@ -47,7 +44,6 @@ jobs:
         id: cache-info
         run: echo "key=${{ runner.os }}-node-v22-${{ hashFiles('**/package-lock.json') }}" >> $GITHUB_OUTPUT
 
-  # 💡 2. 静态语法质检节点（依赖前置节点完成）
   lint:
     name: Lint
     runs-on: ubuntu-latest
@@ -70,7 +66,6 @@ jobs:
       - name: Run ESLint
         run: npm run lint
 
-  # 💡 3. 强类型守卫节点（2秒瞬时恢复，开箱即查）
   typecheck:
     name: TypeScript Check
     runs-on: ubuntu-latest
@@ -96,7 +91,6 @@ jobs:
       - name: Run TypeScript type check
         run: npm run typecheck
 
-  # 💡 4. 单元测试节点（无缝运行你刚刚修复完的 setupTests.ts 套件）
   test:
     name: Unit Tests
     runs-on: ubuntu-latest
@@ -122,16 +116,12 @@ jobs:
       - name: Run tests
         run: npm run test
 
-  # 💡 5. 多端分布式最终编译节点（Production Matrix Compliance）
   build:
     name: Build (${{ matrix.browser }})
     runs-on: ubuntu-latest
-    # 只有当 Linter、类型大闸、Vitest 单元测试全数满分通过，才放行最终打包编译
     needs: [ lint, typecheck, test ]
     strategy:
       matrix:
-        # 💡 完美对齐 WXT 跨端架构：将 firefox 同步纳入生产编译大矩阵，
-        # 如果 firefox 编译因任何多端不兼容挂掉，CI 会立刻拉起警报，防护力拉满！
         browser: [ chrome, firefox ]
       fail-fast: false
     steps:
@@ -149,7 +139,6 @@ jobs:
           path: node_modules
           key: ${{ runner.os }}-node-v22-${{ hashFiles('**/package-lock.json') }}
 
-      # 💡 动态代理编译指令：完美匹配 WXT / 各类多端打包器的标准构建命令
       - name: Generate WXT types
         run: npx wxt prepare
 

.github/workflows/release.yml

@@ -91,6 +91,12 @@ jobs:
           path: node_modules
           key: ${{ runner.os }}-release-v22-${{ hashFiles('**/package-lock.json') }}
 
+      - name: Sync version from tag
+        run: |
+          VERSION="${GITHUB_REF_NAME#v}"
+          echo "Setting version to $VERSION"
+          npm version "$VERSION" --no-git-tag-version
+
       - name: Build and Zip Extension
         run: |
           npm run zip

.gitignore

@@ -14,6 +14,11 @@ stats-*.json
 .wxt
 .vitest
 
+# Environment variables
+.env
+.env.local
+.env.*.local
+
 # Editor directories and files
 .vscode/*
 !.vscode/extensions.json
@@ -30,4 +35,16 @@ stats-*.json
 .qoder/*
 dev/*
 
-docs/*
+# Build outputs
+dist/
+build/
+
+# Test coverage
+coverage/
+
+# IDE files
+*.code-workspace
+
+# Other
+*.tsbuildinfo
+*.tsxbuildinfo

.husky/pre-commit

@@ -1 +1,5 @@
+# 后台运行类型检查，结果输出到 stderr 但不阻塞提交
+npx tsc --noEmit &
+
+# 前台运行 lint-staged（自动修复 + 格式化）
 npx lint-staged

.husky/pre-push

@@ -0,0 +1,13 @@
+# pre-push: 严格检查，阻塞有问题的代码推送到远程
+# 类型检查（全项目，因为类型错误可能跨文件传播）
+npx tsc --noEmit
+
+# ESLint 严格检查（仅检查本次推送的变更文件，不阻塞不相关的旧代码）
+# 新分支无 upstream 时，回退到与 origin/main 对比
+MERGE_BASE=$(git merge-base HEAD @{upstream} 2>/dev/null || git merge-base HEAD origin/main 2>/dev/null)
+if [ -n "$MERGE_BASE" ]; then
+  CHANGED_FILES=$(git diff --name-only --diff-filter=d "$MERGE_BASE" HEAD -- '*.ts' '*.tsx' '*.js' '*.jsx' '*.mjs')
+  if [ -n "$CHANGED_FILES" ]; then
+    echo "$CHANGED_FILES" | xargs npx eslint --max-warnings=0
+  fi
+fi

AGENTS.md

@@ -1,6 +1,6 @@
 # AGENTS.md
 
-WXT 浏览器扩展项目 (React 19 + TypeScript)。
+WXT 浏览器扩展项目 (React 19 + TypeScript)。提供时间戳转换、存储清理、JWT 解析、JSON 工具、二维码、Base64、Markdown、测试数据生成器等测试效率工具。
 
 ## 核心命令
 
@@ -22,14 +22,17 @@ npm run test:coverage    # 带覆盖率的测试
 
 ## 验证流程
 
-CI 执行顺序: `setup → lint/typecheck/test(并行) → build` (build 依赖前三者)。
+CI 步骤（严格顺序，任一步骤失败则停止并标记 CI 失败）：
 
-Pre-commit hook (`.husky/pre-commit` 调用 `lint-staged`):
+1. `setup`（安装依赖、`wxt prepare`）
+2. 并行运行 `lint`、`typecheck`、`test`（三者全部通过才继续）
+3. `build`（仅当步骤 2 全部成功时执行）
 
-- 代码文件 (`*.{ts,tsx,js,jsx,mjs}`): `eslint --fix --max-warnings=0 --no-warn-ignored` → `prettier --write`
-- 其他文件 (`*.{json,css,scss,md}`): `prettier --write`
+Pre-commit hook（`.husky/pre-commit` 调用 `lint-staged`，任一步骤返回非零则终止提交）：
 
-提交前确保 `lint` 和 `typecheck` 通过。
+1. 代码文件 (`*.{ts,tsx,js,jsx,mjs}`)：运行 `eslint --fix --max-warnings=0 --no-warn-ignored`；若失败则终止并报告错误
+2. 同一代码文件：运行 `prettier --write`
+3. 其他文件 (`*.{json,css,scss,md}`)：运行 `prettier --write`
 
 ## WXT 生成文件
 
@@ -40,55 +43,126 @@ Pre-commit hook (`.husky/pre-commit` 调用 `lint-staged`):
 ## 项目结构
 
 ```
+src/                   # 源代码根目录
   config/features.tsx    # 功能定义（路由 + 元数据的单一事实来源）
-entrypoints/           # 扩展入口点 (popup/, options/, sidepanel/, background.ts, content.ts)
+  entrypoints/           # 扩展入口点 (popup/, sidepanel/, background.ts, content.ts)
   pages/                 # 功能页面组件 (懒加载)
   components/            # 可复用 UI 组件
+  components/ui/         # shadcn/ui 基础组件 (button, dialog, select 等)
   providers/             # React Context (Router, Theme 等)
   hooks/                 # 自定义 React Hooks
   utils/                 # 工具函数与服务抽象
   types/                 # TypeScript 类型声明
-i18n/locales/{zh,en}/  # 国际化资源 (common.json, features.json 及各功能独立 JSON)
+  lib/                   # 通用工具函数（cn、utils）
+  workers/               # Web Worker（数据生成等耗时任务）
+public/                # 静态资源（图标、_locales 等）
+```
+
+### 页面组件模式
+
+典型功能页面遵循 **UI + Hook 分离** 模式。详见 [CODING_STANDARDS.md § 11](./.github/CODING_STANDARDS.md#11-页面开发规范)。
+
+```
+src/pages/FeatureName/
+├── index.tsx              # 页面 UI（纯展示，仅负责渲染布局）
+├── useFeatureName.ts      # 业务逻辑 Hook（状态管理 + 转换逻辑）
+├── constants.ts           # 常量定义（可选，≥3 个常量时创建）
+└── __tests__/
+    └── index.test.tsx
+```
+
+- 页面入口组件统一命名为 `Index`，通过 `export default function Index()` 导出
+- Hook 负责所有状态管理和业务逻辑，通过返回值暴露给页面
+- 子组件可以独立调用 `useI18n` 等全局 Hook
+- 当 `index.tsx` 超过 150 行时，必须拆分为 UI + Hook 模式
+- 复杂页面可增加 `contexts/`、`hooks/`、`components/` 子目录
+
+### 测试数据生成器模块
+
+```
+src/pages/TestDataGenerator/
+├── index.tsx                    # 主页面（字段配置 + 标签页切换）
+├── hooks/useGenerator.ts        # Web Worker 管理 Hook（创建、复用、通信、销毁）
+└── components/
+    ├── FieldList.tsx            # 字段列表（虚拟滚动 + @dnd-kit 拖拽排序 + 规则保存）
+    ├── FieldItem.tsx            # 字段卡片展示
+    ├── FieldEditor.tsx          # 字段编辑器（名称校验、生成器选择、参数配置）
+    ├── GeneratorSelector.tsx    # 生成器选择器（分类 + 搜索）
+    ├── GeneratorConfig.tsx      # 生成器参数表单（动态渲染 string/number/boolean/select/array）
+    ├── GenerateOptions.tsx      # 生成选项（数量、格式）
+    ├── GenerateButton.tsx       # 生成按钮 + 进度条
+    ├── DataPreview.tsx          # 示例数据预览（JSON 语法高亮）
+    ├── ResultPanel.tsx          # 生成结果状态面板
+    ├── ExportPanel.tsx          # 导出面板（复制/下载 JSON/CSV）
+    └── RuleManager.tsx          # 规则管理（CRUD、搜索、导入/导出）
+
+src/utils/
+├── ruleStorage.ts               # 规则持久化存储（localStorage）
+├── dataExporter.ts              # 数据导出工具（JSON/CSV 转换、下载、剪贴板）
+└── generators/                  # 内置生成器定义（个人信息、企业、技术、基础类型）
+
+src/workers/
+└── generator.worker.ts          # 数据生成 Web Worker
+
+src/types/
+└── testDataGenerator.ts         # 类型定义（FieldConfig, DataRule, GeneratorDefinition 等）
 ```
 
 ## 关键架构决策
 
-**路由**: 不使用 React Router。通过 `config/features.tsx` 的 `FEATURES` 数组管理，`RouterProvider` 根据 `PageType`
-渲染对应组件。支持三种渲染模式: popup / sidepanel / tab。
+**路由**: 不使用 React Router。通过 `src/config/features.tsx` 的 `FEATURES` 数组管理，`RouterProvider` 根据 `PageType`
+渲染对应组件。支持三种渲染模式：popup（弹窗）、sidepanel（侧边栏）和 browser-tab（浏览器新标签页，通过 `open_in_tab` 打开）。
+每种模式有独立的路由和可见页面配置（`app/popupRoute`、`app/sidepanelRoute`、`app/tabRoute` 等）。
 
-**存储**: 所有 Chrome Storage 键必须在 `types/storage.d.ts` 的 `StorageSchema` 中定义。使用 `utils/chromeStorage.ts` 及其
-Hook。Router 同时使用 `chrome.storage.local` 和 `localStorage` 做快照以消除首屏闪烁。
+**存储**: 所有 Chrome Storage 键必须在 `src/types/storage.d.ts` 的 `StorageSchema` 中定义，键名使用 kebab-case 格式（如 `app/currentRoute`）。
+使用 `src/utils/chromeStorage.ts` 及其 Hook。Router 同时使用 `chrome.storage.local` 和 `localStorage` 做快照以消除首屏闪烁。
+修改 StorageSchema 时，必须在 `src/utils/chromeStorage.ts` 添加版本迁移函数，并在测试中覆盖迁移场景。
 
-**通信**: 使用 `@webext-core/messaging`，协议定义在 `utils/messages.ts`。
+**通信**: 使用 `@webext-core/messaging`，协议定义在 `src/utils/messages.ts`。
 
 **路径别名**: `@/` 映射到项目根目录 (已在 tsconfig 和 vitest.config 中配置)。
 
 **浏览器兼容**: 优先使用 `wxt/browser` 导出的 `browser` 对象，而非原生 `chrome` API。
 
+**代码分割**: `wxt.config.ts` 通过 `manualChunksForHtmlOnly()` 自动分组依赖（vendor-react、vendor-qr、vendor-dnd 等），无需手动配置。
+
 ## 测试环境
 
 - 环境: jsdom
 - 全局变量: `vitest/globals` (describe, it, expect 等无需导入)
 - Setup 文件: `vitest.setup.ts` 自动 mock:
   - `chrome.*` / `browser.*` API (storage, tabs, runtime, cookies 等)
-  - `react-i18next` (返回 key 作为翻译)
-  - `@/utils/useLazyTranslation` (返回 `ns:key` 格式翻译)
+  - `@/utils/chromeI18n` (从 `public/_locales/zh/messages.json` 加载真实翻译)
   - `window.matchMedia`
 - 测试文件命名: `__tests__/*.test.{ts,tsx}` 或 `*.test.{ts,tsx}`
+- Mock 模式: 使用 `vi.mock()` 进行模块级 mock，避免在测试文件中重复 mock 代码
+- 测试工具: `@testing-library/react` + `@testing-library/user-event` 进行组件测试
 
-## i18n
+## i18n (chrome.i18n)
 
-- 命名空间: `common` (默认), `features`
-- 翻译键格式: `namespace:key` (如 `features:timestamp.title`)
-- 语言: `zh` (默认), `en`
-- 添加新翻译: 编辑 `i18n/locales/{zh,en}/{common,features}.json` 及对应功能独立 JSON
+项目使用 Chrome 扩展标准的 `chrome.i18n` API 进行本地化，通过 `src/utils/chromeI18n.ts` 提供类型安全的 React Hook 包装。
+
+- **翻译文件**: `public/_locales/{zh,en}/messages.json`（Chrome 扩展标准格式）
+- **默认语言**: `zh`（在 `wxt.config.ts` 的 `manifest.default_locale` 中配置）
+- **使用方式**: `import { useI18n } from '@/utils/chromeI18n'`
+- **翻译键格式**:
+  - 直接 key: `t('dashboard_title')` → 查找 `dashboard_title`
+  - 命名空间格式（兼容旧用法）: `t('common:buttons.search')` → 查找 `common_buttons_search`
+  - 带命名空间参数: `useI18n(['common', 'features'])`，会自动尝试 `common_key`、`features_key`
+- **占位符支持**: `t('router_notFoundDescription', { entryPointType: 'popup' })`
+- **Hook 返回值**: `{ t, i18n: { language, changeLanguage }, isLoaded }`
+- **回退策略**: 当翻译 key 未命中时，返回 key 本身（开发模式下在控制台记录 warning）
+- **限制**: `chrome.i18n` 无法动态切换语言，语言跟随浏览器设置，切换后需刷新页面
 
 ## 新功能开发清单
 
-1. 在 `types/storage.d.ts` 添加 `PageType` 联合类型
-2. 在 `config/features.tsx` 的 `FEATURES` 数组添加配置
-3. 在 `pages/` 创建页面组件 (懒加载)
-4. 在 `i18n/locales/{zh,en}/features.json` 添加翻译（复杂功能可新建独立 JSON）
+1. 在 `src/types/storage.d.ts` 添加 `PageType` 联合类型
+2. 在 `src/config/features.tsx` 的 `FEATURES` 数组添加配置（指定 key、翻译键、图标、三种渲染模式的组件）
+3. 在 `src/pages/` 创建页面组件 (懒加载)：
+   - `index.tsx` — UI 组件，使用 `useI18n` 获取翻译
+   - `useFeatureName.ts` — 业务逻辑 Hook
+   - `constants.ts` — 常量（可选）
+4. 在 `public/_locales/zh/messages.json`（及 `en/messages.json`）添加翻译
 5. 如需新权限，更新 `wxt.config.ts` 的 `manifest.permissions`
 6. 添加对应的单元测试
 
@@ -97,15 +171,17 @@ Hook。Router 同时使用 `chrome.storage.local` 和 `localStorage` 做快照
 - 禁止使用 `any` (测试文件除外)
 - 未使用变量/参数: 使用 `_` 前缀 (如 `_unused`)
 - 样式: 使用 Tailwind CSS + shadcn/ui (通过 `className` 和 `cn()` 工具)
+- UI 组件: 优先使用 `src/components/ui/` 下的 shadcn/ui 组件 (button, dialog, select 等)
+- 图标: 使用 `lucide-react` 图标库
 - 格式: Prettier (`.prettierrc`: 100 字符宽, 单引号, 尾逗号 all, LF 换行)
 - ESLint 使用 `typescript-eslint` 的 `projectService: true`（无需手动维护 project 路径）
+- **Git Commit**: 必须使用中文描述，遵循 Conventional Commits 规范（如 `fix(组件名): 描述`、`feat(功能名): 描述`）
 
-## 技术栈版本
+## 关键外部库（非显而易见的）
 
-- WXT: ^0.20.26
-- React: ^19.2.6
-- Tailwind CSS: ^3.4.19
-- shadcn/ui (基于 Radix UI + class-variance-authority)
-- TypeScript: ^5.9.3
-- Vitest: ^4.1.7
-- i18next: ^26.2.0
+- `@webext-core/messaging` — 扩展消息通信
+- `@dnd-kit` — 拖拽排序（用于页面顺序管理和字段列表排序）
+- `qrious` + `qr-scanner` — 二维码生成与解析
+- `dayjs` — 日期处理（时间戳转换）
+- `sonner` — Toast 通知（替代传统 snackbar）
+- Web Worker — 批量数据生成（`src/workers/generator.worker.ts`），避免阻塞 UI 线程

CLAUDE.md

@@ -0,0 +1 @@
+@AGENT.md

README.md

@@ -8,65 +8,71 @@
 
 ## 功能特性
 
-### 🚀 Dashboard 首页
+### Dashboard 首页
 
 - **工具导航**: 快速访问所有可用工具.
 - **个性化定制**: 支持自定义工具的排序和可见性.
 - **实时预览**: 在卡片上直接查看实时数据（如当前时间戳）.
 
-### ⏰ 时间戳转换工具
+### 时间戳转换工具
 
 - **实时显示**: 毫秒级精度显示当前系统时间.
 - **双向转换**: 日期字符串与 Unix 时间戳（秒/毫秒）之间的无缝转换.
 - **多时区支持**: 预设常用时区（亚洲/上海、美洲/纽约、欧洲/伦敦），支持快速切换.
 - **快捷操作**: 一键复制转换结果，支持多种格式.
 
-### 🧹 存储清理工具
+### 存储清理工具
 
 - **智能识别**: 自动检测并显示当前活动标签页的域名.
 - **全面清理**: 支持一键清理 localStorage、sessionStorage、IndexedDB、Cookies、Cache Storage 和 Service Workers.
 - **细粒度控制**: 可根据需要选择特定的清理项.
 - **自动刷新**: 提供清理后自动刷新页面的选项，确保状态同步.
 
-### 📝 文本统计工具
+### 文本统计工具
 
 - **实时分析**: 键入即统计，无需额外操作.
 - **多维指标**: 统计字符数、单词数、行数以及精确的字节大小.
 - **性能优化**: 采用高性能分词算法，支持大文本处理.
 
-### 🔑 JWT 解析工具
+### JWT 解析工具
 
 - **快速解码**: 自动解析 JSON Web Token 的 Header 和 Payload.
 - **格式化显示**: 以着色和格式化的 JSON 视图展示数据，方便阅读.
 - **安全检查**: 自动去除 `Bearer` 前缀，处理异常输入并提供友好提示.
 - **签名查看**: 展示 JWT 签名部分，辅助验证令牌完整性.
 
-### 🖱️ 右键恢复工具
+### 右键恢复工具
 
 - **当前页面检测**: 自动识别当前活动标签页的域名.
 - **一键恢复**: 解除网站对右键菜单的限制，恢复复制、粘贴等基础操作.
 - **状态可视化**: 通过 Badge 组件直观展示当前页面的锁定/解锁状态.
 
-### 🖼️ 二维码工具
+### 二维码工具
 
 - **生成器**: 将当前 URL 或自定义文本快速转换为二维码，支持下载.
 - **解析器**: 支持通过上传图片或粘贴图片来解析二维码内容.
 
-### 🔄 JSON 工具
+### JSON 工具
 
 - **差异比较**: 对比两段 JSON 数据，高亮展示差异.
 - **格式化**: 支持 JSON 美化、压缩、转 YAML / TOML.
 
-### 🧰 Base64 转换器
+### Base64 转换器
 
 - **文本编解码**: 支持文本内容的 Base64 编码与解码.
 - **文件转换**: 支持文件与 Base64 字符串互转.
 - **图像预览**: 支持图片 Base64 编码与实时预览.
 
-### 📝 Markdown ↔ HTML 转换
+### 测试数据生成器
 
-- **Markdown 转 HTML**: 实时预览 Markdown 渲染结果，支持导出 HTML 源码.
-- **HTML 转 Markdown**: 将 HTML 内容转换为 Markdown 格式.
+- **可视化字段配置**: 通过 UI 界面定义数据字段，支持拖拽排序、最多 40 个字段.
+- **丰富的内置生成器**: 涵盖个人信息（姓名、手机、邮箱）、企业数据（公司名、职位）、技术数据（IP、MAC 地址、UUID）、基础类型（数字、日期、枚举）等多个分类.
+- **灵活的参数配置**: 每个生成器支持自定义参数（如数字范围、日期格式、枚举值列表等）.
+- **空值率与唯一性**: 可为非必填字段设置空值率，支持字段唯一性约束.
+- **规则管理**: 保存、加载、编辑、复制、导入/导出字段配置规则，方便复用.
+- **批量生成**: 支持 1 ~ 100,000 条数据生成，通过 Web Worker 异步处理避免阻塞 UI.
+- **实时预览**: 配置字段后即时预览示例数据结构.
+- **多格式导出**: 支持 JSON 和 CSV 格式，提供复制到剪贴板和下载文件两种导出方式.
 
 ## 技术栈
 
@@ -80,26 +86,28 @@
 - **存储**: Chrome Storage API (类型安全封装)
 - **解析引擎**: qr-scanner (二维码解析), qrious (二维码生成)
 - **测试**: Vitest + Testing Library
+- **拖拽排序**: @dnd-kit/core + @dnd-kit/sortable
+- **异步生成**: Web Worker (批量数据生成)
 
 ## 项目结构
 
 ```text
-├── components/           # 可复用 React 组件
-├── config/              # 应用配置
-│   └── features.tsx     # 功能定义与路由映射
-├── entrypoints/         # 扩展程序入口点
-│   ├── popup/           # 点击图标弹出的主界面
-│   ├── options/         # 扩展程序设置页面
-│   ├── sidepanel/       # 浏览器侧边栏集成
-│   ├── background.ts    # 后台 Service Worker
-│   └── content.ts       # 网页注入脚本
-├── pages/               # 各功能模块的页面组件
-├── providers/           # 全局状态提供者 (Router, Theme 等)
-├── hooks/               # 自定义 React Hooks
-├── utils/               # 工具函数与服务抽象
-├── types/               # TypeScript 类型声明
-├── lib/                 # 通用工具函数 (cn, utils 等)
-├── i18n/                # 国际化资源
+├── src/                   # 源代码根目录
+│   ├── components/        # 可复用 React 组件
+│   ├── config/            # 应用配置
+│   │   └── features.tsx   # 功能定义与路由映射
+│   ├── entrypoints/       # 扩展程序入口点
+│   │   ├── popup/         # 点击图标弹出的主界面
+│   │   ├── sidepanel/     # 浏览器侧边栏集成
+│   │   ├── background.ts  # 后台 Service Worker
+│   │   └── content.ts     # 网页注入脚本
+│   ├── pages/             # 各功能模块的页面组件
+│   ├── workers/           # Web Worker (数据生成等耗时任务)
+│   ├── providers/         # 全局状态提供者 (Router, Theme 等)
+│   ├── hooks/             # 自定义 React Hooks
+│   ├── utils/             # 工具函数与服务抽象
+│   ├── types/             # TypeScript 类型声明
+│   └── lib/               # 通用工具函数 (cn, utils 等)
 ├── public/                # 静态资源 (图标、manifest 资源等)
 ├── wxt.config.ts          # WXT 框架核心配置
 └── package.json           # 项目元数据与依赖管理

components/CopyButton.tsx

@@ -1,93 +0,0 @@
-import React, { useEffect, useRef, useState } from 'react';
-import { Check, Copy } from 'lucide-react';
-import { copyTextToClipboard } from '@/utils/clipboard';
-import { cn } from '@/lib/utils'; // 1. 必须使用 cn 工具函数
-import { toast } from 'sonner'; // 2. 推荐使用 shadcn 默认的全局 toast
-
-// 3. 继承原生按钮属性，允许外部自由扩展 className、variant 等
-interface CopyButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
-  text: string;
-  tooltip?: string;
-  size?: 'small' | 'medium' | 'large';
-  // 移除复杂的自定义颜色变体，交由 Tailwind 类名或 shadcn 的 variant 解决
-  variant?: 'default' | 'secondary' | 'ghost' | 'outline';
-}
-
-export const CopyButton: React.FC<CopyButtonProps> = ({
-  text,
-  tooltip = '复制',
-  size = 'small',
-  variant = 'ghost',
-  className,
-  ...props
-}) => {
-  const [copied, setCopied] = useState(false);
-  const timerRef = useRef<ReturnType<typeof setTimeout> | null>(null);
-
-  useEffect(() => {
-    return () => {
-      if (timerRef.current) clearTimeout(timerRef.current);
-    };
-  }, []);
-
-  const handleCopy = async (e: React.MouseEvent<HTMLButtonElement>) => {
-    e.stopPropagation(); // 基础组件防冒泡，避免触发父级点击事件
-
-    if (!text) {
-      toast.error('无内容可复制');
-      return;
-    }
-
-    const success = await copyTextToClipboard(text);
-    if (success) {
-      toast.success('复制成功');
-      setCopied(true);
-      if (timerRef.current) clearTimeout(timerRef.current);
-      timerRef.current = setTimeout(() => setCopied(false), 1500);
-    } else {
-      toast.error('复制失败');
-    }
-  };
-
-  // 4. 将控制尺寸的类名标准化
-  const sizeClasses = {
-    small: 'h-8 w-8 text-xs',
-    medium: 'h-10 w-10 text-sm',
-    large: 'h-12 w-12 text-base',
-  };
-
-  // 5. 映射 shadcn 的底层通用 Variant 类名
-  const variantClasses = {
-    default: 'bg-primary text-primary-foreground shadow hover:bg-primary/90',
-    secondary: 'bg-secondary text-secondary-foreground shadow-sm hover:bg-secondary/80',
-    ghost: 'hover:bg-accent hover:text-accent-foreground',
-    outline:
-      'border border-input bg-background shadow-sm hover:bg-accent hover:text-accent-foreground',
-  };
-
-  return (
-    <button
-      type="button"
-      onClick={handleCopy}
-      title={tooltip}
-      // 6. 使用 cn() 合并类名，并完美支持暗黑模式的语义化变量 (destructive/muted等)
-      className={cn(
-        'inline-flex items-center justify-center rounded-md font-medium transition-colors focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring disabled:pointer-events-none disabled:opacity-50',
-        sizeClasses[size],
-        copied
-          ? 'bg-emerald-500/10 text-emerald-600 dark:text-emerald-400' // 兼顾暗黑模式的成功色
-          : variantClasses[variant],
-        className, // 允许外部直接传入 text-red-500 等覆盖样式
-      )}
-      {...props}
-    >
-      {copied ? (
-        <Check className="h-[1.2em] w-[1.2em] animate-in fade-in zoom-in-75 duration-200" />
-      ) : (
-        <Copy className="h-[1.2em] w-[1.2em]" />
-      )}
-    </button>
-  );
-};
-
-export default CopyButton;

components/GlobalSnackbar.tsx

@@ -1,368 +0,0 @@
-/**
- * GlobalSnackbar - 全局 Snackbar 消息提示组件及 Provider
- *
- * 提供可复用的 Toast 消息提示功能，支持三种使用方式：
- * 1. 作为受控组件使用：通过 props 控制显示状态
- * 2. 通过 useSnackbarState Hook 使用：在组件内部自动管理状态
- * 3. 通过 SnackbarProvider 和 useSnackbar Hook 使用：全局单例模式
- *
- * @module GlobalSnackbar
- * @version 1.1.0
- *
- * @example
- * ```tsx
- * // 方式一：受控组件
- * <GlobalSnackbar
- *   message="操作成功"
- *   open={isOpen}
- *   onClose={() => setIsOpen(false)}
- *   severity="success"
- * />
- *
- * // 方式二：Hook 方式 (局部状态)
- * const { snackbarProps, showMessage } = useSnackbarState();
- * showMessage('Hello!', { severity: 'info' });
- *
- * // 方式三：Context 方式 (全局状态)
- * // 在根组件包裹 Provider
- * <SnackbarProvider>
- *   <App />
- * </SnackbarProvider>
- *
- * // 在子组件中使用
- * const { showMessage } = useSnackbar();
- * showMessage('Global Message');
- * ```
- */
-
-import {
-  JSX,
-  useState,
-  useRef,
-  createContext,
-  useContext,
-  useEffect,
-  type ReactNode,
-  type SyntheticEvent,
-} from 'react';
-import { CheckCircle, Info, AlertTriangle, XCircle } from 'lucide-react';
-
-/**
- * Snackbar 消息严重程度类型
- * @description 决定 Alert 组件的颜色和图标
- * - success: 绿色，成功提示
- * - info: 蓝色，信息提示
- * - warning: 橙色，警告提示
- * - error: 红色，错误提示
- */
-export type SnackbarSeverity = 'success' | 'info' | 'warning' | 'error';
-
-/**
- * GlobalSnackbar 组件的属性接口
- * @interface GlobalSnackbarProps
- */
-export interface GlobalSnackbarProps {
-  /** 消息内容，要显示的提示文本 */
-  message: string;
-  /** 是否显示 Snackbar */
-  open: boolean;
-  /** 关闭回调函数 */
-  onClose: () => void;
-  /** 消息级别，影响颜色和图标样式，默认 'info' */
-  severity?: SnackbarSeverity;
-  /** 自动隐藏时间（毫秒），设为 0 则不自动关闭，默认 2000 */
-  autoHideDuration?: number;
-  /** Snackbar 弹出位置，默认 { vertical: 'bottom', horizontal: 'center' } */
-  anchorOrigin?: {
-    vertical: 'top' | 'bottom';
-    horizontal: 'left' | 'center' | 'right';
-  };
-  /** 是否使用 Alert 组件包裹，false 则使用原生 Snackbar message，默认 true */
-  showAlert?: boolean;
-  /** 是否隐藏 Alert 图标，默认 false */
-  hideIcon?: boolean;
-  /** 自定义样式，透传给外层 Snackbar 组件 */
-  sx?: React.CSSProperties;
-  /** 自定义样式，透传给内层 Alert 组件（仅 showAlert=true 时生效） */
-  alertSx?: React.CSSProperties;
-}
-
-/**
- * showMessage 方法的选项配置
- * @interface SnackbarOptions
- */
-export interface SnackbarOptions {
-  /** 消息级别：success | info | warning | error */
-  severity?: SnackbarSeverity;
-  /** 自动隐藏时间（毫秒），设为 0 则不自动关闭 */
-  autoHideDuration?: number;
-  /** 是否隐藏 Alert 图标 */
-  hideIcon?: boolean;
-  /** 是否使用 Alert 组件包裹 */
-  showAlert?: boolean;
-}
-
-/**
- * useSnackbarState Hook 的返回值类型
- * @interface UseSnackbarStateResult
- */
-export interface UseSnackbarStateResult {
-  /** 传递给 GlobalSnackbar 组件的属性对象 */
-  snackbarProps: GlobalSnackbarProps;
-  /** 显示消息的方法 */
-  showMessage: (message: string, options?: SnackbarOptions) => void;
-  /** 关闭消息的方法 */
-  closeMessage: () => void;
-}
-
-/**
- * GlobalSnackbar 组件的默认属性配置
- * @description 提供类型安全的默认值选择
- */
-const defaultProps: Required<
-  Pick<
-    GlobalSnackbarProps,
-    'severity' | 'autoHideDuration' | 'anchorOrigin' | 'showAlert' | 'hideIcon'
-  >
-> = {
-  severity: 'info',
-  autoHideDuration: 2000,
-  anchorOrigin: { vertical: 'bottom', horizontal: 'center' },
-  showAlert: true,
-  hideIcon: false,
-};
-
-const severityConfig: Record<
-  SnackbarSeverity,
-  { icon: React.ElementType; bgClass: string; textClass: string }
-> = {
-  success: { icon: CheckCircle, bgClass: 'bg-green-500', textClass: 'text-white' },
-  info: { icon: Info, bgClass: 'bg-primary/100', textClass: 'text-white' },
-  warning: { icon: AlertTriangle, bgClass: 'bg-amber-500', textClass: 'text-white' },
-  error: { icon: XCircle, bgClass: 'bg-red-500', textClass: 'text-white' },
-};
-
-/**
- * GlobalSnackbar 组件
- *
- * 全局消息提示的展示组件，支持受控和非受控两种使用模式。
- *
- * @param {GlobalSnackbarProps} props - 组件属性
- * @returns {JSX.Element}
- */
-export function GlobalSnackbar({
-  message,
-  open,
-  onClose,
-  severity = defaultProps.severity,
-  autoHideDuration = defaultProps.autoHideDuration,
-  showAlert = defaultProps.showAlert,
-  hideIcon = defaultProps.hideIcon,
-}: GlobalSnackbarProps): JSX.Element | null {
-  const timerRef = useRef<ReturnType<typeof setTimeout> | null>(null);
-
-  useEffect(() => {
-    if (open && autoHideDuration > 0) {
-      timerRef.current = setTimeout(() => {
-        onClose();
-      }, autoHideDuration);
-      return () => {
-        if (timerRef.current) clearTimeout(timerRef.current);
-      };
-    }
-    return undefined;
-  }, [open, autoHideDuration, onClose]);
-
-  if (!open) return null;
-
-  const config = severityConfig[severity];
-  const IconComponent = config.icon;
-
-  return (
-    <div className="fixed z-[999999] bottom-6 left-1/2 -translate-x-1/2 animate-in fade-in slide-in-from-bottom-2 duration-300">
-      {showAlert ? (
-        <div
-          className={`flex items-center gap-2 px-5 py-1.5 rounded-full shadow-lg ${config.bgClass} ${config.textClass}`}
-          style={{ minWidth: '140px' }}
-        >
-          {!hideIcon && <IconComponent className="h-4 w-4 flex-shrink-0" />}
-          <span className="text-xs font-bold">{message}</span>
-        </div>
-      ) : (
-        <div className="px-4 py-2 rounded-lg bg-gray-800 text-white text-sm">{message}</div>
-      )}
-    </div>
-  );
-}
-
-/**
- * useSnackbarState - 消息提示的 Hook 方式
- *
- * 提供状态管理的 Snackbar 功能，自动处理 open、message 等状态。
- * 适合在组件内部使用，无需额外的状态管理代码。
- *
- * @param {SnackbarOptions} [initialOptions] - 初始配置选项
- * @returns {UseSnackbarStateResult} 包含 snackbarProps 和操作方法的对象
- *
- * @description
- * - 自动管理 Snackbar 的显示/隐藏状态
- * - 支持链式调用 showMessage
- * - 合并初始选项和调用时选项
- *
- * @example
- * ```tsx
- * function MyComponent() {
- *   const { snackbarProps, showMessage, closeMessage } = useSnackbarState({
- *     severity: 'info',
- *     autoHideDuration: 3000,
- *   });
- *
- *   const handleSave = () => {
- *     // 业务逻辑...
- *     showMessage('保存成功！', { severity: 'success' });
- *   };
- *
- *   return (
- *     <>
- *       <button onClick={handleSave}>保存</button>
- *       <GlobalSnackbar {...snackbarProps} />
- *     </>
- *   );
- * }
- * ```
- */
-export function useSnackbarState(initialOptions?: SnackbarOptions): UseSnackbarStateResult {
-  // Snackbar 显示状态
-  const [open, setOpen] = useState(false);
-  // 当前显示的消息内容
-  const [message, setMessage] = useState('');
-  // 消息配置选项
-  const [options, setOptions] = useState<SnackbarOptions>(initialOptions || {});
-
-  /**
-   * 显示消息
-   *
-   * @param {string} newMessage - 要显示的消息文本
-   * @param {SnackbarOptions} [newOptions={}] - 新的配置选项
-   *
-   * @description
-   * - 合并初始选项和新的调用选项
-   * - 新选项会覆盖初始选项
-   */
-  const showMessage = (newMessage: string, newOptions: SnackbarOptions = {}) => {
-    setMessage(newMessage);
-    setOptions({ ...initialOptions, ...newOptions });
-    setOpen(true);
-  };
-
-  /**
-   * 关闭消息
-   *
-   * @description
-   * - 直接将 open 状态设置为 false
-   */
-  const closeMessage = () => {
-    setOpen(false);
-  };
-
-  const handleClose = (_event?: SyntheticEvent | Event, reason?: string) => {
-    if (reason === 'clickaway') return;
-    closeMessage();
-  };
-
-  /**
-   * 传递给 GlobalSnackbar 组件的属性
-   *
-   * @description
-   * - 组合当前状态和选项为完整的组件 props
-   * - onClose 使用 handleClose 包装后的版本
-   */
-  const snackbarProps: GlobalSnackbarProps = {
-    message,
-    open,
-    onClose: handleClose,
-    severity: options.severity,
-    autoHideDuration: options.autoHideDuration,
-    hideIcon: options.hideIcon,
-  };
-
-  return {
-    snackbarProps,
-    showMessage,
-    closeMessage,
-  };
-}
-
-// --- Context & Provider ---
-
-/**
- * Snackbar Context 的值类型定义
- */
-interface SnackbarContextValue {
-  showMessage: (message: string, options?: SnackbarOptions) => void;
-  closeMessage: () => void;
-}
-
-const SnackbarContext = createContext<SnackbarContextValue | null>(null);
-
-/**
- * SnackbarProvider 组件的 props 类型
- */
-interface SnackbarProviderProps {
-  children: ReactNode;
-  initialOptions?: SnackbarOptions;
-}
-
-/**
- * SnackbarProvider 组件
- *
- * 全局消息提示的 Provider 组件，需要包裹在应用根组件外层。
- */
-export function SnackbarProvider({ children, initialOptions }: SnackbarProviderProps): JSX.Element {
-  const { snackbarProps, showMessage, closeMessage } = useSnackbarState(initialOptions);
-
-  return (
-    <SnackbarContext.Provider value={{ showMessage, closeMessage }}>
-      {children}
-      <GlobalSnackbar {...snackbarProps} />
-    </SnackbarContext.Provider>
-  );
-}
-
-/**
- * useSnackbar - 在子组件中获取 Snackbar 上下文的 Hook
- *
- * @param {SnackbarOptions} [options] - 钩子级别的默认配置（如 autoHideDuration）
- * @returns {SnackbarContextValue} - 包含 showMessage 和 closeMessage 的对象
- * @throws {Error} - 如果不在 SnackbarProvider 内部调用，抛出错误
- *
- * @description
- * 选项合并策略：
- * 1. 调用 showMessage 时传入的 callOptions 优先级最高
- * 2. useSnackbar(options) 传入的 Hook 级别配置次之
- * 3. SnackbarProvider(initialOptions) 传入的全局配置优先级最低
- */
-export function useSnackbar(options?: SnackbarOptions): SnackbarContextValue {
-  const context = useContext(SnackbarContext);
-  if (!context) {
-    throw new Error('useSnackbar must be used within SnackbarProvider');
-  }
-
-  // 包装 showMessage 以支持 Hook 级别的 initialOptions
-  const wrappedShowMessage = (message: string, callOptions?: SnackbarOptions) => {
-    // 采用防御性编程，确保 options 和 callOptions 为空时也能正常工作
-    // 优先级：callOptions > options
-    const mergedOptions: SnackbarOptions = {
-      ...(options || {}),
-      ...(callOptions || {}),
-    };
-    context.showMessage(message, mergedOptions);
-  };
-
-  return {
-    ...context,
-    showMessage: wrappedShowMessage,
-  };
-}
-
-export default GlobalSnackbar;

components/QrCodePreview.tsx

@@ -1,89 +0,0 @@
-import React from 'react';
-import { Copy, Download } from 'lucide-react';
-import { useLazyTranslation } from '@/utils/useLazyTranslation';
-import { cn } from '@/lib/utils'; // 1. 引入标准的 shadcn 工具函数
-
-// 继承原生 HTML Div 属性，方便外部无缝扩充类名或监听事件
-interface QrCodePreviewProps extends React.HTMLAttributes<HTMLDivElement> {
-  /** 二维码 Data URL */
-  qrCodeDataUrl: string;
-  /** 下载回调 */
-  onDownload: () => void;
-  /** 复制回调 */
-  onCopy: () => void;
-}
-
-const QrCodePreview = ({
-  qrCodeDataUrl,
-  onDownload,
-  onCopy,
-  className,
-  ...props
-}: QrCodePreviewProps) => {
-  const { t } = useLazyTranslation('qrCode');
-
-  // 空状态下的虚线骨架屏
-  if (!qrCodeDataUrl) {
-    return (
-      <div
-        className={cn(
-          'flex flex-col justify-center items-center min-h-[200px] border border-dashed border-input rounded-xl p-4 bg-muted/40',
-          className,
-        )}
-        {...props}
-      >
-        <p className="text-sm text-muted-foreground text-center">{t('qrCode:qrCodeWillShow')}</p>
-      </div>
-    );
-  }
-
-  return (
-    <div
-      className={cn(
-        'flex flex-col justify-center items-center min-h-[200px] border border-input rounded-xl p-6 bg-muted/40',
-        className,
-      )}
-      {...props}
-    >
-      <div className="flex flex-col items-center w-full max-w-xs">
-        {/*
-          2. 二维码容器适配：
-          在暗黑模式下，纯黑白的二维码如果直接暴露在暗色背景下，会导致手机摄像头极难识别。
-          通过裹一层 bg-white 和 p-3，确保黑白对比度绝对安全，同时加入 shadow 增强卡片感。
-        */}
-        <div className="p-3 bg-white rounded-lg shadow-sm border border-border/40">
-          <img
-            src={qrCodeDataUrl}
-            alt="QR Code Preview"
-            className="w-56 h-56 max-w-full object-contain block animate-in fade-in duration-300"
-          />
-        </div>
-
-        {/* 3. 按钮群全面向 shadcn 官方 Button 视觉规范对齐 */}
-        <div className="flex w-full gap-2 mt-5">
-          {/* 下载按钮：使用标准的次要按钮风格 (Outline) */}
-          <button
-            type="button"
-            onClick={onDownload}
-            className="flex-1 inline-flex h-9 items-center justify-center gap-2 px-3 text-sm font-medium rounded-md border border-input bg-background shadow-sm transition-colors hover:bg-accent hover:text-accent-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring"
-          >
-            <Download className="w-4 h-4 text-muted-foreground" />
-            <span className="truncate">{t('qrCode:downloadButton')}</span>
-          </button>
-
-          {/* 复制按钮：使用标准的主要行动按钮风格 (Default) */}
-          <button
-            type="button"
-            onClick={onCopy}
-            className="flex-1 inline-flex h-9 items-center justify-center gap-2 px-3 text-sm font-medium rounded-md bg-primary text-primary-foreground shadow transition-colors hover:bg-primary/90 focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring"
-          >
-            <Copy className="w-4 h-4" />
-            <span className="truncate">{t('qrCode:copyQrButton')}</span>
-          </button>
-        </div>
-      </div>
-    </div>
-  );
-};
-
-export default QrCodePreview;

components/__tests__/GlobalSnackbar.test.tsx

@@ -1,117 +0,0 @@
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-import { act, render, renderHook, screen } from '@testing-library/react';
-import React from 'react';
-import {
-  GlobalSnackbar,
-  type GlobalSnackbarProps,
-  SnackbarProvider,
-  useSnackbar,
-  useSnackbarState,
-} from '@/components/GlobalSnackbar';
-
-describe('GlobalSnackbar 组件系统', () => {
-  const mockOnClose = vi.fn();
-
-  beforeEach(() => {
-    vi.useFakeTimers();
-    vi.clearAllMocks();
-  });
-
-  afterEach(() => {
-    vi.restoreAllMocks();
-    vi.useRealTimers();
-  });
-
-  const defaultProps: GlobalSnackbarProps = {
-    message: '测试消息',
-    open: true,
-    onClose: mockOnClose,
-  };
-
-  describe('GlobalSnackbar UI 渲染', () => {
-    it('应渲染消息内容', () => {
-      render(<GlobalSnackbar {...defaultProps} />);
-      expect(screen.getByText('测试消息')).toBeInTheDocument();
-    });
-
-    it('当 showAlert 为 true 时应渲染带样式的提示', () => {
-      render(<GlobalSnackbar {...defaultProps} showAlert={true} />);
-      // 验证是否包含消息文本
-      const alertElement = screen.getByText('测试消息');
-      expect(alertElement).toBeInTheDocument();
-      // 验证父元素有正确的样式类
-      const parent = alertElement.parentElement;
-      expect(parent).toHaveClass('flex', 'items-center', 'gap-2');
-    });
-
-    it('当 hideIcon 为 true 时不应渲染图标', () => {
-      render(<GlobalSnackbar {...defaultProps} hideIcon={true} />);
-      // 图标使用 lucide-react 的 svg 元素
-      const icon = document.querySelector('svg');
-      expect(icon).not.toBeInTheDocument();
-    });
-
-    it('应根据 severity 应用不同的样式', () => {
-      render(<GlobalSnackbar {...defaultProps} severity="error" />);
-      const message = screen.getByText('测试消息');
-      const parent = message.parentElement;
-      expect(parent).toHaveClass('bg-red-500');
-    });
-  });
-
-  describe('useSnackbarState Hook 逻辑', () => {
-    it('应返回初始状态', () => {
-      const { result } = renderHook(() => useSnackbarState());
-      expect(result.current.snackbarProps.open).toBe(false);
-      expect(result.current.snackbarProps.message).toBe('');
-    });
-
-    it('showMessage 应更新状态', () => {
-      const { result } = renderHook(() => useSnackbarState());
-
-      act(() => {
-        result.current.showMessage('新消息');
-      });
-
-      expect(result.current.snackbarProps.open).toBe(true);
-      expect(result.current.snackbarProps.message).toBe('新消息');
-    });
-
-    it('closeMessage 应关闭消息', () => {
-      const { result } = renderHook(() => useSnackbarState());
-
-      act(() => {
-        result.current.showMessage('消息');
-      });
-      act(() => {
-        result.current.closeMessage();
-      });
-
-      expect(result.current.snackbarProps.open).toBe(false);
-    });
-  });
-
-  describe('useSnackbar Context Hook 优先级', () => {
-    it('优先级验证: Call Options > Hook Options > Provider Options', () => {
-      const wrapper = ({ children }: { children: React.ReactNode }) => (
-        <SnackbarProvider initialOptions={{ severity: 'info' }}>{children}</SnackbarProvider>
-      );
-
-      const { result } = renderHook(() => useSnackbar({ severity: 'warning' }), { wrapper });
-
-      // 1. 测试 Hook Options 覆盖 Provider Options
-      act(() => {
-        result.current.showMessage('消息 1');
-      });
-
-      expect(screen.getByText('消息 1')).toBeInTheDocument();
-
-      // 2. 测试 Call Options 覆盖 Hook Options
-      act(() => {
-        result.current.showMessage('消息 2', { severity: 'error' });
-      });
-
-      expect(screen.getByText('消息 2')).toBeInTheDocument();
-    });
-  });
-});

components/__tests__/ToolCard.test.tsx

@@ -1,118 +0,0 @@
-import { beforeEach, describe, expect, it, vi } from 'vitest';
-import { act, fireEvent, render, screen } from '@testing-library/react';
-import userEvent from '@testing-library/user-event';
-import ToolCard from '@/pages/Dashboard/ToolCard';
-import { Clock } from 'lucide-react';
-
-describe('ToolCard 组件', () => {
-  beforeEach(() => {
-    vi.clearAllMocks();
-  });
-
-  describe('渲染测试', () => {
-    it('应渲染标题和描述', () => {
-      render(
-        <ToolCard
-          title="测试工具"
-          description="这是一个测试工具"
-          colorKey="primary"
-          icon={Clock}
-          onNavigate={() => {}}
-        />,
-      );
-
-      expect(screen.getByText('测试工具')).toBeInTheDocument();
-      expect(screen.getByText('这是一个测试工具')).toBeInTheDocument();
-    });
-
-    it('无描述时仅渲染标题', () => {
-      render(<ToolCard title="仅标题" colorKey="primary" icon={Clock} onNavigate={() => {}} />);
-
-      expect(screen.getByText('仅标题')).toBeInTheDocument();
-    });
-
-    it('应渲染图标', () => {
-      const { container } = render(
-        <ToolCard title="带图标" colorKey="primary" icon={Clock} onNavigate={() => {}} />,
-      );
-
-      const svgElement = container.querySelector('svg');
-      expect(svgElement).toBeInTheDocument();
-    });
-
-    it('提供快照内容时应渲染快照', () => {
-      render(
-        <ToolCard
-          title="带快照"
-          colorKey="primary"
-          icon={Clock}
-          onNavigate={() => {}}
-          snapshot={<div data-testid="snapshot">快照内容</div>}
-        />,
-      );
-
-      expect(screen.getByTestId('snapshot')).toBeInTheDocument();
-    });
-
-    it('未提供快照时不渲染快照区域', () => {
-      const { container } = render(
-        <ToolCard
-          title="无快照"
-          colorKey="primary"
-          icon={Clock}
-          onClick={() => {}}
-          onNavigate={function (): void {
-            throw new Error('Function not implemented.');
-          }}
-        />,
-      );
-
-      expect(container.querySelector('[data-testid="snapshot"]')).not.toBeInTheDocument();
-    });
-
-    it('应使用 CardActionArea 渲染，支持键盘聚焦', () => {
-      render(<ToolCard title="可聚焦" colorKey="primary" icon={Clock} onNavigate={() => {}} />);
-
-      const button = screen.getByRole('button', { name: /可聚焦/ });
-      expect(button).toBeInTheDocument();
-    });
-  });
-
-  describe('交互测试', () => {
-    it('点击时应调用 onClick', () => {
-      const handleClick = vi.fn();
-      render(<ToolCard title="可点击" colorKey="primary" icon={Clock} onNavigate={handleClick} />);
-
-      const button = screen.getByRole('button', { name: /可点击/ });
-      fireEvent.click(button);
-
-      expect(handleClick).toHaveBeenCalledTimes(1);
-    });
-
-    it('按 Enter 键时应调用 onClick', async () => {
-      const handleClick = vi.fn();
-      render(
-        <ToolCard title="键盘可触发" colorKey="primary" icon={Clock} onNavigate={handleClick} />,
-      );
-
-      const button = screen.getByRole('button', { name: /键盘可触发/ });
-      await act(async () => {
-        button.focus();
-        await userEvent.keyboard('{Enter}');
-      });
-
-      expect(handleClick).toHaveBeenCalledTimes(1);
-    });
-  });
-
-  describe('样式测试', () => {
-    it('应应用自定义颜色代码', () => {
-      const { container } = render(
-        <ToolCard title="自定义颜色" colorKey="warning" icon={Clock} onNavigate={() => {}} />,
-      );
-
-      const svgElement = container.querySelector('svg');
-      expect(svgElement).toBeInTheDocument();
-    });
-  });
-});

docs/VISUAL_STYLE_GUIDE.md

@@ -0,0 +1,871 @@
+# Testing Tools — 视觉规范文档
+
+> **版本**: 1.0.0  
+> **日期**: 2026-05-29  
+> **适用范围**: 所有新页面、新组件、UI 修改  
+> **设计系统**: 基于 [shadcn/ui](https://ui.shadcn.com/) + Tailwind CSS
+
+---
+
+## 目录
+
+1. [设计原则](#1-设计原则)
+2. [色彩系统](#2-色彩系统)
+3. [排版规范](#3-排版规范)
+4. [间距与布局](#4-间距与布局)
+5. [圆角与阴影](#5-圆角与阴影)
+6. [组件规范](#6-组件规范)
+7. [交互与动效](#7-交互与动效)
+8. [暗色模式](#8-暗色模式)
+9. [工具色彩标识](#9-工具色彩标识)
+10. [代码规范](#10-代码规范)
+11. [反模式清单](#11-反模式清单)
+
+---
+
+## 1. 设计原则
+
+### 1.1 核心定位
+
+Testing Tools 是一款**浏览器扩展开发者工具集**，视觉风格遵循：
+
+- **专业克制** — 低饱和度色彩，避免视觉噪音
+- **信息密度优先** — 紧凑布局，在 400×600px 的 popup 空间内高效展示
+- **开发者友好** — 等宽字体用于代码/数据，清晰的信息层级
+- **一致性至上** — 所有页面、组件遵循同一套视觉语言
+
+### 1.2 设计关键词
+
+```
+简洁 · 现代 · 功能导向 · 低对比度 · 微圆角 · 微妙阴影
+```
+
+### 1.3 与 shadcn/ui 的关系
+
+本项目以 shadcn/ui 为底座，所有基础组件（Button、Input、Select 等）均来自或对齐 shadcn/ui 的默认样式。业务组件在此基础上扩展，**不得破坏底层设计语言的统一性**。
+
+---
+
+## 2. 色彩系统
+
+### 2.1 CSS 变量定义
+
+所有色彩通过 CSS 自定义属性（HSL 格式）管理，定义于 `src/index.css`：
+
+#### 亮色模式 (`:root`)
+
+| 变量名                     | HSL 值              | 用途          | 近似色    |
+| -------------------------- | ------------------- | ------------- | --------- |
+| `--background`             | `0 0% 100%`         | 页面背景      | `#ffffff` |
+| `--foreground`             | `222.2 84% 4.9%`    | 主文字        | `#020617` |
+| `--card`                   | `0 0% 100%`         | 卡片背景      | `#ffffff` |
+| `--card-foreground`        | `222.2 84% 4.9%`    | 卡片文字      | `#020617` |
+| `--popover`                | `0 0% 100%`         | 浮层背景      | `#ffffff` |
+| `--popover-foreground`     | `222.2 84% 4.9%`    | 浮层文字      | `#020617` |
+| `--primary`                | `222.2 47.4% 11.2%` | 主按钮/强调   | `#0f172a` |
+| `--primary-foreground`     | `210 40% 98%`       | 主按钮文字    | `#f8fafc` |
+| `--secondary`              | `210 40% 96.1%`     | 次级背景      | `#f1f5f9` |
+| `--secondary-foreground`   | `222.2 47.4% 11.2%` | 次级文字      | `#0f172a` |
+| `--muted`                  | `210 40% 96.1%`     | 静音/禁用背景 | `#f1f5f9` |
+| `--muted-foreground`       | `215.4 16.3% 46.9%` | 次要文字      | `#64748b` |
+| `--accent`                 | `210 40% 96.1%`     | 悬停高亮      | `#f1f5f9` |
+| `--accent-foreground`      | `222.2 47.4% 11.2%` | 悬停文字      | `#0f172a` |
+| `--destructive`            | `0 84.2% 60.2%`     | 错误/删除     | `#ef4444` |
+| `--destructive-foreground` | `210 40% 98%`       | 错误文字      | `#f8fafc` |
+| `--border`                 | `214.3 31.8% 91.4%` | 边框          | `#e2e8f0` |
+| `--input`                  | `214.3 31.8% 91.4%` | 输入框边框    | `#e2e8f0` |
+| `--ring`                   | `222.2 84% 4.9%`    | 焦点环        | `#020617` |
+| `--radius`                 | `0.5rem`            | 全局圆角      | `8px`     |
+
+#### 暗色模式 (`.dark`)
+
+暗色模式下所有变量自动反转，保持对比度关系：
+
+| 变量名                 | HSL 值              | 近似色    |
+| ---------------------- | ------------------- | --------- |
+| `--background`         | `222.2 84% 4.9%`    | `#020617` |
+| `--foreground`         | `210 40% 98%`       | `#f8fafc` |
+| `--primary`            | `210 40% 98%`       | `#f8fafc` |
+| `--primary-foreground` | `222.2 47.4% 11.2%` | `#0f172a` |
+| `--secondary`          | `217.2 32.6% 17.5%` | `#1e293b` |
+| `--muted`              | `217.2 32.6% 17.5%` | `#1e293b` |
+| `--border`             | `217.2 32.6% 17.5%` | `#1e293b` |
+
+### 2.2 使用规范
+
+```tsx
+// ✅ 正确：使用 CSS 变量
+<div className="bg-background text-foreground border-border">
+
+// ✅ 正确：使用语义化色彩名
+<Button className="bg-primary text-primary-foreground">
+<span className="text-muted-foreground">
+
+// ❌ 错误：硬编码颜色值
+<div className="bg-white text-black">
+<div className="bg-[#f1f5f9]">
+```
+
+### 2.3 语义化色彩使用场景
+
+| 色彩                       | 场景                             |
+| -------------------------- | -------------------------------- |
+| `background`               | 页面根背景                       |
+| `foreground`               | 主标题、正文                     |
+| `muted-foreground`         | 描述文字、占位符、次级标签       |
+| `border`                   | 卡片边框、分割线、输入框边框     |
+| `card` + `card-foreground` | 卡片容器及其内容                 |
+| `primary`                  | 主按钮、选中状态、关键操作       |
+| `secondary`                | 次级按钮、工具栏背景、标签页背景 |
+| `destructive`              | 错误提示、删除操作、验证失败     |
+| `accent`                   | 悬停背景、下拉选中项             |
+
+---
+
+## 3. 排版规范
+
+### 3.1 字体栈
+
+项目使用系统默认字体栈（Tailwind 默认），**不引入自定义字体**。
+
+```css
+/* Tailwind 默认 sans-serif */
+font-family:
+  ui-sans-serif,
+  system-ui,
+  -apple-system,
+  BlinkMacSystemFont,
+  'Segoe UI',
+  Roboto,
+  'Helvetica Neue',
+  Arial,
+  sans-serif;
+
+/* 等宽字体用于代码/数据 */
+font-family:
+  ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, 'Liberation Mono', 'Courier New', monospace;
+```
+
+### 3.2 字号层级
+
+| 层级      | 类名                                             | 大小 | 字重    | 用途                   |
+| --------- | ------------------------------------------------ | ---- | ------- | ---------------------- |
+| 页面标题  | `text-base font-bold`                            | 16px | 700     | 页面主标题（极少使用） |
+| 卡片标题  | `text-sm font-bold tracking-tight`               | 14px | 700     | 卡片/区块标题          |
+| 正文      | `text-sm`                                        | 14px | 400     | 普通正文               |
+| 次级文字  | `text-xs`                                        | 12px | 400/500 | 描述、标签             |
+| 微标签    | `text-[10px] font-bold uppercase tracking-wider` | 10px | 700     | 区域标签、分类标题     |
+| 数据/代码 | `font-mono text-sm`                              | 14px | 400     | 时间戳、JSON、代码     |
+
+### 3.3 排版模式
+
+```tsx
+// 区域标签（Section Label）— 最常用
+<span className="text-[10px] font-bold text-muted-foreground/90 uppercase tracking-wider">
+  输出结果
+</span>
+
+// 卡片标题
+<h4 className="font-bold text-sm tracking-tight text-foreground leading-snug">
+  标题文字
+</h4>
+
+// 描述文字
+<p className="text-[11px] font-medium text-muted-foreground/90 leading-normal">
+  描述内容
+</p>
+
+// 数据展示
+<span className="font-mono font-bold text-foreground text-sm tracking-tight tabular-nums">
+  1716950400000
+</span>
+```
+
+### 3.4 行高与字间距
+
+| 属性              | 值       | 场景               |
+| ----------------- | -------- | ------------------ |
+| `leading-none`    | 1        | 单行数据、紧凑布局 |
+| `leading-snug`    | 1.375    | 标题、短文本       |
+| `leading-relaxed` | 1.625    | 长文本、代码块     |
+| `tracking-tight`  | -0.025em | 标题、数据         |
+| `tracking-wider`  | 0.05em   | 大写标签           |
+
+---
+
+## 4. 间距与布局
+
+### 4.1 容器尺寸
+
+```tsx
+// Popup 模式（默认）
+<div className="w-[400px] max-w-[400px] min-w-[400px] h-[600px] min-h-[600px]">
+
+// Tab 模式（全屏自适应）
+<div className="sm:w-screen sm:max-w-none sm:min-w-0 sm:h-screen sm:min-h-0">
+```
+
+### 4.2 间距节奏
+
+| Token           | 值          | 使用场景           |
+| --------------- | ----------- | ------------------ |
+| `p-3` / `p-3.5` | 12px / 14px | 页面内边距（紧凑） |
+| `p-4`           | 16px        | 标准页面内边距     |
+| `p-5`           | 20px        | 卡片内部填充       |
+| `gap-2`         | 8px         | 紧凑元素间距       |
+| `gap-3`         | 12px        | 标准元素间距       |
+| `gap-4`         | 16px        | 区块间距           |
+| `gap-6`         | 24px        | 大区块间距         |
+
+### 4.3 布局模式
+
+#### 页面布局
+
+```tsx
+// 标准页面结构
+<div className="p-4 w-full flex flex-col space-y-4 min-h-[500px] select-none">{/* 页面内容 */}</div>
+```
+
+#### 卡片布局
+
+```tsx
+// 标准卡片
+<div className="p-5 rounded-xl border border-border bg-card text-card-foreground shadow-sm">
+  {/* 卡片内容 */}
+</div>
+
+// 可聚焦卡片（含焦点环）
+<div className="border border-border rounded-xl bg-card ... focus-within:ring-1 focus-within:ring-ring focus-within:border-ring">
+```
+
+#### 双栏网格
+
+```tsx
+// 响应式双栏
+<div className="grid grid-cols-1 md:grid-cols-2 gap-4 items-stretch">
+```
+
+#### 工具卡片网格（Dashboard）
+
+```tsx
+// Dashboard 紧凑网格
+<div className="grid grid-cols-3 sm:grid-cols-4 md:grid-cols-5 lg:grid-cols-6 gap-2">
+```
+
+---
+
+## 5. 圆角与阴影
+
+### 5.1 圆角体系
+
+| Token          | 值     | 使用元素               |
+| -------------- | ------ | ---------------------- |
+| `rounded-sm`   | 2px    | Checkbox、小标签       |
+| `rounded-md`   | 6px    | 按钮、输入框、Select   |
+| `rounded-lg`   | 8px    | 搜索框、小卡片         |
+| `rounded-xl`   | 12px   | 大卡片、面板、图标容器 |
+| `rounded-full` | 9999px | 标签、Avatar           |
+
+### 5.2 阴影体系
+
+| 级别 | 类名                  | 用途                   |
+| ---- | --------------------- | ---------------------- |
+| 无   | —                     | 静态元素               |
+| 低   | `shadow-sm`           | 卡片、输入框、按钮     |
+| 中   | `shadow-lg`           | 下拉菜单、浮层、Dialog |
+| 动态 | 自定义 `shadow-[...]` | 卡片悬停时的彩色阴影   |
+
+### 5.3 彩色阴影规范（工具卡片专用）
+
+```tsx
+// 工具卡片悬停阴影 — 必须使用 rgba 格式配合 CSS 变量
+className="hover:shadow-[0_8px_24px_-8px_rgba(var(--tool-color),0.14)]
+           dark:hover:shadow-[0_8px_30px_-10px_rgba(var(--tool-color),0.25)]"
+```
+
+---
+
+## 6. 组件规范
+
+### 6.1 Button
+
+来源：`src/components/ui/button.tsx`
+
+#### 变体
+
+| 变体          | 类名                                         | 场景               |
+| ------------- | -------------------------------------------- | ------------------ |
+| `default`     | `bg-primary text-primary-foreground`         | 主操作             |
+| `destructive` | `bg-destructive text-destructive-foreground` | 删除、危险操作     |
+| `outline`     | `border border-input bg-background`          | 次级操作、取消     |
+| `secondary`   | `bg-secondary text-secondary-foreground`     | 次要操作           |
+| `ghost`       | 仅悬停背景                                   | 图标按钮、低优先级 |
+| `link`        | 下划线文字                                   | 跳转链接           |
+
+#### 尺寸
+
+| 尺寸      | 高度    | 内边距      | 场景     |
+| --------- | ------- | ----------- | -------- |
+| `default` | 40px    | `px-4 py-2` | 标准按钮 |
+| `sm`      | 36px    | `px-3`      | 紧凑按钮 |
+| `lg`      | 44px    | `px-8`      | 突出按钮 |
+| `icon`    | 40×40px | —           | 图标按钮 |
+
+#### 使用示例
+
+```tsx
+// 主操作
+<Button>确认</Button>
+
+// 图标按钮
+<Button variant="ghost" size="icon">
+  <Copy className="h-4 w-4" />
+</Button>
+
+// 危险操作
+<Button variant="destructive" size="sm">删除</Button>
+```
+
+### 6.2 Input
+
+来源：`src/components/ui/input.tsx`
+
+```tsx
+// 标准输入框
+<Input
+  className="font-mono font-semibold h-10 shadow-sm placeholder:text-muted-foreground/60 focus:bg-background"
+/>
+
+// 错误状态
+<Input
+  className="border-destructive focus-visible:ring-destructive"
+/>
+```
+
+**规范要点**：
+
+- 高度统一为 `h-10`（40px）
+- 等宽字体用于数据输入
+- 占位符使用 `text-muted-foreground/60`
+- 错误时边框变红并调整焦点环
+
+### 6.3 SwitchButtonGroup
+
+来源：`src/components/ui/switch.tsx`
+
+```tsx
+// 分段控制器
+<SwitchButtonGroup
+  value={mode}
+  options={[
+    { value: 'ts2dt', label: '转日期' },
+    { value: 'dt2ts', label: '转时间戳' },
+  ]}
+  onChange={setMode}
+  size="small"
+/>
+```
+
+**规范要点**：
+
+- 容器：`rounded-lg bg-muted p-1`
+- 选中项：`bg-background text-foreground shadow-sm font-semibold`
+- 未选中项：`hover:bg-background/50 hover:text-foreground/80`
+- 尺寸：`small`（32px）用于工具页，`medium`（36px）标准
+
+### 6.4 Card（工具卡片）
+
+来源：`src/pages/Dashboard/ToolCard.tsx`
+
+```tsx
+// 标准工具卡片结构
+<div className="group relative rounded-xl border border-border/70 bg-card p-4 h-auto flex flex-col gap-3 shadow-sm">
+  {/* 上半部分：图标 + 标题 + 箭头 */}
+  <div className="flex items-center justify-between">
+    <div className="flex gap-3 items-center">
+      {/* 图标容器 */}
+      <div className="flex items-center justify-center w-10 h-10 rounded-xl bg-[rgba(var(--tool-color),0.08)] text-[rgb(var(--tool-color))]">
+        <Icon className="h-5 w-5" />
+      </div>
+      {/* 文字 */}
+      <div>
+        <h4 className="font-bold text-sm">标题</h4>
+        <p className="text-[11px] text-muted-foreground/90">描述</p>
+      </div>
+    </div>
+    <ChevronRight className="h-4 w-4" />
+  </div>
+  {/* 下半部分：预览区（可选） */}
+  <div className="mt-1 pt-3 border-t border-dashed border-border/80">{snapshot}</div>
+</div>
+```
+
+### 6.5 TextInputArea
+
+来源：`src/components/TextInputArea.tsx`
+
+```tsx
+// 多行文本输入区
+<TextInputArea
+  value={input}
+  onChange={setInput}
+  placeholder="输入内容..."
+  showCount={true}
+  showClear={true}
+  allowCopy={true}
+  minRows={6}
+  maxRows={12}
+/>
+```
+
+**规范要点**：
+
+- 外容器：`rounded-md border border-input bg-background shadow-sm`
+- 焦点状态：`focus-within:ring-1 focus-within:ring-ring`
+- 错误状态：`border-destructive focus-within:ring-destructive`
+- 底部工具栏：`h-10 bg-muted/30 border-t border-border/50`
+- 字体：`font-mono text-sm`
+
+### 6.6 Dialog
+
+来源：`src/components/ui/dialog.tsx`
+
+```tsx
+// 对话框内容
+<DialogContent className="sm:rounded-lg">
+  <DialogHeader>
+    <DialogTitle>标题</DialogTitle>
+    <DialogDescription>描述文字</DialogDescription>
+  </DialogHeader>
+  {/* 内容 */}
+  <DialogFooter>
+    <Button variant="outline">取消</Button>
+    <Button>确认</Button>
+  </DialogFooter>
+</DialogContent>
+```
+
+### 6.7 Select
+
+来源：`src/components/ui/select.tsx`
+
+```tsx
+<Select>
+  <SelectTrigger className="h-9 shadow-sm bg-background">
+    <SelectValue />
+  </SelectTrigger>
+  <SelectContent className="max-h-64">
+    <SelectItem className="text-xs font-semibold focus:bg-accent cursor-pointer">选项</SelectItem>
+  </SelectContent>
+</Select>
+```
+
+### 6.8 Checkbox
+
+来源：`src/components/ui/checkbox.tsx`
+
+```tsx
+// 标准复选框
+<Checkbox className="h-4 w-4 rounded-sm border-primary data-[state=checked]:bg-primary" />
+
+// 小型复选框（工具栏内）
+<Checkbox className="h-3.5 w-3.5 rounded border-input data-[state=checked]:bg-primary shadow-sm" />
+```
+
+### 6.9 Badge
+
+来源：`src/components/ui/badge.tsx`
+
+| 变体          | 场景               |
+| ------------- | ------------------ |
+| `default`     | 状态标签、分类     |
+| `secondary`   | 次要标签           |
+| `destructive` | 错误标签           |
+| `outline`     | 可点击标签、筛选器 |
+
+### 6.10 CopyButton
+
+来源：`src/components/CopyButton.tsx`
+
+```tsx
+// 标准复制按钮
+<CopyButton text={content} />
+
+// 小型复制按钮
+<CopyButton text={content} size="sm" className="h-7 w-7 rounded-md border" />
+```
+
+**规范要点**：
+
+- 默认 `variant="ghost" size="icon"`
+- 复制成功后变为绿色背景 + 对勾图标
+- 使用 `sonner` toast 提示复制结果
+
+---
+
+## 7. 交互与动效
+
+### 7.1 过渡规范
+
+| 属性                | 值         | 场景                          |
+| ------------------- | ---------- | ----------------------------- |
+| `transition-colors` | 150ms ease | 色彩变化（悬停、焦点）        |
+| `transition-all`    | 150ms ease | 综合变化（SwitchButtonGroup） |
+| `duration-200`      | 200ms      | 复制按钮状态切换              |
+
+### 7.2 焦点状态
+
+所有可交互元素必须有可见的焦点指示器：
+
+```tsx
+// 标准焦点环
+focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2
+
+// 紧凑焦点环（图标按钮）
+focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring
+
+// 输入框焦点
+focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2
+```
+
+### 7.3 悬停状态
+
+```tsx
+// 按钮悬停
+hover:bg-accent hover:text-accent-foreground
+
+// 卡片悬停
+hover:bg-muted/30 hover:border-[rgba(var(--tool-color),0.45)]
+
+// 链接/文字悬停
+hover:text-foreground hover:underline
+```
+
+### 7.4 动画规范
+
+使用 `tailwindcss-animate` 提供的动画：
+
+```tsx
+// 淡入
+animate-in fade-in duration-150
+
+// 淡入 + 缩放（SwitchButtonGroup 选中项）
+animate-in fade-in-50 zoom-in-95 duration-150
+
+// 从顶部滑入（下拉菜单）
+animate-in fade-in slide-in-from-top-2 duration-150
+
+// 错误提示出现
+animate-in fade-in slide-in-from-top-1 duration-150
+
+// 骨架屏脉冲
+animate-pulse
+```
+
+### 7.5 禁用状态
+
+```tsx
+// 统一禁用样式
+disabled:pointer-events-none disabled:opacity-50
+```
+
+---
+
+## 8. 暗色模式
+
+### 8.1 实现方式
+
+通过 `darkMode: 'class'`（Tailwind 配置）+ `.dark` 类切换：
+
+```tsx
+// ThemeModeProvider 自动处理
+document.documentElement.classList.toggle('dark', resolvedMode === 'dark');
+```
+
+### 8.2 暗色模式下的特殊处理
+
+```tsx
+// 彩色阴影增强（暗色模式下阴影需要更高透明度）
+shadow-[0_8px_24px_-8px_rgba(var(--tool-color),0.14)]
+dark:shadow-[0_8px_30px_-10px_rgba(var(--tool-color),0.25)]
+
+// 图标容器背景增强
+bg-[rgba(var(--tool-color),0.08)]
+dark:bg-[rgba(var(--tool-color),0.12)]
+
+// 成功状态文字调整
+text-emerald-600 dark:text-emerald-400
+```
+
+### 8.3 暗色模式色彩映射原则
+
+| 亮色             | 暗色             | 说明                            |
+| ---------------- | ---------------- | ------------------------------- |
+| 纯白背景         | 深蓝黑背景       | 避免纯黑 `#000`，使用 `#020617` |
+| 浅灰背景         | 深灰背景         | 保持层次关系                    |
+| 深文字           | 浅文字           | 反转对比度                      |
+| 彩色阴影低透明度 | 彩色阴影高透明度 | 暗色需要更强视觉反馈            |
+
+---
+
+## 9. 工具色彩标识
+
+### 9.1 色板定义
+
+每个工具分配一个主题色，定义于 `src/config/features.tsx`：
+
+```ts
+const PALETTE_COLORS: Record<PaletteColorKey, string> = {
+  primary: '13, 148, 136', // teal (#0d9488)
+  success: '22, 163, 74', // green (#16a34a)
+  warning: '217, 119, 6', // amber (#d97706)
+  error: '220, 38, 38', // red (#dc2626)
+  secondary: '147, 51, 232', // purple (#9333e8)
+  info: '37, 99, 235', // blue (#2563eb)
+};
+```
+
+### 9.2 工具色彩分配
+
+| 工具        | 色彩键      | 色值   |
+| ----------- | ----------- | ------ |
+| 时间戳转换  | `primary`   | Teal   |
+| 存储清理    | `warning`   | Amber  |
+| 二维码工具  | `success`   | Green  |
+| 文本统计    | `secondary` | Purple |
+| JWT 解析    | `info`      | Blue   |
+| JSON 对比   | `primary`   | Teal   |
+| Base64 转换 | `info`      | Blue   |
+| 右键还原    | `success`   | Green  |
+
+### 9.3 工具色彩使用规范
+
+```tsx
+// 1. 通过 style 注入 CSS 变量
+<div style={{ ['--tool-color' as string]: rgbValues }}>
+
+// 2. 图标容器背景（低透明度）
+bg-[rgba(var(--tool-color),0.08)]
+dark:bg-[rgba(var(--tool-color),0.12)]
+
+// 3. 图标颜色
+ text-[rgb(var(--tool-color))]
+
+// 4. 悬停边框
+hover:border-[rgba(var(--tool-color),0.45)]
+
+// 5. 悬停阴影
+hover:shadow-[0_8px_24px_-8px_rgba(var(--tool-color),0.14)]
+
+// 6. 箭头悬停色
+group-hover:text-[rgb(var(--tool-color))]
+```
+
+**注意**：工具色彩仅用于**标识和装饰**，不得用于功能性色彩（如成功/错误状态）。
+
+---
+
+## 10. 代码规范
+
+### 10.1 Tailwind 类名组织顺序
+
+使用 `cn()` 工具函数（`clsx` + `tailwind-merge`）组合类名，按以下顺序排列：
+
+```tsx
+className={cn(
+  // 1. 布局（display, position, flex, grid）
+  'flex items-center justify-between',
+  // 2. 尺寸（width, height, padding, margin）
+  'w-full h-10 px-4',
+  // 3. 外观（background, border, shadow, rounded）
+  'rounded-md border border-input bg-background shadow-sm',
+  // 4. 文字（color, font, text-align）
+  'text-sm font-medium text-foreground',
+  // 5. 交互（hover, focus, disabled, cursor）
+  'hover:bg-accent focus-visible:ring-2 disabled:opacity-50',
+  // 6. 动画（transition, animate）
+  'transition-colors duration-150',
+  // 7. 条件类
+  isActive && 'bg-primary text-primary-foreground',
+  // 8. 外部传入
+  className,
+)}
+```
+
+### 10.2 颜色使用检查清单
+
+- [ ] 所有颜色使用 CSS 变量（`bg-background` 而非 `bg-white`）
+- [ ] 边框使用 `border-border` 及其透明度变体
+- [ ] 文字层级使用 `foreground` → `muted-foreground` → `muted-foreground/60`
+- [ ] 错误状态使用 `destructive` 系列
+- [ ] 工具色彩仅用于装饰性元素
+
+### 10.3 组件文件组织
+
+```
+src/
+├── components/ui/          # shadcn 基础组件（只读，不修改）
+├── components/             # 业务组件
+│   ├── CopyButton.tsx
+│   ├── SwitchButtonGroup.tsx
+│   ├── TextInputArea.tsx
+│   └── ...
+├── pages/                  # 页面组件
+│   ├── <ToolName>/
+│   │   ├── index.tsx       # 页面入口
+│   │   ├── use<ToolName>.ts # 业务逻辑 Hook
+│   │   └── components/     # 页面私有组件
+│   └── ...
+└── providers/              # Context Providers
+```
+
+### 10.4 新增页面模板
+
+```tsx
+// src/pages/NewTool/index.tsx
+import SwitchButtonGroup from '@/components/SwitchButtonGroup';
+import { useI18n } from '@/utils/chromeI18n';
+import { cn } from '@/lib/utils';
+
+export default function Index() {
+  const { t } = useI18n('newTool');
+
+  return (
+    <div className="p-4 w-full flex flex-col space-y-4 min-h-[500px] select-none">
+      {/* 页面内容 */}
+      <div className="p-5 rounded-xl border border-border bg-card text-card-foreground shadow-sm">
+        <h4 className="font-bold text-sm tracking-tight">{t('newTool:title')}</h4>
+      </div>
+    </div>
+  );
+}
+```
+
+---
+
+## 11. 反模式清单
+
+以下模式**禁止**在项目中使用：
+
+### 11.1 色彩反模式
+
+```tsx
+// ❌ 硬编码颜色
+<div className="bg-white text-black">
+<div className="bg-gray-100">
+<div className="text-gray-500">
+
+// ❌ 使用非语义化 Tailwind 颜色
+<div className="bg-slate-50">
+<div className="text-zinc-400">
+
+// ✅ 使用 CSS 变量
+<div className="bg-background text-foreground">
+<div className="bg-muted text-muted-foreground">
+```
+
+### 11.2 布局反模式
+
+```tsx
+// ❌ 固定高度导致内容截断
+<div className="h-[200px]">
+
+// ✅ 使用 min-height 或自适应
+<div className="min-h-[200px]">
+<div className="h-auto">
+
+// ❌ 使用 margin 做组件间距
+<div className="mb-4">
+
+// ✅ 使用 gap
+<div className="flex flex-col gap-4">
+```
+
+### 11.3 组件反模式
+
+```tsx
+// ❌ 修改 shadcn/ui 基础组件样式
+// 如需修改，通过 className 覆盖或创建包装组件
+
+// ❌ 内联样式用于颜色（工具色彩除外）
+<div style={{ backgroundColor: '#f1f5f9' }}>
+
+// ❌ 混合使用不同圆角体系
+<Button className="rounded-lg">  // Button 应为 rounded-md
+
+// ❌ 忽略焦点状态
+<button className="...">  // 缺少 focus-visible 样式
+```
+
+### 11.4 暗色模式反模式
+
+```tsx
+// ❌ 仅适配部分元素
+<div className="bg-white text-black dark:bg-gray-900 dark:text-white">
+
+// ✅ 使用 CSS 变量自动适配
+<div className="bg-background text-foreground">
+
+// ❌ 暗色模式下使用不合适的透明度
+<div className="bg-black/5 dark:bg-white/5">  // 对比度不足
+
+// ✅ 使用语义化变量
+<div className="bg-muted">
+```
+
+---
+
+## 12. 附录
+
+### 12.1 常用类名速查
+
+```
+// 页面容器
+p-4 w-full flex flex-col space-y-4 min-h-[500px] select-none
+
+// 标准卡片
+p-5 rounded-xl border border-border bg-card text-card-foreground shadow-sm
+
+// 工具栏
+flex h-10 items-center justify-between px-1.5 bg-secondary/40 rounded-xl border border-border/60
+
+// 区域标签
+text-[10px] font-bold text-muted-foreground/90 uppercase tracking-wider
+
+// 数据展示
+font-mono font-semibold text-foreground text-sm
+
+// 错误提示
+text-xs font-medium text-destructive
+
+// 空状态
+p-8 rounded-xl bg-muted/30 border border-dashed border-border/80 text-center
+
+// 图标按钮容器
+flex h-8 w-8 items-center justify-center rounded-md border border-input bg-background shadow-sm
+
+// 焦点环
+focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2
+```
+
+### 12.2 相关文件
+
+| 文件                                  | 说明                    |
+| ------------------------------------- | ----------------------- |
+| `src/index.css`                       | CSS 变量定义、全局样式  |
+| `tailwind.config.js`                  | Tailwind 配置、色彩映射 |
+| `src/lib/utils.ts`                    | `cn()` 工具函数         |
+| `src/components/ui/*.tsx`             | shadcn/ui 基础组件      |
+| `src/config/features.tsx`             | 工具配置、色彩分配      |
+| `src/providers/ThemeModeProvider.tsx` | 主题模式管理            |
+
+### 12.3 参考资源
+
+- [shadcn/ui 文档](https://ui.shadcn.com/docs)
+- [Tailwind CSS 文档](https://tailwindcss.com/docs)
+- [Radix UI 文档](https://www.radix-ui.com/)
+- [Lucide Icons](https://lucide.dev/)
+
+---
+
+_本文档随项目迭代更新。新增组件或修改视觉风格时，请同步更新此文档。_

docs/test-data-generator/README.md

@@ -0,0 +1,21 @@
+# 测试数据生成器 - 功能设计文档
+
+> 版本: v1.0
+> 创建时间: 2024-01-20
+> 状态: 待 Review
+
+## 产品定位
+
+**轻量级可视化测试数据生成器**
+
+- 纯前端工具，无需后端
+- 可视化配置，无需编码
+- 本地生成，数据安全
+
+## 目录
+
+- [核心功能](./core-features.md)
+- [生成器库](./generators.md)
+- [规则管理](./rule-management.md)
+- [界面设计](./ui-design.md)
+- [技术实现](./technical-implementation.md)

docs/test-data-generator/TASKS.md

@@ -0,0 +1,384 @@
+# 测试数据生成器 - 实现任务列表
+
+> 创建时间: 2026-06-06
+> 状态: ✅ 已完成
+
+## 总体进度
+
+| 子功能                     | 状态      | 预估工时  |
+| -------------------------- | --------- | --------- |
+| 1. 类型定义与项目配置      | ✅ 已完成 | 0.5h      |
+| 2. 生成器库                | ✅ 已完成 | 4h        |
+| 3. Web Worker 数据生成引擎 | ✅ 已完成 | 2h        |
+| 4. 规则存储与管理          | ✅ 已完成 | 2h        |
+| 5. 数据导出功能            | ✅ 已完成 | 1h        |
+| 6. UI 组件开发             | ✅ 已完成 | 6h        |
+| 7. 页面集成与注册          | ✅ 已完成 | 1h        |
+| 8. 测试与优化              | ✅ 已完成 | 2h        |
+| **总计**                   |           | **18.5h** |
+
+---
+
+## 1. 类型定义与项目配置
+
+**目标**: 创建所有必要的类型定义文件，配置项目注册新功能
+
+### 任务清单
+
+- [x] 1.1 创建 `src/types/testDataGenerator.ts` 类型定义文件
+  - [x] 定义 `FieldConfig` 接口
+  - [x] 定义 `DataRule` 接口
+  - [x] 定义 `GeneratorDefinition` 接口
+  - [x] 定义 `GeneratorParam` 接口
+  - [x] 定义 `GenerateResult` 接口
+  - [x] 定义 `ExportFile` 接口
+
+- [x] 1.2 更新 `src/types/storage.d.ts`
+  - [x] 在 `PageType` 中添加 `'testDataGenerator'`
+  - [x] 在 `StorageSchema` 中添加测试数据生成器相关配置（如需要）
+
+- [x] 1.3 更新 `src/config/features.tsx`
+  - [x] 导入 TestDataGenerator 页面组件
+  - [x] 添加新功能配置到 `FEATURES` 数组
+  - [x] 选择合适的图标（如 `Database` 或 `FileSpreadsheet`）
+
+- [x] 1.4 更新国际化配置
+  - [x] 添加 `testDataGenerator_title` 翻译
+  - [x] 添加 `testDataGenerator_description` 翻译
+
+---
+
+## 2. 生成器库
+
+**目标**: 实现 21 个数据生成器，支持多种生成策略
+
+### 任务清单
+
+#### 2.1 生成器基础框架
+
+- [x] 2.1.1 创建 `src/lib/generators/types.ts`
+  - [x] 定义生成器内部类型（与 `testDataGenerator.ts` 分离）
+
+- [x] 2.1.2 创建 `src/lib/generators/index.ts`
+  - [x] 导出所有生成器
+  - [x] 导出 `generatorCategories` 配置
+
+#### 2.2 个人信息生成器 (6个)
+
+- [x] 2.2.1 创建 `src/lib/generators/personal.ts`
+  - [x] 实现 `chineseName` 生成器
+    - [x] `generate()` 方法
+    - [x] `generateAtIndex()` 方法
+  - [x] 实现 `email` 生成器
+    - [x] `generate()` 方法
+    - [x] `generateAtIndex()` 方法
+  - [x] 实现 `chinesePhone` 生成器
+    - [x] `generate()` 方法
+    - [x] `generateAtIndex()` 方法
+  - [x] 实现 `idCard` 生成器
+    - [x] `generate()` 方法
+    - [x] `generateAtIndex()` 方法
+  - [x] 实现 `chineseAddress` 生成器
+    - [x] `generate()` 方法
+    - [x] `generateAtIndex()` 方法
+  - [x] 实现 `age` 生成器
+    - [x] `generate()` 方法（支持 realistic/uniform/demographic 策略）
+    - [x] `generateAtIndex()` 方法
+    - [x] 实现 `normalRandom()` 辅助函数
+    - [x] 实现 `demographicRandom()` 辅助函数
+
+#### 2.3 业务数据生成器 (8个)
+
+- [x] 2.3.1 创建 `src/lib/generators/business.ts`
+  - [x] 实现 `orderId` 生成器
+  - [x] 实现 `price` 生成器
+    - [x] 实现 `generatePsychologicalPrice()` 辅助函数
+    - [x] 实现 `generateRealisticPrice()` 辅助函数
+  - [x] 实现 `date` 生成器
+    - [x] 实现 `formatDate()` 辅助函数
+  - [x] 实现 `status` 生成器
+  - [x] 实现 `quantity` 生成器
+    - [x] 实现 `poissonRandom()` 辅助函数
+  - [x] 实现 `rating` 生成器
+    - [x] 实现 `skewedRandom()` 辅助函数
+  - [x] 实现 `discount` 生成器
+    - [x] 实现 `generatePsychologicalDiscount()` 辅助函数
+  - [x] 实现 `stock` 生成器
+    - [x] 实现 `exponentialRandom()` 辅助函数
+
+#### 2.4 技术数据生成器 (3个)
+
+- [x] 2.4.1 创建 `src/lib/generators/technical.ts`
+  - [x] 实现 `uuid` 生成器
+  - [x] 实现 `ipv4` 生成器
+  - [x] 实现 `url` 生成器
+
+#### 2.5 基础类型生成器 (4个)
+
+- [x] 2.5.1 创建 `src/lib/generators/basic.ts`
+  - [x] 实现 `randomInt` 生成器
+  - [x] 实现 `randomFloat` 生成器
+  - [x] 实现 `randomString` 生成器
+  - [x] 实现 `fromList` 生成器
+
+---
+
+## 3. Web Worker 数据生成引擎
+
+**目标**: 实现后台数据生成，支持进度回调和取消
+
+### 任务清单
+
+- [x] 3.1 创建 `src/workers/generator.worker.ts`
+  - [x] 实现 `self.onmessage` 处理器
+  - [x] 验证生成器是否存在
+  - [x] 实现数据生成循环
+  - [x] 实现空值率控制逻辑
+  - [x] 实现唯一性约束逻辑
+    - [x] 小数据量：随机生成 + 重试（100次上限）
+    - [x] 大数据量：索引生成策略
+  - [x] 实现进度回调（每1000条）
+  - [x] 实现完成回调（包含统计数据）
+  - [x] 实现错误回调
+
+- [x] 3.2 创建 `src/pages/TestDataGenerator/hooks/useGenerator.ts`
+  - [x] 实现 Worker 创建和销毁
+  - [x] 实现 `generate()` 方法
+  - [x] 实现 `terminate()` 方法
+  - [x] 管理进度状态
+  - [x] 管理生成结果状态
+
+---
+
+## 4. 规则存储与管理
+
+**目标**: 实现规则的持久化存储和管理功能
+
+### 任务清单
+
+- [x] 4.1 创建 `src/utils/ruleStorage.ts`
+  - [x] 定义 `STORAGE_KEY` 常量
+  - [x] 定义 `MAX_RULES = 20` 常量
+  - [x] 实现 `getAll()` 方法
+  - [x] 实现 `getById()` 方法
+  - [x] 实现 `getCount()` 方法
+  - [x] 实现 `isMaxReached()` 方法
+  - [x] 实现 `save()` 方法（含数量限制检查）
+  - [x] 实现 `update()` 方法
+  - [x] 实现 `delete()` 方法
+  - [x] 实现 `duplicate()` 方法
+  - [x] 实现 `recordUse()` 方法
+  - [x] 实现 `search()` 方法
+  - [x] 实现 `getRecent()` 方法
+  - [x] 实现 `export()` 方法
+  - [x] 实现 `import()` 方法（含格式验证）
+  - [x] 实现 `clear()` 方法
+  - [x] 实现 `validateRule()` 私有方法
+
+---
+
+## 5. 数据导出功能
+
+**目标**: 实现 JSON 和 CSV 格式的数据导出
+
+### 任务清单
+
+- [x] 5.1 创建 `src/utils/dataExporter.ts`
+  - [x] 实现 `toJSON()` 静态方法
+  - [x] 实现 `toCSV()` 静态方法
+  - [x] 实现 `escapeCSV()` 私有方法
+  - [x] 实现 `exportByFormat()` 静态方法
+  - [x] 实现 `toMultipleFiles()` 静态方法
+  - [x] 实现 `toSingleFile()` 静态方法
+  - [x] 实现 `getMimeType()` 私有方法
+  - [x] 实现 `download()` 静态方法
+  - [x] 实现 `downloadMultiple()` 静态方法
+
+---
+
+## 6. UI 组件开发
+
+**目标**: 实现所有界面组件，遵循视觉规范
+
+### 任务清单
+
+#### 6.1 页面组件
+
+- [x] 6.1.1 创建 `src/pages/TestDataGenerator/index.tsx` 主页面
+  - [x] 实现左右分栏布局（60% / 40%）
+  - [x] 集成所有子组件
+  - [x] 管理页面状态
+
+#### 6.2 字段管理组件
+
+- [x] 6.2.1 创建 `src/pages/TestDataGenerator/components/FieldList.tsx`
+  - [x] 实现字段列表展示
+  - [x] 实现添加字段按钮
+  - [x] 实现字段拖拽排序（可选，使用上移/下移按钮）
+
+- [x] 6.2.2 创建 `src/pages/TestDataGenerator/components/FieldItem.tsx`
+  - [x] 实现单个字段项展示
+  - [x] 实现字段名编辑
+  - [x] 实现生成器切换下拉框
+  - [x] 实现配置按钮
+  - [x] 实现删除按钮
+  - [x] 实现上移/下移按钮
+
+- [x] 6.2.3 创建 `src/pages/TestDataGenerator/components/FieldEditor.tsx`
+  - [x] 实现基础配置区（字段名、描述）
+  - [x] 实现必填/选填切换
+  - [x] 实现空值率配置（仅选填时显示）
+    - [x] 滑块组件
+    - [x] 预设按钮（低/中/高）
+  - [x] 实现唯一性约束开关
+
+#### 6.3 生成器相关组件
+
+- [x] 6.3.1 创建 `src/pages/TestDataGenerator/components/GeneratorSelector.tsx`
+  - [x] 实现分类展示（个人信息/业务数据/技术数据/基础类型）
+  - [x] 实现搜索功能
+  - [x] 实现生成器选择
+
+- [x] 6.3.2 创建 `src/pages/TestDataGenerator/components/GeneratorConfig.tsx`
+  - [x] 实现参数配置表单
+  - [x] 支持不同参数类型（string/number/boolean/select/array）
+  - [x] 实时预览更新
+
+#### 6.4 数据预览组件
+
+- [x] 6.4.1 创建 `src/pages/TestDataGenerator/components/DataPreview.tsx`
+  - [x] 实现 JSON 格式预览
+  - [x] 实现 CSV 格式预览
+  - [x] 实现格式切换按钮
+  - [x] 实现数据分页
+  - [x] 实现复制功能
+
+#### 6.5 生成选项组件
+
+- [x] 6.5.1 创建 `src/pages/TestDataGenerator/components/GenerateOptions.tsx`
+  - [x] 实现生成数量配置（预设 + 自定义）
+  - [x] 实现数据格式选择（JSON/CSV）
+  - [x] 实现默认空值率配置
+
+- [x] 6.5.2 创建 `src/pages/TestDataGenerator/components/GenerateButton.tsx`
+  - [x] 实现生成按钮
+  - [x] 实现加载状态
+  - [x] 实现进度条显示
+
+#### 6.6 导出组件
+
+- [x] 6.6.1 创建 `src/pages/TestDataGenerator/components/ExportPanel.tsx`
+  - [x] 实现导出选项（复制/下载 JSON/下载 CSV）
+  - [x] 实现下载逻辑
+
+#### 6.7 结果展示组件
+
+- [x] 6.7.1 创建 `src/pages/TestDataGenerator/components/ResultPanel.tsx`
+  - [x] 实现成功状态展示
+  - [x] 实现警告状态展示（部分字段失败）
+  - [x] 实现错误状态展示
+  - [x] 实现数据统计展示
+
+#### 6.8 规则管理组件
+
+- [x] 6.8.1 创建 `src/pages/TestDataGenerator/components/RuleManager.tsx`
+  - [x] 实现规则列表展示
+  - [x] 实现搜索功能
+  - [x] 实现加载/编辑/删除/复制按钮
+  - [x] 实现导入/导出功能
+  - [x] 实现规则数量显示（已保存 X/20 条）
+
+---
+
+## 7. 页面集成与注册
+
+**目标**: 将新功能集成到应用中
+
+### 任务清单
+
+- [x] 7.1 更新路由配置
+  - [x] 确保 `RouterProvider` 支持新页面类型
+
+- [x] 7.2 更新功能注册
+  - [x] 验证 `features.tsx` 配置正确
+  - [x] 验证图标显示正常
+
+- [x] 7.3 更新仪表盘
+  - [x] 在 Dashboard 中显示新工具卡片
+
+---
+
+## 8. 测试与优化
+
+**目标**: 确保功能稳定性和性能
+
+### 任务清单
+
+#### 8.1 单元测试
+
+- [x] 8.1.1 创建生成器测试
+  - [x] `src/lib/generators/__tests__/personal.test.ts`
+  - [x] `src/lib/generators/__tests__/business.test.ts`
+  - [x] `src/lib/generators/__tests__/technical.test.ts`
+  - [x] `src/lib/generators/__tests__/basic.test.ts`
+
+- [x] 8.1.2 创建工具函数测试
+  - [x] `src/utils/__tests__/ruleStorage.test.ts`
+  - [x] `src/utils/__tests__/dataExporter.test.ts`
+
+#### 8.2 集成测试
+
+- [x] 8.2.1 创建页面测试
+  - [x] `src/pages/TestDataGenerator/__tests__/TestDataGenerator.test.tsx`
+
+#### 8.3 性能优化
+
+- [x] 8.3.1 验证 Web Worker 性能
+  - [x] 测试 10000+ 条数据生成
+  - [x] 验证 UI 不阻塞
+
+- [x] 8.3.2 验证内存使用
+  - [x] 检查大数据量时的内存占用
+  - [x] 确保无内存泄漏
+
+#### 8.4 代码质量
+
+- [x] 8.4.1 代码审查
+  - [x] 遵循项目代码规范
+  - [x] 遵循视觉规范文档
+
+- [x] 8.4.2 文档更新
+  - [x] 更新 AGENTS.md（如需要）
+
+---
+
+## 依赖关系
+
+```
+1. 类型定义与项目配置
+    ↓
+2. 生成器库
+    ↓
+3. Web Worker 数据生成引擎 (依赖 2)
+    ↓
+4. 规则存储与管理
+    ↓
+5. 数据导出功能
+    ↓
+6. UI 组件开发 (依赖 1, 2, 3, 4, 5)
+    ↓
+7. 页面集成与注册 (依赖 6)
+    ↓
+8. 测试与优化 (依赖 7)
+```
+
+---
+
+## 注意事项
+
+1. **遵循视觉规范**: 所有 UI 组件必须遵循 `docs/VISUAL_STYLE_GUIDE.md`
+2. **使用现有组件**: 优先使用 `src/components/ui/` 中的 shadcn/ui 组件
+3. **TypeScript 严格模式**: 确保类型安全
+4. **错误处理**: 使用 `sonner` 库进行 Toast 提示
+5. **性能考虑**: 大数据量生成必须使用 Web Worker
+6. **响应式设计**: 支持桌面端、平板端、移动端

docs/test-data-generator/core-features.md

@@ -0,0 +1,238 @@
+# 核心功能
+
+## 功能概览
+
+| 功能模块       | 功能点        | 说明               | 优先级 |
+| -------------- | ------------- | ------------------ | ------ |
+| **字段配置**   | 添加字段      | 可视化添加数据字段 | P0     |
+|                | 删除字段      | 删除不需要的字段   | P0     |
+|                | 字段排序      | 拖拽调整字段顺序   | P1     |
+|                | 字段命名      | 自定义字段名称     | P0     |
+|                | 必填/选填设置 | 控制字段是否必填   | P0     |
+|                | 空值率配置    | 选填字段空值概率   | P1     |
+| **生成器系统** | 生成器选择    | 从生成器库中选择   | P0     |
+|                | 参数配置      | 配置生成器参数     | P0     |
+|                | 实时预览      | 配置时查看生成结果 | P1     |
+| **数据生成**   | 批量生成      | 支持 10000+ 条数据 | P0     |
+|                | 唯一性约束    | 保证字段值唯一     | P1     |
+|                | 组合策略      | 自动选择生成策略   | P1     |
+|                | 数据预览      | 生成前预览数据     | P1     |
+| **数据导出**   | JSON 导出     | 导出为 JSON 格式   | P0     |
+|                | CSV 导出      | 导出为 CSV 格式    | P0     |
+
+## 功能详情
+
+### 1. 字段配置
+
+#### 添加字段
+
+- 用户点击"添加字段"按钮
+- 弹出生成器选择器
+- 选择生成器后，自动创建新字段
+- 字段默认名称为生成器名称
+
+#### 删除字段
+
+- 每个字段右侧有删除按钮
+- 点击后弹出确认对话框
+- 确认后删除该字段
+
+#### 字段排序
+
+- 支持拖拽排序
+- 支持上移/下移按钮
+- 排序后预览数据同步更新
+
+#### 字段命名
+
+- 字段名称可自定义
+- 支持中英文命名
+- 同一规则内字段名不可重复
+
+#### 必填/选填设置
+
+- 每个字段可设置为"必填"或"选填"
+- **必填字段**: 100% 生成数据
+- **选填字段**: 可配置空值概率（0-100%）
+- 默认所有字段为必填
+
+#### 空值率配置
+
+- 选填字段可单独设置空值率
+- 提供预设值：低（20%）、中（50%）、高（80%）
+- 支持滑块精细调节（0-100%）
+- 未单独设置的选填字段使用全局默认空值率
+
+---
+
+### 2. 生成器系统
+
+#### 生成器选择
+
+- 以分类方式展示生成器
+- 支持搜索生成器
+- 点击选择后添加到字段配置
+
+#### 价格生成器（业务数据）
+
+生成真实的价格数据，支持多种策略：
+
+| 策略     | 说明                           | 适用场景     |
+| -------- | ------------------------------ | ------------ |
+| 真实分布 | 对数正态分布，模拟真实商品价格 | 通用电商场景 |
+| 均匀随机 | 所有价格等概率                 | 测试数据     |
+| 心理定价 | .99/.98/.95 结尾               | 营销场景     |
+
+**参数配置**：
+
+- 最低价/最高价：控制价格区间
+- 小数位数：0（整数）、1、2 位
+- 生成策略：选择分布类型
+
+#### 年龄生成器（个人信息）
+
+生成真实分布的年龄数据：
+
+| 策略     | 说明                         | 适用场景     |
+| -------- | ---------------------------- | ------------ |
+| 真实分布 | 正态分布，均值 35，标准差 10 | 通用用户数据 |
+| 人口比例 | 按中国人口年龄比例分布       | 市场调研数据 |
+| 均匀随机 | 所有年龄等概率               | 测试数据     |
+
+**参数配置**：
+
+- 最小年龄/最大年龄：控制年龄区间
+- 生成策略：选择分布类型
+
+#### 数量生成器（业务数据）
+
+生成真实分布的数量数据：
+
+| 策略     | 说明                        | 适用场景 |
+| -------- | --------------------------- | -------- |
+| 真实分布 | 泊松分布，大多数购买 1-3 件 | 零售订单 |
+| 批发模式 | 10-100 之间均匀分布         | 批发订单 |
+| 均匀随机 | 所有数量等概率              | 测试数据 |
+
+**参数配置**：
+
+- 最小值/最大值：控制数量区间
+- 生成策略：选择分布类型
+
+#### 评分生成器（业务数据）
+
+生成真实分布的评分数据：
+
+| 策略     | 说明               | 适用场景 |
+| -------- | ------------------ | -------- |
+| 真实分布 | 偏态分布，偏向高分 | 电商平台 |
+| 严格评价 | 偏态分布，偏向低分 | 严格评审 |
+| 均匀随机 | 所有评分等概率     | 测试数据 |
+
+**参数配置**：
+
+- 最低分/最高分：控制评分区间
+- 小数位数：0、1 位
+- 生成策略：选择分布类型
+
+#### 折扣生成器（业务数据）
+
+生成真实分布的折扣数据：
+
+| 策略     | 说明                     | 适用场景 |
+| -------- | ------------------------ | -------- |
+| 心理定价 | 常见折扣点（8折、9折等） | 电商促销 |
+| 清仓模式 | 大折扣区间（3-7折）      | 清仓处理 |
+| 均匀随机 | 所有折扣等概率           | 测试数据 |
+
+**参数配置**：
+
+- 最低折扣/最高折扣：控制折扣区间（0.1-0.9）
+- 生成策略：选择分布类型
+
+#### 库存生成器（业务数据）
+
+生成真实分布的库存数据：
+
+| 策略     | 说明                     | 适用场景 |
+| -------- | ------------------------ | -------- |
+| 真实分布 | 指数分布，大多数库存较少 | 通用商品 |
+| 热销商品 | 低库存区间（0-50）       | 热销商品 |
+| 均匀随机 | 所有库存等概率           | 测试数据 |
+
+**参数配置**：
+
+- 最小库存/最大库存：控制库存区间
+- 生成策略：选择分布类型
+
+#### 参数配置
+
+- 每个生成器有对应的参数配置界面
+- 必填参数标记星号
+- 修改参数后实时预览更新
+
+#### 实时预览
+
+- 配置参数时，右侧预览区实时更新
+- 显示 5-10 条示例数据
+- 帮助用户确认配置是否正确
+
+---
+
+### 3. 数据生成
+
+#### 批量生成
+
+- 支持配置生成数量
+- 使用 Web Worker 后台生成
+- 支持 10000+ 条数据
+- 生成过程中显示进度条
+
+#### 唯一性约束
+
+- 每个字段可单独设置唯一性约束
+- 启用后，该字段生成的值不会重复
+- 如果无法生成唯一值，使用重试机制
+
+#### 组合策略（唯一性生成）
+
+系统根据数据量自动选择最优生成策略：
+
+| 数据量    | 策略            | 说明                   |
+| --------- | --------------- | ---------------------- |
+| ≤ 1000 条 | 随机生成 + 重试 | 保证随机性，性能可接受 |
+| > 1000 条 | 索引生成        | 高性能，保证唯一性     |
+
+**实现方式**：
+
+- 生成器提供两个方法：`generate()` 和 `generateAtIndex()`
+- `generate()`: 随机生成，用于小数据量或非唯一性字段
+- `generateAtIndex()`: 索引生成，用于大数据量唯一性字段
+- 系统根据配置自动选择合适的方法
+
+**示例**：
+
+- 手机号字段：`generateAtIndex(params, index)` 使用 index 生成唯一手机号
+- 姓名字段：`generateAtIndex(params, index)` 使用 index 组合姓和名
+
+#### 数据预览
+
+- 生成前可预览数据
+- 显示前 10 条数据
+- 支持分页查看更多数据
+
+---
+
+### 4. 数据导出
+
+#### JSON 导出
+
+- 导出为标准 JSON 格式
+- 支持压缩和格式化两种模式
+- 包含字段名和数据
+
+#### CSV 导出
+
+- 导出为 CSV 格式
+- 自动处理逗号转义
+- 支持中文编码 (UTF-8 with BOM)

docs/test-data-generator/generators.md

@@ -0,0 +1,702 @@
+# 生成器库
+
+## 分类概览
+
+| 分类     | 生成器数量 | 说明                                             |
+| -------- | ---------- | ------------------------------------------------ |
+| 个人信息 | 6 个       | 中文姓名、邮箱、手机号、年龄等                   |
+| 业务数据 | 8 个       | 订单号、价格、日期、状态、数量、评分、折扣、库存 |
+| 技术数据 | 3 个       | UUID、IP地址、URL                                |
+| 基础类型 | 4 个       | 整数、浮点数、字符串等                           |
+| **总计** | **21 个**  |                                                  |
+
+---
+
+## 个人信息生成器
+
+### 1. 中文姓名 (chineseName)
+
+**说明**: 生成中文姓名，如张三、李四
+
+**参数**:
+
+| 参数名          | 类型                         | 必填 | 默认值             | 说明         |
+| --------------- | ---------------------------- | ---- | ------------------ | ------------ |
+| surnamePool     | string \| string[]           | 否   | 百家姓前100个      | 姓氏池       |
+| givenNameLength | { min: number, max: number } | 否   | { min: 1, max: 2 } | 名字长度范围 |
+
+**示例**:
+
+```json
+{
+  "name": "name",
+  "generator": "chineseName",
+  "params": {
+    "surnamePool": ["张", "王", "李", "赵"],
+    "givenNameLength": { "min": 1, "max": 2 }
+  }
+}
+```
+
+**生成结果**: 张伟, 李娜, 王强, 赵敏
+
+---
+
+### 2. 邮箱地址 (email)
+
+**说明**: 生成邮箱地址
+
+**参数**:
+
+| 参数名    | 类型                 | 必填 | 默认值                                                       | 说明       |
+| --------- | -------------------- | ---- | ------------------------------------------------------------ | ---------- |
+| domains   | string[]             | 否   | ['qq.com', '163.com', '126.com', 'gmail.com', 'outlook.com'] | 域名列表   |
+| nameStyle | 'pinyin' \| 'random' | 否   | 'pinyin'                                                     | 用户名风格 |
+
+**示例**:
+
+```json
+{
+  "name": "email",
+  "generator": "email",
+  "params": {
+    "domains": ["qq.com", "163.com"],
+    "nameStyle": "pinyin"
+  }
+}
+```
+
+**生成结果**: zhangwei@qq.com, lina@163.com
+
+---
+
+### 3. 中国手机号 (chinesePhone)
+
+**说明**: 生成 11 位中国手机号
+
+**参数**:
+
+| 参数名 | 类型     | 必填 | 默认值         | 说明       |
+| ------ | -------- | ---- | -------------- | ---------- |
+| prefix | string[] | 否   | 常见手机号前缀 | 手机号前缀 |
+
+**示例**:
+
+```json
+{
+  "name": "phone",
+  "generator": "chinesePhone",
+  "params": {
+    "prefix": ["138", "139", "150", "151"]
+  }
+}
+```
+
+**生成结果**: 13812345678, 15087654321
+
+---
+
+### 4. 身份证号 (idCard)
+
+**说明**: 生成 18 位中国身份证号
+
+**参数**:
+
+| 参数名 | 类型   | 必填 | 默认值 | 说明   |
+| ------ | ------ | ---- | ------ | ------ |
+| region | string | 否   | 随机   | 地区码 |
+
+**示例**:
+
+```json
+{
+  "name": "idCard",
+  "generator": "idCard",
+  "params": {
+    "region": "110101"
+  }
+}
+```
+
+**生成结果**: 110101199001011234
+
+---
+
+### 5. 中文地址 (chineseAddress)
+
+**说明**: 生成中国地址
+
+**参数**:
+
+| 参数名 | 类型                           | 必填 | 默认值 | 说明     |
+| ------ | ------------------------------ | ---- | ------ | -------- |
+| level  | 'full' \| 'province' \| 'city' | 否   | 'full' | 详细程度 |
+
+**示例**:
+
+```json
+{
+  "name": "address",
+  "generator": "chineseAddress",
+  "params": {
+    "level": "full"
+  }
+}
+```
+
+**生成结果**: 北京市朝阳区建国路88号
+
+---
+
+### 6. 年龄 (age)
+
+**说明**: 生成真实分布的年龄数据
+
+**参数**:
+
+| 参数名   | 类型                                      | 必填 | 默认值      | 说明     |
+| -------- | ----------------------------------------- | ---- | ----------- | -------- |
+| min      | number                                    | 否   | 1           | 最小年龄 |
+| max      | number                                    | 否   | 100         | 最大年龄 |
+| strategy | 'realistic' \| 'demographic' \| 'uniform' | 否   | 'realistic' | 生成策略 |
+
+**策略说明**:
+
+| 策略        | 说明                         | 适用场景     |
+| ----------- | ---------------------------- | ------------ |
+| realistic   | 正态分布，均值 35，标准差 10 | 通用用户数据 |
+| demographic | 按中国人口年龄比例分布       | 市场调研数据 |
+| uniform     | 均匀随机                     | 测试数据     |
+
+**示例**:
+
+```json
+{
+  "name": "age",
+  "generator": "age",
+  "params": {
+    "min": 18,
+    "max": 65,
+    "strategy": "realistic"
+  }
+}
+```
+
+**生成结果**: 28, 42, 35, 51, 23
+
+---
+
+## 业务数据生成器
+
+### 1. 订单号 (orderId)
+
+**说明**: 生成订单号
+
+**参数**:
+
+| 参数名       | 类型    | 必填 | 默认值 | 说明         |
+| ------------ | ------- | ---- | ------ | ------------ |
+| prefix       | string  | 否   | 'ORD'  | 前缀         |
+| dateIncluded | boolean | 否   | true   | 是否包含日期 |
+
+**示例**:
+
+```json
+{
+  "name": "orderId",
+  "generator": "orderId",
+  "params": {
+    "prefix": "ORD",
+    "dateIncluded": true
+  }
+}
+```
+
+**生成结果**: ORD20240115001, ORD20240115002
+
+---
+
+### 2. 价格 (price)
+
+**说明**: 生成真实的价格数据，支持多种分布策略
+
+**参数**:
+
+| 参数名   | 类型                                        | 必填 | 默认值      | 说明     |
+| -------- | ------------------------------------------- | ---- | ----------- | -------- |
+| min      | number                                      | 是   | 1           | 最低价   |
+| max      | number                                      | 是   | 9999        | 最高价   |
+| decimals | 0 \| 1 \| 2                                 | 否   | 2           | 小数位数 |
+| strategy | 'realistic' \| 'uniform' \| 'psychological' | 否   | 'realistic' | 生成策略 |
+
+**生成策略说明**:
+
+| 策略          | 说明                           | 适用场景     |
+| ------------- | ------------------------------ | ------------ |
+| realistic     | 对数正态分布，模拟真实商品价格 | 通用电商场景 |
+| uniform       | 均匀随机，所有价格等概率       | 测试数据     |
+| psychological | 心理定价，.99/.98/.95 结尾     | 营销场景     |
+
+**示例**:
+
+```json
+{
+  "name": "price",
+  "generator": "price",
+  "params": {
+    "min": 10,
+    "max": 5000,
+    "decimals": 2,
+    "strategy": "realistic"
+  }
+}
+```
+
+**生成结果**:
+
+- 真实分布: 299.00, 1599.50, 49.99, 1299.00
+- 心理定价: 299.99, 1599.98, 49.95, 1299.99
+- 均匀随机: 1234.56, 5678.90, 890.12
+
+---
+
+### 3. 日期时间 (date)
+
+**说明**: 生成日期时间
+
+**参数**:
+
+| 参数名 | 类型   | 必填 | 默认值                | 说明     |
+| ------ | ------ | ---- | --------------------- | -------- |
+| format | string | 否   | 'YYYY-MM-DD HH:mm:ss' | 日期格式 |
+| min    | string | 否   | '2020-01-01'          | 最早日期 |
+| max    | string | 否   | 当前日期              | 最晚日期 |
+
+**示例**:
+
+```json
+{
+  "name": "createdAt",
+  "generator": "date",
+  "params": {
+    "format": "YYYY-MM-DD HH:mm:ss",
+    "min": "2024-01-01"
+  }
+}
+```
+
+**生成结果**: 2024-01-15 14:30:22
+
+---
+
+### 4. 状态 (status)
+
+**说明**: 从选项中随机选择
+
+**参数**:
+
+| 参数名  | 类型     | 必填 | 默认值   | 说明         |
+| ------- | -------- | ---- | -------- | ------------ |
+| options | string[] | 是   | -        | 状态选项列表 |
+| weights | number[] | 否   | 均匀分布 | 各选项权重   |
+
+**示例**:
+
+```json
+{
+  "name": "status",
+  "generator": "status",
+  "params": {
+    "options": ["pending", "paid", "shipped", "completed"],
+    "weights": [30, 40, 20, 10]
+  }
+}
+```
+
+**生成结果**: pending, paid, shipped, completed
+
+---
+
+### 5. 数量 (quantity)
+
+**说明**: 生成真实分布的数量数据
+
+**参数**:
+
+| 参数名   | 类型                               | 必填 | 默认值      | 说明     |
+| -------- | ---------------------------------- | ---- | ----------- | -------- |
+| min      | number                             | 否   | 1           | 最小值   |
+| max      | number                             | 否   | 100         | 最大值   |
+| strategy | 'realistic' \| 'bulk' \| 'uniform' | 否   | 'realistic' | 生成策略 |
+
+**策略说明**:
+
+| 策略      | 说明                        | 适用场景 |
+| --------- | --------------------------- | -------- |
+| realistic | 泊松分布，大多数购买 1-3 件 | 零售订单 |
+| bulk      | 10-100 之间均匀分布         | 批发订单 |
+| uniform   | 均匀随机                    | 测试数据 |
+
+**示例**:
+
+```json
+{
+  "name": "quantity",
+  "generator": "quantity",
+  "params": {
+    "min": 1,
+    "max": 50,
+    "strategy": "realistic"
+  }
+}
+```
+
+**生成结果**: 2, 1, 5, 3, 1
+
+---
+
+### 6. 评分 (rating)
+
+**说明**: 生成真实分布的评分数据
+
+**参数**:
+
+| 参数名   | 类型                                 | 必填 | 默认值      | 说明     |
+| -------- | ------------------------------------ | ---- | ----------- | -------- |
+| min      | number                               | 否   | 1           | 最低分   |
+| max      | number                               | 否   | 5           | 最高分   |
+| decimals | number                               | 否   | 1           | 小数位数 |
+| strategy | 'realistic' \| 'strict' \| 'uniform' | 否   | 'realistic' | 生成策略 |
+
+**策略说明**:
+
+| 策略      | 说明               | 适用场景 |
+| --------- | ------------------ | -------- |
+| realistic | 偏态分布，偏向高分 | 电商平台 |
+| strict    | 偏态分布，偏向低分 | 严格评审 |
+| uniform   | 均匀随机           | 测试数据 |
+
+**示例**:
+
+```json
+{
+  "name": "rating",
+  "generator": "rating",
+  "params": {
+    "min": 1,
+    "max": 5,
+    "decimals": 1,
+    "strategy": "realistic"
+  }
+}
+```
+
+**生成结果**: 4.5, 4.8, 3.9, 5.0, 4.2
+
+---
+
+### 7. 折扣 (discount)
+
+**说明**: 生成真实分布的折扣数据
+
+**参数**:
+
+| 参数名   | 类型                                        | 必填 | 默认值          | 说明     |
+| -------- | ------------------------------------------- | ---- | --------------- | -------- |
+| min      | number                                      | 否   | 0.1             | 最低折扣 |
+| max      | number                                      | 否   | 0.9             | 最高折扣 |
+| strategy | 'psychological' \| 'clearance' \| 'uniform' | 否   | 'psychological' | 生成策略 |
+
+**策略说明**:
+
+| 策略          | 说明                     | 适用场景 |
+| ------------- | ------------------------ | -------- |
+| psychological | 常见折扣点（8折、9折等） | 电商促销 |
+| clearance     | 大折扣区间（3-7折）      | 清仓处理 |
+| uniform       | 均匀随机                 | 测试数据 |
+
+**示例**:
+
+```json
+{
+  "name": "discount",
+  "generator": "discount",
+  "params": {
+    "min": 0.1,
+    "max": 0.9,
+    "strategy": "psychological"
+  }
+}
+```
+
+**生成结果**: 0.80, 0.90, 0.85, 0.95, 0.70
+
+---
+
+### 8. 库存 (stock)
+
+**说明**: 生成真实分布的库存数据
+
+**参数**:
+
+| 参数名   | 类型                              | 必填 | 默认值      | 说明     |
+| -------- | --------------------------------- | ---- | ----------- | -------- |
+| min      | number                            | 否   | 0           | 最小库存 |
+| max      | number                            | 否   | 1000        | 最大库存 |
+| strategy | 'realistic' \| 'hot' \| 'uniform' | 否   | 'realistic' | 生成策略 |
+
+**策略说明**:
+
+| 策略      | 说明                     | 适用场景 |
+| --------- | ------------------------ | -------- |
+| realistic | 指数分布，大多数库存较少 | 通用商品 |
+| hot       | 低库存区间（0-50）       | 热销商品 |
+| uniform   | 均匀随机                 | 测试数据 |
+
+**示例**:
+
+```json
+{
+  "name": "stock",
+  "generator": "stock",
+  "params": {
+    "min": 0,
+    "max": 500,
+    "strategy": "realistic"
+  }
+}
+```
+
+**生成结果**: 23, 8, 156, 45, 12
+
+---
+
+## 技术数据生成器
+
+### 1. UUID (uuid)
+
+**说明**: 生成 UUID
+
+**参数**:
+
+| 参数名  | 类型         | 必填 | 默认值 | 说明      |
+| ------- | ------------ | ---- | ------ | --------- |
+| version | 'v4' \| 'v1' | 否   | 'v4'   | UUID 版本 |
+
+**示例**:
+
+```json
+{
+  "name": "id",
+  "generator": "uuid",
+  "params": {
+    "version": "v4"
+  }
+}
+```
+
+**生成结果**: 550e8400-e29b-41d4-a716-446655440000
+
+---
+
+### 2. IPv4 地址 (ipv4)
+
+**说明**: 生成 IPv4 地址
+
+**参数**:
+
+| 参数名  | 类型    | 必填 | 默认值 | 说明         |
+| ------- | ------- | ---- | ------ | ------------ |
+| private | boolean | 否   | false  | 是否私有地址 |
+
+**示例**:
+
+```json
+{
+  "name": "ip",
+  "generator": "ipv4",
+  "params": {
+    "private": true
+  }
+}
+```
+
+**生成结果**: 192.168.1.1, 10.0.0.1
+
+---
+
+### 3. URL (url)
+
+**说明**: 生成 URL
+
+**参数**:
+
+| 参数名   | 类型              | 必填 | 默认值        | 说明 |
+| -------- | ----------------- | ---- | ------------- | ---- |
+| protocol | 'http' \| 'https' | 否   | 'https'       | 协议 |
+| domain   | string            | 否   | 'example.com' | 域名 |
+
+**示例**:
+
+```json
+{
+  "name": "website",
+  "generator": "url",
+  "params": {
+    "protocol": "https",
+    "domain": "shop.com"
+  }
+}
+```
+
+**生成结果**: https://shop.com/product/123
+
+---
+
+## 基础类型生成器
+
+### 1. 随机整数 (randomInt)
+
+**说明**: 生成指定范围的随机整数
+
+**参数**:
+
+| 参数名 | 类型   | 必填 | 默认值 | 说明   |
+| ------ | ------ | ---- | ------ | ------ |
+| min    | number | 是   | -      | 最小值 |
+| max    | number | 是   | -      | 最大值 |
+
+**示例**:
+
+```json
+{
+  "name": "age",
+  "generator": "randomInt",
+  "params": {
+    "min": 18,
+    "max": 60
+  }
+}
+```
+
+**生成结果**: 25, 42, 18, 60
+
+---
+
+### 2. 随机浮点数 (randomFloat)
+
+**说明**: 生成指定范围的随机浮点数
+
+**参数**:
+
+| 参数名   | 类型   | 必填 | 默认值 | 说明     |
+| -------- | ------ | ---- | ------ | -------- |
+| min      | number | 是   | -      | 最小值   |
+| max      | number | 是   | -      | 最大值   |
+| decimals | number | 否   | 2      | 小数位数 |
+
+**示例**:
+
+```json
+{
+  "name": "score",
+  "generator": "randomFloat",
+  "params": {
+    "min": 0,
+    "max": 100,
+    "decimals": 1
+  }
+}
+```
+
+**生成结果**: 85.3, 42.7, 99.9
+
+---
+
+### 3. 随机字符串 (randomString)
+
+**说明**: 生成指定长度的随机字符串
+
+**参数**:
+
+| 参数名  | 类型   | 必填 | 默认值         | 说明       |
+| ------- | ------ | ---- | -------------- | ---------- |
+| length  | number | 是   | -              | 字符串长度 |
+| charset | string | 否   | 'alphanumeric' | 字符集     |
+
+**示例**:
+
+```json
+{
+  "name": "code",
+  "generator": "randomString",
+  "params": {
+    "length": 8,
+    "charset": "alphanumeric"
+  }
+}
+```
+
+**生成结果**: aB3kL9mN, xY7zW2pQ
+
+---
+
+### 4. 从列表选择 (fromList)
+
+**说明**: 从选项列表中随机选择
+
+**参数**:
+
+| 参数名  | 类型     | 必填 | 默认值   | 说明     |
+| ------- | -------- | ---- | -------- | -------- |
+| options | any[]    | 是   | -        | 选项列表 |
+| weights | number[] | 否   | 均匀分布 | 权重     |
+
+**示例**:
+
+```json
+{
+  "name": "category",
+  "generator": "fromList",
+  "params": {
+    "options": ["电子产品", "服装", "食品", "图书"],
+    "weights": [40, 30, 20, 10]
+  }
+}
+```
+
+**生成结果**: 电子产品, 服装, 食品
+
+---
+
+## 生成器选择界面
+
+### 界面设计
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│  选择生成器                                                       │
+├─────────────────────────────────────────────────────────────────────┤
+│                                                                     │
+│  搜索: [搜索生成器...                                          ] │
+│                                                                     │
+│  分类筛选                                                        │
+│  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐      │
+│  │ 全部    │ │ 个人信息 │ │ 业务数据 │ │ 技术数据 │ │ 基础类型 │      │
+│  └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘      │
+│                                                                     │
+│  生成器列表                                                       │
+│  ┌───────────────────────────────────────────────────────────────┐ │
+│  │  个人信息                                                     │ │
+│  │  ┌─────────────────────────────────────────────────────────┐ │ │
+│  │  │ 中文姓名        生成中文姓名，如张三                     │ │ │
+│  │  │ 邮箱地址        生成邮箱地址                            │ │ │
+│  │  │ 中国手机号      生成11位手机号                          │ │ │
+│  │  │ 身份证号        生成18位身份证号                        │ │ │
+│  │  │ 中文地址        生成中国地址                            │ │ │
+│  │  └─────────────────────────────────────────────────────────┘ │ │
+│  │                                                               │ │
+│  └───────────────────────────────────────────────────────────────┘ │
+│                                                                     │
+└─────────────────────────────────────────────────────────────────────┘
+```

docs/test-data-generator/rule-management.md

@@ -0,0 +1,481 @@
+# 规则管理
+
+## 功能概览
+
+| 功能     | 说明                 | 优先级 |
+| -------- | -------------------- | ------ |
+| 保存规则 | 将当前配置保存为模板 | P0     |
+| 规则列表 | 查看所有已保存的规则 | P0     |
+| 规则搜索 | 按关键词搜索规则     | P1     |
+| 规则编辑 | 修改已保存的规则     | P0     |
+| 规则删除 | 删除不需要的规则     | P0     |
+| 规则加载 | 一键加载规则配置     | P0     |
+| 规则复制 | 复制规则配置         | P1     |
+| 规则导出 | 导出为 JSON 文件     | P1     |
+| 规则导入 | 从 JSON 文件导入     | P1     |
+
+## 规则数量限制
+
+- **最大规则数量**: 20 条
+- **超出限制**: 当规则数量达到 20 条时，保存按钮置灰，提示"已达到最大规则数量"
+- **解决方式**: 用户需要删除已有规则后才能保存新规则
+
+---
+
+## 数据结构
+
+### 规则模板
+
+```typescript
+interface DataRule {
+  id: string; // 唯一标识
+  name: string; // 规则名称
+  description?: string; // 规则描述
+  fields: FieldConfig[]; // 字段配置
+  options: {
+    total: number; // 生成数量
+    format: 'json' | 'csv';
+    defaultEmptyRate: number; // 默认空值率（0-100）
+  };
+  metadata: {
+    createdAt: number; // 创建时间
+    updatedAt: number; // 更新时间
+    lastUsedAt?: number; // 最后使用时间
+    useCount: number; // 使用次数
+  };
+}
+```
+
+### 字段配置
+
+```typescript
+interface FieldConfig {
+  id: string; // 字段唯一标识
+  name: string; // 字段名
+  generator: string; // 生成器名称
+  params: Record<string, any>; // 生成器参数
+  unique: boolean; // 唯一性约束
+  required: boolean; // 是否必填
+  emptyRate?: number; // 选填字段的空值概率（0-100）
+}
+```
+
+---
+
+## 功能详情
+
+### 1. 保存规则
+
+**触发方式**: 用户点击"保存规则"按钮
+
+**界面设计**:
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│  保存规则                                                            │
+├─────────────────────────────────────────────────────────────────────┤
+│                                                                     │
+│  规则信息                                                            │
+│  ┌───────────────────────────────────────────────────────────────┐ │
+│  │  规则名称:                                                     │ │
+│  │  ┌─────────────────────────────────────────────────────────┐ │ │
+│  │  │ [电商用户数据 - 测试用                                  ]│ │ │
+│  │  └─────────────────────────────────────────────────────────┘ │ │
+│  │                                                               │ │
+│  │  规则描述 (可选):                                              │ │
+│  │  ┌─────────────────────────────────────────────────────────┐ │ │
+│  │  │ [用于测试用户注册功能，包含姓名、邮箱、手机号            ]│ │ │
+│  │  └─────────────────────────────────────────────────────────┘ │ │
+│  │                                                               │ │
+│  └───────────────────────────────────────────────────────────────┘ │
+│                                                                     │
+│  规则预览                                                            │
+│  ┌───────────────────────────────────────────────────────────────┐ │
+│  │ 字段数量: 4 个                                                 │ │
+│  │ • name (中文姓名)                                              │ │
+│  │ • email (邮箱地址)                                             │ │
+│  │ • phone (手机号)                                               │ │
+│  │ • age (年龄)                                                   │ │
+│  │                                                               │ │
+│  │ 生成数量: 100 条                                               │ │
+│  │ 数据格式: JSON                                                 │ │
+│  └───────────────────────────────────────────────────────────────┘ │
+│                                                                     │
+│  [保存]  [取消]                                                      │
+│                                                                     │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+**保存逻辑**:
+
+1. 验证规则名称不为空
+2. 检查规则数量是否达到上限（20 条）
+3. 如果达到上限，显示提示"已达到最大规则数量"
+4. 生成唯一 ID
+5. 设置创建时间和更新时间
+6. 初始化使用次数为 0
+7. 保存到 localStorage
+
+---
+
+### 2. 规则列表
+
+**界面设计**:
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│  规则管理                                                            │
+├─────────────────────────────────────────────────────────────────────┤
+│                                                                     │
+│  搜索: [搜索规则名称...                                            ] │
+│                                                                     │
+│  规则列表 (已保存 15/20 条)                                          │
+│  ┌───────────────────────────────────────────────────────────────┐ │
+│  │                                                               │ │
+│  │  ┌─────────────────────────────────────────────────────────┐ │ │
+│  │  │ 电商用户数据 - 测试用                                     │ │ │
+│  │  │ ─────────────────────────────────────────────────────── │ │ │
+│  │  │ 用于测试用户注册功能，包含姓名、邮箱、手机号              │ │ │
+│  │  │ 4 个字段 | 100 条 | JSON                                  │ │ │
+│  │  │ 2024-01-15 14:30 创建 | 2024-01-20 10:15 最后使用        │ │ │
+│  │  │                                                         │ │ │
+│  │  │ [加载]  [复制]  [导出]  [编辑]  [删除]                     │ │ │
+│  │  └─────────────────────────────────────────────────────────┘ │ │
+│  │                                                               │ │
+│  └───────────────────────────────────────────────────────────────┘ │
+│                                                                     │
+│  [导入规则]  [导出全部]  [清空全部]                                  │
+│                                                                     │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+**列表项信息**:
+
+- 规则名称
+- 规则描述
+- 字段数量、生成数量、数据格式
+- 创建时间、最后使用时间
+- 操作按钮
+
+---
+
+### 3. 规则搜索
+
+**搜索逻辑**:
+
+- 支持按规则名称搜索
+- 支持按规则描述搜索
+- 搜索为模糊匹配，不区分大小写
+
+**实现方式**:
+
+```typescript
+search(keyword: string): DataRule[] {
+  const rules = this.getAll();
+  const lowerKeyword = keyword.toLowerCase();
+
+  return rules.filter(r =>
+    r.name.toLowerCase().includes(lowerKeyword) ||
+    r.description?.toLowerCase().includes(lowerKeyword)
+  );
+}
+```
+
+---
+
+### 4. 规则编辑
+
+**界面设计**:
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│  编辑规则 - 电商用户数据                                             │
+├─────────────────────────────────────────────────────────────────────┤
+│                                                                     │
+│  基本信息                                                            │
+│  ┌───────────────────────────────────────────────────────────────┐ │
+│  │ 规则名称: [电商用户数据 - 测试用                              ]│ │
+│  │ 规则描述: [用于测试用户注册功能，包含姓名、邮箱、手机号        ]│ │
+│  └───────────────────────────────────────────────────────────────┘ │
+│                                                                     │
+│  字段配置 (可直接编辑)                                                │
+│  ┌───────────────────────────────────────────────────────────────┐ │
+│  │                                                               │ │
+│  │  1. name        [中文姓名 ▼]  [配置] [删除] [上移][下移]      │ │
+│  │  2. email       [邮箱地址 ▼]  [配置] [删除] [上移][下移]      │ │
+│  │  3. phone       [手机号   ▼]  [配置] [删除] [上移][下移]      │ │
+│  │  4. age         [年龄     ▼]  [配置] [删除] [上移][下移]      │ │
+│  │                                                               │ │
+│  │  [+ 添加字段]                                                 │ │
+│  │                                                               │ │
+│  └───────────────────────────────────────────────────────────────┘ │
+│                                                                     │
+│  生成选项                                                            │
+│  ┌───────────────────────────────────────────────────────────────┐ │
+│  │ 数量: [100]  格式: [JSON ▼]                                   │ │
+│  └───────────────────────────────────────────────────────────────┘ │
+│                                                                     │
+│  [保存修改]  [取消]                                                  │
+│                                                                     │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+**编辑逻辑**:
+
+1. 加载原规则配置到编辑器
+2. 用户修改配置
+3. 点击保存时更新规则
+4. 更新 metadata.updatedAt
+5. 保存到 localStorage
+
+---
+
+### 5. 规则删除
+
+**删除流程**:
+
+1. 点击删除按钮
+2. 弹出确认对话框
+3. 确认后删除规则
+4. 刷新规则列表
+
+**确认对话框**:
+
+```
+┌─────────────────────────────────────────┐
+│  确认删除                            │
+├─────────────────────────────────────────┤
+│                                         │
+│  确定要删除规则 "电商用户数据" 吗？      │
+│                                         │
+│  此操作不可撤销。                        │
+│                                         │
+│  [取消]  [删除]                     │
+│                                         │
+└─────────────────────────────────────────┘
+```
+
+---
+
+### 6. 规则加载
+
+**加载流程**:
+
+1. 点击"加载"按钮
+2. 将规则配置应用到当前编辑器
+3. 更新预览数据
+4. 记录使用时间和次数
+
+**实现方式**:
+
+```typescript
+loadRule(ruleId: string): void {
+  const rule = this.storage.getById(ruleId);
+
+  // 应用规则配置
+  this.setFields(rule.fields);
+  this.setOptions(rule.options);
+
+  // 记录使用
+  this.storage.recordUse(ruleId);
+
+  // 更新预览
+  this.updatePreview();
+}
+```
+
+---
+
+### 7. 规则复制
+
+**复制逻辑**:
+
+1. 点击"复制"按钮
+2. 创建规则的副本
+3. 名称添加"(副本)"后缀
+4. 生成新的 ID
+5. 保存为新规则
+
+---
+
+### 8. 规则导出
+
+**导出界面**:
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│  导出规则                                                            │
+├─────────────────────────────────────────────────────────────────────┤
+│                                                                     │
+│  选择要导出的规则:                                                    │
+│  ┌───────────────────────────────────────────────────────────────┐ │
+│  │ ☑ 电商用户数据 - 测试用 (4个字段, 100条)                       │ │
+│  │ ☑ 电商订单数据 - 测试用 (6个字段, 500条)                       │ │
+│  │ ☐ 用户登录数据 - 测试用 (3个字段, 50条)                       │ │
+│  │                                                               │ │
+│  │ [全选]  [全不选]                                               │ │
+│  └───────────────────────────────────────────────────────────────┘ │
+│                                                                     │
+│  导出格式:                                                            │
+│  ┌───────────────────────────────────────────────────────────────┐ │
+│  │ ○ 导出为单个 JSON 文件 (所有规则合并)                          │ │
+│  │ ● 导出为多个 JSON 文件 (每个规则一个文件)                      │ │
+│  └───────────────────────────────────────────────────────────────┘ │
+│                                                                     │
+│  [导出]  [取消]                                                      │
+│                                                                     │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+**导出格式**:
+
+```json
+{
+  "version": "1.0",
+  "exportedAt": "2024-01-20T10:15:45.000Z",
+  "rules": [
+    {
+      "id": "rule_123456",
+      "name": "电商用户数据 - 测试用",
+      "description": "用于测试用户注册功能",
+      "fields": [...],
+      "options": {...},
+      "metadata": {...}
+    }
+  ]
+}
+```
+
+---
+
+### 9. 规则导入
+
+**导入界面**:
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│  导入规则                                                            │
+├─────────────────────────────────────────────────────────────────────┤
+│                                                                     │
+│  选择导入方式:                                                        │
+│  ┌───────────────────────────────────────────────────────────────┐ │
+│  │                                                               │ │
+│  │  ○ 从文件导入                                                 │ │
+│  │    ┌─────────────────────────────────────────────────────┐   │ │
+│  │    │ 拖拽文件到这里，或 [点击选择文件]                      │   │ │
+│  │    │ 支持格式: .json                                      │   │ │
+│  │    └─────────────────────────────────────────────────────┘   │ │
+│  │                                                               │ │
+│  │  ○ 从剪贴板粘贴                                               │ │
+│  │    ┌─────────────────────────────────────────────────────┐   │ │
+│  │    │ 粘贴 JSON 规则内容...                                │   │ │
+│  │    └─────────────────────────────────────────────────────┘   │ │
+│  │                                                               │ │
+│  └───────────────────────────────────────────────────────────────┘ │
+│                                                                     │
+│  预览导入内容:                                                        │
+│  ┌───────────────────────────────────────────────────────────────┐ │
+│  │ 格式验证通过                                                   │ │
+│  │ 规则数量: 2 个                                                │ │
+│  │ • 电商用户数据 (4个字段)                                       │ │
+│  │ • 电商订单数据 (6个字段)                                       │ │
+│  └───────────────────────────────────────────────────────────────┘ │
+│                                                                     │
+│  [导入]  [取消]                                                      │
+│                                                                     │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+**导入逻辑**:
+
+1. 解析 JSON 文件
+2. 验证格式是否正确
+3. 预览导入内容
+4. 确认后逐条导入
+5. 生成新 ID 避免冲突
+6. 处理导入结果（成功/失败数量）
+
+---
+
+## 存储机制
+
+### 本地存储
+
+使用 localStorage 存储规则数据:
+
+```typescript
+class RuleStorage {
+  private readonly STORAGE_KEY = 'testDataGenerator_rules';
+
+  // 获取所有规则
+  getAll(): DataRule[] {
+    const data = localStorage.getItem(this.STORAGE_KEY);
+    return data ? JSON.parse(data) : [];
+  }
+
+  // 保存规则
+  save(rule: DataRule): { success: boolean; message?: string } {
+    const rules = this.getAll();
+
+    // 规则数量限制：最多 20 条
+    const MAX_RULES = 20;
+    if (rules.length >= MAX_RULES) {
+      return {
+        success: false,
+        message: `已达到最大规则数量（${MAX_RULES}条），请删除一些规则后再保存`,
+      };
+    }
+
+    rules.push(rule);
+    localStorage.setItem(this.STORAGE_KEY, JSON.stringify(rules));
+    return { success: true };
+  }
+
+  // 更新规则
+  update(id: string, updates: Partial<DataRule>): void {
+    const rules = this.getAll();
+    const index = rules.findIndex((r) => r.id === id);
+    if (index !== -1) {
+      rules[index] = { ...rules[index], ...updates };
+      localStorage.setItem(this.STORAGE_KEY, JSON.stringify(rules));
+    }
+  }
+
+  // 删除规则
+  delete(id: string): void {
+    const rules = this.getAll();
+    const filtered = rules.filter((r) => r.id !== id);
+    localStorage.setItem(this.STORAGE_KEY, JSON.stringify(filtered));
+  }
+
+  // 记录使用
+  recordUse(id: string): void {
+    const rules = this.getAll();
+    const rule = rules.find((r) => r.id === id);
+    if (rule) {
+      rule.metadata.lastUsedAt = Date.now();
+      rule.metadata.useCount++;
+      localStorage.setItem(this.STORAGE_KEY, JSON.stringify(rules));
+    }
+  }
+}
+```
+
+### 存储限制
+
+- **规则数量限制**: 最多 20 条
+- localStorage 容量: 5-10MB（浏览器限制）
+- 单个规则约 1-5KB
+- 预计可存储 1000-5000 个规则（但受数量限制，最多 20 条）
+
+---
+
+## 功能亮点
+
+| 亮点     | 说明                           |
+| -------- | ------------------------------ |
+| 本地存储 | 数据保存在浏览器本地，无需后端 |
+| 快速复用 | 一键加载已保存的规则           |
+| 导入导出 | 支持 JSON 文件导入导出         |
+| 使用统计 | 记录使用次数和时间             |
+| 搜索筛选 | 支持关键词搜索                 |

docs/test-data-generator/ui-design.md

@@ -0,0 +1,489 @@
+# 界面设计
+
+## 设计原则
+
+1. **简洁直观** - 一目了然的布局
+2. **操作便捷** - 减少点击次数
+3. **实时反馈** - 配置即预览
+4. **响应式** - 支持多种屏幕尺寸
+
+---
+
+## 页面结构
+
+### 主页面布局
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│  🧪 测试数据生成器                                          [帮助] │
+├─────────────────────────────────────────────────────────────────────┤
+│                                                                     │
+│  ┌─────────────────────────────────────┐ ┌───────────────────────┐ │
+│  │  字段配置                             │ │  数据预览              │ │
+│  │                                     │ │                       │ │
+│  │  [+ 添加字段]                        │ │  [实时预览数据]       │ │
+│  │                                     │ │                       │ │
+│  │  字段列表...                         │ │                       │ │
+│  │                                     │ │                       │ │
+│  └─────────────────────────────────────┘ └───────────────────────┘ │
+│                                                                     │
+│  ┌───────────────────────────────────────────────────────────────┐ │
+│  │  生成选项                                                       │ │
+│  │  数量、格式、约束...                                          │ │
+│  └───────────────────────────────────────────────────────────────┘ │
+│                                                                     │
+│  ┌───────────────────────────────────────────────────────────────┐ │
+│  │  操作栏                                                     │ │
+│  │  [生成]  [保存规则]  [规则管理]                       │ │
+│  └───────────────────────────────────────────────────────────────┘ │
+│                                                                     │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 组件设计
+
+### 1. 字段列表组件
+
+**功能**: 展示和管理所有字段
+
+**界面**:
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│  字段配置                                                         │
+├─────────────────────────────────────────────────────────────────────┤
+│                                                                     │
+│  [+ 添加字段]                                                        │
+│                                                                     │
+│  ┌───────────────────────────────────────────────────────────────┐ │
+│  │ 1. name        [中文姓名 ▼]  [配置] [删除] [上移][下移]             │ │
+│  │ 2. email       [邮箱地址 ▼]  [配置] [删除] [上移][下移]             │ │
+│  │ 3. phone       [手机号   ▼]  [配置] [删除] [上移][下移]             │ │
+│  │ 4. age         [年龄     ▼]  [配置] [删除] [上移][下移]             │ │
+│  └───────────────────────────────────────────────────────────────┘ │
+│                                                                     │
+│  [+ 添加字段]                                                        │
+│                                                                     │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+**交互**:
+
+- 点击字段名可编辑
+- 点击生成器下拉框可切换生成器
+- 点击 配置 展开参数配置
+- 点击 删除 删除字段
+- 点击 上移下移 调整顺序
+
+---
+
+### 2. 字段配置组件
+
+**功能**: 配置单个字段的详细参数
+
+**界面**:
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│  字段配置                                                            │
+├─────────────────────────────────────────────────────────────────────┤
+│                                                                     │
+│  基础配置                                                        │
+│  ┌───────────────────────────────────────────────────────────────┐ │
+│  │ 字段名称:  [name                                         ]   │ │
+│  │ 字段描述:  [用户姓名                                     ]   │ │
+│  └───────────────────────────────────────────────────────────────┘ │
+│                                                                     │
+│  生成器选择                                                      │
+│  ┌───────────────────────────────────────────────────────────────┐ │
+│  │ 分类: [个人信息 ▼]                                         │   │
+│  │ 生成器: [中文姓名 ▼]                                        │   │
+│  │ 说明: 生成中文姓名，如张三、李四                           │   │
+│  └───────────────────────────────────────────────────────────────┘ │
+│                                                                     │
+│  参数配置                                                        │
+│  ┌───────────────────────────────────────────────────────────────┐ │
+│  │ 姓氏池: [百家姓前100 ▼]                                      │ │
+│  │ 名字长度: [1] ~ [2]                                          │ │
+│  │ ☑ 唯一性约束                                                 │ │
+│  │ ☑ 必填                                                       │ │
+│  └───────────────────────────────────────────────────────────────┘ │
+│                                                                     │
+│  空值率设置 (仅选填字段显示)                                       │
+│  ┌───────────────────────────────────────────────────────────────┐ │
+│  │ 空值概率: [====|----] 50%                                     │ │
+│  │ 预设: [低 20%] [中 50%] [高 80%]                              │ │
+│  └───────────────────────────────────────────────────────────────┘ │
+│                                                                     │
+│  预览示例                                                         │
+│  ┌───────────────────────────────────────────────────────────────┐ │
+│  │ 张伟, 李娜, 王强, 赵敏, 刘洋                                  │ │
+│  └───────────────────────────────────────────────────────────────┘ │
+│                                                                     │
+│  [保存]  [取消]                                                │
+│                                                                     │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+**交互说明**:
+
+- **必填复选框**: 勾选后该字段必填，100% 生成数据
+- **空值率设置**: 仅当选填时显示，控制该字段生成空值的概率
+- **预设按钮**: 快速设置常用空值率（低/中/高）
+- **空值率滑块**: 精细调节空值概率（0-100%）
+
+---
+
+### 3. 数据预览组件
+
+**功能**: 实时预览生成的数据
+
+**界面**:
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│  数据预览                                                         │
+├─────────────────────────────────────────────────────────────────────┤
+│                                                                     │
+│  预览: 前 10 条                                                   │
+│                                                                     │
+│  ┌───────────────────────────────────────────────────────────────┐ │
+│  │ {                                                             │ │
+│  │   "name": "张伟",                                             │ │
+│  │   "email": "zhangwei@qq.com",                                 │ │
+│  │   "phone": "13812345678",                                     │ │
+│  │   "age": 28                                                   │ │
+│  │ },                                                            │ │
+│  │ {                                                             │ │
+│  │   "name": "李娜",                                             │ │
+│  │   "email": "lina@163.com",                                    │ │
+│  │   "phone": "13987654321",                                     │ │
+│  │   "age": 35                                                   │ │
+│  │ },                                                            │ │
+│  │ ...                                                           │ │
+│  └───────────────────────────────────────────────────────────────┘ │
+│                                                                     │
+│  格式切换:                                                        │
+│  [JSON]  [CSV]                                                      │
+│                                                                     │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+**功能**:
+
+- 实时更新预览
+- 支持格式切换
+- 分页显示更多数据
+- 一键复制
+
+---
+
+### 4. 生成选项组件
+
+**功能**: 配置生成参数
+
+**界面**:
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│  生成选项                                                         │
+├─────────────────────────────────────────────────────────────────────┤
+│                                                                     │
+│  ┌─────────────────┐ ┌─────────────────┐ ┌───────────────────────┐ │
+│  │ 生成数量      │ │ 数据格式      │ │ 约束条件           │ │
+│  │                 │ │                 │ │                       │ │
+│  │ [100         ] │ │ ○ JSON          │ │ ☑ name 唯一          │ │
+│  │ [10 ▼]          │ │ ○ CSV           │ │ ☑ email 唯一         │ │
+│  │ [100 ▼]         │ │                 │ │ ☑ phone 唯一         │ │
+│  │ [自定义    ]  │ │                 │ │ ☐ age 唯一           │ │
+│  │                 │ │                 │ │                       │ │
+│  └─────────────────┘ └─────────────────┘ └───────────────────────┘ │
+│                                                                     │
+│  默认空值率 (选填字段)                                             │
+│  ┌───────────────────────────────────────────────────────────────┐ │
+│  │ 空值概率: [====|----] 50%                                     │ │
+│  │ 预设: [低 20%] [中 50%] [高 80%]                              │ │
+│  │ 说明: 未单独设置空值率的选填字段将使用此默认值                │ │
+│  └───────────────────────────────────────────────────────────────┘ │
+│                                                                     │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+### 5. 操作栏组件
+
+**功能**: 顶部操作按钮
+
+**界面**:
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│  操作栏                                                           │
+├─────────────────────────────────────────────────────────────────────┤
+│                                                                     │
+│  [生成数据]  [保存规则]  [规则管理]  [导入规则]  [导出]│
+│                                                                     │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+### 6. 生成结果组件
+
+**功能**: 展示生成结果，包含成功、警告、错误三种状态
+
+**成功状态界面**:
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│  生成结果                                                         │
+├─────────────────────────────────────────────────────────────────────┤
+│                                                                     │
+│  生成完成                                                          │
+│  ┌───────────────────────────────────────────────────────────────┐ │
+│  │ [成功图标] 成功生成 100 条数据，耗时 1234ms                  │ │
+│  └───────────────────────────────────────────────────────────────┘ │
+│                                                                     │
+│  数据统计:                                                        │
+│  ┌───────────────────────────────────────────────────────────────┐ │
+│  │ • 总条数: 100                                                 │ │
+│  │ • 成功条数: 100                                               │ │
+│  │ • 失败条数: 0                                                 │ │
+│  │ • 文件大小: 12.5 KB                                           │ │
+│  └───────────────────────────────────────────────────────────────┘ │
+│                                                                     │
+│  数据预览:                                                        │
+│  ┌───────────────────────────────────────────────────────────────┐ │
+│  │ [JSON 格式预览...]                                            │ │
+│  └───────────────────────────────────────────────────────────────┘ │
+│                                                                     │
+│  导出选项:                                                        │
+│  ┌───────────────────────────────────────────────────────────────┐ │
+│  │ [复制全部]  [下载 JSON]  [下载 CSV]                           │ │
+│  └───────────────────────────────────────────────────────────────┘ │
+│                                                                     │
+│  [关闭]                                                           │
+│                                                                     │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+**警告状态界面（部分字段失败）**:
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│  生成结果                                                         │
+├─────────────────────────────────────────────────────────────────────┤
+│                                                                     │
+│  部分字段生成失败                                                  │
+│  ┌───────────────────────────────────────────────────────────────┐ │
+│  │ [警告图标] 有 2 个字段生成失败                               │ │
+│  └───────────────────────────────────────────────────────────────┘ │
+│                                                                     │
+│  失败详情:                                                        │
+│  ┌───────────────────────────────────────────────────────────────┐ │
+│  │ [警告图标] "phone" - 重试 100 次后仍存在重复                  │ │
+│  │ [警告图标] "email" - 重试 100 次后仍存在重复                  │ │
+│  │                                                               │ │
+│  │ 提示: 这些字段的值已设置为空，您可以尝试减少生成数量          │ │
+│  │       或调整字段配置                                          │ │
+│  └───────────────────────────────────────────────────────────────┘ │
+│                                                                     │
+│  数据统计:                                                        │
+│  ┌───────────────────────────────────────────────────────────────┐ │
+│  │ • 总条数: 100                                                 │ │
+│  │ • 成功条数: 98                                                │ │
+│  │ • 失败条数: 2                                                 │ │
+│  │ • 文件大小: 12.3 KB                                           │ │
+│  └───────────────────────────────────────────────────────────────┘ │
+│                                                                     │
+│  数据预览:                                                        │
+│  ┌───────────────────────────────────────────────────────────────┐ │
+│  │ [JSON 格式预览...]                                            │ │
+│  └───────────────────────────────────────────────────────────────┘ │
+│                                                                     │
+│  导出选项:                                                        │
+│  ┌───────────────────────────────────────────────────────────────┐ │
+│  │ [复制全部]  [下载 JSON]  [下载 CSV]                           │ │
+│  └───────────────────────────────────────────────────────────────┘ │
+│                                                                     │
+│  [关闭]                                                           │
+│                                                                     │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+**错误状态界面（生成失败）**:
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│  生成失败                                                         │
+├─────────────────────────────────────────────────────────────────────┤
+│                                                                     │
+│  ┌───────────────────────────────────────────────────────────────┐ │
+│  │ [错误图标] 生成过程中发生错误                                │ │
+│  └───────────────────────────────────────────────────────────────┘ │
+│                                                                     │
+│  错误详情:                                                        │
+│  ┌───────────────────────────────────────────────────────────────┐ │
+│  │                                                               │ │
+│  │  错误类型: 生成器不存在                                      │ │
+│  │  错误信息: 字段 "phone" 的生成器 "chinesePhone1" 不存在      │ │
+│  │  错误位置: 字段配置第 2 行                                   │ │
+│  │                                                               │ │
+│  │  建议操作:                                                   │ │
+│  │  1. 检查字段配置中的生成器名称是否正确                       │ │
+│  │  2. 确认该生成器已正确注册                                   │ │
+│  │                                                               │ │
+│  └───────────────────────────────────────────────────────────────┘ │
+│                                                                     │
+│  [重新配置]  [关闭]                                                │
+│                                                                     │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+### 6.1 Toast 提示组件
+
+**功能**: 显示临时提示信息
+
+**成功提示**:
+
+```
+┌─────────────────────────────────────┐
+│ [成功图标] 数据生成成功             │
+└─────────────────────────────────────┘
+```
+
+**警告提示**:
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ [警告图标] 有 2 个字段生成失败：phone、email               │
+└─────────────────────────────────────────────────────────────┘
+```
+
+**错误提示**:
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ [错误图标] 生成失败：生成器 "xxx" 不存在                   │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
+### 6.2 Modal 提示组件
+
+**功能**: 显示严重错误的模态框
+
+**错误模态框**:
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                                                             │
+│  ┌───────────────────────────────────────────────────────┐ │
+│  │                                                       │ │
+│  │  [错误图标] 生成失败                                  │ │
+│  │                                                       │ │
+│  │  字段 "phone" 的生成器 "chinesePhone1" 不存在        │ │
+│  │                                                       │ │
+│  │  请检查字段配置中的生成器名称是否正确                 │ │
+│  │                                                       │ │
+│  │  ─────────────────────────────────────────────────── │ │
+│  │                                                       │ │
+│  │                    [ 确定 ]                           │ │
+│  │                                                       │ │
+│  └───────────────────────────────────────────────────────┘ │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
+### 7. 规则管理组件
+
+**功能**: 管理已保存的规则
+
+**界面**:
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│  规则管理                                                         │
+├─────────────────────────────────────────────────────────────────────┤
+│                                                                     │
+│  搜索: [搜索规则名称...                                          ] │
+│                                                                     │
+│  规则列表:                                                        │
+│  ┌───────────────────────────────────────────────────────────────┐ │
+│  │ 电商用户数据 - 测试用                                       │ │
+│  │    用于测试用户注册功能                                     │ │
+│  │    4 个字段 | 100 条 | JSON                                │ │
+│  │    2024-01-15 创建 | 使用 12 次                           │ │
+│  │    [加载]  [编辑]  [导出]  [删除]                 │ │
+│  │                                                               │ │
+│  │ 电商订单数据 - 测试用                                       │ │
+│  │    用于测试订单功能                                         │ │
+│  │    6 个字段 | 500 条 | JSON                                │ │
+│  │    2024-01-16 创建 | 使用 8 次                            │ │
+│  │    [加载]  [编辑]  [导出]  [删除]                 │ │
+│  └───────────────────────────────────────────────────────────────┘ │
+│                                                                     │
+│  [导入规则]  [导出全部]                                        │
+│                                                                     │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 响应式设计
+
+### 桌面端 (>1024px)
+
+- 左右分栏布局
+- 字段配置区占 60%
+- 数据预览区占 40%
+
+---
+
+## 交互细节
+
+### 拖拽排序
+
+- 字段支持拖拽排序（基于 @dnd-kit/sortable）
+- 拖拽手柄（GripVertical 图标）位于字段左侧
+- 拖拽时显示半透明效果和阴影
+- 释放后立即生效，自动更新字段顺序
+
+### 实时预览
+
+- 配置参数时实时更新预览
+- 延迟 300ms 防抖，避免频繁重渲染
+- 预览最多显示 10 条示例数据
+- 生成完成后切换为完整结果预览
+
+### 虚拟列表
+
+- 数据量超过 100 条时自动启用虚拟滚动
+- 仅渲染可见区域的行，大幅减少 DOM 节点
+- 行高固定 20px，支持快速滚动
+
+---
+
+## 主题支持
+
+### 浅色主题
+
+- 背景色: #ffffff
+- 文字色: #333333
+- 边框色: #e0e0e0
+- 主题色: #3b82f6
+
+### 深色主题
+
+- 背景色: #1a1a1a
+- 文字色: #ffffff
+- 边框色: #404040
+- 主题色: #60a5fa

entrypoints/background.ts

@@ -1,189 +0,0 @@
-import '../.wxt/types/imports.d.ts';
-import { browser } from 'wxt/browser';
-import { MessageAction, onMessage, sendMessage } from '@/utils/messages';
-import { createAllContextMenus, parseContextMenuClick } from '@/utils/contextMenu';
-import { saveContextMenuData } from '@/utils/useContextMenuData';
-
-export default defineBackground(() => {
-  // 1. 扩展初次安装或更新时，注册右键上下文菜单
-  browser.runtime.onInstalled.addListener(() => {
-    createAllContextMenus();
-  });
-
-  // 2. 右键点击路由
-  browser.contextMenus.onClicked.addListener(async (info, _tab) => {
-    const result = parseContextMenuClick(info.menuItemId as string, info);
-
-    if (!result.success || !result.data) {
-      if (result.error) {
-        console.warn('[Context Menu Warning]', result.error);
-      }
-      return;
-    }
-
-    const { featureKey, payload } = result.data;
-
-    try {
-      const sidePanelState = await browser.storage.local.get('sidePanelOpen');
-      const isSidePanelOpen = sidePanelState.sidePanelOpen === true;
-
-      if (isSidePanelOpen) {
-        await sendMessage(MessageAction.CONTEXT_MENU_CLICKED, { featureKey, payload });
-        return;
-      }
-    } catch (err) {
-      console.debug('[Context Menu] Side panel pipeline is not available:', err);
-    }
-
-    await saveContextMenuData({ featureKey, payload });
-
-    try {
-      await browser.action.openPopup();
-    } catch (err) {
-      console.warn(
-        '[Context Menu] 自动打开 popup 失败，请手动点击扩展图标，暂存数据已安全保留:',
-        err,
-      );
-    }
-  });
-
-  // 监听扩展图标点击事件，安全激活侧边栏
-  browser.action.onClicked.addListener(async (tab) => {
-    if (tab.id) {
-      try {
-        await browser.sidePanel.open({ tabId: tab.id });
-      } catch (err) {
-        console.error('Failed to open side panel via extension action clicked:', err);
-      }
-    }
-  });
-
-  // 3. 注入主环境脚本（content script 无权访问 chrome.tabs/scripting，委托 background 执行）
-  onMessage(MessageAction.INJECT_MAIN_WORLD_SCRIPT, async (message) => {
-    const sender = message.sender as chrome.runtime.MessageSender | undefined;
-    const tabId = sender?.tab?.id;
-
-    if (!tabId) {
-      console.warn('[RightClickRestorer] Injection request missing tabId');
-      return { success: false, message: 'Missing tabId' };
-    }
-
-    try {
-      await browser.scripting.executeScript({
-        target: { tabId },
-        func: () => {
-          'use strict';
-          const w = window as unknown as Record<string, unknown>;
-          if (w.__testingToolsRightClickPatched) return;
-          w.__testingToolsRightClickPatched = true;
-
-          const PROTECTED = ['contextmenu', 'copy', 'paste', 'cut', 'selectstart'];
-
-          /* 1. 屏蔽 MouseEvent.prototype.preventDefault（含 mousedown 右键） */
-          const _origPreventDefault = MouseEvent.prototype.preventDefault;
-          Object.defineProperty(MouseEvent.prototype, 'preventDefault', {
-            value: function (this: MouseEvent) {
-              const t = this.type;
-              if (PROTECTED.includes(t) || (t === 'mousedown' && this.button === 2)) {
-                return;
-              }
-              return _origPreventDefault.call(this);
-            },
-            writable: true,
-            configurable: true,
-          });
-
-          /* 2. 屏蔽 Event.prototype.stopPropagation / stopImmediatePropagation */
-          const _origStopPropagation = Event.prototype.stopPropagation;
-          Object.defineProperty(Event.prototype, 'stopPropagation', {
-            value: function (this: Event) {
-              if (PROTECTED.includes(this.type)) return;
-              return _origStopPropagation.call(this);
-            },
-            writable: true,
-            configurable: true,
-          });
-
-          const _origStopImmediatePropagation = Event.prototype.stopImmediatePropagation;
-          Object.defineProperty(Event.prototype, 'stopImmediatePropagation', {
-            value: function (this: Event) {
-              if (PROTECTED.includes(this.type)) return;
-              return _origStopImmediatePropagation.call(this);
-            },
-            writable: true,
-            configurable: true,
-          });
-
-          /* 3. 拦截 document.oncontextmenu（处理 return false 方式） */
-          let _docOnContextMenu: unknown = null;
-          Object.defineProperty(document, 'oncontextmenu', {
-            get() {
-              return _docOnContextMenu;
-            },
-            set(fn: unknown) {
-              if (typeof fn === 'function') {
-                _docOnContextMenu = function (this: GlobalEventHandlers, e: MouseEvent) {
-                  const r = (fn as (this: GlobalEventHandlers, ev: MouseEvent) => unknown).call(
-                    this,
-                    e,
-                  );
-                  return r === false ? true : r;
-                };
-              } else {
-                _docOnContextMenu = fn;
-              }
-            },
-            configurable: true,
-          });
-        },
-        world: 'MAIN',
-      });
-
-      return { success: true };
-    } catch (err) {
-      const errorMsg = err instanceof Error ? err.message : String(err);
-      console.error('[RightClickRestorer] executeScript failed:', errorMsg);
-      return { success: false, message: errorMsg };
-    }
-  });
-
-  // 4. 异步刷新请求监听（统一使用 alarms API，避免 MV3 Service Worker 被销毁导致任务丢失）
-  onMessage(MessageAction.RELOAD_TAB, async (message) => {
-    const { tabId, delay = 0 } = message.data;
-
-    const executeReload = () => {
-      browser.tabs.reload(tabId).catch((err) => {
-        console.error('Failed to execute tab reload operation:', err);
-      });
-    };
-
-    if (delay <= 0) {
-      executeReload();
-      return { success: true };
-    }
-
-    const alarmName = `reload-tab-${tabId}-${Date.now()}`;
-
-    // 创建一次性 Alarm，由浏览器内核保障触发（不受 Service Worker 生命周期影响）
-    await browser.alarms.create(alarmName, { when: Date.now() + delay });
-
-    // 兜底清理：若 alarm 因异常未触发，delay 后 5 秒强制移除监听器并清理 alarm
-    const cleanupTimeout = setTimeout(() => {
-      browser.alarms.onAlarm.removeListener(alarmListener);
-      browser.alarms.clear(alarmName).catch(() => {});
-    }, delay + 5000);
-
-    const alarmListener = (alarm: { name: string }) => {
-      if (alarm.name !== alarmName) return;
-
-      clearTimeout(cleanupTimeout);
-      executeReload();
-      browser.alarms.onAlarm.removeListener(alarmListener);
-      browser.alarms.clear(alarmName).catch(() => {});
-    };
-
-    browser.alarms.onAlarm.addListener(alarmListener);
-
-    return { success: true };
-  });
-});

entrypoints/content.ts

@@ -1,10 +0,0 @@
-import '../.wxt/types/imports.d.ts';
-import { initMessageHandler } from './content/messageHandler';
-
-export default defineContentScript({
-  matches: ['<all_urls>'],
-  runAt: 'document_end',
-  main() {
-    initMessageHandler();
-  },
-});

entrypoints/content/messageHandler.ts

@@ -1,5 +0,0 @@
-import { initContextMenuHandler } from './contextMenuHandler';
-
-export function initMessageHandler(): void {
-  initContextMenuHandler();
-}

entrypoints/options/App.tsx

@@ -1,383 +0,0 @@
-import { SyntheticEvent, useEffect, useMemo, useState } from 'react';
-import { GripVertical, RefreshCw } from 'lucide-react';
-import {
-  closestCenter,
-  DndContext,
-  type DragEndEvent,
-  KeyboardSensor,
-  PointerSensor,
-  useSensor,
-  useSensors,
-} from '@dnd-kit/core';
-import {
-  arrayMove,
-  SortableContext,
-  sortableKeyboardCoordinates,
-  useSortable,
-  verticalListSortingStrategy,
-} from '@dnd-kit/sortable';
-import { CSS } from '@dnd-kit/utilities';
-import type { PageType, StorageSchema } from '@/types/storage';
-import { storageUtil } from '@/utils/chromeStorage';
-import type { PaletteColorKey } from '@/config/features';
-import {
-  getAllFeatureKeys,
-  getDefaultPageOrder,
-  getDefaultVisibleFeatureKeys,
-  getFeatureByKey,
-} from '@/config/features';
-import GlobalSnackbar, { useSnackbarState } from '@/components/GlobalSnackbar';
-import PageErrorBoundary from '@/components/PageErrorBoundary';
-import { useTranslation } from 'react-i18next';
-
-const PALETTE_COLORS: Record<PaletteColorKey, string> = {
-  primary: '#1976d2',
-  success: '#2e7d32',
-  warning: '#e65100',
-  error: '#c62828',
-  secondary: '#9c27b0',
-  info: '#0288d1',
-};
-
-const getColorCode = (key: PaletteColorKey): string => PALETTE_COLORS[key];
-
-const isValidPage = (page: unknown): page is PageType => {
-  return typeof page === 'string' && (getAllFeatureKeys() as string[]).includes(page);
-};
-
-const isValidPageList = (pages: unknown): pages is PageType[] => {
-  return Array.isArray(pages) && pages.every(isValidPage);
-};
-
-type WindowType = 'popup' | 'sidepanel' | 'tab';
-
-interface SortableFeatureRowProps {
-  pageKey: PageType;
-  isLast: boolean;
-  isChecked: boolean;
-  isDisabled: boolean;
-  onToggle: (key: PageType) => void;
-}
-
-function SortableFeatureRow({
-  pageKey,
-  isLast,
-  isChecked,
-  isDisabled,
-  onToggle,
-}: SortableFeatureRowProps) {
-  const { t } = useTranslation(['features']);
-  const { attributes, listeners, setNodeRef, transform, transition, isDragging } = useSortable({
-    id: pageKey,
-  });
-
-  const feature = getFeatureByKey(pageKey);
-  if (!feature) return null;
-
-  const colorKey = feature.themeColorKey ?? 'primary';
-  const colorCode = getColorCode(colorKey);
-
-  const style = {
-    transform: CSS.Transform.toString(transform),
-    transition,
-    zIndex: isDragging ? 1 : 'auto',
-    position: 'relative' as const,
-    backgroundColor: isDragging ? `${colorCode}0a` : 'transparent',
-    boxShadow: isDragging ? '0 8px 20px rgba(0,0,0,0.08)' : 'none',
-  };
-
-  return (
-    <div
-      ref={setNodeRef}
-      style={style}
-      className={`flex items-center justify-between p-4 sm:p-5 transition-all duration-200 hover:bg-muted ${
-        isLast ? '' : 'border-b border-border'
-      }`}
-    >
-      <div className="flex items-center gap-3 sm:gap-4 flex-1 min-w-0">
-        {/* 拖拽手柄 */}
-        <div
-          className="drag-handle text-muted-foreground cursor-grab touch-none transition-colors duration-200 hover:text-foreground active:cursor-grabbing"
-          {...attributes}
-          {...listeners}
-          aria-label={`拖拽以调整 ${t(feature.labelKey)} 的位置`}
-        >
-          <GripVertical size={16} />
-        </div>
-
-        {/* 功能图标 */}
-        <div
-          className="flex items-center justify-center w-9 h-9 rounded-xl flex-shrink-0"
-          style={{
-            backgroundColor: `${colorCode}1a`,
-            color: colorCode,
-          }}
-        >
-          {feature.icon && <feature.icon size={20} />}
-        </div>
-
-        {/* 文本信息 */}
-        <div className="min-w-0 flex-1">
-          <div className="font-bold text-[0.95rem] leading-tight text-foreground">
-            {t(feature.labelKey)}
-          </div>
-          {feature.descriptionKey && (
-            <div
-              className="text-xs text-muted-foreground font-medium mt-0.5 overflow-hidden text-ellipsis whitespace-nowrap"
-              title={t(feature.descriptionKey)}
-            >
-              {t(feature.descriptionKey)}
-            </div>
-          )}
-        </div>
-      </div>
-
-      {/* 开关 */}
-      <button
-        type="button"
-        role="switch"
-        aria-checked={isChecked}
-        disabled={isDisabled}
-        onClick={() => onToggle(pageKey)}
-        className={`relative inline-flex h-6 w-11 items-center rounded-full transition-colors duration-200 focus:outline-none focus:ring-2 focus:ring-primary focus:ring-offset-2 ${
-          isChecked ? 'bg-primary' : 'bg-muted'
-        } ${isDisabled ? 'opacity-50 cursor-not-allowed' : 'cursor-pointer'}`}
-      >
-        <span
-          className={`inline-block h-4 w-4 transform rounded-full bg-background transition-transform duration-200 ${
-            isChecked ? 'translate-x-6' : 'translate-x-1'
-          }`}
-        />
-      </button>
-    </div>
-  );
-}
-
-export default function App() {
-  const { t } = useTranslation(['features', 'common']);
-
-  const initialWindowType = useMemo(() => {
-    if (typeof window === 'undefined') return 'popup';
-    const params = new URLSearchParams(window.location.search);
-    const tab = params.get('tab');
-    if (tab === 'popup' || tab === 'sidepanel' || tab === 'tab') {
-      return tab as WindowType;
-    }
-    return 'popup';
-  }, []);
-
-  const [windowType, setWindowType] = useState<WindowType>(initialWindowType);
-  const [visiblePages, setVisiblePages] = useState<PageType[]>([]);
-  const [pageOrder, setPageOrder] = useState<PageType[]>([]);
-  const [isLoaded, setIsLoaded] = useState(false);
-  const { snackbarProps, showMessage } = useSnackbarState();
-
-  const sensors = useSensors(
-    useSensor(PointerSensor, { activationConstraint: { distance: 4 } }),
-    useSensor(KeyboardSensor, { coordinateGetter: sortableKeyboardCoordinates }),
-  );
-
-  const configKeys = useMemo(() => {
-    switch (windowType) {
-      case 'sidepanel':
-        return {
-          visible: 'app/sidepanelVisiblePages' as keyof StorageSchema,
-          order: 'app/sidepanelPageOrder' as keyof StorageSchema,
-        };
-      case 'tab':
-        return {
-          visible: 'app/tabVisiblePages' as keyof StorageSchema,
-          order: 'app/tabPageOrder' as keyof StorageSchema,
-        };
-      case 'popup':
-      default:
-        return {
-          visible: 'app/popupVisiblePages' as keyof StorageSchema,
-          order: 'app/popupPageOrder' as keyof StorageSchema,
-        };
-    }
-  }, [windowType]);
-
-  useEffect(() => {
-    const url = new URL(window.location.href);
-    url.searchParams.set('tab', windowType);
-    window.history.replaceState({}, '', url.toString());
-  }, [windowType]);
-
-  useEffect(() => {
-    const loadConfig = async () => {
-      setIsLoaded(false);
-      try {
-        const [savedVisible, savedOrder] = await Promise.all([
-          storageUtil.get(configKeys.visible, getDefaultVisibleFeatureKeys()),
-          storageUtil.get(configKeys.order, getDefaultPageOrder()),
-        ]);
-        setVisiblePages(
-          isValidPageList(savedVisible) ? savedVisible : getDefaultVisibleFeatureKeys(),
-        );
-        setPageOrder(isValidPageList(savedOrder) ? savedOrder : getDefaultPageOrder());
-      } catch (error) {
-        console.error('Failed to load config:', error);
-        setVisiblePages(getDefaultVisibleFeatureKeys());
-        setPageOrder(getDefaultPageOrder());
-      } finally {
-        setIsLoaded(true);
-      }
-    };
-
-    loadConfig().catch(console.error);
-  }, [configKeys]);
-
-  const showToast = (message: string, severity: 'success' | 'info' | 'warning') => {
-    showMessage(message, { severity });
-  };
-
-  const handlePageToggle = async (page: PageType) => {
-    const isCurrentlyVisible = visiblePages.includes(page);
-    let newPages: PageType[];
-
-    if (isCurrentlyVisible) {
-      if (visiblePages.length <= 1) {
-        showToast('至少需要保留一个可见页面', 'warning');
-        return;
-      }
-      newPages = visiblePages.filter((p) => p !== page);
-    } else {
-      newPages = [...visiblePages, page];
-    }
-
-    try {
-      await storageUtil.set(configKeys.visible, newPages);
-      setVisiblePages(newPages);
-      const feature = getFeatureByKey(page);
-      const label = feature ? t(feature.labelKey) : page;
-      showToast(`已${isCurrentlyVisible ? '隐藏' : '显示'} ${label}`, 'success');
-    } catch (error) {
-      console.error('Failed to save config:', error);
-      showToast('保存失败', 'warning');
-    }
-  };
-
-  const handleDragEnd = async (event: DragEndEvent) => {
-    const { active, over } = event;
-    if (!over || active.id === over.id) return;
-
-    const oldIndex = pageOrder.indexOf(active.id as PageType);
-    const newIndex = pageOrder.indexOf(over.id as PageType);
-    if (oldIndex < 0 || newIndex < 0) return;
-
-    const newOrder = arrayMove(pageOrder, oldIndex, newIndex);
-    setPageOrder(newOrder);
-
-    try {
-      await storageUtil.set(configKeys.order, newOrder);
-    } catch (error) {
-      console.error('Failed to save order:', error);
-      showToast('排序保存失败', 'warning');
-    }
-  };
-
-  const handleRestoreDefaults = async () => {
-    try {
-      const defaults = getDefaultVisibleFeatureKeys();
-      const defaultOrder = getDefaultPageOrder();
-
-      await Promise.all([
-        storageUtil.set(configKeys.visible, defaults),
-        storageUtil.set(configKeys.order, defaultOrder),
-      ]);
-
-      setVisiblePages(defaults);
-      setPageOrder(defaultOrder);
-      showToast('已恢复当前模式默认设置', 'success');
-    } catch (error) {
-      console.error('Failed to restore defaults:', error);
-      showToast('恢复失败', 'warning');
-    }
-  };
-
-  const handleWindowTypeChange = (_event: SyntheticEvent, newType: WindowType) => {
-    if (newType !== null) {
-      setWindowType(newType);
-    }
-  };
-
-  if (!isLoaded) {
-    return (
-      <div className="flex justify-center items-center min-h-screen">
-        <div className="w-6 h-6 border-2 border-primary border-t-transparent rounded-full animate-spin" />
-      </div>
-    );
-  }
-
-  return (
-    <div className="app min-h-screen bg-background flex flex-col">
-      <PageErrorBoundary>
-        {/* 顶部标题与导航栏 */}
-        <div className="w-full bg-background border-b border-border pt-8 sm:pt-12 pb-0 px-4 sm:px-8">
-          <div className="max-w-3xl mx-auto">
-            {/* Tab 与恢复按钮同行 */}
-            <div className="flex items-end justify-between border-b-0">
-              <div className="flex-1 flex">
-                {(['popup', 'sidepanel', 'tab'] as WindowType[]).map((type) => (
-                  <button
-                    key={type}
-                    onClick={(e) => handleWindowTypeChange(e, type)}
-                    className={`px-4 sm:px-6 py-2 text-[0.9rem] font-bold transition-colors duration-200 ${
-                      windowType === type
-                        ? 'text-primary border-b-2 border-primary'
-                        : 'text-muted-foreground hover:text-foreground'
-                    }`}
-                  >
-                    {type === 'popup' ? 'Popup 窗口' : type === 'sidepanel' ? '侧边栏' : '标签页'}
-                  </button>
-                ))}
-              </div>
-              <button
-                onClick={handleRestoreDefaults}
-                className="mb-1 ml-2 p-1.5 text-muted-foreground hover:text-primary hover:bg-primary/10 rounded-lg transition-colors duration-200"
-                title="恢复当前模式默认"
-              >
-                <RefreshCw size={16} />
-              </button>
-            </div>
-          </div>
-        </div>
-
-        {/* 主内容区域 */}
-        <div className="flex-1 p-4 sm:p-8">
-          <div className="max-w-3xl mx-auto">
-            <div className="rounded-2xl border border-border overflow-hidden bg-card shadow-sm">
-              <DndContext
-                sensors={sensors}
-                collisionDetection={closestCenter}
-                onDragEnd={handleDragEnd}
-              >
-                <SortableContext items={pageOrder} strategy={verticalListSortingStrategy}>
-                  <div className="flex flex-col">
-                    {pageOrder.map((key, index, array) => {
-                      const isChecked = visiblePages.includes(key);
-                      const isDisabled = isChecked && visiblePages.length === 1;
-                      return (
-                        <SortableFeatureRow
-                          key={key}
-                          pageKey={key}
-                          isLast={index === array.length - 1}
-                          isChecked={isChecked}
-                          isDisabled={isDisabled}
-                          onToggle={handlePageToggle}
-                        />
-                      );
-                    })}
-                  </div>
-                </SortableContext>
-              </DndContext>
-            </div>
-          </div>
-        </div>
-      </PageErrorBoundary>
-
-      <GlobalSnackbar {...snackbarProps} />
-    </div>
-  );
-}

entrypoints/options/__tests__/App.test.tsx

@@ -1,131 +0,0 @@
-import { describe, expect, it, vi, beforeEach } from 'vitest';
-import { render, screen, waitFor } from '@testing-library/react';
-import App from '../App';
-import { storageUtil } from '@/utils/chromeStorage';
-import {
-  getDefaultVisibleFeatureKeys,
-  getDefaultPageOrder,
-  getFeatureByKey,
-} from '@/config/features';
-
-// Mock storageUtil
-vi.mock('@/utils/chromeStorage', () => ({
-  storageUtil: {
-    get: vi.fn(),
-    set: vi.fn(() => Promise.resolve()),
-  },
-}));
-
-// Mock i18next
-vi.mock('react-i18next', () => ({
-  useTranslation: () => ({
-    t: (key: string) => key,
-  }),
-}));
-
-describe('Options App', () => {
-  beforeEach(() => {
-    vi.clearAllMocks();
-    localStorage.clear();
-  });
-
-  it('合法数据应正常加载并显示正确的功能列表', async () => {
-    const defaultOrder = getDefaultPageOrder();
-
-    (storageUtil.get as any).mockImplementation((_key: string, defaultValue: any) =>
-      Promise.resolve(defaultValue),
-    );
-
-    render(<App />);
-
-    await waitFor(() => {
-      expect(screen.queryByRole('progressbar')).not.toBeInTheDocument();
-    });
-
-    // 验证默认可见的功能都被渲染出来了
-    for (const key of defaultOrder) {
-      const feature = getFeatureByKey(key);
-      if (feature) {
-        expect(screen.getByText(feature.labelKey)).toBeInTheDocument();
-      }
-    }
-  });
-
-  it('非法 visiblePages 数据应回退到默认值', async () => {
-    const defaultVisible = getDefaultVisibleFeatureKeys();
-
-    (storageUtil.get as any).mockImplementation((key: string, defaultValue: any) => {
-      if (key.includes('VisiblePages')) {
-        return Promise.resolve(['invalidPage', 'anotherInvalid']);
-      }
-      return Promise.resolve(defaultValue);
-    });
-
-    render(<App />);
-
-    await waitFor(() => {
-      expect(screen.queryByRole('progressbar')).not.toBeInTheDocument();
-    });
-
-    // 验证默认值的功能仍然被渲染（非法数据被回退）
-    for (const key of defaultVisible) {
-      const feature = getFeatureByKey(key);
-      if (feature && key !== 'dashboard') {
-        expect(screen.getByText(feature.labelKey)).toBeInTheDocument();
-      }
-    }
-  });
-
-  it('非法 pageOrder 数据应回退到默认值', async () => {
-    const defaultOrder = getDefaultPageOrder();
-
-    (storageUtil.get as any).mockImplementation((key: string, defaultValue: any) => {
-      if (key.includes('PageOrder')) {
-        return Promise.resolve(['notARealPage', 123, null]);
-      }
-      return Promise.resolve(defaultValue);
-    });
-
-    render(<App />);
-
-    await waitFor(() => {
-      expect(screen.queryByRole('progressbar')).not.toBeInTheDocument();
-    });
-
-    // 验证默认顺序的功能都被渲染
-    for (const key of defaultOrder) {
-      const feature = getFeatureByKey(key);
-      if (feature) {
-        expect(screen.getByText(feature.labelKey)).toBeInTheDocument();
-      }
-    }
-  });
-
-  it('非数组数据应回退到默认值', async () => {
-    const defaultOrder = getDefaultPageOrder();
-
-    (storageUtil.get as any).mockImplementation((key: string, defaultValue: any) => {
-      if (key.includes('VisiblePages')) {
-        return Promise.resolve('not-an-array');
-      }
-      if (key.includes('PageOrder')) {
-        return Promise.resolve({ foo: 'bar' });
-      }
-      return Promise.resolve(defaultValue);
-    });
-
-    render(<App />);
-
-    await waitFor(() => {
-      expect(screen.queryByRole('progressbar')).not.toBeInTheDocument();
-    });
-
-    // 验证默认功能都被渲染
-    for (const key of defaultOrder) {
-      const feature = getFeatureByKey(key);
-      if (feature) {
-        expect(screen.getByText(feature.labelKey)).toBeInTheDocument();
-      }
-    }
-  });
-});

entrypoints/options/index.html

@@ -1,12 +0,0 @@
-<!DOCTYPE html>
-<html lang="zh-CN">
-  <head>
-    <meta charset="UTF-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>扩展设置 - Testing Tools</title>
-  </head>
-  <body>
-    <div id="root"></div>
-    <script type="module" src="./main.tsx"></script>
-  </body>
-</html>

entrypoints/options/main.tsx

@@ -1,11 +0,0 @@
-import ReactDOM from 'react-dom/client';
-import AppRoot from '@/providers/AppRoot';
-import '@/i18n';
-import '@/src/index.css';
-import App from './App';
-
-ReactDOM.createRoot(document.getElementById('root')!).render(
-  <AppRoot>
-    <App />
-  </AppRoot>,
-);

entrypoints/popup/App.tsx

@@ -1,47 +0,0 @@
-import RouterProvider from '@/providers/RouterProvider';
-import TopBar from '@/components/TopBar';
-import RouterContainer from '@/components/RouterContainer';
-import ErrorBoundary from '@/components/ErrorBoundary';
-import { SnackbarProvider } from '@/components/GlobalSnackbar';
-import { getEntryPointType } from '@/config/features';
-import { useMemo } from 'react';
-
-export default function App() {
-  const handleOpenOptions = () => {
-    chrome.runtime.openOptionsPage().catch(console.error);
-  };
-
-  const entryType = useMemo(() => getEntryPointType(), []);
-
-  const routerConfig = useMemo(() => {
-    if (entryType === 'tab') {
-      return {
-        syncKey: 'app/tabRoute' as const,
-        visiblePagesKey: 'app/tabVisiblePages' as const,
-        pageOrderKey: 'app/tabPageOrder' as const,
-      };
-    }
-    return {
-      syncKey: 'app/popupRoute' as const,
-      visiblePagesKey: 'app/popupVisiblePages' as const,
-      pageOrderKey: 'app/popupPageOrder' as const,
-    };
-  }, [entryType]);
-
-  return (
-    <RouterProvider
-      syncKey={routerConfig.syncKey}
-      visiblePagesKey={routerConfig.visiblePagesKey}
-      pageOrderKey={routerConfig.pageOrderKey}
-    >
-      <SnackbarProvider initialOptions={{ autoHideDuration: 1500 }}>
-        <div className="app flex flex-col w-[400px] max-w-[400px] min-w-[400px] h-[600px] min-h-[600px] overflow-hidden bg-background sm:w-screen sm:max-w-none sm:min-w-0 sm:h-screen sm:min-h-0">
-          <TopBar onOpenOptions={handleOpenOptions} />
-          <ErrorBoundary>
-            <RouterContainer />
-          </ErrorBoundary>
-        </div>
-      </SnackbarProvider>
-    </RouterProvider>
-  );
-}

entrypoints/rightClickRestorer.content.ts

@@ -1,194 +0,0 @@
-import { MessageAction, onMessage, sendMessage } from '@/utils/messages';
-
-const BADGE_ID = 'testing-tools-right-click-restorer-badge';
-const BADGE_STYLE_ID = 'testing-tools-right-click-restorer-badge-style';
-
-let isRestored = false;
-
-function updateBadge(): void {
-  const badge = document.getElementById(BADGE_ID);
-  if (badge) {
-    badge.style.opacity = isRestored ? '1' : '0';
-  }
-}
-
-function createBadge(): void {
-  if (document.getElementById(BADGE_ID)) return;
-
-  if (!document.getElementById(BADGE_STYLE_ID)) {
-    const style = document.createElement('style');
-    style.id = BADGE_STYLE_ID;
-    style.textContent = `
-      #${BADGE_ID} {
-        position: fixed;
-        bottom: 16px;
-        right: 16px;
-        z-index: 2147483646;
-        padding: 6px 12px;
-        background: #2e7d32;
-        color: #ffffff;
-        border-radius: 20px;
-        font-size: 12px;
-        font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
-        box-shadow: 0 2px 8px rgba(0,0,0,0.2);
-        opacity: 0;
-        transition: opacity 0.2s ease-out;
-        pointer-events: none;
-        user-select: none;
-      }
-      @media (prefers-color-scheme: dark) {
-        #${BADGE_ID} {
-          background: #4caf50;
-          box-shadow: 0 2px 8px rgba(0,0,0,0.4);
-        }
-      }
-    `;
-    document.head.appendChild(style);
-  }
-
-  const badge = document.createElement('div');
-  badge.id = BADGE_ID;
-  badge.textContent = '\u53f3\u952e\u5df2\u89e3\u9501';
-  document.body.appendChild(badge);
-}
-
-/* ======================== Main World 注入 ======================== */
-
-async function injectMainWorldScript(): Promise<void> {
-  try {
-    const response = await sendMessage(MessageAction.INJECT_MAIN_WORLD_SCRIPT);
-    if (!response.success) {
-      console.error('[RightClickRestorer] Background injection failed:', response.message);
-    }
-  } catch (err) {
-    console.error('[RightClickRestorer] Failed to request main world injection:', err);
-  }
-}
-
-/* ======================== Isolated World 事件拦截 ======================== */
-
-function installEventIntercepts(): void {
-  window.addEventListener(
-    'contextmenu',
-    (e) => {
-      if (!isRestored) return;
-      e.stopPropagation();
-    },
-    true,
-  );
-
-  // 部分网站在 mousedown 阶段阻止 contextmenu
-  window.addEventListener(
-    'mousedown',
-    (e) => {
-      if (!isRestored) return;
-      if (e.button === 2 || (e.buttons & 2) !== 0) {
-        e.stopPropagation();
-      }
-    },
-    true,
-  );
-}
-
-/* ======================== 遮罩层穿透 ======================== */
-
-const MEDIA_TAGS = new Set(['IMG', 'VIDEO', 'CANVAS', 'SVG']);
-
-function initMousePenetration(): void {
-  window.addEventListener(
-    'mousedown',
-    (e) => {
-      if (!isRestored || e.button !== 2) return;
-
-      const elements = document.elementsFromPoint(e.clientX, e.clientY);
-      if (!elements.length) return;
-
-      let targetMedia: HTMLElement | null = null;
-      for (const el of elements) {
-        if (MEDIA_TAGS.has(el.tagName)) {
-          targetMedia = el as HTMLElement;
-          break;
-        }
-      }
-
-      if (!targetMedia) return;
-
-      const modified: Array<{ el: HTMLElement; original: string | null }> = [];
-      let foundMedia = false;
-
-      for (const el of elements) {
-        const htmlEl = el as HTMLElement;
-
-        if (el === targetMedia) {
-          foundMedia = true;
-          const original = htmlEl.style.pointerEvents || null;
-          htmlEl.style.setProperty('pointer-events', 'all', 'important');
-          modified.push({ el: htmlEl, original });
-          continue;
-        }
-
-        if (!foundMedia) {
-          const original = htmlEl.style.pointerEvents || null;
-          htmlEl.style.setProperty('pointer-events', 'none', 'important');
-          modified.push({ el: htmlEl, original });
-        }
-      }
-
-      setTimeout(() => {
-        for (const { el, original } of modified) {
-          if (original === null || original === '') {
-            el.style.removeProperty('pointer-events');
-          } else {
-            el.style.pointerEvents = original;
-          }
-        }
-      }, 300);
-    },
-    true,
-  );
-}
-
-/* ======================== 激活保护 ======================== */
-
-async function activateProtection(): Promise<void> {
-  if (isRestored) return;
-
-  await injectMainWorldScript();
-
-  // 再次检查，防止并发调用导致重复注册
-  if (isRestored) return;
-
-  installEventIntercepts();
-  initMousePenetration();
-
-  isRestored = true;
-  updateBadge();
-}
-
-/* ======================== 消息通信 ======================== */
-
-function initMessaging(): void {
-  onMessage(MessageAction.RESTORE_RIGHT_CLICK, async () => {
-    await activateProtection();
-    return { success: true, restored: isRestored };
-  });
-
-  onMessage(MessageAction.QUERY_RIGHT_CLICK_STATUS, () => {
-    return { success: true, restored: isRestored };
-  });
-}
-
-/* ======================== 入口 ======================== */
-
-export default defineContentScript({
-  matches: ['<all_urls>'],
-  runAt: 'document_start',
-  main() {
-    if (document.readyState === 'loading') {
-      document.addEventListener('DOMContentLoaded', createBadge, { once: true });
-    } else {
-      createBadge();
-    }
-    initMessaging();
-  },
-});

eslint.config.ts

@@ -5,16 +5,13 @@ import reactPlugin from 'eslint-plugin-react';
 import globals from 'globals';
 
 export default tseslint.config(
-  // 1. 全局物理隔离：彻底掐灭对构建产物与配置本身的干扰
   {
     ignores: ['dist', '.output', '.wxt', 'node_modules', 'eslint.config.ts', 'eslint.config.js'],
   },
 
-  // 2. 注入 JavaScript 与 TypeScript 的官方大师级推荐规则集
   js.configs.recommended,
   ...tseslint.configs.recommended,
 
-  // 3. 针对测试文件专属沙箱：解耦强类型死锁，放行 any，容忍未消费变量
   {
     files: ['**/__tests__/**', '**/*.test.{ts,tsx}', '**/*.spec.{ts,tsx}', 'setupTests.ts'],
     rules: {
@@ -26,16 +23,8 @@ export default tseslint.config(
     },
   },
 
-  // 4. 核心业务全受控大管线（Hooks, Entrypoints, Components 统一护航）
   {
-    files: [
-      'hooks/**/*.{ts,tsx}',
-      'entrypoints/**/*.{ts,tsx}',
-      'pages/**/*.{ts,tsx}',
-      'utils/**/*.{ts,tsx}',
-      'components/**/*.{ts,tsx}',
-      'services/**/*.{ts,tsx}',
-    ],
+    files: ['src/**/*.{ts,tsx}'],
     ignores: ['**/__tests__/**', '**/*.test.{ts,tsx}', '**/*.spec.{ts,tsx}'],
 
     languageOptions: {
@@ -44,17 +33,13 @@ export default tseslint.config(
         ...globals.browser,
         ...globals.node,
       },
-      // 💡 修复点 1（史诗级治愈）：废除脆弱的 project 硬编码路径！
-      // 拥抱 typescript-eslint 官方推荐的 projectService 常驻动态类型调度中枢。
-      // 它会在内存中全自动、流式为所有新建、悬空或暂存文件分配编译上下文，
-      // 彻底终结 "file is not included in any tsconfig" 的全量崩溃黑洞！
+
       parserOptions: {
         projectService: true,
         tsconfigRootDir: import.meta.dirname,
       },
     },
 
-    // 挂载插件沙箱
     plugins: {
       react: reactPlugin,
       'react-hooks': reactHooks,
@@ -66,24 +51,19 @@ export default tseslint.config(
       },
     },
 
-    // 💡 修复点 2：高精对齐 React 19 / JSX Runtime 的全量生产质检规则大闸
     rules: {
-      // 激活 react-hooks 官方推荐规则
       ...reactHooks.configs.recommended.rules,
-      // 激活 react 官方精选规则（排除旧版 React 必须手动 import 的历史包袱）
       ...reactPlugin.configs.recommended.rules,
       ...reactPlugin.configs['jsx-runtime'].rules,
 
       'react/prop-types': 'off',
 
-      // 清洗原生未消费变量冲突，统一交由 TS 高阶哨兵接管
       'no-unused-vars': 'off',
       '@typescript-eslint/no-unused-vars': [
         'warn',
         { argsIgnorePattern: '^_', varsIgnorePattern: '^_' },
       ],
 
-      // 彻底关闭老旧的 JSX 作用域检查，全面契合 React 19 核心美学
       'react/react-in-jsx-scope': 'off',
     },
   },

i18n/index.ts

@@ -1,144 +0,0 @@
-import i18n from 'i18next';
-import { initReactI18next } from 'react-i18next';
-import type { CustomDetector } from 'i18next-browser-languagedetector'; // 💡 1. 引入官方强类型探测器接口
-import LanguageDetector from 'i18next-browser-languagedetector';
-import { storageUtil } from '@/utils/chromeStorage';
-import dayjs from 'dayjs';
-
-// 导入 Day.js 本地化语言包
-import 'dayjs/locale/zh-cn';
-
-// 同步加载全局核心命名空间
-import commonZh from './locales/zh/common.json';
-import featuresZh from './locales/zh/features.json';
-import commonEn from './locales/en/common.json';
-import featuresEn from './locales/en/features.json';
-
-const resources = {
-  zh: {
-    common: commonZh,
-    features: featuresZh,
-  },
-  en: {
-    common: commonEn,
-    features: featuresEn,
-  },
-};
-
-export const SUPPORTED_LANGUAGES = ['zh', 'en'] as const;
-export type SupportedLanguage = (typeof SUPPORTED_LANGUAGES)[number];
-
-const LANGUAGE_STORAGE_KEY = 'app/language';
-const LANGUAGE_SNAPSHOT_KEY = 'snapshot/app/language';
-
-/**
- * 将任意语言标识归一化为受支持的核心代码
- */
-export const normalizeLanguage = (lng: string): SupportedLanguage => {
-  if (!lng) return 'en';
-  return lng.toLowerCase().startsWith('zh') ? 'zh' : 'en';
-};
-
-/**
- * 严格校验语言安全边界
- */
-const isValidLanguage = (lng: unknown): lng is SupportedLanguage => {
-  return typeof lng === 'string' && (SUPPORTED_LANGUAGES as readonly string[]).includes(lng);
-};
-
-/**
- * 同步从 localStorage 获取语言快照（消除异步闪烁）
- */
-const getSyncLanguageSnapshot = (): SupportedLanguage | null => {
-  try {
-    const val = localStorage.getItem(LANGUAGE_SNAPSHOT_KEY);
-    if (!val) return null;
-    const parsed = JSON.parse(val) as unknown;
-    return isValidLanguage(parsed) ? parsed : null;
-  } catch (error) {
-    console.error('[i18n] Failed to parse sync language snapshot from localStorage:', error);
-    return null;
-  }
-};
-
-// 💡 2. 强类型接口重塑：显式绑定 CustomDetector 类型，
-// 告诉 TS 编译器这些方法将被全局 Languagedetector 框架隐式调用，彻底治愈“未使用函数”报错！
-const chromeStorageDetector: CustomDetector = {
-  name: 'chromeStorage',
-  lookup() {
-    return undefined;
-  },
-  cacheUserLanguage(lng: string) {
-    const target = normalizeLanguage(lng);
-    // 💡 修复点：对异步写盘操作追加 void 算子或 catch，吞掉 Promise 被忽略警告
-    storageUtil.set(LANGUAGE_STORAGE_KEY, target).catch((err) => {
-      console.error('[i18n Detector Error] Failed to write back language state:', err);
-    });
-  },
-};
-
-const detector = new LanguageDetector();
-detector.addDetector(chromeStorageDetector);
-
-const syncLng = getSyncLanguageSnapshot();
-
-// 💡 3. 修复点：对 i18n.init() 返回的异步 Promise 前方追加 void 斩断依赖链，放行编译
-void i18n
-  .use(detector)
-  .use(initReactI18next)
-  .init({
-    resources,
-    fallbackLng: 'en',
-    lng: syncLng || undefined,
-    ns: ['common', 'features'],
-    defaultNS: 'common',
-    debug: false,
-    interpolation: {
-      escapeValue: false,
-    },
-    detection: {
-      order: ['chromeStorage', 'navigator'],
-      caches: ['chromeStorage'],
-    },
-  });
-
-// 监听语言变更
-i18n.on('languageChanged', (lng) => {
-  const normalizedLng = normalizeLanguage(lng);
-  dayjs.locale(normalizedLng === 'zh' ? 'zh-cn' : 'en');
-  localStorage.setItem(LANGUAGE_SNAPSHOT_KEY, JSON.stringify(normalizedLng));
-});
-
-// 初始化时从长期异步存储中恢复校准
-storageUtil
-  .get(LANGUAGE_STORAGE_KEY)
-  .then((lng) => {
-    const rawTargetLng = lng || syncLng;
-
-    if (!rawTargetLng) {
-      const initialLng = normalizeLanguage(i18n.language);
-
-      // 💡 修复点：对初始化同步写盘追加安全的 Promise .catch() 异常隔离防护罩
-      storageUtil.set(LANGUAGE_STORAGE_KEY, initialLng).catch((err) => {
-        console.error('[i18n Init Error] Persistent sync collapsed:', err);
-      });
-
-      if (initialLng !== normalizeLanguage(i18n.language)) {
-        // 💡 修复点：对 changeLanguage 异步微任务进行显式 void 断链安全隔离
-        void i18n.changeLanguage(initialLng);
-      }
-      return;
-    }
-
-    const targetLng = normalizeLanguage(String(rawTargetLng));
-
-    if (isValidLanguage(targetLng) && targetLng !== normalizeLanguage(i18n.language)) {
-      // 💡 修复点：对 changeLanguage 异步微任务进行显式 void 断链安全隔离
-      void i18n.changeLanguage(targetLng);
-    }
-  })
-  .catch((err) => {
-    console.error('[i18n Context Error] Async local storage lookup collapsed:', err);
-  });
-
-export default i18n;

i18n/locales/en/base64Converter.json

@@ -1,37 +0,0 @@
-{
-  "pageTitle": "Base64 Converter",
-  "pageSubtitle": "Encode and decode text, files, and images with Base64",
-  "textMode": "Text",
-  "fileMode": "File",
-  "imageMode": "Image",
-  "encode": "Encode",
-  "decode": "Decode",
-  "clear": "Clear",
-  "textInputPlaceholder": "Enter text to encode to Base64...",
-  "base64InputPlaceholder": "Enter Base64 string to decode...",
-  "base64Output": "Base64 Output",
-  "textOutput": "Decoded Text Output",
-  "copyRaw": "Copy Raw Base64",
-  "copyDataUri": "Copy Data URI",
-  "clickOrDropToFile": "Click or drop a file here",
-  "clickOrDropToImage": "Click or drop an image here",
-  "clickOrDropToReplace": "Click or drop to replace the file",
-  "maxFileSize": "Maximum file size: {{max}}",
-  "supportedFormats": "Supports PNG, JPG, WEBP, GIF, BMP, SVG, etc.",
-  "fileSizeExceeded": "File size exceeds the limit (max {{max}})",
-  "unsupportedImageType": "Unsupported image format",
-  "conversionFailed": "Conversion failed",
-  "originalSize": "Original Size",
-  "encodedSize": "Encoded Size",
-  "invalidBase64": "Invalid Base64 string",
-  "binaryDataDetected": "Input appears to be binary data (e.g. an image). Please switch to the Image tab.",
-  "imageDataUriHint": "Detected an image data URI — please use the Image tab to decode it.",
-  "switchToImageMode": "Switch to Image mode",
-  "download": "Download",
-  "decodedFileName": "Decoded file name",
-  "decodeBase64Placeholder": "Enter Base64 or data URI to decode...",
-  "decodedFileOutput": "Decoded File",
-  "decodedImageOutput": "Decoded Image",
-  "inferredMimeType": "Inferred MIME type",
-  "decodedSize": "Decoded size"
-}

i18n/locales/en/common.json

@@ -1,35 +0,0 @@
-{
-  "appName": "Testing Tools",
-  "buttons": {
-    "save": "Save",
-    "cancel": "Cancel",
-    "confirm": "Confirm",
-    "copy": "Copy",
-    "clear": "Clear",
-    "refresh": "Refresh",
-    "toggleLanguage": "Switch Language",
-    "toggleTheme": "Toggle theme",
-    "themeMode": {
-      "light": "Switch to dark mode",
-      "dark": "Switch to system mode",
-      "system": "Switch to light mode"
-    },
-    "search": "Search tools...",
-    "back": "Back",
-    "clearSearch": "Clear search",
-    "recentSearch": "Recent search",
-    "noResults": "No tools found",
-    "openInTab": "Open in tab",
-    "settings": "Settings"
-  },
-  "messages": {
-    "copySuccess": "Copied to clipboard",
-    "copyError": "Copy failed"
-  },
-  "textInputArea": {
-    "clear": "Clear",
-    "copyContent": "Copy content",
-    "cleared": "Cleared",
-    "placeholder": "placeholder text"
-  }
-}

i18n/locales/en/features.json

@@ -1,45 +0,0 @@
-{
-  "dashboard": {
-    "title": "Dashboard"
-  },
-  "timestamp": {
-    "title": "Timestamp",
-    "description": "Unix millisecond conversion and formatting"
-  },
-  "storageCleaner": {
-    "title": "Storage Cleaner",
-    "description": "Clean cache, cookies, and local storage"
-  },
-  "qrCode": {
-    "title": "QR Code Tools",
-    "description": "Generate QR code for the selected URL"
-  },
-  "textStatistics": {
-    "title": "Text Statistics",
-    "description": "Real-time analysis of text characters, words, and bytes"
-  },
-  "jwt": {
-    "title": "JWT Parser",
-    "description": "JSON Web Token decoding and viewing"
-  },
-  "jsonDiff": {
-    "title": "JSON Tools",
-    "description": "Diff, format, YAML/TOML conversion, and minify"
-  },
-  "base64Converter": {
-    "title": "Base64 Converter",
-    "description": "Encode text, files, and images to Base64"
-  },
-  "markdownToHtml": {
-    "title": "Markdown to HTML",
-    "description": "Real-time Markdown conversion and HTML preview"
-  },
-  "htmlToMarkdown": {
-    "title": "HTML to Markdown",
-    "description": "Real-time HTML conversion and Markdown preview"
-  },
-  "rightClickRestorer": {
-    "title": "Right Click Restorer",
-    "description": "Detect and restore disabled browser right-click menus"
-  }
-}

i18n/locales/en/htmlToMarkdown.json

@@ -1,16 +0,0 @@
-{
-  "pageTitle": "HTML to Markdown",
-  "pageSubtitle": "Convert HTML to Markdown in real-time",
-  "splitMode": "Split",
-  "previewMode": "Preview",
-  "markdownMode": "Markdown",
-  "clear": "Clear",
-  "inputLabel": "HTML Input",
-  "previewLabel": "Markdown Preview",
-  "markdownOutputLabel": "Markdown Output",
-  "inputPlaceholder": "Enter your HTML content here...",
-  "charCount": "{{count}} chars",
-  "copyMarkdown": "Copy Markdown",
-  "download": "Download",
-  "emptyHint": "Enter HTML content to see the conversion result"
-}

i18n/locales/en/jsonDiff.json

@@ -1,21 +0,0 @@
-{
-  "pageTitle": "JSON Diff",
-  "pageSubtitle": "Compare differences between two JSON values",
-  "leftPlaceholder": "Enter the original JSON...",
-  "rightPlaceholder": "Enter the target JSON...",
-  "leftLabel": "Original JSON",
-  "rightLabel": "Target JSON",
-  "compareButton": "Compare",
-  "clearButton": "Clear",
-  "sideBySideMode": "Side by side",
-  "unifiedMode": "Unified",
-  "previousDiff": "Previous",
-  "nextDiff": "Next",
-  "noDiffs": "No differences",
-  "diffCount": "{{count}} differences",
-  "invalidJson": "Invalid JSON format",
-  "emptyHint": "Enter JSON on both sides and click Compare",
-  "added": "Added",
-  "removed": "Removed",
-  "modified": "Modified"
-}

i18n/locales/en/jsonFormat.json

@@ -1,41 +0,0 @@
-{
-  "formatTitle": "JSON Formatter",
-  "formatSubtitle": "Beautify and format JSON data",
-  "inputPlaceholder": "Enter JSON to format...",
-  "formatButton": "Format",
-  "clearButton": "Clear",
-  "sortKeys": "Sort Keys",
-  "sortKeysTooltip": "Sort JSON object keys in alphabetical order",
-  "indentSize": "Indent",
-  "indentSpaces": "{{count}} spaces",
-  "outputLabel": "Formatted Result",
-  "copySuccess": "Copied",
-  "copyFail": "Copy failed",
-  "noContent": "Nothing to copy",
-  "invalidJson": "Invalid JSON format",
-  "emptyHint": "Enter JSON and click Format",
-  "originalSize": "Original size",
-  "formattedSize": "Formatted size",
-  "diffMode": "Diff",
-  "formatMode": "Format",
-  "yamlMode": "YAML",
-  "tomlMode": "TOML",
-  "minifyMode": "Minify",
-  "yamlTitle": "JSON to YAML",
-  "yamlSubtitle": "Convert JSON data to YAML format",
-  "yamlModeInputPlaceholder": "Enter JSON to convert...",
-  "yamlModeOutputLabel": "YAML Result",
-  "yamlModeEmptyHint": "Enter JSON and click Convert",
-  "convertButton": "Convert",
-  "tomlTitle": "JSON to TOML",
-  "tomlSubtitle": "Convert JSON data to TOML format",
-  "tomlModeInputPlaceholder": "Enter JSON to convert...",
-  "tomlModeOutputLabel": "TOML Result",
-  "tomlModeEmptyHint": "Enter JSON and click Convert",
-  "minifyTitle": "JSON Minifier",
-  "minifySubtitle": "Compress JSON into a compact single-line format",
-  "minifyModeInputPlaceholder": "Enter JSON to minify...",
-  "minifyModeOutputLabel": "Minified Result",
-  "minifyModeEmptyHint": "Enter JSON and click Minify",
-  "minifyButton": "Minify"
-}

i18n/locales/en/jwt.json

@@ -1,17 +0,0 @@
-{
-  "pageTitle": "JWT Parser",
-  "pageSubtitle": "JSON Web Token decoding and viewing",
-  "placeholder": "Paste Encoded JWT here...",
-  "headerTitle": "HEADER: Algorithm & Token Type",
-  "payloadTitle": "PAYLOAD: Data",
-  "signatureTitle": "Signature",
-  "noSignature": "No Signature",
-  "invalidFormat": "Unable to parse",
-  "errors": {
-    "invalidBase64String": "Invalid base64url string",
-    "failedToDecode": "Failed to decode base64url: ",
-    "invalidFormat": "Invalid JWT format: expected 3 parts separated by .",
-    "parseHeaderFailed": "Failed to parse Header: ",
-    "parsePayloadFailed": "Failed to parse Payload: "
-  }
-}

i18n/locales/en/markdownToHtml.json

@@ -1,18 +0,0 @@
-{
-  "pageTitle": "Markdown to HTML",
-  "pageSubtitle": "Convert Markdown to HTML in real-time with preview",
-  "splitMode": "Split",
-  "previewMode": "Preview",
-  "htmlMode": "HTML",
-  "clear": "Clear",
-  "print": "Print",
-  "download": "Download",
-  "inputLabel": "Markdown Input",
-  "previewLabel": "Live Preview",
-  "htmlOutputLabel": "HTML Output",
-  "inputPlaceholder": "Enter your Markdown content here...",
-  "charCount": "{{count}} chars",
-  "copyHtml": "Copy HTML",
-  "downloadSuccess": "File downloaded successfully",
-  "printSuccess": "Print window opened"
-}

i18n/locales/en/qrCode.json

@@ -1,48 +0,0 @@
-{
-  "pageTitle": "QR Code Tools",
-  "pageSubtitle": "Generate and parse QR codes",
-
-  "generateMode": "Generate QR Code",
-  "parseMode": "Parse QR Code",
-
-  "urlToQr": "Text to QR Code",
-  "qrToUrl": "QR Code to Text",
-
-  "urlInputLabel": "Enter URL or Text",
-  "urlInputPlaceholder": "Enter URL or text content, QR code will be generated automatically",
-  "generateButton": "Generate QR Code",
-  "generating": "Generating...",
-
-  "qrCodeWillShow": "QR code will be shown here",
-  "downloadButton": "Download QR Code",
-  "copyQrButton": "Copy QR Code Image",
-
-  "qrCodeSuccess": "QR code generated successfully",
-  "qrCodeDownloadSuccess": "QR code downloaded successfully",
-  "qrCodeCopySuccess": "QR code copied to clipboard",
-
-  "selectImage": "Please select a QR code image",
-  "parseSuccess": "QR code parsed successfully",
-  "noQrDetected": "No QR code detected, please ensure the image is clear and contains a QR code",
-  "parseError": "Failed to parse QR code, please try again",
-  "generateError": "Failed to generate QR code, please check the input",
-  "copyError": "Copy failed, please try again",
-
-  "imagePasted": "Image pasted, parsing...",
-  "imagePasteError": "Failed to paste image, please try again",
-  "imageCleared": "Image cleared",
-  "clickToUpload": "Click, drag, or paste to upload QR code image",
-  "supportFormats": "Supports PNG, JPG, WEBP, Base64 formats",
-
-  "parseButton": "Parse QR Code",
-  "parsing": "Parsing...",
-  "resultLabel": "Parsing Result",
-  "copyTooltip": "Copy",
-
-  "enterUrlError": "Please enter URL or text",
-  "clickToChange": "Click to change image",
-
-  "pasteHint": "Supports Ctrl+V to paste images or Base64 strings",
-  "autoGenerateHint": "QR code will be generated automatically after input",
-  "autoParseHint": "QR code will be parsed automatically after upload"
-}

i18n/locales/en/rightClickRestorer.json

@@ -1,13 +0,0 @@
-{
-  "title": "Right Click Restorer",
-  "description": "Detect and restore disabled browser right-click menus",
-  "loading": "Loading...",
-  "currentDomain": "Current Domain",
-  "statusLocked": "Locked",
-  "statusUnlocked": "Unlocked",
-  "unsupported": "Unsupported",
-  "unsupportedDesc": "The current page is a browser internal or extension page. Right-click unlock is not available. Please switch to a regular webpage.",
-  "unlockDesc": "Click the button below to temporarily unlock the right-click menu for the current website. You will need to unlock again after refreshing the page.",
-  "unlockBtn": "Unlock Right Click",
-  "alreadyUnlocked": "Right Click Unlocked"
-}

i18n/locales/en/storageCleaner.json

@@ -1,33 +0,0 @@
-{
-  "pageTitle": "Storage Cleaner",
-  "pageSubtitle": "Clear cache, cookies, and local storage",
-  "loading": "Loading...",
-  "occupied": "Occupied {{size}}",
-  "cleaning": "Cleaning...",
-  "cleanNow": "Clean Now",
-  "autoRefresh": "Auto refresh page after cleaning",
-  "selectAll": "Select all items",
-  "cleanSuccess": "Cleaning complete",
-  "cleanError": "Cleaning failed",
-  "noData": "No data",
-  "countUnit": "items",
-  "errorNoTab": "Unable to get current tab",
-  "errorRestricted": "Storage cleaning is not supported on this page",
-  "cleanSuccessReload": "Cleaning successful, reloading page...",
-  "errorStandardOnly": "Storage cleaning only works on standard web pages",
-  "confirmTitle": "Confirm Clear Data?",
-  "confirmDesc": "You are about to permanently delete the following selected storage items from the current page.",
-  "irreversible": "This action is irreversible",
-  "confirmAction": "Confirm Clear",
-  "cleanedSummary": "Cleaned {{items}}",
-  "noDataToClean": "No storage data found to clean",
-  "partialFailure": "Some items failed to clean",
-  "options": {
-    "localStorage": "Local Storage",
-    "sessionStorage": "Session Storage",
-    "indexedDB": "IndexedDB",
-    "cookies": "Cookies",
-    "cacheStorage": "Cache Storage",
-    "serviceWorkers": "Service Workers"
-  }
-}

i18n/locales/en/textStatistics.json

@@ -1,9 +0,0 @@
-{
-  "pageTitle": "Text Statistics",
-  "pageSubtitle": "Real-time analysis of characters, words, lines, and byte size",
-  "placeholder": "Type or paste text here...",
-  "characters": "Characters",
-  "words": "Words",
-  "lines": "Lines",
-  "bytes": "Byte Size"
-}

i18n/locales/en/timestamp.json

@@ -1,27 +0,0 @@
-{
-  "pageTitle": "Timestamp Conversion",
-  "pageSubtitle": "Unix millisecond conversion and formatting",
-  "tsToDate": "Timestamp → Date",
-  "dateToTs": "Date → Timestamp",
-  "placeholderTs": "Enter timestamp...",
-  "placeholderDate": "YYYY-MM-DD HH:mm:ss",
-  "unitMs": "Millisecond (ms)",
-  "unitS": "Second (s)",
-  "convertButton": "Convert Now",
-  "currentTs": "Current Timestamp",
-  "useNowTooltip": "Use this value",
-  "copyTsTooltip": "Copy timestamp",
-  "usedSuccess": "Using current timestamp",
-  "resultLabel": "Conversion Result",
-  "copyResultTooltip": "Copy result",
-  "relativeTime": "Relative Time",
-  "iso8601": "ISO 8601",
-  "utcTime": "UTC Time",
-  "copyTooltip": "Copy",
-  "resultEmpty": "Enter a value and click convert",
-  "errors": {
-    "invalidNumber": "Invalid number",
-    "invalidTimestamp": "Invalid timestamp",
-    "invalidFormat": "Format error"
-  }
-}

i18n/locales/zh/base64Converter.json

@@ -1,37 +0,0 @@
-{
-  "pageTitle": "Base64 转换器",
-  "pageSubtitle": "文本、文件与图像的 Base64 编码与解码",
-  "textMode": "文本",
-  "fileMode": "文件",
-  "imageMode": "图像",
-  "encode": "编码",
-  "decode": "解码",
-  "clear": "清空",
-  "textInputPlaceholder": "输入需要编码为 Base64 的文本...",
-  "base64InputPlaceholder": "输入需要解码的 Base64 字符串...",
-  "base64Output": "Base64 编码结果",
-  "textOutput": "解码文本结果",
-  "copyRaw": "复制纯 Base64",
-  "copyDataUri": "复制 Data URI",
-  "clickOrDropToFile": "点击或拖拽文件到此处",
-  "clickOrDropToImage": "点击或拖拽图像到此处",
-  "clickOrDropToReplace": "点击或拖拽以替换文件",
-  "maxFileSize": "最大文件大小：{{max}}",
-  "supportedFormats": "支持 PNG、JPG、WEBP、GIF、BMP、SVG 等格式",
-  "fileSizeExceeded": "文件大小超出限制（最大 {{max}}）",
-  "unsupportedImageType": "不支持的图像格式",
-  "conversionFailed": "转换失败",
-  "originalSize": "原始大小",
-  "encodedSize": "编码大小",
-  "invalidBase64": "Base64 字符串无效",
-  "binaryDataDetected": "输入似乎是二进制数据（如图片）。请切换到「图像」选项卡。",
-  "imageDataUriHint": "检测到图片的 data URI，请使用「图像」选项卡进行解码。",
-  "switchToImageMode": "切换到图像模式",
-  "download": "下载",
-  "decodedFileName": "解码后文件名",
-  "decodeBase64Placeholder": "输入需要解码的 Base64 或 data URI...",
-  "decodedFileOutput": "解码文件",
-  "decodedImageOutput": "解码图像",
-  "inferredMimeType": "推断的 MIME 类型",
-  "decodedSize": "解码大小"
-}

i18n/locales/zh/common.json

@@ -1,35 +0,0 @@
-{
-  "appName": "测试工具",
-  "buttons": {
-    "save": "保存",
-    "cancel": "取消",
-    "confirm": "确认",
-    "copy": "复制",
-    "clear": "清理",
-    "refresh": "刷新",
-    "toggleLanguage": "切换语言",
-    "toggleTheme": "切换主题",
-    "themeMode": {
-      "light": "切换到深色模式",
-      "dark": "切换到系统模式",
-      "system": "切换到浅色模式"
-    },
-    "search": "搜索工具...",
-    "back": "返回",
-    "clearSearch": "清除搜索",
-    "recentSearch": "最近搜索",
-    "noResults": "未找到相关工具",
-    "openInTab": "在标签页打开",
-    "settings": "设置"
-  },
-  "messages": {
-    "copySuccess": "已复制到剪贴板",
-    "copyError": "复制失败"
-  },
-  "textInputArea": {
-    "clear": "清空",
-    "copyContent": "复制内容",
-    "cleared": "已清空",
-    "placeholder": "请输入文本"
-  }
-}

i18n/locales/zh/features.json

@@ -1,45 +0,0 @@
-{
-  "dashboard": {
-    "title": "仪表盘"
-  },
-  "timestamp": {
-    "title": "时间戳",
-    "description": "Unix 毫秒数转换与格式化"
-  },
-  "storageCleaner": {
-    "title": "存储清理",
-    "description": "清理缓存、Cookies 及本地存储"
-  },
-  "qrCode": {
-    "title": "二维码工具",
-    "description": "生成当前选中的 URL 的二维码"
-  },
-  "textStatistics": {
-    "title": "文本统计",
-    "description": "实时分析文本字符、单词及字节"
-  },
-  "jwt": {
-    "title": "JWT 解析",
-    "description": "JSON Web Token 解码与查看"
-  },
-  "jsonDiff": {
-    "title": "JSON 工具",
-    "description": "差异比较、格式化、YAML/TOML 转换及压缩"
-  },
-  "base64Converter": {
-    "title": "Base64 转换器",
-    "description": "文本、文件与图像的 Base64 编码转换"
-  },
-  "markdownToHtml": {
-    "title": "Markdown 转 HTML",
-    "description": "实时 Markdown 转换与 HTML 预览"
-  },
-  "htmlToMarkdown": {
-    "title": "HTML 转 Markdown",
-    "description": "实时 HTML 转换与 Markdown 预览"
-  },
-  "rightClickRestorer": {
-    "title": "右键恢复",
-    "description": "检测并恢复被网站禁用的浏览器右键菜单"
-  }
-}

i18n/locales/zh/htmlToMarkdown.json

@@ -1,16 +0,0 @@
-{
-  "pageTitle": "HTML 转 Markdown",
-  "pageSubtitle": "实时将 HTML 转换为 Markdown 格式",
-  "splitMode": "分屏",
-  "previewMode": "预览",
-  "markdownMode": "Markdown",
-  "clear": "清空",
-  "inputLabel": "HTML 输入",
-  "previewLabel": "Markdown 预览",
-  "markdownOutputLabel": "Markdown 输出",
-  "inputPlaceholder": "在此输入 HTML 内容...",
-  "charCount": "{{count}} 字符",
-  "copyMarkdown": "复制 Markdown",
-  "download": "下载",
-  "emptyHint": "输入 HTML 内容以查看转换结果"
-}

i18n/locales/zh/jsonDiff.json

@@ -1,21 +0,0 @@
-{
-  "pageTitle": "JSON 差异比较",
-  "pageSubtitle": "对比两个 JSON 数据的差异",
-  "leftPlaceholder": "输入原始 JSON...",
-  "rightPlaceholder": "输入目标 JSON...",
-  "leftLabel": "原始 JSON",
-  "rightLabel": "目标 JSON",
-  "compareButton": "比较",
-  "clearButton": "清空",
-  "sideBySideMode": "并排",
-  "unifiedMode": "统一",
-  "previousDiff": "上一个",
-  "nextDiff": "下一个",
-  "noDiffs": "无差异",
-  "diffCount": "{{count}} 处差异",
-  "invalidJson": "无效的 JSON 格式",
-  "emptyHint": "输入两侧 JSON 后点击比较",
-  "added": "新增",
-  "removed": "删除",
-  "modified": "修改"
-}

i18n/locales/zh/jsonFormat.json

@@ -1,41 +0,0 @@
-{
-  "formatTitle": "JSON 格式化",
-  "formatSubtitle": "美化和格式化 JSON 数据",
-  "inputPlaceholder": "输入需要格式化的 JSON...",
-  "formatButton": "格式化",
-  "clearButton": "清空",
-  "sortKeys": "键名排序",
-  "sortKeysTooltip": "按字母顺序对 JSON 对象键进行排序",
-  "indentSize": "缩进",
-  "indentSpaces": "{{count}} 个空格",
-  "outputLabel": "格式化结果",
-  "copySuccess": "复制成功",
-  "copyFail": "复制失败",
-  "noContent": "无内容可复制",
-  "invalidJson": "无效的 JSON 格式",
-  "emptyHint": "输入 JSON 后点击格式化",
-  "originalSize": "原始大小",
-  "formattedSize": "格式化后大小",
-  "diffMode": "差异比较",
-  "formatMode": "格式化",
-  "yamlMode": "YAML",
-  "tomlMode": "TOML",
-  "minifyMode": "压缩",
-  "yamlTitle": "JSON 转 YAML",
-  "yamlSubtitle": "将 JSON 数据转换为 YAML 格式",
-  "yamlModeInputPlaceholder": "输入需要转换的 JSON...",
-  "yamlModeOutputLabel": "YAML 结果",
-  "yamlModeEmptyHint": "输入 JSON 后点击转换",
-  "convertButton": "转换",
-  "tomlTitle": "JSON 转 TOML",
-  "tomlSubtitle": "将 JSON 数据转换为 TOML 格式",
-  "tomlModeInputPlaceholder": "输入需要转换的 JSON...",
-  "tomlModeOutputLabel": "TOML 结果",
-  "tomlModeEmptyHint": "输入 JSON 后点击转换",
-  "minifyTitle": "JSON 压缩",
-  "minifySubtitle": "将 JSON 压缩为紧凑的单行格式",
-  "minifyModeInputPlaceholder": "输入需要压缩的 JSON...",
-  "minifyModeOutputLabel": "压缩结果",
-  "minifyModeEmptyHint": "输入 JSON 后点击压缩",
-  "minifyButton": "压缩"
-}

i18n/locales/zh/jwt.json

@@ -1,17 +0,0 @@
-{
-  "pageTitle": "JWT 解析",
-  "pageSubtitle": "JSON Web Token 解码与查看",
-  "placeholder": "在此粘贴 JWT 令牌 (Encoded JWT)...",
-  "headerTitle": "HEADER: 算法 & 令牌类型",
-  "payloadTitle": "PAYLOAD: 数据",
-  "signatureTitle": "签名",
-  "noSignature": "无签名",
-  "invalidFormat": "无法解析",
-  "errors": {
-    "invalidBase64String": "无效的 Base64URL 字符串",
-    "failedToDecode": "Base64URL 解码失败：",
-    "invalidFormat": "JWT 格式错误：必须包含三个由 . 分隔的部分",
-    "parseHeaderFailed": "解析 Header 失败：",
-    "parsePayloadFailed": "解析 Payload 失败："
-  }
-}

i18n/locales/zh/markdownToHtml.json

@@ -1,18 +0,0 @@
-{
-  "pageTitle": "Markdown 转 HTML",
-  "pageSubtitle": "实时将 Markdown 转换为 HTML 并预览",
-  "splitMode": "分屏",
-  "previewMode": "预览",
-  "htmlMode": "HTML",
-  "clear": "清空",
-  "print": "打印",
-  "download": "下载",
-  "inputLabel": "Markdown 输入",
-  "previewLabel": "实时预览",
-  "htmlOutputLabel": "HTML 输出",
-  "inputPlaceholder": "在此输入 Markdown 内容...",
-  "charCount": "{{count}} 字符",
-  "copyHtml": "复制 HTML",
-  "downloadSuccess": "文件下载成功",
-  "printSuccess": "打印窗口已打开"
-}

i18n/locales/zh/qrCode.json

@@ -1,48 +0,0 @@
-{
-  "pageTitle": "二维码工具",
-  "pageSubtitle": "生成和解析二维码",
-
-  "generateMode": "生成二维码",
-  "parseMode": "解析二维码",
-
-  "urlToQr": "文本转二维码",
-  "qrToUrl": "二维码转文本",
-
-  "urlInputLabel": "输入 URL 或文本",
-  "urlInputPlaceholder": "请输入 URL 或文本内容，将自动生成二维码",
-  "generateButton": "生成二维码",
-  "generating": "生成中...",
-
-  "qrCodeWillShow": "二维码将显示在这里",
-  "downloadButton": "下载二维码",
-  "copyQrButton": "复制二维码",
-
-  "qrCodeSuccess": "二维码生成成功",
-  "qrCodeDownloadSuccess": "二维码下载成功",
-  "qrCodeCopySuccess": "二维码已复制到剪贴板",
-
-  "selectImage": "请选择二维码图片",
-  "parseSuccess": "二维码解析成功",
-  "noQrDetected": "未检测到二维码，请确保图片清晰且包含二维码",
-  "parseError": "解析二维码失败，请重试",
-  "generateError": "生成二维码失败，请检查输入内容",
-  "copyError": "复制失败，请重试",
-
-  "imagePasted": "图片粘贴成功，正在解析...",
-  "imagePasteError": "粘贴图片失败，请重试",
-  "imageCleared": "图片已清除",
-  "clickToUpload": "点击、拖拽或粘贴上传二维码图片",
-  "supportFormats": "支持 PNG、JPG、WEBP、Base64 格式",
-
-  "parseButton": "解析二维码",
-  "parsing": "解析中...",
-  "resultLabel": "解析结果",
-  "copyTooltip": "复制",
-
-  "enterUrlError": "请输入 URL 或文本",
-  "clickToChange": "点击更换图片",
-
-  "pasteHint": "支持 Ctrl+V 粘贴图片或 Base64 字符串",
-  "autoGenerateHint": "输入内容后将自动生成二维码",
-  "autoParseHint": "上传图片后将自动解析二维码"
-}

i18n/locales/zh/rightClickRestorer.json

@@ -1,13 +0,0 @@
-{
-  "title": "右键恢复",
-  "description": "检测并恢复被网站禁用的浏览器右键菜单",
-  "loading": "正在加载...",
-  "currentDomain": "当前域名",
-  "statusLocked": "未解锁",
-  "statusUnlocked": "已解锁",
-  "unsupported": "不支持",
-  "unsupportedDesc": "当前页面为浏览器内部页面或扩展页面，无法解锁右键功能。请切换到普通网页后重试。",
-  "unlockDesc": "点击下方按钮，为当前网站临时解锁右键菜单。刷新页面后需要重新解锁。",
-  "unlockBtn": "解锁当前网站右键",
-  "alreadyUnlocked": "右键已解锁"
-}

i18n/locales/zh/storageCleaner.json

@@ -1,33 +0,0 @@
-{
-  "pageTitle": "存储清理",
-  "pageSubtitle": "清理缓存、Cookies 及本地存储",
-  "loading": "加载中...",
-  "occupied": "已占用 {{size}}",
-  "cleaning": "正在清理...",
-  "cleanNow": "立即清理",
-  "autoRefresh": "清理后自动刷新页面",
-  "selectAll": "全选所有项",
-  "cleanSuccess": "清理完成",
-  "cleanError": "清理失败",
-  "noData": "无数据",
-  "countUnit": "个",
-  "errorNoTab": "无法获取当前标签页",
-  "errorRestricted": "存储清理功能不支持此页面",
-  "cleanSuccessReload": "清理成功，即将刷新页面",
-  "errorStandardOnly": "存储清理功能仅适用于标准网页",
-  "confirmTitle": "确认清理数据？",
-  "confirmDesc": "您将永久删除当前页面的以下选定存储项。",
-  "irreversible": "此操作不可撤销",
-  "confirmAction": "确认清理",
-  "cleanedSummary": "清理了 {{items}}",
-  "noDataToClean": "该页面没有可清理的存储数据",
-  "partialFailure": "部分清理失败",
-  "options": {
-    "localStorage": "Local Storage",
-    "sessionStorage": "Session Storage",
-    "indexedDB": "IndexedDB",
-    "cookies": "Cookies",
-    "cacheStorage": "Cache Storage",
-    "serviceWorkers": "Service Workers"
-  }
-}

i18n/locales/zh/textStatistics.json

@@ -1,9 +0,0 @@
-{
-  "pageTitle": "文本统计",
-  "pageSubtitle": "实时分析文本的字符、单词、行数及字节大小",
-  "placeholder": "在此输入或粘贴文本...",
-  "characters": "字符数",
-  "words": "单词数",
-  "lines": "行数",
-  "bytes": "字节大小"
-}

i18n/locales/zh/timestamp.json

@@ -1,27 +0,0 @@
-{
-  "pageTitle": "时间戳转换",
-  "pageSubtitle": "Unix 毫秒数转换与格式化",
-  "tsToDate": "时间戳 → 日期",
-  "dateToTs": "日期 → 时间戳",
-  "placeholderTs": "输入时间戳...",
-  "placeholderDate": "YYYY-MM-DD HH:mm:ss",
-  "unitMs": "毫秒 (ms)",
-  "unitS": "秒 (s)",
-  "convertButton": "立即转换",
-  "currentTs": "当前时间戳",
-  "useNowTooltip": "填充到下方",
-  "copyTsTooltip": "复制时间戳",
-  "usedSuccess": "已使用当前时间戳",
-  "resultLabel": "转换结果",
-  "copyResultTooltip": "复制结果",
-  "relativeTime": "相对时间",
-  "iso8601": "ISO 8601",
-  "utcTime": "UTC 时间",
-  "copyTooltip": "复制",
-  "resultEmpty": "请输入并点击转换",
-  "errors": {
-    "invalidNumber": "无效数字",
-    "invalidTimestamp": "无效时间戳",
-    "invalidFormat": "格式错误"
-  }
-}

lint-staged.config.mjs

@@ -1,4 +1,12 @@
+/* global process */
+
+const isCI = process.env.CI === 'true';
+
 export default {
-  '*.{ts,tsx,js,jsx,mjs}': ['eslint --fix --max-warnings=0 --no-warn-ignored', 'prettier --write'],
+  '*.{ts,tsx,js,jsx,mjs}': [
+    'eslint --fix --no-warn-ignored',
+    ...(isCI ? ['eslint --max-warnings=0'] : []),
+    'prettier --write',
+  ],
   '*.{json,css,scss,md}': ['prettier --write'],
 };

package-lock.json

@@ -25,15 +25,11 @@
         "class-variance-authority": "^0.7.1",
         "clsx": "^2.1.1",
         "dayjs": "^1.11.20",
-        "i18next": "^26.2.0",
-        "i18next-browser-languagedetector": "^8.2.1",
         "lucide-react": "^1.16.0",
-        "marked": "^18.0.4",
         "qr-scanner": "^1.4.2",
         "qrious": "^4.0.2",
         "react": "^19.2.6",
         "react-dom": "^19.2.6",
-        "react-i18next": "^17.0.8",
         "sonner": "^2.0.7",
         "tailwind-merge": "^3.6.0"
       },
@@ -6643,15 +6639,6 @@
       "integrity": "sha512-H2iMtd0I4Mt5eYiapRdIDjp+XzelXQ0tFE4JS7YFwFevXXMmOp9myNrUvCg0D6ws8iqkRPBfKHgbwig1SmlLfg==",
       "license": "MIT"
     },
-    "node_modules/html-parse-stringify": {
-      "version": "3.0.1",
-      "resolved": "https://registry.npmjs.org/html-parse-stringify/-/html-parse-stringify-3.0.1.tgz",
-      "integrity": "sha512-KknJ50kTInJ7qIScF3jeaFRpMpE8/lfiTdzf/twXyPBLAGrLRTmkz3AdTnKeh40X8k9L2fdYwEp/42WGXIRGcg==",
-      "license": "MIT",
-      "dependencies": {
-        "void-elements": "3.1.0"
-      }
-    },
     "node_modules/htmlparser2": {
       "version": "10.1.0",
       "resolved": "https://registry.npmjs.org/htmlparser2/-/htmlparser2-10.1.0.tgz",
@@ -6701,43 +6688,6 @@
         "url": "https://github.com/sponsors/typicode"
       }
     },
-    "node_modules/i18next": {
-      "version": "26.2.0",
-      "resolved": "https://registry.npmjs.org/i18next/-/i18next-26.2.0.tgz",
-      "integrity": "sha512-zwBHldHdTmwN7r6UNc7lC6GWNN+YYg3DrRSeHR5PRRBf5QnJZcYHrQc0uaU26qZeYxR7iFZD+Y315dPnKP47wA==",
-      "funding": [
-        {
-          "type": "individual",
-          "url": "https://www.locize.com/i18next"
-        },
-        {
-          "type": "individual",
-          "url": "https://www.i18next.com/how-to/faq#i18next-is-awesome.-how-can-i-support-the-project"
-        },
-        {
-          "type": "individual",
-          "url": "https://www.locize.com"
-        }
-      ],
-      "license": "MIT",
-      "peerDependencies": {
-        "typescript": "^5 || ^6"
-      },
-      "peerDependenciesMeta": {
-        "typescript": {
-          "optional": true
-        }
-      }
-    },
-    "node_modules/i18next-browser-languagedetector": {
-      "version": "8.2.1",
-      "resolved": "https://registry.npmjs.org/i18next-browser-languagedetector/-/i18next-browser-languagedetector-8.2.1.tgz",
-      "integrity": "sha512-bZg8+4bdmaOiApD7N7BPT9W8MLZG+nPTOFlLiJiT8uzKXFjhxw4v2ierCXOwB5sFDMtuA5G4kgYZ0AznZxQ/cw==",
-      "license": "MIT",
-      "dependencies": {
-        "@babel/runtime": "^7.23.2"
-      }
-    },
     "node_modules/ignore": {
       "version": "7.0.5",
       "resolved": "https://registry.npmjs.org/ignore/-/ignore-7.0.5.tgz",
@@ -8437,18 +8387,6 @@
         "url": "https://github.com/sponsors/fregante"
       }
     },
-    "node_modules/marked": {
-      "version": "18.0.4",
-      "resolved": "https://registry.npmjs.org/marked/-/marked-18.0.4.tgz",
-      "integrity": "sha512-c/BTaKzg0G6ezQx97DAkYU7k0HM6ys0FqYeKBL6hlBByZwy+ycA1+f0vDdjMHKKeEjdgkx0GOv9Il6D+85cOqA==",
-      "license": "MIT",
-      "bin": {
-        "marked": "bin/marked.js"
-      },
-      "engines": {
-        "node": ">= 20"
-      }
-    },
     "node_modules/marky": {
       "version": "1.3.0",
       "resolved": "https://registry.npmjs.org/marky/-/marky-1.3.0.tgz",
@@ -9807,33 +9745,6 @@
         "react": "^19.2.6"
       }
     },
-    "node_modules/react-i18next": {
-      "version": "17.0.8",
-      "resolved": "https://registry.npmjs.org/react-i18next/-/react-i18next-17.0.8.tgz",
-      "integrity": "sha512-0ooKbGLU8JXhe1zwpQUWIeXSgLPOfwJmgheWRIUpcoA0CpyabpGhayjdG+/eA5esC1AQ8h2jWpXjJfzQzeDOCw==",
-      "license": "MIT",
-      "dependencies": {
-        "@babel/runtime": "^7.29.2",
-        "html-parse-stringify": "^3.0.1",
-        "use-sync-external-store": "^1.6.0"
-      },
-      "peerDependencies": {
-        "i18next": ">= 26.2.0",
-        "react": ">= 16.8.0",
-        "typescript": "^5 || ^6"
-      },
-      "peerDependenciesMeta": {
-        "react-dom": {
-          "optional": true
-        },
-        "react-native": {
-          "optional": true
-        },
-        "typescript": {
-          "optional": true
-        }
-      }
-    },
     "node_modules/react-remove-scroll": {
       "version": "2.7.2",
       "resolved": "https://registry.npmjs.org/react-remove-scroll/-/react-remove-scroll-2.7.2.tgz",
@@ -11443,7 +11354,7 @@
       "version": "5.9.3",
       "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz",
       "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==",
-      "devOptional": true,
+      "dev": true,
       "license": "Apache-2.0",
       "bin": {
         "tsc": "bin/tsc",
@@ -11742,15 +11653,6 @@
         }
       }
     },
-    "node_modules/use-sync-external-store": {
-      "version": "1.6.0",
-      "resolved": "https://registry.npmjs.org/use-sync-external-store/-/use-sync-external-store-1.6.0.tgz",
-      "integrity": "sha512-Pp6GSwGP/NrPIrxVFAIkOQeyw8lFenOHijQWkUTrDvrF4ALqylP2C/KCkeS9dpUM3KvYRQhna5vt7IL95+ZQ9w==",
-      "license": "MIT",
-      "peerDependencies": {
-        "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0"
-      }
-    },
     "node_modules/util-deprecate": {
       "version": "1.0.2",
       "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz",
@@ -11958,15 +11860,6 @@
         }
       }
     },
-    "node_modules/void-elements": {
-      "version": "3.1.0",
-      "resolved": "https://registry.npmjs.org/void-elements/-/void-elements-3.1.0.tgz",
-      "integrity": "sha512-Dhxzh5HZuiHQhbvTW9AMetFfBHDMYpo23Uo9btPXgdYP+3T5S+p+jgNy7spra+veYhBP2dCSgxR/i2Y02h5/6w==",
-      "license": "MIT",
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
     "node_modules/w3c-xmlserializer": {
       "version": "5.0.0",
       "resolved": "https://registry.npmjs.org/w3c-xmlserializer/-/w3c-xmlserializer-5.0.0.tgz",

package.json

@@ -36,15 +36,11 @@
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "dayjs": "^1.11.20",
-    "i18next": "^26.2.0",
-    "i18next-browser-languagedetector": "^8.2.1",
     "lucide-react": "^1.16.0",
-    "marked": "^18.0.4",
     "qr-scanner": "^1.4.2",
     "qrious": "^4.0.2",
     "react": "^19.2.6",
     "react-dom": "^19.2.6",
-    "react-i18next": "^17.0.8",
     "sonner": "^2.0.7",
     "tailwind-merge": "^3.6.0"
   },

pages/Base64Converter/FileMode.tsx

@@ -1,220 +0,0 @@
-import { Trash2, Upload } from 'lucide-react';
-import TextInputArea from '@/components/TextInputArea';
-import { useLazyTranslation } from '@/utils/useLazyTranslation';
-import CopyButton from '@/components/CopyButton';
-import DecodeResultPaper from '@/components/DecodeResultPaper';
-import { Button } from '@/components/ui/button';
-import { downloadBlob, formatFileSize, MAX_FILE_SIZE } from '@/utils/base64Converter';
-import { useStorageState } from '@/utils/useStorageState';
-import type { Base64ConvertDirection } from '@/types/storage';
-import SwitchButtonGroup from '@/components/SwitchButtonGroup';
-import { useBase64Converter } from './useBase64Converter'; // 💡 斩断重复代码
-import { cn } from '@/lib/utils';
-
-const isValidDirection = (val: unknown): val is Base64ConvertDirection =>
-  val === 'encode' || val === 'decode';
-
-export default function FileMode() {
-  const { t } = useLazyTranslation('base64Converter');
-  const [direction, setDirection] = useStorageState(
-    'base64Converter/fileMode/direction',
-    'encode',
-    isValidDirection,
-  );
-
-  const {
-    result,
-    info,
-    isLoading,
-    isDragging,
-    setIsDragging,
-    fileInputRef,
-    encodeError,
-    decodeInput,
-    setDecodeInput,
-    decoded,
-    decodeError,
-    decodedFileName,
-    setCustomFileName,
-    resetAll,
-    safeFileSelect,
-  } = useBase64Converter({ mode: 'file' });
-
-  const handleDownload = () => {
-    if (decoded) downloadBlob(decoded.blob, decodedFileName);
-  };
-
-  return (
-    <div className="w-full flex flex-col space-y-4 animate-in fade-in duration-300">
-      <div className="flex h-11 items-center px-1.5 bg-secondary/40 rounded-xl border border-border/60 w-fit">
-        <SwitchButtonGroup
-          value={direction}
-          options={[
-            { value: 'encode', label: t('encode') },
-            { value: 'decode', label: t('decode') },
-          ]}
-          onChange={(next) => {
-            if (next && next !== direction) {
-              resetAll();
-              setDirection(next);
-            }
-          }}
-          size="small"
-        />
-      </div>
-
-      {direction === 'encode' ? (
-        <div className="flex flex-col space-y-4">
-          <div
-            onDragOver={(e) => {
-              e.preventDefault();
-              setIsDragging(true);
-            }}
-            onDragLeave={() => setIsDragging(false)}
-            onDrop={(e) => {
-              e.preventDefault();
-              setIsDragging(false);
-              const file = e.dataTransfer.files[0];
-              if (file) safeFileSelect(file);
-            }}
-            onClick={() => fileInputRef.current?.click()}
-            className={cn(
-              'flex flex-col items-center justify-center min-h-[190px] border-2 border-dashed rounded-2xl p-8 cursor-pointer transition-all duration-300',
-              isDragging
-                ? 'border-primary bg-primary/10'
-                : info
-                  ? 'border-primary/60 bg-primary/5'
-                  : 'border-border bg-muted/40 hover:border-primary/80 hover:bg-muted/70',
-            )}
-          >
-            <input
-              ref={fileInputRef}
-              type="file"
-              hidden
-              onChange={(e) => {
-                const file = e.target.files?.[0];
-                if (file) safeFileSelect(file);
-              }}
-            />
-            {isLoading ? (
-              <div className="w-9 h-9 border-3 border-primary/20 border-t-primary rounded-full animate-spin" />
-            ) : info ? (
-              <div className="flex flex-col items-center gap-1.5 text-center">
-                <Upload className="w-8 h-8 text-primary animate-bounce" />
-                <span className="text-sm font-bold text-foreground/90 max-w-[280px] truncate">
-                  {info.name}
-                </span>
-                <span className="text-xs text-muted-foreground/80 font-mono tabular-nums">
-                  {formatFileSize(info.size)} · {info.type}
-                </span>
-                <span className="text-[11px] font-medium text-primary/80 mt-1">
-                  {t('clickOrDropToReplace')}
-                </span>
-              </div>
-            ) : (
-              <div className="flex flex-col items-center gap-1.5 text-center">
-                <Upload className="w-8 h-8 text-muted-foreground/60" />
-                <span className="text-xs font-bold text-foreground/80">
-                  {t('clickOrDropToFile')}
-                </span>
-                <span className="text-[10px] font-medium text-muted-foreground/60">
-                  {t('maxFileSize', { max: `${MAX_FILE_SIZE / 1024 / 1024} MB` })}
-                </span>
-              </div>
-            )}
-          </div>
-
-          {encodeError && (
-            <div
-              role="alert"
-              className="p-3.5 bg-destructive/10 border border-destructive/20 rounded-xl text-xs font-semibold text-destructive"
-            >
-              {encodeError}
-            </div>
-          )}
-
-          {result && (
-            <div className="p-4 rounded-2xl bg-card border border-border shadow-sm flex flex-col space-y-3">
-              <div className="flex justify-between items-center select-none">
-                <span className="text-[10px] font-bold uppercase tracking-wider text-muted-foreground/90">
-                  {t('base64Output')}
-                </span>
-                <div className="flex gap-2">
-                  <CopyButton
-                    text={result.rawBase64}
-                    tooltip={t('copyRaw')}
-                    className="h-6 px-2 rounded-md border text-[10px] font-bold"
-                  />
-                  <CopyButton
-                    text={result.output}
-                    tooltip={t('copyDataUri')}
-                    className="h-6 px-2 rounded-md border text-[10px] font-bold"
-                  />
-                </div>
-              </div>
-              <TextInputArea
-                readOnly
-                value={
-                  result.output.length > 2000
-                    ? `${result.output.substring(0, 2000)}...`
-                    : result.output
-                }
-                showClear={false}
-                minRows={4}
-              />
-              <div className="flex items-center justify-between font-mono text-[10px] text-muted-foreground/70 select-none pt-1">
-                <div className="flex gap-4 items-center tabular-nums">
-                  <span>
-                    {t('originalSize')}:{' '}
-                    <span className="font-semibold text-foreground/80">
-                      {formatFileSize(result.originalBytes)}
-                    </span>
-                  </span>
-                  <span className="text-border/60">|</span>
-                  <span>
-                    {t('encodedSize')}:{' '}
-                    <span className="font-semibold text-foreground/80">
-                      {formatFileSize(result.outputBytes)}
-                    </span>
-                  </span>
-                </div>
-                <Button
-                  variant="ghost"
-                  size="sm"
-                  onClick={resetAll}
-                  className="h-7 rounded-md text-muted-foreground hover:text-destructive text-[11px] gap-1 px-2"
-                >
-                  <Trash2 className="w-3.5 h-3.5" />
-                  {t('clear')}
-                </Button>
-              </div>
-            </div>
-          )}
-        </div>
-      ) : (
-        <div className="flex flex-col space-y-4">
-          <TextInputArea
-            placeholder={t('decodeBase64Placeholder')}
-            value={decodeInput}
-            onChange={setDecodeInput}
-            externalError={decodeError || undefined}
-            showClear={true}
-            allowCopy={true}
-            minRows={6}
-            onClear={resetAll}
-          />
-          {decoded && (
-            <DecodeResultPaper
-              title={t('decodedFileOutput')}
-              mimeType={decoded.mimeType}
-              blobSize={decoded.blob.size}
-              fileName={decodedFileName}
-              onFileNameChange={setCustomFileName}
-              onDownload={handleDownload}
-            />
-          )}
-        </div>
-      )}
-    </div>
-  );
-}

pages/Base64Converter/ImageMode.tsx

@@ -1,259 +0,0 @@
-import { Image as ImageIcon, Trash2 } from 'lucide-react';
-import TextInputArea from '@/components/TextInputArea';
-import { useLazyTranslation } from '@/utils/useLazyTranslation';
-import CopyButton from '@/components/CopyButton';
-import DecodeResultPaper from '@/components/DecodeResultPaper';
-import { Button } from '@/components/ui/button';
-import { downloadBlob, formatFileSize } from '@/utils/base64Converter';
-import { useStorageState } from '@/utils/useStorageState';
-import type { Base64ConvertDirection } from '@/types/storage';
-import SwitchButtonGroup from '@/components/SwitchButtonGroup';
-import { useBase64Converter } from './useBase64Converter'; // 💡 引入共享核心
-import { cn } from '@/lib/utils';
-
-const isValidDirection = (val: unknown): val is Base64ConvertDirection =>
-  val === 'encode' || val === 'decode';
-
-export default function ImageMode() {
-  const { t } = useLazyTranslation('base64Converter');
-  const [direction, setDirection] = useStorageState(
-    'base64Converter/imageMode/direction',
-    'encode',
-    isValidDirection,
-  );
-
-  // 消费完全托管的核心 Hook，消灭本地多余状态机
-  const {
-    result,
-    info,
-    isLoading,
-    isDragging,
-    setIsDragging,
-    fileInputRef,
-    encodeError,
-    decodeInput,
-    setDecodeInput,
-    decoded,
-    decodeError,
-    decodedFileName,
-    setCustomFileName,
-    resetAll,
-    safeFileSelect,
-  } = useBase64Converter({ mode: 'image' });
-
-  const handleDirectionChange = (next: Base64ConvertDirection) => {
-    if (!next || next === direction) return;
-    resetAll();
-    setDirection(next);
-  };
-
-  const handleDownload = () => {
-    if (decoded) downloadBlob(decoded.blob, decodedFileName);
-  };
-
-  return (
-    <div className="w-full flex flex-col space-y-4 animate-in fade-in duration-300">
-      <div className="flex h-11 items-center px-1.5 bg-secondary/40 rounded-xl border border-border/60 w-fit">
-        <SwitchButtonGroup
-          value={direction}
-          options={[
-            { value: 'encode', label: t('encode') },
-            { value: 'decode', label: t('decode') },
-          ]}
-          onChange={handleDirectionChange}
-          size="small"
-        />
-      </div>
-
-      {direction === 'encode' ? (
-        <div className="flex flex-col space-y-4">
-          {/* 图片拖拽投递箱终端 */}
-          <div
-            onDragOver={(e) => {
-              e.preventDefault();
-              setIsDragging(true);
-            }}
-            onDragLeave={() => setIsDragging(false)}
-            onDrop={(e) => {
-              e.preventDefault();
-              setIsDragging(false);
-              const file = e.dataTransfer.files[0];
-              if (file) safeFileSelect(file);
-            }}
-            onClick={() => fileInputRef.current?.click()}
-            className={cn(
-              'flex flex-col items-center justify-center min-h-[190px] border-2 border-dashed rounded-2xl p-8 cursor-pointer transition-all duration-300',
-              isDragging
-                ? 'border-primary bg-primary/10'
-                : info
-                  ? 'border-primary/60 bg-primary/5'
-                  : 'border-border bg-muted/40 hover:border-primary/80 hover:bg-muted/70',
-            )}
-          >
-            <input
-              ref={fileInputRef}
-              type="file"
-              accept="image/*"
-              hidden
-              onChange={(e) => {
-                const file = e.target.files?.[0];
-                if (file) safeFileSelect(file);
-              }}
-            />
-            {isLoading ? (
-              <div className="w-9 h-9 border-3 border-primary/20 border-t-primary rounded-full animate-spin" />
-            ) : info ? (
-              <div className="flex flex-col items-center gap-1.5 text-center animate-in fade-in duration-200 w-full">
-                {result && (
-                  <div className="relative p-1 border border-border bg-background rounded-lg shadow-sm mb-1 max-w-[180px] overflow-hidden">
-                    <img
-                      src={result.output}
-                      alt="preview"
-                      className="max-h-32 w-full object-contain rounded"
-                    />
-                  </div>
-                )}
-                <span className="text-sm font-bold text-foreground/90 max-w-[280px] truncate">
-                  {info.name}
-                </span>
-                <span className="text-xs text-muted-foreground/80 font-mono tabular-nums">
-                  {formatFileSize(info.size)} · {info.type}
-                </span>
-                <span className="text-[11px] font-medium text-primary/80 mt-1">
-                  {t('clickOrDropToReplace')}
-                </span>
-              </div>
-            ) : (
-              <div className="flex flex-col items-center gap-1.5 text-center">
-                <ImageIcon className="w-8 h-8 text-muted-foreground/60" />
-                <span className="text-xs font-bold text-foreground/80">
-                  {t('clickOrDropToImage')}
-                </span>
-                <span className="text-[10px] font-medium text-muted-foreground/60">
-                  {t('supportedFormats')}
-                </span>
-              </div>
-            )}
-          </div>
-
-          {encodeError && (
-            <div
-              role="alert"
-              className="p-3.5 bg-destructive/10 border border-destructive/20 rounded-xl text-xs font-semibold text-destructive tracking-wide"
-            >
-              {encodeError}
-            </div>
-          )}
-
-          {result && (
-            <div className="p-4 rounded-2xl bg-card border border-border shadow-sm flex flex-col space-y-3">
-              <div className="flex justify-between items-center select-none">
-                <span className="text-[10px] font-bold uppercase tracking-wider text-muted-foreground/90">
-                  {t('base64Output')}
-                </span>
-                <div className="flex gap-2">
-                  <CopyButton
-                    text={result.rawBase64}
-                    tooltip={t('copyRaw')}
-                    className="h-6 px-2 rounded-md border text-[10px] font-bold"
-                  />
-                  <CopyButton
-                    text={result.output}
-                    tooltip={t('copyDataUri')}
-                    className="h-6 px-2 rounded-md border text-[10px] font-bold"
-                  />
-                </div>
-              </div>
-
-              <TextInputArea
-                readOnly
-                value={
-                  result.output.length > 2000
-                    ? `${result.output.substring(0, 2000)}...`
-                    : result.output
-                }
-                showClear={false}
-                minRows={4}
-              />
-
-              <div className="flex items-center justify-between font-mono text-[10px] text-muted-foreground/70 select-none pt-1">
-                <div className="flex gap-4 items-center tabular-nums">
-                  <span>
-                    {t('originalSize')}:{' '}
-                    <span className="font-semibold text-foreground/80">
-                      {formatFileSize(result.originalBytes)}
-                    </span>
-                  </span>
-                  <span className="text-border/60">|</span>
-                  <span>
-                    {t('encodedSize')}:{' '}
-                    <span className="font-semibold text-foreground/80">
-                      {formatFileSize(result.outputBytes)}
-                    </span>
-                  </span>
-                </div>
-
-                <Button
-                  variant="ghost"
-                  size="sm"
-                  onClick={resetAll}
-                  className="h-7 rounded-md text-muted-foreground hover:text-destructive text-[11px] gap-1 px-2"
-                >
-                  <Trash2 className="w-3.5 h-3.5" />
-                  {t('clear')}
-                </Button>
-              </div>
-            </div>
-          )}
-
-          {info && !result && (
-            <div className="flex justify-end select-none">
-              <Button
-                variant="outline"
-                size="sm"
-                onClick={resetAll}
-                className="h-8 rounded-md text-xs gap-1.5 text-destructive hover:text-destructive hover:bg-destructive/5 dark:hover:bg-destructive/10"
-              >
-                <Trash2 className="w-3.5 h-3.5" />
-                {t('clear')}
-              </Button>
-            </div>
-          )}
-        </div>
-      ) : (
-        <div className="flex flex-col space-y-4">
-          <TextInputArea
-            placeholder={t('decodeBase64Placeholder')}
-            value={decodeInput}
-            onChange={setDecodeInput}
-            externalError={decodeError || undefined}
-            showClear={true}
-            allowCopy={true}
-            minRows={6}
-            onClear={resetAll}
-          />
-          {decoded && (
-            <div className="animate-in slide-in-from-bottom-2 duration-300">
-              <DecodeResultPaper
-                title={t('decodedImageOutput')}
-                mimeType={decoded.mimeType}
-                blobSize={decoded.blob.size}
-                fileName={decodedFileName}
-                onFileNameChange={setCustomFileName}
-                onDownload={handleDownload}
-              >
-                <div className="relative p-1.5 border border-border bg-background dark:bg-muted/10 rounded-xl max-w-[220px] mb-3 overflow-hidden shadow-sm">
-                  <img
-                    src={`data:${decoded.mimeType};base64,${decoded.rawBase64}`}
-                    alt="decoded preview"
-                    className="max-h-40 w-full rounded-lg object-contain bg-[linear-gradient(45deg,#ccc_25%,transparent_25%),linear-gradient(-45deg,#ccc_25%,transparent_25%),linear-gradient(45deg,transparent_75%,#ccc_75%),linear-gradient(-45deg,transparent_75%,#ccc_75%)] bg-[size:10px_10px] bg-[position:0_0,0_5px,5px_-5px,-5px_0] dark:bg-none"
-                  />
-                </div>
-              </DecodeResultPaper>
-            </div>
-          )}
-        </div>
-      )}
-    </div>
-  );
-}

pages/Base64Converter/__tests__/FileMode.test.tsx

@@ -1,235 +0,0 @@
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-import { act, fireEvent, render, screen, waitFor } from '@testing-library/react';
-import FileMode from '../FileMode';
-
-// Mock CopyButton
-vi.mock('@/components/CopyButton', () => ({
-  default: ({ text, tooltip }: { text: string; tooltip?: string }) => (
-    <button data-testid="copy-button" data-tooltip={tooltip}>
-      {text.slice(0, 20)}
-    </button>
-  ),
-}));
-
-beforeEach(() => {
-  localStorage.clear();
-  vi.useFakeTimers({ shouldAdvanceTime: true });
-});
-
-afterEach(() => {
-  vi.useRealTimers();
-});
-
-// useStorageState's async loadState may overwrite user toggle if we click before the
-// initial chrome.storage read settles. Flush pending microtasks first.
-const waitForStorageReady = () => act(() => Promise.resolve());
-
-describe('FileMode', () => {
-  it('应该渲染文件上传区域', async () => {
-    render(<FileMode />);
-    await waitForStorageReady();
-    expect(screen.getByText('base64Converter:clickOrDropToFile')).toBeInTheDocument();
-    expect(screen.getByText('base64Converter:maxFileSize')).toBeInTheDocument();
-  });
-
-  it('应该处理有效的文件选择', async () => {
-    render(<FileMode />);
-    await waitForStorageReady();
-
-    const file = new File(['test content'], 'test.txt', { type: 'text/plain' });
-
-    // 文件输入是隐藏的，直接触发 change 事件
-    const hiddenInput = document.querySelector('input[type="file"]') as HTMLInputElement;
-    fireEvent.change(hiddenInput, { target: { files: [file] } });
-
-    await waitFor(() => {
-      expect(screen.getByText('test.txt')).toBeInTheDocument();
-      expect(screen.getByText('base64Converter:base64Output')).toBeInTheDocument();
-    });
-  });
-
-  it('应该拒绝超出大小限制的文件', async () => {
-    render(<FileMode />);
-    await waitForStorageReady();
-
-    // 创建一个超过 10MB 的文件
-    const largeContent = new Uint8Array(11 * 1024 * 1024);
-    const file = new File([largeContent], 'large.bin', { type: 'application/octet-stream' });
-
-    const hiddenInput = document.querySelector('input[type="file"]') as HTMLInputElement;
-    fireEvent.change(hiddenInput, { target: { files: [file] } });
-
-    await waitFor(() => {
-      expect(screen.getByRole('alert')).toHaveTextContent('base64Converter:fileSizeExceeded');
-    });
-  });
-
-  it('点击清除按钮应该清空文件状态', async () => {
-    render(<FileMode />);
-    await waitForStorageReady();
-
-    const file = new File(['test'], 'test.txt', { type: 'text/plain' });
-    const hiddenInput = document.querySelector('input[type="file"]') as HTMLInputElement;
-    fireEvent.change(hiddenInput, { target: { files: [file] } });
-
-    await waitFor(() => {
-      expect(screen.getByText('test.txt')).toBeInTheDocument();
-    });
-
-    fireEvent.click(screen.getByText('base64Converter:clear'));
-
-    await waitFor(() => {
-      expect(screen.queryByText('test.txt')).not.toBeInTheDocument();
-      expect(screen.getByText('base64Converter:clickOrDropToFile')).toBeInTheDocument();
-    });
-  });
-
-  it('应该显示文件大小和类型信息', async () => {
-    render(<FileMode />);
-    await waitForStorageReady();
-
-    const file = new File(['test content'], 'test.txt', { type: 'text/plain' });
-    const hiddenInput = document.querySelector('input[type="file"]') as HTMLInputElement;
-    fireEvent.change(hiddenInput, { target: { files: [file] } });
-
-    await waitFor(() => {
-      expect(screen.getByText('test.txt')).toBeInTheDocument();
-    });
-    // 文件类型显示在 caption 中，格式为 "size · type"
-    expect(screen.getByText(/test\.txt/)).toBeInTheDocument();
-  });
-
-  it('应该显示原始大小和编码大小', async () => {
-    render(<FileMode />);
-    await waitForStorageReady();
-
-    const file = new File(['test content'], 'test.txt', { type: 'text/plain' });
-    const hiddenInput = document.querySelector('input[type="file"]') as HTMLInputElement;
-    fireEvent.change(hiddenInput, { target: { files: [file] } });
-
-    await waitFor(() => {
-      expect(screen.getByText(/base64Converter:originalSize/)).toBeInTheDocument();
-      expect(screen.getByText(/base64Converter:encodedSize/)).toBeInTheDocument();
-    });
-  });
-
-  it('应该提供复制按钮', async () => {
-    render(<FileMode />);
-    await waitForStorageReady();
-
-    const file = new File(['test'], 'test.txt', { type: 'text/plain' });
-    const hiddenInput = document.querySelector('input[type="file"]') as HTMLInputElement;
-    fireEvent.change(hiddenInput, { target: { files: [file] } });
-
-    await waitFor(() => {
-      const copyButtons = screen.getAllByTestId('copy-button');
-      expect(copyButtons.length).toBeGreaterThanOrEqual(2);
-    });
-  });
-
-  it('应该渲染 encode/decode 切换按钮', () => {
-    render(<FileMode />);
-    expect(screen.getByText('base64Converter:encode')).toBeInTheDocument();
-    expect(screen.getByText('base64Converter:decode')).toBeInTheDocument();
-  });
-
-  it('切到 decode 应该显示 Base64 输入框', async () => {
-    render(<FileMode />);
-    await waitForStorageReady();
-    fireEvent.click(screen.getByText('base64Converter:decode'));
-    expect(
-      await screen.findByPlaceholderText('base64Converter:decodeBase64Placeholder'),
-    ).toBeInTheDocument();
-  });
-
-  it('解码 PDF Base64 后应该显示 application/pdf 与默认文件名 decoded.pdf', async () => {
-    render(<FileMode />);
-    await waitForStorageReady();
-    fireEvent.click(screen.getByText('base64Converter:decode'));
-
-    const input = await screen.findByPlaceholderText('base64Converter:decodeBase64Placeholder');
-    fireEvent.change(input, { target: { value: 'JVBERi0K' } });
-
-    act(() => {
-      vi.advanceTimersByTime(250);
-    });
-
-    await waitFor(() => {
-      expect(screen.getByText('base64Converter:decodedFileOutput')).toBeInTheDocument();
-      expect(screen.getByText(/application\/pdf/)).toBeInTheDocument();
-      expect(screen.getByDisplayValue('decoded.pdf')).toBeInTheDocument();
-    });
-  });
-
-  it('解码后的文件名应该可编辑', async () => {
-    render(<FileMode />);
-    await waitForStorageReady();
-    fireEvent.click(screen.getByText('base64Converter:decode'));
-
-    const input = await screen.findByPlaceholderText('base64Converter:decodeBase64Placeholder');
-    fireEvent.change(input, { target: { value: 'JVBERi0K' } });
-
-    act(() => {
-      vi.advanceTimersByTime(250);
-    });
-
-    const filenameInput = (await screen.findByDisplayValue('decoded.pdf')) as HTMLInputElement;
-    fireEvent.change(filenameInput, { target: { value: 'my-report.pdf' } });
-    expect(filenameInput.value).toBe('my-report.pdf');
-  });
-
-  it('解码后应该显示下载按钮', async () => {
-    render(<FileMode />);
-    await waitForStorageReady();
-    fireEvent.click(screen.getByText('base64Converter:decode'));
-
-    const input = await screen.findByPlaceholderText('base64Converter:decodeBase64Placeholder');
-    fireEvent.change(input, { target: { value: 'JVBERi0K' } });
-
-    act(() => {
-      vi.advanceTimersByTime(250);
-    });
-
-    expect(await screen.findByText('base64Converter:download')).toBeInTheDocument();
-  });
-
-  it('解码非法 Base64 应该显示 invalidBase64 错误', async () => {
-    render(<FileMode />);
-    await waitForStorageReady();
-    fireEvent.click(screen.getByText('base64Converter:decode'));
-
-    const input = await screen.findByPlaceholderText('base64Converter:decodeBase64Placeholder');
-    fireEvent.change(input, { target: { value: '!!!not base64' } });
-
-    act(() => {
-      vi.advanceTimersByTime(250);
-    });
-
-    await waitFor(() => {
-      expect(screen.getByText('base64Converter:invalidBase64')).toBeInTheDocument();
-    });
-  });
-
-  it('切换方向时应该清空解码状态', async () => {
-    render(<FileMode />);
-    await waitForStorageReady();
-    fireEvent.click(screen.getByText('base64Converter:decode'));
-
-    const input = await screen.findByPlaceholderText('base64Converter:decodeBase64Placeholder');
-    fireEvent.change(input, { target: { value: 'JVBERi0K' } });
-
-    act(() => {
-      vi.advanceTimersByTime(250);
-    });
-
-    await waitFor(() => {
-      expect(screen.getByText('base64Converter:decodedFileOutput')).toBeInTheDocument();
-    });
-
-    fireEvent.click(screen.getByText('base64Converter:encode'));
-
-    await waitFor(() => {
-      expect(screen.queryByText('decodedFileOutput')).not.toBeInTheDocument();
-    });
-  });
-});

pages/Base64Converter/__tests__/ImageMode.test.tsx

@@ -1,182 +0,0 @@
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-import { act, fireEvent, render, screen, waitFor } from '@testing-library/react';
-import ImageMode from '../ImageMode';
-
-// Mock CopyButton
-vi.mock('@/components/CopyButton', () => ({
-  default: ({ text, tooltip }: { text: string; tooltip?: string }) => (
-    <button data-testid="copy-button" data-tooltip={tooltip}>
-      {text.slice(0, 20)}
-    </button>
-  ),
-}));
-
-beforeEach(() => {
-  localStorage.clear();
-  vi.useFakeTimers({ shouldAdvanceTime: true });
-});
-
-afterEach(() => {
-  vi.useRealTimers();
-});
-
-const waitForStorageReady = () => act(() => Promise.resolve());
-
-describe('ImageMode', () => {
-  it('应该渲染图像上传区域', async () => {
-    render(<ImageMode />);
-    await waitForStorageReady();
-    expect(screen.getByText('base64Converter:clickOrDropToImage')).toBeInTheDocument();
-    expect(screen.getByText('base64Converter:supportedFormats')).toBeInTheDocument();
-  });
-
-  it('应该接受有效的图像文件', async () => {
-    render(<ImageMode />);
-    await waitForStorageReady();
-
-    const file = new File(['fake-image-data'], 'test.png', { type: 'image/png' });
-    const hiddenInput = document.querySelector('input[type="file"]') as HTMLInputElement;
-    fireEvent.change(hiddenInput, { target: { files: [file] } });
-
-    await waitFor(() => {
-      expect(screen.getByText('test.png')).toBeInTheDocument();
-      expect(screen.getByText('base64Converter:base64Output')).toBeInTheDocument();
-    });
-  });
-
-  it('应该拒绝非图像文件', async () => {
-    render(<ImageMode />);
-    await waitForStorageReady();
-
-    const file = new File(['not an image'], 'test.txt', { type: 'text/plain' });
-    const hiddenInput = document.querySelector('input[type="file"]') as HTMLInputElement;
-    fireEvent.change(hiddenInput, { target: { files: [file] } });
-
-    await waitFor(() => {
-      expect(screen.getByRole('alert')).toHaveTextContent('base64Converter:unsupportedImageType');
-    });
-  });
-
-  it('应该拒绝超出大小限制的图像', async () => {
-    render(<ImageMode />);
-    await waitForStorageReady();
-
-    const largeContent = new Uint8Array(11 * 1024 * 1024);
-    const file = new File([largeContent], 'large.png', { type: 'image/png' });
-
-    const hiddenInput = document.querySelector('input[type="file"]') as HTMLInputElement;
-    fireEvent.change(hiddenInput, { target: { files: [file] } });
-
-    await waitFor(() => {
-      expect(screen.getByRole('alert')).toHaveTextContent('base64Converter:fileSizeExceeded');
-    });
-  });
-
-  it('应该通过扩展名识别图像', async () => {
-    render(<ImageMode />);
-    await waitForStorageReady();
-
-    // 没有 MIME 类型但有正确扩展名
-    const file = new File(['fake'], 'test.jpg');
-    const hiddenInput = document.querySelector('input[type="file"]') as HTMLInputElement;
-    fireEvent.change(hiddenInput, { target: { files: [file] } });
-
-    await waitFor(() => {
-      expect(screen.getByText('test.jpg')).toBeInTheDocument();
-    });
-  });
-
-  it('点击清除按钮应该清空图像状态', async () => {
-    render(<ImageMode />);
-    await waitForStorageReady();
-
-    const file = new File(['fake'], 'test.png', { type: 'image/png' });
-    const hiddenInput = document.querySelector('input[type="file"]') as HTMLInputElement;
-    fireEvent.change(hiddenInput, { target: { files: [file] } });
-
-    await waitFor(() => {
-      expect(screen.getByText('test.png')).toBeInTheDocument();
-    });
-
-    fireEvent.click(screen.getByText('base64Converter:clear'));
-
-    await waitFor(() => {
-      expect(screen.queryByText('test.png')).not.toBeInTheDocument();
-      expect(screen.getByText('base64Converter:clickOrDropToImage')).toBeInTheDocument();
-    });
-  });
-
-  it('应该显示图像预览', async () => {
-    render(<ImageMode />);
-    await waitForStorageReady();
-
-    const file = new File(['fake-image'], 'test.png', { type: 'image/png' });
-    const hiddenInput = document.querySelector('input[type="file"]') as HTMLInputElement;
-    fireEvent.change(hiddenInput, { target: { files: [file] } });
-
-    await waitFor(() => {
-      const img = screen.getByAltText('preview');
-      expect(img).toBeInTheDocument();
-      expect(img.tagName.toLowerCase()).toBe('img');
-    });
-  });
-
-  it('应该渲染 encode/decode 切换按钮', async () => {
-    render(<ImageMode />);
-    await waitForStorageReady();
-    expect(screen.getByText('base64Converter:encode')).toBeInTheDocument();
-    expect(screen.getByText('base64Converter:decode')).toBeInTheDocument();
-  });
-
-  it('解码 PNG Base64 后应该显示图像预览', async () => {
-    render(<ImageMode />);
-    await waitForStorageReady();
-    fireEvent.click(screen.getByText('base64Converter:decode'));
-
-    const input = await screen.findByPlaceholderText('base64Converter:decodeBase64Placeholder');
-    fireEvent.change(input, { target: { value: 'iVBORw0KGgo=' } });
-
-    act(() => {
-      vi.advanceTimersByTime(250);
-    });
-
-    await waitFor(() => {
-      expect(screen.getByText('base64Converter:decodedImageOutput')).toBeInTheDocument();
-      const img = screen.getByAltText('decoded preview');
-      expect(img).toBeInTheDocument();
-      expect(img.tagName.toLowerCase()).toBe('img');
-    });
-  });
-
-  it('解码后默认文件名应该为 decoded.png', async () => {
-    render(<ImageMode />);
-    await waitForStorageReady();
-    fireEvent.click(screen.getByText('base64Converter:decode'));
-
-    const input = await screen.findByPlaceholderText('base64Converter:decodeBase64Placeholder');
-    fireEvent.change(input, { target: { value: 'iVBORw0KGgo=' } });
-
-    act(() => {
-      vi.advanceTimersByTime(250);
-    });
-
-    expect(await screen.findByDisplayValue('decoded.png')).toBeInTheDocument();
-  });
-
-  it('解码非法 Base64 应该显示 invalidBase64 错误', async () => {
-    render(<ImageMode />);
-    await waitForStorageReady();
-    fireEvent.click(screen.getByText('base64Converter:decode'));
-
-    const input = await screen.findByPlaceholderText('base64Converter:decodeBase64Placeholder');
-    fireEvent.change(input, { target: { value: '!!!not base64' } });
-
-    act(() => {
-      vi.advanceTimersByTime(250);
-    });
-
-    await waitFor(() => {
-      expect(screen.getByText('base64Converter:invalidBase64')).toBeInTheDocument();
-    });
-  });
-});

pages/Dashboard/ToolCard.tsx

@@ -1,108 +0,0 @@
-import type { ComponentType } from 'react';
-import React from 'react';
-import type { LucideProps } from 'lucide-react';
-import { ChevronRight } from 'lucide-react';
-import type { PaletteColorKey } from '@/config/features';
-import { cn } from '@/lib/utils';
-
-const PALETTE_COLORS: Record<PaletteColorKey, string> = {
-  primary: '13, 148, 136', // teal
-  success: '22, 163, 74', // green
-  warning: '217, 119, 6', // amber (存储清理的橙色轴)
-  error: '220, 38, 38', // red
-  secondary: '147, 51, 2 purple',
-  info: '37, 99, 235', // blue
-};
-
-export interface ToolCardProps extends React.HTMLAttributes<HTMLDivElement> {
-  title: string;
-  description?: string;
-  snapshot?: React.ReactNode;
-  colorKey: PaletteColorKey;
-  icon: ComponentType<LucideProps>;
-  onNavigate: () => void;
-}
-
-export default function ToolCard({
-  title,
-  description,
-  snapshot,
-  colorKey,
-  icon: IconComponent,
-  onNavigate,
-  className,
-  ...props
-}: ToolCardProps) {
-  const rgbValues = PALETTE_COLORS[colorKey];
-
-  return (
-    <div
-      style={{
-        ['--tool-color' as string]: rgbValues,
-      }}
-      /* 💡 核心修复点：
-        - 坚决不用 h-full 或固定高度，锁死 h-auto（高度自适应流），配合 py-4 px-4 牢牢把内容包裹在卡片体内。
-        - 废除原先会乱飘的内联 style 属性擦写，全权放权给 Tailwind 的声明式 hover 变体。
-      */
-      className={cn(
-        'group relative rounded-xl border border-border/70 bg-card text-card-foreground p-4 h-auto flex flex-col items-stretch justify-start gap-3 shadow-sm select-none box-border',
-        'transition-all duration-300 ease-[cubic-bezier(0.4,0,0.2,1)]',
-        'hover:bg-muted/30',
-        'hover:border-[rgba(var(--tool-color),0.45)]',
-        'hover:shadow-[0_8px_24px_-8px_rgba(var(--tool-color),0.14)] dark:hover:shadow-[0_8px_30px_-10px_rgba(var(--tool-color),0.25)]',
-        className,
-      )}
-      {...props}
-    >
-      {/* 上半部分：核心信息交互排版轴 */}
-      <div className="flex items-center justify-between w-full relative min-w-0 min-h-[44px]">
-        <div className="flex gap-3 items-center min-w-0 flex-1 pr-2">
-          {/* 左侧圆形图标容器 */}
-          <div
-            className={cn(
-              'flex items-center justify-center w-10 h-10 rounded-xl shrink-0 transition-colors duration-300',
-              'bg-[rgba(var(--tool-color),0.08)] dark:bg-[rgba(var(--tool-color),0.12)]',
-              'text-[rgb(var(--tool-color))]',
-            )}
-          >
-            <IconComponent className="h-5 w-5 shrink-0" />
-          </div>
-
-          {/* 中间文字描述区：利用 flex-1 min-w-0 防御文本过长发生恶性撑开 */}
-          <div className="flex-1 min-w-0 flex flex-col">
-            <h4 className="font-bold text-sm tracking-tight text-foreground leading-snug">
-              {title}
-            </h4>
-            {description && (
-              <p className="text-[11px] font-medium text-muted-foreground/90 mt-0.5 leading-normal w-full truncate">
-                {description}
-              </p>
-            )}
-          </div>
-        </div>
-
-        {/* 右侧指示小箭头 */}
-        <div className="text-muted-foreground/40 group-hover:text-[rgb(var(--tool-color))] p-1 shrink-0 transition-all duration-300 ease-in-out group-hover:translate-x-0.5">
-          <ChevronRight className="h-4 w-4" />
-        </div>
-
-        {/* 覆盖整个上半部分的绝对定位隐形跳转层（A11y 无障碍标准合规） */}
-        <button
-          type="button"
-          onClick={onNavigate}
-          aria-label={`进入 ${title}`}
-          className="absolute inset-0 w-full h-full cursor-pointer bg-transparent border-none opacity-0 focus-visible:outline-none"
-        />
-      </div>
-
-      {/* 下半部分：未来的动态预览沙箱独立承载区 */}
-      {snapshot != null && (
-        <div className="mt-1 pt-3 border-t border-dashed border-border/80 w-full relative z-10 select-text">
-          {snapshot}
-        </div>
-      )}
-    </div>
-  );
-}
-
-ToolCard.displayName = 'ToolCard';

pages/Dashboard/index.tsx

@@ -1,41 +0,0 @@
-import { useRouter } from '@/providers/RouterProvider';
-import ToolCard from '@/pages/Dashboard/ToolCard';
-import { getFeatureByKey } from '@/config/features';
-import type { PageType } from '@/types/storage';
-import { useMemo } from 'react';
-import { useTranslation } from 'react-i18next';
-import { cn } from '@/lib/utils';
-
-export default function DashboardPage() {
-  const { navigateTo, visiblePages, pageOrder } = useRouter();
-  const { t } = useTranslation(['features']);
-
-  const visibleSet = useMemo(() => new Set<string>(visiblePages), [visiblePages]);
-
-  return (
-    <div
-      className={cn(
-        'grid grid-cols-1 sm:grid-cols-[repeat(auto-fill,minmax(290px,1fr))] auto-rows-auto gap-3.5 p-3.5 w-full h-auto',
-        'animate-in fade-in duration-300 select-none',
-      )}
-    >
-      {pageOrder.map((key) => {
-        if (!visibleSet.has(key)) return null;
-
-        const feature = getFeatureByKey(key);
-        if (!feature?.themeColorKey || feature.icon == null) return null;
-
-        return (
-          <ToolCard
-            key={key}
-            title={t(feature.labelKey)}
-            description={t(feature.descriptionKey)}
-            colorKey={feature.themeColorKey}
-            icon={feature.icon}
-            onNavigate={() => navigateTo(key as PageType)}
-          />
-        );
-      })}
-    </div>
-  );
-}

pages/HtmlToMarkdown/index.tsx

@@ -1,177 +0,0 @@
-import { useCallback, useMemo, useState } from 'react';
-import { Download, Trash2 } from 'lucide-react';
-import { useLazyTranslation } from '@/utils/useLazyTranslation';
-import CopyButton from '@/components/CopyButton';
-import SwitchButtonGroup from '@/components/SwitchButtonGroup';
-import { Button } from '@/components/ui/button'; // 💡 1. 全面回归规范：引入原生的 shadcn 原子 Button
-import { useStorageState } from '@/utils/useStorageState';
-import type { HtmlToMarkdownPreviewMode } from '@/types/storage';
-import { downloadMarkdownFile, htmlToMarkdown, SAMPLE_HTML } from '@/utils/htmlToMarkdown';
-import { cn } from '@/lib/utils';
-
-const isValidPreviewMode = (val: unknown): val is HtmlToMarkdownPreviewMode =>
-  typeof val === 'string' && ['split', 'preview', 'markdown'].includes(val);
-
-export default function HtmlToMarkdownPage() {
-  const { t } = useLazyTranslation('htmlToMarkdown');
-  const [previewMode, setPreviewMode] = useStorageState(
-    'htmlToMarkdown/previewMode',
-    'split' as HtmlToMarkdownPreviewMode,
-    isValidPreviewMode,
-  );
-  const [html, setHtml] = useState(SAMPLE_HTML);
-
-  const result = useMemo(() => htmlToMarkdown(html), [html]);
-  const error = result.hasError ? (result.error ?? null) : null;
-
-  const handleModeChange = useCallback(
-    (newMode: HtmlToMarkdownPreviewMode) => {
-      setPreviewMode(newMode);
-    },
-    [setPreviewMode],
-  );
-
-  const handleClear = useCallback(() => {
-    setHtml('');
-  }, []);
-
-  const handleDownload = useCallback(() => {
-    if (result.markdown) {
-      downloadMarkdownFile(result.markdown, 'converted.md');
-    }
-  }, [result.markdown]);
-
-  const showInput = previewMode !== 'preview';
-  const showOutput = previewMode !== 'markdown';
-
-  return (
-    /* 💡 统一间距尺寸：
-      - 彻底清除多余的 container max-w-7xl 这种网页大边距，
-      - 统一收拢为我们先前在 Dashboard 页、JSON 工具箱制定的 p-4 space-y-4 标准极客桌面规格。
-    */
-    <div className="p-4 w-full flex flex-col space-y-4 select-none animate-in fade-in duration-300">
-      <div className="flex flex-col gap-4">
-        {/* 工具栏集成区 */}
-        <div className="flex flex-col sm:flex-row gap-3 justify-between items-stretch sm:items-center bg-secondary/40 rounded-xl border border-border/60 px-1.5 py-1.5 sm:h-12">
-          <SwitchButtonGroup
-            value={previewMode}
-            options={[
-              { value: 'split', label: t('splitMode') },
-              { value: 'preview', label: t('previewMode') },
-              { value: 'markdown', label: t('markdownMode') },
-            ]}
-            onChange={handleModeChange}
-            size="small"
-            className="w-full sm:w-auto"
-          />
-
-          <div className="flex gap-2 shrink-0">
-            {/* 2. 重塑下载按钮：接入受控 Button，追加 active 物理微缩放动效 */}
-            <Button
-              variant="outline"
-              size="sm"
-              onClick={handleDownload}
-              disabled={!result.markdown}
-              className="h-8 rounded-md font-medium text-xs gap-1.5 shadow-sm active:scale-95 transition-all"
-            >
-              <Download className="h-3.5 w-3.5" />
-              {t('download')}
-            </Button>
-
-            {/* 重塑清空按钮 */}
-            <Button
-              variant="outline"
-              size="sm"
-              onClick={handleClear}
-              className="h-8 rounded-md font-medium text-xs gap-1.5 shadow-sm active:scale-95 text-destructive hover:text-destructive hover:bg-destructive/5 dark:hover:bg-destructive/10 border-input/60 transition-all"
-            >
-              <Trash2 className="h-3.5 w-3.5" />
-              {t('clear')}
-            </Button>
-          </div>
-        </div>
-
-        {/* 错误提示：
-          - 💡 核心修复点：将硬编码的 bg-red-50 实色，完美超进化为系统的全自适应透明色变体
-        */}
-        {error && (
-          <div className="p-3.5 bg-destructive/10 border border-destructive/20 rounded-xl text-destructive text-xs font-semibold tracking-wide animate-in shake duration-300">
-            {error}
-          </div>
-        )}
-
-        {/* 双翼/单栏联动面板展示区 */}
-        <div
-          className={cn(
-            'grid gap-4 min-h-[460px] w-full',
-            showInput && showOutput ? 'grid-cols-1 md:grid-cols-2' : 'grid-cols-1',
-          )}
-        >
-          {/* HTML 输入端卡片面板 */}
-          {showInput && (
-            /* 3. 智能聚焦框联动（Focus Ring Clamping）：
-              - 外层容器追加 focus-within 变量追踪大闸。
-              - 只要用户用鼠标点击了内部的 textarea，外层整块精巧的圆角大边框会一帧内亮起 primary 系统的深色呼吸发光环，
-              - 这种“全外包裹层框聚焦”的体验极大模仿了本地原生 IDE 的硬核专业体验！
-            */
-            <div className="border border-border rounded-xl bg-card text-card-foreground shadow-sm overflow-hidden flex flex-col transition-all duration-200 focus-within:ring-1 focus-within:ring-ring focus-within:border-ring">
-              {/* 卡片头部：改用标准的灰色 bg-muted/50 */}
-              <div className="flex h-9 items-center justify-between px-4 bg-muted/50 border-b border-border select-none">
-                <span className="text-[10px] font-bold text-muted-foreground/90 uppercase tracking-wider">
-                  {t('inputLabel')}
-                </span>
-                <span className="text-[10px] font-mono text-muted-foreground/60 tabular-nums">
-                  {t('charCount', { count: html.length })}
-                </span>
-              </div>
-              <textarea
-                value={html}
-                onChange={(e) => setHtml(e.target.value)}
-                placeholder={t('inputPlaceholder')}
-                className="flex-1 min-h-[380px] p-4 bg-transparent font-mono text-xs leading-relaxed resize-none focus:outline-none text-foreground/90 select-text"
-              />
-            </div>
-          )}
-
-          {/* Markdown 输出端卡片面板 */}
-          {showOutput && (
-            <div className="border border-border rounded-xl bg-card text-card-foreground shadow-sm overflow-hidden flex flex-col">
-              <div className="flex h-9 items-center justify-between px-4 bg-muted/50 border-b border-border select-none">
-                <span className="text-[10px] font-bold text-muted-foreground/90 uppercase tracking-wider">
-                  {(previewMode as string) === 'markdown'
-                    ? t('markdownOutputLabel')
-                    : t('previewLabel')}
-                </span>
-                <div className="flex items-center gap-2">
-                  <span className="text-[10px] font-mono text-muted-foreground/60 tabular-nums">
-                    {t('charCount', { count: result.markdownLength })}
-                  </span>
-                  <CopyButton
-                    text={result.markdown}
-                    className="h-6 w-6 rounded-md border text-muted-foreground"
-                  />
-                </div>
-              </div>
-
-              {(previewMode as string) === 'markdown' ? (
-                <textarea
-                  value={result.markdown}
-                  readOnly
-                  className="flex-1 min-h-[380px] p-4 font-mono text-xs leading-relaxed resize-none focus:outline-none bg-muted/30 dark:bg-muted/10 text-foreground/80 select-text"
-                />
-              ) : (
-                <div className="flex-1 p-4 min-h-[380px] overflow-auto bg-transparent font-mono text-xs leading-relaxed whitespace-pre-wrap break-all text-foreground/90 select-text">
-                  {result.markdown || (
-                    <span className="text-muted-foreground/70 italic text-[11px] font-sans">
-                      {t('emptyHint')}
-                    </span>
-                  )}
-                </div>
-              )}
-            </div>
-          )}
-        </div>
-      </div>
-    </div>
-  );
-}

pages/JsonTools/index.tsx

@@ -1,203 +0,0 @@
-import { useCallback, useEffect, useMemo, useState } from 'react';
-import { useLazyTranslation } from '@/utils/useLazyTranslation';
-import JsonDiffInput from './JsonDiffInput';
-import DiffResult from './DiffResult';
-import DiffNavigator from './DiffNavigator';
-import JsonFormatSection from './JsonFormatSection';
-import type { ConvertFunction } from './JsonConvertSection';
-import JsonConvertSection from './JsonConvertSection';
-import { diffJson } from './diffEngine';
-import { jsonToYaml } from '@/utils/jsonToYaml';
-import { jsonToToml } from '@/utils/jsonToToml';
-import { minifyJson } from '@/utils/jsonFormatter';
-import { useStorageState } from '@/utils/useStorageState';
-import type { JsonToolsPageMode } from '@/types/storage';
-import SwitchButtonGroup from '@/components/SwitchButtonGroup';
-import type { ViewMode } from './types';
-
-interface ParseState {
-  value: unknown;
-  error: string | null;
-}
-
-const tryParse = (raw: string, invalidMsg: string): ParseState => {
-  const trimmed = raw.trim();
-  if (!trimmed) return { value: undefined, error: null };
-  try {
-    return { value: JSON.parse(trimmed), error: null };
-  } catch {
-    return { value: undefined, error: invalidMsg };
-  }
-};
-
-const VALID_PAGE_MODES: readonly JsonToolsPageMode[] = ['diff', 'format', 'yaml', 'toml', 'minify'];
-const isValidPageMode = (val: unknown): val is JsonToolsPageMode =>
-  typeof val === 'string' && (VALID_PAGE_MODES as readonly string[]).includes(val);
-
-type PageMode = JsonToolsPageMode;
-
-export default function Index() {
-  const { t } = useLazyTranslation(['jsonDiff', 'jsonFormat']);
-  const [pageMode, setPageMode] = useStorageState('jsonTools/pageMode', 'diff', isValidPageMode);
-
-  // 1. 受控原始输入源
-  const [leftInput, setLeftInput] = useState('');
-  const [rightInput, setRightInput] = useState('');
-
-  // 2. 纯净的异步防抖管道：仅负责切断高频打字开销
-  const [debouncedLeft, setDebouncedLeft] = useState('');
-  const [debouncedRight, setDebouncedRight] = useState('');
-
-  useEffect(() => {
-    const handle = setTimeout(() => {
-      setDebouncedLeft(leftInput);
-      setDebouncedRight(rightInput);
-    }, 250);
-    return () => clearTimeout(handle);
-  }, [leftInput, rightInput]);
-
-  // 3. 贯彻方案A：利用 useMemo 将防抖文本同步转化为解析树和错误提示
-  const parseState = useMemo(() => {
-    const invalidMsg = t('jsonDiff:invalidJson');
-    return {
-      left: tryParse(debouncedLeft, invalidMsg),
-      right: tryParse(debouncedRight, invalidMsg),
-    };
-  }, [debouncedLeft, debouncedRight, t]);
-
-  const leftError = parseState.left.error;
-  const rightError = parseState.right.error;
-
-  const [viewMode, setViewMode] = useState<ViewMode>('sideBySide');
-  const [currentDiffIndex, setCurrentDiffIndex] = useState(0);
-
-  // 4. 实时比对流式计算
-  const diffResult = useMemo(() => {
-    const { left, right } = parseState;
-    if (left.error || right.error || debouncedLeft.trim() === '' || debouncedRight.trim() === '') {
-      return null;
-    }
-    return diffJson(left.value, right.value);
-  }, [parseState, debouncedLeft, debouncedRight]);
-
-  // 💡 彻底删除了原本在此处的侦听 [diffResult] 的 useEffect。
-  // 状态重置已完全委托给事件源头，级联更新警告从根源上永久自愈！
-
-  const total = diffResult?.diffPaths.length ?? 0;
-
-  const handlePrev = useCallback(() => {
-    if (total === 0) return;
-    setCurrentDiffIndex((idx) => (idx - 1 + total) % total);
-  }, [total]);
-
-  const handleNext = useCallback(() => {
-    if (total === 0) return;
-    setCurrentDiffIndex((idx) => (idx + 1) % total);
-  }, [total]);
-
-  const activePath = diffResult && total > 0 ? diffResult.diffPaths[currentDiffIndex] : undefined;
-
-  const yamlConvert: ConvertFunction = useCallback((text: string) => {
-    const r = jsonToYaml(text);
-    return { output: r.output, originalBytes: r.originalBytes, outputBytes: r.outputBytes };
-  }, []);
-
-  const tomlConvert: ConvertFunction = useCallback((text: string) => {
-    const r = jsonToToml(text);
-    return { output: r.output, originalBytes: r.originalBytes, outputBytes: r.outputBytes };
-  }, []);
-
-  const minifyConvert: ConvertFunction = useCallback((text: string) => {
-    const r = minifyJson(text);
-    return { output: r.minified, originalBytes: r.originalBytes, outputBytes: r.minifiedBytes };
-  }, []);
-
-  return (
-    <div className="p-4 w-full flex flex-col space-y-4 min-h-[500px] select-none animate-in fade-in duration-300">
-      <SwitchButtonGroup
-        value={pageMode}
-        onChange={(v: PageMode) => setPageMode(v)}
-        options={[
-          { value: 'diff', label: t('jsonFormat:diffMode') },
-          { value: 'format', label: t('jsonFormat:formatMode') },
-          { value: 'yaml', label: t('jsonFormat:yamlMode') },
-          { value: 'toml', label: t('jsonFormat:tomlMode') },
-          { value: 'minify', label: t('jsonFormat:minifyMode') },
-        ]}
-        size="small"
-        className="w-full sm:w-auto"
-      />
-
-      {pageMode === 'diff' ? (
-        <div className="flex flex-col space-y-4 animate-in fade-in duration-200">
-          <div className="flex h-10 items-center justify-between px-1.5 bg-secondary/40 rounded-xl border border-border/60">
-            <SwitchButtonGroup
-              value={viewMode}
-              onChange={(v: ViewMode) => setViewMode(v)}
-              options={[
-                { value: 'sideBySide', label: t('jsonDiff:sideBySideMode') },
-                { value: 'unified', label: t('jsonDiff:unifiedMode') },
-              ]}
-              size="small"
-            />
-          </div>
-
-          <div className="flex flex-col md:flex-row gap-4 w-full items-stretch">
-            <JsonDiffInput
-              label={t('jsonDiff:leftLabel')}
-              placeholder={t('jsonDiff:leftPlaceholder')}
-              value={leftInput}
-              onChange={(val) => {
-                setLeftInput(val);
-                setCurrentDiffIndex(0); // 💡 在同一个用户键盘事件中打包批处理，0 副作用开销
-              }}
-              error={leftError}
-              minRows={9}
-            />
-            <JsonDiffInput
-              label={t('jsonDiff:rightLabel')}
-              placeholder={t('jsonDiff:rightPlaceholder')}
-              value={rightInput}
-              onChange={(val) => {
-                setRightInput(val);
-                setCurrentDiffIndex(0); // 💡 在同一个用户键盘事件中打包批处理，0 副作用开销
-              }}
-              error={rightError}
-              minRows={9}
-            />
-          </div>
-
-          {diffResult ? (
-            <div className="flex flex-col space-y-3.5 w-full pt-1">
-              <div className="flex justify-center w-full">
-                <DiffNavigator
-                  total={total}
-                  currentIndex={currentDiffIndex}
-                  onPrev={handlePrev}
-                  onNext={handleNext}
-                />
-              </div>
-              <DiffResult result={diffResult} viewMode={viewMode} activePath={activePath} />
-            </div>
-          ) : (
-            <div className="p-8 rounded-xl bg-muted/30 border border-dashed border-border/80 text-center flex flex-col items-center justify-center min-h-[140px]">
-              <p className="text-xs font-semibold text-muted-foreground/80 tracking-wide max-w-[260px] leading-relaxed">
-                {leftError || rightError
-                  ? '请修正上方 JSON 的语法错误以开启实时流式比对'
-                  : t('jsonDiff:emptyHint')}
-              </p>
-            </div>
-          )}
-        </div>
-      ) : pageMode === 'format' ? (
-        <JsonFormatSection />
-      ) : pageMode === 'yaml' ? (
-        <JsonConvertSection translationPrefix="yaml" convertFunction={yamlConvert} />
-      ) : pageMode === 'toml' ? (
-        <JsonConvertSection translationPrefix="toml" convertFunction={tomlConvert} />
-      ) : (
-        <JsonConvertSection translationPrefix="minify" convertFunction={minifyConvert} />
-      )}
-    </div>
-  );
-}

pages/Jwt/index.tsx

@@ -1,141 +0,0 @@
-import { useCallback, useEffect, useMemo, useState } from 'react';
-import { parseJwt, stringifyJson } from '@/utils/jwt';
-import CopyButton from '@/components/CopyButton';
-import TextInputArea from '@/components/TextInputArea';
-import { useLazyTranslation } from '@/utils/useLazyTranslation';
-import { useContextMenuData } from '@/utils/useContextMenuData';
-import { cn } from '@/lib/utils';
-
-interface SectionProps {
-  title: string;
-  content: unknown;
-  colorClass: string; // 💡 1. 废除硬编码十六进制色值，改用语义化的 Tailwind 类名
-  bgClass: string;
-  borderClass: string;
-}
-
-const Section = ({ title, content, colorClass, bgClass, borderClass }: SectionProps) => {
-  const { t } = useLazyTranslation('jwt');
-  return (
-    <div
-      className={cn('p-4 rounded-xl border border-solid transition-colors', bgClass, borderClass)}
-    >
-      <div className="flex justify-between items-center mb-2 select-none">
-        <span className={cn('text-xs font-bold tracking-wider uppercase', colorClass)}>
-          {title}
-        </span>
-        <CopyButton
-          text={JSON.stringify(content)}
-          className="h-6 w-6 rounded-md border text-muted-foreground"
-        />
-      </div>
-      {/* 💡 排版微距精雕：
-        - 彻底移除 border-black/5 这种非暗黑模式友好的硬隔离。
-        - 统一收拢为标准的 bg-muted/40 配合 font-mono text-xs
-      */}
-      <pre className="m-0 p-3 bg-muted/30 dark:bg-muted/10 rounded-lg text-xs font-mono overflow-x-auto whitespace-pre-wrap break-all border border-border/50 text-foreground/90 leading-relaxed select-text">
-        {content ? stringifyJson(content) : t('jwt:invalidFormat')}
-      </pre>
-    </div>
-  );
-};
-
-export default function Index() {
-  const { t } = useLazyTranslation(['jwt', 'jsonFormat']);
-  const [jwtInput, setJwtInput] = useState('');
-
-  // 2. 防抖中转管道：切断高频键盘敲击时的红色语法闪烁
-  const [debouncedInput, setDebouncedInput] = useState('');
-
-  useEffect(() => {
-    const handle = setTimeout(() => {
-      setDebouncedInput(jwtInput);
-    }, 200);
-    return () => clearTimeout(handle);
-  }, [jwtInput]);
-
-  const handleContextMenuData = useCallback((payload: string) => {
-    const cleaned = payload.replace(/^Bearer\s*/i, '').trim();
-    setJwtInput(cleaned);
-  }, []);
-
-  useContextMenuData({ featureKey: 'jwt', onData: handleContextMenuData });
-
-  // 3. 贯彻方案 A：衍生变量流。直接消费防抖后的文本
-  const result = useMemo(() => {
-    if (!debouncedInput.trim()) {
-      return null;
-    }
-    return parseJwt(debouncedInput);
-  }, [debouncedInput]);
-
-  return (
-    <div className="p-4 w-full flex flex-col space-y-4 animate-in fade-in duration-300 select-none">
-      <div className="flex flex-col gap-4">
-        {/* 输入终端 */}
-        <TextInputArea
-          minRows={5}
-          maxRows={10}
-          placeholder={t('jwt:placeholder')}
-          value={jwtInput}
-          onChange={(val) => {
-            const cleaned = val.replace(/^Bearer\s*/i, '').trim();
-            setJwtInput(cleaned);
-          }}
-          allowCopy={true}
-          showClear={true}
-          externalError={result?.error || undefined}
-          onClear={() => setJwtInput('')}
-        />
-
-        {/* 解码看板结果展现 */}
-        {result && !result.error && (
-          <div className="flex flex-col gap-4 animate-in slide-in-from-bottom-2 duration-300">
-            {/* Header 分区：完美致敬 JWT.io 的鲜艳色彩，同时实现黑夜暗化自适应 */}
-            <Section
-              title={t('jwt:headerTitle')}
-              content={result.header}
-              colorClass="text-[#fb015b] dark:text-rose-400"
-              borderClass="border-[#fb015b]/20 dark:border-rose-500/20"
-              bgClass="bg-[#fb015b]/5 dark:bg-rose-500/5"
-            />
-
-            {/* Payload 分区 */}
-            <Section
-              title={t('jwt:payloadTitle')}
-              content={result.payload}
-              colorClass="text-[#a03aff] dark:text-purple-400" // 针对暗黑模式略微调高对比度
-              borderClass="border-[#a03aff]/20 dark:border-purple-500/20"
-              bgClass="bg-[#a03aff]/5 dark:bg-purple-500/5"
-            />
-
-            {/* Signature 签名区：完全对齐标准的 shadcn 骨架阶度 */}
-            <div className="p-4 rounded-xl border border-border bg-secondary/40 shadow-sm transition-colors">
-              <div className="flex justify-between items-center mb-2">
-                <span className="text-xs font-bold tracking-wider text-muted-foreground/90 uppercase">
-                  {t('jwt:signatureTitle')}
-                </span>
-                <CopyButton
-                  text={result.signature || ''}
-                  className="h-6 w-6 rounded-md border text-muted-foreground"
-                />
-              </div>
-              <span className="block text-xs font-mono break-all text-foreground/80 bg-muted/30 dark:bg-muted/10 p-3 rounded-lg border border-border/50 leading-relaxed select-text">
-                {result.signature || t('jwt:noSignature')}
-              </span>
-            </div>
-          </div>
-        )}
-
-        {/* 当解析错误时的干净中性引导拦截 */}
-        {result?.error && (
-          <div className="p-6 rounded-xl bg-muted/30 border border-dashed border-border text-center">
-            <p className="text-xs font-semibold text-muted-foreground/80">
-              {t('jsonFormat:invalidJson')}
-            </p>
-          </div>
-        )}
-      </div>
-    </div>
-  );
-}

pages/MarkdownToHtml/index.tsx

@@ -1,303 +0,0 @@
-import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
-import { Download, Printer, Trash2 } from 'lucide-react';
-import { useLazyTranslation } from '@/utils/useLazyTranslation';
-import CopyButton from '@/components/CopyButton';
-import SwitchButtonGroup from '@/components/SwitchButtonGroup';
-import { Button } from '@/components/ui/button';
-import { useStorageState } from '@/utils/useStorageState';
-import type { MarkdownToHtmlPreviewMode } from '@/types/storage';
-import {
-  downloadHtmlFile,
-  markdownToHtml,
-  printHtml,
-  SAMPLE_MARKDOWN,
-  wrapHtmlDocument,
-} from '@/utils/markdownToHtml';
-import { cn } from '@/lib/utils';
-
-const isValidPreviewMode = (val: unknown): val is MarkdownToHtmlPreviewMode =>
-  typeof val === 'string' && ['split', 'preview', 'html'].includes(val);
-
-// 💡 规范回归：保持最纯净的通用选择器集合，内部变量全部交由全局 :root 驱动
-const PREVIEW_STYLES = `
-  .markdown-body {
-    font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
-    line-height: 1.6;
-    color: var(--md-foreground);
-    background-color: transparent;
-    font-size: 14px;
-  }
-  .markdown-body h1, .markdown-body h2, .markdown-body h3 {
-    margin-top: 24px;
-    margin-bottom: 16px;
-    font-weight: 600;
-    line-height: 1.25;
-    color: var(--md-foreground);
-  }
-  .markdown-body h1 { border-bottom: 1px solid var(--md-border); padding-bottom: 0.3em; font-size: 1.6em; }
-  .markdown-body h2 { border-bottom: 1px solid var(--md-border); padding-bottom: 0.3em; font-size: 1.35em; }
-  .markdown-body p { margin-top: 0; margin-bottom: 16px; }
-  .markdown-body a { color: #3b82f6; text-decoration: none; }
-  .markdown-body a:hover { text-decoration: underline; }
-  .markdown-body code {
-    background-color: var(--md-code-bg);
-    border-radius: 4px;
-    font-size: 85%;
-    padding: 0.2em 0.4em;
-    font-family: Menlo, Consolas, monospace;
-  }
-  .markdown-body pre {
-    background-color: var(--md-pre-bg);
-    border-radius: 8px;
-    font-size: 85%;
-    line-height: 1.45;
-    overflow: auto;
-    padding: 16px;
-    margin: 0 0 16px;
-    border: 1px solid var(--md-border);
-  }
-  .markdown-body pre code {
-    background-color: transparent;
-    border: 0;
-    padding: 0;
-  }
-  .markdown-body blockquote {
-    border-left: 0.25em solid var(--md-quote-line);
-    color: var(--md-muted);
-    margin: 0 0 16px;
-    padding: 0 1em;
-  }
-  .markdown-body table {
-    border-collapse: collapse;
-    width: 100%;
-    margin-bottom: 16px;
-    font-size: 13px;
-  }
-  .markdown-body table th, .markdown-body table td {
-    border: 1px solid var(--md-border);
-    padding: 6px 13px;
-  }
-  .markdown-body table tr:nth-child(2n) { background-color: var(--md-code-bg); }
-  .markdown-body table th { font-weight: 600; background-color: var(--md-code-bg); }
-`;
-
-export default function MarkdownToHtmlPage() {
-  const { t } = useLazyTranslation('markdownToHtml');
-  const [previewMode, setPreviewMode] = useStorageState(
-    'markdownToHtml/previewMode',
-    'split' as MarkdownToHtmlPreviewMode,
-    isValidPreviewMode,
-  );
-  const [markdown, setMarkdown] = useState(SAMPLE_MARKDOWN);
-  const iframeRef = useRef<HTMLIFrameElement>(null);
-
-  const result = useMemo(() => markdownToHtml(markdown), [markdown]);
-  const error = result.hasError ? (result.error ?? null) : null;
-
-  // 💡 自适应大总管：以极高严谨度拼装明暗大闸，用标准换行切断粘连风险
-  useEffect(() => {
-    const iframe = iframeRef.current;
-    if (!iframe) return;
-
-    const isDarkMode = document.documentElement.classList.contains('dark');
-
-    const themeVariables = isDarkMode
-      ? `:root { 
-          --md-bg: #090d16;
-          --md-foreground: #e6edf3; 
-          --md-border: rgba(255,255,255,0.15); 
-          --md-code-bg: rgba(255,255,255,0.12); 
-          --md-pre-bg: rgba(255,255,255,0.04); 
-          --md-muted: #8b949e;
-          --md-quote-line: rgba(255,255,255,0.25);
-        }`
-      : `:root { 
-          --md-bg: #ffffff;
-          --md-foreground: #1f2328; 
-          --md-border: rgba(128,128,128,0.2); 
-          --md-code-bg: rgba(128,128,128,0.08); 
-          --md-pre-bg: rgba(128,128,128,0.03); 
-          --md-muted: #4b5563;
-          --md-quote-line: rgba(128,128,128,0.3);
-        }`;
-
-    // 💡 3. 核心大清洗：将全局基础树（html, body）与派生样式完全独立硬编码，杜绝任何语法踩踏
-    const baseGlobalStyles = `
-      html, body { 
-        margin: 0; 
-        padding: 0;
-        width: 100%;
-        height: 100%;
-        background-color: var(--md-bg);
-        color: var(--md-foreground);
-      }
-      body {
-        padding: 16px;
-        box-sizing: border-box;
-      }
-    `;
-
-    iframe.srcdoc = `<!DOCTYPE html>
-<html lang="zh" style="background-color: ${isDarkMode ? '#090d16' : '#ffffff'};">
-<head>
-<meta charset="UTF-8">
-<style>
-  ${themeVariables}
-  ${PREVIEW_STYLES}
-  ${baseGlobalStyles}
-</style>
-</head>
-<body class="markdown-body">${result.html}</body>
-</html>`;
-  }, [result.html, previewMode]);
-
-  const handleModeChange = useCallback(
-    (newMode: MarkdownToHtmlPreviewMode) => {
-      setPreviewMode(newMode);
-    },
-    [setPreviewMode],
-  );
-
-  const handleClear = useCallback(() => {
-    setMarkdown('');
-  }, []);
-
-  const handlePrint = useCallback(() => {
-    printHtml(result.html, t('pageTitle'));
-  }, [result.html, t]);
-
-  const handleDownload = useCallback(() => {
-    const doc = wrapHtmlDocument(result.html, t('pageTitle'));
-    downloadHtmlFile(doc, 'markdown-export.html');
-  }, [result.html, t]);
-
-  const showInput = previewMode !== 'preview';
-  const showPreview = previewMode !== 'html';
-
-  return (
-    <div className="p-4 w-full flex flex-col space-y-4 select-none animate-in fade-in duration-300">
-      <div className="flex flex-col space-y-4">
-        {/* 工具集成控制中枢 */}
-        <div className="flex flex-col sm:flex-row gap-3 justify-between items-stretch sm:items-center bg-secondary/40 rounded-xl border border-border/60 px-1.5 py-1.5 sm:h-12">
-          <SwitchButtonGroup
-            value={previewMode}
-            options={[
-              { value: 'split', label: t('splitMode') },
-              { value: 'preview', label: t('previewMode') },
-              { value: 'html', label: t('htmlMode') },
-            ]}
-            onChange={handleModeChange}
-            size="small"
-            className="w-full sm:w-auto"
-          />
-
-          <div className="flex gap-2 shrink-0">
-            <Button
-              variant="outline"
-              size="sm"
-              onClick={handleClear}
-              className="h-8 rounded-md font-medium text-xs gap-1.5 shadow-sm active:scale-95 text-destructive hover:text-destructive hover:bg-destructive/5 dark:hover:bg-destructive/10 border-input/60 transition-all"
-            >
-              <Trash2 className="h-3.5 w-3.5" />
-              {t('clear')}
-            </Button>
-            <Button
-              variant="outline"
-              size="sm"
-              onClick={handlePrint}
-              disabled={!result.html}
-              className="h-8 rounded-md font-medium text-xs gap-1.5 shadow-sm active:scale-95 transition-all"
-            >
-              <Printer className="h-3.5 w-3.5" />
-              {t('print')}
-            </Button>
-            <Button
-              variant="outline"
-              size="sm"
-              onClick={handleDownload}
-              disabled={!result.html}
-              className="h-8 rounded-md font-medium text-xs gap-1.5 shadow-sm active:scale-95 transition-all"
-            >
-              <Download className="h-3.5 w-3.5" />
-              {t('download')}
-            </Button>
-          </div>
-        </div>
-
-        {/* 错误拦截提示框 */}
-        {error && (
-          <div
-            role="alert"
-            className="p-3.5 bg-destructive/10 border border-destructive/20 rounded-xl text-destructive text-xs font-semibold tracking-wide animate-in shake duration-300"
-          >
-            {error}
-          </div>
-        )}
-
-        {/* 主框架多栏联动排版轴 */}
-        <div
-          className={cn(
-            'grid gap-4 min-h-[480px] w-full',
-            showInput && showPreview ? 'grid-cols-1 md:grid-cols-2' : 'grid-cols-1',
-          )}
-        >
-          {/* Markdown 输入翼终端 */}
-          {showInput && (
-            <div className="border border-border rounded-xl bg-card text-card-foreground shadow-sm overflow-hidden flex flex-col transition-all duration-200 focus-within:ring-1 focus-within:ring-ring focus-within:border-ring animate-in fade-in">
-              <div className="flex h-9 items-center justify-between px-4 bg-muted/50 border-b border-border select-none">
-                <span className="text-[10px] font-bold text-muted-foreground/90 uppercase tracking-wider">
-                  {t('inputLabel')}
-                </span>
-                <span className="text-[10px] font-mono text-muted-foreground/60 tabular-nums">
-                  {t('charCount', { count: markdown.length })}
-                </span>
-              </div>
-              <textarea
-                value={markdown}
-                onChange={(e) => setMarkdown(e.target.value)}
-                placeholder={t('inputPlaceholder')}
-                className="flex-1 min-h-[390px] p-4 bg-transparent font-mono text-xs leading-relaxed resize-none focus:outline-none text-foreground/90 select-text"
-              />
-            </div>
-          )}
-
-          {/* 实时 HTML/Iframe 预览翼终端 */}
-          {showPreview && (
-            <div className="border border-border rounded-xl bg-card text-card-foreground shadow-sm overflow-hidden flex flex-col animate-in fade-in">
-              <div className="flex h-9 items-center justify-between px-4 bg-muted/50 border-b border-border select-none">
-                <span className="text-[10px] font-bold text-muted-foreground/90 uppercase tracking-wider">
-                  {(previewMode as string) === 'html' ? t('htmlOutputLabel') : t('previewLabel')}
-                </span>
-                <div className="flex items-center gap-2">
-                  <span className="text-[10px] font-mono text-muted-foreground/60 tabular-nums">
-                    {t('charCount', { count: result.htmlLength })}
-                  </span>
-                  <CopyButton
-                    text={result.html}
-                    className="h-6 w-6 rounded-md border text-muted-foreground"
-                  />
-                </div>
-              </div>
-
-              {(previewMode as string) === 'html' ? (
-                <textarea
-                  value={result.html}
-                  readOnly
-                  className="flex-1 min-h-[390px] p-4 font-mono text-xs leading-relaxed resize-none focus:outline-none bg-muted/30 dark:bg-muted/10 text-foreground/80 select-text"
-                />
-              ) : (
-                <div className="flex-1 min-h-[390px] overflow-hidden bg-transparent">
-                  <iframe
-                    ref={iframeRef}
-                    title="markdown-preview"
-                    className="w-full h-full min-h-[360px] border-none bg-transparent"
-                  />
-                </div>
-              )}
-            </div>
-          )}
-        </div>
-      </div>
-    </div>
-  );
-}

pages/QrCode/__tests__/index.test.tsx

@@ -1,98 +0,0 @@
-import { beforeEach, describe, expect, it, vi } from 'vitest';
-import { fireEvent, render, screen } from '@testing-library/react';
-import QrCodePage from '../index';
-
-vi.mock('lucide-react', async (importOriginal) => {
-  const actual = await importOriginal<typeof import('lucide-react')>();
-  return {
-    ...actual,
-    // 增量伪造需要高精嗅探的 QrCode 核心定位图标
-    QrCode: () => <div data-testid="mock-lucide-qrcode">Icon</div>,
-  };
-});
-
-// Mock useLazyTranslation
-vi.mock('@/utils/useLazyTranslation', () => ({
-  useLazyTranslation: () => ({
-    t: (key: string) => key,
-    i18n: { changeLanguage: vi.fn(), language: 'zh-CN' },
-    isLoaded: true,
-  }),
-}));
-
-// Mock useSnackbar
-vi.mock('@/components/GlobalSnackbar', () => ({
-  useSnackbar: () => ({
-    showMessage: vi.fn(),
-  }),
-}));
-
-// Mock getEntryPointType（保留原厂其他特征配置，仅模拟入口路由环境）
-vi.mock('@/config/features', async (importOriginal) => {
-  const actual = await importOriginal<typeof import('@/config/features')>();
-  return {
-    ...actual,
-    getEntryPointType: () => 'sidepanel',
-  };
-});
-
-// Mock 高频变化的子组件，收拢断言边界
-vi.mock('@/components/QrCodePreview', () => ({
-  default: () => <div data-testid="qr-code-preview">QrCodePreview</div>,
-}));
-
-vi.mock('@/components/ImageUploader', () => ({
-  default: () => <div data-testid="image-uploader">ImageUploader</div>,
-}));
-
-// Mock QRious 动态图像离屏生成引擎
-vi.mock('qrious', () => ({
-  default: vi.fn().mockImplementation(() => ({
-    toDataURL: () => 'data:image/png;base64,mock',
-  })),
-}));
-
-describe('QrCodePage', () => {
-  beforeEach(() => {
-    vi.clearAllMocks();
-  });
-
-  it('应该默认渲染生成模式', () => {
-    render(<QrCodePage />);
-    expect(screen.getByTestId('qr-code-preview')).toBeInTheDocument();
-  });
-
-  it('应该渲染模式切换按钮', () => {
-    render(<QrCodePage />);
-    expect(screen.getByText('qrCode:urlToQr')).toBeInTheDocument();
-    expect(screen.getByText('qrCode:qrToUrl')).toBeInTheDocument();
-  });
-
-  it('切换到解析模式应该渲染 ImageUploader', () => {
-    render(<QrCodePage />);
-    fireEvent.click(screen.getByText('qrCode:qrToUrl'));
-    expect(screen.getByTestId('image-uploader')).toBeInTheDocument();
-    expect(screen.queryByTestId('qr-code-preview')).not.toBeInTheDocument();
-  });
-
-  it('切换回生成模式应该渲染 QrCodePreview', () => {
-    render(<QrCodePage />);
-    // 先切换到解析模式
-    fireEvent.click(screen.getByText('qrCode:qrToUrl'));
-    expect(screen.getByTestId('image-uploader')).toBeInTheDocument();
-    // 再切换回生成模式
-    fireEvent.click(screen.getByText('qrCode:urlToQr'));
-    expect(screen.getByTestId('qr-code-preview')).toBeInTheDocument();
-  });
-
-  it('应该渲染输入区域的系统标签（对齐新版 Label 机制）', () => {
-    render(<QrCodePage />);
-    expect(screen.getByText('qrCode:urlInputLabel')).toBeInTheDocument();
-  });
-
-  it('应该渲染双翼响应式卡片网格布局', () => {
-    const { container } = render(<QrCodePage />);
-    const gridContainer = container.querySelector('.grid');
-    expect(gridContainer).toBeInTheDocument();
-  });
-});

pages/QrCode/components/GeneratePanel.tsx

@@ -1,57 +0,0 @@
-import TextInputArea from '@/components/TextInputArea';
-import QrCodePreview from '@/components/QrCodePreview';
-import { useLazyTranslation } from '@/utils/useLazyTranslation';
-import { useQrCodeContext } from '../contexts/QrCodeContext';
-import { Label } from '@/components/ui/label';
-import { cn } from '@/lib/utils';
-
-export default function GeneratePanel() {
-  const { t } = useLazyTranslation('qrCode');
-  const { generatorState, setTextToEncode, downloadQrCode, copyQrCode } = useQrCodeContext();
-
-  return (
-    <div className="grid grid-cols-1 md:grid-cols-2 gap-6 w-full items-stretch select-none p-0.5 animate-in fade-in duration-300">
-      {/* 左翼：高性能受控输入翼终端 */}
-      <div
-        className={cn(
-          'border border-border rounded-xl bg-card text-card-foreground shadow-sm flex flex-col p-4 transition-all duration-200',
-          'focus-within:ring-1 focus-within:ring-ring focus-within:border-ring',
-        )}
-      >
-        {/* 💡 2. 独立外置标签架（A11y 无障碍对齐）：
-           - 彻底删掉 TextInputArea 上引发崩溃的违规属性。
-           - 改用正统的 <Label />，并注入标准的高度无障碍样式，间距比例极度平滑。
-        */}
-        <div className="flex flex-col space-y-2.5 h-full">
-          <Label className="text-[10px] font-bold text-muted-foreground/90 uppercase tracking-wider select-none pl-0.5">
-            {t('qrCode:urlInputLabel')}
-          </Label>
-
-          <div className="flex-1 min-h-0">
-            <TextInputArea
-              value={generatorState.textToEncode}
-              onChange={setTextToEncode}
-              placeholder={t('qrCode:urlInputPlaceholder')}
-              showCount={true}
-              showClear={true}
-              allowCopy={true}
-              minRows={6}
-              maxRows={12}
-              externalError={generatorState.inputError || undefined}
-              onClear={() => setTextToEncode('')}
-            />
-          </div>
-        </div>
-      </div>
-
-      {/* 右翼：活态二维码高精生成区 */}
-      <div className="flex flex-col h-full">
-        <QrCodePreview
-          qrCodeDataUrl={generatorState.qrCodeDataUrl}
-          onDownload={downloadQrCode}
-          onCopy={copyQrCode}
-        />
-      </div>
-    </div>
-  );
-}

pages/QrCode/hooks/useQrCode.ts

@@ -1,207 +0,0 @@
-import { useCallback, useMemo, useState } from 'react';
-import QRious from 'qrious';
-import { useSnackbar } from '@/components/GlobalSnackbar';
-import { parseQrCodeFromFile } from '@/utils/qrCodeParser';
-import { useContextMenuData } from '@/utils/useContextMenuData';
-import { useLazyTranslation } from '@/utils/useLazyTranslation';
-import { useDebounce } from '@/utils/useDebounce';
-import type { QrCodeContextValue } from '../contexts/QrCodeContext';
-import type { QrCodeGeneratorState, QrCodeMode, QrCodeParserState } from '../types';
-
-export function useQrCode(): QrCodeContextValue {
-  const { t } = useLazyTranslation('qrCode');
-  const { showMessage } = useSnackbar();
-
-  // 核心路由视图模式
-  const [mode, setMode] = useState<QrCodeMode>('generate');
-
-  // 1. 生成器状态流（大幅瘦身：剔除 generating 状态）
-  const [generatorState, setGeneratorState] = useState<
-    Omit<QrCodeGeneratorState, 'generating' | 'qrCodeDataUrl'>
-  >({
-    textToEncode: '',
-    inputError: '',
-  });
-
-  // 2. 解析器状态流
-  const [parserState, setParserState] = useState<QrCodeParserState>({
-    decodedResult: '',
-    parsing: false,
-    parseError: '',
-    selectedFile: null,
-    previewUrl: '',
-    dragging: false,
-  });
-
-  // 3. 高频打字极速防抖
-  const debouncedTextToEncode = useDebounce(generatorState.textToEncode, 200);
-
-  // 💡 4. 贯彻方案 A（无副作用超导管线）：
-  // 彻底删除原有的 generateQrCodeRef、3个 useEffect、1个 useRef 以及相关的复杂状态机。
-  // 二维码画布纯粹作为防抖文本的派生变量同步算出，0重绘死循环风险，体验平滑如镜！
-  const qrCodeDataUrl = useMemo(() => {
-    const text = debouncedTextToEncode.trim();
-    if (!text) return '';
-
-    try {
-      let url = text;
-      if (!url.startsWith('http://') && !url.startsWith('https://')) {
-        url = 'https://' + url;
-      }
-
-      // 💡 暗黑模式自适应大闸：实时嗅探系统 DOM 阶度
-      const isDark = document.documentElement.classList.contains('dark');
-
-      const qr = new QRious({
-        value: url,
-        size: 260,
-        level: 'H',
-        // 暗黑模式下使用透明底、月白前景色；白天模式下使用标准现代黑白配
-        foreground: isDark ? '#f3f4f6' : '#0f172a',
-        background: isDark ? 'transparent' : '#ffffff',
-      });
-
-      return qr.toDataURL();
-    } catch (error) {
-      console.error('QR code generation sync task failed:', error);
-      return '';
-    }
-  }, [debouncedTextToEncode]);
-
-  // 融合派生数据至完整状态体，满足外部组件强类型契合
-  const fullGeneratorState = useMemo<QrCodeGeneratorState>(
-    () => ({
-      ...generatorState,
-      qrCodeDataUrl,
-      generating: false,
-    }),
-    [generatorState, qrCodeDataUrl],
-  );
-
-  // 设置输入文本
-  const setTextToEncode = useCallback((text: string) => {
-    setGeneratorState((prev) => ({ ...prev, textToEncode: text, inputError: '' }));
-  }, []);
-
-  // 处理右键菜单数据上下文
-  const handleContextMenuData = useCallback((payload: string) => {
-    setMode('generate');
-    setGeneratorState((prev) => ({ ...prev, textToEncode: payload, inputError: '' }));
-  }, []);
-
-  useContextMenuData({ featureKey: 'qrCode', onData: handleContextMenuData });
-
-  // 反向活态解析二维码算法
-  const parseQrCode = useCallback(
-    async (file: File) => {
-      try {
-        setParserState((prev) => ({ ...prev, parsing: true, parseError: '', decodedResult: '' }));
-
-        const result = await parseQrCodeFromFile(file);
-
-        if (result.success && result.data) {
-          setParserState((prev) => ({ ...prev, decodedResult: result.data! }));
-          showMessage(t('qrCode:parseSuccess'), { severity: 'success', autoHideDuration: 1000 });
-        } else {
-          const errorMsg = result.error || t('qrCode:noQrDetected');
-          setParserState((prev) => ({ ...prev, parseError: errorMsg }));
-          showMessage(errorMsg, { severity: 'error', autoHideDuration: 3000 });
-        }
-      } catch (error) {
-        console.error('解析二维码失败:', error);
-        const errorMsg = error instanceof Error ? error.message : t('qrCode:parseError');
-        setParserState((prev) => ({ ...prev, parseError: errorMsg }));
-        showMessage(errorMsg, { severity: 'error', autoHideDuration: 3000 });
-      } finally {
-        setParserState((prev) => ({ ...prev, parsing: false }));
-      }
-    },
-    [t, showMessage],
-  );
-
-  // 下载二维码
-  const downloadQrCode = useCallback(() => {
-    if (!qrCodeDataUrl) return;
-
-    const link = document.createElement('a');
-    link.href = qrCodeDataUrl;
-    link.download = 'qrcode.png';
-    link.click();
-    showMessage(t('qrCode:qrCodeDownloadSuccess'), { severity: 'success', autoHideDuration: 1000 });
-  }, [qrCodeDataUrl, showMessage, t]);
-
-  // 复制二维码至剪贴板
-  const copyQrCode = useCallback(async () => {
-    if (!qrCodeDataUrl) return;
-
-    try {
-      const response = await fetch(qrCodeDataUrl);
-      const blob = await response.blob();
-
-      await navigator.clipboard.write([
-        new ClipboardItem({
-          'image/png': blob,
-        }),
-      ]);
-
-      showMessage(t('qrCode:qrCodeCopySuccess'), { severity: 'success', autoHideDuration: 1000 });
-    } catch (error) {
-      console.error('复制二维码失败:', error);
-      showMessage(t('qrCode:copyError'), { severity: 'error', autoHideDuration: 3000 });
-    }
-  }, [qrCodeDataUrl, showMessage, t]);
-
-  // 处理文件选择
-  const handleFileChange = useCallback(
-    (file: File) => {
-      setParserState((prev) => {
-        if (prev.previewUrl) {
-          URL.revokeObjectURL(prev.previewUrl);
-        }
-        return {
-          ...prev,
-          selectedFile: file,
-          previewUrl: URL.createObjectURL(file),
-          decodedResult: '',
-          parseError: '',
-        };
-      });
-
-      // 触发解析安全的后台 Promise
-      parseQrCode(file).catch((err) => {
-        console.error('Parser standalone task thread exploded:', err);
-      });
-    },
-    [parseQrCode],
-  );
-
-  // 清除解析受控文件
-  const handleClearFile = useCallback(() => {
-    setParserState((prev) => {
-      if (prev.previewUrl) {
-        URL.revokeObjectURL(prev.previewUrl);
-      }
-      return {
-        ...prev,
-        selectedFile: null,
-        previewUrl: '',
-        decodedResult: '',
-        parseError: '',
-      };
-    });
-  }, []);
-
-  return {
-    mode,
-    setMode,
-    generatorState: fullGeneratorState,
-    setTextToEncode,
-    parseQrCode,
-    downloadQrCode,
-    copyQrCode,
-    parserState,
-    setParserState,
-    handleFileChange,
-    handleClearFile,
-  };
-}

pages/StorageCleaner/OptionItem.tsx

@@ -1,81 +0,0 @@
-import React from 'react';
-import { formatSize } from '@/utils/storageCleaner';
-import { useLazyTranslation } from '@/utils/useLazyTranslation';
-import { cn } from '@/lib/utils';
-// 引入官方的 Checkbox 原子组件
-import { Checkbox } from '@/components/ui/checkbox';
-
-interface OptionItemProps extends React.HTMLAttributes<HTMLDivElement> {
-  labelKey: string;
-  checked: boolean;
-  size?: number;
-  isCount?: boolean;
-  onChange: () => void;
-}
-
-export default function OptionItem({
-  labelKey,
-  checked,
-  size,
-  isCount = false,
-  onChange,
-  className,
-  ...props
-}: OptionItemProps) {
-  const { t } = useLazyTranslation('storageCleaner');
-
-  return (
-    <div
-      // 3. 跨越级交互升级：将外部容器升级为一个高度敏感的可点击 Tab 热区
-      onClick={onChange}
-      className={cn(
-        'flex justify-between items-center py-2.5 px-3.5 rounded-xl border cursor-pointer select-none transition-all duration-200',
-        // 4. 彻底抛弃硬编码黄底：
-        // - 选中时：使用 bg-primary/5 (系统主色超淡叠加) 配合标准 border-primary/30。
-        // - 未选中时：保持透明 border-transparent，悬停呈现 bg-muted。
-        // 这样在暗黑模式下会自动无缝混色，极为深邃、高级。
-        checked
-          ? 'bg-primary/5 border-primary/30 shadow-sm'
-          : 'bg-transparent border-transparent hover:bg-muted/70',
-        className,
-      )}
-      {...props}
-    >
-      {/* 左侧数据区域 */}
-      <div className="flex-1 min-w-0 mr-4">
-        <span
-          className={cn(
-            'block text-xs font-semibold leading-tight truncate transition-colors',
-            checked ? 'text-foreground font-bold' : 'text-foreground/80',
-          )}
-        >
-          {t(labelKey)}
-        </span>
-
-        {/* 底部容量大小或计数标识 */}
-        {size !== undefined && size > 0 ? (
-          <span className="block text-[10px] font-mono font-medium text-muted-foreground/80 mt-0.5 tabular-nums">
-            {isCount ? `${size} ${t('storageCleaner:countUnit')}` : formatSize(size)}
-          </span>
-        ) : (
-          <span className="block text-[10px] font-medium text-muted-foreground/60 mt-0.5 italic">
-            {t('storageCleaner:noData')}
-          </span>
-        )}
-      </div>
-
-      {/* 5. 超进化：全面替换原生 input 标签
-        完美调用 shadcn 的 Checkbox 组件。它自带全站统一的主色（Primary）、
-        打钩选中时的平滑微放大缩放动效（Scale Animation），
-        并且阻止冒泡，防范与外层的全局覆盖点击事件产生双重冲突。
-      */}
-      <Checkbox
-        checked={checked}
-        // 阻止 Checkbox 自身的点击事件冒泡，因为外层 div 已经代理了点击逻辑
-        onClick={(e) => e.stopPropagation()}
-        onCheckedChange={onChange}
-        className="h-4 w-4 shrink-0 rounded border-input data-[state=checked]:bg-primary data-[state=checked]:text-primary-foreground"
-      />
-    </div>
-  );
-}

pages/StorageCleaner/StorageOptionsGrid.tsx

@@ -1,98 +0,0 @@
-import React from 'react';
-import type { StorageCleanerOptions } from '@/types/storage';
-import OptionItem from './OptionItem';
-import { useLazyTranslation } from '@/utils/useLazyTranslation';
-import { cn } from '@/lib/utils';
-// 1. 引入官方标准的 Checkbox 原子组件
-import { Checkbox } from '@/components/ui/checkbox';
-import { Label } from '@/components/ui/label';
-
-interface StorageOptionsGridProps extends React.HTMLAttributes<HTMLDivElement> {
-  options: StorageCleanerOptions;
-  sizes: Record<string, number>;
-  allSelected: boolean;
-  someSelected: boolean; // 重新激活半选状态
-  onOptionChange: (key: keyof StorageCleanerOptions) => void;
-  onSelectAll: (checked: boolean) => void;
-}
-
-export default function StorageOptionsGrid({
-  options,
-  sizes,
-  allSelected,
-  someSelected,
-  onOptionChange,
-  onSelectAll,
-  className,
-  ...props
-}: StorageOptionsGridProps) {
-  const { t } = useLazyTranslation('storageCleaner');
-
-  const optionKeys: { key: keyof StorageCleanerOptions; isCount?: boolean }[] = [
-    { key: 'localStorage' },
-    { key: 'sessionStorage' },
-    { key: 'indexedDB' },
-    { key: 'cookies' },
-    { key: 'cacheStorage', isCount: true },
-    { key: 'serviceWorkers', isCount: true },
-  ];
-
-  // 2. 处理全选栏点击事件：包裹整个栏变成超级热区
-  const handleToggleAll = () => {
-    // 如果当前已经是全选，点击则取消全选；否则，点击就是全选
-    onSelectAll(!allSelected);
-  };
-
-  return (
-    <div
-      className={cn(
-        'w-full rounded-xl border border-border bg-card text-card-foreground shadow-sm overflow-hidden transition-all',
-        className,
-      )}
-      {...props}
-    >
-      {/* 核心网格区 */}
-      <div className="p-3">
-        {/* 💡 优化点：加入 items-stretch，确保左右卡片高度绝对对齐 */}
-        <div className="grid grid-cols-2 gap-2.5 items-stretch">
-          {optionKeys.map(({ key, isCount }) => (
-            /* 💡 终极修复：直接把 key 挂在 OptionItem 上，移除了无意义的包裹 div */
-            <OptionItem
-              key={key}
-              labelKey={`storageCleaner:options.${key}`}
-              checked={options[key]}
-              size={sizes[key]}
-              isCount={isCount}
-              onChange={() => onOptionChange(key)}
-            />
-          ))}
-        </div>
-      </div>
-
-      {/* 3. 全选功能底护栏超进化：
-        - 整体赋予 cursor-pointer 和 onClick，点击一整行都能触发全选。
-        - 悬停时自动变色提示可点击 (hover:bg-muted/50)。
-      */}
-      <div
-        onClick={handleToggleAll}
-        className="border-t border-border flex justify-between items-center px-4 py-2.5 bg-muted/20 hover:bg-muted/50 transition-colors cursor-pointer select-none"
-      >
-        <Label className="text-xs font-bold text-muted-foreground/90 cursor-pointer">
-          {t('storageCleaner:selectAll')}
-        </Label>
-
-        {/* 4. 降维打击：调用标准的 shadcn/ui Checkbox
-          - 阻止冒泡：防止事件重复触发。
-          - 完美注入半选逻辑：当 allSelected 为 false 但 someSelected 为 true 时，
-            组件会自动呈现优雅的 "—" (减号) 半选视觉状态，向主流系统控制台高标准看齐！
-        */}
-        <Checkbox
-          checked={allSelected ? true : someSelected ? 'indeterminate' : false}
-          onClick={(e) => e.stopPropagation()}
-          onCheckedChange={(checked) => onSelectAll(checked === true)}
-          className="h-4 w-4 shrink-0 rounded border-input data-[state=checked]:bg-primary data-[state=indeterminate]:bg-primary"
-        />
-      </div>
-    </div>
-  );
-}

pages/StorageCleaner/index.tsx

@@ -1,92 +0,0 @@
-import { Loader2 } from 'lucide-react'; // 引入标准的高级阻尼 Spinner 图标
-import { Button } from '@/components/ui/button';
-import StorageCleanerConfirm from '@/pages/StorageCleaner/StorageCleanerConfirm';
-import { useStorageCleaner } from './useStorageCleaner';
-import StorageOptionsGrid from './StorageOptionsGrid';
-import AutoRefreshToggle from './AutoRefreshToggle';
-import ErrorDisplay from './ErrorDisplay';
-import CleaningResult from './CleaningResult';
-import { useLazyTranslation } from '@/utils/useLazyTranslation';
-
-export default function Index() {
-  const { t } = useLazyTranslation('storageCleaner');
-
-  const {
-    error,
-    isInitializing,
-    options,
-    sizes,
-    reloadAfterClean,
-    loading,
-    result,
-    showConfirm,
-    setShowConfirm,
-    allSelected,
-    someSelected,
-    handleReloadAfterCleanChange,
-    handleOptionChange,
-    handleSelectAll,
-    handleClean,
-  } = useStorageCleaner();
-
-  const isButtonDisabled = !(someSelected || allSelected) || loading;
-
-  if (isInitializing) {
-    return (
-      <div className="flex flex-col items-center justify-center py-12 min-h-[280px] w-full animate-in fade-in duration-200">
-        <Loader2 className="h-6 w-6 animate-spin text-muted-foreground/80" />
-        <span className="text-xs text-muted-foreground mt-2 font-medium tracking-wide">
-          正在读取站点数据...
-        </span>
-      </div>
-    );
-  }
-
-  if (error) {
-    return <ErrorDisplay error={error} />;
-  }
-
-  return (
-    <div className="p-4 w-full flex flex-col space-y-3.5 animate-in fade-in duration-300">
-      <StorageOptionsGrid
-        options={options}
-        sizes={sizes}
-        allSelected={allSelected}
-        someSelected={someSelected}
-        onOptionChange={handleOptionChange}
-        onSelectAll={handleSelectAll}
-      />
-
-      <AutoRefreshToggle
-        reloadAfterClean={reloadAfterClean}
-        onChange={handleReloadAfterCleanChange}
-      />
-
-      <Button
-        variant="destructive"
-        size="default"
-        onClick={() => setShowConfirm(true)}
-        disabled={isButtonDisabled}
-        className="w-full h-10 font-bold shadow-sm text-sm tracking-wide transition-all active:scale-[0.99]"
-      >
-        {loading ? (
-          <>
-            <Loader2 className="mr-2 h-4 w-4 animate-spin" />
-            {t('storageCleaner:cleaning')}
-          </>
-        ) : (
-          t('storageCleaner:cleanNow')
-        )}
-      </Button>
-
-      <CleaningResult result={result} />
-
-      <StorageCleanerConfirm
-        open={showConfirm}
-        onClose={() => setShowConfirm(false)}
-        onConfirm={handleClean}
-        options={options}
-      />
-    </div>
-  );
-}

pages/Timestamp/LiveClock.tsx

@@ -1,100 +0,0 @@
-import React, { useCallback, useEffect, useRef, useState } from 'react';
-import { Clock } from 'lucide-react';
-import CopyButton from '@/components/CopyButton';
-import { useSnackbar } from '@/components/GlobalSnackbar';
-import type { UnitType } from './constants';
-import { useLazyTranslation } from '@/utils/useLazyTranslation';
-import { cn } from '@/lib/utils'; // 引入标准的 shadcn 工具函数
-
-interface LiveClockProps extends React.HTMLAttributes<HTMLDivElement> {
-  unit: UnitType;
-  onUseNow: (val: number) => void;
-}
-
-const LiveClock = React.memo(({ unit, onUseNow, className, ...props }: LiveClockProps) => {
-  const { t } = useLazyTranslation('timestamp');
-  const { showMessage } = useSnackbar();
-  const onUseNowRef = useRef(onUseNow);
-
-  // 1. 采用毫秒/秒的双态原子计数，避免无意义的重绘
-  const [currentDisplay, setCurrentDisplay] = useState(() => {
-    const initNow = Date.now();
-    return {
-      rawTime: initNow,
-      text: String(Math.floor(initNow / (unit === 'ms' ? 1 : 1000))),
-    };
-  });
-
-  // 始终保持外部回调指针最新
-  useEffect(() => {
-    onUseNowRef.current = onUseNow;
-  }, [onUseNow]);
-
-  // 2. 高频高灵敏度计时器 (200ms 刷新率)
-  useEffect(() => {
-    const tick = () => {
-      const rightNow = Date.now();
-      const nextText = String(Math.floor(rightNow / (unit === 'ms' ? 1 : 1000)));
-
-      // 性能核心：只有当生成的文本内容发生变化时，才触发 React 的 State 更新。
-      // 在“秒(s)”单位下，这可以让组件的渲染频率暴跌 90%，做到极度省电和高性能。
-      setCurrentDisplay((prev) => {
-        if (prev.text === nextText) return prev;
-        return { rawTime: rightNow, text: nextText };
-      });
-    };
-
-    // 200ms 的高速低延迟轮询，比 1000ms 更具响应灵敏度，且因为上面有过滤，完全不用担心引发性能损耗
-    const tickId = setInterval(tick, 200);
-    return () => clearInterval(tickId);
-  }, [unit]);
-
-  const handleUseNow = useCallback(() => {
-    // 捕获真实极其精准的绝对时间戳
-    onUseNowRef.current(currentDisplay.rawTime);
-    showMessage?.(t('timestamp:usedSuccess'), { severity: 'success' });
-  }, [currentDisplay.rawTime, showMessage, t]);
-
-  return (
-    <div
-      className={cn(
-        // 3. 完美适配 shadcn 暗黑模式：
-        // 不再写死 bg-primary/10，改用更高级的 bg-secondary/50 和中性边框，
-        // 在任何主题色下都能表现得低调且极具质感。
-        'flex items-center gap-3 px-3 h-10 rounded-lg border border-border/80 bg-secondary/50',
-        className,
-      )}
-      {...props}
-    >
-      <span className="text-muted-foreground font-bold text-[10px] uppercase tracking-wider whitespace-nowrap shrink-0 selection:bg-transparent select-none">
-        {t('timestamp:currentTs')}
-      </span>
-
-      {/* 4. tabular-nums 强制使用等宽数字布局，彻底消灭数字跳动时字符宽度不同带来的抖动颤噪感 */}
-      <span className="flex-1 font-mono font-bold text-foreground text-sm tracking-tight leading-none truncate tabular-nums">
-        {currentDisplay.text}
-      </span>
-
-      {/* 5. 按钮重构成精巧的 shadcn 原子微动效风格 */}
-      <button
-        type="button"
-        onClick={handleUseNow}
-        title={t('timestamp:useNowTooltip')}
-        className="flex h-7 w-7 items-center justify-center rounded-md border border-input bg-background text-muted-foreground shadow-sm transition-all hover:bg-accent hover:text-foreground active:scale-95 focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring"
-      >
-        <Clock className="w-3.5 h-3.5" />
-      </button>
-
-      <CopyButton
-        text={currentDisplay.text}
-        tooltip={t('timestamp:copyTsTooltip')}
-        size="small"
-        className="h-7 w-7 rounded-md border" // 移除了硬编码的颜色配置表，完全交由组件的内置 Class 渲染
-      />
-    </div>
-  );
-});
-
-LiveClock.displayName = 'LiveClock';
-
-export default LiveClock;

pages/Timestamp/ResultView.tsx

@@ -1,137 +0,0 @@
-import React, { useMemo } from 'react';
-import dayjs from '@/utils/dayjs';
-import CopyButton from '@/components/CopyButton';
-import type { UnitType } from './constants';
-import { DATE_FORMAT } from './constants';
-import { useLazyTranslation } from '@/utils/useLazyTranslation';
-import { cn } from '@/lib/utils'; // shadcn 核心类名合并工具
-
-interface ResultViewProps extends React.HTMLAttributes<HTMLDivElement> {
-  result: string;
-  mode: 'ts2dt' | 'dt2ts';
-  unit: UnitType;
-  zone: string;
-  /** 无结果时是否渲染占位（桌面端右栏使用），默认 false */
-  showEmptyPlaceholder?: boolean;
-}
-
-const ResultView = React.memo(
-  ({
-    result,
-    mode,
-    unit,
-    zone,
-    showEmptyPlaceholder = false,
-    className,
-    ...props
-  }: ResultViewProps) => {
-    const { t } = useLazyTranslation('timestamp');
-
-    // 严谨计算时间衍生的附加时区/相对时间状态
-    const extraInfo = useMemo(() => {
-      if (!result) return null;
-      const d =
-        mode === 'ts2dt'
-          ? dayjs(result, DATE_FORMAT).tz(zone)
-          : unit === 'ms'
-            ? dayjs(Number(result))
-            : dayjs.unix(Number(result));
-
-      return {
-        relative: d.fromNow(),
-        iso: d.toISOString(),
-        utc: d.utc().format(DATE_FORMAT) + ' UTC',
-      };
-    }, [result, mode, zone, unit]);
-
-    // 1. 空状态骨架面板：优雅匹配 shadcn 的中性灰色居中占位
-    if (!result) {
-      if (!showEmptyPlaceholder) return null;
-      return (
-        <div
-          className={cn(
-            'flex-1 flex items-center justify-center text-sm font-medium border border-dashed border-border/60 rounded-xl py-12 px-4 text-center text-muted-foreground bg-muted/20 min-h-[320px] animate-in fade-in duration-200',
-            className,
-          )}
-          {...props}
-        >
-          {t('timestamp:resultEmpty')}
-        </div>
-      );
-    }
-
-    return (
-      <div
-        className={cn(
-          'animate-in fade-in slide-in-from-bottom-2 duration-300 flex flex-col w-full',
-          className,
-        )}
-        {...props}
-      >
-        {/* 顶部小标签 */}
-        <span className="block text-muted-foreground/90 mb-2.5 text-xs font-semibold tracking-wider uppercase">
-          {t('timestamp:resultLabel')}
-        </span>
-
-        {/*
-          2. 核心结果大卡片：
-          对齐 shadcn 官方卡片风格，使用 bg-card、border-border 构筑多层级阴影。
-          核心数值直接拉粗为 text-foreground (在黑夜模式下会自动转为大气的纯白，完美避开刺眼强光)
-        */}
-        <div className="bg-card text-card-foreground border border-border p-4 sm:p-5 rounded-xl relative mb-3.5 shadow-sm flex justify-between items-center gap-4 focus-within:ring-1 focus-within:ring-ring transition-all">
-          <span className="font-mono font-extrabold text-foreground break-all text-xl sm:text-2xl tracking-tight leading-tight select-all tabular-nums">
-            {result}
-          </span>
-          <CopyButton
-            text={result}
-            tooltip={t('timestamp:copyResultTooltip')}
-            className="h-8 w-8 rounded-md shrink-0 border"
-          />
-        </div>
-
-        {/*
-          3. 衍生的附加参考数据区：
-          背景改为低饱和度的 bg-muted/40 隔离带。
-          内部数值降级为 text-muted-foreground，建立教科书般的完美“视觉权重层级”。
-        */}
-        <div className="bg-muted/40 p-4 rounded-xl border border-border/50 flex flex-col gap-3">
-          {[
-            { label: t('timestamp:relativeTime'), value: extraInfo?.relative },
-            { label: t('timestamp:iso8601'), value: extraInfo?.iso, isMono: true },
-            { label: t('timestamp:utcTime'), value: extraInfo?.utc, isMono: true },
-          ].map((item) => (
-            <div
-              key={item.label}
-              className="flex flex-col sm:flex-row sm:justify-between sm:items-center gap-1.5 py-0.5 border-b border-border/30 last:border-0 pb-2 sm:pb-0 last:pb-0"
-            >
-              <span className="text-muted-foreground font-semibold text-xs shrink-0 select-none">
-                {item.label}
-              </span>
-              <div className="flex items-center justify-between sm:justify-end gap-2 min-w-0 w-full sm:w-auto">
-                <span
-                  className={cn(
-                    'text-xs text-foreground/90 font-medium break-all text-left sm:text-right tabular-nums',
-                    item.isMono && 'font-mono text-[11px]', // ISO/UTC 等机器时间使用精细化等宽代码体
-                  )}
-                >
-                  {item.value}
-                </span>
-                {item.value && (
-                  <CopyButton
-                    text={item.value}
-                    tooltip={t('timestamp:copyTooltip')}
-                    className="h-6 w-6 rounded-md border shrink-0 text-muted-foreground"
-                  />
-                )}
-              </div>
-            </div>
-          ))}
-        </div>
-      </div>
-    );
-  },
-);
-
-ResultView.displayName = 'ResultView';
-
-export default ResultView;

pages/Timestamp/constants.ts

@@ -1,6 +0,0 @@
-export const DATE_FORMAT = 'YYYY/MM/DD HH:mm:ss';
-
-export const ZONES = ['Asia/Shanghai', 'America/New_York', 'Europe/London'] as const;
-
-export type UnitType = 'ms' | 's';
-export type ZoneType = (typeof ZONES)[number];

pages/Timestamp/useTimestampConverter.ts

@@ -1,124 +0,0 @@
-import { useCallback, useMemo, useState } from 'react';
-import dayjs from '@/utils/dayjs';
-import type { UnitType, ZoneType } from './constants';
-import { DATE_FORMAT } from './constants';
-import { useLazyTranslation } from '@/utils/useLazyTranslation';
-import { useContextMenuData } from '@/utils/useContextMenuData';
-
-export interface UseTimestampConverterReturn {
-  mode: 'ts2dt' | 'dt2ts';
-  input: string; // 统一为单一受控输入源
-  unit: UnitType;
-  zone: ZoneType;
-  result: string;
-  error: string;
-
-  setMode: (mode: 'ts2dt' | 'dt2ts') => void;
-  setInput: (value: string) => void;
-  setUnit: (unit: UnitType) => void;
-  setZone: (zone: ZoneType) => void;
-  handleUseNow: (now: number) => void;
-}
-
-function isTimestampLike(input: string): boolean {
-  const trimmed = input.trim();
-  return /^\d+$/.test(trimmed) && trimmed.length >= 10;
-}
-
-export function useTimestampConverter(): UseTimestampConverterReturn {
-  const { t } = useLazyTranslation('timestamp');
-  const [mode, setMode] = useState<'ts2dt' | 'dt2ts'>('ts2dt');
-  const [unit, setUnit] = useState<UnitType>('ms');
-  const [zone, setZone] = useState<ZoneType>('Asia/Shanghai');
-
-  // 1. 唯一受控源：不再区分 ts/dt，输入框在当前模式下展现的就是它的值
-  const [input, setInput] = useState(() => String(Date.now()));
-
-  // 2. 核心魔法：利用 useMemo 达成 0 延迟响应式转换 (Reactive Pipeline)
-  // 只要 input, mode, unit, zone 任何一个发生改变，结果和错误信息自动流出，废除 convert 按钮
-  const conversionPipeline = useMemo(() => {
-    const rawInput = input.trim();
-    if (!rawInput) return { result: '', error: '' };
-
-    if (mode === 'ts2dt') {
-      const num = Number(rawInput);
-      if (isNaN(num)) {
-        return { result: '', error: t('timestamp:errors.invalidNumber') };
-      }
-      const d = unit === 'ms' ? dayjs(num) : dayjs.unix(num);
-      if (!d.isValid()) {
-        return { result: '', error: t('timestamp:errors.invalidTimestamp') };
-      }
-      return { result: d.tz(zone).format(DATE_FORMAT), error: '' };
-    } else {
-      const d = dayjs.tz(rawInput, DATE_FORMAT, zone);
-      if (!d.isValid()) {
-        return { result: '', error: t('timestamp:errors.invalidFormat') };
-      }
-      const ms = d.valueOf();
-      const outputTs = unit === 'ms' ? String(ms) : String(Math.floor(ms / 1000));
-      return { result: outputTs, error: '' };
-    }
-  }, [input, mode, unit, zone, t]);
-
-  const { result, error } = conversionPipeline;
-
-  // 3. 处理右键菜单联动（直接修改唯一的 input，衍生转换自动触发）
-  const handleContextMenuData = useCallback((payload: string) => {
-    const trimmed = payload.trim();
-    if (isTimestampLike(trimmed)) {
-      setMode('ts2dt');
-      const detectedUnit: UnitType = trimmed.length >= 13 ? 'ms' : 's';
-      setUnit(detectedUnit);
-      setInput(trimmed);
-    } else {
-      const d = dayjs(trimmed);
-      if (d.isValid()) {
-        setMode('dt2ts');
-        setInput(d.format(DATE_FORMAT));
-      } else {
-        setMode('ts2dt');
-        setInput(trimmed);
-      }
-    }
-  }, []);
-
-  useContextMenuData({ featureKey: 'timestamp', onData: handleContextMenuData });
-
-  const handleUseNow = useCallback(
-    (now: number) => {
-      if (mode === 'ts2dt') {
-        setInput(String(unit === 'ms' ? now : Math.floor(now / 1000)));
-      } else {
-        setInput(dayjs(now).tz(zone).format(DATE_FORMAT));
-      }
-    },
-    [mode, unit, zone],
-  );
-
-  // 4. 尊享级连贯交互：切换 Mode 时，自动把上一个模式计算出的结果喂进输入框
-  // 比如：输入时间戳 -> 得到日期 -> 切换模式 -> 日期直接进入输入框，方便用户进行微调反向转换
-  const handleSetMode = useCallback(
-    (newMode: 'ts2dt' | 'dt2ts') => {
-      setMode(newMode);
-      if (result && !error) {
-        setInput(result);
-      }
-    },
-    [result, error],
-  );
-
-  return {
-    mode,
-    input,
-    unit,
-    zone,
-    result,
-    error,
-    setMode: handleSetMode,
-    setInput,
-    setUnit,
-    setZone,
-    handleUseNow,
-  };
-}

public/README.md

@@ -0,0 +1,19 @@
+# public/
+
+静态资源目录，存放无需构建处理的文件，会被直接复制到输出目录。
+
+## 文件说明
+
+| 文件/目录      | 用途                             |
+| -------------- | -------------------------------- |
+| `icon/`        | 扩展图标，提供多种尺寸           |
+| `icon/16.png`  | 16×16 图标（工具栏）             |
+| `icon/32.png`  | 32×32 图标                       |
+| `icon/48.png`  | 48×48 图标（扩展管理页）         |
+| `icon/96.png`  | 96×96 图标                       |
+| `icon/128.png` | 128×128 图标（Chrome Web Store） |
+
+## 注意事项
+
+- 修改图标后需同步更新 `wxt.config.ts` 中的 manifest 配置
+- 图标格式推荐使用 PNG，确保透明背景

src/README.md

@@ -0,0 +1,24 @@
+# src/
+
+源码目录，存放全局样式定义。
+
+## 文件说明
+
+| 文件        | 用途              |
+| ----------- | ----------------- |
+| `index.css` | 全局 CSS 入口文件 |
+
+## index.css
+
+全局样式入口，包含：
+
+- **Tailwind 指令**：`@tailwind base/components/utilities`
+- **shadcn/ui CSS 变量**：定义 `--background`、`--primary`、`--destructive`、`--card`、`--muted`、`--accent`、`--border`、`--ring` 等语义化颜色变量
+- **主题色值**：`:root`（亮色）和 `.dark`（暗色）两套完整的颜色定义
+- **圆角变量**：`--radius` 定义全局圆角大小
+
+## 修改注意事项
+
+- 修改 CSS 变量会影响所有使用 shadcn/ui 语义化 token 的组件
+- 新增颜色变量需同时在 `:root` 和 `.dark` 中定义
+- 避免在组件中硬编码颜色值，应使用 CSS 变量或 Tailwind 的语义化类名

src/components/CopyButton.tsx

@@ -0,0 +1,74 @@
+import React, { useEffect, useRef, useState } from 'react';
+import { Check, Copy } from 'lucide-react';
+import { copyTextToClipboard } from '@/utils/clipboard';
+import { cn } from '@/lib/utils';
+import { buttonVariants, type ButtonProps } from '@/components/ui/button';
+import { toast } from 'sonner';
+import { useI18n } from '@/utils/chromeI18n';
+
+interface CopyButtonProps extends Omit<ButtonProps, 'children' | 'onClick'> {
+  text: string;
+  tooltip?: string;
+}
+
+export const CopyButton: React.FC<CopyButtonProps> = ({
+  text,
+  tooltip,
+  variant = 'ghost',
+  size = 'icon',
+  className,
+  ...props
+}) => {
+  const { t } = useI18n('common');
+  const [copied, setCopied] = useState(false);
+  const timerRef = useRef<ReturnType<typeof setTimeout> | null>(null);
+
+  useEffect(() => {
+    return () => {
+      if (timerRef.current) clearTimeout(timerRef.current);
+    };
+  }, []);
+
+  const handleCopy = async (e: React.MouseEvent<HTMLButtonElement>) => {
+    e.stopPropagation();
+
+    if (!text) {
+      toast.error(t('messages.copyEmpty'));
+      return;
+    }
+
+    const success = await copyTextToClipboard(text);
+    if (success) {
+      toast.success(t('messages.copySuccess'));
+      setCopied(true);
+      if (timerRef.current) clearTimeout(timerRef.current);
+      timerRef.current = setTimeout(() => setCopied(false), 1500);
+    } else {
+      toast.error(t('messages.copyError'));
+    }
+  };
+
+  return (
+    <button
+      type="button"
+      onClick={handleCopy}
+      title={tooltip ?? t('buttons.copy')}
+      aria-label={tooltip ?? t('buttons.copy')}
+      className={cn(
+        buttonVariants({ variant, size }),
+        copied &&
+          'bg-emerald-500/10 text-emerald-600 dark:text-emerald-400 hover:bg-emerald-500/10',
+        className,
+      )}
+      {...props}
+    >
+      {copied ? (
+        <Check className="h-[1.2em] w-[1.2em]" />
+      ) : (
+        <Copy className="h-[1.2em] w-[1.2em]" />
+      )}
+    </button>
+  );
+};
+
+export default CopyButton;

src/components/CopyButton/__tests__/index.test.tsx

@@ -0,0 +1,194 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { act, render, screen, waitFor } from '@testing-library/react';
+import userEvent from '@testing-library/user-event';
+
+// unmock the globally-mocked component so we test the real implementation
+vi.unmock('@/components/CopyButton');
+
+vi.mock('@/utils/clipboard', () => ({
+  copyTextToClipboard: vi.fn(),
+}));
+
+vi.mock('sonner', () => ({
+  toast: {
+    success: vi.fn(),
+    error: vi.fn(),
+  },
+}));
+
+import { CopyButton } from '@/components/CopyButton';
+import { copyTextToClipboard } from '@/utils/clipboard';
+import { toast } from 'sonner';
+
+const mockedCopy = vi.mocked(copyTextToClipboard);
+const mockedToast = vi.mocked(toast);
+
+describe('CopyButton', () => {
+  beforeEach(() => {
+    vi.useFakeTimers({ shouldAdvanceTime: true });
+    vi.clearAllMocks();
+  });
+
+  afterEach(() => {
+    vi.useRealTimers();
+  });
+
+  it('复制成功时调用 copyTextToClipboard 并传入正确 text', async () => {
+    mockedCopy.mockResolvedValue(true);
+    const user = userEvent.setup({ advanceTimers: vi.advanceTimersByTime });
+
+    render(<CopyButton text="hello world" />);
+
+    await user.click(screen.getByRole('button'));
+
+    expect(mockedCopy).toHaveBeenCalledWith('hello world');
+    expect(mockedToast.success).toHaveBeenCalled();
+  });
+
+  it('复制成功后图标切换为 Check，1.5 秒后恢复', async () => {
+    mockedCopy.mockResolvedValue(true);
+    const user = userEvent.setup({ advanceTimers: vi.advanceTimersByTime });
+
+    render(<CopyButton text="test" />);
+
+    // 点击后复制成功，按钮获得 emerald 样式（说明切到了 Check 状态）
+    await user.click(screen.getByRole('button'));
+
+    await waitFor(() => {
+      expect(screen.getByRole('button').className).toContain('text-emerald');
+    });
+
+    // 1.5 秒后样式恢复
+    act(() => {
+      vi.advanceTimersByTime(1500);
+    });
+
+    await waitFor(() => {
+      expect(screen.getByRole('button').className).not.toContain('text-emerald');
+    });
+  });
+
+  it('复制空文本时弹出 error toast', async () => {
+    const user = userEvent.setup({ advanceTimers: vi.advanceTimersByTime });
+
+    render(<CopyButton text="" />);
+
+    await user.click(screen.getByRole('button'));
+
+    expect(mockedCopy).not.toHaveBeenCalled();
+    expect(mockedToast.error).toHaveBeenCalled();
+  });
+
+  it('复制失败时弹出 error toast', async () => {
+    mockedCopy.mockResolvedValue(false);
+    const user = userEvent.setup({ advanceTimers: vi.advanceTimersByTime });
+
+    render(<CopyButton text="something" />);
+
+    await user.click(screen.getByRole('button'));
+
+    expect(mockedCopy).toHaveBeenCalledWith('something');
+    expect(mockedToast.error).toHaveBeenCalled();
+  });
+
+  // ==================== 新增测试 ====================
+
+  it('初始渲染时显示 Copy 图标且无 emerald 样式', () => {
+    render(<CopyButton text="initial" />);
+
+    const button = screen.getByRole('button');
+    expect(button.className).not.toContain('text-emerald');
+    // 通过 aria-label 确认按钮存在，图标由 lucide 渲染为 svg
+    expect(button).toHaveAttribute('aria-label');
+  });
+
+  it('自定义 tooltip 会覆盖默认 title 和 aria-label', () => {
+    render(<CopyButton text="tooltip-test" tooltip="自定义提示" />);
+
+    const button = screen.getByRole('button');
+    expect(button).toHaveAttribute('title', '自定义提示');
+    expect(button).toHaveAttribute('aria-label', '自定义提示');
+  });
+
+  it('className 被正确透传到按钮', () => {
+    render(<CopyButton text="class-test" className="my-custom-class" />);
+
+    const button = screen.getByRole('button');
+    expect(button.className).toContain('my-custom-class');
+  });
+
+  it('点击事件阻止冒泡', async () => {
+    mockedCopy.mockResolvedValue(true);
+    const user = userEvent.setup({ advanceTimers: vi.advanceTimersByTime });
+    const parentClick = vi.fn();
+
+    render(
+      <div onClick={parentClick}>
+        <CopyButton text="stop-propagation" />
+      </div>,
+    );
+
+    await user.click(screen.getByRole('button'));
+
+    expect(mockedCopy).toHaveBeenCalled();
+    expect(parentClick).not.toHaveBeenCalled();
+  });
+
+  it('组件卸载时清除定时器，不触发状态更新警告', async () => {
+    mockedCopy.mockResolvedValue(true);
+    const user = userEvent.setup({ advanceTimers: vi.advanceTimersByTime });
+
+    const { unmount } = render(<CopyButton text="unmount-test" />);
+
+    await user.click(screen.getByRole('button'));
+
+    // 在 1.5 秒超时到期前卸载组件
+    act(() => {
+      vi.advanceTimersByTime(500);
+    });
+
+    // 卸载不应抛出 "Can't perform a React state update on an unmounted component" 警告
+    expect(() => unmount()).not.toThrow();
+
+    // 前进剩余时间，确认没有异常
+    act(() => {
+      vi.advanceTimersByTime(2000);
+    });
+  });
+
+  it('快速连续点击不会创建多个重叠定时器', async () => {
+    mockedCopy.mockResolvedValue(true);
+    const user = userEvent.setup({ advanceTimers: vi.advanceTimersByTime });
+
+    render(<CopyButton text="rapid-click" />);
+
+    const button = screen.getByRole('button');
+
+    // 快速点击 3 次
+    await user.click(button);
+    await user.click(button);
+    await user.click(button);
+
+    // copyTextToClipboard 应该被调用 3 次（每次点击都执行）
+    expect(mockedCopy).toHaveBeenCalledTimes(3);
+
+    // 但 setTimeout 相关的 clearTimeout + setTimeout 组合应正常工作
+    //  advance 1.5 秒后，copied 状态应恢复为 false
+    act(() => {
+      vi.advanceTimersByTime(1500);
+    });
+
+    await waitFor(() => {
+      expect(button.className).not.toContain('text-emerald');
+    });
+  });
+
+  it('其他 button props 通过 ...props 透传', () => {
+    render(<CopyButton text="props-test" data-testid="copy-btn" disabled id="copy-button-id" />);
+
+    const button = screen.getByRole('button');
+    expect(button).toHaveAttribute('data-testid', 'copy-btn');
+    expect(button).toBeDisabled();
+    expect(button).toHaveAttribute('id', 'copy-button-id');
+  });
+});

src/components/DecodeResultPaper.tsx

@@ -10,7 +10,7 @@
 import { Download } from 'lucide-react';
 import { Button } from '@/components/ui/button';
 import { formatFileSize } from '@/utils/base64Converter';
-import { useLazyTranslation } from '@/utils/useLazyTranslation';
+import { useI18n } from '@/utils/chromeI18n';
 
 interface DecodeResultPaperProps {
   /** 标题文案，由调用方传入 i18n key 对应的值（如 decodedFileOutput / decodedImageOutput） */
@@ -38,7 +38,7 @@ export default function DecodeResultPaper({
   onDownload,
   children,
 }: DecodeResultPaperProps) {
-  const { t } = useLazyTranslation('base64Converter');
+  const { t } = useI18n('base64Converter');
 
   return (
     <div className="p-4 rounded-xl bg-primary/10 border border-primary/30">

src/components/ErrorBoundary.tsx

@@ -1,6 +1,7 @@
 import { Component, ErrorInfo, ReactNode } from 'react';
 import { AlertCircle, RefreshCw } from 'lucide-react';
 import { Button } from '@/components/ui/button';
+import { getMessage } from '@/utils/chromeI18n';
 
 interface Props {
   children: ReactNode;
@@ -11,10 +12,7 @@ interface State {
   error: Error | null;
 }
 
-/**
- * 错误边界组件：捕获子组件树中的 JavaScript 错误
- */
-export class ErrorBoundary extends Component<Props, State> {
+class ErrorBoundary extends Component<Props, State> {
   state: State = {
     hasError: false,
     error: null,
@@ -41,27 +39,31 @@ export class ErrorBoundary extends Component<Props, State> {
   render() {
     if (this.state.hasError) {
       return (
-        <div className="mt-16 mx-auto max-w-md">
-          <div className="p-6 text-center rounded-xl border border-red-200 bg-red-50">
-            <AlertCircle className="h-16 w-16 text-red-500 mx-auto mb-4" />
-            <h2 className="text-xl font-extrabold text-red-600 mb-2">糟糕，出了点问题</h2>
+        <div className="flex flex-col items-center justify-center mt-16 mx-auto max-w-md">
+          <div className="p-6 text-center rounded-xl border border-destructive/20 bg-destructive/5 shadow-sm">
+            <div className="flex h-16 w-16 items-center justify-center rounded-full bg-destructive/10 text-destructive mx-auto mb-4">
+              <AlertCircle className="h-8 w-8" />
+            </div>
+            <h2 className="text-xl font-extrabold text-destructive mb-2">
+              {getMessage('errorBoundary_title')}
+            </h2>
             <p className="text-sm text-muted-foreground mb-6">
-              应用遇到了一些意外错误。您可以尝试刷新页面或重置应用。
+              {getMessage('errorBoundary_description')}
             </p>
             {this.state.error && (
-              <div className="mb-6 p-4 bg-muted rounded-lg text-left max-h-[200px] overflow-auto">
-                <pre className="font-mono text-xs whitespace-pre-wrap break-all text-red-700">
+              <div className="mb-6 p-4 rounded-lg bg-zinc-950 dark:bg-zinc-900 text-left max-h-[200px] overflow-auto border border-border/40">
+                <pre className="font-mono text-xs whitespace-pre-wrap break-all text-zinc-200 selection:bg-zinc-700">
                   {this.state.error.toString()}
                 </pre>
               </div>
             )}
             <Button
-              variant="default"
+              variant="destructive"
               onClick={this.handleReset}
-              className="rounded-lg font-bold bg-red-600 hover:bg-red-700 text-white"
+              className="rounded-lg font-bold shadow-sm"
             >
               <RefreshCw className="mr-2 h-4 w-4" />
-              刷新应用
+              {getMessage('errorBoundary_refresh')}
             </Button>
           </div>
         </div>
@@ -72,4 +74,5 @@ export class ErrorBoundary extends Component<Props, State> {
   }
 }
 
+export { ErrorBoundary };
 export default ErrorBoundary;

src/components/ImageUploader.tsx

@@ -1,7 +1,7 @@
 import { useCallback, useEffect, useRef } from 'react';
 import { Image, X } from 'lucide-react';
-import { useSnackbar } from '@/components/GlobalSnackbar';
-import { useLazyTranslation } from '@/utils/useLazyTranslation';
+import { toast } from 'sonner';
+import { useI18n } from '@/utils/chromeI18n';
 
 interface ImageUploaderProps {
   /** 选中的文件 */
@@ -29,8 +29,7 @@ const ImageUploader = ({
   dragging,
   onDraggingChange,
 }: ImageUploaderProps) => {
-  const { t } = useLazyTranslation('qrCode');
-  const { showMessage } = useSnackbar();
+  const { t } = useI18n('qrCode');
   const fileInputRef = useRef<HTMLInputElement>(null);
 
   const handleFileChange = useCallback(
@@ -41,16 +40,13 @@ const ImageUploader = ({
     [onFileChange, onPreviewUrlChange],
   );
 
-  const handleClearFile = () => {
+  const handleClearFile = useCallback(() => {
     if (previewUrl) {
       URL.revokeObjectURL(previewUrl);
     }
     onClearFile();
-    showMessage(t('qrCode:imageCleared'), {
-      severity: 'success',
-      autoHideDuration: 1000,
-    });
-  };
+    toast.success(t('qrCode:imageCleared'));
+  }, [previewUrl, onClearFile, t]);
 
   const handleInputChange = (e: React.ChangeEvent<HTMLInputElement>) => {
     if (e.target.files && e.target.files.length > 0) {
@@ -90,13 +86,10 @@ const ImageUploader = ({
           if (file) {
             try {
               handleFileChange(file);
-              showMessage(t('qrCode:imagePasted'), { severity: 'success', autoHideDuration: 1000 });
+              toast.success(t('qrCode:imagePasted'));
             } catch (error) {
               console.error('处理粘贴图片失败:', error);
-              showMessage(t('qrCode:imagePasteError'), {
-                severity: 'error',
-                autoHideDuration: 3000,
-              });
+              toast.error(t('qrCode:imagePasteError'));
             }
           }
           break;
@@ -109,7 +102,7 @@ const ImageUploader = ({
     return () => {
       document.removeEventListener('paste', handlePaste);
     };
-  }, [showMessage, handleFileChange, t]);
+  }, [handleFileChange, t]);
 
   return (
     <div

src/components/PageErrorBoundary.tsx

@@ -1,6 +1,7 @@
 import { Component, ErrorInfo, ReactNode } from 'react';
 import { AlertCircle, RefreshCw } from 'lucide-react';
 import { Button } from '@/components/ui/button';
+import { getMessage } from '@/utils/chromeI18n';
 
 interface Props {
   children: ReactNode;
@@ -12,11 +13,7 @@ interface State {
   error: Error | null;
 }
 
-/**
- * 页面级错误边界组件：捕获子组件树中的 JavaScript 错误
- * 完美适配 shadcn/ui 语义化主题与暗黑模式
- */
-export class PageErrorBoundary extends Component<Props, State> {
+class PageErrorBoundary extends Component<Props, State> {
   state: State = {
     hasError: false,
     error: null,
@@ -44,23 +41,18 @@ export class PageErrorBoundary extends Component<Props, State> {
     if (this.state.hasError) {
       return (
         <div className="flex flex-col items-center justify-center flex-1 p-6 min-h-[300px] animate-in fade-in zoom-in-95 duration-200">
-          {/*
-            1. 适配暗黑模式的容器设计：
-            不再使用 border-red-200 / bg-red-50，改用标准的 border-destructive/20 和 bg-destructive/5，
-            并在黑夜模式下会自动转为深红底色，绝不刺眼。
-          */}
           <div className="p-6 text-center rounded-xl border border-destructive/20 bg-destructive/5 max-w-md w-full shadow-sm">
-            {/* 2. 状态符号改用标准的 text-destructive 语义色 */}
             <div className="flex h-12 w-12 items-center justify-center rounded-full bg-destructive/10 text-destructive mx-auto mb-4">
               <AlertCircle className="h-6 w-6" />
             </div>
 
-            <h3 className="text-base font-semibold text-foreground mb-1.5">该功能运行异常</h3>
+            <h3 className="text-base font-semibold text-foreground mb-1.5">
+              {getMessage('pageErrorBoundary_title')}
+            </h3>
             <p className="text-xs text-muted-foreground mb-5">
-              该页面在加载或渲染时遇到了内部脚本错误。您可以尝试重试，或者通过导航菜单切换到其他工具。
+              {getMessage('pageErrorBoundary_description')}
             </p>
 
-            {/* 3. 错误日志展示：使用与 shadcn 贴合的深色代码块包裹 */}
             {this.state.error && (
               <div className="mb-5 p-3 rounded-lg bg-zinc-950 dark:bg-zinc-900 text-left max-h-40 overflow-y-auto border border-border/40">
                 <pre className="font-mono text-[11px] leading-relaxed whitespace-pre-wrap break-all text-zinc-200 selection:bg-zinc-700">
@@ -69,11 +61,6 @@ export class PageErrorBoundary extends Component<Props, State> {
               </div>
             )}
 
-            {/*
-              4. 严谨调用 shadcn 原子 Button：
-              去掉全部手动指定的红底白字类名，直接启用 variant="destructive"。
-              它会自动处理 hover 颜色变化、暗黑模式切换以及无障碍高亮边框。
-            */}
             <Button
               variant="destructive"
               size="sm"
@@ -81,7 +68,7 @@ export class PageErrorBoundary extends Component<Props, State> {
               className="font-medium shadow-sm"
             >
               <RefreshCw className="mr-1.5 h-3.5 w-3.5" />
-              重新尝试
+              {getMessage('errorBoundary_retry')}
             </Button>
           </div>
         </div>
@@ -92,4 +79,5 @@ export class PageErrorBoundary extends Component<Props, State> {
   }
 }
 
+export { PageErrorBoundary };
 export default PageErrorBoundary;