# 验收报告 · T-001 ~ T-103（含 T-000/T-004/T-005/T-006）

- 日期：2026-06-27
- 范围：Codex 完成的 Phase 0 地基（T-000~T-006）+ Phase 1 账号与启动（T-101~T-103）
- 评审方式：编译检查 + 单元测试 + 逐模块源码阅读 + 对照 `docs/api.md`/`docs/04-architecture.md`/`docs/06-tasks.md` 契约
- 结论：**通过。按文档完成，忠实于已验证事实，质量偏上。**

## 一、验证方法与结果

```
python3 -m compileall app main.py        # OK
python3 -m unittest discover -s tests    # Ran 22 tests, OK (skipped=2)
```

2 个 skip 为 `app.excel` / `app.prompts` 的**契约测试**（模块尚未实现则自动跳过，实现后即校验），属预期。

## 二、逐任务核对

| 任务 | 结论 | 关键核对 |
| --- | --- | --- |
| T-000 包结构 | ✅ | `app/` 包 + `main.py` + `__main__.py`；prototypes 导入已修正 |
| T-001 `editor.py` | ✅ | 已验证 CDP 事实全部对上（见第三节）；满 9 张不臆造删除，返回 `FULL_IMAGE_SLOTS` 留 T-502 |
| T-002 `appconfig.py`+`config.json` | ✅ | 默认值齐；`response_timeout` 按分辨率派生；`_assert_no_secrets` 强制 config.json 不含密钥 |
| T-003 `db.py`+SQLite | ✅ | WAL/busy_timeout/foreign_keys；建表幂等；`set_collected/generated/applied` 等齐；schema 与架构 5.2 双向同步 |
| T-004 `.gitignore` | ✅ | 配置/密钥/DB/凭证/图片全部排除 |
| T-005 ai_models 后端 | ✅ | category 过滤、唯一名校验、至少各一个 text/image、`_mask_api_key` 打码、`get_model` |
| T-006 测试基座 | ✅ | 22 测试通过；excel/prompts 用契约测试自动 skip |
| T-101 slug+目录 | ✅ | 规范化 + sha1 后缀保证唯一；路径绝对化；按需建目录 |
| T-102 `chrome.py` 启动器 | ✅ | 正好三参数；`/json/version` 探测用空 ProxyHandler 绕过系统代理 |
| T-103 登录保活+检测 | ✅ | 登录页重定向 / 缺 `SPC_ST·SPC_U` 判未登录；5 个登录单测覆盖 |

## 三、已验证 CDP 事实保留情况（最关键）

`app/cdp.py` 完整保留三处防护：清除 `*_proxy` 环境变量、`requests.trust_env=False`、`websocket` 连接 `suppress_origin=True`。

`app/editor.py` 与原型逐项一致：

| 事实 | 实现 |
| --- | --- |
| 标题输入框 XPath | `//input[@class='eds-input__input' and string-length(@modelvalue)>24]` ✅ |
| SPA 就绪判断 | 标题框 + itembox + 上传 input 三者皆存在 ✅ |
| 写标题让 Vue 感知 | 原生 setter + 派发 input/change，校验 `value==modelvalue==新值` ✅ |
| 上传输入框 | `.shopee-image-manager__upload input[type=file]` + `DOM.setFileInputFiles` ✅ |
| 上传成功判断 | 轮询张数 +1 且新图 src 含 `susercontent`、非 `blob:` ✅ |
| 封面=第一位 | 拖拽落点 `first.left - 0.30*w` ✅ |
| 更新按钮 | `button.eds-button` 中 `<span>更新</span>`，禁用态识别 ✅ |
| 登录检测 | 登录页 URL 或缺 `SPC_ST`/`SPC_U` → 未登录 ✅ |

## 四、值得肯定

1. **不臆造未验证内容**：满 9 张删除封面未硬写，明确注释"确认框选择器未验证，留 T-502"。
2. **文档↔代码一致**：db schema 比原 5.2 丰富（batches 表、stage/status 分离、`*_attempts` 重试、行级定位 `source_file_abs/sheet/row/row_key`），但架构 5.2 已同步更新。
3. **工程加分项**：SQLite 多线程连接纪律、密钥脱敏与 `_assert_no_secrets` 守卫、契约式 pending 测试。

## 五、小问题（不影响验收，可不改）

- `editor.replace_cover` 在 `setFileInputFiles` 后又手动派发一次 input/change（原型无，冗余但无害）。
- `collect()` 旧封面写死 `.jpg` 扩展名（Shopee 封面基本为 jpg，影响极小）。

## 六、待办 / 边界

- ⚠️ T-001 验收原文为"在测试商品跑通"，但本轮测试均为 **mock CDP**，未连真实 Shopee。`editor.py` 是对此前已在线验证过的原型的忠实移植，可信度高，但**这份新代码尚未在真实 Shopee 上重新冒烟**。
- **建议**：接 GUI（T-104+）前，用 prototypes 同款环境对 `editor.py` 做一次真机冒烟（打开测试商品 → 采集 → 改标题 → 换封面，不提交），确认移植无回归。

## 七、总评

合格偏上的工程交付：按文档、守纪律、有测试、不臆造。可放心推进 T-104（PySide6 主窗口骨架）。