---
name: 分发-起点中文网
description: 用于将 `小说正文/` 目录内指定章节批量上传到起点中文网作者后台并保存为草稿。支持按 `小说正文/README.md` 读取账号、密码、起点书籍Id、书名与卷名校验，自动执行登录、进入新建/修改章节页、填写合并标题输入框、粘贴正文、添加作家的话、保存草稿，并在保存后从左侧章节列表反查章节Id并写回 `小说正文/分发记录.md`。关键词：起点上传、起点中文网、保存草稿、批量传章、作家的话、章节Id回写。
argument-hint: 给我 chapterPath 或 chapterPaths（位于 `小说正文/` 目录），我会按 `小说正文/README.md` 的账号与书籍信息逐章上传并保存草稿，同时回写章节Id。
---

# 上传指定章节到起点中文网并保存为草稿

用于把你指定的 1 章或多章，上传到起点中文网对应作品下，并全部保存为草稿。

## 何时使用

- 你已经把待上传章节放入 `小说正文/` 目录。
- 你已经在 `小说正文/README.md` 写好账号、密码、起点书籍Id、书名、卷名信息。
- 你希望按固定流程自动完成：登录 → 判断新建/修改模式 → 填写合并标题输入框 → 粘贴正文 → 添加作家的话 → 保存草稿 → 回写章节Id。

## 不适用情形

- 你只想做文本润色，不需要打开网站上传。
- 你没有提供起点账号或书籍Id。
- 目标不是“保存草稿”，而是“立即发布”。

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

### 1) 章节文件目录

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

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

- 必须从章节文件中提取：章节号（阿拉伯数字）、章节标题、正文、作家的话。
- 起点页面只有**一个标题输入框**，最终填入值必须是完整字符串：`第{章号}章 {章节标题}`。
- `章号` 与 `标题` 之间必须保留 **1 个空格**，例如：`第1章 天降奇缘`。
- 若章节文件标题行本身已经是完整格式（如 `第12章 夜半来客`），且章号一致，则可直接使用。
- 若提取到的标题行只有标题文本（如 `夜半来客`），则必须自动组装成 `第{章号}章 夜半来客`。
- 不得把文件名中的平台后缀（如 `_起点版`）带入标题输入框。

### 2) 元数据来源

- 必须读取 `小说正文/README.md`，至少提取以下信息：
  - 起点作者后台用户名
  - 起点作者后台密码
   - 起点书籍Id（纯数字，如 `11997642`；按“书籍Id判定规则”选取当前章节对应值）
   - 小说名称（小说书名，用于当前上传目标）
  - 每一卷卷名

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

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

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

- 若小说无分部：小说书名使用该平台目录 `README.md` 中的“小说名称（小说书名）”。
- 若小说有分部（多部）：小说书名使用该章节所在分部的分部名，不得误用总书名。

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

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

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

当 `小说正文/分发记录.md` 不存在时，必须按以下模板创建：

```markdown
# 起点中文网分发记录

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

## 字段说明

- `章节唯一键`：固定格式 `起点书籍ID|分部名|卷号|章号|章名`（无分部时分部名填 `NA`）
- `起点书籍ID`：对应 `小说正文/README.md` 中书籍Id
- `章节Id`：起点章节编辑地址 hash 中 `#ccid=` 后的数字
- `最近操作`：`新建` 或 `修改`
- `更新时间`：`YYYY-MM-DD HH:mm:ss`
- `备注`：可选

## 记录表

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

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

当 `小说正文/README.md` 不存在时，必须按以下模板创建：

```markdown
# 起点中文网分发配置

> 用途：存储起点中文网账号、书籍信息与分部卷名映射。分发流程将读取此文件。

## 账号信息

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

## 书籍信息

### 无分部小说

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

### 有分部小说

| 分部号 | 分部名 | 书籍ID | 卷数 |
|:--|:--|--:|--:|
| 第1部 | 分部一书名 | 11997642 | 3 |
| 第2部 | 分部二书名 | 11997643 | 2 |

## 卷名映射

### 分部一书名

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

### 分部二书名

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

## 字段说明

- `小说名称` / `分部名`：必须精确匹配 SKILL 中的"书名判定规则"与分部逻辑
- `分部号`：必须使用 `第N部` 规范格式（如 `第1部`、`第2部`），并与 `分部名` 一一对应，不得错位或复用
- `书籍ID`：纯数字，从起点作者后台"作品管理"获取
- `卷名`：该卷在起点平台显示的卷名，用于编辑页校验
- `卷数`：只用于分部信息参考，不参与分发流程

## 安全提醒

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

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

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

1. 读取并解析 `小说正文/README.md`。
2. 确认已获得：账号、密码、目标书籍Id（按“书籍Id判定规则”选取）、目标小说名、目标卷名。
3. 读取 `小说正文/分发记录.md`，建立“章节唯一键 -> 章节Id”映射（建议唯一键：`起点书籍ID|分部名|卷号|章号|章名`；无分部时分部名固定为 `NA`）。
4. 读取你指定的章节文件，提取每章：章节号（阿拉伯数字）、章节标题、正文、作家的话。
5. 对每章生成“页面标题输入框最终值”：`第{章号}章 {章节标题}`。

### 步骤 2：进入作者后台

1. **必须新开一个浏览器标签页**，并在该新标签页访问：
   - `https://write.qq.com/portal/dashboard/books`
