如何将 Obsidian 长文一键上传 X Articles 草稿：yichen-skills 完整实战教程-育师

如何将 Obsidian 长文一键上传 X Articles 草稿：yichen-skills 完整实战教程

【免费下载链接】yichen-skills项目地址: https://gitcode.com/gh_mirrors/yi/yichen-skills

yichen-skills 是面向内容创作者的开源技能仓库，其中yichen-x-article-draft-uploader技能可以把 Obsidian 或本地 Markdown 长文一键上传为 X Articles 草稿：自动把文章首图设为 5:2 封面、把 Markdown 表格转成 X 原生表格、按原文位置插入正文图片，并只保存草稿、绝不误点发布。下面这份指南带你从零跑通整个流程。

🤔 为什么需要 X 长文上传工具？

把一篇几千字的 Obsidian 笔记手动搬到 X Articles，要处理封面图、表格排版、图片错位等一系列琐事。这个技能替你自动化了整条链路：

它帮你做的事	效果
首图自动设为封面	推荐 5:2 比例，无封面则跳过并提醒补图
Markdown pipe 表格	转成 X 原生表格块（10 x 10 以内）
正文图片	按原文位置插入，最多 25 个媒体项
登录态复用	读取本机 Chrome 登录状态，独立浏览器执行，不抢占你的窗口
结果自校验	刷新草稿后核对标题、正文哈希、表格和每张图片
安全底线	只保存草稿，不点击最终`发布`

规则细节见 SKILL.md。

📦 安装与依赖：3 分钟完成准备

获取仓库（如需克隆）：

git clone https://gitcode.com/gh_mirrors/yi/yichen-skills

将 yichen-x-article-draft-uploader/ 整个目录复制到你的技能目录，规范安装名为x-article-draft-uploader：
- 通用 / Ailu：~/.agents/skills/x-article-draft-uploader/
- Codex：~/.codex/skills/x-article-draft-uploader/
安装 Python 依赖（Python 3.9+，macOS 需已安装 Chrome 并已登录 X）：

python3 -m pip install -r requirements.txt python3 -m playwright install chromium

依赖清单见 requirements.txt，当前固定版本见 VERSION。

🔑 第一步：导出 X 登录态（只打印名称，不打印值）

确认本机 Chrome 已登录 X，然后运行 Cookie 导出脚本：

python3 scripts/export_x_cookies_from_chrome.py \ --output ~/.ailu/secrets/x/cookies.json

脚本对应 export_x_cookies_from_chrome.py，只会打印 Cookie 名称、不打印值；输出文件按0600权限写入私有路径。macOS 上可能弹出 Chrome Safe Storage 钥匙串授权，点击允许即可。

✅ 第二步：先做 dry-run 预检，别急着打开 X

这是新手最容易忽略、也最该坚持的一步——预检不打开浏览器，先把所有问题挡在门外：

python3 scripts/upload_markdown_to_x_article.py \ "/absolute/path/to/article.md" \ --cookies-json ~/.ailu/secrets/x/cookies.json \ --dry-run

脚本对应 upload_markdown_to_x_article.py。dry-run 会检查：

文章标题、正文结尾验收短句
封面图是否存在（推荐 5:2；缺失只记 warning，不阻断）
所有本地图片是否真实存在、正文图是否超过 25 张
表格数量与行列数（单表最大 10 x 10）
每张正文图的插入锚点是否稳定

一个最小示例文章见 smoke-test.md。只要preflight.errors非空，就必须先修 Markdown 再重新预检，不要直接上传。

🚀 第三步：正式上传为 X Articles 草稿

去掉--dry-run参数重跑同一条命令即可。脚本会用独立 Playwright 浏览器新建一篇干净的草稿，依次完成：上传封面并点击应用→ 填写标题 → 粘贴富文本正文 → 插入原生表格块 →从后往前逐张插入正文图片 → 等待 autosave → 刷新同一草稿做最终验收。

完成后在本机生成三个结果文件：

文件	用途
`~/.ailu/runs/x-article-draft-uploader/draft-url.txt`	草稿 URL
`~/.ailu/runs/x-article-draft-uploader/result.json`	完整校验结果
`~/.ailu/runs/x-article-draft-uploader/final.png`	最终页面截图

打开草稿 URL，确认无误后，发布这一步由你自己手动决定。🎉

🩹 常见报错速查表

失败后不要立刻重跑——每次正式上传都会新建一篇草稿，盲目重跑会在草稿箱里堆出重复半成品。先查三个结果文件，再对照下表：

报错	原因	处理方法
X 跳到登录页	Cookie 过期	重新运行导出脚本
`missing_body_image`	本地图片路径失效	修路径或移动图片，重新 dry-run
`weak_image_anchor`	图片前缺少稳定定位文字	在图前补一行唯一说明，如`验收截图：`
`table_too_large`	表格超过 10 x 10	拆表、改图片或改成段落
`body_media_limit_exceeded`	正文图超过 25 张	合并连续截图或拆分成篇（封面不占这 25 个名额）
`unsupported_remote_image`	用了网络图片	先下载到本地再引用