直播短视频运营总监 · 诊断台
Overview
本 skill 提供一套本地优先、零接口费的「直播/短视频运营总监诊断台」方法论与可运行核心。
它把"运营一个账号到底看什么、为什么看、看完怎么改"系统化，落地为确定性规则引擎
（基线评级 + 波动归因 + 多维聚合）+ 可选 LLM 叙述层。
两类用法（均免费、零接口费）：
- 对话式诊断——不部署工具，直接套用本 skill 的方法论，对用户给定的后台数据出诊断/方案/报告。
- 构建部署工具——用
scripts/build_ops_director.py把核心引擎 + 极简前端 scaffold 成可运行的本地诊断台。
设计原则（延续用户偏好）：后端零依赖 Python（http.server + sqlite3），前端单文件 HTML，
全部数据存本机、不上云、不出网。
> 增值说明：本 skill 另预留「付费云端诊断」扩展位（详见工作流 C），需在 skillhub.cn 完善计费、并另行部署
> 公网 HTTPS 云端诊断服务并接入支付宝 AI 按量付费后才生效；本体的免费能力（对话诊断 + 本地工具）不受影响。
When to use
- 用户要搭/部署一个直播或短视频运营分析工具（本地、低成本、账号隔离）。
- 用户给了快手/抖音后台导出数据（PDF/Excel/截图/录屏/手填），要自动诊断。
- 用户要生成运营诊断报告、做单场复盘 / 跨场对比 / 团队横评 / 短视频内容矩阵。
- 用户要解释"为什么这个时段掉人"，要求内容时间线 × 指标归因。
- 用户要录屏自动转写文案或截图自动识别填表。
核心方法论（五维分析框架）
运营一个账号必须同时管五条线，每条线回答一组问题。详见 references/运营分析逻辑框架_v1.md。
| 维度 | 回答的问题 | 核心指标 |
|---|---|---|
| 内容线 | 主题结构合不合理、哪段留人哪段讲跑、话术节奏配比 | 内容时间线、掉人段对应内容 |
| 流量线 | 流量自然还是投放、在线异常波动、短视频导流贡献 | 在线人数、有效观看、观看次数、引流占比 |
| 互动线 | 观众是看客还是参与者、高光互动时刻 | 赞播比、评论率、分享率、评论爆发点 |
| 转化线 | 涨粉/粉丝团/带货结果、漏斗漏点 | 涨粉率、粉丝团转化率、GPM、点击率、成交率 |
| 用户线 | 观众画像与内容是否适配、高价值用户是谁 | 性别/年龄/地域分布、粉丝占比、送礼人群 |
内容时间线是整套分析的发动机：把"这个时段讲了什么"结构化，叠加上台后台指标，
才能做"掉人段 ↔ 内容"因果归因，给出可执行建议（否则只能说"18:30 掉人了"，说不出为什么）。
指标基线（经验初值，可被进化机制按账号/品类修正）
直播率指标基线见 references/核心引擎导读.md 与 core/schema.py：
- 常规场：
赞播比 good≥3%/ok≥1%、评论率 good≥1%/ok≥0.3%、分享率 good≥0.5%/ok≥0.2%、
粉丝团转化率 good≥2%/ok≥0.5%。 - 带货场：核心看
商品点击率 good≥10%、商品成交率 good≥8%、GPM good≥1000/ok≥300。 - 短视频：
完播率 good≥30%、有效播放率 good≥60%、封面点击率 good≥8%、点赞率 good≥5%、
评论率 good≥1%、分享率 good≥0.5%。 - 波动检测：在线较近期峰值回落
≥15%判为掉人；某分钟互动增量≥均值2倍判为互动爆发。
评级映射：good=100 / ok=60 / bad=20，综合分取各率均值。
分析流水线（确定性、零依赖）
① 归一(normalize) 多源(PDF/Excel/截图/录屏/手填) → 统一字段字典（core/ingest.py）
② 算率(derive) 按分母优先级(观看次数→有效观看人数)加权平均算各率（core/query.py）
③ 评级(grade) 套基线阈值得到 good/ok/bad 与分数（core/analysis.py + core/schema.py）
④ 多维归因(attribute) 直播秒级波动 × 内容时间线/话术 对齐，标出掉人段对应内容（core/attribution.py）
⑤ 聚合(report) 单场/多场/多主播 KPI、按主播/日期分组、趋势、观众画像、短视频矩阵（core/query.py + cross_analysis.py）
LLM 叙述层（core/analysis.py:LLMNarrator）可插拔：优先本地 Ollama，其次云端 API，
均无则降级为规则模板——核心诊断不依赖大模型即可出。
工作流 A：引导式互动诊断（推荐，不部署工具）
本工作流强调分步提问、给选项、避免一次性大表单。每步只问一件事，用选项降低用户负担；信息不足时先用已有数据出初步结论，再提示缺什么。
第 1 步 · 确认场景与平台（二选一即可，不必全问）
- "你要诊断的是【快手 / 抖音】账号？是常规直播、带货直播、还是短视频？"
- 若用户已给数据，从表头/字段自动判断平台（快手/抖音列名映射见 core/schema.py:PLATFORM_COLMAP），只向用户确认把握不准的项。
第 2 步 · 确认手头数据
- "你方便提供哪种数据？可多选：①后台 PDF 报告 ②Excel 汇总表 ③后台截图 ④直播录屏 ⑤手填指标文字。"
- 据此决定走哪条录入路径（对应 references/功能与页面架构设计_v1.md 四表单）；若只有文字指标，直接进入第 4 步手动算率。
第 3 步 · 确认分析目标（给方向让用户选，避免跑偏）
- "这次最想搞清楚哪类问题？"
1. 在线趋势归因（哪段掉人、为什么）
2. 互动质量（赞播比/评论率/评论爆发点）
3. 转化漏斗（带货点击率/成交率/GPM）
4. 短视频内容矩阵（哪种类型完播最好）
5. 跨场/跨周期对比（成长曲线）
6. 观众画像与粉丝健康
7. 自定义（指定指标+时段+内容标签）
第 4 步 · 关键追问（决定归因深度）
- "这场有没有『内容时间线』——也就是每个时段讲了什么（干货/案例/互动/上链接/抽奖）？"
- 有 → 做"掉人段 ↔ 内容"对齐，输出因果归因与话术建议；
- 没有 → 先出指标级诊断，并提示："补一段内容时间线就能定位掉人原因，下次直播中/后按时间填即可"。
第 5 步 · 归一→算率→评级→归因→出报告
1. 按 references/运营分析逻辑框架_v1.md 字段表归一，识别维度；
2. 套基线算率评级（或直接复用 scripts/core 的 analysis.score_live_rates / query._kpi）；
3. 按所选方向做归因；
4. 输出结构化诊断报告（见下方"输出规范"），并给"下场复盘对照表"建议。
> 全程用中文、给选项；不在一步里同时问超过 2 个问题；用户只给片段数据时，先出能出的部分，再列"还差什么"。
工作流 B：构建 / 部署本地工具
运行构建脚本（需要本机 Python 3.11+）：
python scripts/build_ops_director.py （目标目录）
# 例：python scripts/build_ops_director.py ./ops-director-dist
脚本会生成完整可运行工具：core/（核心引擎，复制自 scripts/core）、web/app.html、
app.py（零依赖 HTTP 服务）、run.py、start.bat、requirements-core.txt、部署说明.txt。
启动与访问：
cd （目标目录）
python install_env.py # 可选：装依赖(openpyxl 等)，缺依赖时 OCR/转写降级但不崩
python run.py # 自动开浏览器 → http://127.0.0.1:8520/app.html
依赖与降级（详见 references/部署说明.txt）：
- 核心（openpyxl）装好即可跑录入/对比/分析；
- 缺 ffmpeg/faster-whisper → 录屏转写不可用；缺 PaddleOCR → 截图识别不可用；二者都缺核心链路正常。
- 分析引擎为纯标准库，永不依赖这些重依赖。
工作流 C：付费云端诊断（增值扩展位，需另行部署）
> 本 skill 的免费能力（工作流 A 方法论 + 工作流 B 本地工具）保持不变、零接口费。
> 下面的付费流程是增值云端服务：把"诊断报告生成"放到云端按次收费，适合不想自己跑本地工具、只想一句话拿到报告的买家。
> 前提：卖家需自行部署公网 HTTPS 云端诊断服务并接入支付宝 AI 按量付费（详见 references/部署说明.txt，源码不随本包发布）。
配置（环境变量，绝不写死密钥）
OPS_DIRECTOR_API_URL—— 云端诊断服务公网地址（必填，HTTPS）。OPS_DIRECTOR_API_METHOD—— 请求方式，默认 POST。OPS_DIRECTOR_API_KEY—— 可选，服务端简单鉴权头。
单次价格
- 价格由卖家在 skillhub.cn「完善计费」时填写，须与支付宝服务登记价、平台展示价三者一致（区间 0.01～50 元/次）。
调用流程（三步）
# 1) 探针：发起诊断请求，未付款会得到 402 账单
node scripts/ops-director-paid.mjs probe --data 诊断请求.json
# （诊断请求.json 含归一指标 + 内容时间线 + 分析目标；无文件可用 --text "帮我诊断昨天这场直播"）
# 2) 支付：把账单交给官方 alipay-bot，弹出二维码扫码付款
node scripts/ops-director-paid.mjs pay --session-id <上一步返回的会话ID>
# 3) 完结：付款后查询原订单并拉取诊断报告
node scripts/ops-director-paid.mjs complete --session-id <会话ID> [--out-shake-no <订单号>]
说明
- 未付款时云端返回 HTTP 402 与
Payment-Needed头；付款后携凭证重试，服务端验付后返回报告，并自动完成商家履约确认。 - 同一订单重试不会重复扣费（服务端须保证幂等）。
- 本脚本只编排、不碰支付密钥、不自行实现支付；支付由官方
alipay-bot完成。 - Skill 包内不含密钥、.env、状态文件、node_modules。
输出规范（诊断报告结构）
- 核心结论：总体评分 + 一句话定调（常规场看互动留存 / 带货场看货品转化）。
- 问题清单：掉人段（含最大回落 % 与对应事件）、互动短板（bad 级率指标）、违规风险、投放 ROI。
- 内容归因：掉人段 ↔ 讲了什么 ↔ 建议（调话术/节奏/福利）。
- 改进方向：达标动作固化为 SOP，未达标项列入下场复盘对照表。
- 跨场/团队：按主播拆解 KPI、按日期趋势、短视频内容矩阵（最佳/最弱类型）。
资源索引
scripts/core/— 可复用分析引擎（schema/analysis/query/ingest/attribution/cross_analysis/report/advisor/store/db_accounts/io_csv/io_xlsx/ocr_img/ocr_pdf/media_asr/video/sample_store/backup/env_check/experience）。scripts/build_ops_director.py— 一键 scaffold 可运行工具。scripts/ops-director-paid.mjs— 付费云端诊断调用脚本（需卖家另部署云端服务）。references/运营分析逻辑框架_v1.md— 五维框架与指标"为什么分析"。references/功能与页面架构设计_v1.md— 账号隔离、四表单录入、对比分析、截图识别、视频转写架构。references/核心引擎导读.md— 各引擎模块职责 + 关键基线/阈值速查。references/直播运营数据分析培训手册.html/直播短视频运营数据分析逻辑清单.html— 培训与清单。references/部署说明.txt— 安装/启动/离线打包/常见问题。