2. 该新标签页仅用于本次起点上传流程，不复用你当前正在进行其他任务的标签页。
3. 若出现登录态失效或未登录：
   - 使用 `README.md` 中的用户名和密码登录。
4. 若登录过程中出现验证码、手机验证、二次确认或安全校验：
   - 必须立即暂停流程，等待用户手动完成验证并明确反馈“登录完成”。
   - 在收到“登录完成”反馈前，不得继续任何后续步骤、不得伪造成功态。
5. 若首次进入编辑页出现“作家创作须知”弹窗：
   - 先勾选“我已阅读...”复选框。
   - 再点击“同意”。
6. 若编辑页出现新手引导浮层（如“瑞特”引导、“下一步 / 跳过 / 关闭”）：
   - 先关闭或跳过，确保编辑器可正常操作后再继续。

### 步骤 3：进入目标书籍章节页（新建/修改二选一）

1. 在访问前，先查询 `小说正文/分发记录.md` 中该章节是否已有 `章节Id`。
2. 若该章节 **没有** 章节Id（新建模式），访问：
   - `https://write.qq.com/portal/booknovels/chaptertmp/CBID/{书籍Id}/#ccid=-1`
3. 若该章节 **已有** 章节Id（修改模式），访问：
   - `https://write.qq.com/portal/booknovels/chaptertmp/CBID/{书籍Id}/#ccid={章节Id}`
4. `{书籍Id}` 必须来自 `README.md`，且是纯数字字符串。
5. 新建模式进入后，必须记住：`#ccid=-1` 只表示“新建临时态”，**不是最终章节Id**。

### 步骤 4：校验当前作品信息

1. 检查编辑页当前作品是否匹配 `README.md` 中的目标书名。
2. 若页面存在卷信息、分卷信息或左侧章节树能辨认卷名，则进一步校验目标卷名。
3. 若书名或卷名不匹配：
   - 立即停止当前章上传。
   - 返回错误说明（书名/卷名不一致）。
   - 禁止继续盲传到错误作品。

### 步骤 5：填写标题输入框

1. 找到章节标题输入框。
2. 将其内容设置为完整字符串：`第{章号}章 {章节标题}`。
3. 输入前应先全选并清空旧值，避免残留“未命名章节”“草稿标题”或历史标题。
4. 再次核对：
   - 使用的是阿拉伯数字章号。
   - `章号` 与 `标题` 之间只有一个空格。
   - 未混入文件名后缀、卷名、平台名等无关信息。

### 步骤 6：填写正文

1. 在正文编辑区域输入该章节正文。
2. 必须确保正文来自你指定的章节文件，不得错章串章。
3. 若编辑器为富文本或类富文本区域，输入后需确认可见正文确实已落入编辑区，而不是只进入了错误焦点元素。

### 步骤 7：添加作家的话

1. 点击“作家的话”按钮（可能位于编辑器工具栏，也可能位于页面下方）。
2. 等待右侧浮层出现输入框。
3. 在浮层输入框中**先全选清空旧内容**，再输入该章“作家的话”内容，避免与旧文本拼接。
4. 若页面存在字数限制提示，必须在限制内保存原意，不得超限硬提。
5. 输入完成后，点击浮层右上角“收起”。
6. 收起后需确认“作家的话”内容未丢失；若页面有可见摘要或已填写态，应检查其已更新。

### 步骤 8：保存草稿并获取章节Id

1. 根据模式选择正确按钮：
   - 新建模式优先点击“存为草稿”；若页面仅显示“保存”，则点击“保存”（该入口同样会保存在草稿箱）。
   - 修改模式点击“保存”。
