Develop fastapi (#6)

* feat: add side panel with navigation and storage cleaner functionality

* feat: add OpenUrlPage and integrate into app navigation

* feat: 添加 GlobalSnackbar 组件并在多个页面中集成，替换原有 Snackbar 实现

* feat: fix OpenUrl sidebar issue with architecture refactor

- 修复原问题：不再直接替换侧边栏 URL，保持插件导航可见
- 采用配置页 + 查看页分离架构：OpenUrlPage (配置) + OpenUrlViewerPage (查看)
- 支持多个 URL 快捷方式管理（添加/删除）
- 每个 URL 提供两种打开方式：在侧边栏打开 / 在新标签页打开
- 侧边栏查看页使用 iframe 占满全部剩余空间
- 更新 TypeScript 类型定义
- 保留原有混合内容警告检查
- 数据持久化到 Chrome Storage

* refactor: centralized route management - consolidate routing config into single source

* feat: 更换logo

* refactor: code review fixes - security and race condition improvements

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Changes:

- wxt.config.ts: Remove unused `debugger` permission (no code uses it)
- OpenUrlPage.tsx: Fix unreachable showMessage after window.close()
- OpenUrlPage.tsx: Replace unnecessary div wrapper with Fragment to reduce DOM nesting
- OpenUrlViewerPage.tsx: Add URL validation to prevent XSS via javascript:/data: URLs
- OpenUrlViewerPage.tsx: Add sandbox attribute to iframe for security isolation
- OpenUrlViewerPage.tsx: Add error handling for invalid URLs
- StorageCleanerPage.tsx: Fix race condition in handleOptionChange preference saving
- StorageCleanerPage.tsx: Remove unnecessary storage reads when saving preferences (use state directly)
- StorageCleanerPage.tsx: Add timeout cleanup for setTimeout to follow React best practices

* feat: implement drill-down navigation with master-detail dashboard

* feat: enhance dashboard dynamism and refine options UI

* feat: overhaul storage cleaner UI with real-time size estimation and modern aesthetics

* feat: overhaul TimestampPage UI/UX and fix GlobalSnackbar positioning

* fix: decouple popup routing from storage sync and enhance OpenUrlPage UI

* fix: avoid closing sidepanel when opening URL preview from within sidepanel

.claude/settings.local.json

@@ -8,7 +8,12 @@
       "Bash(npm run:*)",
       "Bash(git show-ref:*)",
       "Bash(git checkout:*)",
-      "mcp__plugin_playwright_playwright__browser_navigate"
+      "mcp__plugin_playwright_playwright__browser_navigate",
+      "Skill(code-review:code-review)",
+      "Bash(grep -E \"\\\\.\\(md|txt\\)$\")",
+      "Bash(pkill -f \"wxt\")",
+      "Bash(python3 -m json.tool)",
+      "Bash(git restore:*)"
     ]
   }
 }

CLAUDE.md

@@ -2,170 +2,182 @@
 
 This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
 
-## 项目概述
+## Quick Start
 
-这是一个基于 WXT 框架的浏览器扩展项目，提供时间戳转换工具。项目已精简为核心功能，移除了录制回放等复杂功能。
+A browser extension built with the WXT framework, providing timestamp conversion and storage cleaning tools.
 
-## 核心命令
+### Essential Commands
 
-### 开发相关
+| Command                 | Purpose                                                |
+| ----------------------- | ------------------------------------------------------ |
+| `npm install`           | Install dependencies (runs `wxt prepare` post-install) |
+| `npm run dev`           | Start development mode for Chrome                      |
+| `npm run dev:firefox`   | Start development mode for Firefox                     |
+| `npm run build`         | Build production version for Chrome                    |
+| `npm run build:firefox` | Build production version for Firefox                   |
+| `npm run zip`           | Package Chrome extension                               |
+| `npm run zip:firefox`   | Package Firefox extension                              |
+| `npm run compile`       | TypeScript type checking (no file generation)          |
+| `npm run lint`          | Run ESLint with zero warnings allowed                  |
 
-- `npm run dev` - 启动 Chrome 浏览器的开发模式
+### Setup
-- `npm run dev:firefox` - 启动 Firefox 浏览器的开发模式
-- `npm run build` - 构建 Chrome 浏览器的生产版本
-- `npm run build:firefox` - 构建 Firefox 浏览器的生产版本
-- `npm run zip` - 打包 Chrome 扩展
-- `npm run zip:firefox` - 打包 Firefox 扩展
-- `npm run compile` - TypeScript 类型检查（不生成文件）
-- `npm run lint` - 运行 ESLint 检查
 
-### 依赖与准备
+- Dependencies install automatically runs `wxt prepare` via postinstall hook
+- Husky Git hooks are initialized via `prepare` script
 
-- `npm install` - 安装依赖
+## Architecture Overview
-- `postinstall` 会自动运行 `wxt prepare` 准备开发环境
-- `prepare` 钩子会初始化 Husky Git 钩子
 
-### CI/CD
+### Tech Stack
 
-- GitHub Actions 配置: `.github/workflows/node.js.yml`
+- **Framework**: WXT (Web Extension Toolkit)
-- 在 main 分支推送或 PR 时触发
+- **Frontend**: React 19 + TypeScript
-- 使用 Node.js 22.x 运行 build
+- **UI Library**: Material UI (MUI)
-- 测试命令当前被注释（项目暂无测试）
+- **Date Handling**: dayjs (with UTC and timezone plugins)
+- **Communication**: @webext-core/messaging
+- **Storage**: Chrome Storage API with type-safe wrapper
 
-## 项目架构
+### Directory Structure
-
-### 技术栈
-
-- **框架**: WXT (Web Extension Toolkit) - 浏览器扩展开发框架
-- **前端**: React 19 + TypeScript
-- **UI 库**: Material UI (MUI)
-- **日期处理**: dayjs (含 UTC 和时区插件)
-- **通信**: @webext-core/messaging
-
-### 目录结构
 
 ```
-├── entrypoints/          # 浏览器扩展入口点
+entrypoints/          # Browser extension entry points
-│   ├── background.ts     # 后台脚本（处理扩展安装/更新，注入内容脚本）
+├── background.ts     # Background script (injects content scripts)
-│   ├── content.ts        # 内容内容脚本（注入到页面，当前为空占位）
+├── content.ts        # Content script (injected into pages)
-│   ├── popup/            # 扩展弹窗界面
+├── popup/            # Extension popup interface
-│   │   ├── App.tsx       # 弹窗主应用
+│   ├── App.tsx       # Popup main application (handles routing)
-│   │   ├── main.tsx      # 弹窗入口
+│   ├── main.tsx      # Popup entry point
-│   │   ├── index.html    # 弹窗 HTML
+│   ├── index.html    # Popup HTML
-│   │   └── pages/       # 弹窗页面
+│   └── pages/        # Popup pages
-│   │       └── TimestampPage.tsx  # 时间戳转换页面（核心功能）
+│       ├── TimestampPage.tsx      # Timestamp conversion
-│   └── options/         # 选项页面（当前为静态 HTML）
+│       └── StorageCleanerPage.tsx # Storage cleaning
-│       └── index.html    # 选项页 HTML
+└── options/          # Options page (static HTML)
-├── utils/                # 工具函数
+utils/                # Utility functions
-│   ├── chromeStorage.ts  # Chrome Storage 工具（类型安全封装）
+types/                # TypeScript type definitions
-│   ├── dayjs.ts          # dayjs 配置（UTC + 时区插件）
+public/               # Static assets
-│   └── messages.tsx     # 扩展消息通信工具（@webext-core/messaging）
-├── types/                # 类型定义
-│   └── storage.d.ts      # StorageSchema 类型定义
-├── constants/            # 常量定义（当前为空）
-└── public/               # 静态资源
 ```
 
-### 核心功能
+### Extension Entry Points
 
-#### 时间戳转换工具 (entrypoints/popup/pages/TimestampPage.tsx)
+- **Background Script**: Listens for install/update events, injects content scripts into valid tabs
+- **Content Script**: Matches all URLs (`<all_urls>`), runs at document start (currently placeholder)
+- **Popup**: Main interface with tab-based navigation between timestamp conversion and storage cleaning
+- **Options Page**: Static HTML page, can be extended as settings interface
 
-- 实时显示当前时间戳（毫秒/秒可切换）
+## Core Features
-- 时间戳 → 日期时间转换
-- 日期时间 → 时间戳转换
-- 支持多个时区（亚洲/上海、美洲/纽约、欧洲/伦敦）
-- 一键复制功能
-- 输入验证和错误提示
 
-### 扩展入口点
+### Timestamp Conversion Tool (`entrypoints/popup/pages/TimestampPage.tsx`)
 
-- **后台脚本** (`entrypoints/background.ts`):
+- Real-time current timestamp display (milliseconds/seconds toggle)
-  - 监听扩展安装/更新事件
+- Timestamp ↔ date/time conversion
-  - 自动向所有有效标签页注入内容脚本
+- Support for multiple timezones (Asia/Shanghai, America/New_York, Europe/London)
-  - 过滤受限协议（chrome://, about:// 等）
+- One-click copy functionality
+- Input validation and error handling
 
-- **内容脚本** (`entrypoints/content.ts`):
+### Storage Cleaning Tool (`entrypoints/popup/pages/StorageCleanerPage.tsx`)
-  - 匹配所有 URL (`<all_urls>`)
-  - 在文档开始时运行
-  - 当前为占位符，无实际逻辑
 
-- **弹窗** (`entrypoints/popup/`):
+- Automatically reads current domain
-  - 主入口显示 TimestampPage
+- Cleans multiple storage types: localStorage, sessionStorage, IndexedDB, Cookies, Cache Storage, Service Workers
-  - 提供时间戳转换的完整功能
+- User-selectable storage types (all selected by default)
+- Confirmation dialog to prevent accidental cleaning
+- Cleaning result statistics display
+- Auto-refresh page after cleaning option
+- User preferences persistence
 
-- **选项页** (`entrypoints/options/`):
+### Data Storage
-  - 当前为静态 HTML 页面
-  - 可扩展为设置界面
 
-### 数据存储
+Uses Chrome Storage API with type-safe wrapper (`utils/chromeStorage.ts`):
 
-使用 Chrome Storage API 进行持久化存储：
+- **Storage Schema** (`types/storage.d.ts`): Interface-based type definitions
+- **Current storage keys**:
+  - `app/currentRoute`: Current active page route (default: 'timestamp')
+  - `app/visiblePages`: List of visible pages (default: ['timestamp', 'storageCleaner'])
+  - `app/lastRoute`: Last accessed route (legacy)
+  - `app/theme`: Theme settings
+  - `storageCleaner/preferences`: Storage cleaner preferences (autoRefresh, selectedTypes)
 
-- 类型安全的封装 (`utils/chromeStorage.ts`)
+## Development Workflow
-- 基于接口定义的 Schema (`types/storage.d.ts`)
-- 当前支持的存储键：
-  - `app/lastRoute`: 上次访问的路由
-  - `app/theme`: 主题设置
 
-### 消息通信
+### Browser Compatibility
 
-使用 `@webext-core/messaging` 库实现类型安全的扩展内通信：
+- Supports Chrome and Firefox browsers
+- Uses WXT framework to abstract browser differences
 
-- 定义在 `utils/messages.tsx`
+### Code Quality
-- 当前 ProtocolMap 为空（预留接口）
 
-### 关键配置文件
+- **ESLint**: Zero warnings enforced (`npm run lint`)
+- **Husky**: Git hook management
+- **lint-staged**: Ensures staged files comply (ESLint + TypeScript + Prettier)
+- **Prettier**: Code formatting (100 char line width, 2 space indent, single quotes, trailing comma)
 
-#### wxt.config.ts
+### TypeScript Configuration
 
-- 启用 React 模块 (`@wxt-dev/module-react`)
+- Strict mode enabled (`strict: true`)
-- 配置 manifest 权限和 host_permissions
+- `noImplicitAny` set to `false` (allows implicit any)
-- 使用 Terser 压缩（强制 ASCII 编码）
+- Unused variables/parameters cause errors (`noUnusedLocals`, `noUnusedParameters`)
-- 配置图标和选项页
+- Module resolution mode: Bundler
+- Path alias: `@/*` maps to project root
+- Excludes test files from type checking
 
-#### manifest 权限
+### Path Aliases
+
+- Use `@/` prefix for project-relative imports (e.g., `@/utils/chromeStorage`)
+- Configured in `tsconfig.json` paths
+
+## Configuration & Implementation
+
+### `wxt.config.ts`
+
+- Enables React module (`@wxt-dev/module-react`)
+- Configures manifest permissions and host_permissions
+- Uses Terser compression (forces ASCII encoding)
+- Configures icons and options page
+
+### Manifest Permissions
 
 ```typescript
 permissions: [
   'storage',           // Chrome Storage
-  'unlimitedStorage',  // 无限制存储
+  'unlimitedStorage',  // Unlimited storage
-  'clipboardWrite',    // 剪贴板写入（复制功能）
+  'clipboardWrite',    // Clipboard write (copy functionality)
-  'activeTab',         // 当前标签页访问
+  'activeTab',         // Current tab access
-  'scripting',         // 脚本注入
+  'scripting',         // Script injection
-  'tabs',              // 标签页管理
+  'tabs',              // Tab management
-  'debugger',          // 调试器权限
+  'debugger',          // Debugger permissions
+  'cookies',           // Cookies access (added for storage cleaning)
 ],
-host_permissions: ['<all_urls>']  // 访问所有网站
+host_permissions: ['<all_urls>']  // Access all websites
 ```
 
-## 开发注意事项
+### Storage Cleaning Implementation Details
 
-### 浏览器兼容性
+- **Cookies**: Uses `chrome.cookies` API directly in extension context
+- **Other storage types**: Uses `chrome.scripting.executeScript` to inject cleaning scripts into page context
+- **Restricted page filtering**: chrome://, about://, edge://, view-source://, file://, data://
+- **IndexedDB**: Uses `indexedDB.databases()` to get database list, handles `onblocked` events
+- **Service Workers**: Unregisters to prevent re-caching
+- **Cache Storage**: Uses `caches` API to clear all caches
 
-- 支持 Chrome 和 Firefox 浏览器
+### Messaging System
-- 使用 WXT 框架抽象浏览器差异
 
-### 代码质量
+- Uses `@webext-core/messaging` library for type-safe extension communication
+- Defined in `utils/messages.tsx`
+- Current ProtocolMap is empty (reserved for future use)
 
-- 使用 ESLint 进行代码检查（零警告）
+## CI/CD & Project Context
-- Husky 用于 Git 钩子管理
-- Lint-staged 确保暂存文件符合规范（ESLint + TypeScript + Prettier）
-- Prettier 用于代码格式化
-- Prettier 配置: 100 字符行宽，2 空格缩进，单引号，trailing comma
 
-### TypeScript 配置
+### GitHub Actions Workflow (`.github/workflows/node.js.yml`)
 
-- 严格模式开启（`strict: true`）
+- Triggers on push to main branch or pull requests
-- `noImplicitAny` 设置为 `false`（允许隐式 any）
+- Uses Node.js 20.x and 22.x for multi-version testing
-- 未使用变量/参数会报错（`noUnusedLocals`, `noUnusedParameters`）
+- Runs ESLint, TypeScript compilation, and build steps
-- 模块解析模式：Bundler
+- Test commands are currently commented (project has no tests)
-- 排除测试文件（`**/*.test.tsx`, `**/*.test.ts`）以避免类型检查
 
-### 项目历史
+### Project History
 
-近期重构（根据 git 历史）：
+Recent refactoring streamlined the project:
 
-- 移除了录制回放功能
+- Removed recording and playback functionality
-- 移除了测试页面
+- Removed test pages
-- 精简为单页面时间戳工具
+- Streamlined to single-page timestamp tool
-- 将 storage 工具类重命名为 storageUtil
+- Renamed storage utility class to storageUtil
+- Added storage cleaning functionality with persistent preferences
+- Added route persistence for popup navigation

components/Button.tsx

@@ -0,0 +1,32 @@
+import { Button as MuiButton, ButtonProps as MuiButtonProps } from '@mui/material';
+
+export type ButtonProps = MuiButtonProps;
+
+export function Button({ sx = [], ...props }: ButtonProps) {
+  return (
+    <MuiButton
+      disableElevation
+      disableRipple
+      {...props}
+      sx={[
+        {
+          py: 1.6,
+          borderRadius: 4,
+          fontSize: '1rem',
+          fontWeight: 600,
+          textTransform: 'none',
+          transition: 'all 0.2s cubic-bezier(0.4, 0, 0.2, 1)',
+          '&:hover': {
+            transform: 'translateY(-1px)',
+          },
+          '&:active': {
+            transform: 'translateY(0)',
+          },
+        },
+        ...(Array.isArray(sx) ? sx : [sx]),
+      ]}
+    />
+  );
+}
+
+export default Button;

components/GlobalSnackbar.tsx

