kiakun-collab B站视频决策助手
你（Claude）是总结者，脚本只负责取素材。 脚本以最低成本拿全原始文本素材 + 预算好的统计信号， 输出一份 ≤15KB 的固定量级 JSON；你据此写出帮助用户快速判断长视频价值的报告。
Start Here
python scripts/bilibili_digest.py "<B站链接 / BV号 / AV号>"
- 常用开关：
--page N（分P，默认1）、--transcript full|head|none（字幕正文，默认full，超8000字自动截头部）、--skip-comments、--skip-uploader、--no-cache。 - 无 CC 字幕时用 Whisper 兜底：
python scripts/bilibili_whisper.py "<链接>" [--sample --peaks peaks.json] [--whisper-model small]（需系统 ffmpeg）。 - 脚本自带 24h 本地缓存（
~/.cache/bilibili-summary/）与限速；stdout 是 UTF-8 JSON，进度走 stderr。
输出 JSON 契约（字段即事实源）
{
"ok": true, "error": null, // ok=false 时仅含 error{code,message}
"video": { "bvid","aid","title","desc","duration_sec","pubdate","tname","pages_total","current_page","url","tags" },
"uploader": { "uid","name" },
"uploader_profile": { "sign","official","followers","recent_videos":[{title,play,pubdate}] }, // 可能为 null
"uploader_profile_error": null, // 画像抓取失败时的原因串（区分"UP无数据"与"接口失败/wbi风控"）
"stats": { "view","like","coin","favorite","reply","danmaku","share" },
"value_signals": { "like_rate","fav_rate","coin_rate","danmaku_per_min","reply_rate","hint" },
"transcript": { "source":"subtitle|whisper|ai_conclusion_fallback|none", "subtitle_type":"cc|ai|null",
"text":"...", "truncated":false, "segments_sample":[{t,text}] },
"auxiliary": { "ai_conclusion": { "available","source":"bilibili_official_ai","outline":[{title,timestamp}],"summary" } },
"danmaku_analysis": { "total","top_words":[{word,count}],"density_buckets":[],"bucket_sec",
"peaks":[{t_sec,count,samples:[]}],"pbp_available" },
"hot_comments": [{ "rpid","user","text","likes","reply_count","is_pinned","up_replied","sub_replies":[{user,text,likes}] }],
"meta": { "fetched_at","cache_hit","requests_made","elapsed_sec" }
}
素材优先级：transcript.source 标注本次内容来源。subtitle/whisper 是主内容源；ai_conclusion_fallback
仅在字幕与转写都拿不到时降级采用（B站自研小模型，质量低于你对全文的总结，用时必须注明来源）。
AI 小结永远只是 auxiliary 辅助信号（分段章节可作结构锚点）。
报告生成指令（决策导向）
依据 JSON 产出以下结构（无对应数据的小节注明"数据不足"，不要编造）：
① 一句话结论：值得完整看 / 看高能点即可 / 看本总结即可 / 不值得看（结合 value_signals 与内容判断）。
② 内容摘要 + 分段大纲：基于 transcript.text（注明素材来源：字幕/转写/AI小结降级）；有 auxiliary.ai_conclusion.outline 时用其时间戳作章节锚点。
③ 高能点时间轴：danmaku_analysis.peaks 的 t_sec + samples 代表弹幕 + 对应内容段落；pbp_available 为 true 时说明与官方高能进度条互相印证。
④ 评论区共识与争议：对 hot_comments 做观点聚类；用 sub_replies（楼中楼）摘要争议交锋；区分"对内容的评价"与"对UP主的评价"，输出共识观点、少数派观点、风评倾向。
⑤ UP主风评（有 uploader_profile 时）：画像（粉丝量、认证、近期作品）+ 本视频舆论倾向。
⑥ 价值信号：列 value_signals 各互动率 + hint 判断依据。
错误处理指引
ok=false 时按 error.code 应对，不要重试到风控：
not_found：BV/AV 号可能有误或视频不可见，请用户核对。auth：需要登录态（字幕/部分接口）——提示配置cookies.json（sessdata/bili_jct/buvid3）；可继续用无需登录的字段。rate_limited（-352/-412）：触发风控，稍后再试，不要连续重试。network：网络问题，检查连接后重试。unknown：附原始 message 供排查。
配置与合规
- Cookie 仅本地读取，优先 skill 目录
cookies.json，其次~/.hermes/skills/openclaw-imports/bilibili-summary/cookies.json。不要泄露 SESSDATA/BILI_JCT。 - 保持脚本内置限速，不做任何绕过登录/风控的行为。
- 依赖：
pip install -e .（或bilibili-api-python aiohttp）；Whisper 兜底另需pip install faster-whisper+ 系统 ffmpeg。