# SS27 女装秀场研究 SOP

版本 1.0。工作目录：`D:\codex\fashion-workbench\runway-research`。研究受众：小红书电商女装、设计师／高端女装。范围：四大时装周本季女装成衣，巴黎／米兰优先；不是高定、婚纱、童装或纯男装。

## 1. 在现有工程续跑

先读 `README.md`、`data/catalog.json` 中 summary、`data/validation.json` 和 `data/update_history.json`。不要另建项目，也不要重新分析全部图片。用户新需求与旧记录冲突时，以新要求为准并记录变化。

`index.html` 是离线浏览入口，不依赖外部账号。默认展示已保存图像；选择“全部公开索引（需联网）”可以按需查看尚未保存的官方原图。官方细节图按媒体编号关联，未下载时也明确标注需联网。`scripts/serve.py` 只监听本机 127.0.0.1，可提供只读API。已有服务还在运行时直接复用。

## 2. 冻结本次输入，再查变化

统一入口 `update.ps1` 获得排他锁；同一工作目录不重叠更新。更新前把元数据、分析记录和原始页面缓存归档到 `snapshots/`。成功图片文件按稳定路径复用，避免重复下载和重复模型处理。

分别记录母集来源、季节、门类和日期。巴黎目录、日程和单场官方页分开读取；米兰优先官方日程与品牌页，品牌官网作为补充；纽约伦敦先从官方公告建立母集，再核对最终日程。仅看“最新”标签不够，必须检查页面标题、系列正文和媒体名称的季节一致性。

## 3. 采集与保存

调用 provider 的发现／元数据接口，按来源获取公开图片URL及编号。遵循串行／保守限速、有限重试与服务器 Retry-After。明确401、403、验证码或付费限制时记录状态，不尝试登录、代理轮换或访问控制绕过。网络失败保留上次有效结果；上游改版或季节错配进入人工检查。

保存每场来源URL、原始HTML或API响应、获取时间、版权署名、可公开视频链接和素材状态。每张图保存稳定ID、图册顺序、原URL、本地路径、SHA-256及图像尺寸。官网图序不一定是真正Look号，不能自动把末尾谢幕或多人图算成服装套数。视频目前只保留官方入口；仅视频的场次进入待图册队列，不默默抽帧并宣称全套。

## 4. 范围筛选和完整性

有明确WW/W/M媒体标记时按来源分流；否则仅按官方女装系列归属及服装资料处理，不根据模特人脸推断身份或性别。混秀缺少服装分类证据时标范围待核。排除明确谢幕、嘉宾、后台及旧季图。

对每场比较官网已公开图片数量、索引数和本地有效图片数；区分“相对当前来源完整”和“官方是否已发布全系列”。在未锁定全季母集、未解决全部缺口前，不用“全覆盖完成”作为状态。纽约初步日程不是最终全量母集。

## 5. 逐图分析与拆解

本轮由AI逐图观察并记录，未经另外的人工审核。仅对实际看过的图写分析，记录到 `data/*_analysis.json`；遵守 `data/analysis.schema.json`。先看全身比例，再拆可见单品、领袖肩腰、闭合、口袋、褶量与下摆。材料记录分官方逐款A、官方系列B、视觉候选C，候选有理由、替代解释及验证动作。

局部框使用原图0–1归一化坐标。图册通过原图局部定位提供拆解视图；不填造背面或内部结构，不把局部图称为纸样。需要技术包时另做自有设计，标注推演与事实边界。

模特姓名默认空，仅采用官方明确关联到本图的文字署名。复核图册中的姓名也不能通过人脸进行反向确认。材料成分比例、克重、真实色号、供应商与性能没有证据就留空。

每个分析保存当时图片哈希；图片变更后标 `stale_image`，从频次统计中移除并重新审核。只新增证据不改变图像时，由分析者审阅对应字段。修改分析前保留快照。`write_priority_analysis.py` 与 `write_milan_priority_analysis.py` 是本次逐图观察的记录构建器，不是视觉模型，也不应在未来自动更新中执行。

## 6. 生成数据与报告

先运行 `build_catalog.py` 汇合 provider、母集与分析，检查孤儿ID和变更图片；再运行 `build_reports.py`，最后 `export_pdfs.py`，完成后重建 catalog 使PDF入口出现。这些脚本都可离线运行，不重复消耗图像分析算力。

数据库以 shows、looks、analyses、materials、source_records 和 build_history 分层保存。服装与面料报告只统计已复核且明确纳入女装的记录；单品数和Look数不同，品牌间样本不平衡需要声明。只凭当季数据不能判断趋势涨跌，只有曝光和点赞不能推出销量。

