my-gzh 公众号文章工程

一个纯本地的公众号文章生产流水线：选题 → 写作 → 配图 → 转微信兼容 HTML → 同步草稿箱，全流程脚本化，不依赖任何付费服务。

能力分三层：

本工程所有截图、配图、HTML 都在本地生成。核心脚本只用 Python 标准库即可运行；只有「生成配图」和「抓取参考文章」两步需要额外装包。

my-gzh/
├── SKILL.md                      # 写作技能规范：12 身份协作流程 + 优质内容 8 条硬标准 + 违禁词审查
├── article.md                    # 当前正文（默认入口，用标准 Markdown 写）
├── meta.json                     # 当前元信息：标题、摘要、作者、来源、封面、标签
├── article-ai-desktop-workflow.md # 备选文章正文（多文章并存，详见「四、5」）
├── meta-ai-desktop-workflow.json  # 备选文章元信息
├── zhihu_article.md              # 同一选题的知乎版本（多平台复用）
├── README.md                     # 本教程
├── LICENSE                       # MIT
├── .gitignore                    # 忽略 wechat-config.json / images / out / 备份文件
├── wechat-config.example.json    # 配置模板（提交到仓库）
├── wechat-config.json            # 本地公众号凭据（不提交，被 .gitignore 忽略）
├── requirements.txt              # 可选第三方依赖（仅抓取参考文章/生成配图时用）
├── templates/                    # 写作模板（写稿时照着套）
│   ├── viral-titles.md           # 爆款标题模板：钩子类型 + 字数红线
│   ├── viral-summary.md          # 摘要模板：120 字内三段式
│   └── viral-copy.md             # 正文结构模板：问题-方案型 / 清单型 / 观点型
├── images/                       # 本地素材（被 .gitignore 忽略，不提交）
│   ├── real_robot.jpg            # 正文配图（由 fetch 脚本从 Wikimedia 拉取）
│   ├── real_circuit.jpg
│   ├── ...（real_*.jpg 若干）
│   ├── p01_group.jpg … p09_*.jpg # 由 fetch_chosen_photos.py 从 Pexels 抓取的实拍图
│   ├── cover.jpg / cover.png     # 封面（make_cover.py 裁成 1200×510）
│   ├── fig1-*.png / fig2-*.png   # 由 HTML 设计稿导出的信息图（配 .html 源文件）
│   ├── _candidates/              # Pexels 候选缩略图 + 联系表（人工挑选用）
│   └── wechat-urls.json          # 手动发布时，填微信图片链接的映射表
├── references/                   # 参考文章与 archive/ 已发存档（查重来源，被 .gitignore 忽略）
├── tools/
│   ├── md_to_wechat.py           # Markdown → 微信兼容 HTML + 本地预览页（标准库）
│   ├── push_wechat_draft.py      # 上传图片并同步到公众号草稿箱（标准库）
│   ├── fetch_real_images.py      # 从 Wikimedia Commons 抓取真实可商用图片（标准库）
│   ├── fetch_real_images_retry.py    # 对限流的主题重试抓取（标准库）
│   ├── fetch_real_images_retry2.py   # 替换 3 张质量偏弱的真实图片（标准库）
│   ├── search_commons.py         # 检索 Commons 只打印候选链接，供人工挑选（标准库）
│   ├── fetch_pexels_candidates.py    # 下载 Pexels 候选图并拼联系表（需 Pillow）
│   ├── fetch_chosen_photos.py    # 按 ID 清单下载最终选定的 Pexels 高清图（标准库）
│   ├── make_cover.py             # 把原图裁成 2.35:1 的 1200×510 封面（需 Pillow）
│   ├── make_mhs_images.py        # 用 Pillow 生成 MHS 主题封面与示意图（需 Pillow）
│   ├── make_article_images.py    # 通用封面/示意图生成器（需 Pillow）
│   ├── make_doubao_images.py     # 豆包开学季主题封面与信息图（需 Pillow）
│   ├── gen_robot_images.py       # 机器人主题封面 + 对比信息图（需 Pillow）
│   ├── fetch_reference.py        # 抓取网页/公众号/知乎文章到 references/（需 requests+trafilatura）
│   ├── analyze_reference.py      # 分析 references/ 下的参考素材（标准库）
│   └── check_article.py          # 发布前检查：连续 13 字查重 + 配图资产校验（标准库）
└── out/                          # 生成结果（被 .gitignore 忽略，不提交）
    ├── article.wechat.html       # 本地预览页，可点「复制正文」
    ├── article.wechat.fragment.html  # 纯片段 HTML（供程序二次处理）
    ├── article.wechat.uploaded.html  # 推送成功后的最终页
    ├── article-ai-desktop-workflow.wechat.html  # 备选稿的预览页（按稿件名输出）
    ├── last-draft-id.txt         # 主稿的草稿 media_id，用于自动更新
    └── last-draft-id-<稿件名>.txt # 其它稿件各自的草稿 ID（互不覆盖）

