看板升级: L3分析引擎原型v0.1 + 视觉方向定稿 + 页面布局设计

- 新增 l3_analysis_prototype.py：读Excel 25期收视 + GT 20期AI标签，计算5个分析模块（指标卡/走势/季度/题材/编导），输出HTML+ECharts报告 - 制片人审定视觉方向：磨砂玻璃/大倒角/1100px限宽/暖色渐变 - 页面布局定稿：指标卡→走势图→L4诊断(走势图下方)→季度+题材→编导→象限图 - 范围选择器定方案A（按自然年分页+年内dataZoom滑块） - 新增设计参考图3张（功能区划/幅面参考/页面风格） - 更新两份CLAUDE.md状态栏+进度+关键决策+交接备注 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-06-26 20:19:05 +08:00
parent ffb507a87c
commit 93db565c10
7 changed files with 896 additions and 20 deletions
@@ -13,7 +13,7 @@
 ## 🔖 状态栏（每次结束 session 前必须更新这三行）

 - **最后更新**：Claude Opus（顾问）｜ 2026-06-26
- **当前状态一句话**：L2 打标收摊。GT v0.5.0（20期6字段全覆盖）。Schema 加字段方案已写好（003_add_ai_labels.sql + Model），待在数据库上执行。下一步进 L3 分析引擎设计。
+- **当前状态一句话**：L3 分析引擎原型 v0.1 已出（HTML 可视化，5 模块 + L4 模拟诊断），制片人审完视觉方向，页面布局和交互设计方案已定。下一步：原型微调收尾 → 进 React 前端实现。
 - **下一个动手的人从这里开始**：见下方「⏩ 交接备注」

 ---
@@ -109,8 +109,8 @@
 |----|------|--------|----------|
 | L1 | **数据沉淀** | 每期节目的收视数据、文稿全文、编导、选题单持续入库 | 主项目已有 episodes 表基础结构 |
 | L2 | **AI 打标** | 读文稿自动判别：题材分类(4字段)、叙事结构(2档)、开篇钩子(3档) | Prompt 1 v0.3(80%) + Prompt 2 v0.2(100%) + Prompt 3 v0.2(90%)，三个均达可用水平 |
-| L3 | **分析引擎** | 基于双引擎模型，计算走势、编导对比、题材对比、高低样本对照等多维分析 | 待设计 |
-| L4 | **诊断报告** | 调用 LLM 生成文字诊断结论 + 改进建议（对标 PPT 第 8-10 页水平） | 待设计 |
+| L3 | **分析引擎** | 基于双引擎模型，计算走势、编导对比、题材对比、高低样本对照等多维分析 | HTML 原型 v0.1 已出（5 模块），页面布局已定 |
+| L4 | **诊断报告** | 调用 LLM 生成文字诊断结论 + 改进建议（对标 PPT 第 8-10 页水平） | 位置已定（走势图下方），模拟文字已预览 |

 ### 1.6 三层分步交付策略（v1 快照定稿）

@@ -229,14 +229,16 @@ python scripts/summarize.py --model mimo-v2.5-pro --field opening_hook

 ## 3. 当前进度（动态，核心交接区）

- **已完成**：三个 Prompt 均达可用水平 + GT v0.5.0（20期6字段全覆盖）+ schema 加字段方案（SQL + Model 已写好）+ git 大扫除
- **正在做**：无
- **卡点/待解**：① 003_add_ai_labels.sql 待在数据库上执行（先 pg_dump 备份）；② L3 分析引擎架构设计未启动
+- **已完成至**：L3 原型 v0.1（HTML 可视化 + 制片人审定视觉方向），L2 打标收摊，003 迁移到位
+- **正在做**：L3 原型视觉微调（Cline 执行），页面布局设计讨论中
+- **卡点/待解**：无硬卡点。下一步进 React 前端实现前需定最终页面线框图

 ---

 ## 4. 已完成（只追加，最新在上）

