雨霖铃
528621f16e
- vitest.setup.ts: react-i18next mock 添加 withTranslation HOC（读取 zh/common.json 翻译） - vitest.setup.ts: 添加 @/components/CopyButton 全局 mock - App 测试: 补充 withTranslation 导出 - TextMode 测试: 修复多个 CopyButton 实例导致的 getByTestId 冲突，改用 getByRole
entrypoints/
WXT 框架要求的扩展生命周期入口点，对应 Chrome Extension 的各个上下文。
入口文件
| 文件 | 用途 |
|---|---|
background.ts |
Service Worker 入口：注册右键菜单、监听菜单点击、处理消息通信、管理侧边栏状态、注入主环境脚本 |
content.ts |
Content Script 入口：注入所有页面（<all_urls>），在 document_end 时初始化消息处理器 |
rightClickRestorer.content.ts |
专用 Content Script：处理右键菜单恢复功能，注入浮动状态徽章 |
子目录
popup/
Popup 弹窗页面（点击扩展图标弹出）。
| 文件 | 用途 |
|---|---|
index.html |
HTML 入口 |
main.tsx |
React 挂载点 |
App.tsx |
根组件，组装 RouterProvider + TopBar + ErrorBoundary + RouterContainer |
sidepanel/
侧边栏页面，结构与 popup 类似，额外通知 background 侧边栏开启/关闭状态。
options/
设置页面，支持：
- 拖拽排序功能顺序（
@dnd-kit） - 功能可见性管理（显示/隐藏）
- Popup/Sidepanel/Tab 三种模式独立配置
content/
Content Script 内部分模块：
| 文件 | 用途 |
|---|---|
messageHandler.ts |
消息处理器初始化入口 |
contextMenuHandler.ts |
右键菜单点击事件处理，执行时间戳转换/文本统计并通过 UI Popover 展示 |
uiPopover.ts |
在页面中注入浮层 Popover UI，展示右键菜单操作结果 |
架构说明
background.ts是扩展的核心协调者，处理跨上下文通信content.ts注入到所有页面，负责接收和处理来自 background 的消息popup/、sidepanel/、options/共享同一套页面组件（来自pages/），通过RouterProvider的不同配置实现独立路由