⚠️ images/、references/、out/、wechat-config.json 以及 *.bak* 备份、.edge-tmp*/ 临时目录都在 .gitignore 里，不会提交到仓库。克隆到新机器后，这些目录需要本地重新生成或配置（详见下文）。

本工程脚本都是 Python 写的，需要本机有 Python 3.10 或更高版本（建议 3.12）。

1. 打开官网 https://www.python.org/downloads/，下载 3.10+（建议 3.12）。

2. 安装时必须勾选 Add python.exe to PATH（Windows 最关键的一步）。

3. 安装完成后，新开一个终端窗口（让 PATH 生效），运行：

   python --version
   

   能看到版本号（如 Python 3.12.x）即说明装好。若提示「python 不是内部或外部命令」，通常是没勾选 PATH，重新安装一次即可。

核心流水线（md_to_wechat.py、push_wechat_draft.py、三个 fetch_real_images*.py、analyze_reference.py）只用 Python 标准库，完全不用装任何第三方包。

只有下面两种情况需要装包：

如果你只打算「写 Markdown → 转 HTML → 复制/推送」，且图片已经准备好（或走手动上传），可以一个包都不装，直接跳到「二、配置公众号接口」。

一次性把可选依赖都装上也可以：

python -m pip install -r requirements.txt

（仓库里的 requirements.txt 含 trafilatura / requests / markdown / lxml，主要用于 fetch_reference.py；markdown 与 lxml 多为 trafilatura 的传递依赖，装了无害。）

只有走「接口同步到草稿箱」模式才需要这一步。若只手动复制正文，可跳过。

登录公众号后台 https://mp.weixin.qq.com/：

1. 进入「设置与开发」→「基本配置」。
2. 复制 AppID（一串 18 位字符）。
3. 点击「查看」或「重置」AppSecret。

AppSecret 只显示一次，重置后旧值立即失效。复制出来后妥善保存到本地密码管理器，不要截图发到任何群里。

把模板复制一份并重命名：

wechat-config.example.json  →  wechat-config.json

填入真实值（注意去掉 YOUR_* 占位符）：

{
  "app_id": "wx1234567890abcdef",
  "app_secret": "a1b2c3d4e5f6..."
}

脚本会按以下顺序查找配置，命中第一个即停止：

1. ~/.codex/skills/wechat-publisher/config.json
2. 项目根目录下的 wechat-config.json（本工程已存在该文件，且被 .gitignore 忽略，不会提交）

如果你在别的电脑上克隆了本项目，仓库里只有 wechat-config.example.json，需要按上面步骤重新创建 wechat-config.json。

公众号接口要求调用方 IP 在白名单内。

1. 在公众号后台「设置与开发」→「基本配置」→「IP 白名单」里，添加当前电脑的公网 IP。

2. 查看公网 IP（任选其一）：

   curl https://ipinfo.io/ip
   

   或浏览器打开 https://ipinfo.io/ip。

3. 如果推送时微信返回：

   errcode 40164, invalid ip xxx.xxx.xxx.xxx, not in whitelist
   

   就把报错里的 xxx.xxx.xxx.xxx 加进白名单。