2. 等待页面出现保存成功的反馈或等价成功状态。
3. 保存成功后，**必须立即获取该章最终章节Id**，推荐按以下顺序执行：

#### 8.1) 优先从左侧章节列表反查

1. 观察左侧章节列表中新出现或刚更新的章节项。
2. 用以下信息交叉确认是当前章节：
   - 章节号
   - 章节标题
   - 最近保存时间
   - 字数
3. 若该章节项本身是链接，优先读取其链接地址、hash、跳转目标或元素属性中的 `#ccid={章节Id}`。

#### 8.2) 若左侧项不可直接读到 ID，则点击该章节项

1. 点击左侧刚保存的章节项重新进入该章。
2. 读取当前页面 URL hash。
3. 若页面地址变为 `https://write.qq.com/portal/booknovels/chaptertmp/CBID/{书籍Id}/#ccid={章节Id}`，则提取 `#ccid=` 后的纯数字作为 `章节Id`。

#### 8.3) 若 URL 仍未显式变化，则继续检查元素属性

1. 检查左侧章节项及其可点击子元素是否包含如下属性：
   - `href`
   - `data-ccid`
   - `data-id`
   - `data-chapterid`
   - 其他可明确表示章节主键的属性
2. 若能拿到纯数字章节主键，则将其视为 `章节Id`。

#### 8.4) 获取 `章节Id` 后写回记录

1. 将“章节唯一键 + 章节Id + 更新时间”写回 `小说正文/分发记录.md`：
   - 若记录不存在：新增一条。
   - 若记录已存在：更新 `章节Id`（如变化）和更新时间。
2. `最近操作` 根据本次模式写为 `新建` 或 `修改`。

> 章节唯一键生成规则（强制）：
> - 使用字段顺序：`起点书籍ID|分部名|卷号|章号|章名`
> - 其中：
>   - `起点书籍ID` 来自 `小说正文/README.md`
>   - `分部名` 使用当前分部书名；无分部填 `NA`
>   - `卷号`、`章号` 必须是阿拉伯数字
> - 该规则用于避免多部小说、多卷并行分发时的同章号冲突。

4. 若保存成功但仍未拿到 `章节Id`：
   - 本章状态必须标记为“部分成功（草稿已存，章节Id未回写）”。
   - 立即向用户明确报告阻塞点。
   - 禁止把该章静默算作完全成功。

### 步骤 9：多章循环

- 对每个指定章节，严格重复步骤 3～8，直到全部章节完成。
- 每章开始前都必须先查一次 `分发记录.md` 决定新建/修改模式，不得沿用上一章模式。

## 关键边界与硬规则

- 必须只上传用户明确指定的章节，不得擅自扩展范围。
- 步骤 2 必须使用**新标签页**进入作者后台，禁止占用用户正在使用的原标签页。
- 每章进入步骤 3 前，必须先查询 `小说正文/分发记录.md`。
- 新建模式必须使用 `#ccid=-1`，修改模式必须使用 `#ccid={章节Id}`，二者不得混用。
- 每章保存成功后，必须尝试从左侧章节列表或页面 hash 中拿到最终 `章节Id` 并回写 `小说正文/分发记录.md`。
- 章节标题输入框必须填写完整字符串 `第{章号}章 {章节标题}`，且中间保留一个空格。
- 章节号必须是阿拉伯数字，不得写中文数字。
- 起点是分卷平台，章节号必须使用所在卷内的相对章节号，不做跨卷累加。
- “作家的话”必须通过“作家的话”按钮（工具栏或页面下方）打开右侧浮层后录入。
- “作家的话”录入后必须点击浮层右上角“收起”。
- 新建模式优先“存为草稿”；若页面仅显示“保存”，则点击“保存”并以草稿箱新增/更新时间作为成功判据；修改模式使用“保存”。
- 未拿到 `章节Id` 时，不得把本章标记为完全成功。
- 账号密码仅用于当次登录，不写入产物文件、不外泄。

## 失败与回退处理

