---
name: 分发-微信订阅号
description: 用于将“微信订阅号/”目录内指定章节批量上传到微信公众平台（订阅号）后台并保存为草稿。支持按 README.md 读取账号、密码、作者笔名、小说名称与微信书籍ID，自动执行登录、获取本次会话 token、按新建/修改分流填写标题与正文、完成文章设置（作者有话说/原创声明/合集）并保存草稿，同时回写文章Id到分发记录。关键词：微信订阅号上传、公众号发布、保存草稿、批量传章、原创声明、合集。
argument-hint: 给我 chapterPath 或 chapterPaths（位于“微信订阅号/”目录），我会按 README.md 的账号与书籍信息逐章上传并保存草稿，同时回写文章Id。
---

# 上传指定章节到微信订阅号并保存草稿

用于把你指定的 1 章或多章，上传到微信公众平台对应账号下，并全部保存为草稿。

## 何时使用

- 你已经把待上传章节放入 `微信订阅号/` 目录。
- 你已经在 `微信订阅号/README.md` 写好账号、密码、作者笔名、小说名称等信息。
- 你希望按固定流程自动完成：登录 → 获取本次 token → 判断新建/修改模式 → 填写标题与正文 → 文章设置 → 保存为草稿 → 回写文章Id。

## 不适用情形

- 你只想做文本润色，不需要打开网站上传。
- 你没有提供微信订阅号账号或必要元数据。
- 目标不是“保存为草稿”，而是“直接群发/发布”。

## 输入前置要求（强制）

### 1) 章节文件目录

- 待上传文件必须放在 `微信订阅号/` 下。
- 你会明确指定要上传哪些章节（可单章，可多章）。
- 章节标题**不以文件名直接照抄为准**，必须从章节文件内容中提取并规范化后填写到页面标题框。

### 1.1) 章节标题提取与组装规则（强制）

- 必须从章节文件中提取：章节号（阿拉伯数字）、章节标题、正文、作者有话说。
- 微信订阅号标题是**单一输入框**，最终填入值必须是完整字符串：`第{绝对章节号}章 {章节标题}`。
- `章号` 与 `标题` 之间必须保留 **1 个空格**，例如：`第1章 天降奇缘`。
- 若提取到的标题行只有标题文本（如 `天降奇缘`），则必须自动组装成 `第{绝对章节号}章 天降奇缘`。

### 2) 元数据来源

- 必须读取 `微信订阅号/README.md`，至少提取以下信息：
  - 微信订阅号用户名
  - 微信订阅号密码
  - 作者笔名（用于原创声明）
   - 微信书籍ID（按“书籍Id判定规则”选取当前章节对应值）
   - 小说名称（小说书名候选；最终以“书名判定规则”确定合集匹配名）

### 3) 分发记录来源（强制）

- 必须读取 `微信订阅号/分发记录.md`：
  - 若文件不存在，先创建后再执行分发。
  - 用于查询“章节 -> 文章Id”映射，判定该章是“新建模式”还是“修改模式”。

### 4) 书名判定规则（强制）

- 微信订阅号目录中的“小说名称”即小说书名。
- 若小说无分部：小说书名使用该平台目录 `README.md` 中的“小说名称（小说书名）”。
- 若小说有分部（多部）：小说书名使用该章节所在分部的分部名。

### 4.1) 书籍Id判定规则（强制）

- 若小说无分部：书籍Id使用该平台目录 `README.md` 中与“小说名称（小说书名）”成对维护的书籍Id。
- 若小说有分部（多部）：书籍Id使用该章节所在分部名对应成对维护的书籍Id。
- 禁止把总书名对应书籍Id用于分部章节，或把分部书籍Id用于非对应分部章节。

### 5) `分发记录.md` 模板（首次创建直接使用）

```markdown
# 微信订阅号分发记录

> 用途：记录“章节唯一键 -> 微信文章Id”映射，供分发流程判断“新建模式/修改模式”。

## 字段说明

- `章节唯一键`：固定格式 `微信书籍ID|分部名|绝对章号|章名`（无分部时分部名填 `NA`）
- `微信书籍ID`：对应 `微信订阅号/README.md` 中书籍ID
- `文章Id`：微信编辑地址中的 `appmsgid` 参数（纯数字）
- `最近操作`：`新建` 或 `修改`
- `更新时间`：`YYYY-MM-DD HH:mm:ss`
- `备注`：可选

## 记录表

|章节唯一键|微信书籍ID|文章Id|最近操作|更新时间|备注|
|:--|--:|--:|:--|:--|:--|
```

### 6) `README.md` 模板（首次创建直接使用）

当 `微信订阅号/README.md` 不存在时，必须按以下模板创建：

