Skip to content
Back to search

moore-wechat-article-downloader

当用户要下载或管理微信公众号文章时使用本技能。支持订阅同步、微信收藏和链接导入;互动数据仅在用户微信短时会话有效时补充指标与精选评论。优先本地运行;不要扩展成内容改写、总结、SaaS 或云服务。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

Its scripts were only partly scanned.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/Moore-developers/moore-wechat-article-downloader with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/Moore-developers/moore-wechat-article-downloader'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/moore-developers-moore-wechat-article-downloader/badge.svg)](/listings/moore-developers-moore-wechat-article-downloader)

HTML

<a href="/listings/moore-developers-moore-wechat-article-downloader"><img src="/api/listings/moore-developers-moore-wechat-article-downloader/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 405 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: moore-wechat-article-downloader
  3. description: 当用户要下载或管理微信公众号文章时使用本技能。支持订阅同步、微信收藏和链接导入;互动数据仅在用户微信短时会话有效时补充指标与精选评论。优先本地运行;不要扩展成内容改写、总结、SaaS 或云服务。
  4. ---
  5. # 公众号归档器
  6. ## 场景判断
  7. | 用户意图 | 场景 | 入口 |
  8. |---------|------|------|
  9. | 提供了完整文章 URL | 场景 1:直接下载 | `wechat_wizard.py run "下载:<url>"` |
  10. | 给公众号名 / 样例 URL,想要历史文章 | 场景 2A:Exporter(默认) | `wechat_wizard.py run "历史文章:<名称或URL>"` |
  11. | 明确说"不登录"或"用代理" | 场景 2B:代理(备选) | `wechat_wizard.py run "代理历史:<url>"` |
  12. | 想抓评论/阅读/点赞/页面风格 | 场景 2C:微信收藏 | `wechat_downloader.py proxy-enhancer-session-start --yes` |
  13. | 管理多个公众号 / 定时同步 | 场景 3:订阅同步 | 见场景 3 |
  14. 统一入口优先。wizard 返回以下 gate 时按表处理,不要立刻降级为底层命令:
  15. | Gate | 处理 |
  16. |------|------|
  17. | `need_login` | 引导扫码 → `login-status` 轮询 → `login-complete` 恢复任务 |
  18. | `need_proxy_confirm` | 向用户确认启用系统代理 → 确认后继续 |
  19. | `need_account_choice` | 聊天中列出候选公众号 → `resume --choice "<序号>"` |
  20. | `need_article_choice` | 聊天中列出文章标题+日期 → `resume --choice "<选择>"` |
  21. 只有 wizard 返回 `blocked` 或 `failed_recoverable` 并明确给出底层命令时,才使用底层命令。
  22. ## 范围
  23. 可以做:下载公开的 `mp.weixin.qq.com` 文章、抓取历史文章列表、Exporter 扫码登录和账号管理、定时增量同步。
  24. 不要做:绕过登录/付费墙/私密内容;打印 auth-key/cookie/token;把历史列表抓取和 URL 下载混为一谈;扩展成内容改写、总结、SaaS。
  25. ## 执行护栏
  26. - **不要把命令成功等同于交付完整**:`success_count` 只表示流程没有抛错。结束前必须检查 `index.csv`、Markdown、图片目录和源页面状态。
  27. - **不要只给二维码文件路径**:生成或复用二维码后优先调用当前操作系统的默认看图程序直接打开。只有无桌面环境或系统打开失败时,才退回聊天图片展示;裸路径只能作为最后兜底。同一未完成登录会话只打开一次,二维码过期后才重新生成。
  28. - **扫码流程不能少步骤**:用户说“已扫码”后先运行 `exporter-login-qr-status`;只有状态为 `confirmed` / `ready_to_complete=true` 才运行 `exporter-login-qr-complete`。
  29. - **搜索结果必须精确匹配**:公众号搜索可能返回多个相似名称。优先选择昵称完全一致的结果,并核对简介或 alias;不要默认使用第一个模糊匹配结果。
  30. - **已有明确选择时不要重复询问**:用户已经说“最新 N 篇”或给出标题/日期时,该表达本身就是文章选择;同步后直接执行,但结束时仍要在聊天中列出日期、标题和结果。
  31. ## 场景 1:直接下载已知文章
  32. **触发**:用户提供一篇或多篇完整文章 URL,或 `.txt`/`.csv`/`.json` 文件。
  33. ```bash
  34. python3 {baseDir}/scripts/wechat_wizard.py run "下载:<url 或文件路径>"
  35. ```
  36. 重跑会跳过已成功的 URL。失败项重试:
  37. ```bash
  38. python3 {baseDir}/scripts/wechat_wizard.py retry "<task-id>"
  39. ```
  40. 下载完成后报告:成功数量、失败数量、失败 URL(如有)、`output_dir`、`index.csv`。
  41. ## 场景 2:公众号历史文章
  42. ### 2A. Exporter 模式(默认首选)
  43. **触发**:用户提供公众号名、关键词或样例文章 URL,想要历史文章列表。
  44. **优势**:API 稳定、无需代理、支持按名称搜索、一次登录 4 天有效、SQLite 持久化可复用。
  45. **边界**:Exporter 模式只做公众号搜索、历史文章同步和文章下载;不获取评论、阅读数、点赞数、收藏数、转发数等互动数据。互动数据只在代理快照模式验证通过后再提供。
  46. **带评论/互动数据的硬规则**:
  47. - 普通下载:`exporter-sync -> exporter-download`,只用于不带评论/互动数据的正文下载。
  48. - 带评论互动下载:`exporter-sync -> engagement batch download`。
  49. - 当用户需求包含“评论 / 互动 / 阅读数 / 点赞 / 在看 / 精选评论”时,禁止先调用普通 `exporter-download`。
  50. - 此时 Exporter 只负责同步文章列表、标题、日期和 URL;正文与互动数据由 `wechat-collection-sync-engagement` / wizard 的 engagement 批量任务处理。
  51. - 文章落盘只发生一次:成功拿到互动数据后生成最终 Markdown;如果某篇互动失败,再降级写正文并标记“互动数据缺失”。
  52. ```bash
  53. python3 {baseDir}/scripts/wechat_wizard.py run "获取公众号「<名称>」的历史文章"
  54. ```
  55. wizard 自动处理:检查登录 → 搜索公众号 → 同步文章 → 列出结果。
  56. **文章列表展示(强制要求)**:
  57. 抓取完成后必须在聊天中直接罗列,格式:
  58. ```text
  59. - **YYYY-MM-DD**:文章标题
  60. ```
  61. 不要只给 CSV/JSON 路径。不要只给编号,必须同时展示标题和日期。
  62. 让用户按标题关键词、日期、最新 N 篇或编号范围选择后再下载。
  63. ### 2B. 代理模式(备选)
  64. **触发**:用户明确说"不登录"或"用代理",或 Exporter 模式失败。
  65. ```bash
  66. python3 {baseDir}/scripts/wechat_wizard.py run "代理历史:<sample-article-url>"
  67. ```
  68. **硬性规则**:
  69. - 必须使用旧版历史入口:`https://mp.weixin.qq.com/mp/profile_ext?action=home&__biz=<biz>&scene=124#wechat_redirect`
  70. - 不要引导用户使用 `channels.weixin.qq.com/web/pages/mp_profile`(视频号壳页,不触发 getmsg 接口)
  71. - 启用系统代理前必须向用户确认;结束时必须用 `history-capture-finish` 恢复系统代理
  72. - 默认使用常驻本地代理 `127.0.0.1:23344`;切换公众号时不要停止代理服务,直接运行新的 `history-capture-prepare` 复用进程
  73. 告诉用户:把旧版入口发到微信文件传输助手,用桌面客户端内置浏览器打开,看到历史列表后向下滚动。
  74. ### 2C. 微信收藏(互动数据与页面保存)
  75. **触发**:用户要评论、阅读数、点赞数、收藏数、在看数、完整页面快照、公众号排版风格。
  76. 此模式保存用户当前浏览的文章,也可在短时凭证有效期内恢复同公众号已授权任务的互动同步。历史列表仍默认走 Exporter;旧代理历史列表只作为备用。只同步精选评论,不承诺全量评论或完整回复树。
  77. 批量互动任务必须使用已经同步出的文章列表和 URL 创建,不要先用普通 Exporter 下载正文。用户说“下载某公众号最新 N 篇文章的评论和互动数据”时,正确链路是:
  78. ```text
  79. exporter-sync -> engagement batch download
  80. ```
  81. 主流程不再使用 `proxy-snapshot-prepare --yes`。
  82. 每次新会话从 `23032-24045` 选择一个空闲随机端口。启动前先固定当前 upstream,再启动增强代理并切换系统 HTTP/HTTPS 代理。端口、PID、upstream 和恢复状态写入活动会话;同一会话安全重载时必须复用这些值。
  83. 启动成功后会终止旧的微信 `WeChatAppEx` WebView 进程。微信主进程和登录状态保持不变;用户下次打开文章时,微信会创建使用当前代理的新 WebView。代理增强代码安全重载后也执行同样的 WebView 重置,避免旧进程继续使用缓存页面。
  84. ```text
  85. 系统/微信 -> 127.0.0.1:<会话端口> -> 会话启动时确定的上游代理或直连 -> 外网
  86. ```
  87. 启动命令:
  88. ```bash
  89. python3 {baseDir}/scripts/wechat_downloader.py proxy-enhancer-session-start --upstream-proxy none --yes
  90. ```
  91. 如果修改了代理增强代码或需要重载,只能使用安全重载。该命令自动读取并复用活动端口与 upstream:
  92. ```bash
  93. python3 {baseDir}/scripts/wechat_downloader.py proxy-enhancer-restart --upstream-proxy none --yes
  94. ```
  95. 不要在系统代理指向活动端口时直接 `kill`、`proxy-enhancer-stop` 或 `stop && start`;这会让系统代理指向死端口。安全重载会临时恢复上游或直连,使用原端口重启,再切回活动端口。
  96. 启动后常见链路:
  97. ```text
  98. 系统/微信 -> 127.0.0.1:<会话端口> -> 启动时确定的上游代理 -> 外网
  99. ```
  100. 以下命令自动读取活动端口,不要手工猜端口:
  101. ```bash
  102. python3 {baseDir}/scripts/wechat_downloader.py proxy-enhancer-route-help
  103. python3 {baseDir}/scripts/wechat_downloader.py proxy-enhancer-check-ingress --minutes 10
  104. python3 {baseDir}/scripts/wechat_downloader.py proxy-enhancer-logs --hours 24 --limit 80
  105. python3 {baseDir}/scripts/wechat_downloader.py proxy-enhancer-video-links --hours 24 --limit 100
  106. ```
  107. 增强代理常驻期间会额外捕获公开的 `channels.weixin.qq.com` 视频号页面地址,写入 `proxy-snapshots/video-links.jsonl`。只提供页面链接,不下载视频;禁止保存或展示 `finder.video.qq.com` 临时媒体地址以及 token、ticket、exportkey、session、auth 等签名凭证。
  108. 视频号链接捕获规则:
  109. - **必须先启动再浏览**:常驻拦截只能捕获启动后的流量,不能追溯之前打开过的视频号页面。
  110. - **先确认流量进入代理**:启动后运行 `proxy-enhancer-check-ingress`;确认微信流量到达,再让用户在微信里打开视频号卡片或页面。
  111. - **只保存可复用页面链接**:仅保留脱敏后的 `channels.weixin.qq.com` 页面 URL;`finder.video.qq.com` 通常是短时签名媒体地址,不作为结果。
  112. - **没有结果不代表没有视频**:可能是页面未重新打开、流量未经过代理、链接只存在于客户端内部状态,或公开链接依赖已过滤的临时凭证。报告时必须说明是哪一层没有观察到。
  113. - **结束时恢复系统代理**:用户明确结束常驻拦截后运行 `proxy-enhancer-session-finish --yes`,避免系统继续指向已停止的本地端口。
  114. 视频下载入口:
  115. - **Exporter 直接下载**:先运行常驻增强代理并打开目标视频页完成短时媒体凭证捕获,再执行 `python3 {baseDir}/scripts/wechat_exporter.py exporter-download --account-id <id> --latest <N> --include-video --video-quality highest`。输出在账号目录 `videos/` 下,文件名前缀为 `[视频]`。
  116. - **视频号页面按钮**:常驻增强代理会尝试在 `channels.weixin.qq.com/web/pages/...` 页面注入“下载视频”按钮;按钮只在用户当前有权限播放、页面 JS 暴露 `objectDesc.media[]` 后可下载。
  117. - **无凭证必须明示**:Exporter 未发现活跃代理或匹配的短时媒体描述时返回 `needs_capture`,不得报告视频下载成功。处理方式是保持/启动 `proxy-enhancer-session-start --yes`,重新打开目标视频页,等按钮显示“下载视频”后再重跑。
  118. - **敏感字段只留内存**:`urlToken`、`decodeKey`、签名媒体 URL、Cookie 和请求头只在代理进程内短时保存和下载使用;禁止写入 SQLite、Markdown、JSONL、调试日志或聊天输出。结果只报告页面 URL、descriptor id、文件路径、大小、是否解密。
  119. - **能力边界**:不绕过私密、付费或 DRM 内容;只下载用户当前会话能播放的公开视频。加密视频会按 `decodeKey` 生成 128 KiB key stream 并 XOR 文件头,失败时标记 `failed` / `decrypt_failed`。
  120. 调试日志位于 `~/.moore/wechat-article-downloader/proxy-snapshots/debug.jsonl`,只记录脱敏事件:请求路径、响应状态、是否识别为文章页、是否注入脚本、页面脚本是否执行、按钮是否放置成功。日志只保留 24 小时;清理动作每 12 小时最多执行一次。
  121. 成功识别并注入的文章 HTML 响应必须写入 `Cache-Control: no-store`,并移除 `ETag` / `Last-Modified`,防止微信 WebView 在下一次会话继续复用未更新的注入代码。已禁用的系统代理状态视为没有 endpoint;不要保存或展示其残留的 server/port。
  122. 不要在用户点击保存后自动恢复系统代理。只有用户明确要求恢复时才运行:
  123. ```bash
  124. python3 {baseDir}/scripts/wechat_downloader.py proxy-enhancer-session-finish --yes
  125. ```
  126. 该命令先恢复系统代理,再停止并回收本次会话的随机端口进程。
  127. 用户之后正常打开公众号文章。页面加载完成后应自动出现注入按钮:顶部元信息行一个,评论区标题旁一个,点击任意一个都会保存当前文章现场。
  128. ```text
  129. 收藏到本地
  130. ```
  131. 用户点击后读取最近快照:
  132. ```bash
  133. python3 {baseDir}/scripts/wechat_downloader.py snapshot-latest
  134. python3 {baseDir}/scripts/wechat_downloader.py snapshot-list --limit 10
  135. ```
  136. 如果用户说“已保存”“处理刚才保存的快照”“整理今天保存的快照”,默认不要只处理 latest。先看快照收件箱,再把所有未处理快照归档到文章库:
  137. ```bash
  138. python3 {baseDir}/scripts/wechat_downloader.py snapshot-inbox --limit 50
  139. python3 {baseDir}/scripts/wechat_downloader.py snapshot-attach --all-unprocessed
  140. ```
  141. 归档规则:
  142. - 已下载过的文章:按 URL/微信文章参数匹配,增强数据放到对应公众号目录。
  143. - 没下载过的文章:从快照正文生成 Markdown,也放到 `~/Downloads/wechat-articles/<公众号名>/`。
  144. - 评论、阅读数、点赞数、收藏数等页面数据必须写进文章 Markdown 的 `## 页面数据` 区块;同一篇文章重复归档时替换旧区块,不重复追加。
  145. - 同一篇文章多次保存:保留每次快照,并更新 `latest.json` 和 `metrics_history.jsonl`。
  146. - 不递归复制原始快照目录;只归档结构化提取产物,避免把敏感或调试文件带进文章库。
  147. 把最近快照提取成后续处理用的结构化文件:
  148. ```bash
  149. python3 {baseDir}/scripts/wechat_downloader.py snapshot-extract latest
  150. ```
  151. 也可以指定快照:
  152. ```bash
  153. python3 {baseDir}/scripts/wechat_downloader.py snapshot-extract <snapshot-id> --output-dir <dir>
  154. ```
  155. 输出位于:
  156. ```text
  157. ~/.moore/wechat-article-downloader/proxy-snapshots/<snapshot-id>/
  158. ```
  159. 主要文件:
  160. - `snapshot.json`:DOM 快照和基础字段
  161. - `dom.html`:脱敏后的完整页面 DOM
  162. - `js_content.html`:正文 DOM
  163. - `comments_dom.html`:页面已渲染评论 DOM
  164. - `engagement_dom.html`:互动区域 DOM
  165. - `metrics.json`:阅读、点赞、在看、评论、收藏、分享的可观察结果
  166. - `network.jsonl`:脱敏后的网络响应摘要
  167. - `style_profile.json` / `style_summary.md`:页面风格摘要
  168. - `report.md`:本次快照报告
  169. `snapshot-extract` 默认输出到 `<snapshot-dir>/extracted/`:
  170. - `article.md`:正文 Markdown
  171. - `comments.json`:已加载评论文本和原始评论 DOM,`complete=false`
  172. - `comments_structured.json`:结构化评论,包含昵称、地区/时间、点赞、回复数、内容
  173. - `metrics.json`:可观察互动数据
  174. - `style_profile.json`:页面风格特征
  175. - `image_urls.json`:正文图片 URL 列表
  176. - `engagement.html`:互动区域 DOM
  177. - `report.md`:提取报告
  178. 规则:不承诺一定拿到所有互动字段;页面未暴露时必须标记 `missing`。不要保存或打印 cookie、auth-key、token、pass_ticket、key 等敏感值。
  179. 文章落盘规则:标题和 Markdown 文件名必须带 `[图文]` 或 `[贴图]` 前缀;微信 `item_show_type=8` 判定为贴图,其他文章判定为图文。贴图 Markdown 先集中输出全部图片,再输出文字内容。
  180. ### 文章类型与图片完整性
  181. - **类型判定只看微信字段**:`item_show_type=8` 是贴图;不要根据图片数量、正文长度或是否存在 `content_noencode` 猜类型。普通图文也可能包含 `content_noencode`。
  182. - **正文提取顺序**:优先使用非空 `#js_content`;为空或缺失时安全解码 `content_noencode`,禁止执行页面 JavaScript。
  183. - **贴图图片兜底**:贴图正文没有 `<img>` 时,优先读取 `share_imageinfo[].cdn_url` 中公开的 `mmbiz.qpic.cn` 原图地址。排除 `watermark_info`、`cover_url`、头像、封面和同图不同尺寸派生项,再按规范化 URL 或内容哈希去重。该兜底只用于贴图,避免普通图文误收装饰资源。
  184. - **标题来源优先级**:页面标题有效时使用页面标题;页面返回 `untitled`、空标题或删除提示时,回退到 Exporter 已同步的数据库标题。frontmatter、`index.csv` 和文件名必须一致。
  185. - **删除文章单独标记**:页面出现“该内容已被发布者删除”等提示时,不得报告为“全文下载成功”;保留历史标题和 URL,并明确标记正文不可用。
  186. - **贴图验收**:至少检查 `content_type=贴图`、`item_show_type=8`、`image_count>0`、所有本地图片存在,以及第一个图片引用位于正文内容之前。还要抽查图片确为文章内容图,不能只看数量;若 `image_count=0`,必须继续排查元数据图片清单,不能直接结束。
  187. - **图文验收**:检查标题/文件名 `[图文]` 前缀、正文非空、Markdown 图片引用对应本地文件。图片下载失败要在 `error` 中保留原因。
  188. 下载后建议按以下顺序验收:
  189. ```text
  190. 命令结果 -> index.csv 类型/数量 -> Markdown 标题与排序 -> 图片文件存在 -> 删除/风控页面检查 -> 聊天中报告真实结果
  191. ```
  192. ## 场景 3:多账号订阅 + 定时同步
  193. **触发**:用户需要长期跟踪多个公众号,希望每天自动同步并下载新文章。
  194. **已有能力**:
  195. ```bash
  196. # 搜索并添加公众号
  197. python3 {baseDir}/scripts/wechat_exporter.py exporter-search "关键词"
  198. python3 {baseDir}/scripts/wechat_exporter.py exporter-add --fakeid "<fakeid>" --nickname "<name>"
  199. # 查看已订阅的公众号列表
  200. python3 {baseDir}/scripts/wechat_exporter.py exporter-accounts
  201. # 同步单个账号文章
  202. python3 {baseDir}/scripts/wechat_exporter.py exporter-sync --account-id "<id>" --limit 200
  203. # 下载指定账号最新 N 篇
  204. python3 {baseDir}/scripts/wechat_exporter.py exporter-download --account-id "<id>" --latest 20
  205. ```
  206. ```bash
  207. # 同步所有已订阅账号(默认每个账号最新 50 篇)
  208. python3 {baseDir}/scripts/wechat_exporter.py exporter-sync-all
  209. python3 {baseDir}/scripts/wechat_exporter.py exporter-sync-all --per-account-limit 100
  210. # 下载所有尚未下载的新文章
  211. python3 {baseDir}/scripts/wechat_exporter.py exporter-download-new
  212. # 每日一键运行:sync-all + download-new(适合 cron)
  213. python3 {baseDir}/scripts/wechat_exporter.py exporter-daily-run
  214. ```
  215. 设置 cron 定时任务时,用 AI 帮用户生成 launchd plist 或 crontab 条目,指定绝对路径调用 `exporter-daily-run`。
  216. ## Exporter 登录
  217. **QR 流程(首选)**:
  218. ```bash
  219. python3 {baseDir}/scripts/wechat_exporter.py exporter-login-qr-start --open
  220. python3 {baseDir}/scripts/wechat_exporter.py exporter-login-qr-status "<login-id>"
  221. python3 {baseDir}/scripts/wechat_exporter.py exporter-login-qr-complete "<login-id>"
  222. ```
  223. **降级:手动 auth-key**(QR 不可用时):
  224. ```bash
  225. python3 {baseDir}/scripts/wechat_exporter.py exporter-login-start --open
  226. python3 {baseDir}/scripts/wechat_exporter.py exporter-config --auth-key "<auth-key>"
  227. ```
  228. 规则:扫码时必须选公众号/服务号,不要选小程序;auth-key 有效期约 4 天;不在聊天中打印完整 auth-key;auth-key 优先存 macOS Keychain。
  229. 二维码交互要求:
  230. 1. 运行 `exporter-login-qr-start --open`;命令会先复用未完成且未过期的二维码会话,只有过期后才生成新二维码,不要省略 `--open`。
  231. 2. 如果二维码没有自动打开,确认 `qrcode_path` 文件存在且为 `.png` / `.jpg` / `.jpeg`,再按平台调用系统打开命令。
  232. 3. 用户确认扫码后运行 `exporter-login-qr-status`,不要靠等待时间猜测状态。
  233. 4. 状态确认后运行 `exporter-login-qr-complete`,只向用户报告登录是否成功和有效期,不展示 auth-key 或其预览。
  234. 系统打开命令:
  235. | 环境 | 首选命令 | 备用命令 |
  236. |------|----------|----------|
  237. | macOS | `open "<qrcode_path>"` | `open "file://<absolute-path>"` |
  238. | Windows PowerShell | `Start-Process -FilePath "<qrcode_path>"` | `explorer.exe "<qrcode_path>"` |
  239. | Windows CMD | `start "" "<qrcode_path>"` | `explorer.exe "<qrcode_path>"` |
  240. | Linux 桌面 | `xdg-open "<qrcode_path>"` | `gio open "<qrcode_path>"` |
  241. | WSL | `explorer.exe "$(wslpath -w '<qrcode_path>')"` | `cmd.exe /c start "" "$(wslpath -w '<qrcode_path>')"` |
  242. 执行规则:
  243. - **本地路径优先**:二维码是本地图片,直接打开路径比转换成网页 URL 更稳定。
  244. - **禁止拼接不可信 shell 字符串**:代码实现应使用参数数组调用进程;Windows Python 优先使用 `os.startfile()`,避免 `cmd /c start` 的引号陷阱。
  245. - **无桌面环境要降级**:SSH、容器或 Linux 没有 `DISPLAY` / `WAYLAND_DISPLAY` 时不要反复调用打开命令,改为聊天展示二维码图片。
  246. - **打开后仍要提示动作**:系统窗口弹出后明确告诉用户“请用微信扫码并在手机端确认”,不能只执行命令后沉默。
  247. 本地管理页(仅用户明确要求时启动):
  248. ```bash
  249. python3 {baseDir}/scripts/wechat_exporter.py exporter-server-start --port 8765
  250. ```
  251. ## 路径和输出
  252. `{baseDir}` = 本 `SKILL.md` 所在目录,脚本位于 `{baseDir}/scripts/`。
  253. 内部会话数据:`~/.moore/wechat-article-downloader/`
  254. 默认下载目录:
  255. - URL 模式:`~/Downloads/wechat-articles/<公众号名>/`;多公众号 URL 会按公众号拆分目录
  256. - Exporter 单公众号模式:`~/Downloads/wechat-articles/<公众号名>/`
  257. - Exporter 多公众号模式:按公众号拆分为多个 `~/Downloads/wechat-articles/<公众号名>/`
  258. 输出结构:
  259. ```text
  260. index.csv
  261. articles/<safe-title>.md
  262. images/<safe-title>/<image-number>.<ext>
  263. ```
  264. URL 模式和 Exporter 模式都不再使用可见的 `<run-id>` 交付目录。`run_id` 只保存在运行记录里。Exporter 下载会先检查账号目录里的 `index.csv` 和实际 Markdown/图片文件;SQLite 标记为已下载但文件缺失时会重新下载。
  265. ## 输出约定
  266. 每次结束报告:使用的模式、成功/失败数量、失败 URL(如有)、`output_dir`、`index.csv`。
  267. 报告中的“成功”必须区分:正文完整、图片完整、源文章已删除。不要把 HTTP 请求成功或 Markdown 文件生成成功描述成“全文和图片均已获取”。
  268. Exporter 模式额外报告:auth-key 是否有效、公众号/文章数量、SQLite 路径。
  269. 历史文章模式:必须先在聊天中列出文章标题和日期,让用户选择,不要自动全量下载。
  270. 保持回复简洁,详细内容由文件承载。
  271. ## 参考文件
  272. - `references/backend-design.md`:两模式架构
  273. - `references/skill-cli-flow.md`:Skill 驱动 CLI 流程
  274. - `references/output-formats.md`:输出文件结构
  275. - `references/compliance.md`:安全和权限规则
  276. - `references/troubleshooting.md`:常见失败和处理
