# M4 Popup查词模块 (v0.3.1-0.3.8)

## 模块概述
- **版本范围**: 0.3.1 ~ 0.3.8
- **任务数**: 8
- **目标**: 构建独立弹窗界面，支持搜索、历史记录和独立窗口

## 关键产出
- Popup 页面框架（HTML/JS/CSS）
- 搜索功能和自动补全建议
- 查询历史记录系统
- 前进后退导航功能
- 独立窗口支持

## 任务列表

### M4.1 Popup基础界面 [目标版本: 0.3.1]
**任务**: 创建 Popup 页面框架  
**验收标准**:
- [ ] `src/popup/` 目录存在，含 HTML/JS/CSS
- [ ] Popup 宽度 400px，高度自适应（最小400px）
- [ ] 顶部有搜索输入框
- [ ] 中间为结果展示区
- [ ] 底部有"启用划词"开关

### M4.2 Popup搜索功能 [目标版本: 0.3.2]
**任务**: 输入单词查询  
**验收标准**:
- [ ] 在输入框输入单词，按 Enter 触发查询
- [ ] 查询结果显示在下方（复用 content 的结果组件）
- [ ] 支持查询多个词典

### M4.3 搜索建议（Autocomplete） [目标版本: 0.3.3]
**任务**: 输入时显示单词建议  
**验收标准**:
- [ ] 输入时，下拉显示匹配单词列表
- [ ] 使用简单的内置词库（100个常用词）
- [ ] 点击建议项，自动填入并查询
- [ ] 键盘上下键可选择建议项

### M4.4 查询历史记录 [目标版本: 0.3.4]
**任务**: 保存查询历史  
**验收标准**:
- [ ] 每次查询保存到 `chrome.storage.local`
- [ ] 最多保存 50 条历史
- [ ] Popup 顶部有历史记录按钮

### M4.5 历史记录展示 [目标版本: 0.3.5]
**任务**: 查看和选择历史  
**验收标准**:
- [ ] 点击历史按钮，显示历史单词列表
- [ ] 点击历史单词，直接查询该单词
- [ ] 历史列表可清空

### M4.6 前进后退导航 [目标版本: 0.3.6]
**任务**: 像浏览器一样前进后退  
**验收标准**:
- [ ] Popup 顶部有前进、后退按钮
- [ ] 查询新单词后，可后退到上一个结果
- [ ] 支持键盘快捷键 Alt+←/→

### M4.7 收藏按钮（UI占位） [目标版本: 0.3.7]
**任务**: 添加心形收藏按钮  
**验收标准**:
- [ ] 结果区域右上角有心形图标
- [ ] 点击切换空心/实心状态
- [ ] 暂不需要实际存储（仅UI）

### M4.8 独立窗口打开 [目标版本: 0.3.8]
**任务**: Popup 可打开独立窗口  
**验收标准**:
- [ ] Popup 有"打开独立窗口"按钮
- [ ] 点击后打开新窗口，URL 为 `chrome-extension://.../standalone.html`
- [ ] 独立窗口尺寸 600x500px，可调整大小

## 依赖
- **前置模块**: M1 基础架构模块, M2 划词核心模块, M3 词典系统模块
- **后置模块**: M8 生词本模块

## 参考资料
- [AGENTS.md](./AGENTS.md) - 规范文档
- [QUICK_REF.md](./QUICK_REF.md) - 快速参考