@@ -0,0 +1,178 @@
+import { useState } from 'react';
+import { Snackbar, Alert, type SxProps, type Theme, alpha } from '@mui/material';
+
+export type SnackbarSeverity = 'success' | 'info' | 'warning' | 'error';
+
+export interface GlobalSnackbarProps {
+  /** 消息内容 */
+  message: string;
+  /** 是否显示 */
+  open: boolean;
+  /** 关闭回调 */
+  onClose: () => void;
+  /** 消息级别：影响颜色 */
+  severity?: SnackbarSeverity;
+  /** 自动隐藏时间，毫秒，0 不自动关闭 */
+  autoHideDuration?: number;
+  /** 弹出位置 */
+  anchorOrigin?: {
+    vertical: 'top' | 'bottom';
+    horizontal: 'left' | 'center' | 'right';
+  };
+  /** 是否使用 Alert 包裹（false 则使用原生 Snackbar message） */
+  showAlert?: boolean;
+  /** Alert 是否隐藏图标 */
+  hideIcon?: boolean;
+  /** 自定义样式，透传给 Snackbar */
+  sx?: SxProps<Theme>;
+  /** 自定义样式，透传给 Alert（仅当 showAlert=true 时生效） */
+  alertSx?: SxProps<Theme>;
+}
+
+export interface SnackbarOptions {
+  severity?: SnackbarSeverity;
+  autoHideDuration?: number;
+  hideIcon?: boolean;
+  showAlert?: boolean;
+}
+
+export interface UseSnackbarResult {
+  snackbarProps: GlobalSnackbarProps;
+  showMessage: (message: string, options?: SnackbarOptions) => void;
+  closeMessage: () => void;
+}
+
+const defaultProps: Required<
+  Pick<
+    GlobalSnackbarProps,
+    'severity' | 'autoHideDuration' | 'anchorOrigin' | 'showAlert' | 'hideIcon'
+  >
+> = {
+  severity: 'info',
+  autoHideDuration: 2000,
+  anchorOrigin: { vertical: 'bottom', horizontal: 'center' },
+  showAlert: true,
+  hideIcon: false,
+};
+
+export function GlobalSnackbar({
+  message,
+  open,
+  onClose,
+  severity = defaultProps.severity,
+  autoHideDuration = defaultProps.autoHideDuration,
+  anchorOrigin = defaultProps.anchorOrigin,
+  showAlert = defaultProps.showAlert,
+  hideIcon = defaultProps.hideIcon,
+  sx,
+  alertSx,
+}: GlobalSnackbarProps) {
+  // 共享的固定定位样式
+  const fixedSx: SxProps<Theme> = {
+    position: 'fixed',
+    bottom: '24px !important', // 固定在视口底部
+    left: '50% !important',
+    transform: 'translateX(-50%) !important',
+    zIndex: (theme) => theme.zIndex.tooltip + 100,
+    maxWidth: '90%',
+    width: 'max-content',
+  };
+
+  if (showAlert) {
+    return (
+      <Snackbar
+        open={open}
+        autoHideDuration={autoHideDuration}
+        onClose={onClose}
+        anchorOrigin={anchorOrigin}
+        disableWindowBlurListener
+        sx={[fixedSx, ...(Array.isArray(sx) ? sx : [sx])]}
+      >
+        <Alert
+          severity={severity}
+          variant="filled"
+          icon={hideIcon ? false : undefined}
+          sx={[
+            { 
+              borderRadius: '50px',
+              px: 2.5,
+              py: 0.2,
+              minWidth: '140px',
+              display: 'flex',
+              alignItems: 'center',
+              justifyContent: 'center',
+              fontWeight: 800,
+              fontSize: '0.75rem',
+              letterSpacing: '0.02em',
+              backgroundImage: 'none',
+              boxShadow: (theme: Theme) => `0 12px 32px ${alpha(theme.palette[severity].main, 0.35)}`,
+              
+              '& .MuiAlert-icon': {
+                mr: 0.5,
+                fontSize: '1.1rem',
+                color: '#fff'
+              },
+              '& .MuiAlert-message': {
+                color: '#fff',
+                padding: '6px 0',
+                textAlign: 'center'
+              }
+            },
+            ...(Array.isArray(alertSx) ? alertSx : [alertSx]),
+          ]}
+        >
+          {message}
+        </Alert>
+      </Snackbar>
+    );
+  }
+
+  return (
+    <Snackbar
+      open={open}
+      autoHideDuration={autoHideDuration}
+      onClose={onClose}
+      anchorOrigin={anchorOrigin}
+      message={message}
+      sx={[fixedSx, ...(Array.isArray(sx) ? sx : [sx])]}
+    />
+  );
+}
+
+export function useSnackbar(initialOptions?: SnackbarOptions): UseSnackbarResult {
+  const [open, setOpen] = useState(false);
+  const [message, setMessage] = useState('');
+  const [options, setOptions] = useState<SnackbarOptions>(initialOptions || {});
+
+  const showMessage = (newMessage: string, newOptions: SnackbarOptions = {}) => {
+    setMessage(newMessage);
+    setOptions({ ...initialOptions, ...newOptions });
+    setOpen(true);
+  };
+
+  const closeMessage = () => {
+    setOpen(false);
+  };
+
+  const handleClose = (_event?: React.SyntheticEvent | Event, reason?: string) => {
+    if (reason === 'clickaway') return;
+    closeMessage();
+  };
+
+  const snackbarProps: GlobalSnackbarProps = {
+    message,
+    open,
+    onClose: handleClose,
+    severity: options.severity,
+    autoHideDuration: options.autoHideDuration,
+    hideIcon: options.hideIcon,
+  };
+
+  return {
+    snackbarProps,
+    showMessage,
+    closeMessage,
+  };
+}
+
+export default GlobalSnackbar;

components/RouterContainer.tsx

@@ -0,0 +1,35 @@
+import { Box } from '@mui/material';
+import { ROUTES } from '@/config/routes';
+import { useRouter } from '@/providers/RouterProvider';
+import { useMemo } from 'react';
+
+export default function RouterContainer() {
+  const { currentPage, isLoaded } = useRouter();
+
+  const animationClass = useMemo(() => {
+    return currentPage === 'dashboard' ? 'page-transition-dashboard' : 'page-transition-enter';
+  }, [currentPage]);
+
+  if (!isLoaded) {
+    return <div className="app">Loading...</div>;
+  }
+
+  const currentRoute = ROUTES.find(route => route.key === currentPage);
+
+  return (
+    <Box
+      key={currentPage} // Trigger animation on navigation
+      className={animationClass}
+      sx={{
+        flex: 1,
+        overflowY: 'auto',
+        overflowX: 'hidden',
+        scrollbarGutter: 'stable',
+        display: 'flex',
+        flexDirection: 'column',
+      }}
+    >
+      {currentRoute && <currentRoute.component />}
+    </Box>
+  );
+}

components/StorageCleanerConfirm.tsx

@@ -0,0 +1,107 @@
+import {
+  Dialog,
+  DialogTitle,
+  DialogContent,
+  DialogActions,
+  Typography,
+  Box,
+  Chip,
+} from '@mui/material';
+import type { StorageCleanerOptions } from '@/types/storage';
+import Button from '@/components/Button';
+
+export interface StorageCleanerConfirmProps {
+  open: boolean;
+  onClose: () => void;
+  onConfirm: () => void;
+  options: StorageCleanerOptions;
+}
+
+export function StorageCleanerConfirm({
+  open,
+  onClose,
+  onConfirm,
+  options,
+}: StorageCleanerConfirmProps) {
+  const selectedOptions = Object.entries(options)
+    .filter(([_, value]) => value)
+    .map(([key, _]) => key);
+
+  return (
+    <Dialog
+      open={open}
+      onClose={onClose}
+      fullWidth
+      maxWidth="xs"
+      slotProps={{
+        paper: {
+          sx: {
+            borderRadius: 5,
+            backgroundImage: 'none',
+            boxShadow: '0 24px 48px -12px rgba(0,0,0,0.15)',
+            p: 1
+          },
+        },
+      }}
+    >
+      <DialogTitle sx={{ textAlign: 'center', pt: 3, pb: 1, fontWeight: 900, letterSpacing: '-0.5px', fontSize: '1.25rem' }}>
+        确认清理数据？
+      </DialogTitle>
+      
+      <DialogContent sx={{ textAlign: 'center', pb: 2 }}>
+        <Typography variant="body2" color="text.secondary" sx={{ mb: 3, fontWeight: 500 }}>
+          您将清除当前页面的选定存储项。
+        </Typography>
+        
+        <Box sx={{ display: 'flex', flexWrap: 'wrap', gap: 1, justifyContent: 'center', mb: 3 }}>
+          {selectedOptions.map((opt) => (
+            <Chip 
+              key={opt} 
+              label={opt} 
+              size="small" 
+              sx={{ 
+                bgcolor: 'grey.50', 
+                fontWeight: 600, 
+                color: 'text.secondary',
+                fontSize: '0.7rem',
+                border: '1px solid',
+                borderColor: 'grey.200'
+              }} 
+            />
+          ))}
+        </Box>
+
+        <Typography variant="caption" sx={{ color: '#ff9800', fontWeight: 700, bgcolor: '#fff4e5', px: 1.5, py: 0.5, borderRadius: 2 }}>
+          ⚠️ 此操作不可撤销
+        </Typography>
+      </DialogContent>
+
+      <DialogActions sx={{ p: 2.5, gap: 1.5 }}>
+        <Button 
+          variant="text" 
+          onClick={onClose} 
+          fullWidth
+          sx={{ fontWeight: 700, color: 'text.secondary', borderRadius: 3 }}
+        >
+          取消
+        </Button>
+        <Button 
+          variant="contained" 
+          onClick={onConfirm} 
+          fullWidth
+          sx={{ 
+            bgcolor: '#ff9800', 
+            '&:hover': { bgcolor: '#f57c00' },
+            fontWeight: 800,
+            borderRadius: 3,
+            boxShadow: 'none'
+          }}
+        >
+          确认清理
+        </Button>
+      </DialogActions>
+    </Dialog>
+  );
+}
+
+export default StorageCleanerConfirm;

components/ToolCard.tsx

@@ -0,0 +1,114 @@
+import { Box, Typography, Stack } from '@mui/material';
+import AutoAwesomeIcon from '@mui/icons-material/AutoAwesome'; // Sparkles for AI
+import ArrowForwardIosIcon from '@mui/icons-material/ArrowForwardIos';
+import React from 'react';
+
+interface ToolCardProps {
+  title: string;
+  description?: string;
+  snapshot?: React.ReactNode;
+  colorCode: string;
+  icon: React.ReactNode;
+  onClick: () => void;
+  hasAI?: boolean;
+}
+
+export default function ToolCard({ title, description, snapshot, colorCode, icon, onClick, hasAI }: ToolCardProps) {
+  return (
+    <Box
+      onClick={onClick}
+      sx={{
+        position: 'relative',
+        bgcolor: 'background.paper',
+        borderRadius: 4,
+        p: 2.5,
+        cursor: 'pointer',
+        border: '1px solid',
+        borderColor: 'grey.100',
+        transition: 'all 0.3s cubic-bezier(0.4, 0, 0.2, 1)',
+        display: 'flex',
+        flexDirection: 'column',
+        gap: 1.5,
+        '&:hover': { 
+          borderColor: colorCode,
+          transform: 'translateY(-4px)',
+          boxShadow: `0 12px 24px -10px ${colorCode}33`, // 20% opacity of colorCode
+          '& .arrow-icon': {
+            transform: 'translateX(4px)',
+            color: colorCode
+          }
+        }
+      }}
+    >
+      <Stack direction="row" justifyContent="space-between" alignItems="flex-start">
+        <Stack direction="row" spacing={1.5} alignItems="center">
+          <Box 
+            sx={{ 
+              display: 'flex', 
+              alignItems: 'center', 
+              justifyContent: 'center',
+              width: 40,
+              height: 40,
+              borderRadius: 3,
+              bgcolor: `${colorCode}11`, // 7% opacity
+              color: colorCode
+            }}
+          >
+            {icon}
+          </Box>
+          <Box>
+            <Typography 
+              variant="subtitle1" 
+              sx={{ 
+                fontWeight: 700, 
+                lineHeight: 1.2,
+                color: 'text.primary',
+                display: 'flex',
+                alignItems: 'center',
+                gap: 0.5
+              }}
+            >
+              {title}
+              {hasAI && <AutoAwesomeIcon sx={{ fontSize: 14, color: '#f5b041' }} />}
+            </Typography>
+            {description && (
+              <Typography 
+                variant="caption" 
+                sx={{ 
+                  color: 'text.secondary',
+                  fontWeight: 500,
+                  display: 'block',
+                  mt: 0.5
+                }}
+              >
+                {description}
+              </Typography>
+            )}
+          </Box>
+        </Stack>
+        <ArrowForwardIosIcon 
+          className="arrow-icon"
+          sx={{ 
+            fontSize: 12, 
+            color: 'grey.300', 
+            mt: 0.5,
+            transition: 'all 0.3s ease'
+          }} 
+        />
+      </Stack>
+
+      {snapshot && (
+        <Box 
+          sx={{ 
+            mt: 'auto',
+            pt: 1.5,
+            borderTop: '1px dashed',
+            borderColor: 'grey.100'
+          }}
+        >
+          {snapshot}
+        </Box>
+      )}
+    </Box>
+  );
+}

components/TopBar.tsx

@@ -0,0 +1,78 @@
+import { Box, IconButton, Typography, Stack, Tooltip } from '@mui/material';
+import SettingsIcon from '@mui/icons-material/Settings';
+import OpenInNewIcon from '@mui/icons-material/OpenInNew';
+import ArrowBackIosNewIcon from '@mui/icons-material/ArrowBackIosNew';
+import { useRouter } from '@/providers/RouterProvider';
+
+export default function TopBar({ onOpenOptions }: { onOpenOptions: () => void }) {
+  const { currentPage, goBack } = useRouter();
+
+  const handleDetach = () => {
+    // 弹出脱离窗口 (以独立面板形式打开当前 URL)
+    chrome.windows.create({
+      url: window.location.href,
+      type: 'panel',
+      width: 420,
+      height: 600
+    });
+  };
+
+  const isDashboard = currentPage === 'dashboard';
+
+  return (
+    <Stack 
+      direction="row" 
+      justifyContent="space-between" 
+      alignItems="center" 
+      sx={{ 
+        px: 2, 
+        py: 1.5, 
+        borderBottom: '1px solid',
+        borderColor: 'grey.100',
+        bgcolor: 'background.paper',
+        zIndex: 1100
+      }}
+    >
+      <Box sx={{ width: 40 }}>
+        {!isDashboard && (
+          <IconButton 
+            size="small" 
+            onClick={goBack}
+            sx={{ 
+              bgcolor: 'grey.50',
+              '&:hover': { bgcolor: 'grey.200' }
+            }}
+          >
+            <ArrowBackIosNewIcon sx={{ fontSize: 14 }} />
+          </IconButton>
+        )}
+      </Box>
+
+      <Typography 
+        variant="subtitle2" 
+        sx={{ 
+          fontWeight: 800, 
+          letterSpacing: '0.5px',
+          textTransform: 'uppercase',
+          fontSize: '0.75rem',
+          color: 'text.secondary'
+        }}
+      >
+        Testing Tools
+      </Typography>
+
+      <Stack direction="row" spacing={1} sx={{ width: 80, justifyContent: 'flex-end' }}>
+        <Tooltip title="独立窗口模式">
+          <IconButton size="small" onClick={handleDetach}>
+            <OpenInNewIcon sx={{ fontSize: 18 }} />
+          </IconButton>
+        </Tooltip>
+        <Tooltip title="设置">
+          <IconButton size="small" onClick={onOpenOptions}>
+            <SettingsIcon sx={{ fontSize: 18 }} />
+          </IconButton>
+        </Tooltip>
+      </Stack>
+    </Stack>
+  );
+}

config/routes.ts

@@ -0,0 +1,58 @@
+import type { PageType } from '@/types/storage';
+import DashboardPage from '@/entrypoints/popup/pages/DashboardPage';
+import TimestampPage from '@/entrypoints/popup/pages/TimestampPage';
+import StorageCleanerPage from '@/entrypoints/popup/pages/StorageCleanerPage';
+import OpenUrlPage from '@/entrypoints/popup/pages/OpenUrlPage';
+import OpenUrlViewerPage from '@/entrypoints/popup/pages/OpenUrlViewerPage';
+
+export interface RouteConfig {
+  key: PageType;
+  label: string;
+  defaultVisible: boolean;
+  component: React.ComponentType;
+}
+
+export const ROUTES: RouteConfig[] = [
+  {
+    key: 'dashboard',
+    label: 'Dashboard',
+    defaultVisible: true,
+    component: DashboardPage,
+  },
+  {
+    key: 'timestamp',
+    label: '时间戳',
+    defaultVisible: true,
+    component: TimestampPage,
+  },
+  {
+    key: 'storageCleaner',
+    label: '存储清理',
+    defaultVisible: true,
+    component: StorageCleanerPage,
+  },
+  {
+    key: 'openUrl',
+    label: 'Open Url',
+    defaultVisible: true,
+    component: OpenUrlPage,
+  },
+  {
+    key: 'openUrlViewer',
+    label: '查看',
+    defaultVisible: false,
+    component: OpenUrlViewerPage,
+  },
+];
+
+export function getRouteByKey(key: PageType): RouteConfig | undefined {
+  return ROUTES.find(route => route.key === key);
+}
+
+export function getDefaultVisibleRoutes(): PageType[] {
+  return ROUTES.filter(route => route.defaultVisible).map(route => route.key);
+}
+
+export function getAllRouteKeys(): PageType[] {
+  return ROUTES.map(route => route.key);
+}

