内容猫抓

解决的问题

手工拆解小红书或抖音视频选题时，工程师或运营通常要在浏览器、转写工具、笔记和表格之间反复切换：找视频直链、导出音轨、跑 Whisper、整理观点，再把结果贴进飞书。这个过程重复且容易断在「拿不到可下载流」或「逐字稿是假的」这类环节。

核心能力

• 浏览器端抓取：Chrome/Edge 扩展在页面右下角提供 🐱 按钮，点击后触发当前视频页的内容抓取。v1.2.0 通过 run_at: document_start、MAIN world 注入、chrome.storage.session 保存地址，并尝试从页面数据（如小红书 __INITIAL_STATE__ 的 masterUrl）解析直链。
• 本地语音转写：后端使用 faster-whisper 把视频流转成逐字稿；v1.1.0 起默认 small 模型，配合 beam_size=5、VAD 静音裁剪和中文提示词提升准确率。
• 选题拆解与表格输出：逐字稿交给 DeepSeek 做结构化拆解；未配置 API Key 时自动降级为本地启发式逻辑。结果写入三 Sheet Excel，包含原始逐字稿、选题拆解和相关运行信息。
• 飞书推送：配置 lark-cli 与群 chat_id 后，Excel 会发送到飞书群；未配置则只落在 runtime/outputs/。

关键步骤

1. 首次运行 scripts/setup.sh：脚本创建 Python 虚拟环境、安装依赖、生成 runtime/config.json，并检测 lark-cli。
2. 按需填写凭据：要 DeepSeek 拆解则填 Key；要飞书投递则先 lark-cli auth login，再填 receive_id/群 chat_id。
3. 启动后端：运行 scripts/start_server.sh，脚本会先清理旧进程再拉起服务。
4. 手动加载扩展：在 chrome://extensions 开启开发者模式，选择 runtime/extension/ 目录；进入小红书/抖音视频页后点击右下角 🐱。

适用边界与注意点

• 只面向小红书/抖音视频页；🐱 不出现时先确认扩展已加载、当前域名正确，SPA 页面需要 Cmd/Ctrl+R 刷新，改过代码要在扩展页点 ↻。
• Failed to fetch 通常表示后端未启动；服务日志中出现「transcribing 语音转写」才算真实转写，出现「未拿到可下载视频流」则是文案兜底。
• api_key/receive_id 含 填入、你的、sk-你的 等字样会被判定未填写并自动降级；修改 config.json 或 server.py 后需要重启服务。
• 扩展只能手动加载，包内不提供自动安装浏览器插件的能力。