Use the repository's sau zhihu command; do not write separate web upload logic.
Feature Overview
| Feature | Command Entry | Description |
|---|---|---|
| Login | sau zhihu login --account <name> |
Save a local session for a specified account |
| Account Check | sau zhihu check --account <name> |
Check whether the session matches the current account |
| Article Publishing | sau zhihu upload-article ... |
HTML/Markdown/TXT manuscripts; images retain their manuscript positions |
| Video Publishing | sau zhihu upload-video ... |
Single video, title, description, domain, and content declaration |
| Work Verification | sau zhihu verify --account <name> --result <json> |
Open the original work link in the result file to verify the title |
Metadata conventions: articles use title + content-file, videos use title + desc + originality + category + video-mark。--account is a local session alias and need not match the Zhihu nickname.
Login
sau zhihu login --account creator
sau zhihu check --account creator
Enter the account, password, and verification code in the login window; session files are saved locally and are not committed to the repository.
Articles
The title can be up to 100 characters. The body uses UTF-8 HTML, Markdown, or TXT; for first-time Markdown use, run sau article setup。
Images are written in the corresponding paragraphs of the manuscript, and relative paths are resolved from the manuscript directory:
第一段正文。
第二段正文。
sau zhihu upload-article --account creator --title "文章标题" --content-file "文章.md"
Before submitting, verify the text, image order, basic formatting, and links. If the editor restores a non-empty draft, it stops to avoid overwriting existing content. Custom theme CSS, manual covers, column inclusion, Zhihu tasks, and document import are not yet supported.
Videos
The file must be larger than 100KB (102400 bytes), at most 20GB, and at most 4 hours long. The title is 5–50 characters, and the description is at most 300 characters; the platform-generated cover is used by default.
sau zhihu upload-video --account creator --file "视频.mp4" --title "视频标题示例" --desc "视频简介" --originality original --category "教育" --video-mark "含 AI 生成内容"
--originality：original(Original) orreprint(Repost).--category: For domain options, seesau zhihu upload-video --help; when omitted, a live menu is displayed and you select by number.--video-mark：内容无需标注、含 AI 生成内容、含虚构演绎内容、内容含营销信息、内容为转载、个人观点仅供参考; the declaration must match the content.
Non-interactive calls should specify the domain and declaration. The program still verifies the live menu before submitting. To only retrieve candidates on the current page, use:
sau zhihu upload-video --account creator --file "视频.mp4" --title "视频标题示例" --originality original --show-options
Candidates are written to the result JSON's options.category、options.video_mark. Automatically selecting topics, custom covers, columns, and content sources are not yet supported.
Submission and Results
Both articles and videos can be run with --prepare-only, which fills in and checks the form and then exits;--prepare-only、--show-options may leave a remote draft.
published indicates that the platform confirmed publication, and the detail link is written to the result file's url; the video address can be /pin/<作品ID>. If reading the details fails, retain published and error, check the original work in the Creator Center, and do not repost.prepared does not mean publication succeeded. If it is submission_unknown, also first check the original work by title and submission time. When a URL is already available, you can run:
sau zhihu verify --account creator --result "本次结果.json"
--schedule "YYYY-MM-DD HH:MM" is an experimental option, limited to between 30 minutes and 48 hours from now in Beijing time; a complete scheduling workflow is not yet guaranteed to work.
Example Scripts
The following files provide templates for login, checking, form pre-filling, and candidate queries; removing --prepare-only will actually publish the article.