docs/superpowers/plans/2026-04-05-popup-layout-fix-plan.md

@@ -0,0 +1,32 @@
+# 实施计划：修复 Popup 布局与滚动条样式
+
+## 1. 目标
+
+按照设计规范实施固定高度布局与极简滚动条，确保扩展弹窗显示稳定且美观。
+
+## 2. 实施步骤
+
+### 2.1 CSS 核心样式更新 (`entrypoints/popup/App.css`)
+
+1. **视口锁定**: 更新 `html`, `body` 样式，固定 `width: 400px`, `height: 600px`。
+2. **根容器改造**:
+   - 将 `.app` 修改为 Flex 容器：`display: flex; flex-direction: column; height: 100%; overflow: hidden;`。
+   - 移除 `margin: 0 auto;` 和 `min-height: 100%;`。
+3. **滚动条变量与全局注入**:
+   - 在 `:root` 中定义 `--sb-` 开头的滚动条样式变量。
+   - 使用 `*::-webkit-scrollbar` 系列伪元素定义全局极简滚动条。
+
+### 2.2 React 结构重构 (`entrypoints/popup/App.tsx`)
+
+1. **注入滚动容器**: 在 `nav-container` 之后，将所有的页面渲染（`TimestampPage`, `StorageCleanerPage`）包裹在一个统一的 `Box` 中。
+2. **设置容器样式**: 给该 `Box` 设置 `sx={{ flex: 1, overflowY: 'auto', scrollbarGutter: 'stable' }}`。
+
+### 2.3 质量保障
+
+1. **Lint 检测**: 运行 `npm run lint` 检查样式变量引用和 JSX 结构。
+2. **类型检查**: 运行 `npm run compile` 验证 MUI 组件属性。
+
+## 3. 验证计划
+
+- 手动切换导航栏，观察窗口尺寸是否维持在 600px。
+- 在“存储清理”页面展开所有选项，观察右侧是否出现极细滚动条，且不会挤压内容。

docs/superpowers/specs/2026-03-25-claude-md-reorganization-design.md

@@ -0,0 +1,97 @@
+# CLAUDE.md Reorganization Design
+
+**Date**: 2026-03-25
+**Status**: Approved & Implemented
+**Related Files**: `/CLAUDE.md`
+
+## Overview
+
+Reorganized the existing CLAUDE.md file to improve clarity, flow, and usability for future Claude Code instances working with this browser extension project.
+
+## Problem Statement
+
+The existing CLAUDE.md file contained comprehensive information but had organizational issues:
+- Mixed development commands, architecture, and implementation details
+- Redundant information in multiple sections
+- Lack of clear logical flow from setup to development to reference
+- Missing some technical details (path aliases, messaging system explanation)
+
+## Design Goals
+
+1. **Improve logical flow**: Structure content in order of developer needs
+2. **Reduce redundancy**: Eliminate duplicate information
+3. **Enhance readability**: Use clearer headings and organization
+4. **Maintain completeness**: Preserve all essential information
+5. **Add missing context**: Include path aliases and other technical specifics
+
+## Solution Design
+
+### Reorganized Structure
+
+1. **Quick Start** - Essential commands and setup (first thing developers need)
+2. **Architecture Overview** - Tech stack and high-level structure (context before diving in)
+3. **Core Features** - What the extension does (timestamp conversion, storage cleaning)
+4. **Development Workflow** - How to work with the codebase (browser compatibility, code quality tools)
+5. **Configuration & Implementation** - Reference details (wxt.config.ts, manifest permissions)
+6. **CI/CD & Project Context** - Background information (GitHub Actions, project history)
+
+### Key Improvements
+
+1. **Command Table**: Replaced bullet list with markdown table for better readability
+2. **Simplified Directory Structure**: Removed excessive detail while maintaining clarity
+3. **Logical Grouping**: Related information placed together (e.g., all storage cleaning details)
+4. **Added Missing Information**: Path aliases (`@/`), TypeScript configuration highlights
+5. **Clearer Section Titles**: More descriptive headings that indicate content purpose
+
+### Content Preservation
+
+All essential information from the original CLAUDE.md was preserved:
+- All npm commands and their purposes
+- Tech stack details
+- Directory structure (simplified but complete)
+- Core feature descriptions
+- Storage cleaning implementation details
+- Manifest permissions
+- CI/CD workflow information
+- Project history context
+
+## Implementation Details
+
+### File Changes
+- **CLAUDE.md**: Complete rewrite with reorganized structure
+- **No other files modified**: Only documentation changes
+
+### Structural Changes
+1. **Moved commands to front**: Developers need these immediately
+2. **Grouped related topics**: All storage-related information together
+3. **Separated workflow from reference**: Development process vs. configuration details
+4. **Added visual hierarchy**: Clear section headings and subheadings
+
+### Content Additions
+1. **Path aliases section**: Explains `@/` import pattern
+2. **TypeScript configuration highlights**: Key settings called out
+3. **Better cross-references**: Links between related sections
+
+## Validation
+
+The reorganized CLAUDE.md was validated against:
+- ✅ All original commands preserved
+- ✅ All architectural information maintained
+- ✅ All feature descriptions included
+- ✅ All configuration details retained
+- ✅ Improved readability and flow
+- ✅ Added missing technical context
+
+## Success Criteria
+
+1. **Quick access to commands**: Developers can find essential npm scripts immediately
+2. **Clear understanding of architecture**: Tech stack and structure explained upfront
+3. **Logical information flow**: Follows natural developer workflow
+4. **Complete reference**: All necessary information preserved and organized
+5. **Improved usability**: Easier for Claude Code instances to understand and work with the project
+
+## Future Considerations
+
+1. **Regular updates**: CLAUDE.md should be updated when project structure changes
+2. **User feedback**: Monitor if the reorganization improves developer experience
+3. **Additional context**: Consider adding troubleshooting tips or common issues section if needed

docs/superpowers/specs/2026-04-05-popup-layout-fix-design.md

@@ -0,0 +1,48 @@
+# 设计规范：Popup 弹窗固定高度与极简滚动条
+
+## 1. 目标
+
+解决 Chrome 扩展弹窗高度“只增不减”的布局问题，提供稳定的 600px 固定高度体验，并实现符合极简主义设计规范的可复用滚动条样式。
+
+## 2. 核心架构方案 (方案 A)
+
+采用 **Flex 布局 + 视口锁定** 的策略，将弹窗尺寸固定在 `400px * 600px`。
+
+### 2.1 容器层级设计
+
+- **`html`, `body`**: 锁定为 `400px * 600px`，并设置 `overflow: hidden` 防止出现双滚动条。
+- **`.app` (根容器)**:
+  - 设置为 `display: flex; flex-direction: column;`。
+  - 高度撑满父级 (`100%`)。
+  - 锁定 `overflow: hidden`。
+- **`nav-container` (导航栏)**:
+  - 位于顶部，高度固定，不参与 Flex 缩放。
+- **内容展示区 (Page Container)**:
+  - 设置 `flex: 1`，自动填充剩余空间。
+  - 设置 `overflow-y: auto`，启用局部滚动。
+  - 设置 `scrollbar-gutter: stable`，预留滚动条空间，防止布局抖动。
+
+## 3. 极简滚动条设计规范
+
+为了确保在所有页面和组件中表现一致，采用全局 Webkit 伪元素定制方案。
+
+### 3.1 变量定义
+
+在 `:root` 中定义 CSS 变量以增强兼容性和可维护性：
+
+- `--sb-width`: `6px` (极细)
+- `--sb-thumb-color`: `rgba(0, 0, 0, 0.1)` (浅灰色半透明)
+- `--sb-thumb-hover`: `rgba(0, 0, 0, 0.18)` (悬停时微深)
+- `--sb-track-color`: `transparent` (背景完全透明)
+
+### 3.2 样式表现
+
+- **滑块 (Thumb)**: 胶囊状圆角 (`10px`)。
+- **背景剪裁 (Background Clip)**: 使用 `content-box` 结合透明边框来实现滑块与边缘的微距感。
+- **自动应用**: 使用通配符 `*::-webkit-scrollbar` 确保全局所有溢出容器均自动继承此样式。
+
+## 4. 成功准则
+
+- 切换“时间戳”和“存储清理”页面时，浏览器窗口大小保持 `600px` 不变。
+- 当页面内容超过视口时，右侧显示细长、半透明的滚动条。
+- 内容加载或 Accordion 展开时，页面水平方向不发生位移。

entrypoints/background.ts

