feat: 完成Tab①任务导入列表

实现 CollectTab 与 TaskTableModel，Tab① 接入导入 Excel 按钮、QTableView 任务列表和未匹配别名略过标记。

新增 GUI 测试覆盖 Tab① 接入、任务展示、未匹配标记和导入刷新；同步任务状态、API 合约、当前状态与 progress。

加入标准空模板 shopee待处理任务模板.xlsx，并更新 ignore/文档规则：模板可提交，运营填写后的 Excel 业务文件默认忽略。

.gitignore

@@ -9,6 +9,13 @@ cmshopee.db
 chrome_user_data_dir/
 # 采集的旧封面 / AI 生成的新封面
 images/
+# 运营填写后的 Excel 业务文件；标准空模板可提交
+*.xlsx
+*.xlsm
+!shopee待处理任务模板.xlsx
+# Excel 打开文件时产生的临时锁文件
+~$*.xlsx
+~$*.xlsm
 # 本地测试图片 / 临时启动脚本
 1_TY030.jpg
 cmshopee_t001_cover.jpg

AGENTS.md

@@ -34,6 +34,7 @@ cmshopee 是一个 **Windows 本地桌面自动化工具**：管理多个 Shopee
 
 - 绝不把真实账号、密码、Cookie、token 写进代码、文档或日志；密码/API Key 可在本地配置或 DB 明文保存，但文件必须 gitignore，且不自动登录。
 - `config.json`、`config/ai_models.json`、`cmshopee.db`、`chrome_user_data_dir/`、`images/`（含配置、密钥、业务数据、登录态、图片）绝不提交版本库。
+- `shopee待处理任务模板.xlsx` 是标准空模板，可提交；运营复制填写后的 Excel 属于业务数据，不提交版本库。
 - 「更新」提交线上、删除满 9 张封面等不可逆动作，必须有显式确认；③ 点击「开始更新」后必须弹窗确认，用户确认后才批量更新当前筛选结果。
 - 不绕过 Shopee 的验证码、风控、限流或权限校验。
 

app/gui.py

@@ -6,11 +6,13 @@ import os
 import sys
 
 try:
