xsl
e7076c9c01
dimensions.py 逐行编码需求文档 §4（32 项四要素、缺失显式 skipped）+ VisionProvider 接口位与确定性实现 + 规则引擎联动 rule_hits（T-P3-01/06）。 实现： - dimensions.py：DimensionSpec 恰 32 项（number 1~32 连续，33/34 永不复用）， basic_coverage 口径机器可读：full 10 / label 3 / partial 8 / none 11， 初级覆盖 21/32（BASIC_FULL_KEYS + BASIC_COVERED_KEYS）。 - vision.py：VisionProvider Protocol（派生特征形状写进 docstring，真实 RTMPose/BiRefNet 实现后续按此替换）+ DeterministicVisionProvider（问卷 BMI/自评驱动体型与肤色，sha256(object_key+canonical问卷) 驱动其余枚举， 同输入同输出）+ build_vision_provider（未知名 CONFIG_ERROR）。 - vision_stage.py：derived_features 已存在 → skipped/reused（T-P3-09）； 否则分析 → 写中间态并 flush；photo_meta.quality_flags 透传进产物（T-P3-01）。 - diagnosis_stage.py：32 维恒全键，缺输入显式 skipped+原因（T-P3-06 红线）； 每维四要素 value/confidence/source/evidence/rule_hits + status；构造 RuleContext → RuleService 载入 published 规则 → evaluate，body_shape/color 类命中回落 #5/#19/#21，全量命中聚合进 #28/#30 的 rule_hits 与 evidence； 色板 #19/#20/#21 从 kb_color 按季型读取，库空 → skipped「色板未录入」。 测试：单测 29 项（32 项完整性/编号连续/确定性/工厂拒绝未知名；四要素齐全 性——故意缺问卷+缺视觉断言 32 键全在且全部 skipped 带原因；规则命中进 rule_hits 用内置最小规则集不连库）；集成 1 项（种 2 条 published 规则 → VisionStage → DiagnosisStage：中间态落库与复用 skipped/reused、32 维全键、 rule_hits 出现、kb_color 空时色板 skipped、coverage basic_full=10/32）。 全绿：ruff check/format、mypy packages/report、lint-imports；单测 536 通过 （3 处既有 skip）、集成 46 通过。 偏差说明： 1. 任务文档写 RulesService，实际类名为 RuleService（packages/rules/service.py），按实际代码调用。 2. kb_color 联表键采用四季代码 spring/summer/autumn/winter（仓库无既定口径），已在 vision.py 注释声明。 3. 任务文档只给 basic_coverage 四枚举，需求表格中的「粗判/8色/3色」归入 partial、「Top1」归入 label。
packages/report/ — 美学报告（占位）
职责（架构 §4.1）：触发判定、生成编排、版本管理、分享。 不负责：具体的视觉分析与文案生成（调 AI 能力层）。
待实现
- 表：
rp_reportrp_inputrp_share - 架构 §7.1 的 24 步生成链路（这是全系统最复杂的一条）
这条链路上不能妥协的四件事
- 原图生命周期：直传 COS 临时桶 → Worker 拉取 → 第 14 步显式删除 →
桶级 2 小时生命周期兜底（TD-20 / CR-02）。
rp_input只存派生特征与图片元信息。 - 失败即退款：任何步骤失败 →
tk_task转 failed →billing.refund()。 - 分步可恢复：视觉分析结果必须落中间态，LLM 或渲染失败时不重跑视觉分析 （也就不需要用户重新上传）。
- 生成后校验不可跳过：禁忌违反、色值在板内、维度引用存在、无医疗/贬损表述。 最多重试 2 次，仍失败降级为规则直出模板文案，绝不放行违规内容。