用途:在 Instagram 独立网页环境中,通过 sau CLI 完成账号登录检查、立即发布 Reels、单图或轮播,并对指定原作品进行核验或移至最近删除。不自行实现浏览器上传,而是调用现有 CLI,使用工程 Patchright Chrome 和独立 Instagram 会话,不使用 Business Suite 的绑定入口。
主要能力:
- 登录与检查:sau instagram login --account creator;sau instagram check --account creator。账号 cookie 保存为 cookies/instagram_creator.json,密码和验证由用户在工程浏览器中输入。
- 视频/Reel 上传:upload-video 支持 --file 视频、--thumbnail 封面、--title、--desc、--tags 与 --result。视频支持 MP4/MOV;封面支持 JPG/JPEG/PNG,省略时使用 Instagram 默认封面。指定封面后会检查主预览是否确实使用该图片,失败则停止提交;封面按当前视频画幅居中裁剪。
- 图文/轮播上传:upload-note 支持 --images 多图、--title、--note 与 --result。照片支持 JPG/JPEG/PNG/AVIF/HEIC/HEIF,实际处理取决于平台。多图按输入顺序发布为轮播,单图和两图轮播已实测。图文发布不接受封面参数。
- 核验与删除:verify 通过 --post-url 和 --expected-text 核对登录用户、作者、作品编号和正文;delete 在核对通过后将作品移至“最近删除”。链接支持 /p/编号/、/reel/编号/ 和带作者名的形式。本地素材不会被删除。
使用方式:默认可见浏览器,未配置代理时按系统网络直连;需要代理时显式使用 --proxy 或设置 SAU_INSTAGRAM_PROXY,传 --proxy "" 可忽略环境变量并直连。标题、正文、标签合计最多 2200 字符。上传流程会自动跳过首次通知提示、确认 Reels 介绍;登录验证仍由用户完成,未知弹窗或提示关闭失败须报告,不能宣称上传成功。结果默认位于 .local/instagram-results/,可用 --result 固定记录路径。published 表示平台确认作品创建并返回作品编号、原作品链接和媒体数;processing 表示已受理且仍在处理;submission_unknown 表示提交后结果未确认,不能当成已发布,也不能直接重发。结果未知但没有链接时,先在同一账号主页按素材、配文和发布时间找到原作品,复制链接再运行 verify;未找到不证明失败,不重复上传。deletion_unknown 须先查询原作品和“最近删除”,不重复提交删除。
适用场景:需要在 Instagram 独立网页会话中自动化发布 Reels、单图或轮播,并对已发布内容做链接核验或移入最近删除的操作。
限制:当前账号独立网页版的照片/Reels 表单及高级设置没有定时入口,CLI 仅支持立即发布,不能把定时任务转换成立即发布。地点、协作者、AI 标签、替代文字、滤镜、裁剪、声音和评论/点赞设置未接入,沿用页面默认值。批量删除和提前永久清空不在范围内。完整参数和能力边界以各子命令 --help 为准。失败时应根据结果文件中的错误及本地证据分析;不得把账号状态、截图或页面记录提交到 Git。scripts/examples/ 下文件为复制用示例,不是运行时依赖,执行前先查看当前 CLI 的 --help 并替换账号、素材和正文,这些命令可能创建真实作品。