v2 UI 改版说明(重要)¶
本次为整体界面改版,改动较大、分阶段进行。本文件记录改版的范围、进度与注意事项。 v0.10.108 起从 repo 根迁移到
docs/specs/done/,统一归档为 SPEC-000。
构建输出(重要)¶
| 目录 | 版本 | 说明 |
|---|---|---|
dist/chrome-mv3/ |
v0.8.58 | 旧稳定版,已冻结,不再重新构建。日常使用、回退基线。 |
dist-v2/chrome-mv3/ |
v0.9.x | 改版中的 v2,pnpm build 输出到这里。 |
wxt.config.ts的outDir已改为dist-v2,所以pnpm build只会更新 v2,不动旧版。- 过渡期两版可同时在
chrome://extensions加载测试(注意:同一套 storage,数据互通)。 - 旧版完整源码备份在
backup/v0.8.58_20260522/,必要时可回退。
改版目标:左侧导航 + 6 个页面¶
- 概览 —— 数据总览(商家数、采集进度等)
- 任务 —— 任务列表,可创建任务(关键词×地区),显示进度;任务采用队列模型,自动一个接一个跑
- 商家 —— 商家列表,默认全部、可筛选;从任务可跳转到「该任务的商家」
- 数据 —— 三个子 tab:官网列表(含批量导入网址,单次一万)/ 邮箱列表(含来源)/ 手机列表(含来源)
- 日志 —— 平移现有日志(地图实开 / 地图请求 / 官网社媒)
- 设置 —— 平移现有设置,新增:邮箱/手机正则、官网采集深度
分阶段计划¶
- 阶段一(已完成 v0.9.0):新导航框架 + 页面归位
- 左侧导航 6 项;概览(基础统计);任务(暂用现有批量搜索 UI);商家(现有数据表格); 数据(占位);日志(现有);设置(现有)。
- 阶段二(计划):任务队列模型 —— 任务实体、创建任务、队列调度、
MapTaskData加taskId、任务↔商家关联与跳转筛选。 - 阶段三(计划):数据列表 —— 官网列表 + 批量导入网址采集、邮箱列表、手机列表。
- 阶段四(计划):设置增强 —— 邮箱/手机正则、官网采集深度(抓首页 + 站内子页)。
注意事项¶
- 每阶段开工前先备份(见
更新规则.md),改动记入development-log.md。 - v2 与旧版共用同一 IndexedDB / storage,数据不会丢。