| name | self-media-uper |
| description | 当用户要把素材目录里的视频批量投稿/发布到 B站、抖音、小红书、快手、视频号时使用本 skill。
触发示例：「投稿」「发B站/发抖音/发小红书」「继续投10个」「投稿进度怎么样」「从第11个开始投」。
本 skill 调用 smu CLI 完成扫描、对账、批量投稿；标题/封面/文案/标签全部取自素材文件夹，
各项目的标题前缀/话题/固定标签由素材目录下的 smu.json 提供（skill 不写死任何项目配置）。
不应触发：制作视频/封面/文案（上游生产环节）、查询平台数据。
|
self-media-uper：素材目录批量投稿
工具：smu（已在 PATH）。状态记录在 ~/.self-media-uper/state.json，按「平台 + 素材文件夹名」防重复投稿。
支持平台：B站（biliup，API）、抖音/小红书/快手/视频号（social-auto-upload，隐身浏览器）。
平台用 --platform 指定，默认 bilibili。视频号平台名是 shipinhao（smu 内映射为 sau 的 tencent）。
第一步：确认素材目录（必须）
永远先和用户确认素材目录，不要猜、不要用历史目录直接开干。
- 用户没给目录 → 询问「这次投哪个素材目录？」，可列出候选帮用户选。
- 用户给了模糊名称 → 找到匹配目录后复述完整路径让用户确认。
- 目录确认后先跑
smu scan <目录> 检查素材完整性（缺封面/文案有 ⚠️，宽容识别依据用 ↳ 标注）。
目录不规范时：协商，不要硬投
scan 出现较多 ⚠️/↳、或扫出 0 个素材时，不要直接 upload：
- 把问题归类汇总报给用户（缺件、识别歧义、平铺未分夹），附目录约定要点。
- 确认处理方式：(a) 用户补齐/改名；(b) 你代为整理（动文件前列改名清单让用户确认）；
(c) 接受降级 → upload 加
--allow-incomplete。
- upload 的预检会把缺关键件的素材整批拦下，这是兜底，不要当日常流程。
第二步：检查登录态 + 对账
在投稿前，先检查各平台 cookie 文件是否存在：
ls ~/.self-media-uper/bilibili.cookies.json
ls ~/.self-media-uper/engines/social-auto-upload/cookies/douyin_*.json
ls ~/.self-media-uper/engines/social-auto-upload/cookies/xiaohongshu_*.json
ls ~/.self-media-uper/engines/social-auto-upload/cookies/kuaishou_*.json
ls ~/.self-media-uper/engines/social-auto-upload/cookies/tencent_*.json
cookie 文件存在 ≠ cookie 有效（尤其是视频号，经常文件在但会话失效）。
smu sync <目录>
smu status <目录> --platform <平台>
第三步：投稿（公开发布前必须向用户确认）
smu upload <目录> 11-20
smu upload <目录> --all
smu upload <目录> 11 --platform douyin --account <号> \
--schedule "2026-06-13 12:00"
smu upload <目录> 11 --dry-run
规则：
- 公开投稿是对外发布，执行前必须把「平台 + 数量 + 起止序号」报给用户确认；
用户已明确说了数量/范围则直接执行。
- 间隔是随机的、按平台自动：B站 30
90 秒；抖音/小红书/视频号/快手 512 分钟（防规律节奏被风控）。
- 单日上限：B站不超 20 条；抖音/小红书/视频号/快手更严，不超 10 条，用户要更多时提醒分天投。
- 用户说"先投10个看看效果"是合理的首日策略，不要试图一次全投完。
- 已投稿自动跳过；用户明确要求重投才用
--force。
- 失败的素材列出原因、问用户是否重试，不要无限自动重试。
- 不要替用户删除任何稿件。
多平台并行策略
B站走 API（无浏览器），可与其他平台并行。抖音/小红书/视频号/快手都走隐身浏览器：
- 可以并行：B站 + 任一浏览器平台同时跑，不冲突。
- 多个浏览器平台并行：抖音、小红书、视频号可以同时跑（各自独立浏览器实例），实测可行。但视频号不稳定时建议单跑。
- 总耗时估算：浏览器平台每条 5-12 分钟间隔，10 条约 50-120 分钟。并行三个平台也在同一时间窗口内完成。
第四步：汇报
报告：成功 N 个（B站列 BV 号）、失败 M 个（列原因）、进度（已投/总数）、下一个待投序号。
抖音/小红书注意（真实账号浏览器操作，风控更严）
- 登录：
smu login --platform douyin --account <号>（真终端扫码，不能用 agent 的 shell）。
- 强烈建议小号试水、定时发布、低频，先养几天确认账号稳再放量。
- 封面按真实比例自动检测选图（竖 3:4 + 横 4:3），缺合规封面会提示。
- 抖音自主声明默认选「内容由AI生成」（
--no-ai-statement 可关）。
- 发布后提醒用户去创作中心核对：封面横竖、定时时间、声明是否符合预期。
视频号特有坑点（shipinhao / tencent）
视频号是目前最不稳定的平台，以下问题反复出现：
Cookie 假有效
- cookie 文件存在不代表会话有效。经常出现"文件在但浏览器打开后仍需扫码"的情况。
- 表现：进程启动后长时间（5 分钟+）零输出，大概率是卡在登录页等扫码。
- 对策：视频号发布时，建议用户在自己的终端跑命令，能直接看到浏览器窗口、随时扫码。agent 看不到 GUI，卡住了只能盲杀。
封面弹窗 bug
- 视频号发布页的封面设置弹窗（
编辑封面 / 裁剪封面图）经常处于 hidden 状态。
- Patchright 的
wait_for(visible) 会持续超时（每次 ~15 秒），但通常最终能降级通过：
4:3 横版封面设置失败，这次先跳过 → 竖版封面仍能设上，视频可以发出。封面裁剪确认时出错 → 如果卡在此处超过 2 分钟不动，进程大概率已死，杀掉重试。
- 重试建议：杀掉卡死进程 →
smu mark <目录> <已发序号> --platform shipinhao 标记已发的 → 从下一个序号继续。
活动下拉菜单
- 视频号发布页有一个活动/事件选择下拉框，可用于选择法考相关活动提高曝光。
- 当前版本的 sau tencent uploader 不支持选择活动，视频只能裸发。
- 如需要选活动，目前只能手动在视频号创作中心操作。
建议运行方式
- 先在其他三个平台跑通后，视频号单独跑。
- 用户在自己的终端执行（能看到浏览器 GUI，随时扫码/手动干预）。
- 如 agent 盲跑：监控前 2 分钟是否有输出，无输出则可能卡登录，果断杀掉通知用户。
- 卡封面弹窗超过 3 分钟无新日志 → 杀掉，mark 已发，从下一条继续。
数据与运营分析（数据中心 / 最佳时间 / 周报）
采集每条已发视频的播放/赞/评论/分享/收藏，存本地时间序列，由你（agent）做分析。
smu stats pull --platform douyin --account <号>
smu stats pull --platform bilibili
smu stats show --platform douyin --top 10
数据落在 ~/.self-media-uper/stats/<平台>.jsonl，每行一条快照记录：
{platform, account, fetched_at, video_id, title, published_at(unix秒), play, like, comment, share, collect}。
同一视频多次 pull = 多条不同 fetched_at 的记录（时间序列）。
用户要趋势/最佳时间/周报时，你直接 Read 这个 jsonl 自己算，不要硬塞给某个内置功能：
- 趋势：同一 video_id 按 fetched_at 排序看播放增长；或按 fetched_at 汇总账号总播放。
- 最佳发布时间：把每条 published_at 转成「星期几 + 小时」，对播放量分组求平均，找高产时段。
- 周报：取近 7 天数据，算总播放/互动、增长、Top 视频、最佳时段，写成报告。
- 发布前检查：你本来就能审标题/标签/钩子；结合上面采集到的历史数据更有据。
（已支持采集：抖音、B站、小红书、视频号。小红书/视频号走 patchright 拦截创作中心已签名响应，采集时会短暂弹窗。）
登录态问题
报「未登录」→ 让用户在自己的终端（需要扫码）运行 smu login [--platform 平台 --account 号]。
B站 cookie 过期 → smu renew 可直接代跑。
视频号 cookie 经常假有效 → 参考上文「视频号特有坑点」一节。
批量换号 / 重置 cookie
如需更换所有平台的账号（从测试号切到大号）：
rm ~/.self-media-uper/bilibili.cookies.json
rm ~/.self-media-uper/engines/social-auto-upload/cookies/*.json
smu login --platform bilibili
smu login --platform douyin --account main
smu login --platform xiaohongshu --account main
smu login --platform kuaishou --account main
smu login --platform shipinhao --account main
项目配置（不在 skill 里写死）
标题前缀、参与话题、固定标签、分区等因项目而异，放在素材目录下的 smu.json，例如：
{ "title_prefix": "【某系列（某科目）】", "topic": "某话题", "ensure_tags": ["标签A", "标签B"] }
skill 不假设任何具体项目的配置；换项目/科目只改对应素材目录的 smu.json，或用 --title-prefix 等参数临时覆盖。
