用途：处理抖音公开视频链接抓取，并将结果回填到飞书 Base；默认使用未登录的公开访问方式，只有用户明确同意后才以已登录 Chrome 配置作为低频回退。适用于按表格批量跟踪抖音视频正文、点赞数与收藏数，以及需要视频画面内容解析或按规则自动评论的场景。
主要能力：从原始文本、Markdown 链接或 Base 单元格中提取规范 URL；抓取正文、点赞数（digg_count）、收藏数（collect_count）与抓取时间；对视频下载后用 ffmpeg 生成代表帧联系表，并可用 MiniMax mmx vision describe --region global 生成画面描述；在满足状态条件时通过已登录 CDP 浏览器自动发布评论并校验结果。
使用方式：一次性诊断可运行 python3 ~/.agents/skills/douyin-scraper/scripts/scrape-douyin.py --json < urls.txt；飞书 Base 批量处理使用 node ~/.agents/skills/douyin-scraper/scripts/process-lark-douyin.mjs 并传入 --base-token、--table-id、--view-id、--batch-size。回退登录时加 --browser-confirm 与 --chrome-user-data-dir。自动评论需在已登录 CDP 浏览器上使用 --cdp-url 'http://[::1]:9222' --cdp-only --new-tab --worker-tab-name codex-douyin-worker --comment。专用浏览器 CDP 端点为 http://[::1]:9222，user-data-dir 为 $HOME/Library/Application Support/Google/DouyinChrome，启动脚本为 ~/.agents/social-browser-profiles/launch-social-chrome.sh douyin。
状态规则：抓取状态为空白、准备抓取或保持抓取时才会处理；准备抓取成功会写入正文与互动字段并转为保持抓取，保持抓取仅刷新互动数与时间；确认失败写抓取异常。评论状态独立管理，仅在抓取状态=保持抓取、生成评论非空且评论状态为空白或准备评论时发布。
限制：不绕过验证码、付费墙、私密内容或访问控制；不导出 Cookie、令牌等敏感信息；遇验证码或账号风险须立即停止；登录回退批量保持 3-5 行，平台警告后暂停 24-48 小时。视频分析须用与当前 aweme_id 匹配的视频流地址，否则跳过分析仅写正文与互动值；未实际运行 ASR 时不得声称音频转写准确。