⚠️ 家庭宽带多为动态 IP，换 WiFi / 热点 / 重启光猫后白名单可能又要重加。公司固定 IP 一般一次配置即可。

本工程有两套图片方案，可二选一，也可混用。封面与正文图片都放在 images/ 下，并在 article.md 里用相对路径引用。

article.md 当前引用的是 images/real_robot.jpg、real_circuit.jpg、real_usbc.jpg、real_code.jpg、real_arm.jpg、real_quantum.jpg、real_quad.jpg、real_datacenter.jpg、real_ai.jpg 等。这些来自 Wikimedia Commons（CC/PD 协议，可商用），由脚本自动抓取：

python tools/fetch_real_images.py

• 脚本会把每张主题的最佳候选缩略图下载到 images/real_*.jpg，并打印 [OK]/[FAIL]/[NONE] 结果。

• 部分主题若被限流或没拿到好图，再补跑重试脚本（带延时，降低被限流概率）：

  python tools/fetch_real_images_retry.py
  python tools/fetch_real_images_retry2.py
  

• 抓完请用文件管理器确认 images/real_*.jpg 都在；推送前这一步必须完成，否则 push_wechat_draft.py 会因找不到本地图片而报错。

想换主题或换图？直接改这三个脚本顶部的 TOPICS = [...] 列表（格式为 ("搜索词", "目标文件名")），重跑即可。

科技类图片用 Wikimedia 够用；人像、校园、生活场景这类实拍图，Wikimedia 质量普遍偏差，改走 Pexels（免费可商用，无需署名）。流程是「先批量抓候选 → 人眼挑 → 再下高清」：

# 1) 检索阶段（二选一，都只打印候选，不下图）
python tools/search_commons.py            # Commons 检索，打印候选链接（标准库）
python tools/fetch_pexels_candidates.py   # Pexels 批量下候选缩略图 + 拼联系表（需 Pillow）

# 2) 人工挑选：把看中的 Pexels 图片 ID 填进 fetch_chosen_photos.py 顶部的 PICKS 列表
#    格式：(图片ID, "目标文件名.jpg", "这张图的用途说明")

# 3) 下载最终选定的高清图
python tools/fetch_chosen_photos.py       # 并发下载到 images/，宽度默认 1400

# 4) 裁封面（公众号首图推荐 2.35:1）
python tools/make_cover.py                # 把 p01_group.jpg 裁成 1200×510 的 cover

• fetch_pexels_candidates.py 会把候选图与「联系表（contact sheet）」输出到 images/_candidates/，一屏看完再决定，比一张张点开快得多。
• fetch_chosen_photos.py 里的 PICKS 是三元组列表，改 ID 和文件名即可换图；W = 1400 控制下载宽度。
• make_cover.py 按 1200/510 居中裁剪（过宽裁两边、过高裁上下），最后 resize 成 1200×510。换源图就改脚本里的 p01_group.jpg。

挑图原则：图片必须服务内容，不凑数；同一篇里风格要统一（要么全实拍，要么全自绘）。

若你想用自绘的科技风示意图，运行：

python tools/make_mhs_images.py

会生成 images/cover.png（封面）、images/pic1.png（总线对比图）、images/pic2.png（落地支点图）。

注意：make_mhs_images.py 生成的是 cover.png，而当前 meta.json 的封面字段是 "cover": "images/real_ai.jpg"。若改用生成的封面，请把 meta.json 里的 cover 改成 images/cover.png，并在 article.md 里把对应插图路径改成 images/pic1.png / images/pic2.png。两套图不要混着引用同一个不存在的文件。

其它主题的自绘脚本（改脚本内的文案/配色即可复用）：

这几个脚本都用 Windows 系统字体（优先 msyhbd.ttc/msyh.ttc，回退 simhei.ttf），Linux/macOS 上跑需要自己改 load_font() 里的字体路径，否则中文会变成方块。

