Merge remote-tracking branch 'origin/main' into develop

src/types/README.md

@@ -0,0 +1,42 @@
+# types/
+
+全局共享的 TypeScript 类型声明文件目录。
+
+## 文件说明
+
+### storage.d.ts
+
+核心类型定义文件，包含：
+
+**页面类型：**
+
+- `PageType` — 所有页面类型的联合类型（`dashboard` | `timestamp` | `storageCleaner` | ...）
+- `JsonToolsPageMode` — JSON 工具子模式（`diff` | `format` | `yaml` | `toml` | `minify`）
+- `Base64ConverterPageMode` — Base64 子模式（`text` | `file` | `image`）
+- `Base64ConvertDirection` — 编解码方向（`encode` | `decode`）
+- `MarkdownToHtmlPreviewMode` — Markdown 预览模式（`split` | `preview` | `html`）
+- `HtmlToMarkdownPreviewMode` — HTML 预览模式（`split` | `preview` | `markdown`）
+
+**存储 Schema：**
+
+- `StorageSchema` — Chrome Storage 完整数据结构定义，所有存储键必须在此声明
+  - 键名使用 kebab-case 格式（如 `app/currentRoute`）
+  - 包含路由、主题、工具偏好、搜索历史等所有持久化数据
+
+**其他类型：**
+
+- `FormMapEntry` — 表单映射条目定义
+- `ContextMenuPendingData` — 右键菜单待处理数据
+- `StorageCleanerPreferences` / `StorageCleanerOptions` — 存储清理偏好
+- `CleaningResult` / `StorageCleanResult` — 清理结果类型
+
+### qrious.d.ts
+
+`qrious` 库的类型声明，定义 QR 码生成选项和 `QRious` 类。
+
+## 修改 StorageSchema 的注意事项
+
+修改 `StorageSchema` 时，必须：
+
+1. 在 `utils/chromeStorage.ts` 添加版本迁移函数
+2. 在测试中覆盖迁移场景