---
name: 分发-豆瓣
description: 用于将"豆瓣/"目录内指定章节批量上传到豆瓣阅读作者后台并保存为草稿。支持按 README.md 读取账号、密码、豆瓣书籍ID、书名与卷名校验，自动执行登录、章节信息填写、正文粘贴、作者的话添加与存草稿循环。关键词：豆瓣上传、保存草稿、批量传章、豆瓣作者后台、作者的话。
argument-hint: 给我 chapterPath 或 chapterPaths（位于"豆瓣/"目录），我会按 README.md 的账号与书籍信息逐章上传并存草稿。
---

# 上传指定章节小说到豆瓣阅读并保存为草稿

用于把你指定的 1 章或多章，上传到豆瓣阅读对应作品下，并全部保存为草稿。

## 何时使用

- 你已经把待上传章节放入 `豆瓣/` 目录。
- 你已经在 `豆瓣/README.md` 写好账号、密码、豆瓣书籍 ID、书名、卷名信息。
- 你希望按固定流程自动完成：登录 → 填章号与章名 → 粘贴正文 → 添加作者的话 → 存草稿。

## 不适用情形

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

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

### 1) 章节文件目录

- 待上传文件必须放在 `豆瓣/` 下。
- 你会明确指定要上传哪些章节（可单章，可多章）。
- 章节标题**不以文件名为准**，必须从章节文件正文中提取。

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

- 章节标题来源于章节文件内容，通常是第 1 行的 Markdown 标题行（以 `# ` 开头）。
- 该标题行有时会带章节编号，有时只有标题文本；两种都合法。
- 豆瓣要求章节号与标题合并在一个输入框，格式为 `第X章 标题文本`（章号与标题之间必须保留一个空格）。

### 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`：豆瓣章节页 URL 中的数字段
- `最近操作`：`新建` 或 `修改`
- `更新时间`：`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 | 第二卷 卷标题 |

## 字段说明

- `小说名称` / `分部名`：必须精确匹配 SKILL 中的"书名判定规则"
- `分部号`：必须使用 `第N部` 规范格式（如 `第1部`、`第2部`），并与 `分部名` 一一对应，不得错位或复用
- `书籍ID`：纯数字
- `卷名`：豆瓣平台上该卷的显示名称

## 安全提醒

- 本文件包含明文密码，请妥善保管。
- 本文件应存入 `.gitignore`，不提交到公开仓库。
```
## 执行流程（强制按序）

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

1. 读取并解析 `豆瓣/README.md`。
2. 确认已获得：账号、密码、目标书籍Id（按“书籍Id判定规则”选取）、目标小说名、目标卷名。
3. 读取 `豆瓣/分发记录.md`，建立"章节唯一键 -> 章节Id"映射（建议唯一键：`豆瓣书籍ID|分部名|卷号|章号|章名`；无分部时分部名固定为`NA`）。
4. 读取你指定的章节文件，提取每章：章节号（阿拉伯数字）、章节标题、正文、作者的话。
   - 其中章节标题必须按"章节标题提取规则（强制）"从文件内容提取，不得用文件名替代。

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

1. **必须新开一个浏览器标签页**，并在该新标签页访问：
   - `https://read.douban.com/submit/agent`
2. 该新标签页仅用于本次豆瓣上传流程，不复用你当前正在进行其他任务的标签页。
3. 若出现未登录状态：
   - 页面默认显示"手机号验证码登录"界面
   - **必须点击"豆瓣登录"链接**
   - 页面跳转后，在右上角找到并点击"短信登录/注册"
   - 然后切换到"密码登录"选项卡
   - 使用 `README.md` 中的用户名和密码进行登录
4. 若密码登录后页面提示"为保证账号安全，请使用验证码"或同类提示：
   - 必须立即暂停流程，等待用户手动完成验证并明确反馈“登录完成”
   - 在收到“登录完成”反馈前，不得继续任何后续步骤、不得伪造成功态

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

