2026-02-09 15:52:45 +08:00

83 lines
2.7 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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) - 快速参考