` 里的「 - 1024 工程笔记」，但该值靠 env 传入、Makefile 没传 → 正则为空，**标题带着站名发到公众号**。已修：`config.py` 内置默认 `" - 1024 工程笔记"`，`prepare.py` 再加写法变体兜底正则（`1024\s*工程笔记`）。换站名时记得同步改这两处。 - **草稿堆积（应主动清理，勿留）**：`publish_mp.py` 每次 `sub=create` 新建草稿（不覆盖旧草稿）。反复调试会产生多个废弃草稿——**按「草稿箱清理」节处理，测试草稿当场删**；`link-map.json` 只保留最后一次的 `draft_appmsgid`。 ## 文件结构速查 | 文件 | 作用 | |---|---| | `scripts/config.py` | 路径、inline 样式常量（一律 `background-color`）、封面尺寸、超时、`ALBUMS` 合集映射 | | `scripts/prepare.py` | 内容准备（清洗/样式/SVG→PNG/cover.png/代码高亮/原文链接） | | `scripts/publish_mp.py` | **mp API 直推**（登录态/上传图+封面/创建草稿+合集/回填 link-map） | | `scripts/schedule_api.py` | 直连 `time_send` 定时发表（全字符串表单 + fingerprint，`--dry-run` 预览；先查配额） | | `scripts/schedule_ui_v2.py` | UI 定时发表（创建发布副本；headless 面板用 JS-click；`--capture-only` 停确认弹窗抓 fingerprint） | | `scripts/list_drafts.py` | 草稿箱 DOM 盘点（`.wechat-build/draft-inventory.json`） | | `scripts/cleanup_drafts.py` | 批量删除测试草稿（dry-run 默认，`--delete` 执行） | | `Makefile` | `wechat-prepare` / `wechat-publish-mp`（传 `album=`） | | `content/link-map.json` | slug → 平台草稿 ID / 永久链接映射表 | | `wechat-profile/` | Playwright 持久登录态（gitignore） | | `.wechat-build/`

` + 逐行 `

`，Hugo chroma class → Monokai inline 颜色（映射表见下）。**背景色写法见「代码块背景」坑**。 6. **`strip_leading_cover()`（2026-08-29 定规，仅 weixin 版）**：正文开头的封面重复图剥掉——博客端源稿普遍以 `` 题图开头，公众号封面正是从这同一张图裁出；平台侧推送卡片与文章详情页首屏已展示过封面，正文再以同一张图开头就是同图重复，还把首屏 150 字钩子往下挤（wechat-retention：标题+封面吃掉首屏一半）。判据=文档第一张图且沿祖先链无任何前置兄弟；首图嵌在正文间的总览图不剥。juejin 版不剥。**必须在 convert_images 之后执行——封面裁切取的是剥前的首图** 7. 文末注入原文链接段落 8. 按平台生成 `wechat-ready-{weixin,juejin}.html` + `wechat-ready.html` 产物在 `.wechat-build//`（gitignore）。 ### ⚠️ 发布前检查（防重复发布，2026-08-06 定规） **任何发布动作（建草稿/定时/群发）前必须先过防重复检查**——同一篇文章不能已上线还重发，也不能同渠道发两次： 1. **link-map.json**：slug 是否已有 `published_url`，或 `publish_status` 为 `published` / `scheduled` / `published_free_no_push`？有 → 已发布过，**拒绝重发**。 2. **公众号发表记录**：home「近期发表」/「全部发表记录」搜标题——文章已在主页（免费发布或群发都算已上线）？在 → **拒绝重发**。 3. **草稿箱**：避免对同一 slug 反复 `sub=create` 堆草稿（清理见「草稿箱清理」节）。 > 2026-08-05 事故：ai-dev-openspec-superpowers-workflow 被 schedule_ui_v2「今天」静默免费发布上主页（无推送），后又误排 08-10 定时，用户手动取消。**教训：发前必查，已上线不重发。** ### Step 3: 推送到草稿箱 + 自动发布 ```bash make wechat-publish-mp slug= # 存草稿 + 自动群发通知 make wechat-draft-only slug= # 只存草稿(留存规范推荐路径:草稿阶段补转化段再群发,亦作逃生舱) ``` Makefile 自动：`wechat-prepare`（刷新内容）→ `publish_mp.py`（全局 Python311）。**默认 headless 无窗口**（复用 `wechat-profile/` 会话，token/ticket 从首页 HTML 抠）；登录态失效或首次使用时才弹可见窗口扫码。`--no-headless` 可强制弹窗。`publish_mp.py` 流程： 1. 开 msedge，复用 `wechat-profile/` 登录态，GET mp 首页提取 `token`/`ticket`/`user_name`/`svr_time`（token 正则限定 `[A-Za-z0-9_-]`，避免误匹配未登录页的 `https://`） 2. 读 `wechat-ready-weixin.html`，把正文本地图片上传到微信图床（`cdn_url` 替换 img src） 3. **上传 `cover.png` 做封面**（见下节） 4. POST `cgi-bin/operate_appmsg?sub=create&type=77` 创建草稿（表单带 `author0=${WECHAT_AUTHOR}` + `copyright_type0=1` 文字原创）→ 返回 `appMsgId` 5. **自动群发通知**：`POST /cgi-bin/masssend`（立即群发）；今日无通知次数 → `action=time_send` 逐日顺延定时，最长 7 天，全无则失败（草稿保留） 6. 回填 `link-map.json` 的 `draft_appmsgid` + 发布状态（`published` / `pending` / `failed`） ### Step 4: 发布后核对 **自动发布 = 粉丝收到推送，不可撤销。** 建议发布前在手机端预览核对（公众号后台编辑器预览不过滤样式，会骗人；手机端才是真实渲染）。核对封面 + 代码块背景 + 排版无误后再跑 `make wechat-publish-mp`。发布后把永久链接填入 `link-map.json` 的 `published_url`。 > 想保留「先看草稿再人工发布」旧流程：用 `make wechat-draft-only slug=`，只存草稿不发布。 ## 封面自动化（2026-08-01 起，已验证） `prepare.py` 已从首图生成 `cover.png`（`COVER_SIZE=(1800,1000)`，9:5）。`publish_mp.py` 上传它并填封面字段，无需后台手动补。首图本身源自博客正文的题图，**weixin 版正文会把这张开头重复图剥掉**（见发布流程 Step 2 第 6 步），封面只在推送卡片/详情页首屏出现一次，不随正文重复展示。 **关键坑：upload_material 响应里素材 ID 的字段名是 `content`，不是 `fileid`/`id`。** 响应结构： ```json {"base_resp":{"ret":0,"err_msg":"ok"}, "location":"bizfile", "type":"image", "content":"100001138", "cdn_url":"https://mmbiz.qpic.cn/...", "ai_status":1} ``` `publish_mp.py` 按 `content` → `fileid` → `id` 顺序提取，填入草稿表单 `fileid0` / `cdn_url0` / `cdn_235_1_url0` / `cdn_1_1_url0`。 **`crop_list0` 留空**：mp 服务端会自动按 2.35:1 生成裁剪（appmsg_edit 详情验证返回 `crop_list:{ratio:2.35_1,...}`），不用手算坐标。 **验证封面是否真写进草稿**：GET 草稿详情接口，看 `file_id`/`cover`/`cdn_url` 是否有值—— ``` cgi-bin/appmsg?t=media/appmsg_edit&action=edit&type=77&appMsgId=&token=&f=json ``` 返回 `app_msg_info`（JSON 字符串），里面有 `file_id`/`cover`/`cdn_url`/`crop_list`。 > 注意：列表接口 `operate_appmsg?sub=get` 返回 `ret:2` 空列表，**不可用**；`appmsg?t=media/appmsg_list` 也返回空。查单篇只能用上面的 `appmsg_edit`。 ## 代码块背景（关键坑，已修） **公众号渲染端过滤 `background:` 简写属性（`

