[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-76119":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":15,"stars7d":16,"stars30d":17,"stars90d":15,"forks30d":15,"starsTrendScore":15,"compositeScore":18,"rankGlobal":9,"rankLanguage":9,"license":19,"archived":20,"fork":20,"defaultBranch":21,"hasWiki":22,"hasPages":20,"topics":23,"createdAt":9,"pushedAt":9,"updatedAt":24,"readmeContent":25,"aiSummary":26,"trendingCount":15,"starSnapshotCount":15,"syncStatus":14,"lastSyncTime":27,"discoverSource":28},76119,"opencli-weixin-album","SlowGrowth1314\u002Fopencli-weixin-album","SlowGrowth1314","opencli plugin — 获取微信公众号合集（Album）的所有文章列表，生成 Markdown 索引文件。",null,"TypeScript",196,19,163,2,0,1,22,3.9,"MIT License",false,"main",true,[],"2026-06-12 02:03:40","# opencli-weixin-album\n\nopencli plugin — 获取微信公众号合集（Album）的所有文章列表，自动下载全部文章（含图片），生成带本地路径的 Markdown 索引文件。\n\n## 功能\n\n- 自动获取合集全部文章链接（无需 Cookie，直接调用微信 API）\n- 自动逐篇下载文章内容和图片（复用 `opencli weixin download`）\n- **增量下载**：自动检测已有索引，跳过已下载的文章，只下载缺失的\n- 生成 Markdown 索引文件，下载完成后自动回写本地路径\n- 每次翻页\u002F下载间隔 1-3 秒随机暂停，避免触发限流\n\n## 前置要求\n\n- Node.js >= 18\n- [opencli](https:\u002F\u002Fgithub.com\u002Fjackwener\u002Fopencli) >= 1.3.3\n- **Chrome 浏览器** + **opencli Browser Bridge 扩展**（下载文章时需要）\n\n```bash\nnpm install -g @jackwener\u002Fopencli\n```\n\n## 安装\n\n```bash\nopencli plugin install github:SlowGrowth1314\u002Fopencli-weixin-album\n```\n\n安装后插件位于 `~\u002F.opencli\u002Fplugins\u002Fopencli-weixin-album\u002F`。安装过程中会自动完成 npm install、依赖链接和 TypeScript 编译。\n\n## 浏览器扩展配置（必须）\n\n下载文章需要 opencli 通过浏览器访问微信页面，必须安装并连接 Browser Bridge 扩展：\n\n### 1. 安装扩展\n\n1. 打开 Chrome，访问 `chrome:\u002F\u002Fextensions\u002F`\n2. 开启右上角 **Developer mode**\n3. 点击 **Load unpacked**\n4. 选择目录：`{node_modules}\u002F@jackwener\u002Fopencli\u002Fextension\u002F`\n   - 全局安装路径示例：`\u002FUsers\u002F{用户名}\u002F.nvm\u002Fversions\u002Fnode\u002Fv24.14.0\u002Flib\u002Fnode_modules\u002F@jackwener\u002Fopencli\u002Fextension\u002F`\n5. 确认扩展显示为 **OpenCLI v1.2.6** 且已启用\n\n### 2. 验证连接\n\n```bash\nopencli doctor\n```\n\n应该看到：\n\n```\n[OK] Daemon: running on port 19825\n[OK] Extension: connected\n[OK] Connectivity: connected in 0.3s\n```\n\n如果显示 `[MISSING] Extension: not connected`，请检查：\n- 扩展是否已在 Chrome 中启用\n- 尝试刷新扩展页面或重启 Chrome\n\n### 常见问题\n\n| 问题 | 原因 | 解决 |\n|------|------|------|\n| `zsh: permission denied: opencli` | `main.js` 缺少执行权限 | `chmod +x $(which opencli)` 或对 symlink 目标文件执行 `chmod +x` |\n| `zsh: parse error near '&'` | URL 中的 `&` 被 shell 解析 | URL 必须用引号包裹 |\n| `Package subpath '.\u002Fregistry.js' is not defined` | import 路径带了 `.js` 后缀 | 已在新版本修复，更新插件即可 |\n| `Browser Extension is not connected` | Chrome 扩展未加载或未连接 | 按上面步骤安装扩展，然后 `opencli doctor` 验证 |\n\n## 使用方法\n\n### 一键下载合集\n\n在微信中打开合集页面，复制 URL，例如：\n\n```\nhttps:\u002F\u002Fmp.weixin.qq.com\u002Fmp\u002Fappmsgalbum?__biz=MzI0NTU3NTc5Ng==&action=getalbum&album_id=4482506796406177793&scene=21#wechat_redirect\n```\n\n执行命令（**URL 必须用引号包裹**，防止 shell 解析 `&`）：\n\n```bash\nopencli weixin download-album \\\n  --url \"https:\u002F\u002Fmp.weixin.qq.com\u002Fmp\u002Fappmsgalbum?__biz=MzI0NTU3NTc5Ng==&action=getalbum&album_id=4482506796406177793&scene=21#wechat_redirect\"\n```\n\n运行输出：\n\n```\n📦 获取合集: 4482506796406177793\n📖 合集名称: 智能体设计模式\n📥 4 篇 (cursor=2247484319)\n✅ 共收集 4 篇文章链接\n📄 已生成索引: .\u002Fweixin-albums\u002F智能体设计模式\u002F智能体设计模式.md\n\n[1\u002F4] 📥 下载: 智能体设计模式 - 第一章: 让 AI 不再「一口吃成胖子」\n✅ [1\u002F4] 下载成功，已更新本地路径: ...\n[2\u002F4] 📥 下载: 智能体设计模式-第二章: 让 AI 学会看情况办事\n✅ [2\u002F4] 下载成功，已更新本地路径: ...\n...\n\n✅ 合集下载完成: 4\u002F4 篇\n📄 索引文件: .\u002Fweixin-albums\u002F智能体设计模式\u002F智能体设计模式.md\n```\n\n### 指定输出目录\n\n```bash\nopencli weixin download-album \\\n  --url \"合集URL\" \\\n  --output .\u002Fmy-articles\n```\n\n### 调整每页获取数量\n\n```bash\nopencli weixin download-album \\\n  --url \"合集URL\" \\\n  --batch-size 10\n```\n\n最大值为 20（微信 API 限制）。\n\n### 增量下载（断点续传）\n\n如果下载中断，可以直接传入已有索引文件继续下载：\n\n```bash\nopencli weixin download-album --url \".\u002Fweixin-albums\u002F智能体设计模式\u002F智能体设计模式.md\"\n```\n\n运行输出：\n\n```\n📋 增量下载模式: .\u002Fweixin-albums\u002F智能体设计模式\u002F智能体设计模式.md\n📖 合集名称: 智能体设计模式\n📊 已下载: 15 篇，待下载: 7 篇\n\n[16\u002F22] 📥 下载: 智能体设计模式 - 第十六章...\n✅ [16\u002F22] 下载成功\n...\n\n✅ 合集下载完成: 22\u002F22 篇\n```\n\n**两种触发方式：**\n\n1. **传入索引文件路径** — 直接指定 MD 文件，解析其中未下载的文章\n2. **传入合集 URL** — 如果输出目录已存在索引文件，自动检测并跳过已下载的\n\n## 输出格式\n\n在输出目录下生成以合集名称命名的文件夹，包含索引文件和各篇文章：\n\n```\nweixin-albums\u002F\n└── 智能体设计模式\u002F\n    ├── 智能体设计模式.md                          # 索引文件\n    ├── 智能体设计模式_-_第一章_让_AI_不再...\u002F      # 第一章\n    │   ├── 智能体设计模式_-_第一章_....md\n    │   └── images\u002F\n    │       ├── img_001.png\n    │       └── ...\n    ├── 智能体设计模式-第二章_让_AI_学会...\u002F         # 第二章\n    │   ├── 智能体设计模式-第二章_....md\n    │   └── images\u002F\n    └── ...\n```\n\n索引文件内容示例（本地路径列在下载完成后自动填入）：\n\n```markdown\n| # | 标题 | URL | 本地路径 | 发布时间 |\n|---|------|-----|---------|---------|\n| 1 | 智能体设计模式 - 第一章: 让 AI 不再「一口吃成胖子」 | https:\u002F\u002Fmp.weixin.qq.com\u002Fs?... | 智能体设计模式_-_第一章...\u002F....md | 2026-04-23 |\n| 2 | 智能体设计模式-第二章: 让 AI 学会看情况办事 | https:\u002F\u002Fmp.weixin.qq.com\u002Fs?... | 智能体设计模式-第二章...\u002F....md | 2026-04-25 |\n```\n\n## 参数说明\n\n| 参数 | 必填 | 默认值 | 说明 |\n|------|------|--------|------|\n| `--url` | 是 | - | 微信合集页面 URL（必须用引号包裹） |\n| `--output` | 否 | `.\u002Fweixin-albums` | 输出目录 |\n| `--batch-size` | 否 | `20` | 每次 API 请求获取的文章数（上限 20） |\n\n## 技术细节\n\n- **翻页机制**：微信合集 API 使用 cursor-based 分页，通过上一页最后一条文章的 `msgid` 和 `itemidx` 作为游标请求下一页\n- **文章列表无需认证**：合集文章列表为公开数据，无需 Cookie 或登录\n- **文章下载需要浏览器**：通过 `opencli weixin download` 调用浏览器渲染页面获取完整内容\n- **图片下载**：自动下载文章内所有图片到本地 `images\u002F` 目录，Markdown 中图片路径替换为本地相对路径\n- **限流保护**：翻页间隔 1-3 秒随机暂停\n\n## License\n\nMIT\n","opencli-weixin-album 是一个用于获取微信公众号合集（Album）所有文章并生成 Markdown 索引文件的 opencli 插件。其核心功能包括自动获取合集内的全部文章链接、逐篇下载文章内容及图片，并支持增量下载以避免重复下载已有的内容。此外，该插件通过随机暂停来防止触发限流机制。此项目基于 TypeScript 开发，需要 Node.js 18 以上版本和 Chrome 浏览器配合使用。适用于需要批量保存微信公众号专辑文章的场景，如个人知识管理或研究资料收集等。","2026-06-11 03:54:32","CREATED_QUERY"]