simonkoson
5.7 KiB
5.7 KiB
看板升级子项目 Brief
主项目 → 子项目的"交接宪法":红线、技术栈、出入口接口 起草日期:2026-06-12 状态:子项目立项时由主项目顾问(Opus)签发,子项目内部不修改
一、为什么做
痛点:制片人和编导团队拿到的"收视成绩单"只能看到结果(均值、走势、单期高低), 看不到结构性原因。每次复盘要靠人工拼诊断(21 期那次花了若干周),无法持续。
升级目标:把仪表盘从"看成绩"升级为"能分析"—— 让"双引擎模型(题材热度 × 叙事结构)"这个一次性人工产出的分析框架, 变成一台持续运转的诊断仪。
二、做什么(功能边界,只列名)
| 模块 | 简述 |
|---|---|
| 三层信息架构 | 纯算 / 打标后 / AI 起草,分层呈现 |
| 双引擎象限图 | 招牌视觉,题材热度 × 叙事结构 |
| AI 打标流水线 | Prompt 1/2/3 + MiniMax M3 + ground-truth |
| 编导能力地图 | 反排名,正反馈 |
| 本期诊断小结 | AI 起草 + 制片人审改后发布 |
| 时间选择器 | 实时脉搏 vs 周期复盘,边界永远可调 |
具体怎么做,子项目内部讨论,本 Brief 不预设方案。
三、怎么用(目标流程)
- 每周:制片人看"实时脉搏"——核心指标卡 + 近 9 期走势
- 每月:制片人看"题材分析"——题材汇总,关注异动
- 每季:制片人看"双引擎象限图 + 本期诊断小结"——周期复盘
- 新节目入库:AI 打标草稿 → staging 表 → 制片人审 → 落库
- 编导维度:制片人查能力地图,把强项做成全组可复用模板
- 离职编导:历史保留,面向当下视图可筛掉
四、不做什么(红线)
子项目设计任何方案,绝不触碰以下:
- ❌ 不做深色大屏(留给 2.0 数据大屏蓝本)
- ❌ 不做编导排名(团队视角走能力地图)
- ❌ AI 不自动盖章下结论(永远是"AI 出草稿,人拍板")
- ❌ 不引入新图表库(继续 ECharts / @ant-design/charts)
- ❌ 不引入主 project 没有的技术栈
- ❌ 不动主 project 已有的 schema(改字段必须走 §六交付协议)
- ❌ 不做"未审字段直接上看板"(置信度三档必须可辨)
- ❌ 不写 / 不改 AI 打标 Prompt 由 Cline 完成(Cline 是执行者不是作者)
五、技术栈约束(继承主 project)
子项目所有设计必须能落在以下栈上,不引入新依赖:
- 前端:React 18 + Vite + AntD 5 + Zustand + ECharts / @ant-design/charts
- 后端:FastAPI + SQLModel + PG 16 + pgvector
- 配色:米色底
#fbf9f1+ 深绿主色#6b8e6b - 三色色板:红
#c0584f/ 蓝#5b8db8/ 绿#7aa874 - 基准线:基础线 0.6448 / 摸高线 0.8989(2026)
- AI 打标:沙盒
ai-labeling/,生产模型 MiniMax M3,openai==1.55.0 锁版本 - 部署:腾讯云 4 核 8G(性能上限,凡是吃不动的方案直接否决)
六、交付什么(出口接口)
子项目产出最终要回到主 project 实施,交付物必须满足以下接口:
6.1 Schema 变更类
- 子项目出:字段定义文档(命名 / 类型 / 枚举 / nullable / 约束 / 回滚方案)
- 主 project 实施:Cline 切 Plan → Opus 审 → 制片人批准 Act →
pg_dump备份 → 跑迁移 - 不接受:子项目自己改主 project schema 或
backend/任何代码
6.2 前端实施类
- 子项目出:设计 token JSON + HTML mock + 视觉规范文档
- 主 project 实施:Cline 按设计稿落 React 组件
- 不接受:子项目自己写主 project 的 React 代码
6.3 AI 打标类
- 子项目在
ai-labeling/沙盒自治,沙盒内 Cline 可直接 Act - 子项目出:Prompt 文件 + ground-truth.json + 模型选型结论
- 主 project 实施:episodes_staging 表 schema 落库 + 审稿 UI 落地
6.4 回填类
- 子项目出:回填脚本设计文档 + 23 期回填策略
- 主 project 实施:Cline 跑脚本 + 制片人审 staging
6.5 通用约束
- 子项目不主动 push 文件到主 project,所有交付物由制片人决定时机
- 主 project 只接稳定版,子项目内部草稿不交付
七、入口接口(子项目要知道的主 project 现状)
- Phase 0-3 已落地:episodes / editors / 收视诊断基础数据,23 期 2026 年数据已入库
- 现有视觉语言:米色 + 深绿,卡片圆角 12px,AntD 5 默认行高
- 现有 backlog:主 project 这边的 backlog 已标注"看板升级条目已外迁"
- 现有沙盒:
ai-labeling/工作区已搭建,Prompt 2 v0.2 已锁,MiniMax M3 已选定 - 现有 git:Gitea 落库,关键 commit
38f3728
八、未决项(归子项目自己拍板)
以下不在本 Brief 内预设,由子项目和制片人讨论决定:
- 横轴量化方法的具体公式
- AI 打标 Prompt 1 / Prompt 3 的具体写法
- 看板各屏幕的具体布局和交互
- 双引擎象限图的具体视觉细节
- 能力地图的具体可视化方案
- episodes 新字段的最终命名 / 类型 / 是否多对多关联表
- 置信度是单字段还是分字段
- 时间窗口取多大 / 小样本怎么兜底等具体口径
九、决策史指向(不重复内容)
子项目讨论前应该读的:
续接快照_看板分析升级_设计讨论.md(v1,2026-06-09)续接快照_看板分析升级_设计讨论_v3.md(v3,2026-06-11 上午)续接快照_看板分析升级_设计讨论_v4.md(v4,2026-06-11 晚)军事科技栏目收视诊断分析_v2.xlsx(双引擎模型源数据)
十、本 Brief 自身的修订规则
- 本 Brief 不在子项目内修改
- 红线 / 技术栈如有变更,主 project 这边发新版,通过寄存条同步
- 子项目可在自己的 chat 里讨论"建议主 project 调整某条红线",但调整动作只能在主 project 发生