雨霖铃
c61b599287
- 新增 .github/copilot-instructions.md：Copilot 指令文件，涵盖构建命令、CI 流水线、项目架构、关键规范 - 新增 .github/CODING_STANDARDS.md：完整的代码编写规范文档（TypeScript、React、样式、错误处理、命名、测试、Hook、i18n、存储等 12 个章节） - 新增 11 个目录的 README.md：components、components/ui、config、entrypoints、i18n、lib、pages、providers、public、src、types、utils - 更新 AGENTS.md：补充页面组件模式说明和 components/ui 目录 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
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的不同配置实现独立路由