B站评论猎手（for Win）

要解决什么问题

做 B 站内容或竞品分析时，评论往往比播放量更能反映受众态度：热评、子楼争论、UP 主回复、IP 属地都会藏在嵌套结构里。网页端翻页既慢又难导出；若还要按 mid 统计核心粉、按 ctime 画反馈时间线，更需要一行一条、字段稳定的本地数据，而不是截图或手工复制。

本技能面向 Windows 环境，用 bbc 命令行把指定 BV 或整站 UP 主视频下的评论拉全，并落盘为可续抓、可二次分析的结构化文件。

如何工作

• bbc cookie-check：先确认 Cookie 是否有效（文件、$BBC_SESSDATA 或 --browser auto 的 DPAPI 解密），避免空跑。
• bbc fetch / bbc fetch-user：按页请求 B 站评论 API，支持 --dry-run 预演；重复执行会读 .bbc-state.json 断点续传，--force 可全量重抓。
• 输出约定：默认目录下 comments.jsonl（主评+子评已展开）、summary.json（元数据与 Top-N）、raw/ 存档；stdout 在非 TTY 下为稳定 JSON，stderr 为人类日志与进度。

分析侧建议先读体积较小的 summary.json 建立全局，再对 comments.jsonl 用 grep/分批扫描做情感、关键词、is_up_reply、 ip_location 等方向，避免一次性全量载入大文件。

边界与注意

• 只读采集：不发评、删评、不下视频/弹幕/直播/私信。
• 认证：不跑 OAuth，需在浏览器登录后自行提供 Cookie；自动读浏览器 Cookie 依赖本机已登录且已写入磁盘。
• 完整性：以 API 的 all_count（含置顶）做校验；老评论在发布者注销后可能稀疏；过大 --max 或频繁重跑可能触发 HTTP 412，客户端会间隔等待并退避。