分发 WebNovel

<!-- ===== Layer 1: 永久缓存 ===== -->

上传指定章节到 WebNovel 并保存

用于把你指定的 1 章或多章，上传到 WebNovel（Inkstone）对应作品下，并按后台要求保存。

<!-- ===== Layer 3: 场景缓存 ===== -->

工作目录路由规则（强制）

本 Skill 执行前，必须按以下规则确定工作目录：

1. 读取项目根目录 Agents.md，检查其中 主输出平台 声明
2. 若当前平台（WebNovel）匹配 主输出平台 → 工作目录为 小说正文/
3. 若当前平台不匹配 主输出平台，或 Agents.md 不存在/未声明 主输出平台 → 工作目录为 WebNovel/

后续所有章节文件路径、README.md、分发记录.md 均基于此工作目录。明确说明：

• 本平台是主输出平台时 → 章节文件、README.md、分发记录.md 均在 小说正文/ 下
• 本平台不是主输出平台时 → 章节文件、README.md、分发记录.md 均在 WebNovel/ 下

路径说明：以下各节中所有 WebNovel/ 形式的路经（如 WebNovel/README.md、WebNovel/分发记录.md）均为工作目录的示例写法。实际目录由上方「工作目录路由规则」确定：本平台是主输出平台时，所有这些路径对应 小说正文/；不是主输出平台时，对应 WebNovel/。

何时使用

• 你已经把待上传章节放入 WebNovel/ 目录。
• 你已经在 WebNovel/README.md 写好账号、密码、WebNovel 书籍Id、书名、卷名信息。
• 你希望按固定流程自动完成：进入后台 → 手动登录确认 → 判断新建/修改模式 → 填写章节标题 → 粘贴正文 → 添加作者有话说 → 保存 → 继续下一章。

不适用情形

• 你只想做文本润色，不需要打开网站上传。
• 你没有提供 WebNovel 账号或书籍Id。
• 目标不是“保存章节”，而是只做内容校对。

输入前置要求（强制）

1) 章节文件目录

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

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

• 必须从章节文件中提取：章节号（阿拉伯数字）、章节标题、正文、作者有话说。
• 若章节文件标题行为 # 1.1.3 三分钟，其中 1.1.3 表示 部号.卷号.章号；提取时必须只取最后一段 3 作为“章号”，三分钟 作为“章节标题”。
• WebNovel 是分卷平台，上传时只使用卷内章号，不得把 1.1.3、2.4.17 这类三级编号原样带入标题输入框；最终只能写成 Chapter 3 三分钟 一类格式。
• WebNovel 页面只有一个章节标题输入框，最终填入值必须是完整字符串：Chapter {章号} {章节标题}。
• Chapter、章号 与 标题 之间必须保留 1 个空格，例如：Chapter 1 天降奇缘。
• 若章节文件标题行本身已经是完整格式（如 Chapter 12 Night Visitor），且章号一致，则可直接使用。
• 若提取到的标题行只有标题文本（如 夜半来客），则必须自动组装成 Chapter {章号} 夜半来客。
• 不得把文件名中的平台后缀（如 _WebNovel版）带入标题输入框。

2) 元数据来源

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

2.1) 平台校验（强制）

读取 WebNovel/README.md 后，必须检查其第一行一级标题是否等于 # WebNovel 分发配置：

• 匹配 → 继续执行后续流程
• 不匹配 → 立即停止上传，并向用户报错：README.md 平台标识与当前 Skill 不符：预期"WebNovel 分发配置"，实际读取到"{实际读取到的标题}"。请检查是否将其他平台的 README.md 误放到了当前工作目录。

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

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

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

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

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

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

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

当 WebNovel/分发记录.md 不存在时，必须按以下模板创建：

# WebNovel 分发记录

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

## 字段说明

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

## 记录表

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

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

当 WebNovel/README.md 不存在时，必须按以下模板创建：

# WebNovel 分发配置

> 用途：存储 WebNovel 书籍信息与卷名映射。分发流程需要用户手动登录，不读取密码。

## 书籍信息

### 无分部小说

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

### 有分部小说

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

## 卷名映射

### 分部一书名

| 卷号 | 卷名（英文） |
|--:|:--|
| 1 | Volume 1 Title |
| 2 | Volume 2 Title |

## 字段说明

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

## 登录方式

- **本文件不存储密码**。分发流程将在浏览器打开 WebNovel Inkstone，需要你在浏览器中**手动登录**。
- 确保登录账号拥有上述书籍的编辑权限。

## 注意事项

- 分发流程会检查登录状态；如未登录，需要你手动完成登录后再继续。
- 若出现安全验证、二次确认等额外步骤，需要你在浏览器中手动完成。
- 章节标题格式：`Chapter {章号} {章节标题}`（英文）。

