weixin-article-to-obsidian-cnlisted

# 微信公众号文章转 Obsidian ## Overview 把微信公众号文章保存为 Obsidian 知识库里的 Markdown 文档，并把正文图片下载到本地资源目录。流程优先使用 `opencli weixin download` 获取正文，再解析页面源码补齐长图文章的图片和文章元信息。 ## 何时使用 当用户提出以下需求时使用本技能： - 提供 `mp.weixin.qq.com` 文章链接 - 要把微信公众号文章正文保存为 Markdown 笔记 - 要把文章图片下载到本地，而不是保留远程 CDN 链接 - 要使用 Obsidian 图片双链，例如 `![[assets/标题/图片.png]]` - 要把这类微信公众号剪藏流程沉淀为可重复执行的操作 ## 不要使用 以下场景不应使用本技能： - 链接不是微信公众号文章 - 用户只想提取文章视觉样式或排版主题 - 用户想把 Markdown 发布回微信公众号 - 目标不是本地 Markdown 或 Obsidian 知识库 ## 使用说明 1. 先阅读目标知识库规则，重点确认文档分类、图片资源目录、索引维护要求。 2. 根据文章主题选择语义目录。知识库已有更具体分类时，不要默认放到通用剪藏目录。 3. 如果本机有 `opencli`，先运行： ```bash opencli weixin download --url "https://mp.weixin.qq.com/s/example" --output /tmp/weixin-article --download-images true -f yaml ``` 4. 如果 `opencli` 没有抓全图片，或文章是长图页，运行本技能脚本： ```bash python3 scripts/download_weixin_article.py "https://mp.weixin.qq.com/s/example" \ --vault-root /path/to/obsidian-vault \ --target-dir "FrontEnd/安全" ``` 5. 检查生成的 Markdown，删除平台按钮、推荐阅读、打赏、重复元信息等残留内容。 6. 确认所有图片引用都指向 `assets/<文档标题>/` 下的本地文件，并使用 Obsidian 双链语法。 7. 如果知识库要求维护专题索引，把新文档以 wiki 链接加入对应索引页。 ## 脚本行为 `scripts/download_weixin_article.py` 会执行以下操作： - 优先尝试 `opencli weixin download`，在正文足够完整时复用其 Markdown 正文 - 直接抓取文章 HTML 作为兜底或补充 - 提取标题、公众号名称、发布时间、正文摘要和长图文章图片 URL - 下载图片到 `assets/<安全标题>/` - 将 Markdown 写入指定 `--target-dir` - 输出 JSON 摘要，包含文档路径、资源目录、图片数量、是否运行 opencli 常用参数： - `--vault-root`：Obsidian 知识库根目录，默认当前目录。 - `--target-dir`：知识库内的相对文档目录，默认知识库根目录。 - `--title`���覆盖自动提取到的标题，同时影响资源目录名。 - `--locale`：元信息标签语言，可选 `zh` 或 `en`，默认 `zh`。 - `--