雪球长文

使用仓库现有 sau xueqiu，不另写网页上传实现。先检查 sau xueqiu upload-article --help。Windows 未加入 PATH 时在仓库根目录使用 .\.venv\Scripts\sau.exe。

账号及输入

• 已有账号执行 sau xueqiu check --account <别名>。首次使用执行 sau xueqiu login --account <别名> --expected-name "用户指定昵称"，在打开的 Chrome 中登录。程序保存会话并绑定真实用户 ID；不要把账号密码写进命令或源码。Codex 内置浏览器的登录不会自动生成 CLI 会话文件。
• 必须提供非空单行 --title、UTF-8 HTML/Markdown/TXT --content-file 和与实际创作方式相符的 --declaration。声明选择 不添加创作声明 或 本文包含AI生成内容，不要替用户猜测。
• --visibility 为 公开 或 私人，默认公开。正文图片通过 HTML 的 img 或 Markdown 图片写在原稿对应位置，相对路径基于原稿目录；没有 --images 文末追加参数。独立封面用 --cover，采用平台默认裁剪。图片接受本地 GIF/JPEG/PNG，不接受远端或 data URL。
• 雪球各级标题统一为平台小标题，保留段落、加粗、斜体、链接；列表转换为带编号或圆点的段落。自定义 CSS 不保证保留。表格、代码块等未验证结构在创建远端草稿前报错。Markdown 首次使用需运行 sau article setup，详见使用说明。

草稿和发表

sau xueqiu upload-article --account <别名> --title "用户标题" --content-file "文章.md" --cover "封面.png" --visibility 私人 --declaration "本文包含AI生成内容"

命令默认实际发表。仅检查草稿和预览时显式增加 --prepare-only；雪球会自动保存远端草稿，重复运行可能创建多份草稿。编辑器若已有内容会拒绝覆盖。无需独立封面时省略 --cover。