仓库里 images/fig*.html 是信息图的 HTML 设计稿，用浏览器打开后截图（或整页截图）即得到 fig*.png。适合做「流程图、对比表、清单卡」这类排版密度高的图，比 Pillow 手绘省事。改 HTML 再重新截图即可迭代（仓库里的 -v2 就是第二版）。

直接在 images/ 里放你自己的图（如 myphoto.jpg），在 article.md 里写 ![说明](images/myphoto.jpg) 即可。make_local_srcs_relative 会自动把路径处理成预览可用的相对路径。

仓库里有一套写作约束，写稿/改稿时照着走，能明显减少「写完发现是注水文」的返工：

优质内容 8 条硬标准（摘自 SKILL.md）：信息密度、独特观点、具体案例（≥3 个）、可执行步骤、逻辑链条、情绪共鸣、传播钩子、事实准确。8 项自检必须全部通过，任何一项不通过就重写。

每篇按下面顺序走（顺序不能跳）。用户确认只发生在 4 个检查点：选题（身份 1-4 合并汇报）、标题（3 选 1）、终审（身份 5-11 打包交付）、发布（身份 12）；检查点内自动连续执行，内部重写不占确认次数。知识库缺料时，先按 references/knowledge.md 的素材问答问用户。

⚠️ 发布前必过第 10 步：扫描广告法极限词（最/第一/唯一/国家级…）、政治敏感词、色情低俗、暴力恐怖、赌博迷信、医疗夸大，并检查诱导分享等违规行为。脚本不会替你做合规检查，这一步必须在推送草稿前人工完成；AI 生成内容也需本人最终审核。

事实类内容（数据、产品、版本）发布前必须核实，不确定就标注「需核实」；本工程的惯例是多源交叉验证（如人民网、新华社等权威源）后再推送。

单项任务（改稿、查违禁词、排版、只发布）可走 SKILL.md 的「快速模式」，不必跑全流程；发布前记得先过 python tools/check_article.py（查重 + 配图资产校验）。

用标准 Markdown 写，并支持以下本项目扩展语法：

示例片段：

## 小标题

第一段会作为导语展示。

![人形机器人](images/real_robot.jpg)
图注：人形机器人是「物理世界」最直观的代表。

:::highlight
一句话总结：MCP 接管软件，MHS 接管硬件。
:::

> 这是一句金句引用。

{
  "title": "文章标题",
  "summary": "文章摘要（用作草稿 digest）",
  "author": "作者名",
  "source": "公众号：公众号名",
  "cover": "images/real_ai.jpg",
  "tags": ["标签1", "标签2"],
  "video_vid": ""
}

字段说明：

• title / summary / author / source：必填，推送时写入草稿。
• cover：封面图路径，推送时会被作为永久素材上传，拿 thumb_media_id。必须指向 images/ 下真实存在的文件。
• tags：可选，渲染在正文末尾的标签条。
• video_vid：可选。若文章用 @video[...] 且你已有现成视频 vid（如之前上传过的），填这里可跳过重新上传；留空则推送时自动上传 images/ 下的视频文件并取 vid。