- 登录失败：提示账号/密码错误并停止，不继续后续章节。
- 登录触发验证码或手机验证：必须立即暂停流程，等待用户手动完成验证并明确反馈“登录完成”；在收到该反馈前不得继续任何后续步骤。
- 页面元素缺失（如按钮改版、浮层未出现）：记录当前失败步骤并停止本章，继续尝试下一章前需先确认页面可操作。
- 书名/卷名不匹配：直接停止该书上传流程，要求先修正 `小说正文/README.md` 或目标书籍Id。
- 保存失败：本章标记失败，重试后仍失败则保留失败记录并继续下一章（除非用户要求遇错即停）。
- “作家的话”保存态异常或收起后内容丢失：本章先不算完成，需重试“打开作家的话 → 重填 → 收起 → 保存”链路；仍失败则记录原因并继续下一章（除非用户要求遇错即停）。
- `章节Id` 获取失败：本章标记“部分成功（草稿已存）”，要求人工补录章节Id，禁止静默成功。
- `小说正文/分发记录.md` 写入失败：本章虽然可能已保存草稿，但流程状态必须标记为“部分失败（记录未落盘）”，并立即提示人工补录，禁止静默成功。

## 实操经验沉淀（基于已知页面信息与分发逻辑）

- `write.qq.com` 编辑页首次进入时，可能先出现“作家创作须知”弹窗；不先勾选并点击“同意”，后续编辑区可能不可用。
- 编辑页可能带有“瑞特”引导层；先“跳过”或“关闭”，别让引导层抢焦点，不然标题、正文、保存按钮都像在玩躲猫猫。
- 新建地址里的 `#ccid=-1` 不是正式章节Id；正式 `章节Id` 必须在保存草稿后，再从左侧章节列表或跳转后的 hash 中反查。
- 左侧章节列表在保存后会显示新章节的章节号、标题、保存时间和字数，这是确认“当前章是哪一条”的关键锚点。
- 若左侧章节项可点击，优先点回该章节再读 `#ccid=`；这通常比盯着当前页发呆更靠谱。
- 每章结束以“保存成功 + 已拿到章节Id并回写记录”为完整完成信号；缺任一项都不算真正闭环。

### 本轮实操补充（2026-05-09）

- 登录常见会触发滑块安全验证；该验证需用户实时手动完成，未通过前不得继续后续步骤。
- 登录页“同意协议”复选框可能被自定义 `label` 覆盖；勾选失败时应改点 `label` 触发，不要反复硬点原始 `input`。
- “作家的话”浮层已知存在 **500 字上限**（页面显示如 `248/500`）；超限时必须先压缩再保存。
- 同一页面的“收起”“保存”等关键动作应**串行执行**，避免并行点击造成状态竞争与误判。
- `小说正文/分发记录.md` 使用 Markdown 表格时，`章节唯一键` 内部的分隔符 `|` 必须转义为 `\|`，否则会触发列数错乱（如 MD056）。

## 最小可执行检查表（10秒版）

> 用法：每次分发前按顺序快速过一遍；有任意一项不满足，就先修正再上传。

1. **输入是否齐全**
   - 已明确本次只上传哪些章节（不扩范围）。
   - `小说正文/README.md` 可读到用户名、密码、书籍Id、书名、卷名。

2. **目标是否正确**
   - 当前编辑页书名、卷名与 `README.md` 一致。
   - 本章模式已判定：无 `章节Id` 走新建（`#ccid=-1`），有 `章节Id` 走修改（`#ccid={章节Id}`）。

3. **关键输入是否到位**
   - 标题框是完整格式：`第{章号}章 {章节标题}`（阿拉伯数字、一个空格）。
   - 正文已确认写入编辑器可见区（不是误填到别处）。
   - “作家的话”已填、未超 500 字、已点“收起”。

4. **保存与回写是否闭环**
   - 已保存成功（新建优先“存为草稿”；仅有“保存”时以草稿箱新增/更新时间判定）。
   - 已拿到最终 `章节Id`（左侧章节项或 URL `#ccid=`）。
   - 已回写 `小说正文/分发记录.md`，且 `章节唯一键` 中 `|` 已转义为 `\|`。

5. **失败是否明示**
   - 若验证码未过、保存失败、`章节Id` 未拿到、记录未写入：必须标记失败/部分成功并说明阻塞点。

## 完成检查清单

- 已读取 `小说正文/README.md` 并提取必需字段。
- 已按指定章节列表逐章执行上传。
- 已在每章执行前查询 `小说正文/分发记录.md` 并正确选择新建/修改 URL。
- 每章均完成：标题输入框、正文、作家的话、保存草稿/保存。
- 每章保存后均已尝试并优先通过左侧章节列表获取 `章节Id`。
- 每章均已记录或更新到 `小说正文/分发记录.md`（含章节与章节Id映射）。
- 每章上传前均完成目标作品信息校验。
- 已输出每章结果（成功 / 失败 / 部分成功及原因）。