---
name: 分发-今日头条
description: 用于将"今日头条/"目录内指定章节批量上传到今日头条作者后台并保存为草稿。支持按 README.md 读取账号、密码、作者笔名、小说名称与书籍ID，自动执行登录、按新建/修改分流填写标题与正文、完成发布设置（声明首发/合集）。系统自动保存，无需手动点击保存按钮。关键词：今日头条上传、自动保存、批量传章、声明首发、合集、草稿。
argument-hint: 给我 chapterPath 或 chapterPaths（位于"今日头条/"目录），我会按 README.md 的账号与书籍信息逐章上传并自动保存，同时回写章节Id。
---

# 上传指定章节到今日头条并自动保存

用于把你指定的 1 章或多章，上传到今日头条对应账号下，系统将自动保存为草稿。

## 何时使用

- 你已经把待上传章节放入 `今日头条/` 目录。
- 你已经在 `今日头条/README.md` 写好账号、密码、作者笔名、小说名称与书籍ID等信息。
- 你希望按固定流程自动完成：登录 → 判断新建/修改模式 → 填写标题与正文 → 发布设置 → 系统自动保存 → 回写章节Id。

## 不适用情形

- 你只想做文本润色，不需要打开网站上传。
- 你没有提供今日头条账号或必要元数据。
- 目标不是"保存为草稿"，而是"直接发布"。

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

### 1) 章节文件目录

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

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

- 必须从章节文件中提取：章节号（阿拉伯数字）、章节标题、正文、作者有话说。
- 今日头条章节号与章节标题共用**一个标题输入框**。
- 最终填入值必须是完整字符串：`第{绝对章节号}章 {章节标题}`。
- `章号` 与 `标题` 之间必须保留 **1 个空格**，例如：`第1章 天降奇缘`。
- 若提取到的标题行只有标题文本（如 `天降奇缘`），则必须自动组装成 `第{绝对章节号}章 天降奇缘`。
- 标题长度必须满足平台输入框约束（通常 **2~30 字**）；超限时必须先做等义压缩，再填写，避免“看似已输入但草稿未落盘”。

### 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`：编辑地址中的 `pgc_id` 参数（纯数字）
- `最近操作`：`新建` 或 `修改`
- `更新时间`：`YYYY-MM-DD HH:mm:ss`
- `备注`：可选

## 记录表

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

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

当 `今日头条/README.md` 不存在时，必须按以下模板创建：

```markdown
# 今日头条分发配置

> 用途：存储今日头条账号、作者信息与书籍ID。分发流程将读取此文件。

## 账号信息

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

## 作者信息

- 作者笔名：`笔名`

## 书籍信息

### 无分部小说

| 小说名称 | 头条书籍ID |
|:--|--:|
| 作品名 | 11997642 |

### 有分部小说

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

## 卷名映射

### 分部一书名

| 卷号 | 卷名 |
|--:|:--|
| 1 | 第一卷 卷标题 |
| 2 | 第二卷 卷标题 |

### 分部二书名

| 卷号 | 卷名 |
|--:|:--|
| 1 | 第一卷 卷标题 |
| 2 | 第二卷 卷标题 |

## 字段说明

- `小说名称` / `分部名`：必须精确匹配 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.toutiao.com/`
2. 该新标签页仅用于本次今日头条上传流程，不复用你当前正在进行其他任务的标签页。
3. 若出现未登录状态：
   - 选择"密码登录"；
   - 输入 `README.md` 中的用户名和密码完成登录。
4. 登录后保持在今日头条作者后台。

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

1. 每章开始前，先查 `今日头条/分发记录.md`：
   - 若已有 `章节Id`：走**修改模式**。
   - 若无 `章节Id`：走**新建模式**。

2. 新建模式：
   - 访问：
   - `https://mp.toutiao.com/profile_v4/graphic/publish`

3. 修改模式：
   - 访问：
   - `https://mp.toutiao.com/profile_v4/graphic/publish?pgc_id={章节Id}`

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

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

### 步骤 5：发布设置（强制）

#### 5.1 声明首发（必选）

- 在"发布设置"中找到"声明首发"选项。
- 必须勾选"头条首发"。

#### 5.2 合集（必选）

- 在"发布设置"中点击"添加至合集"。
- 在弹窗中勾选与目标小说名称一致的合集。
- 点击"确定"。

#### 5.3 作品声明（必选）

- 在"发布设置"中找到作品声明相关选项。
- 必须勾选"虚构演绎，故事经历"。

#### 5.4 展示封面（必选）

- 在"发布设置"中找到"展示封面"选项。
- 必须选择"无封面"。

### 步骤 6：系统自动保存

