沙拉查词开发文档总纲
项目概述、版本规则、模块索引
项目概述
- 项目名称：沙拉查词
- 类型：Chrome Extension (Manifest V3)
- 核心功能：划词翻译、多词典聚合查询
- 目标浏览器：Chrome 109+
技术栈:
- Chrome Extension Manifest V3
- JavaScript ES2022+
- Vue.js ^3.4.0 (Popup/Options)
- Vite ^5.0.0
- Node.js >= 18.0.0
- pnpm >= 9.0.0 (包管理器)
版本号规则
格式
MAJOR.MINOR.PATCH
| 位 | 含义 | 更新时机 |
|---|---|---|
| MAJOR | 主版本 | 正式发布时设为 1 |
| MINOR | 模块号 | M1=0, M2=1, M3=2... |
| PATCH | 任务号 | 每个任务完成时 +1 |
版本与模块对应
| 模块 | 版本范围 | 任务数 | 描述 |
|---|---|---|---|
| M1 | 0.0.1 ~ 0.0.5 | 5 | 基础架构 |
| M2 | 0.1.1 ~ 0.1.9 | 9 | 划词核心 |
| M3 | 0.2.1 ~ 0.2.11 | 11 | 词典系统 |
| M4 | 0.3.1 ~ 0.3.8 | 8 | Popup查词 |
| M5 | 0.4.1 ~ 0.4.16 | 16 | 设置系统 |
| M6 | 0.5.1 ~ 0.5.7 | 7 | 触发方式 |
| M7 | 0.6.1 ~ 0.6.6 | 6 | 右键菜单 |
| M8 | 0.7.1 ~ 0.7.10 | 10 | 生词本 |
| M9 | 0.8.1 ~ 0.8.7 | 7 | API账号 |
| M10 | 0.9.1 ~ 0.9.8 | 8 | 高级功能 |
| M11 | 0.10.1 ~ 1.0.0 | 10 | 优化发布 |
总计: 97个验收点 → 最终版本 1.0.0
版本流程示例
开始: 0.0.0
M1.1完成 → 0.0.1
...
M1.5完成 → 0.0.5 (M1完成)
M2.1完成 → 0.1.1 (进入M2，MINOR+1)
...
M11.10完成 → 1.0.0 (正式发布)
当前状态
当前版本: 0.2.11
当前进度: 25/97 (26%)
下一任务: M4.1 Popup基础界面
文档索引
核心规范（必读）
| 文档 | 内容 |
|---|---|
| AGENTS.md | 架构原则、代码风格、通信协议、安全规范 |
| QUICK_REF.md | 版本速查、命名规范、代码模板 |
模块开发计划
| 文档 | 版本范围 | 任务数 | 关键产出 |
|---|---|---|---|
| M1.md | 0.0.1-0.0.5 | 5 | 项目框架、构建配置、通信机制 |
| M2.md | 0.1.1-0.1.9 | 9 | 划词检测、图标、基础面板 |
| M3.md | 0.2.1-0.2.11 | 11 | 词典基类、必应/有道实现 |
| M4.md | 0.3.1-0.3.8 | 8 | Popup界面、搜索、历史、独立窗口 |
| M5.md | 0.4.1-0.4.16 | 16 | 6页设置系统 |
| M6.md | 0.5.1-0.5.7 | 7 | 多种触发方式配置 |
| M7.md | 0.6.1-0.6.6 | 6 | 右键菜单系统 |
| M8.md | 0.7.1-0.7.10 | 10 | 生词本、导入导出 |
| M9.md | 0.8.1-0.8.7 | 7 | 第三方API账号配置 |
| M10.md | 0.9.1-0.9.8 | 8 | 剪贴板、PDF支持、权限管理 |
| M11.md | 0.10.1-1.0.0 | 10 | 性能优化、国际化、发布 |
版本记录
| 文档 | 内容 |
|---|---|
| VERSION.md | 所有任务的完成状态和历史记录 |
开发流程
- 阅读规范: 开始前阅读 AGENTS.md 和 QUICK_REF.md
- 查看模块: 根据当前版本打开对应的模块文件（如 M1.md）
- 开发实现: 按任务顺序实现需求
- 更新文档:任务完成后更新
docs/README.md的当前状态小节，更新docs/VERSION.md中对应人物的状态和日期，更新docs/QUICK_REF.md的当前版本小节，更新package.json和manifest.json的版本号 - 提交验收: 用户确认后提交代码
Commit 格式
feat(M1.1): 任务描述 (v0.0.1)
快速命令
# 开发
npm run dev
# 构建
npm run build
# 版本更新（手动）
# 1. 修改 package.json version
# 2. 修改 manifest.json version
# 3. 更新 VERSION.md 任务状态
# 4. git commit -m "feat(Mx.x): 描述 (vx.x.x)"