```markdown
# 微信订阅号分发配置

> 用途：存储微信订阅号账号、书籍信息与合集映射。分发流程将读取此文件。

## 账号信息

- 用户名：`your_username`
- 密码：`your_password`

## 作者信息

- 作者笔名：`笔名`

## 书籍信息

### 无分部小说

| 小说名称 | 微信书籍ID |
|:--|--:|
| 作品名 | 11997642 |

### 有分部小说

| 分部号 | 分部名 | 微信书籍ID |
|:--|:--|--:|
| 第1部 | 分部一书名 | 11997642 |
| 第2部 | 分部二书名 | 11997643 |

## 合集映射

| 小说名 / 分部名 | 目标合集名 |
|:--|:--|
| 作品名 | 合集名称 |

## 字段说明

- `小说名称` / `分部名`：必须精确匹配 SKILL 中的"书名判定规则"
- `分部号`：必须使用 `第N部` 规范格式（如 `第1部`、`第2部`），并与 `分部名` 一一对应，不得错位或复用
- `微信书籍ID`：纯数字，从微信公众号后台获取
- `目标合集名`：公众号已创建的合集名称

## 安全提醒

- 本文件包含明文密码，请妥善保管。
- 本文件应存入 `.gitignore`，不提交到公开仓库。
```

## 执行流程（强制按序）

### 步骤 1：读取本地输入

1. 读取并解析 `微信订阅号/README.md`。
2. 确认已获得：账号、密码、作者笔名、目标书籍Id（按“书籍Id判定规则”选取）、小说名称，并按“书名判定规则”得到本章目标小说名（用于合集匹配）。
3. 读取 `微信订阅号/分发记录.md`，建立“章节唯一键 -> 文章Id”映射（建议唯一键：`微信书籍ID|分部名|绝对章号|章名`；无分部时分部名固定为 `NA`）。
4. 读取你指定的章节文件，提取每章：卷号、章号（阿拉伯数字）、章节标题、正文、作者有话说。

### 步骤 1.5：计算绝对章节编号（不分卷口径）

1. 章节编号统一使用“绝对章节编号”口径，不使用卷内局部编号。
2. 计算方式：
   - 读取 `分发记录.md` 中同一目标书籍Id下全部已记录章节；
   - 依据 `绝对章号`排序后，计算当前章节的绝对序号。
3. 微信订阅号不分卷发布场景，章节号使用绝对章节号，计算公式为：
   - `绝对章节号 = 前面各卷章节数之和 + 该章节在所在卷的相对章号`。
4. 示例：
   - 若第1卷有90章、第2卷有100章：
   - 第1卷第5章 → 绝对章节号第5章；
   - 第2卷第5章 → 绝对章节号第95章；
   - 第3卷第5章 → 绝对章节号第195章。
5. 若 `分发记录.md` 不存在或无历史记录，则按上述公式从已知卷章结构计算；无法确定前卷章数时需先补齐台账后再发布。

### 步骤 2：登录微信公众平台

1. **必须新开一个浏览器标签页**，并在该新标签页访问：
   - `https://mp.weixin.qq.com/`
2. 该新标签页仅用于本次微信订阅号上传流程，不复用你当前正在进行其他任务的标签页。
3. 若出现未登录状态：
   - 进入登录流程，选择“使用账号登录”。
   - 输入 `README.md` 中的用户名和密码完成登录。
4. 登录后会到达首页，URL 形如：
   - `https://mp.weixin.qq.com/cgi-bin/home?t=home/index&lang=zh_CN&token={用户Token}`
5. 从当前 URL 中提取并记录本次会话 `token`：
   - 仅在本次会话中使用；
   - **不得落盘，不做持久化存储**。

### 步骤 3：新建/修改分流

1. 每章开始前，先查 `微信订阅号/分发记录.md`：
   - 若已有 `文章Id`：走**修改模式**。
   - 若无 `文章Id`：走**新建模式**。

2. 新建模式：
   - 访问：
   - `https://mp.weixin.qq.com/cgi-bin/appmsg?t=media/appmsg_edit_v2&action=edit&isNew=1&type=77&createType=0&token={用户Token}&lang=zh_CN`

3. 修改模式：
   - 访问：
   - `https://mp.weixin.qq.com/cgi-bin/appmsg?t=media/appmsg_edit&action=edit&type=77&appmsgid={文章Id}&isMul=1&replaceScene=0&isSend=0&isFreePublish=0&token={用户Token}&lang=zh_CN`

### 步骤 4：填写标题与正文

1. 在标题输入框填写：`第{绝对章节号}章 {章节标题}`。
2. 在正文编辑区粘贴该章正文。
3. 必须确保正文来自你指定的章节文件，不得错章串章。

