Enhance form recognition, optimize UI, and unify components (#19)

- **docs**: 完善组件注释、README 目录结构及 AGENTS.md 文档。
- **refactor**:
  - 提取通用 `PageHeader`、`Button`、`DashboardCard` 及 `ErrorBoundary` 组件。
  - 重构消息通信机制，采用 `@webext-core/messaging` 实现类型安全。
  - 将全局通知系统重构为 `SnackbarProvider` (后合并至 `GlobalSnackbar`)。
  - 迁移样式系统至 MUI 主题，移除冗余 CSS。
  - 优化路由配置，支持独立标签页模式及页面懒加载。
  - 移除未使用文件、URL 工具及表单映射相关功能。
- **feat**:
  - 新增配置导出功能（JSON）及状态提示。
  - 新增侧边栏状态变化通知机制。
  - 新增文本统计及 JWT 解析工具。
  - 优化二维码生成与解析逻辑，换用更轻量的 `qrious` 和 `qr-scanner`。
  - 增强高亮器功能，支持闪烁效果及 Shadow DOM 穿透。
- **style**: 优化仪表盘响应式网格布局及 UI 细节。
- **fix**: 修复 `useStorageState` 依赖缺失及路由初始化性能问题。
- **test**: 更新单元测试以覆盖新增的工具函数及功能特性。

utils/__tests__/jwt.test.ts

@@ -0,0 +1,63 @@
+import { describe, it, expect } from 'vitest';
+import { parseJwt, decodeBase64Url } from '../jwt';
+
+describe('jwt utils', () => {
+  describe('decodeBase64Url', () => {
+    it('should decode standard base64url', () => {
+      // "test" -> "dGVzdA"
+      expect(decodeBase64Url('dGVzdA')).toBe('test');
+    });
+
+    it('should handle padding correctly', () => {
+      // "a" -> "YQ" (needs ==)
+      expect(decodeBase64Url('YQ')).toBe('a');
+      // "ab" -> "YWI" (needs =)
+      expect(decodeBase64Url('YWI')).toBe('ab');
+    });
+
+    it('should handle - and _ correctly', () => {
+      // Validating base64url specific chars
+      // standard base64 of binary 0xFF 0xEF is "/+8="
+      // base64url should be "_-8"
+      // Wait, let's use a simpler one.
+      // 0xFB 0xFF -> "+/8=" in base64, "-_8=" in base64url? No.
+      // + -> -
+      // / -> _
+      // let's try to encode something that results in + and /
+      // binary 0xFB 0xFF 0xBE -> "+/++" in base64 -> "-_--" in base64url
+      expect(decodeBase64Url('-_--')).toBeDefined();
+    });
+
+    it('should decode UTF-8 characters correctly', () => {
+      // "你好" -> "5L2g5aW9"
+      expect(decodeBase64Url('5L2g5aW9')).toBe('你好');
+    });
+  });
+
+  describe('parseJwt', () => {
+    it('should return error for invalid format', () => {
+      const result = parseJwt('invalid-token');
+      expect(result.error).toContain('格式错误');
+    });
+
+    it('should parse a valid JWT structure', () => {
+      // Header: {"alg":"HS256","typ":"JWT"}
+      // Payload: {"sub":"1234567890","name":"John Doe","iat":1516239022}
+      const token =
+        'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c';
+      const result = parseJwt(token);
+
+      expect(result.error).toBeUndefined();
+      expect(result.header?.alg).toBe('HS256');
+      expect(result.payload?.name).toBe('John Doe');
+      expect(result.signature).toBe('SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c');
+    });
+
+    it('should handle malformed json in header/payload', () => {
+      // Base64 of "{"
+      const token = 'ew.ew.signature';
+      const result = parseJwt(token);
+      expect(result.error).toBeDefined();
+    });
+  });
+});

utils/__tests__/textStatistics.test.ts

@@ -0,0 +1,58 @@
+import { describe, it, expect } from 'vitest';
+import { getTextStats, formatByteSize } from '../textStatistics';
+
+describe('textStatistics utils', () => {
+  describe('getTextStats', () => {
+    it('should return zeros for empty text', () => {
+      const stats = getTextStats('');
+      expect(stats).toEqual({ characters: 0, words: 0, lines: 0, bytes: 0 });
+    });
+
+    it('should count characters correctly', () => {
+      expect(getTextStats('abc').characters).toBe(3);
+      expect(getTextStats('a b c').characters).toBe(5);
+      expect(getTextStats('你好').characters).toBe(2);
+    });
+
+    it('should count English words correctly', () => {
+      expect(getTextStats('hello world').words).toBe(2);
+      expect(getTextStats('  hello   world  ').words).toBe(2);
+      expect(getTextStats('hello, world!').words).toBe(2);
+    });
+
+    it('should count Chinese words correctly', () => {
+      // "你好世界" 在 Intl.Segmenter 中通常被识别为 "你好" 和 "世界" 两个词
+      const stats = getTextStats('你好世界');
+      expect(stats.words).toBe(2);
+    });
+
+    it('should count mixed language words correctly', () => {
+      const stats = getTextStats('Hello 你好');
+      // "Hello" (1) + "你好" (1) = 2
+      expect(stats.words).toBe(2);
+    });
+
+    it('should count lines correctly', () => {
+      expect(getTextStats('line1\nline2').lines).toBe(2);
+      expect(getTextStats('line1\nline2\n').lines).toBe(3);
+    });
+
+    it('should count bytes correctly (UTF-8)', () => {
+      expect(getTextStats('abc').bytes).toBe(3);
+      expect(getTextStats('你好').bytes).toBe(6); // UTF-8 中每个常用汉字占 3 字节
+    });
+
+    it('should handle special cases', () => {
+      expect(getTextStats('   ').words).toBe(0);
+      expect(getTextStats('\n\n\n').lines).toBe(4);
+      expect(getTextStats('\n\n\n').words).toBe(0);
+    });
+  });
+
+  describe('formatByteSize', () => {
+    it('should format bytes correctly', () => {
+      expect(formatByteSize(100)).toBe('100 Bytes');
+      expect(formatByteSize(0)).toBe('0 Bytes');
+    });
+  });
+});