+    from PySide6.QtCore import QAbstractTableModel, QModelIndex, Qt
     from PySide6.QtWidgets import (
         QAbstractItemView,
         QApplication,
         QDialog,
         QDialogButtonBox,
+        QFileDialog,
         QFormLayout,
         QHBoxLayout,
         QHeaderView,
@@ -20,6 +22,7 @@ try:
         QMessageBox,
         QPlainTextEdit,
         QPushButton,
+        QTableView,
         QSpinBox,
         QTableWidget,
         QTableWidgetItem,
@@ -72,10 +75,209 @@ QTabBar::tab:hover:!selected {
 
 
 if QT_IMPORT_ERROR is None:
-    from . import accounts, appconfig
+    from . import accounts, appconfig, db, excel
     from . import config as account_config
 
 
+    def _database_path(db_path=None, config=None) -> str:
+        return db_path or appconfig.db_path(config)
+
+
+    class TaskTableModel(QAbstractTableModel):
+        """Table model for task rows shared by workflow tabs."""
+
+        HEADERS = ["账号", "别名", "商品ID", "阶段"]
+
+        STAGE_TEXT = {
+            "imported": "待采集",
+            "collected": "已采集",
+            "generated": "已生成",
+            "applied": "已更新",
+        }
+
+        STATUS_TEXT = {
+            "running": "处理中",
+            "failed": "失败",
+            "skipped": "略过",
+            "cancelled": "已取消",
+        }
+
+        def __init__(self, parent=None):
+            super().__init__(parent)
+            self.tasks = []
+            self.account_by_alias = {}
+
+        def set_tasks(self, tasks, accounts):
+            self.beginResetModel()
+            self.tasks = list(tasks)
+            self.account_by_alias = {
+                str(account.alias).strip(): account
+                for account in accounts
+                if str(account.alias).strip()
+            }
+            self.endResetModel()
+
+        def rowCount(self, parent=QModelIndex()):
+            return 0 if parent.isValid() else len(self.tasks)
+
+        def columnCount(self, parent=QModelIndex()):
+            return 0 if parent.isValid() else len(self.HEADERS)
+
+        def headerData(self, section, orientation, role=Qt.DisplayRole):
+            if role != Qt.DisplayRole:
+                return None
+            if orientation == Qt.Horizontal and 0 <= section < len(self.HEADERS):
+                return self.HEADERS[section]
+            return section + 1 if orientation == Qt.Vertical else None
+
+        def data(self, index, role=Qt.DisplayRole):
+            if not index.isValid():
+                return None
+            task = self.tasks[index.row()]
+            if role == Qt.DisplayRole:
+                return self._display_value(task, index.column())
+            if role == Qt.ToolTipRole and self.is_unmatched(task):
+                return "别名未匹配账号，采集时将略过"
+            return None
+
+        def flags(self, index):
+            if not index.isValid():
+                return Qt.NoItemFlags
+            return Qt.ItemIsEnabled | Qt.ItemIsSelectable
+
+        def task_at(self, row):
+            if row < 0 or row >= len(self.tasks):
+                return None
+            return self.tasks[row]
+
+        def is_unmatched(self, task) -> bool:
+            return str(task.alias).strip() not in self.account_by_alias
+
+        def unmatched_count(self) -> int:
+            return sum(1 for task in self.tasks if self.is_unmatched(task))
+
+        def _account_name(self, task) -> str:
+            account = self.account_by_alias.get(str(task.alias).strip())
+            if account is not None:
+                return account.account_name
+            return task.account_name or ""
+
+        def _stage_text(self, task) -> str:
+            if self.is_unmatched(task):
+                return "略过"
+            if task.status in self.STATUS_TEXT and task.status != "pending":
+                return self.STATUS_TEXT[task.status]
+            return self.STAGE_TEXT.get(task.stage, task.stage)
+
+        def _display_value(self, task, column):
+            values = [
+                self._account_name(task),
+                task.alias,
+                task.item_id,
+                self._stage_text(task),
+            ]
+            return values[column] if 0 <= column < len(values) else None
+
+
+    class CollectTab(QWidget):
+        """Tab 1: import Excel files and list imported tasks."""
+
+        def __init__(self, parent=None, db_path=None, config=None, status_callback=None):
+            super().__init__(parent)
+            self.config = appconfig.load_config() if config is None else config
+            self.db_path = _database_path(db_path, self.config)
+            self.status_callback = status_callback
+            self.current_batch_id = None
+
+            self.import_button = QPushButton("导入 Excel...")
+            self.refresh_button = QPushButton("刷新")
+
+            toolbar = QHBoxLayout()
+            toolbar.addWidget(self.import_button)
+            toolbar.addWidget(self.refresh_button)
+            toolbar.addStretch(1)
+
+            self.model = TaskTableModel(self)
+            self.table = QTableView()
+            self.table.setModel(self.model)
+            self.table.setSelectionBehavior(QAbstractItemView.SelectRows)
+            self.table.setSelectionMode(QAbstractItemView.SingleSelection)
+            self.table.setEditTriggers(QAbstractItemView.NoEditTriggers)
+            self.table.horizontalHeader().setSectionResizeMode(QHeaderView.Stretch)
+            self.table.verticalHeader().setVisible(False)
+
+            self.empty_label = QLabel("")
+
+            layout = QVBoxLayout(self)
+            layout.setContentsMargins(18, 18, 18, 18)
+            layout.addLayout(toolbar)
+            layout.addWidget(self.table, 1)
+            layout.addWidget(self.empty_label)
+
+            self.import_button.clicked.connect(self.import_excel)
+            self.refresh_button.clicked.connect(self.refresh_tasks)
+
+            self.refresh_tasks()
+
+        def _set_status(self, message):
+            if self.status_callback is not None:
+                self.status_callback(message)
+
+        def _show_error(self, message):
+            QMessageBox.warning(self, "导入采集", str(message))
+            self._set_status(str(message))
+
+        def _choose_excel_files(self):
+            files, _selected_filter = QFileDialog.getOpenFileNames(
+                self,
+                "选择 Excel 文件",
+                "",
+                "Excel 文件 (*.xlsx *.xlsm)",
+            )
+            return files
+
+        def import_excel(self, checked=False):
+            file_paths = self._choose_excel_files()
+            if not file_paths:
+                return
+            try:
+                result = excel.import_tasks(file_paths, path=self.db_path)
+            except Exception as exc:
+                self._show_error(exc)
+                return
+            if result.get("batch_id"):
+                self.current_batch_id = result["batch_id"]
+            self.refresh_tasks()
+            stats = result.get("stats") or {}
+            self._set_status(
+                "导入完成：有效{valid}，无效{invalid}，入库{inserted}，未匹配{unmatched}".format(
+                    valid=stats.get("valid", 0),
+                    invalid=stats.get("invalid", 0),
+                    inserted=stats.get("inserted", 0),
+                    unmatched=self.model.unmatched_count(),
+                )
+            )
+
+        def refresh_tasks(self, checked=False):
+            try:
+                db.init_db(self.db_path)
+                task_rows = db.list_tasks(batch_id=self.current_batch_id, path=self.db_path)
+                account_rows = accounts.list_accounts(path=self.db_path, config=self.config)
+            except Exception as exc:
+                self.model.set_tasks([], [])
+                self.empty_label.setText("任务读取失败")
+                self._set_status(f"任务读取失败：{exc}")
+                return
+            self.model.set_tasks(task_rows, account_rows)
+            if task_rows:
+                unmatched = self.model.unmatched_count()
+                self.empty_label.setText(
+                    "" if unmatched == 0 else f"{unmatched} 条任务别名未匹配账号，阶段显示为“略过”"
+                )
+            else:
+                self.empty_label.setText("暂无任务")
+
+
     class AccountDialog(QDialog):
         """Dialog for adding or editing one account."""
 
@@ -441,8 +643,8 @@ if QT_IMPORT_ERROR is None:
 
         def __init__(self, db_path=None, config=None):
             super().__init__()
-            self.db_path = db_path
             self.config = appconfig.load_config() if config is None else config
+            self.db_path = _database_path(db_path, self.config)
             self.setWindowTitle("cmshopee")
             self.resize(1180, 760)
             self.tabs = QTabWidget()
@@ -455,6 +657,12 @@ if QT_IMPORT_ERROR is None:
             self.statusBar().showMessage("就绪")
 
         def _build_tab(self, title):
+            if title == "① 导入采集":
+                return CollectTab(
+                    db_path=self.db_path,
+                    config=self.config,
+                    status_callback=self.statusBar().showMessage,
+                )
             if title == "④ 账号管理":
                 return AccountsTab(
                     db_path=self.db_path,

docs/04-architecture.md

@@ -244,6 +244,8 @@ CREATE INDEX idx_tasks_item ON tasks(item_id);
 
 ### 5.3 Excel 模板
 
+标准空模板文件保留在仓库根目录：`shopee待处理任务模板.xlsx`，单工作表名为 `待处理任务`。运营使用时应复制一份再填写，填写后的业务 Excel 含商品数据，不提交版本库。
+
 | 列 | 含义 | 输入/输出 |
 | --- | --- | --- |
 | 账号名 | Shopee 账号名（展示） | 输入 |
@@ -257,6 +259,7 @@ CREATE INDEX idx_tasks_item ON tasks(item_id);
 
 - 输入列（账号名/别名/商品id）运营填；其余为程序各阶段输出，**回写到原 Excel**（被锁→提示重试/另存副本）。
 - 别名以此列为匹配权威，不解析文件名。
+- 标准模板推荐前三列表头固定为：`账号名 | 别名 | 商品id`。不要使用 `账号`、`店铺名`、`店名` 代替匹配列；`别名` 必须与 ④ 账号管理中的 `accounts.alias` 一致。
 - 导入容错：缺少必需列（别名/商品id）时拒绝整个文件，记入 `file_errors`，不导入该文件任何行。
 - 脏行处理：单行缺别名/商品id、商品id 格式错误等逐行跳过，计入 `invalid`，不阻塞同文件其他有效行。
 
@@ -359,6 +362,7 @@ cmshopee/
 │   ├── appconfig.py / db.py / excel.py / config.py / accounts.py / chrome.py
 │   ├── editor.py / ai.py / prompts.py / gui.py / workers.py
 ├── main.py                    # GUI 启动入口：from app.gui import main
+├── shopee待处理任务模板.xlsx   # 标准空 Excel 模板，可提交；业务填写后的副本不提交
 ├── config.json               # 应用配置（模型选择/生成参数/路径，gitignore）
 ├── config/ai_models.json     # AI 模型清单（含密钥，必须 gitignore）
 ├── cmshopee.db               # SQLite（账号/任务/结果，gitignore）
@@ -370,7 +374,7 @@ cmshopee/
                               # 逻辑待并入 app/editor.py 后清理；见 prototypes/README.md
 ```
 
-> `config.json`、`config/ai_models.json`、`cmshopee.db`、`chrome_user_data_dir/`、`images/` 含密钥/凭证/业务数据，必须 gitignore。
+> `config.json`、`config/ai_models.json`、`cmshopee.db`、`chrome_user_data_dir/`、`images/` 含密钥/凭证/业务数据，必须 gitignore。`shopee待处理任务模板.xlsx` 是标准空模板，可以提交；运营填写后的 Excel 副本属于业务数据，不提交。
 
 ## 十、架构纪律
 

docs/05-coding-rules.md

@@ -77,6 +77,7 @@ python prototypes/demo.py            # 单账号闭环验证（不提交）
 - 绝不把真实账号、密码、Cookie、token 写进代码、文档或日志。
 - 绝不把密码/API Key 写进代码、文档、日志或导出文件；本地配置/DB 可明文保存，必须 gitignore，UI 打码。
 - 绝不把 `config.json`、`config/ai_models.json`、`cmshopee.db`、`chrome_user_data_dir/`、`images/` 提交版本库。
+- 绝不提交运营填写后的 Excel 业务文件；根目录 `shopee待处理任务模板.xlsx` 是标准空模板，允许提交。
 - 绝不自动登录 / 自动填账号密码；登录由人工完成，程序只检测登录态。
 - 绝不在缺少 ③ 批量确认弹窗确认的情况下点击「更新」提交线上。
 - 绝不擅自删除用户文件或重置 user-data-dir。

docs/06-tasks.md

@@ -48,7 +48,7 @@
 | ID | 任务 | 依赖 | 验收要点 | 状态 |
 | --- | --- | --- | --- | --- |
 | T-201 | `app/excel.py` 导入：解析多文件输入列入库 | T-003 | 按模板解析账号名/别名/商品id；记录 source_file_abs/source_sheet/source_row/row_key；缺必需列则拒绝整文件并记 file_errors；脏行逐行跳过计 invalid；写 batches/tasks | DONE |
-| T-202 | Tab① 任务列表 + 导入按钮 + 别名匹配标记 | T-201, T-105 | `QTableView` 显示账号/别名/商品id/阶段；未匹配标“略过” | TODO |
+| T-202 | Tab① 任务列表 + 导入按钮 + 别名匹配标记 | T-201, T-105 | `QTableView` 显示账号/别名/商品id/阶段；未匹配标“略过” | DONE |
 | T-202b | Tab① 导入汇总栏 | T-202 | 导入后显示 文件数/解析行数/有效/无效/匹配(按账号)/未匹配；未匹配可点击筛出 | TODO |
 | T-203 | 采集旧标题+旧封面（只读），下载图片，立即写库 | T-202, T-001, T-104b | 通过 worker 执行；逐条 set_collected；旧封面下载到 `images/<slug>/`；未登录/未匹配略过记原因 | TODO |
 | T-204 | 回写旧字段到原 Excel（含文件锁处理） | T-203, T-201 | 旧标题/旧封面回写原文件；被锁提示重试或 export_copy | TODO |

docs/api.md

@@ -95,8 +95,8 @@ class ExcelError(RuntimeError): ...
 OPENPYXL_IMPORT_ERROR: Exception | None
 
 import_tasks(file_paths, path=None, note=None, write_db=True) -> dict
-# file_paths 可传单个路径或多个路径。
-# 只解析【输入列】：账号名(可选)、别名、商品id；并记录
+# file_paths 可传单个路径或多个路径；标准空模板为根目录 shopee待处理任务模板.xlsx。
+# 只解析【输入列】：账号名(可选)、别名、商品id；推荐表头固定为 账号名 | 别名 | 商品id，并记录
 # source_file/source_file_abs/source_sheet/source_row/row_key。
 # 默认 write_db=True：有有效行时创建 batch 并写入 tasks。
 # -> {
@@ -124,7 +124,7 @@ export_copy(batch_id, out_dir_or_path, path=None) -> dict
 # T-201 仅保证函数存在；实际回写/另存实现留给 T-204/T-403。
 ```
 
-列模板见 [架构 5.3](04-architecture.md)；别名以“别名”列为权威。
+列模板见 [架构 5.3](04-architecture.md)；别名以“别名”列为权威，必须与 ④ 账号管理中的账号别名一致。`shopee待处理任务模板.xlsx` 是可提交的标准空模板；运营填写后的 Excel 副本属于业务数据，不提交。
 
 ## config 模块（`app/config.py`，已建）
 
@@ -271,13 +271,15 @@ render_prompt(template_text, task) -> str
 # GUI 入口
 main() -> int                              # 创建 QApplication + MainWindow
 class MainWindow(QMainWindow)              # QTabWidget: ①②③④⑤；支持注入 db_path/config 便于测试
+class CollectTab(QWidget)                  # ① 导入采集：导入 Excel + QTableView 任务列表 + 未匹配略过标记
+class TaskTableModel(QAbstractTableModel)  # 任务表格模型：账号/别名/商品ID/阶段；未匹配别名显示“略过”
 class AccountsTab(QWidget)                 # ④ 账号管理：表格 + 增删改 + 启动登录 + 检测登录 + 快捷方式
 class AccountDialog(QDialog)               # 账号编辑弹窗；密码 QLineEdit.Password
 TAB_TITLES: list[str]                      # 固定 Tab 顺序
 TAB_STYLE: str                              # 顶层 Tab 栏防误点样式：最小宽度/padding/间距/当前态
 ```
 
-`MainWindow` 已实现五 Tab 与 ④ 账号管理；①②③⑤ 仍为空壳，业务控件按后续 Tab 任务逐步填充。缺 PySide6 时 `main()` 返回 1 并输出明确提示。
+`MainWindow` 已实现五 Tab、① 导入采集任务列表与 ④ 账号管理；②③⑤ 仍为空壳，业务控件按后续 Tab 任务逐步填充。缺 PySide6 时 `main()` 返回 1 并输出明确提示。
 
 主 Tab 栏必须在 `MainWindow` 初始化时应用 `TAB_STYLE`：5 个 Tab 不使用 Qt 默认紧凑宽度，需保证点击区域稳定、间距清晰、当前 Tab 高亮明显。该样式属于全局导航基础，不归后续业务 Tab 任务重复实现。
 
@@ -287,6 +289,13 @@ TAB_STYLE: str                              # 顶层 Tab 栏防误点样式：
 - 弹窗字段：账号名、别名、地区、调试端口、密码、备注、slug、数据目录；密码框使用打码显示。
 - 「启动登录」只启动 Chrome，人工登录；「检测登录」用 worker 跑 `accounts.detect_login()` 并刷新状态列；「快捷方式」调用 `accounts.create_shortcut()` 生成默认桌面 `.lnk`。
 
+① 导入采集当前要点（T-202）：
+
+- 「导入 Excel...」按钮调用 `excel.import_tasks(file_paths, path=db_path)`，导入成功后刷新当前批次任务。
+- 任务列表使用 `QTableView + TaskTableModel`，列为：账号、别名、商品ID、阶段。
+- 账号列优先显示匹配到的 `accounts.account_name`；未匹配账号时保留 Excel 输入账号名。
+- 别名未匹配 `accounts.alias` 时不立即写库为 skipped，只在表格阶段列显示“略过”，真正跳过入库留给采集执行阶段。
+
 ## workers 模块（`app/workers.py`，已建，PySide6）
 
 ```python

docs/current-state.md

@@ -6,11 +6,11 @@
 ## 当前快照
 
 - 日期：2026-06-27
-- 阶段：V0 单账号 CDP 流程已验证；V1 已完成 T-000 正式代码包结构、T-001 `app/editor.py` 模块化、T-002 `app/appconfig.py` 应用配置、T-003 SQLite 持久化地基、T-004 本地数据忽略规则、T-005 AI 模型清单后端、T-006 单元测试基座、T-101 账号 user-data-dir 工具、T-102 Chrome 启动器、T-103 登录保活与检测、T-104 PySide6 主窗口骨架、T-104b PySide6 worker 基座、T-105 Tab④ 账号管理、T-106 账号快捷方式、T-201 Excel 导入入库。
+- 阶段：V0 单账号 CDP 流程已验证；V1 已完成 T-000 正式代码包结构、T-001 `app/editor.py` 模块化、T-002 `app/appconfig.py` 应用配置、T-003 SQLite 持久化地基、T-004 本地数据忽略规则、T-005 AI 模型清单后端、T-006 单元测试基座、T-101 账号 user-data-dir 工具、T-102 Chrome 启动器、T-103 登录保活与检测、T-104 PySide6 主窗口骨架、T-104b PySide6 worker 基座、T-105 Tab④ 账号管理、T-106 账号快捷方式、T-201 Excel 导入入库、T-202 Tab① 任务列表与导入按钮。
 - 技术栈：Python 3.10+，自研 CDP（websocket-client + requests），SQLite（sqlite3）+ `config.json` + openpyxl + AI（服务商待定），GUI PySide6 5 Tab（已定）。
-- 生产代码：已建立 `app/` 包 + 根入口 `main.py`；`app/cdp.py` 为已验证 CDP 底座；`app/editor.py` 已封装登录状态检测、标题/封面/采集/更新按钮能力；`app/appconfig.py` 已实现 `config.json` 默认值/读写/更新、AI 参数与端口读取，以及 `config/ai_models.json` 模型清单 CRUD/过滤/打码/测试连接；`app/db.py` 已实现 SQLite schema、连接 PRAGMA、批次/账号/任务与阶段写库函数；`app/excel.py` 已实现多 Excel 输入列解析、整文件列校验、脏行统计跳过、导入批次与任务入库、别名匹配统计；`app/config.py` 已实现账号 slug 与 user-data-dir 创建；`app/accounts.py` 已实现账号 CRUD 服务、端口默认分配、启动登录、检测登录、生成快捷方式；`app/chrome.py` 已实现 Chrome 参数拼装、启动、CDP 端口探测、PowerShell `.lnk` 快捷方式生成；`app/gui.py` 已实现 PySide6 `MainWindow`、五 Tab、顶部 Tab 栏防误点样式、④ 账号管理表格/弹窗/按钮/快捷方式与状态栏；`app/workers.py` 已实现 `BaseWorker`、通用 signals、取消标记和 `QThread` 启动包装。
-- 测试：`tests/` 已建立；T-006 后纯逻辑改动必须运行 `python -m unittest discover -s tests`，当前覆盖 appconfig/db/config/accounts/chrome 启动与快捷方式/editor 登录检测/excel 导入/gui 账号管理/worker signal 与线程包装，并对尚未实现的 app.prompts 做契约占位 skip；CDP/Shopee 改动仍需测试商品手动验证。
-- 数据：`config.json`、`config/ai_models.json`、`cmshopee.db`、`chrome_user_data_dir/`、`images/` 已由 `.gitignore` 排除；`app/appconfig.py` 首次读取缺失的 `config.json` 时会在本地写默认配置，`app/db.py` 调用 `init_db()` 时会在本地创建 SQLite DB。
+- 生产代码：已建立 `app/` 包 + 根入口 `main.py`；`app/cdp.py` 为已验证 CDP 底座；`app/editor.py` 已封装登录状态检测、标题/封面/采集/更新按钮能力；`app/appconfig.py` 已实现 `config.json` 默认值/读写/更新、AI 参数与端口读取，以及 `config/ai_models.json` 模型清单 CRUD/过滤/打码/测试连接；`app/db.py` 已实现 SQLite schema、连接 PRAGMA、批次/账号/任务与阶段写库函数；`app/excel.py` 已实现多 Excel 输入列解析、整文件列校验、脏行统计跳过、导入批次与任务入库、别名匹配统计；`app/config.py` 已实现账号 slug 与 user-data-dir 创建；`app/accounts.py` 已实现账号 CRUD 服务、端口默认分配、启动登录、检测登录、生成快捷方式；`app/chrome.py` 已实现 Chrome 参数拼装、启动、CDP 端口探测、PowerShell `.lnk` 快捷方式生成；`app/gui.py` 已实现 PySide6 `MainWindow`、五 Tab、顶部 Tab 栏防误点样式、① 导入采集的 Excel 导入按钮/QTableView 任务列表/未匹配略过标记、④ 账号管理表格/弹窗/按钮/快捷方式与状态栏；`app/workers.py` 已实现 `BaseWorker`、通用 signals、取消标记和 `QThread` 启动包装。
+- 测试：`tests/` 已建立；T-006 后纯逻辑改动必须运行 `python -m unittest discover -s tests`，当前覆盖 appconfig/db/config/accounts/chrome 启动与快捷方式/editor 登录检测/excel 导入/gui ① 导入采集/gui ④ 账号管理/worker signal 与线程包装，并对尚未实现的 app.prompts 做契约占位 skip；CDP/Shopee 改动仍需测试商品手动验证。
+- 数据：`config.json`、`config/ai_models.json`、`cmshopee.db`、`chrome_user_data_dir/`、`images/` 已由 `.gitignore` 排除；运营填写后的 Excel 业务文件默认忽略，标准空模板 `shopee待处理任务模板.xlsx` 可提交；`app/appconfig.py` 首次读取缺失的 `config.json` 时会在本地写默认配置，`app/db.py` 调用 `init_db()` 时会在本地创建 SQLite DB。
 
 ## 既定设计要点（文档已定）
 
@@ -32,7 +32,7 @@
 | `prototypes/` | 已有 | 已验证原型/探查脚本（demo/set_title/set_cover/get_title/cookies/inspect_images/grab/1.py），保留作人工回归与探查参考；见 `prototypes/README.md` |
 | `chrome-remote-debug-lan.md` | 已有 | WSL→Windows CDP 转发排查记录 |
 | `app/__init__.py` / `app/__main__.py` / `main.py` | 已有 | 正式包与启动入口；`python main.py` / `python -m app` 可运行占位入口 |
-| `app/gui.py` | 已有 | T-104/T-105/T-106 产出：PySide6 `QMainWindow` + 五 Tab；顶部 Tab 栏防误点样式；④ 账号管理表格、账号弹窗、启动登录、检测登录、快捷方式 |
+| `app/gui.py` | 已有 | T-104/T-105/T-106/T-202 产出：PySide6 `QMainWindow` + 五 Tab；顶部 Tab 栏防误点样式；① 导入采集导入按钮、`QTableView` 任务列表、未匹配略过标记；④ 账号管理表格、账号弹窗、启动登录、检测登录、快捷方式 |
 | `app/workers.py` | 已有 | T-104b 产出：`BaseWorker` + 通用 signals + 取消标记 + `run_worker()` QThread 包装 |
 | `app/accounts.py` | 已有 | T-105/T-106 产出：账号 CRUD 服务、目录创建、端口分配、启动登录、检测登录、快捷方式 |
 | `app/editor.py` | 已有 | T-001/T-103 产出：登录状态检测、打开商品页、读/写标题、读/下载封面、上传拖封面、更新按钮、apply_task |
@@ -40,8 +40,9 @@
 | `app/db.py` | 已有 | T-003 产出：batches/accounts/tasks schema；WAL/busy_timeout/foreign_keys；账号/批次/任务与 set_* 阶段写库 |
 | `app/config.py` | 已有 | T-101 产出：别名→稳定 slug；创建并返回绝对 user-data-dir |
 | `app/chrome.py` | 已有 | T-102/T-106 产出：Chrome 启动参数、`subprocess.Popen` 启动、`/json/version` 端口探测、PowerShell `.lnk` 快捷方式 |
-| `tests/` | 已有 | T-006/T-201 产出：stdlib unittest 基座；覆盖 appconfig/db/config/accounts/chrome/editor/excel/gui/workers；prompts 模块契约占位测试 |
+| `tests/` | 已有 | T-006/T-201/T-202 产出：stdlib unittest 基座；覆盖 appconfig/db/config/accounts/chrome/editor/excel/gui/workers；prompts 模块契约占位测试 |
 | `app/excel.py` | 已有 | T-201 产出：多文件 Excel 输入列解析、必需列整文件拒绝、脏行逐行跳过、批次/任务入库、匹配统计；回写留给 T-204/T-403 |
+| `shopee待处理任务模板.xlsx` | 已有，待提交 | 标准空 Excel 模板；单工作表 `待处理任务`，表头 `账号名 | 别名 | 商品id | 旧标题 | 旧封面图片路径 | 新标题 | 新封面图片路径 | 更新状态`；运营复制后填写，填写副本不提交 |
 | `config.json` / `config/ai_models.json` / `cmshopee.db` / `chrome_user_data_dir/` / `images/` | 本地待建，已忽略 | 含配置、密钥、业务、登录态、图片，不提交版本库 |
 
 ## 已验证能力（单账号）
@@ -56,9 +57,9 @@
 
 任务状态以 [`06-tasks.md`](06-tasks.md) 为准，历史记录见 [`../progress.md`](../progress.md)。
 
-- 已完成：T-000（正式代码包结构）、T-001（`app/editor.py` 模块化）、T-002（`app/appconfig.py` + `config.json`）、T-003（`app/db.py` + SQLite 建表）、T-004（本地数据 gitignore）、T-005（AI 模型清单后端）、T-006（单元测试基座）、T-101（账号 slug/user-data-dir）、T-102（Chrome 启动器）、T-103（登录保活与检测）、T-104（PySide6 五 Tab 主窗口骨架）、T-104b（PySide6 worker 基座）、T-105（Tab④ 账号管理）、T-106（账号快捷方式）、T-201（Excel 导入：解析多文件输入列入库）。
+- 已完成：T-000（正式代码包结构）、T-001（`app/editor.py` 模块化）、T-002（`app/appconfig.py` + `config.json`）、T-003（`app/db.py` + SQLite 建表）、T-004（本地数据 gitignore）、T-005（AI 模型清单后端）、T-006（单元测试基座）、T-101（账号 slug/user-data-dir）、T-102（Chrome 启动器）、T-103（登录保活与检测）、T-104（PySide6 五 Tab 主窗口骨架）、T-104b（PySide6 worker 基座）、T-105（Tab④ 账号管理）、T-106（账号快捷方式）、T-201（Excel 导入：解析多文件输入列入库）、T-202（Tab① 任务列表 + 导入按钮 + 别名匹配标记）。
 - 正在进行：无。
-- 下一个可领取任务：**T-202（Tab① 任务列表 + 导入按钮 + 别名匹配标记）**。
+- 下一个可领取任务：**T-202b（Tab① 导入汇总栏）**。
 
 ## 当前可运行内容
 

progress.md

@@ -376,3 +376,19 @@
 - 验证：`python -m compileall app main.py tests` 通过；`python -m unittest discover -s tests` 通过（45 tests，skipped=1，默认 python 环境已安装 openpyxl 并执行真实 Excel 解析测试）；`py -3 -m compileall app main.py tests` 通过；`py -3 -m unittest discover -s tests` 通过（34 tests，skipped=4，py -3 环境缺 openpyxl/PySide6，相关测试按设计跳过，`app.excel` 契约测试通过）。
 - 注意：本轮不涉及 Shopee/CDP 页面改动，无需测试商品实跑。目录中未跟踪的本地 Excel 文件未处理、未纳入本次变更。
 - 下一步：按任务看板领取 T-202（Tab① 任务列表 + 导入按钮 + 别名匹配标记）。
+
+## 【2026-06-27】T-202 Tab① 任务列表 + 导入按钮 + 别名匹配标记
+
+- 状态：DONE
+- 变更：`app/gui.py` 新增 `CollectTab` 与 `TaskTableModel(QAbstractTableModel)`；① 导入采集 Tab 接入「导入 Excel...」按钮、`QTableView` 任务列表和刷新按钮；导入时调用 `excel.import_tasks(file_paths, path=db_path)` 并展示当前批次任务；任务表列为账号、别名、商品ID、阶段，别名未匹配账号时阶段显示“略过”。更新 `tests/test_gui.py` 覆盖 Tab① 接入、任务展示、未匹配略过和导入按钮刷新；同步 `docs/06-tasks.md`、`docs/current-state.md`、`docs/api.md`。
+- 细节：账号列优先显示匹配到的 `accounts.account_name`，未匹配时保留 Excel 输入账号名；T-202 只做 UI 标记，不把未匹配任务立即写库为 skipped，实际跳过与原因入库留给 T-203 采集执行阶段。
+- 验证：`python -m unittest discover -s tests -p "test_gui.py"` 通过（8 tests）；`python -m compileall app main.py tests` 通过；`python -m unittest discover -s tests` 通过（47 tests，skipped=1）；`py -3 -m compileall app main.py tests` 通过；`py -3 -m unittest discover -s tests` 通过（34 tests，skipped=4，py -3 环境缺 openpyxl/PySide6，相关测试按设计跳过）。
+- 注意：本轮只改 GUI/DB 展示与 Excel 导入入口，不涉及 Shopee/CDP 页面操作，无需测试商品实跑。
+- 下一步：按任务看板领取 T-202b（Tab① 导入汇总栏）。
+
+## 【2026-06-27】补充 · 标准 Excel 模板入库规则
+
+- 状态：DONE（文档/忽略规则补充）
+- 变更：将根目录 `shopee待处理任务模板.xlsx` 整理为可提交的标准空模板（单工作表 `待处理任务`，含输入列与后续输出列）；更新 `.gitignore`，默认忽略运营填写后的 `*.xlsx/*.xlsm` 业务文件与 Excel 临时锁文件，但放行该标准模板；同步 `AGENTS.md`、`docs/04-architecture.md`、`docs/api.md`、`docs/current-state.md`、`docs/05-coding-rules.md`。
+- 决策：标准模板推荐表头固定为 `账号名 | 别名 | 商品id`；`别名` 必须与 ④ 账号管理中的别名一致；运营实际填写时复制模板另存，填写后的副本不进版本库。
+- 验证：只读检查 `shopee待处理任务模板.xlsx` 可被当前 `app.excel` 识别核心列（`账号名/别名/商品id`），`file_errors=[]`、`row_errors=[]`；本轮未导入数据库。

tests/test_gui.py

@@ -9,14 +9,21 @@ sys.path.insert(0, os.path.dirname(__file__))
 from _helpers import TempDirMixin
 
 from app import gui
-from app import accounts
+from app import accounts, db
 
 if gui.QT_IMPORT_ERROR is not None:
     raise unittest.SkipTest("PySide6 未安装")
 
-from PySide6.QtWidgets import QApplication, QLineEdit
+from PySide6.QtWidgets import QApplication, QLineEdit, QTableView
 
-from app.gui import AccountDialog, AccountsTab, MainWindow, TAB_STYLE, TAB_TITLES
+from app.gui import (
+    AccountDialog,
+    AccountsTab,
+    CollectTab,
+    MainWindow,
+    TAB_STYLE,
+    TAB_TITLES,
+)
 
 
 class GuiTests(TempDirMixin, unittest.TestCase):
@@ -47,6 +54,7 @@ class GuiTests(TempDirMixin, unittest.TestCase):
             self.assertIn("min-width: 128px", window.tabs.styleSheet())
             self.assertIn("padding: 8px 18px", window.tabs.styleSheet())
             self.assertIn("margin-right: 8px", window.tabs.styleSheet())
+            self.assertIsInstance(window.tabs.widget(0), CollectTab)
 
         self.assert_removed(temp_dir)
 
@@ -149,6 +157,95 @@ class GuiTests(TempDirMixin, unittest.TestCase):
 
         self.assert_removed(temp_dir)
 
+    def test_collect_tab_lists_tasks_with_unmatched_alias_as_skipped(self):
+        with self.make_temp_dir() as temp_dir:
+            cfg = self.make_config(temp_dir)
+            accounts.create_account("主店", "alias-a", debug_port=9222, config=cfg)
+            batch_id = db.create_batch(["input.xlsx"], path=cfg["db_path"])
+            db.insert_tasks(
+                batch_id,
+                [
+                    {
+                        "source_file_abs": os.path.join(temp_dir, "input.xlsx"),
+                        "source_sheet": "商品",
+                        "source_row": 2,
+                        "account_name": "Excel主店",
+                        "alias": "alias-a",
+                        "item_id": "51100639510",
+                    },
+                    {
+                        "source_file_abs": os.path.join(temp_dir, "input.xlsx"),
+                        "source_sheet": "商品",
+                        "source_row": 3,
+                        "account_name": "Excel副店",
+                        "alias": "missing",
+                        "item_id": "51100639511",
+                    },
+                ],
+                path=cfg["db_path"],
+            )
+
+            tab = CollectTab(config=cfg)
+            self.addCleanup(tab.close)
+
+            self.assertIsInstance(tab.table, QTableView)
+            self.assertEqual(2, tab.model.rowCount())
+            self.assertEqual("主店", tab.model.index(0, 0).data())
+            self.assertEqual("alias-a", tab.model.index(0, 1).data())
+            self.assertEqual("51100639510", tab.model.index(0, 2).data())
+            self.assertEqual("待采集", tab.model.index(0, 3).data())
+            self.assertEqual("Excel副店", tab.model.index(1, 0).data())
+            self.assertEqual("missing", tab.model.index(1, 1).data())
+            self.assertEqual("略过", tab.model.index(1, 3).data())
+            self.assertIn("未匹配", tab.empty_label.text())
+
+        self.assert_removed(temp_dir)
+
+    def test_collect_tab_import_button_imports_excel_and_refreshes_tasks(self):
+        with self.make_temp_dir() as temp_dir:
+            cfg = self.make_config(temp_dir)
+            accounts.create_account("主店", "alias-a", debug_port=9222, config=cfg)
+            excel_path = os.path.join(temp_dir, "input.xlsx")
+            statuses = []
+            tab = CollectTab(config=cfg, status_callback=statuses.append)
+            self.addCleanup(tab.close)
+
+            def fake_import(file_paths, path=None):
+                batch_id = db.create_batch(file_paths, path=path)
+                db.insert_tasks(
+                    batch_id,
+                    [
+                        {
+                            "source_file_abs": excel_path,
+                            "source_sheet": "商品",
+                            "source_row": 2,
+                            "account_name": "Excel主店",
+                            "alias": "alias-a",
+                            "item_id": "51100639510",
+                        }
+                    ],
+                    path=path,
+                )
+                return {
+                    "batch_id": batch_id,
+                    "rows": [],
+                    "stats": {"valid": 1, "invalid": 0, "inserted": 1},
+                }
+
+            with mock.patch.object(
+                tab,
+                "_choose_excel_files",
+                return_value=[excel_path],
+            ), mock.patch("app.gui.excel.import_tasks", side_effect=fake_import) as import_tasks:
+                tab.import_excel()
+
+            import_tasks.assert_called_once_with([excel_path], path=cfg["db_path"])
+            self.assertEqual(1, tab.model.rowCount())
+            self.assertEqual("alias-a", tab.model.index(0, 1).data())
+            self.assertIn("入库1", statuses[-1])
+
+        self.assert_removed(temp_dir)
+
 
 if __name__ == "__main__":
     unittest.main()