README.md · README · 234 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # 公众号研究助手(本地版)
  2. > **重要:自 2026 年 7 月 30 日起,微信已关闭本项目依赖的公众号后台文章列表核心接口,本项目暂时停止维护。**
  3. 内容创作者每天刷几十篇公众号文章,却常常看完就忘、难以复用;
  4. 产品经理想长期跟踪竞品选题,却苦于数据分散、评论缺失;
  5. AI 用户需要高质量语料,却缺少干净、结构化、可长期管理的本地输入。
  6. 现在,你可以把这些内容沉淀下来:
  7. - 自动同步关注的公众号文章
  8. - 保存正文、图片,以及页面实际提供的精选评论和互动数据
  9. - 转为结构化的本地资料库
  10. - 随时搜索、拆解,或交给 AI 做进一步分析
  11. **目标**:帮助内容创作者、产品研究者和 AI 用户,把零散的公众号阅读转化为系统、可积累、可复用的个人知识资产。
  12. ---
  13. ## 核心亮点
  14. - **告别信息碎片化**:把公众号文章归档成永久可搜索的本地资料库,不再依赖聊天记录和收藏夹翻找。
  15. - **补齐读者反馈**:除正文外,还可在微信短时会话有效时保存页面实际返回的精选评论、阅读、点赞、在看等互动信号。
  16. - **边看边收藏**:在微信桌面客户端打开文章时,可以通过“收藏到本地”把当前正文、已加载评论和页面数据一起归档。
  17. - **适合深度研究**:Markdown、CSV 和 SQLite 输出可直接用于选题拆解、标题分析、内容复盘和 AI 辅助研究。
  18. - **本地优先**:文章库、索引和凭据保存在本机;除访问微信文章和 Exporter 接口外,不上传到项目自建的云端服务。
  19. **一句话:把别人随手刷过的公众号,变成你可以反复使用的内容情报库。**
  20. ---
  21. ## 目录
  22. - [快速开始](#快速开始)
  23. - [适用人群](#适用人群)
  24. - [核心使用场景](#核心使用场景)
  25. - [输出文件结构](#输出文件结构)
  26. - [与普通工具的区别](#与普通工具的区别)
  27. - [安装与使用](#安装与使用)
  28. - [边界与隐私](#边界与隐私)
  29. - [开发与贡献](#开发与贡献)
  30. - [许可证](#许可证)
  31. ## 快速开始
  32. 安装到 Codex:
  33. ```bash
  34. mkdir -p ~/.codex/skills
  35. git clone https://github.com/Moore-developers/moore-wechat-article-downloader.git \
  36. ~/.codex/skills/moore-wechat-article-downloader
  37. ```
  38. 安装到 Claude Code:
  39. ```bash
  40. mkdir -p ~/.claude/skills
  41. git clone https://github.com/Moore-developers/moore-wechat-article-downloader.git \
  42. ~/.claude/skills/moore-wechat-article-downloader
  43. ```
  44. 重新打开 Codex 或 Claude Code,然后直接描述目标:
  45. ```text
  46. 同步我关注的公众号,按日期列出最近 50 篇新文章
  47. 把「某公众号」最近 20 篇文章收进本地资料库
  48. 结合最近 5 篇文章的精选评论和互动数据,判断读者真正买账的点
  49. 开启微信收藏会话,边看边把正文、评论和互动信号保存到本地
  50. 把这些公众号文章链接导入本地:https://mp.weixin.qq.com/s/xxx
  51. ```
  52. ## 适用人群
  53. - **内容创作者**:拆解选题、标题、结构和读者反馈,建立自己的素材库。
  54. - **产品经理和研究者**:长期跟踪公众号和竞品内容,比较主题与表达变化。
  55. - **知识管理用户**:把微信内容沉淀到本地资料库、Wiki 或第二大脑。
  56. - **AI 用户**:为 Codex、Claude Code 等工具准备结构化、可追溯的本地输入。
  57. ## 核心使用场景
  58. ### 1. 同步更新
  59. 适合把关注的公众号变成可持续追踪的文章列表。
  60. ```text
  61. 同步我关注的公众号,按日期列出最近 50 篇新文章
  62. 从已订阅公众号里筛出最近值得精读的 10 篇
  63. 整理最近一周的新文章,按公众号分组
  64. ```
  65. 默认只下载正文和图片,不抓取评论与互动数据。
  66. ### 2. 公众号研究
  67. 适合分析一个公众号的选题方式、内容结构和读者反馈。
  68. ```text
  69. 看「某公众号」最近 10 篇文章,判断它值不值得长期跟踪
  70. 拆「某公众号」最近 10 篇文章的选题、标题和内容结构
  71. 基于最近 20 篇文章和精选评论,提炼可以复用的选题方法
  72. ```
  73. 研究素材包括:
  74. - **正文**:作者如何立题、组织结构和表达观点。
  75. - **精选评论**:读者认同、反对或继续追问的内容。
  76. - **互动信号**:页面实际提供的阅读、点赞、在看、评论等数据。
  77. ### 3. 微信收藏会话
  78. 适合在微信里阅读时,把当前文章现场保存到本地。
  79. ```text
  80. 开启微信收藏会话,我要边看文章边保存正文、评论和互动信号
  81. ```
  82. 打开文章后点击页面里的“收藏到本地”,可以保存:
  83. - 当前文章正文和图片
  84. - 页面已经加载的评论
  85. - 页面当前暴露的互动数据
  86. - 页面结构和样式摘要
  87. 评论和互动数据依赖当前微信页面及短时有效凭据,不保证每篇文章都能获得相同字段。
  88. ### 4. 链接归档
  89. 适合把聊天记录、收藏夹或文件中的零散文章链接统一归档。
  90. ```text
  91. 把这些公众号文章链接导入本地:https://mp.weixin.qq.com/s/xxx
  92. 把群里发来的公众号文章链接按公众号归档
  93. 把一批文章链接收进本地,后面用于选题分析
  94. ```
  95. ## 输出文件结构
  96. 默认按公众号保存到:
  97. ```text
  98. ~/Downloads/wechat-articles/<公众号名>/
  99. ```
  100. 典型结构:
  101. ```text
  102. <公众号名>/
  103. ├── index.csv
  104. ├── articles/
  105. │ └── <文章标题>.md
  106. └── images/
  107. └── <文章标题>/
  108. └── 001.<扩展名>
  109. ```
  110. 本地运行状态保存在:
  111. ```text
  112. ~/.moore/wechat-article-downloader/
  113. ```
  114. 其中包括 SQLite 索引、任务状态、页面快照和脱敏后的运行记录。
  115. ## 与普通工具的区别
  116. | 维度 | 普通导出工具 | 公众号研究助手 |
  117. |---|---|---|
  118. | 产品入口 | 需要理解脚本和参数 | 直接用自然语言描述同步、研究、收藏或归档目标 |
  119. | 内容范围 | 以正文批量导出为主 | 正文、图片,以及页面实际提供的精选评论和互动信号 |
  120. | 当前页收藏 | 通常不支持 | 可在微信里边看边保存当前文章现场 |
  121. | 输出方式 | 按任务分散输出 | 按公众号维护长期 Markdown、图片和 CSV 索引 |
  122. | 本地状态 | 偏一次性任务 | 使用 SQLite 管理公众号、文章、下载和互动状态 |
  123. | 隐私边界 | 取决于具体服务 | 本地优先,不提供 SaaS 或项目自建云端托管 |
  124. 它不是“导出后就结束”的下载脚本,而是一套围绕同步、收藏、研究和归档建立的本地工作流。
  125. ## 安装与使用
  126. ### 运行要求
  127. - Python 3
  128. - 需要访问公开的微信文章页面
  129. - Exporter 历史列表需要扫码登录自己的微信公众号后台
  130. - 微信收藏和代理历史需要 macOS 微信桌面客户端、本地证书和 mitmproxy
  131. - 自动切换和恢复系统代理目前只支持 macOS
  132. ### 更新
  133. ```bash
  134. cd ~/.codex/skills/moore-wechat-article-downloader
  135. git pull
  136. ```
  137. 如果安装在 Claude Code 的 Skills 目录,把路径替换为:
  138. ```text
  139. ~/.claude/skills/moore-wechat-article-downloader
  140. ```
  141. ## 边界与隐私
  142. - 只处理用户当前有权访问的公开文章,不绕过登录、付费墙或私密内容。
  143. - 只承诺页面或接口实际返回的数据,不承诺全量评论或完整回复树。
  144. - 精选评论和互动数据依赖短时微信会话,字段可能缺失或失效。
  145. - 不打印或对外输出 cookie、token、auth-key、pass_ticket 等敏感值。
  146. - 文章库、索引和凭据保存在本机,但获取内容时仍会访问微信和配置的 Exporter 服务。
  147. - 不提供 SaaS、云端托管或内容改写服务。
  148. ## 开发与贡献
  149. 主要入口:
  150. - `scripts/wechat_wizard.py`:自然语言任务、登录和选择入口
  151. - `scripts/wechat_exporter.py`:公众号搜索、历史同步、订阅和增量下载
  152. - `scripts/wechat_downloader.py`:链接导入、微信收藏、代理历史和页面快照归档
  153. 运行离线契约测试:
  154. ```bash
  155. python3 -m unittest discover -s evals -p 'test_*contract.py'
  156. ```
  157. 相关文档:
  158. - [Skill 使用说明](SKILL.md)
  159. - [CLI 流程](references/skill-cli-flow.md)
  160. - [输出格式](references/output-formats.md)
  161. - [故障排查](references/troubleshooting.md)
  162. - [合规边界](references/compliance.md)
  163. ## 许可证
  164. 本项目使用 [MIT License](LICENSE)。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.