雨霖铃
2c901ab4fd
- 删除原有的 TopBar 组件，重构为布局组件并移动至 layout/ 目录。 - 更新相关文档，反映 TopBar 组件的新位置。 - 引入新的 useTopBar 钩子以管理 TopBar 的状态和逻辑。 - 添加 TopBar 组件的单元测试，确保功能正常。
2.6 KiB
2.6 KiB
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 + layout/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的不同配置实现独立路由