zhihu-upload 是 social-auto-upload 仓库中的知乎发布技能,使用仓库自带的 sau zhihu 命令操作,不另写网页上传逻辑。
用途 面向需要批量或脚本化发布知乎内容的场景,提供登录、会话检查、文章发布、视频发布与结果核对五类命令入口。
主要能力
- 登录与账号检查:sau zhihu login --account <name> 保存指定账号的本地会话;sau zhihu check --account <name> 检查会话与当前账号是否一致。账号密码、验证码在登录窗口输入,会话文件保存在本地,不提交到仓库。--account 是本地会话别名,无须与知乎昵称相同。
- 文章发布:sau zhihu upload-article 接受 UTF-8 编码的 HTML、Markdown 或 TXT 原稿,标题最多 100 字。图片写在原稿对应段落中,相对路径从原稿目录解析,图片保留原稿位置。Markdown 首次使用需先执行 sau article setup。编辑器恢复出非空草稿时会停止,避免覆盖已有内容。
- 视频发布:sau zhihu upload-video 支持单视频上传,文件须大于 100KB(102400 字节)、最大 20GB、最长 4 小时;标题 5–50 字,简介最多 300 字,默认使用平台生成的封面。可通过 --originality 指定 original(原创)或 reprint(转载);--category 指定领域,省略时显示实时菜单按编号选择;--video-mark 指定内容声明,可选内容无需标注、含 AI 生成内容、含虚构演绎内容、内容含营销信息、内容为转载、个人观点仅供参考,声明须与内容一致。非交互调用应指定领域和声明,程序提交前仍会核对实时菜单。
- 候选查询:使用 sau zhihu upload-video --show-options 可仅获取当前页面的候选,写入结果 JSON 的 options.category、options.video_mark。
- 作品核对:sau zhihu verify --account <name> --result <json> 打开结果文件中的原作品链接核对标题。
使用方式 先登录并检查会话,再以文章或视频命令发布。示例: 登录:sau zhihu login --account creator;检查:sau zhihu check --account creator。 文章:sau zhihu upload-article --account creator --title "文章标题" --content-file "文章.md"。 视频:sau zhihu upload-video --account creator --file "视频.mp4" --title "视频标题示例" --desc "视频简介" --originality original --category "教育" --video-mark "含 AI 生成内容"。 核对:sau zhihu verify --account creator --result "本次结果.json"。 文章和视频均可加 --prepare-only,填写并检查后结束;--prepare-only、--show-options 都可能留下远端草稿。--schedule "YYYY-MM-DD HH:MM" 为实验性选项,按北京时间限制在 30 分钟后至 48 小时内,尚不保证完整排期流程可用。
结果状态 published 表示平台确认发表,详情链接写入结果文件的 url,视频地址可为 /pin/<作品ID>。若详情读取失败,保留 published 和 error,应到创作中心查原作品,勿重发。prepared 不表示发表成功。若为 submission_unknown,也应先按标题和提交时间检查原作品。
适用场景 适合通过脚本或命令行批量发布知乎文章、视频,以及在自动发布后核对作品链接的场景。仓库还提供登录、检查、表单预填及候选查询的 PowerShell、Bash、Python subprocess 示例脚本模板,移除 --prepare-only 会真实发布文章。
限制 暂不支持自定义主题 CSS、手动封面、专栏收录、芝士任务、文档导入;视频暂不支持自动选择话题、自定义封面、专栏和内容来源。