## 7. 验收

- 图片来源、季节和ID可追溯；不能以随机占位图替代失败图。
- 图片实际可打开；本地路径存在，SQL外键无孤儿。
- 新图和待分析状态可见；样本统计分母有说明。
- 图册筛选、详情、比较、报告、JSON导出可操作。
- 报告来源有效，事实与建议分开；PDF中文可检索且渲染无溢出。
- 离线重跑不增加重复ID；下载重跑优先复用已成功文件。
- 写入 `data/validation.json` 和更新历史。失败清楚记录，不把失败变成“0条新增、全部正常”。

## 8. 后续定时与收官

当前是否已开启自动更新以 `docs/schedule.json` 为准；不存在或enabled=false表示仅手动。

适合的节奏是秀期每日轻量发现，官方图册发布后只补新图；巴黎结束后另做一次收官核对。收官需要最终母集和素材稳定性证据，不因到某日期自动标完成。缺图、范围待核、逐套分析待完成分别保留。

调度任务调用同一个更新入口，读取上次状态，优先处理巴黎米兰重点品牌的新增或缺口，然后补纽约伦敦。无变化且无需用户操作时不打扰用户；发现有意义的新素材、完成、失败或需要选择时才通知。自动更新只能抓取和重建，新增图的逐图分析仍由具备视觉能力的Agent按本SOP完成，不能把默认模板算成分析。


## 9. 材料频率计算

先筛 analysis_status=reviewed 且 analysis.classification=womenswear，不要使用可能保留旧值的顶层 classification。排除 category 为配饰的记录。将每件衣服全部候选名称按 material_taxonomy.json 归并，单品内同方向去重，再按 look_id 去重，分别计算单品出现率和图像出现率；alternatives 不计频次。原名称含“或”的候选保留宽类别或待核，不拆成实际同时用料。

多标签表不是互斥成分表。官方逐款、系列披露与视觉候选分开；材料的系列披露频次仅以已核对的披露系列作分母，不把无资料系列算作未使用。变更名称映射需更新 taxonomy 版本，保留待归并记录与审计映射。

官方系列材料频率另用 data/official_material_frequency_map.json 保存已核实名称与材料说明指纹；说明变化时暂停对应系列的材料计数并重新核对，不能自动沿用原标签。


## 10. Chloé 本季图片与断点续跑

Chloé SS27 对应 2026-10-01 巴黎秀场，稳定 show_id 为 paris-chlo-ss27。品牌官网 Spring 27 预系列不可混入。当前主图和细节图采用 Vogue 公开图库，图片署名 Courtesy of Chloé，来源与官网/FHCM 入口分别保存。

使用 scripts/collect_chloe.py --metadata-only --refresh 重新发现本季图库；使用 --download-only 补主图，使用 --download-only --all-details 补全部已发现细节图。已有成功文件和 SHA-256 会复用。只补重点图可用 --download-only --details-for 1,12,20,25,29,33,35,41,48,54。保持串行和默认保守间隔，遇访问限制保留失败状态。

截至 2026-10-02：55 张主图已保存，其中 54 张女装、1 张谢幕；106 张细节已全部保存，无待下载项。10 张服装主图已由 AI 逐图分析，44 张待分析，不把待分析记录纳入面料频次。最新缺口以 raw/chloe/download_queue.json及 catalog 为准。

新增或修改分析后，按第 6 节离线重建报告。scripts/verify_chloe.py 校验主图、细节图与关联；scripts/verify_assets.py 校验全库。原图变化时必须重新看图，不能自动继承旧面料结论。


## 11. 国内协作站点发布

图片和缩略图、CSS、JavaScript、频率明细与 PDF 均由本站提供，主页无境外字体或脚本依赖。图册默认只显示已保存图片；未下载的来源细节仅提供外部链接。先运行 build_web_thumbnails.py，再 build_catalog.py；标准 update.py 已包含缩略图构建。

build_deploy.py 仅打包网站白名单文件，不发布原始 HTTP 缓存、数据库、工作日志或任何登录密钥。部署前保留旧 release 和站点配置，使用独立目录；先通过语法检查和本地 Host 头测试，再切换 current 链接并重载服务。DNS/HTTPS 完成不等于大陆访问验收，需独立大陆网络实际访问首页、图片、报告和下载。具体已完成步骤记录在 docs/DELIVERY_STATUS.md。