执行流程（强制按序）

步骤 1：读取本地输入

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

步骤 2：进入作者后台

1. 必须新开一个浏览器标签页，并在该新标签页访问：
   • https://inkstone.webnovel.com/novels/list
2. 该新标签页仅用于本次 WebNovel 上传流程，不复用你当前正在进行其他任务的标签页。
3. 若出现登录态失效或未登录：
   • 先进入登录流程，但必须等待用户手动完成登录操作。
   • 在用户明确告诉你“登录完成”之前，禁止继续任何后续步骤。
   • 期间不要尝试代填密码、不要伪造登录成功状态。
4. 登录完成后，再继续后续编辑流程。
5. 若编辑页出现新手引导浮层或提示遮挡：
   • 先关闭、跳过或收起，确保编辑器可正常操作后再继续。

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

1. 在访问前，先查询 WebNovel/分发记录.md 中该章节是否已有 章节Id。
2. 若该章节 没有 章节Id（新建模式），访问：
   • https://inkstone.webnovel.com/novels/chapter/create/{小说书籍ID}
3. 若该章节 已有 章节Id（修改模式），访问：
   • https://inkstone.webnovel.com/novels/chapter/edit/{书籍ID}/{章节ID}
4. {书籍ID} 必须来自 README.md，且是纯数字字符串。
5. 进入编辑页后，先确认卷信息：
   • 卷信息通常位于章节编辑区左上角，会显示卷编号和卷名称。

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

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

步骤 5：填写标题输入框

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

步骤 6：填写正文

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

步骤 7：添加作者有话说

1. 点击章节编辑区下方的“ADD AUTHOR'S THOUGHT”。
2. 等待弹出的对话框出现输入框。
3. 在对话框输入框中先全选清空旧内容，再输入该章“作者有话说”内容，避免与旧文本拼接。
4. 若页面存在字数限制提示，必须在限制内保存原意，不得超限硬提。
5. 输入完成后，点击“SUBMIT”。
6. 若页面支持收起或关闭该对话框，则确认内容已写入后再收起，避免输入丢失。

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

1. 点击“SAVE”。
2. 等待页面出现保存成功的反馈或等价成功状态。
3. 保存成功后，必须立即确认当前章节页 URL 已变更为：
   • https://inkstone.webnovel.com/novels/chapter/edit/{书籍ID}/{章节ID}
4. 从 URL 中提取 {章节ID}，将其视为本章的最终 章节Id。
5. 若页面没有跳转但保存成功，也应继续检查当前地址栏与页面状态，确认是否已经更新为编辑 URL。
6. 将“章节唯一键 + 章节Id + 更新时间”写回 WebNovel/分发记录.md：
   • 若记录不存在：新增一条。
   • 若记录已存在：更新 章节Id（如变化）和更新时间。
7. 最近操作 根据本次模式写为 新建 或 修改。

章节唯一键生成规则（强制）：

• 使用字段顺序：WebNovel书籍ID|分部名|卷号|章号|章名
• 其中：
  • WebNovel书籍ID 来自 WebNovel/README.md
  • 分部名 使用当前分部书名；无分部填 NA
  • 卷号、章号 必须是阿拉伯数字
• 该规则用于避免多部小说、多卷并行分发时的同章号冲突。

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

步骤 9：多章循环

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

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

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

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://inkstone.webnovel.com/novels/list，并在需要登录时等待用户手动完成登录。
• 每章进入步骤 3 前，必须先查询 WebNovel/分发记录.md。
• 新建模式必须使用 https://inkstone.webnovel.com/novels/chapter/create/{小说书籍ID}，修改模式必须使用 https://inkstone.webnovel.com/novels/chapter/edit/{书籍ID}/{章节ID}，二者不得混用。
• 章节标题输入框必须填写完整字符串 Chapter {章号} {章节标题}，且中间保留一个空格。
• 章节号必须是阿拉伯数字，不得写中文数字。
• 起点是分卷平台，章节号必须使用所在卷内的相对章节号，不做跨卷累加。
• “ADD AUTHOR'S THOUGHT” 必须先弹出对话框，再在对话框里录入“作者有话说”。
• “作者有话说”录入后必须点击“SUBMIT”。
• 必须点击“SAVE”完成保存。
• SAVE 后 URL 应变更为 https://inkstone.webnovel.com/novels/chapter/edit/{书籍ID}/{章节ID}；若未变化，必须继续确认，不得直接默认成功。
• 未拿到 章节Id 时，不得把本章标记为完全成功。
• 账号密码仅用于当次登录，不写入产物文件、不外泄。

