# 分发-WebNovel
> 用于将 `WebNovel/` 目录内指定章节批量上传到 WebNovel（Inkstone）作者后台并保存。支持按 `WebNovel/README.md` 读取账号、密码、书籍Id、书名与卷名校验，自动进入新建/修改章节页，填写合并标题输入框，录入正文与作者有话说，保存后循环处理下一章。关键词：WebNovel 上传、Inkstone、章节保存、批量传章、作者有话说、章节编辑。
- Skill: `lornshrimp/webnovel` (Agent Skill)
- Install (CLI): `npx skillmds@latest add lornshrimp/webnovel`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lornshrimp/webnovel/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: lornshrimp (https://skillmd.com/u/lornshrimp)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/lornshrimp/webnovel
---
# 上传指定章节到 WebNovel 并保存
用于把你指定的 1 章或多章，上传到 WebNovel（Inkstone）对应作品下，并按后台要求保存。
## 工作目录路由规则（强制）
本 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` 不存在时，必须按以下模板创建：
```markdown
# 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` 不存在时，必须按以下模板创建：
```markdown
# 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 页，也无报错提示）。
**正确的注入与触发流程：**
```javascript
// 正文注入 + 变更检测（完整正确流程）
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();
// 每行一个 ，空行用 占位保留行间距
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`（单换行）拆分**，每一行都是独立 `
`，**禁止用 `\n\n`（双换行）合并多行为一段**。
>
> WebNovel 英文版章节采用"句句独立成行 + 空行区分大段"的风格，HTML `
.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')`，每行独立 `
`** |
| 标题未更新 | 直接用 `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映射）。
- 每章上传前均完成目标作品信息校验。
- 已输出每章结果（成功 / 失败 / 部分成功及原因）。