LingandRX
d4c29a1bf4
* fix(ci): fix release workflow artifact upload issue - Split artifact upload into 3 separate steps (Chrome, Firefox, Source) - Update download steps to match new artifact names - Add if-no-files-found: error for better error handling - Fix Node.js 20 compatibility issue with upload-artifact@v4 glob pattern * docs: 更新 AGENTS.md，添加测试工具和翻译文件结构说明 * docs: 更新 AGENTS.md，完善 CI 步骤和存储键名格式说明 * fix: remove unnecessary animations from StorageCleaner page - Remove entrance animations (animate-in, fade-in, zoom-in) from all components - Remove scale effect (active:scale-[0.99]) from clean button - Remove transition effects (transition-all, transition-colors) from OptionItem, StorageOptionsGrid, AutoRefreshToggle - Remove bouncing animation from error icon - Remove pulsing animation from warning banner - Keep animate-spin on button loading spinner as functional indicator * fix: remove unnecessary animations from RightClickRestorer page * fix: remove all unnecessary animations from all pages - Remove dead code animations (animate-in, fade-in, slide-in, zoom-in, shake) from tailwindcss-animate plugin (not installed) - Remove decorative transition effects (transition-all, transition-colors) from all page components - Remove scale effects (active:scale-95) from buttons - Remove bounce animations (animate-bounce) from icons - Keep functional animate-spin on loading spinners as they provide essential loading feedback Affected pages: Dashboard, Timestamp, Jwt, JsonTools, Base64Converter, HtmlToMarkdown, MarkdownToHtml, QrCode, TextStatistics * docs: 添加项目文档（copilot-instructions、编码规范、各目录 README） - 新增 .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> * fix(CopyButton): use shadcn buttonVariants instead of duplicated variant classes Remove hand-written variantClasses/sizeClasses that duplicated shadcn's buttonVariants. Now extends ButtonProps and imports buttonVariants from components/ui/button for consistent styling. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * fix(ErrorBoundary): use shadcn destructive tokens instead of hardcoded red colors Replace hardcoded red-200/red-50/red-600 with border-destructive, bg-destructive/5, text-destructive. Use variant='destructive' on Button. Align error log styling with PageErrorBoundary. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * fix(TextInputArea): replace hardcoded Chinese strings with i18n t() calls Use existing translation keys for clear success, copy success, and copy error messages instead of hardcoded Chinese text. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * fix(QrCodePreview): use shadcn Button instead of manual button styles Replace hand-written button class strings with shadcn Button component using outline and default variants. Removes ~15 lines of duplicated Tailwind classes. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * docs(GlobalSnackbar): clarify relationship with sonner toast Add note explaining when to use GlobalSnackbar (provider context, severity levels, custom positioning) vs sonner toast (simple one-off messages). Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * fix(ImageUploader): wrap handleClearFile with useCallback Prevents unnecessary re-renders by memoizing the callback, consistent with handleFileChange which already uses useCallback. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * fix(SwitchButtonGroup): remove redundant containerPadding conditional Both branches of the ternary returned 'p-1'. Inline the constant directly into the className string. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * fix(TopBar): add missing openExtensionPage import The function was called in handleOpenInTab but never imported from utils/chromeTabs. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * fix(TopBar): add selectedIndex boundary protection in keyboard nav Guard against out-of-bounds access when search results change during keyboard navigation. Check selectedIndex < totalItems before accessing arrays. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * fix(RouterContainer): remove unnecessary empty-dep useMemo getEntryPointType() is a simple config getter. Replace useMemo(() => ..., []) with a direct call — the empty dep array made the memo pointless. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * feat(i18n): add missing translation keys for error boundaries and copy messages Add keys for errorBoundary, pageErrorBoundary, router, and messages.copyEmpty in both zh and en locales. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * fix(CopyButton): replace hardcoded Chinese strings with i18n t() calls Use useTranslation('common') for tooltip, copy empty/success/error toast messages. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * fix(ErrorBoundary): replace hardcoded Chinese with i18n via withTranslation HOC Use react-i18next withTranslation HOC for class component to translate title, description, and refresh button text. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * fix(PageErrorBoundary): replace hardcoded Chinese with i18n via withTranslation HOC Use react-i18next withTranslation HOC for class component to translate title, description, and retry button text. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * fix(RouterContainer): replace hardcoded Chinese with i18n t() calls Use useTranslation('common') for 404 page title and description with entryPointType interpolation. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * fix(pages): 修复 TypeScript 错误、硬编码字符串，移除死代码 - 修复 LiveClock.tsx CopyButton size 属性类型错误 (small → sm) - 修复 ToolCard.tsx 紫色 RGB 值拼写错误 (147,51,2 purple → 147,51,232) - 替换 4 处硬编码中文为 i18n 调用 (StorageCleaner, JsonTools) - MarkdownToHtml 预览链接色改为 CSS 变量以支持暗黑模式 - 移除 Base64Converter 中已被 Base64ConverterSection 替代的死代码 (FileMode.tsx, ImageMode.tsx 及其测试文件) - 更新 README.md 移除对已删除文件的引用 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * fix(CopyButton, LiveClock): 修改按钮大小为 'icon'，移除硬编码颜色配置 * refactor(TextInputArea): 复用 CopyButton 组件替换内联复制逻辑 * fix(test): 修复 CopyButton mock 未捕获 clipboard writeText 异常 --------- Co-authored-by: Ubuntu <ubuntu@localhost.localdomain> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
141 lines
5.5 KiB
Markdown
141 lines
5.5 KiB
Markdown
# pages/
|
||
|
||
功能页面组件目录，每个子目录对应一个工具页面。
|
||
|
||
## 目录结构约定
|
||
|
||
典型页面遵循 **UI + Hook 分离** 模式：
|
||
|
||
```
|
||
pages/FeatureName/
|
||
├── index.tsx # 页面 UI（纯展示，使用 shadcn/ui 组件）
|
||
├── useFeatureName.ts # 业务逻辑 Hook（状态管理 + 转换逻辑）
|
||
├── constants.ts # 常量定义（可选）
|
||
├── SubComponent.tsx # 子组件（可选）
|
||
└── __tests__/ # 测试文件
|
||
└── index.test.tsx
|
||
```
|
||
|
||
## 页面列表
|
||
|
||
### Dashboard/
|
||
|
||
仪表盘首页，以卡片网格展示所有可见工具，支持点击导航。
|
||
|
||
| 文件 | 用途 |
|
||
| -------------- | -------------------------------------------- |
|
||
| `index.tsx` | 页面组件，渲染工具卡片网格 |
|
||
| `ToolCard.tsx` | 工具卡片组件，展示图标、标题、描述和实时数据 |
|
||
|
||
### Timestamp/
|
||
|
||
时间戳转换工具，支持秒/毫秒级互转、多时区选择、实时时钟。
|
||
|
||
| 文件 | 用途 |
|
||
| -------------------------- | ----------------------------------------------------------------- |
|
||
| `index.tsx` | 页面 UI |
|
||
| `useTimestampConverter.ts` | 业务逻辑 Hook，包含转换模式、输入、单位、时区状态和响应式计算管线 |
|
||
| `LiveClock.tsx` | 实时时钟子组件，`React.memo` 优化 |
|
||
| `ResultView.tsx` | 转换结果展示子组件 |
|
||
| `constants.ts` | 时区列表等常量 |
|
||
|
||
### StorageCleaner/
|
||
|
||
浏览器存储清理工具，支持 Cookie/LocalStorage/SessionStorage/IndexedDB/Cache/SW 清理。
|
||
|
||
| 文件 | 用途 |
|
||
| --------------------------- | -------------- |
|
||
| `index.tsx` | 页面 UI |
|
||
| `useStorageCleaner.ts` | 业务逻辑 Hook |
|
||
| `StorageOptionsGrid.tsx` | 清理选项网格 |
|
||
| `StorageCleanerConfirm.tsx` | 清理确认对话框 |
|
||
| `AutoRefreshToggle.tsx` | 自动刷新开关 |
|
||
| `ErrorDisplay.tsx` | 错误展示组件 |
|
||
| `CleaningResult.tsx` | 清理结果展示 |
|
||
| `OptionItem.tsx` | 单个选项组件 |
|
||
|
||
### QrCode/
|
||
|
||
二维码工具，支持生成（URL→QR）和解析（QR→URL）。
|
||
|
||
| 文件/目录 | 用途 |
|
||
| ------------- | ---------------- |
|
||
| `index.tsx` | 页面 UI |
|
||
| `types.ts` | 类型定义 |
|
||
| `contexts/` | Context Provider |
|
||
| `hooks/` | 业务逻辑 Hooks |
|
||
| `components/` | 子组件 |
|
||
|
||
### TextStatistics/
|
||
|
||
文本统计工具，实时计算字符数、单词数、行数、字节大小。
|
||
|
||
| 文件 | 用途 |
|
||
| ----------- | --------------------------------------------- |
|
||
| `index.tsx` | 页面组件，集成 `TextInputArea` 和统计结果展示 |
|
||
|
||
### Jwt/
|
||
|
||
JWT 解析工具，解码 Header/Payload/Signature。
|
||
|
||
| 文件/目录 | 用途 |
|
||
| ------------- | ---------------- |
|
||
| `index.tsx` | 页面 UI |
|
||
| `types.ts` | 类型定义 |
|
||
| `contexts/` | Context Provider |
|
||
| `hooks/` | 业务逻辑 Hooks |
|
||
| `components/` | 子组件 |
|
||
|
||
### JsonTools/
|
||
|
||
JSON 工具集：差异比较、格式化、YAML/TOML/Minify 转换。
|
||
|
||
| 文件 | 用途 |
|
||
| ------------------------ | ---------------------------- |
|
||
| `index.tsx` | 页面入口，子模式切换 |
|
||
| `types.ts` | 类型定义 |
|
||
| `diffEngine.ts` | 差异比较引擎 |
|
||
| `JsonDiffInput.tsx` | JSON 输入组件 |
|
||
| `DiffResult.tsx` | 差异结果展示 |
|
||
| `DiffNavigator.tsx` | 差异导航器 |
|
||
| `JsonFormatSection.tsx` | 格式化区域 |
|
||
| `JsonConvertSection.tsx` | 转换区域（YAML/TOML/Minify） |
|
||
| `JsonTree.tsx` | JSON 树形展示 |
|
||
|
||
### Base64Converter/
|
||
|
||
Base64 编解码工具，支持文本/文件/图片三种模式。
|
||
|
||
| 文件 | 用途 |
|
||
| ---------------------------- | --------------------- |
|
||
| `index.tsx` | 页面入口，子模式切换 |
|
||
| `useBase64Converter.ts` | 业务逻辑 Hook |
|
||
| `TextMode.tsx` | 文本模式 |
|
||
| `Base64ConverterSection.tsx` | 文件/图片通用转换区域 |
|
||
|
||
### MarkdownToHtml/
|
||
|
||
Markdown 转 HTML 工具，支持分栏/预览/源码三种视图模式。
|
||
|
||
### HtmlToMarkdown/
|
||
|
||
HTML 转 Markdown 工具，支持分栏/预览/Markdown 三种视图模式。
|
||
|
||
### RightClickRestorer/
|
||
|
||
右键菜单恢复工具，解除网站对右键的限制。
|
||
|
||
| 文件 | 用途 |
|
||
| -------------------------- | ------------- |
|
||
| `index.tsx` | 页面 UI |
|
||
| `useRightClickRestorer.ts` | 业务逻辑 Hook |
|
||
|
||
## 新增页面
|
||
|
||
1. 在 `types/storage.d.ts` 添加 `PageType` 联合类型成员
|
||
2. 在 `config/features.tsx` 的 `FEATURES` 数组添加配置
|
||
3. 在 `pages/` 创建页面目录（遵循上述结构）
|
||
4. 在 `i18n/locales/{zh,en}/features.json` 添加翻译
|
||
5. 如需新权限，更新 `wxt.config.ts`
|
||
6. 添加对应的单元测试
|