+- [2026-06-26 ｜ Opus] L3 分析引擎原型 v0.1：Python 脚本读 Excel（25期）+ ground-truth（20期AI标签），计算 5 个模块（核心指标卡/走势图/季度对比/题材对比/编导对比），生成 HTML+ECharts 可视化报告。制片人审定：磨砂玻璃+大倒角+1100px 限宽+暖色渐变底；L4 诊断报告位置定在走势图下方（摘要-详情模式）；题材饼图+柱图组合；摸高完成率动态变色。脚本 `scripts/l3_analysis_prototype.py`，输出 `output/l3_report.html`。
+- [2026-06-26 ｜ Opus] 003_add_ai_labels.sql 迁移已在 milsci_dev 执行：episodes 表 +7 列（program_format / equipment_domain / scene_tags / tech_tags / narrative_structure / opening_hook / ai_label_confidence）+3 索引。COMMENT 因 Windows GBK 编码未写入，不影响功能。Schema（schemas/episode.py）留待 L3 API 时同步更新。
 - [2026-06-26 ｜ Opus] GT v0.5.0：补完10期narrative_structure标注（MiMo跑批85%命中+制片人审定，ep019从AI判主线演进改为并列结构）。20期6字段全覆盖。Schema加字段方案：003_add_ai_labels.sql（episodes表+7列）+ episode.py Model同步。summarize.py修复无标注期次崩溃。Git大扫除：doco/programs中间产物移出git、.gitignore补全、deliverables/寄存条入库。commit `cdb213f`。
 - [2026-06-25 ｜ Opus] Prompt 1 迭代 v0.1→v0.3（全对率40%→80%）：v0.2加多选字段显著篇幅门槛+从属零件反例+前沿科技vs横切类比拆清+装备深解同类体系测试；v0.3修正跨域规则（传播分类框非军事术语）+训练舰窄类别判定+装备首发校准。ground-truth v0.4.1（ep008补标跨域）。
 - [2026-06-25 ｜ Opus] Prompt 3 v0.1→v0.2（开篇钩子，命中率50%→90%）：v0.1撰写+脚本opening_hook支持；v0.2修复三问题——阅读范围扩至3段（导视+主持人+首段解说）、强判定从紧迫感硬门槛改为6条独立路径、弱判定区分信息性提问vs悬念式提问。ground-truth v0.4.2（20期opening_hook全标注，制片人逐期审定含钩子分析）。summarize.py改为从源GT文件读取。
@@ -269,20 +271,27 @@ python scripts/summarize.py --model mimo-v2.5-pro --field opening_hook

 ### L1 — 数据沉淀（与主项目交界，需 Opus 审）

- [ ] **episodes schema 加字段** — 方案已就绪（`003_add_ai_labels.sql` + Model），待在数据库执行。先 `pg_dump` 备份。
+- [x] **episodes schema 加字段** — 003 迁移已执行（2026-06-26），7 列 + 3 索引到位。
 - [ ] **文稿入库流程** — 每期文稿全文入知识库（主项目 Phase 3 已有知识库基础设施）。
 - [ ] **收视数据导入** — 真实收视 Excel 批量导入 + 清测试数据。

-### L3 — 分析引擎（待设计）
+### L3 — 分析引擎（原型已出，进入前端实现）

- [ ] **分析维度定义** — 对标 Excel 8 个 Sheet：核心指标卡、走势图、编导对比、题材对比、阶段对比、高低样本对照、诊断结论。
- [ ] **计算逻辑实现** — 滚动均值、达标率、分组统计、样本排序等。
- [ ] **API 设计** — 支持按季度/自定义周期查询，返回结构化分析数据。
+- [x] **HTML 原型 v0.1** — 5 模块计算验证通过（指标卡/走势/季度/题材/编导），25 期数据全部读入。
+- [x] **视觉方向定稿** — 磨砂玻璃+大倒角+1100px 限宽+暖色渐变底+三色判定+题材饼图柱图组合。
+- [x] **页面布局定稿** — 指标卡 → 走势图 → L4 诊断报告 → 季度对比+题材对比 → 编导对比 → 双引擎象限图。
+- [ ] **范围选择器（方案 A 已定）** — 按自然年分页，年内用 ECharts dataZoom 滑块选范围，下方所有模块联动刷新。历史年份（如 2025）仅展示走势+编导（无 AI 标签的模块标灰）。
+- [ ] **单期详情页入口** — 走势图柱子可点击跳转到该期节目分析页（独立子项目）。
+- [ ] **计算逻辑实现（React）** — 将原型 Python 计算逻辑搬进 backend API。
+- [ ] **API 设计** — 支持按年度+自定义期次范围查询，返回结构化分析数据。

