From 6f36118b7e2332844e5f0902bdda73d56fe71de6 Mon Sep 17 00:00:00 2001 From: chengma Date: Sat, 27 Jun 2026 11:29:48 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20=E5=AE=8C=E6=88=90Tab=E2=91=A0=E4=BB=BB?= =?UTF-8?q?=E5=8A=A1=E5=AF=BC=E5=85=A5=E5=88=97=E8=A1=A8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 实现 CollectTab 与 TaskTableModel，Tab① 接入导入 Excel 按钮、QTableView 任务列表和未匹配别名略过标记。 新增 GUI 测试覆盖 Tab① 接入、任务展示、未匹配标记和导入刷新；同步任务状态、API 合约、当前状态与 progress。 加入标准空模板 shopee待处理任务模板.xlsx，并更新 ignore/文档规则：模板可提交，运营填写后的 Excel 业务文件默认忽略。 --- .gitignore | 7 ++ AGENTS.md | 1 + app/gui.py | 212 +++++++++++++++++++++++++++++++++++++- docs/04-architecture.md | 6 +- docs/05-coding-rules.md | 1 + docs/06-tasks.md | 2 +- docs/api.md | 17 ++- docs/current-state.md | 17 +-- progress.md | 16 +++ shopee待处理任务模板.xlsx | Bin 0 -> 7053 bytes tests/test_gui.py | 103 +++++++++++++++++- 11 files changed, 363 insertions(+), 19 deletions(-) create mode 100644 shopee待处理任务模板.xlsx diff --git a/.gitignore b/.gitignore index 66f6aaa..75d6d0f 100644 --- a/.gitignore +++ b/.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 diff --git a/AGENTS.md b/AGENTS.md index fd91697..949dda0 100644 --- a/AGENTS.md +++ b/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 的验证码、风控、限流或权限校验。 diff --git a/app/gui.py b/app/gui.py index d8fd3d6..8a45b7d 100644 --- a/app/gui.py +++ b/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, diff --git a/docs/04-architecture.md b/docs/04-architecture.md index a384d21..d2d8692 100644 --- a/docs/04-architecture.md +++ b/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 副本属于业务数据，不提交。 ## 十、架构纪律 diff --git a/docs/05-coding-rules.md b/docs/05-coding-rules.md index f1eabb8..d47035a 100644 --- a/docs/05-coding-rules.md +++ b/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。 diff --git a/docs/06-tasks.md b/docs/06-tasks.md index 92e5a6f..4dc0d09 100644 --- a/docs/06-tasks.md +++ b/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//`；未登录/未匹配略过记原因 | TODO | | T-204 | 回写旧字段到原 Excel（含文件锁处理） | T-203, T-201 | 旧标题/旧封面回写原文件；被锁提示重试或 export_copy | TODO | diff --git a/docs/api.md b/docs/api.md index f57b7f6..35d7537 100644 --- a/docs/api.md +++ b/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 diff --git a/docs/current-state.md b/docs/current-state.md index fd086bb..f2fc6f3 100644 --- a/docs/current-state.md +++ b/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① 导入汇总栏）**。 ## 当前可运行内容 diff --git a/progress.md b/progress.md index 8ece3d1..7d875f2 100644 --- a/progress.md +++ b/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=[]`；本轮未导入数据库。 diff --git a/shopee待处理任务模板.xlsx b/shopee待处理任务模板.xlsx new file mode 100644 index 0000000000000000000000000000000000000000..5895af4f3060f682f0ea631ef6b147d357f10f5e GIT binary patch literal 7053 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