技术文档

┌─────────────────────────────────────────────────────┐
│  Chrome 扩展程序 (Manifest V3)                     │
│                                                     │
│  ┌──────────────┐     ┌───────────────────────────┐ │
│  │   弹出界面   │     │     Content Script         │ │
│  │  (React)     │     │   (meet.google.com)        │ │
│  │              │     │                            │ │
│  │  - 切换    │     │  ┌────────────────────┐   │ │
│  │  - 音量表     │◄───►│  │  音频分析器    │   │ │
│  │  - 设置  │     │  │  (Web Audio API)   │   │ │
│  │              │     │  └────────┬───────────┘   │ │
│  └──────────────┘     │           │               │ │
│         ▲             │  ┌────────▼───────────┐   │ │
│         │             │  │  状态机     │   │ │
│         │             │  │  IDLE → MUTED →    │   │ │
│         │             │  │  SPEAKING → GRACE  │   │ │
│         │             │  └────────┬───────────┘   │ │
│         │             │           │               │ │
│         │             │  ┌────────▼───────────┐   │ │
│         │             │  │  静音控制器   │   │ │
│         │             │  │  (DOM 操作)│   │ │
│         │             │  └────────────────────┘   │ │
│         │             └───────────────────────────┘ │
│         │                                           │
│         └─── Chrome Storage API (配置/状态同步)─┘
│                                                     │
└─────────────────────────────────────────────────────┘

src/
├── constants.ts          # 常量、模式、阈值、存储键
├── messages.ts           # i18n 消息 (EN/JA)
├── i18n.ts               # 语言管理
├── manifest.ts           # Chrome 扩展程序清单定义
├── background/
│   └── service-worker.ts # Service Worker（游戏启动器等）
├── content/
│   └── index.ts          # Content Script（状态机、模式控制、快捷键）
└── popup/
    ├── index.html        # 弹出页面入口 HTML
    ├── main.tsx          # React 挂载
    ├── Popup.tsx         # 弹出界面组件
    ├── popup.css         # 样式
    ├── Equalizer.tsx     # 频谱分析器
    ├── ThemeSwitcher.tsx # 主题切换器
    ├── LocaleSwitcher.tsx# 语言切换器
    └── GameLauncher.tsx  # 小游戏启动器

使用 Web Audio API 的 AnalyserNode 实时测量麦克风输入音量。

getUserMedia() → AudioContext → MediaStreamSource → AnalyserNode
                                                          │
                                                    getFloatTimeDomainData()
                                                          │
                                                    RMS（均方根）计算

配置参数：

一个包含 5 个状态的有限状态机管理语音状态。

IDLE ──(选择了非关闭模式)──► MUTED ──(音量 > 语音阈值)──► UNMUTING ──► SPEAKING
                     ▲                                                │
                     │                              (音量 < 静音阈值)
                     │                                                │
                     └──(宽限定时器到期)── GRACE ◄────────────────────┘
                                                │
                                         (音量 > 静音阈值)
                                                │
                                                ▼
                                            SPEAKING

* 如果用户手动切换 Meet 麦克风，模式保持不变，仅状态跟随变化。

四种模式控制状态转换的行为。关闭模式为禁用控制模式。

提供可自定义的键盘快捷键（默认：Ctrl+Shift+M）。

• 关闭：禁用
• 自动：切换静音
• 自动关闭：切换静音
• Push-to-Talk：仅在按住键时取消静音（按住操作）

快捷键可以在弹出窗口的设置中自由更改。

取消静音和静音使用不同的阈值，以防止抖动（频繁切换）。

语音阈值（语音开始）    = 0.025（默认）
静音阈值（静音判定）    = 语音阈值 × 0.5 = 0.0125

  音量
   ▲
   │  ┄┄┄┄┄┄┄┄┄ 语音阈值 (0.025) ┄┄┄┄  ← 超过时取消静音
   │
   │  ┄┄┄┄┄┄┄┄┄ 静音阈值 (0.0125) ┄┄  ← 低于时开始宽限期
   │
   └──────────────────────────────────────────► 时间

使用多种策略检测 Google Meet 的静音按钮：

1. 通过 aria-label 属性搜索（支持日语/英语）
2. 通过 data-tooltip 属性搜索
3. 回退方案：模拟 Ctrl+D 键盘快捷键

静音状态通过 data-is-muted 属性或 aria-label 文本内容来判定。

使用 React 19 构建的设置界面。通过 Chrome Storage API 与 Content Script 实时同步状态。

• 模式选择器: 在关闭 / 自动 / 自动关闭 / Push-to-Talk 之间切换
• 状态显示: 通过圆点指示器显示当前状态（静音/讲话中/宽限期）
• 电平表: 实时显示麦克风输入电平（带阈值标记）
• 灵敏度滑块: 调整 speechThreshold（0.005–0.25）— 按模式保存
• 宽限期滑块: 调整 gracePeriod（500ms–4000ms）— 按模式保存
• 快捷键设置: 通过按键录制界面进行自定义
• 麦克风设备选择: 手动选择要使用的麦克风

Popup → Chrome Storage → Content Script
  │                            │
  │  hushMeetConfig: object    │  （灵敏度/宽限期设置）
  │  hushMeetMode: string      │  （运行模式）
  │  hushMeetShortcutKey: str  │  （快捷键）
  │                            │
  │                            ▼
  │                      Content Script → Chrome Storage → Popup
  │                            │
  │                            │  hushMeetState: string  （当前状态）
  │                            │  hushMeetLevel: number  （音量电平）
  │                            │  hushMeetSpectrum: array （频谱）
  └────────────────────────────┘

Popup 和 Content Script 之间不直接通信；它们通过 Chrome Storage API 的变更事件进行双向通信。

命令

• 语音检测基于 RMS（音量），因此可能会被较大的环境噪声误触发（可通过使用自动关闭模式来缓解）
• Google Meet 界面变更可能导致静音按钮检测失效
• 语音的最开始部分可能会被截断（可通过阈值设置进行调整）
• 快捷键仅在 Google Meet 标签页处于焦点时有效

• 语音加权噪声门限，提高检测准确性
• 语音前缓冲，减少语音开头被截断的问题
• 自动检测逻辑，适应 Google Meet 界面变更
• Silero VAD（基于机器学习）替代方案，实现更高的检测准确率