-### L4 — 诊断报告（待设计）
+### L4 — 诊断报告（位置已定，待实现）

+- [x] **位置定稿** — 走势图下方，摘要-详情模式（看板页固定高度干条 + 点击展开详情页全文）。
+- [ ] **自适应色调 Prompt 机制** — 根据选定范围的达标率/均值动态切换分析角度：优秀期→复盘总结模式；问题期→病因诊断模式；混合→综合对比模式。
 - [ ] **多 LLM 共识选型测试** — 用样板数据测试 MiMo / GLM 5.2 / 其他模型的诊断分析能力，确定阵容。
 - [ ] **诊断 Prompt 撰写** — 输入结构化分析数据，输出自然语言诊断结论 + 改进建议。需融入双引擎理论框架。
+- [ ] **外部因素关联分析** — 结合互联网搜索（同时段竞争节目、社会热点）丰富诊断深度。
 - [ ] **共识聚合逻辑** — 多家结果如何合并/投票/呈现。
 - [ ] **UI 置信度三档** — AI 草稿/制片人确认/标题推断一眼可辨。

@@ -350,6 +359,17 @@ python scripts/summarize.py --model mimo-v2.5-pro --field opening_hook
 - [2026-06-11] **三个 Prompt 独立**（分类 / 叙事结构 / 开篇钩子），不合并成一个大 Prompt。
 - [2026-06-11] **示例集"慢慢长大"**：10-30 期全塞 prompt → 30-80 期 pgvector 检索相似 → 80+ 期固定 5 + 动态 5-8。栈里 pgvector 已就位，第二阶段不新增依赖。

+### L3/L4 页面设计决策
+
+- [2026-06-26] **范围选择器走方案 A（按自然年分页）**：每年目标清零+基础/摸高数值可能变+2025 年以前无文稿无 AI 标签，跨年混算问题太多。年内用 ECharts dataZoom 滑块选范围，所有模块联动刷新。
+- [2026-06-26] **L4 诊断报告位置：走势图下方**（不是最底部）：制片人定调——诊断分析是最有含金量的内容，不能埋在最后。摘要-详情模式：看板页放 3-5 条干条，点击展开详情页看全文。
+- [2026-06-26] **L4 诊断内容自适应选定范围色调**：全红→复盘总结模式；全绿→病因诊断模式（语气重）；混合→综合对比模式。
+- [2026-06-26] **页面幅面 max-width 1100px 居中**：参考 Crextio 风格，不撑满全屏。
+- [2026-06-26] **视觉方向**：磨砂玻璃卡片（backdrop-filter: blur）+ 大倒角（16px）+ 暖色渐变底 + 充足留白。参考风格图 `example/页面风格.webp`。
+- [2026-06-26] **摸高完成率动态效果**：≥95% 红色微光闪烁；85-94% 蓝色；80-84% 绿色脉冲；<80% 黑色+红色警报光晕。
+- [2026-06-26] **收视分析看板 ≠ TPS 仪表盘首页**：首页是每天扫一眼的门面（题图/近9期/热点/排播），分析看板是左侧工具栏里的深度分析入口。首页从看板抽关键数字展示。
+- [2026-06-26] **2026 年收视目标**：基础 0.6448，摸高 0.8989。
+
 ### 技术约束

 - [2026-06-11] MiMo / M3 等 reasoning model 输出带 `<think>...</think>` 前缀。脚本用 `extract_json_from_response` 正则剥掉后再 `json.loads`。**换其他 reasoning model（R1、o1 系列）同样适用。**
@@ -361,11 +381,14 @@ python scripts/summarize.py --model mimo-v2.5-pro --field opening_hook

 ## 7. ⏩ 交接备注（换人/换工具 0 摩擦续上）