1. 在访问前，先查询 `豆瓣/分发记录.md` 中该章节是否已有 `章节Id`。
2. 若该章节 **没有** 章节Id（新建模式），访问：
   - `https://read.douban.com/article_v2/chapter/create?column_id={豆瓣书籍ID}`
   - 页面加载后，URL 会自动重定向到 `https://read.douban.com/article_v2/chapter/{章节Id}/`
   - 从重定向后的 URL 提取 `{章节Id}` 部分（两个斜杠之间的纯数字）
3. 若该章节 **已有** 章节Id（修改模式），访问：
   - `https://read.douban.com/article_v2/chapter/{章节Id}`
4. `{豆瓣书籍ID}` 必须来自 `README.md`，且是数字串。
5. 豆瓣编辑界面不显示书籍信息与卷名，无法在页面做书籍校验；书籍ID的正确性仅通过 URL 中的 `column_id` 或 URL 路径本身来确认，请在步骤 2 前确认 `README.md` 中书籍ID无误。

### 步骤 4：填写章节标题区

豆瓣要求在单一输入框中输入"章节编号 + 空格 + 章节标题"。

1. 获取该章的阿拉伯数字章节号（如 `1`）。
2. 获取该章的章节标题（来源于文件内容，通常为第1行 `# ` 标题行），不得使用文件名。
3. 按格式 `第X章 标题文本` 组合填入标题输入框：
   - 示例：`第1章 天降奇缘`
   - 章号与标题之间**必须保留一个空格**
4. 确保格式正确后提交。

### 步骤 5：填写正文

1. 在正文文本框输入该章节正文。
2. 必须确保正文来自你指定的章节文件，不得错章串章。

### 步骤 6：添加作者的话

1. 在页面右上方找到"工具"按钮或菜单。
2. 点击其中的"作者的话"选项。
3. 点击后会在页面右上角弹出一个浮层输入框。
4. 在弹出的输入框中**先全选清空旧内容**，再输入该章"作者的话"内容，避免与历史文本拼接。
5. 输入后必须检查计数器（若页面显示字数限制）：
   - 若超限，按"保钩子优先"压缩到平台限制内再保存。
   - 若未超限，保持原文语义。
6. 点击弹出浮层中的"确定"按钮，确认作者的话已落盘。

### 步骤 7：保存章节

1. 点击页面上的"保存"按钮。
2. 等待页面反馈已保存成功（或等价成功提示）。
3. 保存成功后，从当前 URL 提取 `章节Id`（若为新建模式，这时 URL 应为 `https://read.douban.com/article_v2/chapter/{章节Id}/`）。
4. 将"章节唯一键 + 章节Id + 更新时间"写回 `豆瓣/分发记录.md`：
   - 若记录不存在：新增一条。
   - 若记录已存在：仅更新 `章节Id`（如变化）和更新时间。
   - **注意 Markdown 表格转义**：`章节唯一键`内部包含 `|` 时，写入表格必须转义为 `\|`，否则会破坏表格列数并导致记录不可解析。

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

### 步骤 8：多章循环

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

## 关键边界与硬规则

- 必须只上传用户明确指定的章节，不得擅自扩展范围。
- 步骤 2 必须使用**新标签页**进入作者后台，禁止占用用户正在使用的原标签页。
- 登录流程必须按"手机号验证码 → 豆瓣登录 → 短信登录/注册 → 密码登录"的顺序执行。
- 每章进入步骤 3 前，必须先查询 `豆瓣/分发记录.md`。
- 每章进入步骤 3 前，必须确认 `README.md` 中的豆瓣书籍 ID 正确无误（豆瓣编辑界面无法在页面校验书籍信息）。
- `create?column_id={书籍ID}` 与 `chapter/{章节Id}` 两种地址必须按记录自动分流，禁止混用。
- 每章"保存"成功后，必须把最新 `章节Id` 回写到 `豆瓣/分发记录.md`。
- 章节标题必须来自章节文件内容（通常第1行 `# ` 标题行），不得以文件名充当标题。
- 章节标题输入格式必须为 `第X章 标题文本`（章号与标题之间**必须保留一个空格**），不得遗漏空格。
- 章节号必须是阿拉伯数字，不得写中文数字。
- 豆瓣是分卷平台，章节号必须使用所在卷内的相对章节号，不做跨卷累加。
- "作者的话"必须通过"工具 → 作者的话 → 在弹出浮层中输入 → 确定"路径录入。
- 作者的话录入前必须先清空编辑框，再粘贴本章文本。
- 作者的话必须满足平台字数限制后再确定。
- 最终动作是"保存"，保存后即为草稿状态。
- 账号密码仅用于当次登录，不写入产物文件、不外泄。

