雨霖铃
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>
utils/
通用工具函数和 React 自定义 Hooks 目录，与具体页面解耦。
工具函数
| 文件 | 用途 |
|---|---|
chromeStorage.ts |
Chrome Storage API 封装：类型安全的 StorageUtils 类，提供 get/set/remove 方法 |
chromeTabs.ts |
Chrome Tabs API 封装：获取活动标签页、获取域名、在新标签页打开扩展页面 |
clipboard.ts |
剪贴板操作：copyTextToClipboard（文本）、copyImageToClipboard（图片） |
messages.ts |
扩展消息通信：基于 @webext-core/messaging，定义 MessageAction 枚举和 ProtocolMap 类型安全映射 |
contextMenu.ts |
右键菜单配置与操作：定义菜单项、创建菜单、解析点击事件、ID→PageType 映射 |
base64Converter.ts |
Base64 编解码：文本↔Base64、文件↔Base64、图片预览，定义文件大小限制和图像 MIME 类型 |
jwt.ts |
JWT 解析：Base64URL 解码、解析 Header/Payload/Signature、JSON 格式化输出 |
jsonFormatter.ts |
JSON 格式化/压缩：支持缩进、按键排序、minify |
jsonToYaml.ts |
JSON→YAML 转换 |
jsonToToml.ts |
JSON→TOML 转换 |
markdownToHtml.ts |
Markdown→HTML 转换：基于 marked 库，支持 GFM 和换行转换 |
htmlToMarkdown.ts |
HTML→Markdown 转换：基于 DOMParser 解析 |
qrCodeParser.ts |
二维码解析：基于 qr-scanner 库从文件中解析二维码 |
storageCleaner.ts |
存储清理：获取当前标签页、检测受限 URL、计算 Cookie/Storage 大小、清理操作 |
textStatistics.ts |
文本统计：使用 Intl.Segmenter 计算字符数/单词数/行数/字节大小 |
format.ts |
通用格式化：formatBytes 将字节转为可读字符串（B/KB/MB/GB/TB） |
dayjs.ts |
Day.js 初始化：扩展 UTC、Timezone、RelativeTime 插件，加载中文本地化 |
自定义 Hooks
| 文件 | 用途 |
|---|---|
useStorageState.ts |
Chrome Storage 状态 Hook：类似 useState，值自动同步到 chrome.storage，使用 localStorage 快照消除首屏闪烁 |
useLazyTranslation.ts |
懒加载翻译 Hook：按需动态导入 i18n 命名空间，支持预加载和缓存 |
useContextMenuData.ts |
右键菜单数据 Hook：从 storage 读取待处理数据，匹配 featureKey 后消费并触发回调 |
useDebounce.ts |
防抖 Hook：对值进行延迟更新，避免频繁触发 |
使用约定
- 工具函数使用命名导出（
export function xxx()） - 工具函数不抛异常，返回包含
hasError和error字段的结果对象 - Hook 使用
use前缀命名，定义返回值接口类型 - 存储操作使用
chromeStorage.ts的storageUtil封装，不要直接调用chrome.storage - 消息通信使用
messages.ts的sendMessage/onMessage，不要使用原生chrome.runtime.sendMessage