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

如何将 Obsidian 长文一键上传 X Articles 草稿yichen-skills 完整实战教程【免费下载链接】yichen-skills项目地址: https://gitcode.com/gh_mirrors/yi/yichen-skillsyichen-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.9macOS 需已安装 Chrome 并已登录 Xpython3 -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-runweak_image_anchor图片前缺少稳定定位文字在图前补一行唯一说明如验收截图table_too_large表格超过 10 x 10拆表、改图片或改成段落body_media_limit_exceeded正文图超过 25 张合并连续截图或拆分成篇封面不占这 25 个名额unsupported_remote_image用了网络图片先下载到本地再引用完整故障处理说明见 README.md。 隐私与边界它绝对不会做什么只创建草稿除非你当轮明确确认否则不会点击发布不接管你的浏览器全程在独立 Playwright 会话中运行不含任何凭据源码里没有 Cookie、Token 或账号密码不自动挪图充封面文章没以图片开头就保持封面空白完成后提醒你补一张 5:2 封面 延伸阅读技能入口与规则SKILL.md安装、隐私与 FAQREADME.md许可条款LICENSE技能发布与安装维护规范docs/skill-maintenance.md上传成功只是起点去草稿箱里看看封面比例和排版细节再决定何时点下那个发布按钮。【免费下载链接】yichen-skills项目地址: https://gitcode.com/gh_mirrors/yi/yichen-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考