| name | yichen-x-article-draft-uploader |
| description | 将 Obsidian 或本地 Markdown 文章上传到 X/Twitter Articles 草稿，自动把第一张图作为封面，并按原文位置插入所有正文图片。适用于用户要求上传、发布、保存 Markdown 到 X Article，尤其是需要复用 Chrome 登录态、使用独立 Playwright 浏览器、不接管用户当前浏览器、封面必须是最上方图片，或旧脚本出现缺图、错位、MPH_MARKER 等残留时。 |
X Article Draft Uploader
核心原则
只创建草稿。除非用户明确确认可以公开发布，否则不要点击 X 最终的 发布 按钮。
使用独立的 Playwright 浏览器会话，不要抢占用户当前正在用的 Chrome 窗口。可以复用 Chrome 登录态，但只通过临时导出的 Playwright cookie JSON 使用。
快速开始
- 如果
/tmp/x_current_cookies.json 不存在或登录态失效，先导出当前 X cookies：
python3 ~/.codex/skills/yichen-x-article-draft-uploader/scripts/export_x_cookies_from_chrome.py --output /tmp/x_current_cookies.json
- 正式碰 X 之前，先 dry-run 解析文章，确认封面、正文图数量和锚点：
python3 ~/.codex/skills/yichen-x-article-draft-uploader/scripts/upload_markdown_to_x_article.py \
"/absolute/path/to/article.md" \
--cookies-json /tmp/x_current_cookies.json \
--dry-run
如果 dry-run 提醒“文章第一个有效内容不是图片”，先停下来提醒用户：建议在文章最开头加一张封面图。不要继续上传。只有用户明确拒绝添加封面、并要求继续上传无封面草稿时，才加 --allow-no-cover：
python3 ~/.codex/skills/yichen-x-article-draft-uploader/scripts/upload_markdown_to_x_article.py \
"/absolute/path/to/article.md" \
--cookies-json /tmp/x_current_cookies.json \
--allow-no-cover
- 新建一篇干净的 X Article 草稿并上传：
python3 ~/.codex/skills/yichen-x-article-draft-uploader/scripts/upload_markdown_to_x_article.py \
"/absolute/path/to/article.md" \
--cookies-json /tmp/x_current_cookies.json
脚本会输出这些结果文件：
- 草稿 URL：
/tmp/x_article_upload_url.txt
- 校验结果 JSON：
/tmp/x_article_upload_result.json
- 最终截图：
/tmp/x_article_final_uploaded.png
操作流程
- 使用本 Skill 自带的
scripts/parse_markdown.py 解析 Markdown。
- 检查文章第一个有效内容是否是图片。若不是图片，默认中断上传并提醒用户加封面图；只有用户明确拒绝加封面并要求继续时，才使用
--allow-no-cover 跳过封面上传。
- 把文章最开头的第一张图片当作封面图。使用
--allow-no-cover 时，不上传封面，文章里的所有图片都按正文图处理。
- 从原始 Markdown 中读取每张正文图前一行，作为图片插入锚点。列表场景尤其要注意：用真实的上一行，比如
Git 变化。，不要用前面列表项拼出来的更长 fallback。
- 启动全新的 Playwright Chromium context，并添加 X cookies。
- 打开
https://x.com/compose/articles，点击 create，记录新生成的 /compose/articles/edit/... URL。
- 通过封面区域的 file input 上传封面，然后点击 X 的
应用。如果跳过这步，X 会留下 media-edit mask 挡住编辑器，而且封面不会真正保存。
- 填写标题，并把 rich HTML 正文粘贴到
[data-testid="composer"]。
- 正文图片从后往前插入。每张图都按这个顺序处理：
- 在当前编辑器里找到优先级最高的 anchor。
- 点击该段落末尾。
- 按
End，再按 Enter。
- 通过 clipboard paste event 粘贴图片文件。
- 等页面里检测到的 media count 增加后再继续下一张。
- 等 X autosave 完成，然后校验标题、正文开头/结尾、没有
MPH_MARKER，并确认总媒体数等于 封面数 + expected_image_count。
常见卡点
- 如果 X 跳转到
/login，说明登录态失效，重新导出 cookies。
- 如果文章不是以图片开头，默认停止上传。提醒用户加封面图；用户明确拒绝后再用
--allow-no-cover 继续。
- 如果上传封面后编辑器被遮罩挡住，找
应用 按钮并点击。
- 正文图片不要直接用隐藏 file input。它可能指向封面上传器，导致替换封面。
- 不要只看 media count。列表后的图片尤其要看 anchor 是否正确。脚本会在结果 JSON 里记录
anchor_used 和 expected_anchor。
- 如果某次运行只是部分成功，但图片位置不对，优先新建干净草稿重跑，不要在旧草稿上硬修。
脚本说明
upload_markdown_to_x_article.py --dry-run 是安全检查，不会打开 X。--allow-no-cover 只在用户明确拒绝添加封面图时使用；它会跳过封面上传，并把所有图片都作为正文图插入。- 上传脚本需要 Python Playwright 和有效的 X cookie JSON。
- Markdown parser 已经内置在当前 Skill 里，不依赖旧的
x-article-publisher Skill。
- cookie 导出脚本只读取本机 Chrome cookies，并写入指定的临时 Playwright cookie 文件；Skill 本身不保存任何 cookie。
