SuperAPI AI 工具集

soia-media-publish-x-article

写作与研究

查看项目

更新于 10-16 08:49

技能介绍

用途:把 Obsidian 或本地 Markdown 长文推送为 X Articles 草稿。触发说法包括「发成 X Article」「上传 X 文章」「推到 X 草稿箱」;普通短帖或推文串不归本技能,另有对应技能处理。

主要能力:先用 parse_x_article.py 解析 Markdown 得到 JSON(title / cover_image / content_images / dividers / html / missing_images),再通过 Playwright 脚本 x_article_post.py 在浏览器里新建草稿,依次放置封面、标题、正文富文本、正文插图与分割线,最后运行机械校验。H2/H3、加粗、斜体、链接、列表、引用原生保留;代码块转为引用块;表格与 mermaid 不被 X 支持,需自行转为 PNG 或接受降级;--- 通过编辑器插入菜单加分割线;H1 仅作标题。

使用方式:安装可按插件或单技能两条路线,后者命令为 npx skills add soia-team/soia-open-media-content-skills -g -a '*' -s soia-media-publish-x-article -y。需 Python 3.9+,主路线依赖 pip install playwright && python -m playwright install chromium。常用命令:python3 scripts/parse_x_article.py <article.md> > /tmp/x_article.json;python3 scripts/x_article_post.py status;check;draft /tmp/x_article.json。本技能自身不提供 login 子命令,未登录时需到共用同一 profile 的另一个技能跑一次登录。

闸门与校验:解析阶段若 missing_images 大于 0 或缺封面会先停下询问;draft 完成后校验标题、正文首末句、媒体数、分割线数、草稿状态(autosave_confirmed)与草稿 URL。备选路线需宿主的浏览器控制工具,校验标准一致,仅支持 macOS。

限制与安全:只保存草稿,脚本内无发布代码路径;不导出 cookie,不写凭据到磁盘。账号需具备含「撰写文章」权益的 X Premium 订阅(资料记载 2026-07 购买页 US$4 档即含,以 X 实时权益表为准),不代订阅。

资料未验证项:check 的 ok 分支与完整 draft 流程尚无真实 Premium 账号实测,多处选择器为合理猜测;Windows/Linux 剪贴板路径未在真机验证。首次真实运行可能遇到选择器失效或 autosave_confirmed 为 false,需按页面实况调整。