失败与回退处理

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

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

• inkstone.webnovel.com 的登录步骤必须留给用户手动完成；这是硬边界，不要替用户“代劳”到过线。
• 编辑页左上角通常会显示卷编号和卷名称，这是确认当前卷的关键锚点。
• ADD AUTHOR'S THOUGHT 不是直接文本框，而是先弹出对话框，再在对话框里输入内容。
• SUBMIT 后再点 SAVE，能更稳妥地保证“作者有话说”和正文同时落盘。
• SAVE 后最终章节 URL 会变成 https://inkstone.webnovel.com/novels/chapter/edit/{书籍ID}/{章节ID}；该 URL 是提取章节Id 的优先来源。
• 每章结束以“保存成功 + URL 已确认含章节Id + 已回写记录”为完整完成信号；缺任一项都不算真正闭环。

批量上传经验（2026-05-24 40章实战验证）

以下经验基于第1卷第1-40章一次性上传 WebNovel 的实战总结，所有结论均已验证。

1) 正文编辑器变更检测是最大陷阱

WebNovel 的 iframe 富文本编辑器不会自动检测 DOM 变更。仅用 frame.evaluate() 将 innerHTML 设置为正文后，SAVE 按钮虽然可点击，但保存不会成功（URL 不跳转到编辑页，仍停留在 create 页，也无报错提示）。

正确的注入与触发流程：

// 正文注入 + 变更检测（完整正确流程）
const frameEl = await page.locator('iframe').first().elementHandle();
const frame = await frameEl.contentFrame();

// 1. 聚焦编辑器
const body = frame.locator('body');
await body.click();

// 2. 注入正文（按单换行拆分，每一行独立成段）
await frame.evaluate((text) => {
  document.body.innerHTML = '';
  const lines = text.split('\n');
  // 去掉首尾空行
  while (lines.length > 0 && lines[0].trim() === '') lines.shift();
  while (lines.length > 0 && lines[lines.length - 1].trim() === '') lines.pop();
  // 每行一个 <p>，空行用 &nbsp; 占位保留行间距
  for (const line of lines) {
    const trimmed = line.trim();
    const el = document.createElement('p');
    el.textContent = trimmed || '\u00A0';
    document.body.appendChild(el);
  }
}, bodyText);

// 3. 触发编辑器变更检测
await body.press('End');        // 等待 100ms
await body.press('Space');      // 等待 100ms
await body.press('Backspace');  // 等待 300ms
// 点击 SAVE

⚠️ 分段铁律：正文必须按 \n（单换行）拆分，每一行都是独立 <p>，禁止用 \n\n（双换行）合并多行为一段。

WebNovel 英文版章节采用"句句独立成行 + 空行区分大段"的风格，HTML <p>.textContent 中的单换行 \n 会被浏览器折叠成空格，导致相邻行粘连成一个无法阅读的文本块。split('\n\n') 的合并逻辑在此场景下是致命错误，会造成已上传章节失去全部分段。已上传章节需以 split('\n') 方式重新上传覆盖修复。<｜end▁of▁thinking｜>

<｜｜DSML｜｜tool_calls> <｜｜DSML｜｜invoke name="replace_string_in_file"> <｜｜DSML｜｜parameter name="filePath" string="true">d:\Users\lorns\OneDrive\第二职业\网文写作\坍缩侦探\小说分发\分发-WebNovel\SKILL.md

教训：不要假设"内容可见 = 编辑器已识别"。任何直接操作 DOM 的注入方式，末尾必须跟一次真实键盘事件（End → 打印字符 → 删除）来激活编辑器的变更追踪。

2) 草稿恢复弹窗

保存一章后立刻进入下一章的 create 页面，可能弹出：

"There is an unsaved draft from a previous creation. Would you like to use it?"

• 必须点 "Cancel"（不是 USE），确保从空白页开始。
• 若点 "USE"，会加载上一章的残留内容，导致标题/正文混串。
• 用 page.locator('div[class*="modal"] button:has-text("Cancel")') 定位。
• 等待 300ms 让弹窗关闭动画完成。

3) 作者有话说的 "got it!" 教学浮层

首次点击 "ADD AUTHOR'S THOUGHT" 时，会在对话框前面弹出一个教学提示浮层，内含 "got it!" 按钮。必须点击 "got it!" 关闭浮层后，才能操作对话框内的 textarea。

• 定位器：page.locator('button:has-text("got it!")')
• 仅在 isVisible() 时才点击，后续章节可能不再出现。
• 若跳过此步骤，textarea 被浮层遮挡，fill() 会超时或写入错误元素。

4) 标题输入框的清空方式

不能只用 fill(text)，因为旧值可能残留。必须三步：

