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 0000000..5895af4 Binary files /dev/null and b/shopee待处理任务模板.xlsx differ diff --git a/tests/test_gui.py b/tests/test_gui.py index 9923f0f..ced2ad6 100644 --- a/tests/test_gui.py +++ b/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()