social-auto-upload/docs/dayu.md

大鱼号视频发布使用说明

当前支持登录、检查账号、立即或定时发布视频和查询发布结果；尚未接入 Web 界面。文章和富文本正文文件发布见 大鱼号图文发布，Agent 使用见 大鱼号 Skill。

首次使用

先按 CLI 安装说明 安装项目，在项目根目录执行命令。Windows 中若找不到 sau，可使用 .\.venv\Scripts\sau.exe。

sau dayu login --account creator --expected-name "你的大鱼号名称"
sau dayu check --account creator

登录时会打开 Chrome，请在网页中完成登录。creator 是你给这个账号起的本地名称，后续发布使用相同名称。检查返回 valid 表示账号可用；返回 invalid 时重新登录。

发布前准备

必填内容	命令参数	要求
账号	--account	已登录的本地账号名称
视频文件	--file	本机文件路径；至少 5 秒，横屏建议 15 秒以上
视频标题	--title	5–60 字，英文字符按半字计数
视频分类	--category	从下列 43 个分类中选择一项
视频封面	--thumbnail	与视频相关的图片路径，最大 5 MB；jpg、jpeg、png、gif 或 bmp
信息来源	--source	按实际内容选择下列来源之一

横屏视频最大 10 GB；竖屏视频最大 5 GB、时长不超过 30 分钟。支持的文件扩展名为：3gp、avi、flv、mp4、m3u8、mpg、asf、wmv、mkv、mov、ts、webm、mts，文件须能在本地正常解码。大小边界最终以平台检查为准。当前已完成横屏视频的真实发布验证；竖屏视频尚未完成真实发布验证。

视频分类（2026-10-17 当前账号页面，共 43 项）：

其他、社会、国内、国际、体育、科技、娱乐、军事、财经、汽车、房产、时尚、健康、两性情感、游戏、动漫、旅游、美食、历史、奇闻、科学探索、星座、育儿、教育、美女、搞笑、演讲、萌娃、萌宠、音乐、语言类、记录短片、涨姿势、劲爆体育、幽默、综艺、电视剧、电影、纪录片、少儿、文化、三农、生活方式。

信息来源：

页面选项	当前命令支持情况
无需标注	支持；已完成真实发布验证
AI生成	支持
虚构演绎	支持填写；尚未单独进行真实发布验证
营销信息	支持填写；尚未单独进行真实发布验证
转载	支持填写；必须同时提供 --source-url "https://原文地址"，尚未单独进行真实发布验证
个人观点	支持填写；尚未单独进行真实发布验证
不适宜未成年人	支持填写；尚未单独进行真实发布验证

选择“转载”时，原文链接为条件必填项；其他来源无需提供原文链接。

立即发布

下面的命令会实际发表视频；平台确认发表后即返回成功，不等待审核：

sau dayu upload-video --account creator --file "D:\素材\视频.mp4" --title "这是大鱼号视频标题" --category "科技" --source "无需标注" --thumbnail "D:\素材\封面.jpg"

需要简介或标签时增加以下参数：

--desc "视频简介，最多200字" --tags "标签一,标签二"

标签用英文逗号分隔，每个标签最多 10 字。

定时发布

在发布命令中增加 --schedule "YYYY-MM-DD HH:MM"。时间固定按**北京时间（Asia/Shanghai，UTC+8）**解释，不受运行电脑时区影响；须在当前时间 2 小时后至 7 天内，分钟为 5 的倍数，例如 10:30 或 10:35。程序不会自动取整或改成立即发布。请留足上传和处理时间，填表时仍须处于允许范围内。

sau dayu upload-video --account creator --file "D:\素材\视频.mp4" --title "这是大鱼号视频标题" --category "科技" --source "无需标注" --thumbnail "D:\素材\封面.jpg" --schedule "2027-01-01 10:30"

示例日期需替换成实际范围内的时间。省略 --schedule 默认立即发布。平台确认原作品及定时时间后返回成功，表示定时安排已提交，不等待到点或审核。平台审核若延长，实际公开时间可能晚于预定时间。

页面还有哪些功能

下表按本次登录账号的短视频发布页整理。平台可能根据账号或素材展示不同功能。

页面功能	是否必填	当前命令支持情况
视频简介	选填	支持，使用 --desc
视频标签	选填	支持，使用 --tags
竖版封面	选填	尚未支持
定时发布	选填	支持，使用 --schedule；北京时间 2 小时后至 7 天内，5 分钟一档
从素材库选择视频	可选素材来源	尚未支持；当前命令使用本机文件
网页预览	可选操作	发布过程中会进入预览并确认；尚未提供独立预览命令
保存草稿、清空编辑内容	可选操作	尚未提供对应命令

查看结果

命令提示“发表成功”后，表示平台已确认本次发表，结果中会返回作品 ID。不等待审核通过或公开播放，审核结果不影响本次发表操作的成功判定。

默认等待上传和处理最多 10 分钟，可增加 --upload-timeout 1200，单位为秒。

如果命令因断线等原因未能确认发表结果，请使用日志中给出的结果文件查询原作品，避免重复发表：

sau dayu verify --account creator --result "cookies/dayu_results/本次结果文件.json"

该命令只读查询；找到已提交的原作品即成功，仍在审核中也会返回成功。定时作品还会核对结果文件中的预定时间，确认待发布安排即成功。若日志提示没有可查询的作品信息，请到大鱼号后台检查本次作品。

需要额外检查公开视频播放时，可主动增加 --public，使用 --timeout 设置等待秒数：

sau dayu verify --account creator --result "cookies/dayu_results/本次结果文件.json" --public --timeout 900

公开检查可能需要等待审核。它是独立检查，不是发表命令的成功条件。

其他命令选项

选项	用途
--headed	显示发布时的 Chrome 窗口
--prepare-only	上传素材、填写表单并保存本地截图，随后结束；用于检查发布前内容，未发表，也未保存网页草稿
--debug	出错时保存页面截图，便于排查

完整参数帮助：sau dayu upload-video --help。