xueqiu-upload

1# 雪球长文
2 
3使用仓库现有 `sau xueqiu`，不另写网页上传实现。先检查 `sau xueqiu upload-article --help`。Windows 未加入 PATH 时在仓库根目录使用 `.\.venv\Scripts\sau.exe`。
4 
5## 账号及输入
6 
7- 已有账号执行 `sau xueqiu check --account <别名>`。首次使用执行 `sau xueqiu login --account <别名> --expected-name "用户指定昵称"`，在打开的 Chrome 中登录。程序保存会话并绑定真实用户 ID；不要把账号密码写进命令或源码。Codex 内置浏览器的登录不会自动生成 CLI 会话文件。
8- 必须提供非空单行 `--title`、UTF-8 HTML/Markdown/TXT `--content-file` 和与实际创作方式相符的 `--declaration`。声明选择 `不添加创作声明` 或 `本文包含AI生成内容`，不要替用户猜测。
9- `--visibility` 为 `公开` 或 `私人`，默认公开。正文图片通过 HTML 的 `img` 或 Markdown 图片写在原稿对应位置，相对路径基于原稿目录；没有 `--images` 文末追加参数。独立封面用 `--cover`，采用平台默认裁剪。图片接受本地 GIF/JPEG/PNG，不接受远端或 data URL。
10- 雪球各级标题统一为平台小标题，保留段落、加粗、斜体、链接；列表转换为带编号或圆点的段落。自定义 CSS 不保证保留。表格、代码块等未验证结构在创建远端草稿前报错。Markdown 首次使用需运行 `sau article setup`，详见使用说明。
11 
12## 草稿和发表
13 
14```powershell
15sau xueqiu upload-article --account <别名> --title "用户标题" --content-file "文章.md" --cover "封面.png" --visibility 私人 --declaration "本文包含AI生成内容"
16```
17 
18命令默认实际发表。仅检查草稿和预览时显式增加 `--prepare-only`；雪球会自动保存远端草稿，重复运行可能创建多份草稿。编辑器若已有内容会拒绝覆盖。无需独立封面时省略 `--cover`。
19 
20优先使用 Markdown 原稿；段间配图用相对原稿路径的 Markdown 图片语法，例如 `![图片说明](images/chart.png)`。首次使用先执行 `sau article setup`。
21 
22正式 CLI 已实测原生结构、两张不同的段间图片、独立封面、私人发表及后台原作品查询。沿用用户的操作范围；开发或登录授权本身不等于授权发表测试内容。
23 
24没有定时参数：本次账号的完整长文表单未观察到定时功能。Word、自定义裁剪、视频、股票/话题/@关联对象尚未支持，不用普通文字冒充关联对象。
25 
26## 判断结果与中断处理
27 
28保留命令输出的结果 JSON 路径和截图。`prepared` 仅表示准备完成；`published` 表示平台最终受理并通过主体、标题、分享范围及正文核对。`management_verified: true` 表示后台原 ID 查询也通过。私人作品显示“仅自己可见”。
29…