` 上尤甚）**——旧实现用 `

`，整块代码块在手机端变白底。 `prepare.py` `_process_code_blocks` 现在三重保险： 1. `background` → **`background-color`**（明确属性，保留率高） 2. 容器 `

` → **`section`**（公众号对 section 支持更好） 3. **每行 `

` 也带 `background-color:#334155`**（兜底：容器背景万一被剥，每行仍深色，整块不白） `config.py` 的 `INLINE_STYLES`（blockquote / `th` 表头 / `pre` / `code`）**一律 `background-color`**，禁止 `background:` 简写。 **改代码块/背景相关样式后，必须重新同步并在手机端验证**——后台预览看不出问题。 ## 代码高亮：Chroma class → Monokai 颜色 Hugo 用 chroma 以 class-based 方式生成高亮（`noClasses = false`）。公众号不支持 CSS class，`prepare.py` 把 class 转 inline 颜色： | Hugo chroma class | Monokai 色值 | 语义 | |---|---|---| | `k` `kc` `kn` `ow` | `#f92672` | 关键字 (async, def, import, True, is...) | | `o` | `#f92672` | 运算符 (=, ->, ., >=, ==) | | `bp` `nb` `nc` `ne` `nf` `fm` | `#a6e22e` | 名称 (self, 类名, 函数名, __init__) | | `n` `nn` `p` | `#f8f8f2` | 变量 / 标点 | | `s2` `sa` `si` | `#e6db74` | 字符串 | | `se` `mi` `mf` | `#ae81ff` | 转义字符 / 数字 | | `c1` | `#75715e` | 注释 | | `err` | `#960050` | 错误 | > Hugo 产物的属性无引号（``），正则兼容无引号和双引号。 ## 作者与原创声明（API 直推已支持，2026-08-01 实测）曾误判「mp API 对个人订阅号无效、需后台手填」，实测两者都可直推： - **作者**：`create_draft` 表单 `author0` 直接生效（`config.DEFAULT_AUTHOR="${WECHAT_AUTHOR}"`），编辑页 `#author` 即显示该值。 - **原创声明**：`copyright_type0="1"`（`config.COPYRIGHT_TYPE`）直接生效，草稿落库即为「文字原创」——编辑页已声明区 `#js_original_open` 显示 `display:flex`、未声明区 `display:none`。账号需 `can_use_copyright=1`（本账号已实测为 1）。验证手段：打开草稿编辑页，看 `#author` 值 + `#js_original_open` 的 display（`flex`=已声明 / `none`=未声明）。原文链接：`prepare.py` 文末自动注入完整段落（mp API 的 `sourceurl0` 不稳定）。 ## 合集挂载（2026-08-03 实证：create 时直接注入） **合集是文章普通字段 `appmsg_album_info`**（编辑器/详情返回里叫 `appmsg_album_info`，create 表单字段名是 `appmsg_album_info0`）。发布管线 `publish_mp.py` 已内置：`make wechat-publish-mp slug=` **默认挂 AI 合集**，用 `album=前端技术` / `album=碎碎念` / `album=none` 覆盖（`config.ALBUMS`）。 **关键坑：字段格式必须是富结构，简单格式会被静默忽略。** ```python # ✅ 富结构(实测生效,create 后回读 app_msg_info 确认合集已写入) {"id": "[ALBUM_ID]", "title": "AI", "album_id": [ALBUM_ID], "appmsg_album_infos": [{"id": "[ALBUM_ID]", "title": "AI", "album_id": [ALBUM_ID], "appmsg_album_infos": [], "tagSource": 0}]} # ❌ 简单格式(字段名对了也白搭,服务端忽略) {"appmsg_album_infos": [{"id": "[ALBUM_ID]", "title": "AI"}]} ``` `publish_mp.py` 的 `build_album_field()` 生成富结构。调试时踩过的字段名全无效：`appmsg_album_info`（无下标）、`audio_info` / `audio_info0`（前端用它承载过合集，但 create 直传不生效）。 **合集 ID**（`appmsgalbummgr?action=list` 实测）：AI=`[ALBUM_ID]`、前端技术=`[ALBUM_ID]`、碎碎念=`[ALBUM_ID]`。 **验证方式**：读草稿详情 `appmsg?t=media/appmsg_edit&action=edit&type=77&appMsgId=&f=json` → `app_msg_info`（JSON 字符串）→ `item[0].multi_item[0].appmsg_album_info.appmsg_album_infos` 看是否含目标 id。 > 已存在的草稿补合集，仍只有两条路：① 人工在 mp 后台编辑器选（headless 保存无法持久化，6 种方式全失败）；② 重新走 `sub=create` 复制（需先取消原排期再重排）。见 memory `wechat-album-set-mechanism`。 ## 自动发布与顺延（2026-08-01 实测） `publish_mp.py` 存草稿后自动群发通知。接口（从 JS bundle 实证）： | 动作 | 接口 | payload 要点 | |---|---|---| | 立即群发 | `POST /cgi-bin/masssend?t=ajax-response` | `{msgid: , sync_version: 1}` | | 定时群发 | `POST /cgi-bin/masssend?action=time_send` | 全字符串表单编码，含 `fingerprint`/`random`/`token`/`operation_seq`/`req_id`/`req_time`/`direct_send=1`/`isFreePublish=false`。见下方「time_send 直连」 | | 取消定时 | `POST /cgi-bin/masssendpage?action=cancel_time_send` | 表单：`id=<数字>` + `fingerprint` + `token` + `lang=zh_CN` + `f=json` + `ajax=1`。**注意：`{id:"..."}` JSON 包会被拒(ret:1)** | | 状态回查 | `GET /cgi-bin/check_publish_status` | `{msgid, publish_type:1}` | ### time_send 直连（schedule_api.py，2026-08-03 修复 67011/-1 根因） `publish_mp.py` 的 mass_send() 只带 `{msgid, sync_version}`，**不适用于 time_send**——定时发表必须完整复刻前端 masssend 弹窗的请求，缺字段直接 67011/-1： - **必带 `fingerprint`**：masssend 系 API（time_send / check_ad / check_hot_time）账号级稳定值，**仅在打开群发弹窗时由前端生成，无法从页面加载/全局对象/cookie/HTML 提取**（曾误抓资源 hash `06fcd5b9...` 当 fingerprint → ret -1）。值在 `config.MASS_SEND_FINGERPRINT`（2026-08-03 两次 UI 运行 + 0807 日志均一致）。若 API 再报 67011/-1 → 微信轮换了 fingerprint → 跑 `schedule_ui_v2 --capture-only` 从日志抓新值。 - **必须全字符串表单编码**（Playwright `form=`，`Content-Type: application/x-www-form-urlencoded`）；布尔/数字混用会被拒（`data=` 发 JSON 是 67011 的另一个根因）。 - `direct_send=1` 缺失直接 67011；`isFreePublish` 必须小写字符串 `"false"`（布尔 False 序列化成 `"False"` 服务端不认）。 - `operation_seq` 从 `masssendpage?f=json&preview_appmsgid=` 拿（每次会话变）；`req_id` 32 位随机字母数字；`req_time` 毫秒+`client_time_diff`。 - 直连前**必须先查配额**（`quota_detail_list`，`quota:0` = 已被排期占用，`original_quota`=上限），无配额日期 time_send 会被拒。`schedule_api.py` 内置此检查，`--dry-run` 只打印 payload 不提交。 ### 定时取消与权威核验（2026-08-29 实证） - **取消定时走 API，不走 UI 气泡**：`cancel_time_send` 表单 `id` = **masssend 定时记录 id**（不是草稿 appMsgId），来源见下条 timesend_msg。实测 form 直推 ret=0，一击即中。**首页「定时发表」面板的取消气泡是每卡预渲染的**——盲点 JS「确认」会点中错误卡片的气泡（2026-08-29 事故：想取消 QKV 卡，误把总抢跑卡的定时取消了）。UI 取消必须「记录触发点坐标→点最近确认→复核列表」三步走全。 - **权威核验通道 = 首页 HTML 内嵌 `wx.cgiData.timesend_msg`**：GET 首页后正则提取（`timesend_msg\s*:\s*"(.*?)",\s*\n`，反转义后 JSON.parse），`sent_list[]` 含全部定时条目的 `msgid`（=cancel_time_send 的 id）/`sent_info.time`/`appmsg_info[].title`。改完约 1 分钟后可查到新状态，无面板窗口限制。 - **⚠️ 首页「定时发表」面板模板是 `v-show="show || index < 2"`——DOM 里永远只渲染前 2 条**，滚动/等待都出不来。面板只适合看最近两档；全量排期一律走 timesend_msg。 - **schedule_ui_v2 的「发表」按钮坐标兜底（已并入脚本）**：编辑器底部「发表」不是 button/a 元素，`get_by_text` 可能全不可见——按「文本恰为『发表』的最内层元素」scrollIntoView 后 `mouse.click` 坐标点击（2026-08-29 五级文实证，无兜底时两次重试全挂在「无可见发表」）。 - **time_send 抓包判定会漏报**：三次定时实际成功但脚本报「未检测到 time_send/未确认发布动作」（confirm 链抓包窗口错过）。**以 timesend_msg 列表为准**，脚本报失败先核验再重跑，盲目重跑会多堆一个发布副本。 ### UI 定时发表会创建发布副本（schedule_ui_v2.py，2026-08-03 实证） `schedule_ui_v2.py`（`python -m scripts.wechat.schedule_ui_v2 <日期文案> `）走 UI：编辑器→发表→定时发表开关→日期/时间→发表→继续发表确认循环。成功率高，但机制有坑： - **每次定时都 `sub=create` 一个新「发布副本」，原稿留草稿箱、副本离箱排期**（100001177→100001246、100001271→100001273 实证）。副本不可在后台手动编辑合集。 - **取消定时 = 副本回草稿箱**：`cancel_time_send` 后副本回到草稿箱（100001159、100001248 实证），可再删或重新排。校验副本身份勿信面板文案，用草稿箱盘点核对。 - **headless 定时面板部分 li 隐藏**：`page.hover()`/`link.click()` 报 "element is not visible"，用 `page.evaluate` JS click（`link.click()` / `btn.click()`）触发 Vue handler。点击取消后页面会跳转，销毁 execution context——校验状态需重新加载页面再查。 - **合集继承**：`sub=create` 副本从原稿继承 `appmsg_album_info`——原稿带合集则副本带（DeepSeek），原稿不带则副本不带（CcSwitch 100001199→100001248 无合集）。给已排副本补合集的唯一可靠方式：「原稿先挂合集（人工或 create 注入）→ 取消旧排期 → 重新定时」。 - **删除原稿/副本不影响已排期副本**：cleanup 删 100001271 后，其副本 100001273 的排期仍有效（实证）。 - **⚠️ 禁止定时「今天」（2026-08-05 事故）**：前端 dayChange 对「今天」降级为 `isFreePublish=true` 免费发布——文章**静默上主页、无粉丝推送**，走即时 masssend 不走 time_send，脚本 time_send 检测永远不触发 → 空响应「假失败真发布」（草稿 100001282 被免费发布上主页，挂太久无法撤回）。`schedule_ui_v2.py` 已加硬守卫 `is_today_label` 拒绝「今天/今日/当天日期」，**只允许定时未来配额日**（isFreePublish=false 群发通知）。真今天发需即时群发（暂不可靠）。教训：**空响应 ≠ 失败**，发布后查 home「近期发表」核对真实结果。 **已发文章删除与免费发表的直连 API 均不可靠（2026-08-31 codex-auto-video-editing 实证，用户手动操作才成功）**：① `appmsgpublish?sub=delete_submit` 带 `article_id` 返回 ret:0 + 完整 publish_page——看似成功实则**静默无效**（60s 后复验条目仍在），ret:0 是页面渲染不是删除动作，别信；② 免费发表 `masssend?is_release_publish_page=1&isFreePublish=true` 直连 ret:-1 真失败（同 time_send，缺弹窗态字段）。**两条都走后台 UI 手动操作**：发表记录→卡片「删除」；草稿→发表→次数用尽时选发布（不推送）。核验认 `appmsgpublish` 条目的 `is_deleted` 标志——API 列表会连同已删除条目一起返回，按「标题存在」判断会误判；且并发期用户手动操作与脚本动作要分清归因。 - **⚠️ 「继续发表」即使选了未来日期也可能走免费发布（2026-08-16 事故）**：double_check 弹窗确认时，mp 在部分状态下（弹窗链路切到发布页变体）会把请求发成 `masssend?t=ajax-response&is_release_publish_page=1` + `isFreePublish=true`——即使表单里带着未来 `send_time`。后果是**同一篇文章一次群发通知、一次免费发布，重复上线**，且界面像失败（响应为空）。**已修**：`schedule_ui_v2.py` 现用 `page.route` 熔断，凡 `masssend` 且 body 含 `isFreePublish=true` 一律 abort，脚本走到「未检测到 time_send」报错退出、草稿保留可安全重跑。**铁律：定时成功的唯一判据是抓到 `action=time_send` 且 `isFreePublish=false`、ret:0**；跑完必查「发表记录」页有无意外新条目。 - **编辑器每次点「发表」都会自动另存一个新 appMsgId（2026-08-16 实证）**：进编辑器点「发表」即 `sub=create` 副本（428→448/470、404→459、411→464…），**失败重跑 N 次就堆 N 个副本**。本轮 5 篇排期在草稿箱堆了 18+ 条废稿。流程纪律：批量定时后**必须** `list_drafts` → 更新 link-map keep-set（成功排期的新 id 记入 `scheduled_appmsgid`）→ `cleanup_drafts --delete`；失败重试前先盘点，别盲目重跑。 - **登录态短效（<1 天）**：mp 会话隔夜即踢（页面 `t:""`/`ticket:""` 即失效）。批量长流程跑前先 `get_token` 校验；失效需弹窗重扫码，一次扫码窗口给足 15 分钟并在终端明确提示。 **顺延语义**：个人订阅号每日群发 1 次（通知次数）。立即群发失败（无通知次数/可顺延错误）→ 逐日尝试 `send_time=明天/后天/…`，最长 `PUBLISH_RETRY_DAYS=7` 天，全无则抛「7 天内均无通知次数」，草稿保留。 **不可顺延错误**（内容违规 10806 / 非法外链 412 / 素材不可群发 64006 等）：直接失败，不白试 7 次。见 `NON_RETRYABLE_RET`。 **扫码**：群发/定时设置若触发风险操作保护，会报「需要扫码」。到后台「设置与开发→安全中心→风险操作保护→群发消息」关闭可免扫码。 **测试草稿可回滚**：`operate_appmsg sub=create` 建草稿 → `sub=del` 删（`{AppMsgId}`），实测全链路可逆，不影响生产。 ## 草稿箱清理（测试草稿一律删除） **规则（用户 2026-08-03 明确）：调试/测试创建的草稿用后必须删除，不留堆积。** 草稿箱曾堆到 53 条（38 条 DeepSeek 副本 + OpenSpec/CcSwitch 副本），全部是反复调试 `sub=create` 的产物。清理工作流（安全优先，删前必盘点）： ```bash python -m scripts.wechat.list_drafts # 1. 盘点全部草稿 → .wechat-build/draft-inventory.json python -m scripts.wechat.cleanup_drafts # 2. dry-run,打印将删除清单 python -m scripts.wechat.cleanup_drafts --delete # 3. 真正删除 ``` - **`list_drafts.py`**：草稿箱列表页 DOM 枚举（滚动触发加载全部）。**反例：`appmsg?action=list_card` 等接口 ctx.request 直调会被风控静默返回空**，必须走页面。草稿箱 URL = 首页「草稿箱」菜单项（`cgi-bin/appmsg?action=list_card&type=77&begin=0&count=10`），卡片 `.weui-desktop-card[data-appid]`。 - **`cleanup_drafts.py`**：保留集 = `link-map.json` 全部 `weixin.draft_appmsgid`/`scheduled_appmsgid`（正式文章/排期稿）+ 显式补的 4 个排期原稿（100001177/100001182/100001191/100001199）。其余一律删。删除用 `operate_appmsg?sub=del`（最小 payload：`{AppMsgId, count}` 即可，实测 ret=0）。 - **删除前必须确认排期**：定时发表的稿件有的会离开草稿箱（100001246/100001248 不在箱内）、有的仍在箱内（100001182/100001191 在箱内且排期有效）。删前先看首页「定时发表」面板，确认没有排期指向待删 ID。 - **排期副本与箱内原稿是两回事**：副本离箱排期，删除箱内原稿（或另一副本）不影响已排期副本（cleanup 删 100001271 后 100001273 排期仍有效，实证）。取消定时后副本回箱，此时删掉才安全。 ## 已知坑位 - **Windows 编码**：Makefile `wechat-publish-mp` / `wechat-prepare` 均设 `PYTHONIOENCODING=utf-8`，勿删。Python 子进程、JSON 请求、终端 print 中文都要显式 utf-8。 - **msedge channel**：见前置条件，Chrome 损坏，禁用 chrome/内置 chromium。 - **背景白**：见「代码块背景」，任何 `background:` 简写都会被过滤。 - **公众号 2 万字上限**：`config.py` `WECHAT_MAX_CHARS = 20000`，prepare 超限 warn。 - **标题残留站名后缀（2026-08-16 事故）**：`prepare.py` 靠 `SITE_NAME_SUFFIX` 去掉 `` 里的「 - 1024 工程笔记」，但该值靠 env 传入、Makefile 没传 → 正则为空，**标题带着站名发到公众号**。已修：`config.py` 内置默认 `" - 1024 工程笔记"`，`prepare.py` 再加写法变体兜底正则（`1024\s*工程笔记`）。换站名时记得同步改这两处。 - **草稿堆积（应主动清理，勿留）**：`publish_mp.py` 每次 `sub=create` 新建草稿（不覆盖旧草稿）。反复调试会产生多个废弃草稿——**按「草稿箱清理」节处理，测试草稿当场删**；`link-map.json` 只保留最后一次的 `draft_appmsgid`。 ## 文件结构速查 | 文件 | 作用 | |---|---| | `scripts/config.py` | 路径、inline 样式常量（一律 `background-color`）、封面尺寸、超时、`ALBUMS` 合集映射 | | `scripts/prepare.py` | 内容准备（清洗/样式/SVG→PNG/cover.png/代码高亮/原文链接） | | `scripts/publish_mp.py` | **mp API 直推**（登录态/上传图+封面/创建草稿+合集/回填 link-map） | | `scripts/schedule_api.py` | 直连 `time_send` 定时发表（全字符串表单 + fingerprint，`--dry-run` 预览；先查配额） | | `scripts/schedule_ui_v2.py` | UI 定时发表（创建发布副本；headless 面板用 JS-click；`--capture-only` 停确认弹窗抓 fingerprint） | | `scripts/list_drafts.py` | 草稿箱 DOM 盘点（`.wechat-build/draft-inventory.json`） | | `scripts/cleanup_drafts.py` | 批量删除测试草稿（dry-run 默认，`--delete` 执行） | | `Makefile` | `wechat-prepare` / `wechat-publish-mp`（传 `album=`） | | `content/link-map.json` | slug → 平台草稿 ID / 永久链接映射表 | | `wechat-profile/` | Playwright 持久登录态（gitignore） | | `.wechat-build/` | 构建产物（gitignore） |