## 失败与回退处理

- 登录失败：提示账号/密码错误并停止，不继续后续章节。
- 密码登录被拦截为验证码登录：必须立即暂停流程，等待用户手动完成验证并明确反馈“登录完成”；在收到该反馈前不得继续任何后续步骤。
- 编辑页出现二次安全验证（拼图/滑块）：必须立即暂停流程，等待用户手动完成验证并明确反馈“登录完成”；在收到该反馈前不得继续任何后续步骤。
- 页面元素缺失（如按钮改版）：记录当前失败步骤并停止本章，继续尝试下一章前需先确认页面可操作。
- 保存失败：本章标记失败，重试后仍失败则保留失败记录并继续下一章（除非用户要求遇错即停）。
- 作者的话保存失败：本章先不保存，重试"编辑作者的话 → 确定 → 保存"链路；仍失败则记录原因并继续下一章（除非用户要求遇错即停）。
- `分发记录.md` 写入失败：本章虽然可能已保存，但流程状态必须标记为"部分失败（记录未落盘）"，并立即提示人工补录，禁止静默成功。

## 实操经验沉淀（基于真实上传）

- 豆瓣登录流程复杂，必须严格按"手机号验证码 → 豆瓣登录 → 短信登录/注册 → 密码登录"顺序执行。
- 登录完成后再访问作者后台，避免反复重定向。
- 新建章节时，页面自动重定向后 URL 会变成 `.../chapter/{章节Id}/`，该 `章节Id` 必须提取并回写到分发记录。
- 章节标题输入框在豆瓣要求格式严格，必须是 `第X章 标题` 的样式，缺少空格会导致排版错误。
- 正文粘贴后要观察顶部保存状态，避免"看起来贴上了实际未落盘"。
- 作者的话弹出浮层容易被忽视，必须确认浮层出现且焦点在输入框再输入。
- 作者的话存在 300 字上限风险：若源文超限，必须先压缩再点"确定"，并在结果中注明"已压缩"与压缩策略（保钩子、保信息密度、去重复解释）。
- 每章结束以"保存成功"提示为唯一完成信号；没有成功提示就不算完成。

## 本次实跑教训（2026-05-10）

- `豆瓣/分发记录.md` 首次不存在时必须先创建模板再执行，否则新建/修改分流失效。
- `章节唯一键`写入 Markdown 表格时必须使用转义竖线（`\|`）；不转义会触发表格列错位（典型报错：Expected 6 columns, Actual 10）。
- 编辑页可能出现二次安全验证弹层（即使已登录）；这是硬阻塞点，需用户协助完成后再继续自动化。
- 本次第1章新建后实际章节链接为：`https://read.douban.com/article_v2/chapter/732782163/`，验证了"create -> 重定向 -> 提取章节Id -> 回写记录"链路可用。

## 完成检查清单

- 已读取 `豆瓣/README.md` 并提取必需字段。
- 已按指定章节列表逐章执行上传。
- 已在每章执行前查询 `豆瓣/分发记录.md` 并正确选择新建/修改 URL。
- 每章均完成：章号+章名、正文、作者的话、保存。
- 每章均已记录或更新到 `豆瓣/分发记录.md`（含章节与章节Id映射）。
- 已输出每章结果（成功/失败及原因）。