### 步骤 5：文章设置（强制）

#### 5.1 作者有话说（最大120字）

- 在“原创”声明上方、且“拖拽或选择封面”按钮右侧的文本框填写“作者有话说”。
- 文本来源为章节文件中的“作者有话说”，并压缩到最大 120 字。

#### 5.2 原创声明（必选）

- 必须勾选“原创”声明。
- 点击后弹出浮层中：
  - “声明类型”选择“文字原创”；
  - “作者”填写 `微信订阅号/README.md` 中声明的作者笔名；
  - 点击“确定”。

#### 5.3 合集（必选）

- 必须添加“合集”。
- 在弹出浮层中输入“按书名判定规则得到的目标小说名”，并在搜索结果中选择匹配项。
- 点击“确定”。

### 步骤 6：保存草稿

1. 点击“保存为草稿”。
2. 等待页面反馈保存成功（或等价成功提示）。
### 步骤 7：新建章节提取文章Id

1. 对于新建章节，保存后会得到新的 URL，形如：
   - `https://mp.weixin.qq.com/cgi-bin/appmsg?t=media/appmsg_edit&action=edit&reprint_confirm=0&timestamp=1778422403278&type=77&appmsgid={章节Id}&token={用户Token}&lang=zh_CN`
2. 从 URL 中提取 `appmsgid` 作为新的文章Id。
3. 将“章节唯一键 + 文章Id + 更新时间”写回 `微信订阅号/分发记录.md`：
   - 若记录不存在：新增一条；
   - 若记录已存在：更新 `文章Id`（如变化）和更新时间。

### 步骤 8：多章循环

- 创建或修改更多章节时，严格循环步骤 3～8。
- 每章都必须重新校验：本次 token 是否有效、当前章节是新建还是修改。

## 关键边界与硬规则

- 必须只上传用户明确指定的章节，不得擅自扩展范围。
- 步骤 2 必须使用**新标签页**进入微信后台，禁止占用用户正在使用的原标签页。
- 作者后台入口固定为：`https://mp.weixin.qq.com/`。
- 登录后 token 每次会变化，仅可会话内使用，不得写入本地文件。
- 新建与修改 URL 必须按分发记录自动分流，禁止混用。
- 标题必须使用合并格式：`第X章 标题文本`（`X` 为绝对章节号，章号与标题之间有 1 个空格）。
- 微信订阅号不分卷，章节编号统一采用绝对章节号口径进行判定与校验。
- “文章设置”三项必须完成：作者有话说（≤120字）+ 原创声明 + 合集。
- 每章最终保存动作必须是“保存为草稿”。
- 每章保存成功后必须回写 `微信订阅号/分发记录.md`。
- 账号密码仅用于当次登录，不写入产物文件、不外泄。

## 失败与回退处理

- 登录失败：提示账号/密码错误并停止，不继续后续章节。
- 出现二次验证（验证码/扫码确认/风控）：必须立即暂停流程，等待用户手动完成验证并明确反馈“登录完成”；在收到该反馈前不得继续任何后续步骤。
- token 失效或过期：返回主页重新获取 token 后重试当前章。
- 页面元素缺失（如原创声明、合集入口改版）：记录失败步骤并停止该章。
- 合集搜索无匹配：停止保存，提示先在后台创建或确认合集名称。
- “保存为草稿”失败：本章标记失败；重试后仍失败则保留失败记录并继续下一章（除非用户要求遇错即停）。
- `分发记录.md` 写入失败：流程标记为“部分失败（记录未落盘）”，并提示人工补录。

## 实操经验沉淀（微信订阅号）

- 登录后优先确认并提取 token，再做新建/修改分流，能减少因 token 失效导致的回退。
- 先完成“原创声明 + 合集”再保存草稿，避免保存后反复补设置。
- 新建章节保存后 URL 中出现 `appmsgid`，这是回写文章Id最稳定的来源。
- 每章结束以“保存为草稿成功”提示为唯一完成信号，没有成功提示就不算完成。

## 完成检查清单

- 已读取 `微信订阅号/README.md` 并提取必需字段。
- 已登录微信公众平台并获取本次会话 token（未落盘）。
- 已在每章开始前查询 `微信订阅号/分发记录.md` 并正确区分新建/修改模式。
- 每章均完成绝对章节号计算或校验（不分卷单序列口径）。
- 每章均完成：标题、正文、作者有话说（≤120字）、原创声明、合集、保存为草稿。
- 每章保存后均已回写 `微信订阅号/分发记录.md`（含章节与文章Id映射）。
- 已输出每章结果（成功/失败及原因）。