• 用相对路径，如 images/real_robot.jpg。
• 不要写 <div class="...">、不要引入外部 CSS/JS（微信会过滤）。
• 代码块用 ``` 包裹。

仓库里可以同时放好几篇稿子，命名规则是「正文 + 同名元信息」成对出现：

article.md                      + meta.json                       # 当前主稿（默认入口）
article-ai-desktop-workflow.md  + meta-ai-desktop-workflow.json   # 备选稿
zhihu_article.md                                                  # 同一选题的知乎版

• 两个脚本都支持 --article，直接指定任意一篇，不用再手工替换入口文件：

  # 预览备选稿
  python tools/md_to_wechat.py --article article-ai-desktop-workflow.md \
         --meta meta-ai-desktop-workflow.json \
         --out out/article-ai-desktop-workflow.wechat.html
  
  # 推送备选稿（meta 会自动推断为 meta-ai-desktop-workflow.json）
  python tools/push_wechat_draft.py --article article-ai-desktop-workflow.md
  

自动推断规则（不用记参数）：

也就是说每篇稿子有自己独立的草稿 ID 文件，来回切换推送不会互相覆盖；--new-draft 只在这篇稿子第一次推送时（或你想另起一篇时）才需要加。

• 想显式指定 meta（文件名不符合 article-* / meta-* 配对时）：

  python tools/push_wechat_draft.py --article zhihu.md --meta meta-robot.json
  

• 路径支持绝对路径，相对路径会先按当前目录找、找不到再回退到项目根目录；文件不存在会直接报 Article file not found: xxx，不会走到网络请求。

运行转换脚本（标准库，无需装包）：

python tools/md_to_wechat.py

成功后生成：

out/article.wechat.html

用浏览器打开这个文件，页面顶部有「复制正文」按钮，点一下即可复制带内联样式的微信 HTML，直接粘到公众号后台。

• 若正文里还有本地图片未替换成微信链接，预览页顶部会有黄色提示。
• 纯片段版在 out/article.wechat.fragment.html，供程序二次处理。

常用参数（都有默认值，一般不用改）：

python tools/md_to_wechat.py --article article.md --meta meta.json \
       --images-map images/wechat-urls.json --out out/article.wechat.html

适合偶尔写、不想配接口的情况。

1. 到公众号后台「素材管理」上传 images/ 里的图片。

2. 复制每张图返回的 https://mmbiz.qpic.cn/... 链接。

3. 打开 images/wechat-urls.json，按「本地路径 → 微信链接」填好映射：

   {
     "images/real_robot.jpg": "https://mmbiz.qpic.cn/xxxx",
     "images/real_circuit.jpg": "https://mmbiz.qpic.cn/yyyy"
   }

4. 重新运行转换：

   python tools/md_to_wechat.py
   

5. 打开 out/article.wechat.html，点「复制正文」。

6. 到公众号后台新建图文，粘贴正文；上传封面、填标题和摘要，存草稿，人工确认后发布。

md_to_wechat.py 会读取 wechat-urls.json，自动把正文里的本地路径替换成你填的微信链接。

适合已配好 AppID / AppSecret / IP 白名单的情况。

python tools/push_wechat_draft.py                                  # 推送主稿 article.md
python tools/push_wechat_draft.py --article article-foo.md         # 推送指定稿件

脚本依次执行：

1. 解析稿件：--article 指定的 Markdown（默认 article.md），并推断/读取对应 meta。
2. 在配置的 .json 里读取凭据，调用接口拿 access_token。
3. 把 meta 里 cover 指向的封面作为永久素材上传，拿到 thumb_media_id。
4. 遍历正文里所有本地图片，通过 media/uploadimg 上传，拿到 https://mmbiz.qpic.cn/... 链接并替换正文路径。
5. 若正文有 @video[...]，上传视频并生成公众号视频 iframe（或读取 meta 的 video_vid）。
6. 调用草稿接口，把标题、摘要、作者、正文、封面同步到草稿箱。
7. 把草稿 media_id 写入该稿件专属的 ID 文件（out/last-draft-id.txt 或 out/last-draft-id-<稿件名>.txt），并生成 out/<稿件名>.wechat.html 等预览文件。

草稿更新策略（按稿件独立记录）：

• 每篇稿子一个 ID 文件：主稿 out/last-draft-id.txt，article-foo.md → out/last-draft-id-article-foo.txt。切换稿件推送不会互相覆盖。

• 第一次推送某篇：新建草稿并记录 media_id。

• 之后再推同一篇：读取该稿件的 ID 文件，自动更新同一篇草稿，不会重复建草稿。

• 想强制新建一篇（同一稿件另起一篇草稿）：

  python tools/push_wechat_draft.py --new-draft
  python tools/push_wechat_draft.py --article article-foo.md --new-draft
  

• 想更新指定草稿（不用记录文件）：

  python tools/push_wechat_draft.py --draft-media-id 草稿ID
  

• 想顺手删掉某篇重复草稿：

  python tools/push_wechat_draft.py --delete-draft-id 要删的草稿ID
  

• 想指定别的配置文件（而不是默认的 wechat-config.json）：

  python tools/push_wechat_draft.py --config 路径/config.json
  

推送完成后，刷新公众号后台「草稿箱」即可看到最新版本。发布前仍建议人工确认一遍。

推送要求 images/ 下的图片和封面真实存在（见「三、准备图片素材」）。若图片缺失，会报 No local images found to upload. 或上传失败。

写稿前想抓取同类文章做素材，可用：

# 抓取一篇网页/公众号/知乎文章，存到 references/
python tools/fetch_reference.py "https://example.com/some-article"

# 分析 references/ 下的素材（提取标题、正文等）
python tools/analyze_reference.py

fetch_reference.py 需要 requests + trafilatura（见「一、2」）。公众号链接常有访问限制，抓不到时会提示你手动保存。

重装 Python，安装时勾选 Add python.exe to PATH，然后新开终端窗口。

运行了需要 Pillow 的脚本（make_mhs_images.py / make_article_images.py）。装一下：

python -m pip install pillow

运行了 fetch_reference.py。装一下：

python -m pip install requests trafilatura

没找到 wechat-config.json，也没放到 ~/.codex/skills/wechat-publisher/config.json。按「二、2」创建并填写。

配置文件里 app_id 或 app_secret 为空，或还留着 YOUR_APP_ID_HERE 这类占位文字。改成真实值。

当前公网 IP 不在白名单。把报错里的 IP 加到「设置与开发」→「基本配置」→「IP 白名单」（见「二、3」）。

app_secret 填错，或 AppSecret 被重置过。回到后台重新查看/重置并填入。

article.md / meta.json 里引用的图片在 images/ 下找不到。先跑 fetch_real_images.py 或把图片放进 images/。

先运行 python tools/md_to_wechat.py。预览页图片路径应是 ../images/xxx.jpg。仍看不到就检查图片是否真的在 images/ 下。

手动发布（方式 A）时，要先在「素材管理」上传图片，并把 mmbiz.qpic.cn 链接填进 images/wechat-urls.json，再重新转换。接口发布（方式 B）会自动上传并替换，无需手动填。

fetch_real_images*.py 产出 real_*.jpg；make_mhs_images.py 产出 cover.png/pic1.png/pic2.png；fetch_chosen_photos.py 产出 p01_*.jpg…p09_*.jpg。meta.json 的 cover 与 article.md 的图片路径要指向同一套实际存在的文件，不要混用。

现在每篇稿子有独立的 ID 文件（out/last-draft-id.txt / out/last-draft-id-<稿件名>.txt），只要用 --article 指定稿件就不会互串。出现覆盖通常是这两种情况：

• 手工把备选稿复制成 article.md 再推送（旧做法），共用了一个 last-draft-id.txt → 改用 --article。
• 同一篇稿件想另起一篇草稿却忘了加 --new-draft。

python tools/push_wechat_draft.py --article article-foo.md            # 更新 foo 自己的草稿
python tools/push_wechat_draft.py --article article-foo.md --new-draft # 给 foo 另建一篇

已被覆盖的草稿无法从脚本恢复，只能重新推一次新建。

--article / --meta 路径写错了。相对路径会先按当前目录找、再回退到项目根目录；确认文件名拼写，或直接用绝对路径。

预览文件现在按稿件名输出：推 article-foo.md 得到 out/article-foo.wechat.html，主稿仍是 out/article.wechat.html。打开对应文件即可。

Pillow 脚本默认找 Windows 字体（C:\Windows\Fonts\msyhbd.ttc / msyh.ttc / simhei.ttf）。在 macOS / Linux 上或字体缺失时，会回退到默认字体导致中文不显示。改脚本里 load_font() 的候选列表，指向本机真实中文字体（如 /System/Library/Fonts/PingFang.ttc、/usr/share/fonts/opentype/noto/NotoSansCJK-Bold.ttc）。

多为限流或网络问题。Commons 走 fetch_real_images_retry.py（带延时）重试；Pexels 换一批 ID 或减少并发（改 fetch_chosen_photos.py 里的 ThreadPoolExecutor 线程数）。始终抓不到就走「方案 E」手动放图。

公众号首图推荐 2.35:1。用 make_cover.py 裁成 1200×510 后再上传，避免后台自动裁剪把主体切掉。

# —— 图片素材：Wikimedia（科技/器物类）——
python tools/fetch_real_images.py          # 抓取真实可商用图片到 images/real_*.jpg
python tools/fetch_real_images_retry.py    # 限流主题重试
python tools/fetch_real_images_retry2.py   # 替换 3 张偏弱图片
python tools/search_commons.py             # 只检索打印候选，人工挑选

# —— 图片素材：Pexels（人像/校园/生活场景）——
python tools/fetch_pexels_candidates.py    # 下候选缩略图 + 联系表（需 Pillow）
python tools/fetch_chosen_photos.py        # 下载最终选定的高清图
python tools/make_cover.py                 # 裁 2.35:1 的 1200×510 封面

# —— 图片素材：本地自绘（需 Pillow）——
python tools/make_article_images.py        # 通用封面/示意图（公共函数库）
python tools/make_mhs_images.py            # MHS 主题
python tools/make_doubao_images.py         # 豆包主题
python tools/gen_robot_images.py           # 机器人主题

# —— 转换与预览 ——
python tools/md_to_wechat.py                                    # 默认 article.md + meta.json
python tools/md_to_wechat.py --article X.md --meta X.json --out out/X.html   # 指定其它稿件

# —— 推送草稿箱（每篇稿件独立记录草稿 ID）——
python tools/push_wechat_draft.py                       # 推送主稿，更新它自己的草稿
python tools/push_wechat_draft.py --article X.md        # 推送指定稿件（meta 自动推断）
python tools/push_wechat_draft.py --article X.md --meta Y.json  # 显式指定 meta
python tools/push_wechat_draft.py --new-draft           # 强制新建一篇草稿
python tools/push_wechat_draft.py --draft-media-id ID   # 更新指定草稿
python tools/push_wechat_draft.py --delete-draft-id ID  # 顺手删重复草稿
python tools/push_wechat_draft.py --config path.json    # 指定配置文件

# —— 发布前检查（标准库）——
python tools/check_article.py --article X.md                  # 查重 + 配图资产校验（meta 自动推断）
python tools/check_article.py --article X.md --sources references/archive   # 显式指定查重来源

# —— 参考素材（可选，需 requests+trafilatura）——
python tools/fetch_reference.py "文章URL"
python tools/analyze_reference.py

完整推荐流程：

1) 定规范：  读 SKILL.md + templates/，先出 3 个标题、定结构
2) 配接口：  cp wechat-config.example.json wechat-config.json   # 填 AppID/AppSecret + 加 IP 白名单
3) 备图片：  python tools/fetch_real_images.py / fetch_chosen_photos.py   # 确认图片到位
4) 写文章：  编辑 article.md 与 meta.json（多源核实事实）
5) 预览：    python tools/md_to_wechat.py --article X.md           # 浏览器打开 out/X.wechat.html
6) 过合规：  按 SKILL.md 第 10 步扫违禁词，改完再进下一步
7) 推送：    python tools/push_wechat_draft.py --article X.md     # 到后台草稿箱确认（发布员只发草稿，不群发）

• wechat-config.json 含 AppSecret，不要发到群里、不要提交到公开仓库、不要截图展示。
• 本工程已用 .gitignore 忽略它；若把整个文件夹复制给别人，注意别把配置文件一起带出去。
• 若怀疑 AppSecret 泄露，立即登录公众号后台「基本配置」重置 AppSecret（旧值即刻失效）。
• 所有接口调用均使用微信官方接口（api.weixin.qq.com）；正文图片必须来自 media/uploadimg 返回的 mmbiz.qpic.cn 链接，外部图链会被微信过滤。
• 推送成功后仍建议到公众号后台人工确认一遍再发布。