@@ -2,6 +2,17 @@ import '../.wxt/types/imports.d.ts';
 import { browser } from 'wxt/browser';
 
 export default defineBackground(() => {
+  // 监听扩展图标点击事件，打开侧边栏
+  browser.action.onClicked.addListener(async (tab) => {
+    if (tab.id) {
+      try {
+        await browser.sidePanel.open({ tabId: tab.id });
+      } catch (err) {
+        console.error('Failed to open side panel:', err);
+      }
+    }
+  });
+
   // 监听扩展安装或更新事件
   browser.runtime.onInstalled.addListener(async ({ reason }) => {
     if (reason === 'install') {

entrypoints/options/App.css

@@ -0,0 +1,9 @@
+.app {
+  min-height: 100vh;
+  background-color: #f5f5f5;
+  font-family:
+    -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', 'Oxygen', 'Ubuntu', 'Cantarell',
+    'Fira Sans', 'Droid Sans', 'Helvetica Neue', sans-serif;
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+}

entrypoints/options/App.tsx

@@ -0,0 +1,182 @@
+import { useState, useEffect } from 'react';
+import {
+  Box,
+  Typography,
+  Paper,
+  Switch,
+  Button,
+  Snackbar,
+  Alert,
+  CircularProgress,
+  Stack,
+} from '@mui/material';
+import RefreshIcon from '@mui/icons-material/Refresh';
+import type { PageType } from '@/types/storage';
+import { storageUtil } from '@/utils/chromeStorage';
+import { ROUTES } from '@/config/routes';
+
+function App() {
+  const [visiblePages, setVisiblePages] = useState<PageType[]>([]);
+  const [isLoaded, setIsLoaded] = useState(false);
+  const [toast, setToast] = useState<string | null>(null);
+  const [toastSeverity, setToastSeverity] = useState<'success' | 'info' | 'warning'>('info');
+
+  useEffect(() => {
+    loadConfig();
+  }, []);
+
+  const loadConfig = async () => {
+    try {
+      const saved = await storageUtil.get('app/visiblePages', [
+        'timestamp',
+        'storageCleaner',
+        'openUrl',
+      ] as PageType[]);
+      setVisiblePages(saved ?? ['timestamp', 'storageCleaner', 'openUrl']);
+    } catch (error) {
+      console.error('Failed to load config:', error);
+      setVisiblePages(['timestamp', 'storageCleaner', 'openUrl']);
+    } finally {
+      setIsLoaded(true);
+    }
+  };
+
+  const handlePageToggle = async (page: PageType) => {
+    const isCurrentlyVisible = visiblePages.includes(page);
+    let newPages: PageType[];
+
+    if (isCurrentlyVisible) {
+      if (visiblePages.length <= 1) {
+        showToast('至少需要保留一个可见页面', 'warning');
+        return;
+      }
+      newPages = visiblePages.filter((p) => p !== page);
+    } else {
+      newPages = [...visiblePages, page];
+    }
+
+    try {
+      await storageUtil.set('app/visiblePages', newPages);
+      setVisiblePages(newPages);
+      const route = ROUTES.find((r) => r.key === page);
+      showToast(`已${isCurrentlyVisible ? '隐藏' : '显示'} ${route?.label || page}`, 'success');
+    } catch (error) {
+      console.error('Failed to save config:', error);
+      showToast('保存失败', 'warning');
+    }
+  };
+
+  const handleRestoreDefaults = async () => {
+    try {
+      const defaults = ROUTES.filter((route) => route.defaultVisible).map((route) => route.key);
+      await storageUtil.set('app/visiblePages', defaults);
+      setVisiblePages(defaults);
+      showToast('已恢复默认', 'success');
+    } catch (error) {
+      console.error('Failed to restore defaults:', error);
+      showToast('恢复失败', 'warning');
+    }
+  };
+
+  const showToast = (message: string, severity: 'success' | 'info' | 'warning') => {
+    setToast(message);
+    setToastSeverity(severity);
+  };
+
+  const handleCloseToast = () => setToast(null);
+
+  if (!isLoaded) {
+    return (
+      <Box
+        sx={{ display: 'flex', justifyContent: 'center', alignItems: 'center', minHeight: '100vh' }}
+      >
+        <CircularProgress size={24} />
+      </Box>
+    );
+  }
+
+  return (
+    <Box sx={{ p: 4, maxWidth: 600, mx: 'auto', minHeight: '100vh', bgcolor: 'grey.50' }}>
+      <Stack direction="row" justifyContent="space-between" alignItems="flex-start" sx={{ mb: 4 }}>
+        <Button
+          variant="text"
+          size="small"
+          onClick={handleRestoreDefaults}
+          startIcon={<RefreshIcon sx={{ fontSize: 16 }} />}
+          sx={{ color: 'text.secondary', fontWeight: 600 }}
+        >
+          恢复默认
+        </Button>
+      </Stack>
+
+      <Paper
+        elevation={0}
+        sx={{
+          borderRadius: 4,
+          border: '1px solid',
+          borderColor: 'grey.200',
+          overflow: 'hidden',
+          bgcolor: 'background.paper',
+        }}
+      >
+        <Box sx={{ display: 'flex', flexDirection: 'column' }}>
+          {ROUTES.filter((route) => route.key !== 'dashboard' && route.key !== 'openUrlViewer').map(
+            (route, index, array) => {
+              const isChecked = visiblePages.includes(route.key);
+              const isDisabled = isChecked && visiblePages.length === 1;
+
+              return (
+                <Box
+                  key={route.key}
+                  sx={{
+                    display: 'flex',
+                    alignItems: 'center',
+                    justifyContent: 'space-between',
+                    p: 2.5,
+                    borderBottom: index === array.length - 1 ? 'none' : '1px solid',
+                    borderColor: 'grey.100',
+                    transition: 'all 0.2s',
+                    '&:hover': { bgcolor: 'grey.50' },
+                  }}
+                >
+                  <Box>
+                    <Typography variant="body1" sx={{ fontWeight: 700, color: 'text.primary' }}>
+                      {route.label}
+                    </Typography>
+                    <Typography variant="caption" color="text.secondary">
+                      {isChecked ? '已在 Dashboard 启用' : '已在 Dashboard 隐藏'}
+                    </Typography>
+                  </Box>
+                  <Switch
+                    size="small"
+                    checked={isChecked}
+                    onChange={() => handlePageToggle(route.key)}
+                    disabled={isDisabled}
+                  />
+                </Box>
+              );
+            },
+          )}
+        </Box>
+      </Paper>
+
+      <Snackbar
+        open={!!toast}
+        autoHideDuration={2000}
+        onClose={handleCloseToast}
+        anchorOrigin={{ vertical: 'bottom', horizontal: 'center' }}
+      >
+        <Alert
+          onClose={handleCloseToast}
+          severity={toastSeverity}
+          variant="filled"
+          sx={{ borderRadius: 2, fontWeight: 600 }}
+        >
+          {toast}
+        </Alert>
+      </Snackbar>
+    </Box>
+  );
+}
+
+export default App;

entrypoints/options/index.html

@@ -1,11 +1,12 @@
 <!DOCTYPE html>
-<html lang="en">
+<html lang="zh-CN">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>Document</title>
+    <title>扩展设置 - Testing Tools</title>
   </head>
   <body>
-    Hello Options Page
+    <div id="root"></div>
+    <script type="module" src="./main.tsx"></script>
   </body>
 </html>

entrypoints/options/main.tsx

@@ -0,0 +1,11 @@
+import React from 'react';
+import ReactDOM from 'react-dom/client';
+import App from './App';
+import './App.css';
+import '@mui/material/styles';
+
+ReactDOM.createRoot(document.getElementById('root')!).render(
+  <React.StrictMode>
+    <App />
+  </React.StrictMode>,
+);

entrypoints/popup/App.css

@@ -1,18 +1,4 @@
-/* 隐藏页面滚动条 */
+/* 极简滚动条变量 */
-html,
-body {
-  margin: 0;
-  padding: 0;
-  width: 100%;
-  height: 100%;
-  scrollbar-gutter: stable;
-}
-
-/* 隐藏body滚动条但允许滚动 */
-body {
-  overflow: auto;
-}
-
 :root {
   /* 统一圆角变量 */
   --radius: 8px;
@@ -25,55 +11,81 @@ body {
   /* 统一按钮文字颜色变量 */
   --btn-text: #333333;
   --border: 1px solid #e0e0e0;
+
+  /* 滚动条变量 */
+  --sb-width: 6px;
+  --sb-thumb-color: rgba(0, 0, 0, 0.1);
+  --sb-thumb-hover: rgba(0, 0, 0, 0.2);
+  --sb-track-color: transparent;
+}
+
+/* 强制固定视口尺寸 */
+html,
+body,
+#root {
+  margin: 0;
+  padding: 0;
+  width: 400px;
+  height: 600px;
+  overflow: hidden; /* 禁用外层滚动 */
+}
+
+/* 全局极简滚动条定制 */
+*::-webkit-scrollbar {
+  width: var(--sb-width);
+}
+
+*::-webkit-scrollbar-track {
+  background: var(--sb-track-color);
+}
+
+*::-webkit-scrollbar-thumb {
+  background: var(--sb-thumb-color);
+  border-radius: 10px;
+  background-clip: content-box;
+  border: 1px solid transparent;
+}
+
+*::-webkit-scrollbar-thumb:hover {
+  background: var(--sb-thumb-hover);
 }
 
 .app {
-  width: 400px;
+  display: flex;
-  min-height: 100%;
+  flex-direction: column;
-  margin: 0 auto;
+  width: 100%;
+  height: 100%;
   box-sizing: border-box;
   font-family:
     -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
-  overflow-x: hidden;
+  overflow: hidden; /* 内部由 flex 子项控制滚动 */
+}
+
+/* Animations */
+@keyframes slideInRight {
+  from {
+    transform: translateX(30px);
+    opacity: 0;
+  }
+  to {
+    transform: translateX(0);
+    opacity: 1;
+  }
 }
 
 @keyframes fadeIn {
   from {
     opacity: 0;
-    transform: translateY(-5px);
   }
   to {
     opacity: 1;
-    transform: translateY(0);
   }
 }
 
-/* 导航容器 */
+.page-transition-enter {
-.nav-container {
+  animation: slideInRight 0.3s cubic-bezier(0.25, 0.8, 0.25, 1) forwards;
-  display: flex;
-  justify-content: center;
-  margin-top: 16px;
-  margin-bottom: 16px;
-  gap: 8px;
 }
 
-/* 导航按钮 */
+.page-transition-dashboard {
-.nav-button {
+  animation: fadeIn 0.3s ease-out forwards;
-  padding: 8px 16px;
-  border: 1px solid var(--btn-bg);
-  border-radius: var(--radius);
-  background: transparent;
-  color: var(--btn-text);
-  cursor: pointer;
-  transition: all 0.2s ease;
-  font-size: 14px;
-}
-
-.nav-button:hover {
-  background: var(--btn-bg);
-}
-
-.nav-button.active {
-  background: var(--btn-bg);
-  font-weight: 500;
 }

entrypoints/popup/App.tsx

@@ -1,87 +1,20 @@
-import { useState, useEffect } from 'react';
-import { Box } from '@mui/material';
-import type { PageType } from '@/types/storage';
-import { storageUtil } from '@/utils/chromeStorage';
-import TimestampPage from './pages/TimestampPage';
-import StorageCleanerPage from './pages/StorageCleanerPage';
 import './App.css';
-
+import RouterProvider from '@/providers/RouterProvider';
-
+import TopBar from '@/components/TopBar';
-const PAGE_CONFIG = {
+import RouterContainer from '@/components/RouterContainer';
-  timestamp: { label: '时间戳', defaultVisible: true },
-  storageCleaner: { label: '存储清理', defaultVisible: true },
-} as const satisfies Record<PageType, { label: string; defaultVisible: boolean }>;
 
 function App() {
-  const [currentPage, setCurrentPage] = useState<PageType>('timestamp');
+  const handleOpenOptions = () => {
-  const [visiblePages, setVisiblePages] = useState<PageType[]>(['timestamp', 'storageCleaner']);
+    chrome.runtime.openOptionsPage();
-  const [isLoaded, setIsLoaded] = useState(false);
-
-  useEffect(() => {
-    loadInitialData();
-  }, []);
-
-  useEffect(() => {
-    if (isLoaded) {
-      storageUtil.set('app/currentRoute', currentPage);
-    }
-  }, [currentPage, isLoaded]);
-
-  const loadInitialData = async () => {
-    try {
-      const [savedRoute, savedVisiblePages] = await Promise.all([
-        storageUtil.get('app/currentRoute', 'timestamp'),
-        storageUtil.get('app/visiblePages', ['timestamp', 'storageCleaner'] as PageType[]),
-      ]);
-
-      if (savedRoute) {
-        setCurrentPage(savedRoute);
-      }
-
-      if (savedVisiblePages) {
-        setVisiblePages(savedVisiblePages);
-      }
-    } catch (error) {
-      console.error('Failed to load initial data:', error);
-    } finally {
-      setIsLoaded(true);
-    }
   };
 
-  const handlePageChange = (page: PageType) => {
-    setCurrentPage(page);
-  };
-
-  const NavButton = ({ pageKey }: { pageKey: PageType }) => {
-    const config = PAGE_CONFIG[pageKey];
-    if (!config) return null;
-
-    return (
-      <Box key={pageKey}>
-        <button
-          className={currentPage === pageKey ? 'nav-button active' : 'nav-button'}
-          onClick={() => handlePageChange(pageKey)}
-        >
-          {config.label}
-        </button>
-      </Box>
-    );
-  };
-
-  if (!isLoaded) {
-    return <div className="app">Loading...</div>;
-  }
-
   return (
-    <div className="app">
+    <RouterProvider defaultRoute="dashboard" syncRoute={false}>
-      <Box className="nav-container">
+      <div className="app" style={{ display: 'flex', flexDirection: 'column', height: '100vh', overflow: 'hidden' }}>
-        {(Object.keys(PAGE_CONFIG) as PageType[])
+        <TopBar onOpenOptions={handleOpenOptions} />
-          .filter((key) => visiblePages.includes(key))
+        <RouterContainer />
-          .map((key) => <NavButton key={key} pageKey={key} />)}
+      </div>
-      </Box>
+    </RouterProvider>
-      {currentPage === 'timestamp' && <TimestampPage />}
-      {currentPage === 'storageCleaner' && <StorageCleanerPage />}
-    </div>
   );
 }
 

entrypoints/popup/pages/DashboardPage.tsx

@@ -0,0 +1,78 @@
+import { Box, Typography, Container } from '@mui/material';
+import { useRouter } from '@/providers/RouterProvider';
+import ToolCard from '@/components/ToolCard';
+import AccessTimeIcon from '@mui/icons-material/AccessTime';
+import StorageIcon from '@mui/icons-material/Storage';
+import LanguageIcon from '@mui/icons-material/Language';
+import type { PageType } from '@/types/storage';
+import { useEffect, useState } from 'react';
+import dayjs from '@/utils/dayjs';
+
+export default function DashboardPage() {
+  const { navigateTo, visiblePages } = useRouter();
+  const [now, setNow] = useState(dayjs());
+
+  useEffect(() => {
+    const timer = setInterval(() => setNow(dayjs()), 1000);
+    return () => clearInterval(timer);
+  }, []);
+
+  const isVisible = (key: string) => visiblePages.includes(key as PageType);
+
+  return (
+    <Box sx={{ bgcolor: 'grey.50', minHeight: '100%', pb: 4 }}>
+      <Container maxWidth="sm" sx={{ py: 3, px: 2 }}>
+        <Box sx={{ display: 'flex', flexDirection: 'column', gap: 2 }}>
+          {isVisible('timestamp') && (
+            <ToolCard
+              title="时间戳"
+              description="Unix 毫秒数转换与格式化"
+              colorCode="#2196f3"
+              icon={<AccessTimeIcon sx={{ fontSize: 20 }} />}
+              onClick={() => navigateTo('timestamp')}
+              snapshot={
+                <Box
+                  sx={{ display: 'flex', justifyContent: 'space-between', alignItems: 'center' }}
+                >
+                  <Typography
+                    sx={{
+                      fontFamily: 'monospace',
+                      fontWeight: 600,
+                      color: '#2196f3',
+                      fontSize: '0.85rem',
+                    }}
+                  >
+                    {now.valueOf()}
+                  </Typography>
+                  <Typography sx={{ fontSize: '0.7rem', color: 'text.secondary' }}>
+                    {now.format('HH:mm:ss')}
+                  </Typography>
+                </Box>
+              }
+            />
+          )}
+
+          {isVisible('storageCleaner') && (
+            <ToolCard
+              title="存储管理"
+              description="清理缓存、Cookies 及本地存储"
+              colorCode="#ff9800"
+              icon={<StorageIcon sx={{ fontSize: 20 }} />}
+              onClick={() => navigateTo('storageCleaner')}
+            />
+          )}
+
+          {isVisible('openUrl') && (
+            <ToolCard
+              title="URL 实验室"
+              description="多环境跳转与安全性预检"
+              colorCode="#9c27b0"
+              icon={<LanguageIcon sx={{ fontSize: 20 }} />}
+              onClick={() => navigateTo('openUrl')}
+            />
+          )}
+        </Box>
+      </Container>
+    </Box>
+  );
+}

entrypoints/popup/pages/OpenUrlPage.tsx

@@ -0,0 +1,403 @@
+import { useState, useEffect, useCallback, Fragment } from 'react';
+import {
+  Box,
+  TextField,
+  Alert,
+  List,
+  ListItem,
+  IconButton,
+  Typography,
+  Divider,
+  Container,
+  Stack,
+  alpha,
+  Theme,
+  Tooltip,
+} from '@mui/material';
+import DeleteIcon from '@mui/icons-material/Delete';
+import OpenInNewIcon from '@mui/icons-material/OpenInNew';
+import VisibilityIcon from '@mui/icons-material/Visibility';
+import AddIcon from '@mui/icons-material/Add';
+import LanguageIcon from '@mui/icons-material/Language';
+import LinkIcon from '@mui/icons-material/Link';
+import Button from '@/components/Button';
+import GlobalSnackbar, { useSnackbar } from '@/components/GlobalSnackbar';
+import { storageUtil } from '@/utils/chromeStorage';
+import { useRouter } from '@/providers/RouterProvider';
+import type { OpenUrlPreferences, OpenUrlEntry } from '@/types/storage';
+
+const THEME_COLOR = '#9c27b0';
+
+const INPUT_STYLE = {
+  '& .MuiOutlinedInput-root': {
+    bgcolor: 'background.paper',
+    borderRadius: 3.5,
+    border: '1px solid',
+    borderColor: 'grey.100',
+    transition: 'all 0.25s cubic-bezier(0.4, 0, 0.2, 1)',
+    '& fieldset': { border: 'none' },
+    '&:hover': { borderColor: 'grey.300', bgcolor: 'grey.50' },
+    '&.Mui-focused': {
+      bgcolor: '#fff',
+      borderColor: THEME_COLOR,
+      boxShadow: (_theme: Theme) => `0 0 0 4px ${alpha(THEME_COLOR, 0.1)}`,
+    },
+  },
+  '& .MuiInputBase-input': {
+    py: 1.2,
+    px: 2,
+    fontSize: '0.85rem',
+    fontWeight: 600,
+  },
+  '& .MuiInputLabel-root': {
+    fontSize: '0.85rem',
+    fontWeight: 700,
+    color: 'text.secondary',
+    mb: 0.5,
+    '&.Mui-focused': { color: THEME_COLOR },
+  },
+};
+
+const DEFAULT_PREFERENCES: OpenUrlPreferences = {
+  entries: [],
+};
+
+export default function OpenUrlPage() {
+  const [entries, setEntries] = useState<OpenUrlEntry[]>(DEFAULT_PREFERENCES.entries);
+  const [newName, setNewName] = useState<string>('');
+  const [newUrl, setNewUrl] = useState<string>('');
+  const [isLoaded, setIsLoaded] = useState(false);
+  const { snackbarProps, showMessage } = useSnackbar();
+  const { syncNavigation } = useRouter();
+
+  const showMixedContentWarning =
+    newUrl.startsWith('http://') && !newUrl.includes('localhost') && !newUrl.includes('127.0.0.1');
+
+  const isValidUrl = (url: string) => {
+    if (!url.trim()) return false;
+    try {
+      new URL(url);
+      return true;
+    } catch {
+      return false;
+    }
+  };
+
+  useEffect(() => {
+    const loadPreferences = async () => {
+      try {
+        const saved = await storageUtil.get('openUrl/preferences', DEFAULT_PREFERENCES);
+        if (saved && saved.entries) {
+          setEntries(saved.entries);
+        }
+      } catch (error) {
+        console.error('Failed to load Open Url preferences:', error);
+      } finally {
+        setIsLoaded(true);
+      }
+    };
+    loadPreferences();
+  }, []);
+
+  const savePreferences = useCallback(() => {
+    const preferences: OpenUrlPreferences = { entries };
+    storageUtil.set('openUrl/preferences', preferences).catch((error) => {
+      console.error('Failed to save Open Url preferences:', error);
+    });
+  }, [entries]);
+
+  useEffect(() => {
+    if (!isLoaded) return;
+    const timer = setTimeout(() => {
+      savePreferences();
+    }, 500);
+    return () => clearTimeout(timer);
+  }, [entries, isLoaded, savePreferences]);
+
+  const handleAddEntry = () => {
+    if (!newName.trim()) {
+      showMessage('请输入名称', { severity: 'error' });
+      return;
+    }
+    if (!isValidUrl(newUrl)) {
+      showMessage('请输入有效的 URL', { severity: 'error' });
+      return;
+    }
+
+    setEntries([...entries, { name: newName.trim(), url: newUrl.trim() }]);
+    setNewName('');
+    setNewUrl('');
+    showMessage('添加成功', { severity: 'success' });
+  };
+
+  const handleDeleteEntry = (index: number) => {
+    const newEntries = [...entries];
+    newEntries.splice(index, 1);
+    setEntries(newEntries);
+    showMessage('删除成功', { severity: 'success' });
+  };
+
+  const handleOpenInSidebar = async (entry: OpenUrlEntry) => {
+    try {
+      await storageUtil.set('openUrl/currentUrl', entry.url);
+      syncNavigation('openUrlViewer');
+
+      const [currentTab] = await chrome.tabs.query({
+        active: true,
+        currentWindow: true,
+      });
+      const tabId = currentTab.id;
+      if (!tabId) {
+        showMessage('无法获取当前标签页', { severity: 'error' });
+        return;
+      }
+
+      await chrome.sidePanel.setOptions({
+        tabId,
+        path: 'sidepanel.html',
+        enabled: true,
+      });
+      await chrome.sidePanel.open({ windowId: currentTab.windowId });
+
+      // 仅当在 Popup 中时才关闭窗口，防止在侧边栏内点击预览时导致侧边栏关闭
+      if (window.location.pathname.includes('popup.html')) {
+        window.close();
+      }
+    } catch (error) {
+      console.error('Failed to open side panel:', error);
+      showMessage(`打开失败: ${(error as Error).message}`, { severity: 'error' });
+    }
+  };
+
+  const handleOpenInNewTab = (entry: OpenUrlEntry) => {
+    chrome.tabs.create({ url: entry.url });
+    window.close();
+  };
+
+  return (
+    <Box sx={{ pb: 3 }}>
+      <Container sx={{ py: 2 }}>
+        {/* Header */}
+        <Stack direction="row" spacing={1.5} alignItems="center" sx={{ mb: 2.5 }}>
+          <Box
+            sx={{
+              p: 1,
+              borderRadius: 2.5,
+              bgcolor: alpha(THEME_COLOR, 0.1),
+              color: THEME_COLOR,
+              display: 'flex',
+            }}
+          >
+            <LanguageIcon sx={{ fontSize: 20 }} />
+          </Box>
+          <Box sx={{ flex: 1 }}>
+            <Typography
+              variant="subtitle1"
+              fontWeight={900}
+              sx={{ letterSpacing: '-0.5px', lineHeight: 1.2 }}
+            >
+              URL 实验室
+            </Typography>
+            <Typography variant="caption" color="text.secondary" sx={{ fontWeight: 600 }}>
+              多环境跳转与安全性预检
+            </Typography>
+          </Box>
+        </Stack>
+
+        {/* Form Section */}
+        <Box
+          sx={{
+            bgcolor: 'background.paper',
+            p: 2,
+            borderRadius: 4,
+            border: '1px solid',
+            borderColor: 'grey.100',
+            mb: 3,
+            boxShadow: '0 4px 12px rgba(0,0,0,0.02)',
+          }}
+        >
+          <Stack spacing={2}>
+            <TextField
+              label="环境名称"
+              placeholder="例如: 本地文档"
+              value={newName}
+              onChange={(e) => setNewName(e.target.value)}
+              fullWidth
+              variant="outlined"
+              sx={INPUT_STYLE}
+              InputLabelProps={{ shrink: true }}
+            />
+            <TextField
+              label="目标 URL"
+              placeholder="例如: http://localhost:8000/docs"
+              value={newUrl}
+              onChange={(e) => setNewUrl(e.target.value)}
+              fullWidth
+              variant="outlined"
+              sx={INPUT_STYLE}
+              InputLabelProps={{ shrink: true }}
+            />
+
+            {showMixedContentWarning && (
+              <Alert
+                severity="warning"
+                sx={{
+                  borderRadius: 3,
+                  '& .MuiAlert-message': { fontSize: '0.7rem', fontWeight: 600, lineHeight: 1.4 },
+                }}
+              >
+                混合内容警告：当前 HTTPS 页面无法加载 HTTP 资源。
+              </Alert>
+            )}
+
+            <Button
+              variant="contained"
+              onClick={handleAddEntry}
+              disabled={!newName.trim() || !isValidUrl(newUrl)}
+              fullWidth
+              startIcon={<AddIcon />}
+              sx={{
+                py: 1.2,
+                borderRadius: 4,
+                bgcolor: THEME_COLOR,
+                fontWeight: 800,
+                boxShadow: 'none',
+                '&:hover': {
+                  bgcolor: alpha(THEME_COLOR, 0.85),
+                  boxShadow: `0 8px 24px ${alpha(THEME_COLOR, 0.2)}`,
+                },
+              }}
+            >
+              添加快捷方式
+            </Button>
+          </Stack>
+        </Box>
+
+        {/* List Section */}
+        <Box>
+          <Typography
+            variant="caption"
+            sx={{ color: 'text.secondary', fontWeight: 800, px: 1, mb: 1, display: 'block' }}
+          >
+            已保存的快捷方式 ({entries.length})
+          </Typography>
+
+          {entries.length === 0 ? (
+            <Box
+              sx={{
+                textAlign: 'center',
+                py: 4,
+                bgcolor: 'grey.50',
+                borderRadius: 4,
+                border: '1px dashed',
+                borderColor: 'grey.200',
+              }}
+            >
+              <LinkIcon sx={{ color: 'grey.300', fontSize: 40, mb: 1 }} />
+              <Typography
+                variant="caption"
+                color="text.disabled"
+                sx={{ display: 'block', fontWeight: 600 }}
+              >
+                暂无快捷方式，请在上方添加
+              </Typography>
+            </Box>
+          ) : (
+            <List
+              disablePadding
+              sx={{
+                bgcolor: 'background.paper',
+                borderRadius: 4,
+                border: '1px solid',
+                borderColor: 'grey.100',
+                overflow: 'hidden',
+              }}
+            >
+              {entries.map((entry, index) => (
+                <Fragment key={index}>
+                  <ListItem
+                    sx={{
+                      px: 2,
+                      py: 1.5,
+                      display: 'flex',
+                      alignItems: 'center',
+                      gap: 2,
+                      transition: 'background-color 0.2s',
+                      '&:hover': { bgcolor: 'grey.50' },
+                    }}
+                  >
+                    <Box sx={{ flex: 1, minWidth: 0 }}>
+                      <Typography
+                        variant="body2"
+                        sx={{ fontWeight: 800, color: 'text.primary' }}
+                        noWrap
+                      >
+                        {entry.name}
+                      </Typography>
+                      <Typography
+                        variant="caption"
+                        color="text.secondary"
+                        noWrap
+                        sx={{
+                          fontSize: '0.65rem',
+                          fontWeight: 500,
+                          display: 'block',
+                          mt: 0.2,
+                          fontFamily: 'monospace',
+                        }}
+                      >
+                        {entry.url}
+                      </Typography>
+                    </Box>
+                    <Stack direction="row" spacing={0.5}>
+                      <Tooltip title="在侧边栏预览">
+                        <IconButton
+                          size="small"
+                          onClick={() => handleOpenInSidebar(entry)}
+                          sx={{
+                            color: THEME_COLOR,
+                            bgcolor: alpha(THEME_COLOR, 0.05),
+                            '&:hover': { bgcolor: THEME_COLOR, color: '#fff' },
+                          }}
+                        >
+                          <VisibilityIcon sx={{ fontSize: 16 }} />
+                        </IconButton>
+                      </Tooltip>
+                      <Tooltip title="新标签页打开">
+                        <IconButton
+                          size="small"
+                          onClick={() => handleOpenInNewTab(entry)}
+                          sx={{
+                            color: 'grey.500',
+                            bgcolor: 'grey.100',
+                            '&:hover': { bgcolor: 'grey.600', color: '#fff' },
+                          }}
+                        >
+                          <OpenInNewIcon sx={{ fontSize: 16 }} />
+                        </IconButton>
+                      </Tooltip>
+                      <Tooltip title="删除">
+                        <IconButton
+                          size="small"
+                          onClick={() => handleDeleteEntry(index)}
+                          sx={{
+                            color: 'error.main',
+                            '&:hover': { color: 'error.dark', bgcolor: alpha('#f44336', 0.05) },
+                          }}
+                        >
+                          <DeleteIcon sx={{ fontSize: 16 }} />
+                        </IconButton>
+                      </Tooltip>
+                    </Stack>
+                  </ListItem>
+                  {index < entries.length - 1 && <Divider sx={{ mx: 2, borderColor: 'grey.50' }} />}
+                </Fragment>
+              ))}
+            </List>
+          )}
+        </Box>
+      </Container>
+      <GlobalSnackbar {...snackbarProps} />
+    </Box>
+  );
+}

entrypoints/popup/pages/OpenUrlViewerPage.tsx

@@ -0,0 +1,91 @@
+import { useState, useEffect } from 'react';
+import { Box, Typography } from '@mui/material';
+import { storageUtil } from '@/utils/chromeStorage';
+
+// 只允许 HTTP/HTTPS 协议，阻止危险协议
+const ALLOWED_PROTOCOLS = ['http:', 'https:'];
+
+export default function OpenUrlViewerPage() {
+  const [currentUrl, setCurrentUrl] = useState<string>('');
+  const [isLoaded, setIsLoaded] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+
+  // 验证 URL 是否安全
+  const validateUrl = (url: string): string | null => {
+    try {
+      const urlObj = new URL(url);
+      if (!ALLOWED_PROTOCOLS.includes(urlObj.protocol)) {
+        return `不支持的 URL 协议: ${urlObj.protocol}。仅允许 HTTP 和 HTTPS。`;
+      }
+      return null;
+    } catch {
+      return '无效的 URL 格式';
+    }
+  };
+
+  // 从存储加载当前选中的 URL
+  useEffect(() => {
+    const loadCurrentUrl = async () => {
+      try {
+        const saved = await storageUtil.get('openUrl/currentUrl', '');
+        if (saved) {
+          const validationError = validateUrl(saved);
+          if (validationError) {
+            setError(validationError);
+          } else {
+            setCurrentUrl(saved);
+            setError(null);
+          }
+        }
+      } catch (error) {
+        console.error('Failed to load current URL:', error);
+        setError('加载 URL 失败');
+      } finally {
+        setIsLoaded(true);
+      }
+    };
+    loadCurrentUrl();
+  }, []);
+
+  if (!isLoaded) {
+    return (
+      <Box sx={{ p: 2, flex: 1 }}>
+        <Typography color="text.secondary">Loading...</Typography>
+      </Box>
+    );
+  }
+
+  if (error) {
+    return (
+      <Box sx={{ p: 2, flex: 1 }}>
+        <Typography color="error">{error}</Typography>
+      </Box>
+    );
+  }
+
+  if (!currentUrl) {
+    return (
+      <Box sx={{ p: 2, flex: 1 }}>
+        <Typography color="text.secondary">
+          没有选中的 URL，请先在 OpenUrl 页面选择一个 URL 打开。
+        </Typography>
+      </Box>
+    );
+  }
+
+  return (
+    <Box sx={{ flex: 1, display: 'flex', flexDirection: 'column', overflow: 'hidden' }}>
+      <iframe
+        src={currentUrl}
+        title="OpenUrl Viewer"
+        sandbox="allow-same-origin allow-scripts allow-forms allow-popups allow-navigation"
+        style={{
+          flex: 1,
+          width: '100%',
+          border: 'none',
+          display: 'block',
+        }}
+      />
+    </Box>
+  );
+}

entrypoints/popup/pages/StorageCleanerPage.tsx

@@ -1,23 +1,35 @@
-import { useState, useEffect, useCallback } from 'react';
+import { useState, useEffect, useCallback, useRef } from 'react';
 import {
-  Paper,
   Typography,
   Box,
   Checkbox,
-  Button,
-  FormControlLabel,
   Alert,
-  Snackbar,
+  Divider,
+  Container,
+  Stack,
+  Switch,
+  Grid,
 } from '@mui/material';
-import RefreshIcon from '@mui/icons-material/Refresh';
 import WarningIcon from '@mui/icons-material/Warning';
+import StorageIcon from '@mui/icons-material/Storage';
+import Button from '@/components/Button';
+import GlobalSnackbar, { useSnackbar } from '@/components/GlobalSnackbar';
+import StorageCleanerConfirm from '@/components/StorageCleanerConfirm';
 import { storageUtil } from '@/utils/chromeStorage';
-import type { StorageCleanerOptions, CleaningResult, StorageCleanerPreferences } from 'types/storage';
+import type {
+  StorageCleanerOptions,
+  CleaningResult,
+  StorageCleanerPreferences,
+} from '@/types/storage';
 import {
   getCurrentTab,
   isRestrictedUrl,
   clearStorage,
   formatCleaningResult,
+  getCookieSize,
+  getLocalStorageSize,
+  getSessionStorageSize,
+  formatSize,
 } from '@/utils/storageCleaner';
 
 const DEFAULT_OPTIONS: StorageCleanerOptions = {
@@ -38,291 +50,403 @@ export default function StorageCleanerPage() {
   const [domain, setDomain] = useState<string>('');
   const [error, setError] = useState<string>('');
   const [options, setOptions] = useState<StorageCleanerOptions>(DEFAULT_OPTIONS);
+  const [sizes, setSizes] = useState<Record<string, number>>({});
   const [autoRefresh, setAutoRefresh] = useState<boolean>(true);
   const [loading, setLoading] = useState<boolean>(false);
   const [result, setResult] = useState<CleaningResult | null>(null);
   const [showConfirm, setShowConfirm] = useState<boolean>(false);
-  const [snackbar, setSnackbar] = useState<{ open: boolean; message: string }>({
+  const { snackbarProps, showMessage } = useSnackbar();
-    open: false,
+  const reloadTimeoutRef = useRef<NodeJS.Timeout | null>(null);
-    message: '',
-  });
 
-  // Load tab info and user preferences
   useEffect(() => {
-    const loadInfo = async () => {
+    return () => {
-      const tab = await getCurrentTab();
+      if (reloadTimeoutRef.current) clearTimeout(reloadTimeoutRef.current);
-
-      if (!tab || !tab.url) {
-        setError('无法获取当前标签页');
-        return;
-      }
-
-      if (isRestrictedUrl(tab.url)) {
-        setError('存储清理功能不支持此页面');
-        return;
-      }
-
-      setDomain(new URL(tab.url).hostname);
-
-      // Load user preferences
-      const prefs = await storageUtil.get(
-        'storageCleaner/preferences',
-        DEFAULT_PREFERENCES,
-      );
-      setAutoRefresh(prefs?.autoRefresh ?? DEFAULT_PREFERENCES.autoRefresh);
-      setOptions(prefs?.selectedTypes ?? DEFAULT_PREFERENCES.selectedTypes);
     };
+  }, []);
 
+  const loadInfo = async () => {
+    const tab = await getCurrentTab();
+    if (!tab || !tab.url) {
+      setError('无法获取当前标签页');
+      return;
+    }
+    if (isRestrictedUrl(tab.url)) {
+      setError('存储清理功能不支持此页面');
+      return;
+    }
+    const url = tab.url;
+    const tabId = tab.id!;
+    setDomain(new URL(url).hostname);
+
+    const [savedPrefs, cSize, lsSize, ssSize] = await Promise.all([
+      storageUtil.get('storageCleaner/preferences', DEFAULT_PREFERENCES),
+      getCookieSize(url),
+      getLocalStorageSize(tabId),
+      getSessionStorageSize(tabId),
+    ]);
+
+    setAutoRefresh(savedPrefs?.autoRefresh ?? DEFAULT_PREFERENCES.autoRefresh);
+    setOptions(savedPrefs?.selectedTypes ?? DEFAULT_PREFERENCES.selectedTypes);
+    setSizes({
+      cookies: cSize,
+      localStorage: lsSize,
+      sessionStorage: ssSize,
+    });
+  };
+
+  useEffect(() => {
     loadInfo();
   }, []);
 
-  const handleOptionChange = useCallback((key: keyof StorageCleanerOptions) => {
+  const handleAutoRefreshChange = useCallback(
-    setOptions((prev) => ({ ...prev, [key]: !prev[key] }));
+    async (checked: boolean) => {
-  }, []);
+      setAutoRefresh(checked);
+      await storageUtil.set('storageCleaner/preferences', {
+        autoRefresh: checked,
+        selectedTypes: options,
+      });
+    },
+    [options],
+  );
+
+  const handleOptionChange = useCallback(
+    async (key: keyof StorageCleanerOptions) => {
+      setOptions((prev) => {
+        const newOptions = { ...prev, [key]: !prev[key] };
+        storageUtil.set('storageCleaner/preferences', {
+          autoRefresh,
+          selectedTypes: newOptions,
+        });
+        return newOptions;
+      });
+    },
+    [autoRefresh],
+  );
+
+  const allSelected = Object.values(options).every(Boolean);
+  const someSelected = Object.values(options).some(Boolean) && !allSelected;
+
+  const handleSelectAll = useCallback(
+    async (checked: boolean) => {
+      const newOptions = {
+        localStorage: checked,
+        sessionStorage: checked,
+        indexedDB: checked,
+        cookies: checked,
+        cacheStorage: checked,
+        serviceWorkers: checked,
+      };
+      setOptions(newOptions);
+      await storageUtil.set('storageCleaner/preferences', {
+        autoRefresh,
+        selectedTypes: newOptions,
+      });
+    },
+    [autoRefresh],
+  );
 
   const handleClean = useCallback(async () => {
     const tab = await getCurrentTab();
-
     if (!tab || !tab.id || !tab.url) {
-      setSnackbar({ open: true, message: '无法获取当前标签页' });
+      showMessage('无法获取当前标签页');
       return;
     }
-
     setLoading(true);
-
     try {
       const cleaningResult = await clearStorage(tab.id, tab.url, options);
       setResult(cleaningResult);
-
-      // Save user preferences
-      await storageUtil.set('storageCleaner/preferences', {
-        autoRefresh,
-        selectedTypes: options,
-      });
-
-      // Auto refresh if enabled
       if (autoRefresh && cleaningResult.success && tab.id !== undefined) {
-        setSnackbar({ open: true, message: '页面即将刷新，Popup 将关闭' });
+        showMessage('清理成功，即将刷新页面');
-        setTimeout(() => {
+        reloadTimeoutRef.current = setTimeout(() => {
           chrome.tabs.reload(tab.id!);
         }, 1500);
+      } else {
+        loadInfo();
       }
     } catch (err) {
-      setSnackbar({ open: true, message: `清理失败: ${String(err)}` });
+      showMessage(`清理失败: ${String(err)}`, { severity: 'error' });
     } finally {
       setLoading(false);
       setShowConfirm(false);
     }
-  }, [options, autoRefresh]);
+  }, [options, autoRefresh, showMessage]);
-
-  const handleRefresh = useCallback(async () => {
-    const tab = await getCurrentTab();
-    if (tab?.id !== undefined) {
-      setSnackbar({ open: true, message: '页面即将刷新，Popup 将关闭' });
-      setTimeout(() => {
-        chrome.tabs.reload(tab.id!);
-      }, 1500);
-    }
-  }, []);
 
   if (error) {
     return (
-      <Paper sx={{ p: 2, m: 1, borderRadius: 2 }}>
+      <Container sx={{ py: 4 }}>
-        <Alert severity="error" icon={<WarningIcon />}>
+        <Alert severity="error" icon={<WarningIcon />} sx={{ borderRadius: 3 }}>
           {error}
         </Alert>
-      </Paper>
+      </Container>
     );
   }
 
-  return (
+  const totalSize = Object.values(sizes).reduce((acc, curr) => acc + curr, 0);
-    <Paper sx={{ p: 2, m: 1, borderRadius: 2 }}>
-      {/* Header */}
-      <Box sx={{ textAlign: 'center', mb: 2 }}>
-        <Typography variant="h5" component="h1" sx={{ mb: 1 }}>
-          存储清理
-        </Typography>
-        <Typography variant="body2" color="text.secondary">
-          当前页面: {domain || '加载中...'}
-        </Typography>
-      </Box>
 
-      {/* Storage Type Options */}
+  const OptionItem = ({
-      <Box sx={{ mb: 2 }}>
+    label,
-        <Typography variant="subtitle1" sx={{ mb: 1 }}>
+    checked,
-          选择要清理的存储类型：
+    size,
+    onChange,
+  }: {
+    label: string;
+    checked: boolean;
+    size?: number;
+    onChange: () => void;
+  }) => (
+    <Box
+      sx={{
+        display: 'flex',
+        justifyContent: 'space-between',
+        alignItems: 'center',
+        py: 0.6,
+        px: 1.2,
+        borderRadius: 2.5,
+        transition: 'all 0.2s',
+        '&:hover': { bgcolor: 'grey.50' },
+      }}
+    >
+      <Stack direction="row" spacing={0.8} alignItems="baseline">
+        <Typography
+          variant="caption"
+          fontWeight={700}
+          color="text.primary"
+          sx={{ fontSize: '0.75rem' }}
+        >
+          {label}
         </Typography>
-        <Box sx={{ display: 'flex', flexDirection: 'column', gap: 0.5 }}>
+        {size !== undefined && size > 0 && (
-          <FormControlLabel
+          <Typography
-            control={
+            variant="caption"
-              <Checkbox
+            sx={{ color: 'text.disabled', fontSize: '0.65rem', fontWeight: 500 }}
+          >
+            {formatSize(size)}
+          </Typography>
+        )}
+      </Stack>
+      <Checkbox
+        size="small"
+        checked={checked}
+        onChange={onChange}
+        color="warning"
+        sx={{ p: 0.5 }}
+      />
+    </Box>
+  );
+
+  return (
+    <Box sx={{ pb: 2 }}>
+      <Container sx={{ py: 2 }}>
+        {/* Domain Header */}
+        <Stack direction="row" spacing={1.5} alignItems="center" sx={{ mb: 2 }}>
+          <Box
+            sx={{
+              p: 1,
+              borderRadius: 2.5,
+              bgcolor: '#fff4e5',
+              color: '#ff9800',
+              display: 'flex',
+            }}
+          >
+            <StorageIcon sx={{ fontSize: 20 }} />
+          </Box>
+          <Box sx={{ flex: 1 }}>
+            <Stack direction="row" justifyContent="space-between" alignItems="center">
+              <Typography
+                variant="subtitle1"
+                fontWeight={900}
+                sx={{ letterSpacing: '-0.5px', lineHeight: 1.2 }}
+              >
+                存储清理
+              </Typography>
+              {totalSize > 0 && (
+                <Typography
+                  variant="caption"
+                  sx={{
+                    bgcolor: '#fff4e5',
+                    color: '#ff9800',
+                    px: 1,
+                    py: 0.2,
+                    borderRadius: 1.5,
+                    fontWeight: 800,
+                    fontSize: '0.65rem',
+                  }}
+                >
+                  已占用 {formatSize(totalSize)}
+                </Typography>
+              )}
+            </Stack>
+            <Typography
+              variant="caption"
+              color="text.secondary"
+              sx={{
+                fontWeight: 600,
+                display: 'block',
+                maxWidth: 220,
+                overflow: 'hidden',
+                textOverflow: 'ellipsis',
+                whiteSpace: 'nowrap',
+              }}
+            >
+              {domain || '加载中...'}
+            </Typography>
+          </Box>
+        </Stack>
+
+        {/* Storage Options Grid */}
+        <Box
+          sx={{
+            mb: 2,
+            border: '1px solid',
+            borderColor: 'grey.100',
+            borderRadius: 4,
+            p: 0.8,
+            bgcolor: 'background.paper',
+          }}
+        >
+          <Grid container spacing={0}>
+            <Grid size={6}>
+              <OptionItem
+                label="LocalStorage"
                 checked={options.localStorage}
+                size={sizes.localStorage}
                 onChange={() => handleOptionChange('localStorage')}
               />
-            }
+            </Grid>
-            label="localStorage"
+            <Grid size={6}>
-          />
+              <OptionItem
-          <FormControlLabel
+                label="Session"
-            control={
-              <Checkbox
                 checked={options.sessionStorage}
+                size={sizes.sessionStorage}
                 onChange={() => handleOptionChange('sessionStorage')}
               />
-            }
+            </Grid>
-            label="sessionStorage"
+            <Grid size={6}>
-          />
+              <OptionItem
-          <FormControlLabel
+                label="IndexedDB"
-            control={
-              <Checkbox
                 checked={options.indexedDB}
                 onChange={() => handleOptionChange('indexedDB')}
               />
-            }
+            </Grid>
-            label="IndexedDB"
+            <Grid size={6}>
-          />
+              <OptionItem
-          <FormControlLabel
+                label="Cookies"
-            control={
-              <Checkbox
                 checked={options.cookies}
+                size={sizes.cookies}
                 onChange={() => handleOptionChange('cookies')}
               />
-            }
+            </Grid>
-            label="Cookies"
+            <Grid size={6}>
-          />
+              <OptionItem
-          <FormControlLabel
+                label="Cache"
-            control={
-              <Checkbox
                 checked={options.cacheStorage}
                 onChange={() => handleOptionChange('cacheStorage')}
               />
-            }
+            </Grid>
-            label="Cache Storage"
+            <Grid size={6}>
-          />
+              <OptionItem
-          <FormControlLabel
+                label="Workers"
-            control={
-              <Checkbox
                 checked={options.serviceWorkers}
                 onChange={() => handleOptionChange('serviceWorkers')}
               />
-            }
+            </Grid>
-            label="Service Workers"
+          </Grid>
+          <Divider sx={{ my: 0.8, borderColor: 'grey.50' }} />
+          <Box
+            sx={{
+              display: 'flex',
+              justifyContent: 'space-between',
+              alignItems: 'center',
+              px: 1.2,
+              py: 0.4,
+            }}
+          >
+            <Typography
+              variant="caption"
+              fontWeight={800}
+              sx={{ color: 'text.secondary', fontSize: '0.65rem' }}
+            >
+              全选所有项
+            </Typography>
+            <Checkbox
+              size="small"
+              checked={allSelected}
+              indeterminate={someSelected}
+              onChange={(e) => handleSelectAll(e.target.checked)}
+              color="warning"
+              sx={{ p: 0.5 }}
+            />
+          </Box>
+        </Box>
+
+        {/* Auto Refresh Toggle */}
+        <Box
+          sx={{
+            mb: 2,
+            p: 1.2,
+            borderRadius: 4,
+            bgcolor: 'background.paper',
+            border: '1px solid',
+            borderColor: 'grey.100',
+            display: 'flex',
+            justifyContent: 'space-between',
+            alignItems: 'center',
+          }}
+        >
+          <Typography variant="caption" fontWeight={700}>
+            清理后自动刷新页面
+          </Typography>
+          <Switch
+            size="small"
+            checked={autoRefresh}
+            onChange={(e) => handleAutoRefreshChange(e.target.checked)}
+            color="warning"
           />
         </Box>
-      </Box>
 
-      {/* Auto Refresh Option */}
+        {/* Primary Action */}
-      <Box sx={{ mb: 2 }}>
-        <FormControlLabel
-          control={
-            <Checkbox
-              checked={autoRefresh}
-              onChange={(e) => setAutoRefresh(e.target.checked)}
-            />
-          }
-          label="清理完成后自动刷新页面"
-        />
-      </Box>
-
-      {/* Action Buttons */}
-      <Box sx={{ display: 'flex', gap: 1, mb: 2 }}>
         <Button
           variant="contained"
           onClick={() => setShowConfirm(true)}
+          sx={{
+            py: 1.2,
+            borderRadius: 4,
+            bgcolor: '#ff9800',
+            fontWeight: 800,
+            fontSize: '0.85rem',
+            boxShadow: 'none',
+            '&:hover': { bgcolor: '#f57c00', boxShadow: '0 8px 16px rgba(255, 152, 0, 0.2)' },
+          }}
           disabled={loading}
           fullWidth
         >
-          {loading ? '清理中...' : '清理'}
+          {loading ? '正在清理...' : '立即清理'}
         </Button>
-      </Box>
 
-      {/* Result Display */}
+        {/* Result & Refresh Secondary Action */}
-      {result && (
+        {result && (
-        <Box sx={{ mb: 2 }}>
+          <Box sx={{ mt: 2 }}>
-          <Alert
+            <Alert
-            severity={result.success ? 'success' : 'error'}
+              severity={result.success ? 'success' : 'error'}
-            sx={{ mb: !autoRefresh && result.success ? 1 : 0 }}
+              sx={{
-          >
+                borderRadius: 2.5,
-            {result.success ? formatCleaningResult(result) : result.error || '清理失败'}
+                py: 0,
-          </Alert>
+                '& .MuiAlert-message': { fontSize: '0.75rem', fontWeight: 600 },
-          {!autoRefresh && result.success && (
+              }}
-            <Button
-              variant="outlined"
-              startIcon={<RefreshIcon />}
-              onClick={handleRefresh}
-              fullWidth
             >
-              刷新页面
+              {result.success ? formatCleaningResult(result) : result.error || '清理失败'}
-            </Button>
+            </Alert>
-          )}
-        </Box>
-      )}
-
-      {/* Confirmation Dialog */}
-      {showConfirm && (
-        <Paper
-          sx={{
-            position: 'absolute',
-            top: 0,
-            left: 0,
-            right: 0,
-            bottom: 0,
-            bgcolor: 'rgba(255,255,255, 0.95)',
-            display: 'flex',
-            flexDirection: 'column',
-            alignItems: 'center',
-            justifyContent: 'center',
-            gap: 2,
-            zIndex: 10,
-          }}
-        >
-          <Typography variant="h6">确认清理</Typography>
-          <Typography variant="body2" color="text.secondary" sx={{ textAlign: 'center', mb: 1 }}>
-            将清理以下存储类型：
-          </Typography>
-          <Box sx={{ mb: 1 }}>
-            {options.localStorage && (
-              <Typography variant="body2">- localStorage</Typography>
-            )}
-            {options.sessionStorage && (
-              <Typography variant="body2">- sessionStorage</Typography>
-            )}
-            {options.indexedDB && <Typography variant="body2">- IndexedDB</Typography>}
-            {options.cookies && <Typography variant="body2">- Cookies</Typography>}
-            {options.cacheStorage && (
-              <Typography variant="body2">- Cache Storage</Typography>
-            )}
-            {options.serviceWorkers && (
-              <Typography variant="body2">- Service Workers</Typography>
-            )}
           </Box>
-          <Typography
+        )}
-            variant="body2"
+      </Container>
-            color="text.secondary"
-            sx={{ textAlign: 'center', mb: 1 }}
-          >
-            此操作不可撤销。
-          </Typography>
-          <Box sx={{ display: 'flex', gap: 1 }}>
-            <Button variant="outlined" onClick={() => setShowConfirm(false)}>
-              取消
-            </Button>
-            <Button variant="contained" color="error" onClick={handleClean}>
-              确认清理
-            </Button>
-          </Box>
-        </Paper>
-      )}
 
-      {/* Snackbar */}
+      <StorageCleanerConfirm
-      <Snackbar
+        open={showConfirm}
-        open={snackbar.open}
+        onClose={() => setShowConfirm(false)}
-        autoHideDuration={3000}
+        onConfirm={handleClean}
-        onClose={() => setSnackbar({ ...snackbar, open: false })}
+        options={options}
-      >
+      />
-        <Alert severity="info" variant="filled">
+      <GlobalSnackbar {...snackbarProps} />
-          {snackbar.message}
+    </Box>
-        </Alert>
-      </Snackbar>
-    </Paper>
   );
 }

entrypoints/popup/pages/TimestampPage.tsx

@@ -1,26 +1,25 @@
 import React, { useState, useEffect, useCallback, useMemo } from 'react';
 import dayjs from '@/utils/dayjs';
 import {
-  Button,
   TextField,
   Select,
   MenuItem,
-  Paper,
   Stack,
   Typography,
   Box,
   IconButton,
-  Snackbar,
-  Alert,
-  InputAdornment,
   alpha,
   Tooltip,
   Theme,
+  Container,
+  Fade,
+  Divider,
 } from '@mui/material';
+import GlobalSnackbar, { useSnackbar } from '@/components/GlobalSnackbar';
 import ContentCopyIcon from '@mui/icons-material/ContentCopy';
-import SwapHorizIcon from '@mui/icons-material/SwapHoriz'; 
 import CheckIcon from '@mui/icons-material/Check';
 import AccessTimeIcon from '@mui/icons-material/AccessTime';
+import Button from '@/components/Button';
 
 // ================= 常量配置 =================
 const DATE_FORMAT = 'YYYY/MM/DD HH:mm:ss';
@@ -31,33 +30,45 @@ type ZoneType = (typeof ZONES)[number];
 
 const INPUT_STYLE = {
   '& .MuiOutlinedInput-root': {
-    bgcolor: 'grey.50',
+    bgcolor: 'background.paper',
-    borderRadius: 3,
+    borderRadius: 3.5,
+    border: '1px solid',
+    borderColor: 'grey.100',
     transition: 'all 0.25s cubic-bezier(0.4, 0, 0.2, 1)',
     '& fieldset': { border: 'none' },
-    '&:hover': { bgcolor: 'grey.100' },
+    '&:hover': { borderColor: 'grey.300', bgcolor: 'grey.50' },
     '&.Mui-focused': {
       bgcolor: '#fff',
-      boxShadow: (theme: Theme) => `0 0 0 2px ${alpha(theme.palette.primary.main, 0.2)}, 0 4px 12px rgba(0,0,0,0.03)`,
+      borderColor: 'primary.main',
+      boxShadow: (theme: Theme) => `0 0 0 4px ${alpha(theme.palette.primary.main, 0.1)}`,
     },
     '&.Mui-error': {
-      boxShadow: (theme: Theme) => `0 0 0 2px ${alpha(theme.palette.error.main, 0.2)}`,
+      borderColor: 'error.main',
+      boxShadow: (theme: Theme) => `0 0 0 4px ${alpha(theme.palette.error.main, 0.1)}`,
     },
   },
-  '& .MuiInputBase-input': { py: 1.5, fontFamily: 'monospace' },
+  '& .MuiInputBase-input': { 
+    py: 1.4, 
+    px: 2,
+    fontSize: '0.9rem',
+    fontFamily: 'monospace',
+    fontWeight: 600
+  },
 };
 
-// ================= 子组件：实时时钟 =================
+// ================= 子组件：实时时钟 (优化交互) =================
 interface LiveClockProps {
   unit: UnitType;
   onCopy: (val: string) => void;
   onUseNow: (val: number) => void;
+  onUnitChange: (u: UnitType) => void;
 }
 
 const LiveClock = React.memo(({ 
   unit, 
   onCopy, 
-  onUseNow 
+  onUseNow,
+  onUnitChange
 }: LiveClockProps) => {
   const [now, setNow] = useState(() => Date.now());
 
@@ -71,36 +82,78 @@ const LiveClock = React.memo(({
   [now, unit]);
 
   return (
-    <Box sx={{ display: 'flex', alignItems: 'center', justifyContent: 'space-between', mb: 4 }}>
+    <Box sx={{ 
-      <Stack direction="row" spacing={1} alignItems="baseline">
+      display: 'flex', 
-        <Typography variant="h5" sx={{ fontWeight: 300, letterSpacing: '-1px', color: 'text.primary', fontFamily: 'monospace' }}>
+      alignItems: 'center', 
+      justifyContent: 'space-between', 
+      p: 1.8,
+      mb: 2.5,
+      bgcolor: alpha('#2196f3', 0.04),
+      borderRadius: 4,
+      border: '1px solid',
+      borderColor: alpha('#2196f3', 0.1)
+    }}>
+      <Stack spacing={0.5}>
+        <Typography variant="caption" sx={{ color: 'primary.main', fontWeight: 800, fontSize: '0.6rem', textTransform: 'uppercase', letterSpacing: 1 }}>
+          当前时间戳
+        </Typography>
+        <Typography variant="subtitle2" sx={{ fontWeight: 800, color: 'text.primary', fontFamily: 'monospace', fontSize: '1.2rem', letterSpacing: '-0.5px', lineHeight: 1.2 }}>
           {displayVal}
         </Typography>
-        <Typography variant="caption" sx={{ color: 'text.secondary', fontWeight: 600, textTransform: 'uppercase' }}>
-          {unit}
-        </Typography>
       </Stack>
-      <Stack direction="row" spacing={0.5}>
+
-        <Tooltip title="填充到下方">
+      <Stack direction="row" spacing={1} alignItems="center">
+        {/* 胶囊式单位切换器 */}
+        <Box sx={{ 
+          display: 'flex', 
+          p: 0.4, 
+          bgcolor: alpha('#2196f3', 0.08), 
+          borderRadius: 2.5,
+          border: '1px solid',
+          borderColor: alpha('#2196f3', 0.1)
+        }}>
+          {(['ms', 's'] as const).map((u) => (
+            <Box
+              key={u}
+              onClick={() => onUnitChange(u)}
+              sx={{ 
+                px: 1.2, 
+                py: 0.35, 
+                borderRadius: 2, 
+                cursor: 'pointer',
+                fontSize: '0.65rem', 
+                fontWeight: 900,
+                transition: 'all 0.2s',
+                bgcolor: unit === u ? '#fff' : 'transparent',
+                color: unit === u ? 'primary.main' : alpha('#2196f3', 0.4),
+                boxShadow: unit === u ? '0 2px 6px rgba(33, 150, 243, 0.2)' : 'none',
+              }}
+            >
+              {u.toUpperCase()}
+            </Box>
+          ))}
+        </Box>
+        
+        <Divider orientation="vertical" flexItem sx={{ mx: 0.5, my: 1, borderColor: alpha('#2196f3', 0.1) }} />
+
+        <Stack direction="row" spacing={0.5}>
+          <Tooltip title="填充到下方">
+            <IconButton 
+              size="small" 
+              onClick={() => onUseNow(now)} 
+              sx={{ color: 'primary.main', bgcolor: '#fff', boxShadow: '0 2px 4px rgba(0,0,0,0.05)', '&:hover': { bgcolor: 'primary.main', color: '#fff' } }}
+            >
+              <AccessTimeIcon fontSize="small" />
+            </IconButton>
+          </Tooltip>
           <IconButton 
-            aria-label="use current time"
-            size="small" 
-            onClick={() => onUseNow(now)} 
-            sx={{ color: 'primary.main', transition: 'all 0.2s', '&:hover': { bgcolor: alpha('#2563eb', 0.08) } }}
-          >
-            <AccessTimeIcon fontSize="small" />
-          </IconButton>
-        </Tooltip>
-        <Tooltip title="复制当前时间戳">
-          <IconButton 
-            aria-label="copy current timestamp"
             size="small" 
             onClick={() => onCopy(displayVal)} 
-            sx={{ color: 'grey.400', transition: 'all 0.2s', '&:hover': { color: 'primary.main', transform: 'scale(1.1)' } }}
+            sx={{ color: 'grey.400', '&:hover': { color: 'primary.main' } }}
           >
             <ContentCopyIcon fontSize="small" />
           </IconButton>
-        </Tooltip>
+        </Stack>
       </Stack>
     </Box>
   );
@@ -146,73 +199,79 @@ const ResultView = React.memo(({
   if (!result) return null;
 
   return (
-    <Box sx={{ 
+    <Fade in={!!result}>
-      mt: 3, pt: 3, borderTop: '1px solid', borderColor: 'grey.50',
+      <Box sx={{ mt: 3, pt: 2.5, borderTop: '1px solid', borderColor: 'grey.50' }}>
-      animation: 'fadeIn 0.3s ease-out',
+        <Typography variant="caption" sx={{ color: 'text.secondary', mb: 1.2, display: 'block', fontWeight: 800, fontSize: '0.7rem' }}>
-      '@keyframes fadeIn': { from: { opacity: 0, transform: 'translateY(10px)' }, to: { opacity: 1, transform: 'translateY(0)' } }
+          转换结果
-    }}>
+        </Typography>
-      <Typography variant="caption" sx={{ color: 'text.disabled', mb: 1, display: 'block', ml: 1, fontWeight: 500 }}>
+        
-        转换结果
+        <Box sx={{ 
-      </Typography>
+          bgcolor: alpha('#2196f3', 0.05),
-      <TextField
+          p: 2,
-        fullWidth
+          borderRadius: 4,
-        value={result}
+          position: 'relative',
-        slotProps={{
+          mb: 2.5,
-          input: {
+          border: '1px solid',
-            readOnly: true,
+          borderColor: alpha('#2196f3', 0.1)
-            endAdornment: (
+        }}>
-              <InputAdornment position="end">
+          <Typography 
-                <IconButton 
+            variant="body1" 
-                  aria-label="copy result"
+            sx={{ 
-                  size="small" 
+              fontFamily: 'monospace', 
-                  onClick={handleCopy} 
+              fontWeight: 700, 
-                  sx={{ 
+              color: 'primary.main',
-                    color: copied ? 'success.main' : 'primary.main',
+              wordBreak: 'break-all',
-                    transition: 'all 0.3s cubic-bezier(0.34, 1.56, 0.64, 1)',
+              pr: 4,
-                    transform: copied ? 'scale(1.2)' : 'scale(1)',
+              fontSize: '1rem'
-                  }}
+            }}
-                >
+          >
-                  {copied ? <CheckIcon fontSize="small" /> : <ContentCopyIcon fontSize="small" />}
+            {result}
-                </IconButton>
+          </Typography>
-              </InputAdornment>
+          <IconButton 
-            ),
+            size="small" 
-          },
+            onClick={handleCopy}
-        }}
+            sx={{ 
-        sx={{
+              position: 'absolute', 
-          ...INPUT_STYLE,
+              right: 8, 
-          mb: 2,
+              top: '50%', 
-          '& .MuiOutlinedInput-root': {
+              transform: 'translateY(-50%)',
-            ...INPUT_STYLE['& .MuiOutlinedInput-root'],
+              color: copied ? 'success.main' : 'primary.main',
-            bgcolor: alpha('#2563eb', 0.03),
+              bgcolor: '#fff',
-          },
+              boxShadow: '0 2px 8px rgba(0,0,0,0.05)',
-        }}
+              '&:hover': { bgcolor: copied ? 'success.main' : 'primary.main', color: '#fff' }
-      />
+            }}
-      
+          >
-      {/* 辅助信息预览 */}
+            {copied ? <CheckIcon fontSize="small" /> : <ContentCopyIcon fontSize="small" />}
-      <Stack spacing={1} sx={{ px: 1 }}>
+          </IconButton>
-        {[
+        </Box>
-          { label: '相对时间', value: extraInfo?.relative },
+        
-          { label: 'ISO 8601', value: extraInfo?.iso },
+        <Stack spacing={1.2}>
-          { label: 'UTC 时间', value: extraInfo?.utc },
+          {[
-        ].map((item) => (
+            { label: '相对时间', value: extraInfo?.relative },
-          <Box key={item.label} sx={{ display: 'flex', justifyContent: 'space-between', alignItems: 'center' }}>
+            { label: 'ISO 8601', value: extraInfo?.iso },
-            <Typography variant="caption" sx={{ color: 'text.secondary' }}>{item.label}</Typography>
+            { label: 'UTC 时间', value: extraInfo?.utc },
-            <Typography 
+          ].map((item) => (
-              variant="caption" 
+            <Box key={item.label} sx={{ display: 'flex', justifyContent: 'space-between', alignItems: 'center', px: 1 }}>
-              onClick={() => { if (item.value) onCopy(item.value); }}
+              <Typography variant="caption" sx={{ color: 'text.disabled', fontWeight: 700, fontSize: '0.65rem' }}>{item.label}</Typography>
-              sx={{ 
+              <Typography 
-                fontFamily: 'monospace', 
+                variant="caption" 
-                color: 'text.primary', 
+                onClick={() => { if (item.value) onCopy(item.value); }}
-                cursor: 'pointer',
+                sx={{ 
-                '&:hover': { color: 'primary.main', textDecoration: 'underline' }
+                  fontFamily: 'monospace', 
-              }}
+                  color: 'text.secondary', 
-            >
+                  fontWeight: 600,
-              {item.value}
+                  fontSize: '0.65rem',
-            </Typography>
+                  cursor: 'pointer',
-          </Box>
+                  '&:hover': { color: 'primary.main' }
-        ))}
+                }}
-      </Stack>
+              >
-    </Box>
+                {item.value}
+              </Typography>
+            </Box>
+          ))}
+        </Stack>
+      </Box>
+    </Fade>
   );
 });
 
@@ -227,16 +286,16 @@ export default function TimestampPage() {
   const [zone, setZone] = useState<ZoneType>('Asia/Shanghai');
   const [result, setResult] = useState('');
   const [error, setError] = useState('');
-  const [snack, setSnack] = useState<{ open: boolean; msg: string }>({ open: false, msg: '' });
+  const { snackbarProps, showMessage } = useSnackbar({ autoHideDuration: 1500 });
 
   const copy = useCallback(async (text: string) => {
     try {
       await navigator.clipboard.writeText(text);
-      setSnack({ open: true, msg: '已复制' });
+      showMessage('已复制', { severity: 'success' });
     } catch {
-      setSnack({ open: true, msg: '复制失败' });
+      showMessage('复制失败', { severity: 'error' });
     }
-  }, []);
+  }, [showMessage]);
 
   const convert = useCallback(() => {
     if (mode === 'ts2dt') {
@@ -259,14 +318,9 @@ export default function TimestampPage() {
     }
   }, [mode, tsInput, dtInput, unit, zone]);
 
-  // 智能实时转换 (Debounce Effect)
   useEffect(() => {
-    const timer = setTimeout(() => {
+    const timer = setTimeout(convert, 400);
-      convert();
+    return () => clearTimeout(timer);
-    }, 400);
-    return () => {
-      clearTimeout(timer);
-    };
   }, [convert]);
 
   const handleUseNow = useCallback((now: number) => {
@@ -278,65 +332,71 @@ export default function TimestampPage() {
   }, [mode, unit, zone]);
 
   return (
-    <Box sx={{ p: 1, width: '100%', bgcolor: 'transparent', boxSizing: 'border-box' }}>
+    <Box sx={{ pb: 3 }}>
-      <Paper
+      <Container sx={{ py: 2 }}>
-        elevation={0}
+        {/* Header with Icon */}
-        sx={{
+        <Stack direction="row" spacing={1.5} alignItems="center" sx={{ mb: 2.5 }}>
-          p: 2.5,
+          <Box sx={{ p: 1, borderRadius: 2.5, bgcolor: alpha('#2196f3', 0.1), color: 'primary.main', display: 'flex' }}>
-          borderRadius: 4,
+            <AccessTimeIcon sx={{ fontSize: 20 }} />
-          border: '1px solid',
+          </Box>
-          borderColor: 'grey.100',
+          <Box sx={{ flex: 1 }}>
-          transition: 'all 0.4s cubic-bezier(0.4, 0, 0.2, 1)',
+            <Typography variant="subtitle1" fontWeight={900} sx={{ letterSpacing: '-0.5px', lineHeight: 1.2 }}>
-          '&:hover': { boxShadow: '0 12px 40px rgba(0,0,0,0.06)', borderColor: 'grey.200' },
+              时间戳转换
-        }}
+            </Typography>
-      >
+            <Typography variant="caption" color="text.secondary" sx={{ fontWeight: 600 }}>
-        {/* 1. 实时时钟 */}
+              Unix 毫秒数转换与格式化
-        <Box sx={{ position: 'relative' }}>
+            </Typography>
-          <LiveClock unit={unit} onCopy={copy} onUseNow={handleUseNow} />
+          </Box>
-          <Tooltip title="切换单位">
+        </Stack>
-            <IconButton 
-              aria-label="switch unit"
-              size="small" 
-              onClick={() => { setUnit((u) => (u === 'ms' ? 's' : 'ms')); }} 
-              sx={{ 
-                position: 'absolute', right: 80, top: 4, color: 'grey.400',
-                transition: 'transform 0.3s ease',
-                '&:hover': { transform: 'rotate(180deg)', color: 'primary.main' }
-              }}
-            >
-              <SwapHorizIcon fontSize="small" />
-            </IconButton>
-          </Tooltip>
-        </Box>
 
-        {/* 2. 模式切换 */}
+        {/* Live Clock Card */}
-        <Box sx={{ position: 'relative', display: 'flex', p: 0.5, bgcolor: 'grey.100', borderRadius: 3.5, mb: 3, overflow: 'hidden' }}>
+        <LiveClock unit={unit} onCopy={copy} onUseNow={handleUseNow} onUnitChange={setUnit} />
-          <Box
+
-            sx={{
+        {/* Mode Switcher */}
-              position: 'absolute', height: 'calc(100% - 8px)', width: 'calc(50% - 4px)',
+        <Box sx={{ 
-              bgcolor: '#fff', borderRadius: 3, boxShadow: '0 2px 8px rgba(0,0,0,0.08)',
+          position: 'relative', 
-              transition: 'transform 0.25s cubic-bezier(0.4, 0, 0.2, 1)',
+          display: 'flex', 
-              transform: mode === 'ts2dt' ? 'translateX(0)' : 'translateX(100%)',
+          p: 0.6, 
-              top: 4, left: 4,
+          bgcolor: 'grey.100', 
-            }}
+          borderRadius: 4, 
-          />
+          mb: 2.5,
+          border: '1px solid',
+          borderColor: 'grey.200'
+        }}>
+          <Box sx={{
+            position: 'absolute', 
+            height: 'calc(100% - 10px)', 
+            width: 'calc(50% - 5px)',
+            bgcolor: '#fff', 
+            borderRadius: 3.5, 
+            boxShadow: '0 4px 12px rgba(0,0,0,0.08)',
+            transition: 'transform 0.3s cubic-bezier(0.4, 0, 0.2, 1)',
+            transform: mode === 'ts2dt' ? 'translateX(0)' : 'translateX(100%)',
+            top: 5, left: 5,
+          }} />
           {(['ts2dt', 'dt2ts'] as const).map((m) => (
-            <Button
+            <Box
-              key={m} fullWidth disableRipple
+              key={m}
               onClick={() => { setMode(m); setError(''); setResult(''); }}
-              sx={{
+              sx={{ 
-                position: 'relative', zIndex: 1, borderRadius: 3, py: 1, textTransform: 'none',
+                flex: 1, 
-                fontSize: '0.875rem', fontWeight: 500, transition: 'color 0.2s',
+                py: 1, 
-                color: mode === m ? 'text.primary' : 'text.disabled',
+                textAlign: 'center', 
-                '&:hover': { bgcolor: 'transparent', color: mode === m ? 'text.primary' : 'text.secondary' },
+                position: 'relative', 
+                zIndex: 1, 
+                cursor: 'pointer',
+                fontWeight: 800,
+                fontSize: '0.75rem',
+                color: mode === m ? 'primary.main' : 'text.secondary',
+                transition: 'color 0.3s'
               }}
             >
               {m === 'ts2dt' ? '时间戳 → 日期' : '日期 → 时间戳'}
-            </Button>
+            </Box>
           ))}
         </Box>
 
-        {/* 3. 输入与设置 */}
+        {/* Input Area */}
         <Stack spacing={2} sx={{ mb: 3 }}>
           <TextField
             placeholder={mode === 'ts2dt' ? "输入时间戳..." : DATE_FORMAT}
@@ -356,57 +416,76 @@ export default function TimestampPage() {
             sx={INPUT_STYLE}
           />
 
-          <Stack direction="row" spacing={2}>
+          <Stack direction="row" spacing={1.5}>
-            <Select
+            {/* 优化后的单位选择按钮组 */}
-              fullWidth value={unit}
+            <Box sx={{ 
-              onChange={(e) => { setUnit(e.target.value as UnitType); }}
+              flex: 1, 
-              sx={{ ...INPUT_STYLE, flex: 1 }}
+              display: 'flex', 
-              MenuProps={{ PaperProps: { sx: { borderRadius: 3, mt: 1, boxShadow: '0 10px 40px rgba(0,0,0,0.1)' } } }}
+              bgcolor: 'grey.50', 
-            >
+              p: 0.5, 
-              <MenuItem value="ms">毫秒 (ms)</MenuItem>
+              borderRadius: 3.5,
-              <MenuItem value="s">秒 (s)</MenuItem>
+              border: '1px solid',
-            </Select>
+              borderColor: 'grey.100'
+            }}>
+              {(['ms', 's'] as const).map((u) => (
+                <Box
+                  key={u}
+                  onClick={() => setUnit(u)}
+                  sx={{ 
+                    flex: 1, 
+                    py: 0.8, 
+                    textAlign: 'center', 
+                    borderRadius: 3, 
+                    cursor: 'pointer',
+                    fontSize: '0.75rem', 
+                    fontWeight: 800,
+                    transition: 'all 0.2s',
+                    bgcolor: unit === u ? '#fff' : 'transparent',
+                    color: unit === u ? 'primary.main' : 'text.disabled',
+                    boxShadow: unit === u ? '0 2px 8px rgba(0,0,0,0.05)' : 'none',
+                  }}
+                >
+                  {u === 'ms' ? '毫秒 (ms)' : '秒 (s)'}
+                </Box>
+              ))}
+            </Box>
 
             <Select
               fullWidth value={zone}
-              onChange={(e) => { setZone(e.target.value as ZoneType); }}
+              onChange={(e) => setZone(e.target.value as ZoneType)}
-              sx={{ ...INPUT_STYLE, flex: 1.5 }}
+              sx={{ ...INPUT_STYLE, flex: 1 }}
-              MenuProps={{ PaperProps: { sx: { borderRadius: 3, mt: 1, boxShadow: '0 10px 40px rgba(0,0,0,0.1)' } } }}
+              MenuProps={{ PaperProps: { sx: { borderRadius: 3, mt: 1, boxShadow: '0 12px 32px rgba(0,0,0,0.1)' } } }}
             >
               {ZONES.map((z) => (
-                <MenuItem key={z} value={z}>{z}</MenuItem>
+                <MenuItem key={z} value={z} sx={{ fontSize: '0.8rem', fontWeight: 600 }}>{z}</MenuItem>
               ))}
             </Select>
           </Stack>
         </Stack>
 
-        {/* 4. 转换操作 (作为手动确认) */}
+        {/* Main Action */}
         <Button
-          fullWidth variant="contained" disableElevation disableRipple
+          fullWidth 
+          variant="contained" 
           onClick={convert}
           sx={{
-            py: 1.6, borderRadius: 3, fontSize: '1rem', fontWeight: 600, textTransform: 'none',
+            py: 1.4,
-            bgcolor: 'primary.main', transition: 'all 0.2s',
+            borderRadius: 4,
-            '&:hover': { bgcolor: 'primary.dark', transform: 'translateY(-1px)' },
+            bgcolor: 'primary.main',
-            '&:active': { transform: 'translateY(0)' }
+            fontWeight: 800,
+            fontSize: '0.9rem',
+            boxShadow: 'none',
+            '&:hover': { bgcolor: 'primary.dark', boxShadow: `0 8px 24px ${alpha('#2196f3', 0.2)}` }
           }}
         >
           立即转换
         </Button>
 
-        {/* 5. 结果展示 */}
+        {/* Result View */}
         <ResultView result={result} mode={mode} unit={unit} zone={zone} onCopy={copy} />
-      </Paper>
+      </Container>
 
-      <Snackbar 
+      <GlobalSnackbar {...snackbarProps} />
-        open={snack.open} autoHideDuration={1500} 
-        onClose={() => { setSnack((s) => ({ ...s, open: false })); }}
-        anchorOrigin={{ vertical: 'bottom', horizontal: 'center' }}
-      >
-        <Alert severity="success" variant="filled" icon={false} sx={{ borderRadius: 2.5, bgcolor: 'grey.900' }}>
-          {snack.msg}
-        </Alert>
-      </Snackbar>
     </Box>
   );
 }

entrypoints/sidepanel/App.css

@@ -0,0 +1,91 @@
+/* 极简滚动条变量 */
+:root {
+  /* 统一圆角变量 */
+  --radius: 8px;
+  /* 统一背景颜色变量 */
+  --bg-color: #fafafa;
+  /* 统一文字颜色变量 */
+  --text-color: #333333;
+  /* 统一按钮颜色变量 */
+  --btn-bg: #e0e0e0;
+  /* 统一按钮文字颜色变量 */
+  --btn-text: #333333;
+  --border: 1px solid #e0e0e0;
+
+  /* 滚动条变量 */
+  --sb-width: 6px;
+  --sb-thumb-color: rgba(0, 0, 0, 0.1);
+  --sb-thumb-hover: rgba(0, 0, 0, 0.2);
+  --sb-track-color: transparent;
+}
+
+/* 适配侧边栏 - 使用百分比而非固定尺寸 */
+html,
+body,
+#root {
+  margin: 0;
+  padding: 0;
+  width: 100%;
+  height: 100vh;
+  overflow: hidden; /* 禁用外层滚动 */
+}
+
+/* 全局极简滚动条定制 */
+*::-webkit-scrollbar {
+  width: var(--sb-width);
+}
+
+*::-webkit-scrollbar-track {
+  background: var(--sb-track-color);
+}
+
+*::-webkit-scrollbar-thumb {
+  background: var(--sb-thumb-color);
+  border-radius: 10px;
+  background-clip: content-box;
+  border: 1px solid transparent;
+}
+
+*::-webkit-scrollbar-thumb:hover {
+  background: var(--sb-thumb-hover);
+}
+
+.app {
+  display: flex;
+  flex-direction: column;
+  width: 100%;
+  height: 100%;
+  box-sizing: border-box;
+  font-family:
+    -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
+  overflow: hidden; /* 内部由 flex 子项控制滚动 */
+}
+
+/* Animations */
+@keyframes slideInRight {
+  from {
+    transform: translateX(30px);
+    opacity: 0;
+  }
+  to {
+    transform: translateX(0);
+    opacity: 1;
+  }
+}
+
+@keyframes fadeIn {
+  from {
+    opacity: 0;
+  }
+  to {
+    opacity: 1;
+  }
+}
+
+.page-transition-enter {
+  animation: slideInRight 0.3s cubic-bezier(0.25, 0.8, 0.25, 1) forwards;
+}
+
+.page-transition-dashboard {
+  animation: fadeIn 0.3s ease-out forwards;
+}

entrypoints/sidepanel/App.tsx

@@ -0,0 +1,21 @@
+import './App.css';
+import RouterProvider from '@/providers/RouterProvider';
+import TopBar from '@/components/TopBar';
+import RouterContainer from '@/components/RouterContainer';
+
+function App() {
+  const handleOpenOptions = () => {
+    chrome.runtime.openOptionsPage();
+  };
+
+  return (
+    <RouterProvider defaultRoute="dashboard">
+      <div className="app" style={{ display: 'flex', flexDirection: 'column', height: '100vh', overflow: 'hidden' }}>
+        <TopBar onOpenOptions={handleOpenOptions} />
+        <RouterContainer />
+      </div>
+    </RouterProvider>
+  );
+}
+
+export default App;

entrypoints/sidepanel/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Testing Tools - Side Panel</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="./main.tsx"></script>
+  </body>
+</html>

entrypoints/sidepanel/main.tsx

@@ -0,0 +1,10 @@
+import React from 'react';
+import ReactDOM from 'react-dom/client';
+import App from './App.tsx';
+import './style.css';
+
+ReactDOM.createRoot(document.getElementById('root')!).render(
+  <React.StrictMode>
+    <App />
+  </React.StrictMode>,
+);

entrypoints/sidepanel/style.css

@@ -0,0 +1,22 @@
+body {
+  margin: 0;
+  font-family:
+    -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', 'Ubuntu', 'Cantarell', 'Fira Sans',
+    'Droid Sans', 'Helvetica Neue', sans-serif;
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+}
+
+code {
+  font-family: source-code-pro, Menlo, Monaco, Consolas, 'Courier New', monospace;
+}
+
+h1,
+h2,
+h3,
+h4,
+h5,
+h6 {
+  font-size: inherit; /* 先全部重置为继承大小 */
+  font-weight: inherit;
+}

providers/RouterProvider.tsx

@@ -0,0 +1,123 @@
+import { createContext, useContext, useState, useEffect, ReactNode } from 'react';
+import type { PageType } from '@/types/storage';
+import { storageUtil } from '@/utils/chromeStorage';
+import { getDefaultVisibleRoutes } from '@/config/routes';
+
+interface RouterContextType {
+  currentPage: PageType;
+  visiblePages: PageType[];
+  isLoaded: boolean;
+  navigateTo: (page: PageType) => void;
+  navigateLocal: (page: PageType) => void;
+  syncNavigation: (page: PageType) => void;
+  goBack: () => void;
+  setVisiblePages: (pages: PageType[]) => void;
+}
+
+const RouterContext = createContext<RouterContextType | null>(null);
+
+interface RouterProviderProps {
+  children: ReactNode;
+  defaultRoute?: PageType;
+  syncRoute?: boolean;
+}
+
+export function RouterProvider({
+  children,
+  defaultRoute = 'dashboard',
+  syncRoute = true
+}: RouterProviderProps) {
+  const [currentPage, setCurrentPage] = useState<PageType>(defaultRoute);
+  const [visiblePages, setVisiblePages] = useState<PageType[]>(getDefaultVisibleRoutes());
+  const [isLoaded, setIsLoaded] = useState(false);
+
+  useEffect(() => {
+    loadInitialData();
+  }, []);
+
+  useEffect(() => {
+    if (isLoaded && syncRoute) {
+      storageUtil.set('app/currentRoute', currentPage);
+    }
+  }, [currentPage, isLoaded, syncRoute]);
+
+  // Listen for storage changes if sync is enabled
+  useEffect(() => {
+    if (!syncRoute) return;
+
+    const handleStorageChange = (changes: { [key: string]: chrome.storage.StorageChange }) => {
+      if (changes['app/currentRoute']) {
+        const newRoute = changes['app/currentRoute'].newValue as PageType;
+        if (newRoute && newRoute !== currentPage) {
+          setCurrentPage(newRoute);
+        }
+      }
+    };
+
+    chrome.storage.onChanged.addListener(handleStorageChange);
+    return () => chrome.storage.onChanged.removeListener(handleStorageChange);
+  }, [syncRoute, currentPage]);
+
+  const loadInitialData = async () => {
+    try {
+      const [savedRoute, savedVisiblePages] = await Promise.all([
+        storageUtil.get('app/currentRoute', defaultRoute),
+        storageUtil.get('app/visiblePages', getDefaultVisibleRoutes()),
+      ]);
+
+      if (savedRoute && syncRoute) {
+        setCurrentPage(savedRoute);
+      }
+      if (savedVisiblePages) {
+        setVisiblePages(savedVisiblePages);
+      }
+    } catch (error) {
+      console.error('Failed to load initial routing data:', error);
+    } finally {
+      setIsLoaded(true);
+    }
+  };
+
+  const navigateTo = (page: PageType) => {
+    setCurrentPage(page);
+  };
+
+  const navigateLocal = (page: PageType) => {
+    setCurrentPage(page);
+  };
+
+  const syncNavigation = (page: PageType) => {
+    storageUtil.set('app/currentRoute', page);
+  };
+
+  const goBack = () => {
+    setCurrentPage('dashboard');
+  };
+
+  return (
+    <RouterContext.Provider
+      value={{
+        currentPage,
+        visiblePages,
+        isLoaded,
+        navigateTo,
+        navigateLocal,
+        syncNavigation,
+        goBack,
+        setVisiblePages
+      }}
+    >
+      {children}
+    </RouterContext.Provider>
+  );
+}
+
+export function useRouter() {
+  const context = useContext(RouterContext);
+  if (!context) {
+    throw new Error('useRouter must be used within a RouterProvider');
+  }
+  return context;
+}
+
+export default RouterProvider;

tsconfig.json

@@ -1,19 +1,14 @@
 {
   "extends": "./.wxt/tsconfig.json",
   "compilerOptions": {
-    /* --- 原有配置保持 --- */
     "allowImportingTsExtensions": true,
     "jsx": "react-jsx",
     "esModuleInterop": true,
     "module": "ESNext", // 支持 import.meta
     "moduleResolution": "Bundler", // 或者用 "Node"
-
-    /* --- 1. 严格类型检查 (关键) --- */
-    // 开启所有严格检查，包括 noImplicitAny。
-    // 这能帮你捕获 "timer" 隐式 any 等错误，强制你写出更高质量的代码。
     "strict": true,
 
-    /* --- 2. 代码质量检查 --- */
+    /* --- 代码质量检查 --- */
     // 声明了但没使用的变量报错（防止代码冗余）
     "noUnusedLocals": true,
     // 函数参数没使用报错
@@ -23,28 +18,22 @@
     // switch 语句没有 break 时报错
     "noFallthroughCasesInSwitch": true,
 
-    /* --- 3. 路径与环境 --- */
+    /* --- 路径与环境 --- */
-    // 设置基础目录，方便解析相对路径
-    "baseUrl": ".",
     // 确保包含 DOM 类型（解决 setTimeout、document 等报错）
     "lib": ["DOM", "DOM.Iterable", "ESNext"],
     // 编译目标设置为最新，WXT 底层 Vite 会处理降级兼容
     "target": "ESNext",
 
-    /* --- 4. 路径别名 (可选) --- */
-    // 如果你的 @/utils/... 爆红，可以手动添加这个映射。
-    // WXT 通常会自动处理，但在这里显式声明有助于 VS Code 智能提示。
-    "paths": {
-      "@/*": ["./*"]
-    },
     "types": ["chrome", "webextension-polyfill"],
     "noImplicitAny": false
   },
   // 确保包含你的源代码目录
   "include": [
+    "vite-env.d.ts",
     "entrypoints/**/*",
     "components/**/*",
     "utils/**/*",
+    "types/**/*",
     "assets/**/*",
     "hooks/**/*",
     ".wxt/types/**/*.ts",

types/storage.d.ts

@@ -1,4 +1,4 @@
-export type PageType = 'timestamp' | 'storageCleaner';
+export type PageType = 'dashboard' | 'timestamp' | 'storageCleaner' | 'openUrl' | 'openUrlViewer';
 
 export interface StorageSchema {
   'app/currentRoute': PageType;
@@ -6,6 +6,8 @@ export interface StorageSchema {
   'app/lastRoute': string;
   'app/theme': string;
   'storageCleaner/preferences': StorageCleanerPreferences;
+  'openUrl/preferences': OpenUrlPreferences;
+  'openUrl/currentUrl': string;
 }
 
 export interface StorageCleanerPreferences {
@@ -13,6 +15,15 @@ export interface StorageCleanerPreferences {
   selectedTypes: StorageCleanerOptions;
 }
 
+export interface OpenUrlEntry {
+  name: string;
+  url: string;
+}
+
+export interface OpenUrlPreferences {
+  entries: OpenUrlEntry[];
+}
+
 export interface StorageCleanerOptions {
   localStorage: boolean;
   sessionStorage: boolean;

utils/chromeStorage.ts

@@ -1,4 +1,4 @@
-import { StorageSchema } from 'types/storage';
+import { StorageSchema } from '@/types/storage';
 
 class StorageUtils {
   async get<K extends keyof StorageSchema>(key: K): Promise<StorageSchema[K]>;

utils/storageCleaner.ts

@@ -1,4 +1,4 @@
-import type { StorageCleanerOptions, CleaningResult, StorageCleanResult } from 'types/storage';
+import type { StorageCleanerOptions, CleaningResult, StorageCleanResult } from '@/types/storage';
 
 const RESTRICTED_PROTOCOLS = [
   'chrome:',
@@ -20,6 +20,51 @@ export function isRestrictedUrl(url?: string): boolean {
   return RESTRICTED_PROTOCOLS.some((p) => url.startsWith(p));
 }
 
+export async function getCookieSize(url: string): Promise<number> {
+  try {
+    const cookies = await chrome.cookies.getAll({ url });
+    return cookies.reduce((acc, c) => acc + c.name.length + c.value.length, 0);
+  } catch {
+    return 0;
+  }
+}
+
+export async function getLocalStorageSize(tabId: number): Promise<number> {
+  try {
+    const [result] = await chrome.scripting.executeScript({
+      target: { tabId },
+      func: () => {
+        return Object.entries(localStorage).reduce((acc, [k, v]) => acc + k.length + v.length, 0);
+      },
+    });
+    return (result?.result as number) || 0;
+  } catch {
+    return 0;
+  }
+}
+
+export async function getSessionStorageSize(tabId: number): Promise<number> {
+  try {
+    const [result] = await chrome.scripting.executeScript({
+      target: { tabId },
+      func: () => {
+        return Object.entries(sessionStorage).reduce((acc, [k, v]) => acc + k.length + v.length, 0);
+      },
+    });
+    return (result?.result as number) || 0;
+  } catch {
+    return 0;
+  }
+}
+
+export function formatSize(bytes: number): string {
+  if (bytes === 0) return '0 B';
+  const k = 1024;
+  const sizes = ['B', 'KB', 'MB', 'GB'];
+  const i = Math.floor(Math.log(bytes) / Math.log(k));
+  return parseFloat((bytes / Math.pow(k, i)).toFixed(2)) + ' ' + sizes[i];
+}
+
 export async function clearCookies(url: string): Promise<StorageCleanResult> {
   try {
     const cookies = await chrome.cookies.getAll({ url });

vite-env.d.ts

@@ -0,0 +1 @@
+/// <reference types="vite/client" />

wxt.config.ts

@@ -14,21 +14,19 @@ export default defineConfig({
       'activeTab',
       'scripting',
       'tabs',
-      'debugger',
       'cookies',
+      'sidePanel',
     ],
     host_permissions: ['<all_urls>'],
     action: {
       default_title: 'Testing Tools',
     },
-    options_ui: {
+    side_panel: {
-      open_in_tab: true,
+      default_path: 'entrypoints/sidepanel/index.html',
     },
-    // 将 favicon.ico 放入 public/ 文件夹中
+    options_ui: {
-    icons: {
+      page: 'entrypoints/options/index.html',
-      16: 'favicon.ico',
+      open_in_tab: true,
-      48: 'favicon.ico',
-      128: 'favicon.ico',
     },
   },
   vite: () => ({