- **L2 打标已收摊**（2026-06-26）：三个 Prompt 均可用（分类80%/结构85%/钩子90%），GT v0.5.0 20期6字段全覆盖。边际收益递减，暂停迭代。
- **Schema 加字段方案已就绪**：`backend/sql/003_add_ai_labels.sql`（episodes 表 +7 列）+ `backend/app/models/episode.py`（Model 同步）。**待在数据库上执行**：先 `pg_dump` 备份 → 执行 SQL → 验证。
- **Git 已清理**（2026-06-26）：doco/programs 中间产物移出 git（本地保留），.gitignore 补全，`git status` 干净。
- **下一步**：① 在数据库执行 003 迁移 → ② L3 分析引擎架构设计（对标 Excel 8 个 Sheet）→ ③ L4 诊断报告。
- **L3/L4 待设计**：分析引擎和诊断报告的架构尚未展开。数据基础（打标+schema）就位后可启动。
+- **L3 原型已出**（2026-06-26）：`scripts/l3_analysis_prototype.py` 读 Excel 25 期 + GT 20 期标签，输出 `output/l3_report.html`。5 个模块计算验证通过，视觉方向已定（磨砂玻璃/大倒角/限宽/暖色渐变），L4 位置已定（走势图下方）。原型仍在微调中（Cline 执行视觉改动）。
+- **页面布局已定**（2026-06-26）：指标卡 → 走势图 → AI 诊断报告(L4) → 季度+题材对比 → 编导对比 → 双引擎象限图。范围选择器走方案 A（按自然年分页 + 年内 dataZoom 滑块）。
+- **关键数据**：2026 年基础目标 0.6448，摸高目标 0.8989。25 期完整收视数据在 `example/2026收视update.xlsx`。5 位编导：张彤枫/付天雨/孙逸昊/穆佩弦/左鑫。
+- **GT↔Excel 映射**：ground-truth 的 20 期 ep 编号与 Excel 期次不同（GT 用重映射编号），脚本通过关键词匹配标题。5 期无标签：第1/2/9/24/25期。
+- **L2 打标已收摊**（2026-06-26）：三个 Prompt 均可用（分类80%/结构85%/钩子90%），GT v0.5.0 20期6字段全覆盖。
+- **003 迁移已执行**（2026-06-26）：episodes 表 +7 列 +3 索引到位。`schemas/episode.py` 尚未加新字段，留待 L3 API 时同步。
+- **下一步**：① 原型视觉微调收尾；② 页面线框图定稿；③ 进 React 前端实现（Cline 主力，Claude 审关键逻辑）。
+- **单期详情页**：走势图柱子可点击跳转（已登记需求入口，独立子项目，暂不实施）。

 ---

@@ -373,6 +396,9 @@ python scripts/summarize.py --model mimo-v2.5-pro --field opening_hook

 - [x] ~~Prompt 1 的 4 分类字段枚举最终口径~~ → 已在 v2 快照锁定（见 §1.4）
 - [ ] 多 LLM 共识机制的模型阵容（MiMo + GLM 5.2 + ?）待选型测试后定
- [ ] L3 分析引擎是否需要超出 Excel 8 Sheet 的额外分析维度
+- [x] ~~L3 分析引擎是否需要超出 Excel 8 Sheet 的额外分析维度~~ → 暂不增加，先复刻 Excel 能力
+- [x] ~~范围选择器方案 A vs B~~ → 方案 A（按自然年分页），2025 年以前无文稿无 AI 标签不适合跨年混算
+- [x] ~~L4 诊断报告放在页面什么位置~~ → 走势图下方（制片人定调：诊断是最有含金量的内容）
+- [ ] L4 诊断需要哪些外部搜索 API（同时段竞争节目热度等）
 - [x] ~~下一步优先级：先推 Prompt 1 还是先推 schema 加字段方案？~~ → Prompt 1 先行，已完成 v0.3（80%）
 - [x] ~~Prompt 1 示例集是否需要扩充？~~ → v0.3 已扩至 7 个示例（含防空反导、硅基大脑等易错案例），全对率 80%