1. 今日头条系统会自动保存草稿，**无需手动点击任何保存按钮**。
2. 等待页面反馈自动保存成功（通常会有"已保存"或类似提示）。
3. 建议执行双重判定：页面出现"草稿已保存"提示 + 草稿列表接口出现对应标题或新增 `gid`，两者至少命中其一才算成功。

### 步骤 7：新建章节提取章节Id

1. 对于新建章节，系统自动保存后 URL 不会立即变化，需要访问草稿箱查询：
   - 访问：`https://mp.toutiao.com/profile_v4/manage/draft`
   - 在草稿列表中找到刚才上传的文章（按标题文本匹配）。
2. 点击该文章的"编辑"按钮，跳转到编辑页面。
3. 编辑页面 URL 会显示为：
   - `https://mp.toutiao.com/profile_v4/graphic/publish?pgc_id={章节Id}`
4. 从 URL 中提取 `pgc_id` 后面的数字部分作为新的章节Id。
5. 将"章节唯一键 + 章节Id + 更新时间"写回 `今日头条/分发记录.md`：
   - 若记录不存在：新增一条；
   - 若记录已存在：更新 `章节Id`（如变化）和更新时间。

### 步骤 8：多章循环

- 创建或修改更多章节时，严格循环步骤 3～8。
- 每章都必须重新校验：当前章节是新建还是修改、发布设置是否已完成。


### 连续多章提效模式（推荐）

> 目标：在不放松现有强制规则的前提下，减少重复点击、重复粘贴与重复判定成本。

#### A. 先批量预处理，再进入浏览器连续执行

- 在打开网页前，一次性完成以下预处理：
   - 章节号 / 章节标题提取；
   - 正文与平台扩展字段拆分（如作者的话 / 发布设置文本）；
   - 平台限制预检（如标题字数、作者话字数、必选发布项）；
   - 新建 / 修改模式预判（来自 `分发记录.md`）。
- 产物建议统一放入临时队列（如内存对象或 `{平台目录}/.cache/content_parts/no_part/v{卷号}/*.txt`、`{平台目录}/.cache/content_parts/p{分部号}/v{卷号}/*.txt` + 映射表），浏览器阶段只做“取数据→填写→保存”。

#### B. 浏览器阶段采用“固定入口 + 重复节拍”

- 对于每一章，保持统一节拍：
   1) 打开目标地址（按记录走新建或修改）；
   2) 填标题；
   3) 填正文；
   4) 填平台扩展字段（如作者话/发布设置）；
   5) 保存草稿；
   6) 提取章节Id；
   7) 回写记录。
- 除“目标地址”和“填入文本”外，其余动作应尽量保持同一套定位器与顺序，避免每章临时切换策略。

#### C. 用“小批次提交”替代“整批一次性提交”

- 推荐按 `5–10` 章为一个小批次执行：
   - 每个小批次完成后立刻回写 `分发记录.md`；
   - 再进入下一个小批次。
- 这样即使遇到限流、登录态波动或页面改版，也只影响当前小批次，不会让整批进度回滚。

> D / E / F 三节统一执行口径：优先保证批次连续性与可回滚性；安全验证类提示一律按阻断处理；数据通道异常必须可降级。

#### D. 对“高频弹窗”做一次性消噪

- 对平台中反复出现的非阻塞提醒（字数提醒、教学浮层、引导弹窗），首次可消噪后继续主流程。
- 仅当弹窗真实阻断“输入/保存/提交”关键路径时，才升级为失败处理或人工接管。

#### E. 失败分层：快跳过、可续跑

- 对单章失败采用“记录原因并继续下一章”的策略（除非用户要求遇错即停）。
- 失败章需记录最小必要信息：
   - 章节唯一键；
   - 失败步骤（打开页 / 标题 / 正文 / 平台扩展字段 / 保存 / 回写）；
   - 页面关键提示。
- 批量结束后按失败清单单独补传，避免在主循环里反复卡住。

#### F. 数据通道提效（可选）

- 长批量自动化场景可选用 `scripts/content_parts_server.mjs`：
   - 无分部：`/parts/v/{卷号}/{章号}`
   - 有分部：`/parts/p/{分部号}/v/{卷号}/{章号}`
   - 平铺 `/parts/{章号}` 仅限单批次临时使用。
- 该方式是提效手段，不替代各平台 Skill 的书籍Id判定、章节唯一键、回写规则与失败处理要求。

#### G. 批量执行防误用补丁（建议默认开启）

- “新建 / 修改模式预判”仅用于提效，不得替代每章执行前对 `分发记录.md` 的实时查询。
- “高频弹窗消噪”仅限非安全类提示；涉及登录风控、验证码、实名校验、账号安全提示时，一律按阻断处理并暂停。
- 失败分层需加入“致命错误即停”：书名/卷名（或作品）不匹配、书籍ID错误、登录态异常未解除时，不得继续下一章。
- 使用数据通道（如 `content_parts_server`）时必须提供降级路径：服务不可用时自动回退到本地文件读取，不中断批次执行。
- 每个小批次结束必须执行对账复核：`计划章数 = 成功章数 + 失败章数`，且成功章均完成 `章节Id` 回写。
## 关键边界与硬规则