titleInput.click()
titleInput.fill('')     // 先清空
titleInput.fill(text)   // 再填入

5) 内容服务器 + 小批次预取策略（推荐）

对 10 章以上批量场景：

1. 预处理：用脚本将所有章节提取到 .cache/content_parts/no_part/v{卷号}/ 目录（格式：{两位章号}_title.txt、{两位章号}_body.txt、{两位章号}_author.txt）。
2. 启动服务器：$env:CONTENT_PARTS_PORT='8765'; $env:DISTRIBUTION_PLATFORM_DIR='WebNovel'; node scripts/content_parts_server.mjs
3. 预取到内存：每小批次开始前，先 navigate 到 http://127.0.0.1:8765/parts/v/1/{章号} 获取 JSON，存入内存对象。
4. 再开始上传循环：从内存取数据，不用每章重新读文件。
5. 注意 CORS：HTTPS 页面不能直接 fetch HTTP。Playwright 代码中必须先用 page.goto('http://127.0.0.1:8765/...') 获取数据，再 navigate 回 inkstone。

6) 各步骤等待时间的经验值

步骤	建议等待	说明
页面跳转后	1500ms	等 iframe 编辑器和 JS 初始化完成
正文注入后 + 触发变更	300ms	等编辑器消化 input 事件
ADD AUTHOR'S THOUGHT 点击后	1000-1500ms	等对话框 + 浮层完整加载
SUBMIT 后	500-800ms	等对话框关闭、内容落位
SAVE 后	2500-3000ms	等服务器保存 + URL 跳转
Cancel 草稿弹窗后	300ms	等弹窗消失

7) 失败的常见信号

症状	根因	修复
SAVE 后 URL 仍为 /chapter/create/...	编辑器未检测到内容变更	在注入正文后加 End→Space→Backspace
上传后章节无分行分段，正文为一整块	用 split('\n\n') 合并多行为一段，textContent 中 \n 被 HTML 折叠	改用 split('\n')，每行独立 <p>
标题未更新	直接用 fill() 未先清空	先 fill('') 再 fill(text)
作者有话说未保存	未点 SUBMIT 或浮层遮挡	先消 "got it!" 浮层，再填 textarea + SUBMIT
章节内容串到上一章	草稿弹窗点了 USE	点 Cancel 清空后重新填写
章节Id 缺失但保存成功	URL 未跳转或跳转延迟	等待更长时间（3000ms+），或用 page.url() 确认

8) 对账机制

每个小批次（5-10章）结束后必须对账：

• 计划章数 = 成功章数 + 失败章数
• 所有成功章必须都有 章节Id（从 URL 中提取）
• 所有成功章必须已写入 分发记录.md
• 缺任一项 → 暂停下一批次，先补漏

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

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

1. 输入是否齐全

   • 已明确本次只上传哪些章节（不扩范围）。
   • WebNovel/README.md 可读到用户名、密码、书籍Id、书名、卷名。

2. 目标是否正确

   • 当前编辑页书名、卷名与 README.md 一致。
   • 本章模式已判定：无 章节Id 走新建（/chapter/create/{书籍ID}），有 章节Id 走修改（/chapter/edit/{书籍ID}/{章节ID}）。

3. 关键输入是否到位

   • 标题框是完整格式：Chapter {章号} {章节标题}（Chapter + 阿拉伯数字 + 一个空格）。
   • 正文已确认写入编辑器可见区（不是误填到别处）。
   • “作者有话说”已通过 “ADD AUTHOR'S THOUGHT” 打开对话框、已填、已点“SUBMIT”。

4. 保存与回写是否闭环

   • 已点击“SAVE”并确认成功。
   • 已拿到最终 章节Id（URL 变更为 /novels/chapter/edit/{书籍ID}/{章节ID}）。
   • 已回写 WebNovel/分发记录.md，且 章节唯一键 中 | 已按 Markdown 需要妥善处理。

5. 失败是否明示

   • 若登录未完成、保存失败、章节Id 未拿到、记录未写入：必须标记失败/部分成功并说明阻塞点。

完成检查清单

• 已读取 WebNovel/README.md 并提取必需字段。
• 已按指定章节列表逐章执行上传。
• 已在每章执行前查询 WebNovel/分发记录.md 并正确选择新建/修改 URL。
• 每章均完成：标题输入框、正文、作者有话说、点击 SAVE。
• 每章保存后均已确认 URL 已变更到章节编辑地址，并提取 章节Id。
• 每章均已记录或更新到 WebNovel/分发记录.md（含章节与章节Id映射）。
• 每章上传前均完成目标作品信息校验。
• 已输出每章结果（成功 / 失败 / 部分成功及原因）。