雨霖铃
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>
52 lines
2.6 KiB
Markdown
52 lines
2.6 KiB
Markdown
# 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` 的不同配置实现独立路由
|