- 必须只上传用户明确指定的章节，不得擅自扩展范围。
- 步骤 2 必须使用**新标签页**进入今日头条后台，禁止占用用户正在使用的原标签页。
- 作者后台入口固定为：`https://mp.toutiao.com/`。
- 登录动作固定为"密码登录 + 输入用户名密码"。
- 新建与修改 URL 必须按分发记录自动分流，禁止混用。
- 标题必须使用合并格式：`第X章 标题文本`（`X` 为绝对章节号，章号与标题之间有 1 个空格）。
- 今日头条章节编号统一采用绝对章节号口径进行判定与校验。
- "发布设置"四项必须满足：声明首发已勾选 + 已添加至合集并确认 + 已勾选"虚构演绎，故事经历" + "展示封面"已选择"无封面"。
- 系统自动保存，**不需要点击任何保存按钮**。
- 新建章节保存后必须从新 URL 提取 `pgc_id` 并回写 `今日头条/分发记录.md`。
- 账号密码仅用于当次登录，不写入产物文件、不外泄。

## 失败与回退处理

- 登录失败：提示账号/密码错误并停止，不继续后续章节。
- 出现二次验证（验证码/短信验证/风控）：必须立即暂停流程，等待用户手动完成验证并明确反馈"登录完成"；在收到该反馈前不得继续任何后续步骤。
- 页面元素缺失（如"声明首发""添加至合集"改版）：记录失败步骤并停止该章。
- 合集列表无匹配：停止保存，提示先创建或核对合集名称。
- 系统自动保存失败（页面无保存反馈）：本章标记失败；重试后仍失败则保留失败记录并继续下一章（除非用户要求遇错即停）。
- `分发记录.md` 写入失败：流程标记为"部分失败（记录未落盘）"，并提示人工补录。

## 实操经验沉淀（今日头条）

- 新建章节自动保存后，需要进入草稿箱后点击"编辑"才能获得含 `pgc_id` 的 URL，这是回写章节Id最稳定来源。
- 每章保存前先完成"声明首发 + 合集确认"，可避免保存后返工。
- 标题输入前先拼好 `第X章 标题文本`，能避免章节号漏填或空格遗漏。
- 今日头条不需要手动点击保存，系统自动保存，若页面没有保存反馈可能表示网络延迟或设置未落盘，需重新核实。
- 提取新建章节的 `pgc_id` 最稳定的流程是：保存后 → 进入草稿箱 → 按标题找到文章 → 点击"编辑" → 从新 URL 提取 `pgc_id`。
- 每章结束以"页面反馈自动保存成功"提示为唯一完成信号，没有成功反馈就不算完成。

### 40章全量实战复盘（2026-05-21）

- **标题是第一失败源**：超长标题、复杂标点、口语冗长会显著提高“未落草稿”概率；应先压缩成短标题再填入。
- **建议默认启用短标题回退**：当同章连续 2 次未落盘时，切换到“`第X章 + 语义压缩标题`”重试，通常可恢复保存。
- **草稿回读优先接口**：`/mp/agw/creator_center/draft_list?type=0&offset=0&count=300&app_id=1231` 可稳定读取 `title + gid`，用于判定是否保存成功与回写章节Id。
- **标题可能被平台自动规整**：如删字、替换词、裁剪；匹配时应按“章号前缀 + 宽松文本匹配”回读，而非只做全等匹配。
- **失败章分批重试比整批重跑更稳**：先完成可落盘章节并即时回写，再对失败清单定点补传，避免整批回滚。
- **每批必须对账**：批次结束执行 `计划章数 = 成功章数 + 失败章数`；全批结束执行 `1..N` 章节映射完整性校验（缺失章必须继续补传）。

## 完成检查清单

- 已读取 `今日头条/README.md` 并提取必需字段。
- 已登录今日头条后台，并按规定链路完成密码登录。
- 已在每章开始前查询 `今日头条/分发记录.md` 并正确区分新建/修改模式。
- 每章均完成绝对章节号计算或校验（不分卷单序列口径）。
- 每章均完成：标题、正文、发布设置四项（声明首发、合集、"虚构演绎，故事经历"、"展示封面=无封面"）。
- 每章系统已自动保存（无需手动点击）。
- 新建章节均已从新 URL 提取 `pgc_id`。
- 每章保存后均已回写 `今日头条/分发记录.md`（含章节与章节Id映射）。
- 已输出每章结果（成功/失败及原因）。