锤无双丨公众号文章下载

要解决什么问题

公众号后台里的历史文章分散在网页里，想整库备份、改成 Markdown 二次编辑，或按时间做增量归档时，手工逐篇保存成本高，也容易漏篇。本技能面向已发表的群发文章，把列表与正文批量落到本地，每篇同时生成 HTML 与 Markdown。

技能如何工作

核心路径是 Chrome DevTools Protocol（CDP）：脚本用 Node.js 内置模块连接本机以远程调试端口启动的 Chromium 内核浏览器（优先 Chrome，也可复用已在 9223 端口上的实例），在用户已登录的 mp.weixin.qq.com 会话里拉取文章列表，再逐篇打开页面提取正文并写入磁盘。

• 输出：默认目录下每篇文章一对 *.html（含标题、账号名、正文）与 *.md（YAML frontmatter + 正文转写）。
• 模式：首次无 .download_state.json 时等价全量；之后默认按状态文件中的 last_time 做增量；也可显式全量或 --mode since --since YYYY-MM-DD。
• 依赖：不 npm install；凭证不写进脚本，token 仅在运行时从浏览器会话读取，不落盘。

适用边界与注意点

• 必须先扫码登录公众号后台，未登录会出现 invalid csrf token 一类错误；下载过程中不要关掉调试浏览器窗口。
• 只覆盖后台「已发表」列表（如 type=9 群发），不包含草稿箱。
• 需要 Node 21+（全局 WebSocket）；中文路径与标题可正常使用。状态文件只记时间戳，不含账号密钥。