From 886ddd8e88c3fa154a349aaf6424d70035c5f072 Mon Sep 17 00:00:00 2001 From: simonkoson <28867558@qq.com> Date: Fri, 3 Jul 2026 09:32:37 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E7=9C=8B=E6=9D=BF=E5=8D=87=E7=BA=A7?= =?UTF-8?q?=E5=AD=90=E9=A1=B9=E7=9B=AE=E5=8E=9F=E5=9E=8B=E9=98=B6=E6=AE=B5?= =?UTF-8?q?=E6=94=B6=E5=B7=A5=EF=BC=8C=E4=BA=A4=E4=BB=98=E6=B8=85=E5=8D=95?= =?UTF-8?q?=E5=86=99=E5=85=A5=E5=AF=84=E5=AD=98=E6=9D=A1?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 更新4份文件：主项目CLAUDE.md状态+待办+交接备注、子项目CLAUDE.md状态栏、 两份寄存条追加交付清单（Schema/打标/前端规范/理论框架）。 主项目待办新增第④选项：收视分析看板React前端实现。 Co-Authored-By: Claude Opus 4.6 --- CLAUDE.md | 13 ++++--- ai-labeling/CLAUDE.md | 6 +-- .../main/寄存条_看板升级已外迁.md | 25 ++++++++++++ note/寄存条看板升级已外迁.md | 38 +++++++++++++++++++ 4 files changed, 73 insertions(+), 9 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 1eb86dd..08df021 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -14,7 +14,7 @@ ## 🔖 状态栏（每次结束 session 前必须更新这三行） - **最后更新**：Claude（顾问）｜ 2026-07-03 - - **当前状态一句话**：远程仓库已迁至腾讯云 Gitea（101.42.29.217:3000），双机开发就绪；git 历史已清理大文件（769MB→5MB）。Phase 3 知识库已完成，主干暂停。 + - **当前状态一句话**：远程仓库已迁至腾讯云 Gitea，双机开发就绪。Phase 3 知识库已完成。**看板升级子项目原型阶段收工**（2026-07-03），交付清单已写入寄存条，主项目可启动收视分析看板 React 前端实现。 - **下一个动手的人从这里开始**：见下方「⏩ 交接备注」 --- @@ -75,14 +75,15 @@ ## 3. 当前进度（动态，核心交接区 — 以最新快照为准） - **已完成至**：Phase 3 / Task 3（知识库树形视图·按来源两层分组，路线 B），含 Task 3.1、3.2，验收通过，最终 commit `3409d48`。 - - **正在做**：无。主干暂停，资源投入外迁子项目。 - - **卡点/待解**：下一刀方向未定（见「待办」）；其中 PDF 大文件存储架构需先与 Opus 讨论定方案再立项。 - - **Schema 状态**：知识库两表 schema 已就绪，**Phase 3 不再改表**。 + - **正在做**：无。看板升级子项目原型阶段已收工（2026-07-03），交付物就绪，可启动收视分析看板 React 前端实现。 + - **卡点/待解**：下一刀方向未定（见「待办」）——现在多了一个选项：收视分析看板前端实现（子项目已交付设计规范+原型）。 + - **Schema 状态**：知识库两表 schema 已就绪，**Phase 3 不再改表**。episodes 表已通过 003 迁移加 7 列 AI 标签字段（看板升级子项目 2026-06-26 执行）。 --- ## 4. 已完成（只追加，最新在上） + - [2026-07-03] 看板升级子项目原型阶段收工：L2 打标流水线就绪（GT v0.6.0 / 25 期 / 三个 Prompt 可用）+ L3 HTML 原型验证通过（双引擎象限图+5 模块+视觉定稿）+ 003 迁移已执行（episodes +7 AI 标签列）。交付清单见寄存条。 - [2026-05-27] Phase 3 Task 3/3.1/3.2：知识库树形视图（按来源大类→二级维度分组、左右布局、节点联动、展开收起；修出处筛选/宽度跳动/排版）。commit `3409d48`。 - [2026-05-27] Phase 3 Task 2：知识库管理后台最小版（上传/列表/删除）。 - [2026-05-27] Phase 3 Task 1：embedding 链路（入库即调 MiniMax embo-01 算 1536 维向量存 pgvector）。 @@ -94,7 +95,7 @@ ## 5. 待办（下一刀候选，开局前定先做哪件） - - [ ] **下一刀三选一**：① 语义搜索界面（不依赖任何材料，随时能开，是 Phase 4a 硬门槛）；② PDF 原文关联 + 大文件存储架构（需 Opus 审方案，优先级较高）；③ 导入真实收视 Excel + 清测试数据（Phase 4a 另一前置）。 + - [ ] **下一刀四选一**：① 语义搜索界面（不依赖任何材料，随时能开，是 Phase 4a 硬门槛）；② PDF 原文关联 + 大文件存储架构（需 Opus 审方案，优先级较高）；③ 导入真实收视 Excel + 清测试数据（Phase 4a 另一前置）；④ **收视分析看板 React 前端实现**（看板升级子项目已交付设计规范+HTML 原型，详见 `note/寄存条看板升级已外迁.md` 交付清单）。 - [ ] PDF 大文件存储：**大文件不入库，单独文件仓库，DB 只存地址指针**（md 正文+向量留库参与检索；pdf 仅按需调阅）。地基一次定对，避免上云返工。 - [ ] 200+ Obsidian md 批量录入（**建议在 PDF 存储方案定后做**；先试 10 篇验证解析/落位再全量，每篇都真调 MiniMax 耗额度）。 - [ ] 「按编导看稿」独立筛选视图（路线 A 重构时一并处理，从来源树里迁出来）。 @@ -125,7 +126,7 @@ ## 7. ⏩ 交接备注（换人/换账号 0 摩擦续上） - - **下一刀未定**，开工第一件事：与制片人确认三选一（语义搜索 / PDF 存储 / 真实收视导入）。PDF 存储须先和 Opus 讨论方案才立项。 + - **下一刀未定**，开工第一件事：与制片人确认四选一（语义搜索 / PDF 存储 / 真实收视导入 / **收视分析看板 React 前端**）。看板前端的设计规范+原型已由子项目交付（见 `note/寄存条看板升级已外迁.md` 交付清单 + `ai-labeling/CLAUDE.md` §1/§6/§7）。PDF 存储须先和 Opus 讨论方案才立项。 - **schema 红线**：Phase 3 不改知识库两表；`topics` / `topic_embeddings` 属 Phase 4a，**勿碰**；五类 `source_type` 枚举固定不增减，细分杂志/军报=改表=须 Opus 审。 - **`logs/` 是受保护资产**：Act 模式严禁 Cline 改；phase 日志由顾问协助生成。Task 3 三轮内容待并入 `phase3_log`（Task 3 段）。 - **避雷（Phase 3 实战教训）**： diff --git a/ai-labeling/CLAUDE.md b/ai-labeling/CLAUDE.md index ae40133..de37920 100644 --- a/ai-labeling/CLAUDE.md +++ b/ai-labeling/CLAUDE.md @@ -12,9 +12,9 @@ ## 🔖 状态栏（每次结束 session 前必须更新这三行） -- **最后更新**：Claude Opus（顾问）｜ 2026-07-01 -- **当前状态一句话**：L3 原型改版完成（双引擎象限图实现+视觉打磨+25 期全覆盖），GT v0.6.0（25 期 6 字段全覆盖），Prompt 3 v0.3（增"零门槛切口"强钩子路径）。制片人对看板原型阶段满意，下一步进 React 前端实现。 -- **下一个动手的人从这里开始**：见下方「⏩ 交接备注」 +- **最后更新**：Claude Opus（顾问）｜ 2026-07-03 +- **当前状态一句话**：**子项目原型阶段收工**。交付清单已写入寄存条（`note/寄存条看板升级已外迁.md`），主项目可启动 React 前端实现。L2 打标就绪、L3 原型验证通过、视觉/布局/设计 token 全部定稿。 +- **下一个动手的人从这里开始**：本子项目暂停，后续工作回到主项目。如需重开子项目（如 L4 诊断 Prompt 撰写、打标迭代），见下方「⏩ 交接备注」 --- diff --git a/docs/cross_project/看板升级分析/main/寄存条_看板升级已外迁.md b/docs/cross_project/看板升级分析/main/寄存条_看板升级已外迁.md index 0bfdc70..b7f85a7 100644 --- a/docs/cross_project/看板升级分析/main/寄存条_看板升级已外迁.md +++ b/docs/cross_project/看板升级分析/main/寄存条_看板升级已外迁.md @@ -56,6 +56,31 @@ --- +## 子项目阶段性收工交付清单（2026-07-03） + +子项目原型阶段收工，以下交付物已就绪，主项目可以启动 React 前端实现： + +### 已交付 + +1. **Schema 变更**：`backend/sql/003_add_ai_labels.sql` 已于 2026-06-26 在 milsci_dev 执行。episodes 表 +7 列 +3 索引。`schemas/episode.py` 留待 L3 API 时同步更新。 + +2. **AI 打标流水线**（沙盒自治完毕）：三个 Prompt 均达可用水平（分类 80% / 结构 85% / 钩子 90%），GT v0.6.0（25 期 6 字段全覆盖），生产模型 mimo-v2.5-pro。 + +3. **前端实施规范**（HTML 原型 + 设计 token + 视觉规范 + 页面布局）：详见 `ai-labeling/CLAUDE.md` §1.3（象限图视觉规格）、§6（关键决策/L3L4 页面设计决策）、§7（交接备注含完整实现细节）。原型文件 `ai-labeling/output/l3_report.html`（不入 git）。 + +4. **理论框架文档**：双引擎模型、6 字段枚举定义、三层分步交付策略——全部在 `ai-labeling/CLAUDE.md` §1。 + +### 未交付（暂不需要） + +- 回填脚本：等 React 前端 + API 就绪后再设计 +- L4 诊断报告 Prompt：等 L3 前端落地后再写 + +### 主项目 React 实现建议优先级 + +① 走势图 + 指标卡 → ② 题材/季度/编导对比 → ③ 双引擎象限图 → ④ L4 诊断报告 + +--- + ## 万一子项目记录丢了 降级方案: diff --git a/note/寄存条看板升级已外迁.md b/note/寄存条看板升级已外迁.md index f4cf470..08bc33d 100644 --- a/note/寄存条看板升级已外迁.md +++ b/note/寄存条看板升级已外迁.md @@ -57,6 +57,44 @@ ------ +## 子项目阶段性收工交付清单（2026-07-03） + +子项目原型阶段收工，以下交付物已就绪，主项目可以启动 React 前端实现： + +### 已交付 + +1. **Schema 变更**：`backend/sql/003_add_ai_labels.sql` 已于 2026-06-26 在 milsci_dev 执行。episodes 表 +7 列（program_format / equipment_domain / scene_tags / tech_tags / narrative_structure / opening_hook / ai_label_confidence）+3 索引。`schemas/episode.py` 留待 L3 API 时同步更新。 + +2. **AI 打标流水线**（沙盒自治完毕）： + - 三个 Prompt 均达可用水平：分类 80% / 结构 85% / 钩子 90% + - Ground-truth v0.6.0：25 期 6 字段全覆盖 + - 生产模型：mimo-v2.5-pro + - 脚本：`ai-labeling/scripts/run_labeling.py` + `summarize.py` + +3. **前端实施规范**（HTML 原型 + 设计 token + 视觉规范）： + - HTML 原型：`ai-labeling/output/l3_report.html`（不入 git，output/ 在 .gitignore，制片人本地有） + - 页面布局：指标卡 → 走势图(含 dataZoom) → AI 诊断报告(L4) → 双引擎象限图（招牌位）→ 左列(季度对比+编导对比) / 右列通高(题材对比) + - 视觉规范：磨砂玻璃卡片 + 大倒角 16px + max-width 1100px 居中 + 暖色渐变底 + 充足留白 + - 收视三色：红 `#c0584f` 优秀 / 蓝 `#5b8db8` 达标 / 绿 `#7aa874` 待提升 + - 题材色板：装备深解 `#5b8db8` / 历史纵深 `#e8a838` / 前沿科技 `#7aa874` / 横切类比 `#9b7eb8` / 人物牵引 `#d4816b` + - 范围选择器：方案 A（按自然年分页 + 年内 ECharts dataZoom 滑块，所有模块联动刷新） + - 2026 年收视目标：基础 0.6448，摸高 0.8989 + - 5 位编导：张彤枫/付天雨/孙逸昊/穆佩弦/左鑫 + - 象限图实现细节见 `ai-labeling/CLAUDE.md` §7 交接备注 + +4. **理论框架文档**：双引擎模型、6 字段枚举定义、三层分步交付策略、关键决策记录——全部在 `ai-labeling/CLAUDE.md` §1 和 §6。 + +### 未交付（暂不需要） + +- **回填脚本**：等 React 前端做好、API 就绪后再设计 +- **L4 诊断报告 Prompt**：等 L3 前端落地后再写 + +### 主项目 React 实现建议优先级 + +① 走势图 + 指标卡（纯数据，不依赖 AI 标签）→ ② 题材/季度/编导对比 → ③ 双引擎象限图 → ④ L4 诊断报告（LLM 调用） + +------ + ## 万一子项目记录丢了 降级方案: