> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# 怎样只用公众号列表生成 RSS，并迁移旧阅读器订阅？

> 用已取得的标题、链接与摘要制作订阅源，保留旧订阅并核对阅读器里的新条目。

只想在阅读器里追新文章，用 `wechat_mp.v2.fetch_account_articles` 返回的公众号文章列表里的标题、链接和已有摘要生成 `wechat.xml`，把 `wechat.xml` 放到阅读器能访问的 HTTPS 地址，再订阅这个地址。每次刷新只为实际翻过的列表页付费。想在阅读器里看更多正文，再给入选文章走[正文摘录版 RSS](/zh/guides/wechat-to-rss)。

## 先为一个公众号生成列表快照

1. 按[增量检查](/zh/guides/wechat-incremental-articles)，用已确认的 `username` 调用 `wechat_mp.v2.fetch_account_articles`，传 `raw:false`。
2. 保存成功扫描的 `state.json` 和 `coverage.json`，在 `coverage.json` 里核对账号、页数和停止原因。
3. 试迁时选两篇旧文章和一篇当前文章，记下每篇文章在列表里的 `app_msg_id`、`idx`。
4. 需要每天更新时，用同一个账号从第一页开始，按本轮游标逐页查看，并设页数上限。

一次读取失败时保留已发布的订阅源不动，等下一次扫描成功后再更新。

如果团队只想知道「今天发了什么」，用列表标题、原文链接和已有摘要就能生成订阅项。比如新文标题是《安装手册更新》，读者在 RSS 里点开这一条，就进入微信原文。需要直接在阅读器里看到正文摘录时，再给入选文章走[正文摘录订阅](/zh/guides/wechat-to-rss)。

## 把选中文章转成 RSS 输入

1. 从[双源 RSS 指南](/zh/guides/trendradar-social-feeds)保存 `make_feed.py`。`make_feed.py` 接收一个含 `items` 的 JSON 文件。
2. 把下方适配器保存为 `wechat_feed_input.py`。`wechat_feed_input.py` 从上一节的 `state.json` 取指定的文章键，生成 `make_feed.py` 需要的 `items` 输入。
3. 运行 `wechat_feed_input.py`，参数依次填状态文件、订阅源首页的 HTTPS 地址和要发布的文章键：

```bash
python3 wechat_feed_input.py state.json https://feeds.example.com/ 11801:1 11802:1 11803:1 > wechat-items.json &&
python3 make_feed.py wechat-items.json wechat.xml
```

```python
import json
import sys
from pathlib import Path
from urllib.parse import urlsplit

state_path, homepage, *selected = sys.argv[1:]
if not selected or len(set(selected)) != len(selected):
    raise SystemExit("Supply one or more distinct app_msg_id:idx keys")
state = json.loads(Path(state_path).read_text(encoding="utf-8"))
account = state["username"]
articles = {f"{row['app_msg_id']}:{row['idx']}": row for row in state["articles"]}
items = []
for key in selected:
    if key not in articles:
        raise SystemExit(f"Article key unavailable: {key}")
    row = articles[key]
    link = urlsplit(row["url"])
    if link.scheme != "https" or link.hostname != "mp.weixin.qq.com" or link.username:
        raise SystemExit(f"Verify the source link for {key}")
    items.append({
        "id": f"wechat:{account}:{key}",
        "title": row["title"],
        "url": row["url"],
        "excerpt": row.get("digest") or "",
    })
print(json.dumps({
    "title": f"WeChat: {account}",
    "link": homepage,
    "description": "Selected article listing excerpts",
    "items": items,
}, ensure_ascii=True, indent=2))
```

`wechat_feed_input.py` 把 `digest` 按原响应传给阅读器，文章没有 `digest` 时省略。`wechat_feed_input.py` 不输出发布时间，避免把查到文章的日期当作发文日期。需要按时间筛选时，先核对 `create_time` 的实际时间单位和时区，再填写生成器支持的 `published_at`。

## 旧订阅怎么试迁？

1. 保留旧订阅的 OPML 和能取得的旧 feed XML。
2. 比较两篇同时出现在旧源和 `wechat.xml` 里的文章的 `link` 和 `guid`。`wechat_feed_input.py` 默认用账号和文章键生成稳定 ID。若目标阅读器依赖旧 ID，确认两边指向同一篇原文后，把本次输入里的 `id` 换成对应的旧 `guid`，并保存这份对应关系供后续生成继续使用。
3. 链接里有私人访问令牌时，只在自己的本地记录里保留。
4. 把 `wechat.xml` 放到你自己的 HTTPS 地址，先在阅读器里新增一个测试订阅。阅读器支持导入 OPML 时，复制下面的 OPML，替换 `xmlUrl`。

OPML 只记录订阅地址，已读状态能否迁移取决于具体阅读器。

```xml
<opml version="2.0">
  <head><title>WeChat trial subscription</title></head>
  <body>
    <outline text="WeChat research" type="rss"
             xmlUrl="https://feeds.example.com/wechat.xml" />
  </body>
</opml>
```

### 试迁三篇文章，看到什么才切换？

| 发布新源后看到的情况         | 怎么判断和处理                                                                |
| ------------------ | ---------------------------------------------------------------------- |
| 两篇旧文和当前文章都能打开      | 点开一条，确认进入原公众号文章。只有摘要的条目，能看到摘要和原文链接就够了。                                 |
| 相同三篇重新生成后又出现在未读里   | 先比较同一订阅地址下两次 XML 的 `guid` 和 `link`。如果 XML 没变，再看阅读器是否把旧地址和测试地址当作两个独立订阅。 |
| 加入一篇新文并刷新，只有这篇新文新增 | 切换到新订阅。若想保留旧源中的历史或已读标记，先确认阅读器的迁移能力并备份，再停用旧源。                           |

例如订阅 5 个公众号，每天各检查一页，30 天就是 150 次列表请求。翻页和正文详情按实际次数另计。见 [BeatAPI 价格页](https://beatapi.io/zh/pricing)。

[RSS 规范](https://www.rssboard.org/rss-specification) · [OPML 规范](https://opml.org/spec2.opml)