���发 ���猫小说 Agent Skill

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

上传指定章节小说到七猫小说网并保存为草稿

用于把你指定的 1 章或多章，上传到七猫小说网对应作品下，并全部保存为草稿。

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

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

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

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

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

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

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

何时使用

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

不适用情形

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

输入前置要求（强制）

1) 章节文件目录

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

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

• 章节标题来源于章节文件内容，通常是第 1 行的 Markdown 标题行（以 # 开头）。
• 该标题行有时会带章节编号，有时只有标题文本；两种都合法。
• 若章节文件标题行为 # 1.1.3 三分钟，其中 1.1.3 表示 部号.卷号.章号；提取时必须只取最后一段 3 作为源章号，三分钟 作为“章节标题”。
• 填写七猫“章节标题”输入框时只允许使用标题文本 三分钟；若页面另有章节号字段或后续需要换算绝对章节号，也只能使用最后一段章号 3，不得把 1.1.3 原样上传。
• 填写到七猫“章节标题”输入框时，应使用提取后的标题文本，不得直接使用文件名。

2) 元数据来源

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

2.1) 平台校验（强制）

读取 七猫小说/readme.md（或 七猫小说/README）后，必须检查其第一行一级标题是否等于 # 七猫小说分发配置：

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

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

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

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

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

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

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

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

# 七猫小说分发记录

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

## 字段说明

- `章节唯一键`：固定格式 `七猫书籍ID|分部名|卷号|章号|章名`（无分部时分部名填 `NA`）
- `七猫书籍ID`：对应 `七猫小说/readme.md` 或 `七猫小说/README` 中书籍ID
- `章节Id`：章节保存后返回的纯数字
- `最近操作`：`新建` 或 `修改`
- `更新时间`：`YYYY-MM-DD HH:mm:ss`
- `备注`：可选

## 记录表

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

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

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

# 七猫小说分发配置

> 用途：存储七猫小说网账号、书籍信息与卷名映射。分发流程将读取此文件。

## 账号信息

- 用户名：`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：读取本地输入

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

步骤 1.5：计算绝对章节编号（不分卷口径）

• 七猫按不分卷平台处理，章节号使用“绝对章节号”口径。
• 计算公式：
• 绝对章节号 = 前面各卷章节数之和 + 该章节在所在卷的相对章号。
• 示例：
• 若第1卷有90章、第2卷有100章：
• 第1卷第5章 → 绝对章节号第5章；
• 第2卷第5章 → 绝对章节号第95章；
• 第3卷第5章 → 绝对章节号第195章。
• 若 分发记录.md 不存在或无历史记录，则按上述公式从已知卷章结构计算；无法确定前卷章数时需先补齐台账后再发布。
• 页面若“第X章”不可编辑，则仅用于校验；以平台显示值为准继续流程。

步骤 2：进入作者后台

• 必须新开一个浏览器标签页，并在该新标签页访问：
• https://zuozhe.qimao.com/front/book-manage
• 该新标签页仅用于本次七猫上传流程，不复用你当前正在进行其他任务的标签页。
• 若出现登录态失效或未登录：
• 使用 readme/README.md 中的用户名和密码登录。
• 若登录后页面提示需要验证码或其他二次验证：
• 必须立即暂停流程，等待用户手动完成验证并明确反馈“登录完成”。
• 在收到“登录完成”反馈前，不得继续任何后续步骤、不得伪造成功态。

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

• 在访问前，先查询 七猫小说/分发记录.md 中该章节是否已有 章节Id。
• 若该章节 没有 章节Id（新建模式），访问：
• https://zuozhe.qimao.com/front/book-upload?id={书籍Id}
• 若该章节 已有 章节Id（修改模式），访问：
• https://zuozhe.qimao.com/front/book-upload?id={书籍Id}&cid={章节Id}
• 页面加载后，记录当前 URL；注意新建章节后 URL 不会出现章节Id，需在“存为草稿”后回查。
• {书籍Id} 必须来自 readme/README.md，且是数字串。

步骤 4：校验左上角书名

• 检查页面左上角显示是否匹配：
• “{小说名}”
• 若不匹配：
• 立即停止当前章上传。
• 返回错误说明（书名不一致）。
• 禁止继续盲传到错误作品。

步骤 5：填写章节标题区

• 七猫章节编号如“第2章”无法修改，直接跳过。
• 章节标题填写为章节内容第1行提取的标题。

步骤 6：填写正文（Quill 编辑器——必须有键盘粘贴，禁用 fill() / DOM 操作）

> ▲ 高警告：该编辑器的 Quill 内核会把 fill()、innerHTML、appendChild 等 DOM 直写视为"非法外部操作"，导致正文被截断至 30–60% 且无任何报错。这是本 Skill 历史上最严重的事故根因。下方是唯一安全方法。

• 前置：将正文复制到系统剪贴板
• 使用 PowerShell 或 Playwright 调用系统剪贴板 API 将清理后的正文写入剪贴板：

   # PowerShell 示例（从文件提取正文并去掉标题行和后记）：
   $c = [System.IO.File]::ReadAllText($chapterPath)
   $body = $c -replace '(?s)^# .+?\n\n',''
   $body = $body -replace '(?s)\n\n## 作者有话说.*',''
   Set-Clipboard $body

• 或在 Playwright 中用 navigator.clipboard.writeText(fullBody)。

• 填入标题后，聚焦正文编辑器
• 定位 .q-contenteditable.book 第一个元素，点击使其获得焦点。
• 点击后等待至少 200ms 确保编辑器就绪。

• 全选 + 清空（避免残留）
• 发送 Control+A（全选），然后 Delete（删除选中内容）。
• 等待至少 200ms。

• 粘贴正文
• 发送 Control+V。
• 必须等待至少 3 秒给 Quill 完成异步内容处理（大段正文可能需要更久，安全值为 3–5 秒）。

• 清理粘贴自带的 Markdown 头尾（关键副步骤）
• 粘贴后编辑器会包含源文件中的 #第N章 行和 ##作者有话说/## 章节后记 等不应出现在正文的区域。
• 用 Playwright 执行 DOM 清理：

   const editor = document.querySelector('.q-contenteditable.book');
   const ps = editor.querySelectorAll('p');
   // 移除第一个段落（#第N章行）
   if (ps[0] && ps[0].textContent?.startsWith('#第')) ps[0].remove();
   // 移除 作者有话说 及其后的所有内容
   for (const p of ps) {
     if (p.textContent?.includes('##作者有话说') || p.textContent?.includes('## 作者有话说')) {
       let c = p; while (c) { const n = c.nextElementSibling; c.remove(); c = n; } break;
     }
   }
   // 触发 Quill 的 input 事件，刷新字数统计
   editor.dispatchEvent(new Event('input', { bubbles: true }));

• 字数验证（强制——少一个字都不行）
• 清理后立即读取页面上的"当前字数"显示：

     const wcMatch = document.body.textContent.match(/当前字数(\d+)/);
     const actual = wcMatch ? parseInt(wcMatch[1]) : 0;
     const source = sourceBody.length;  // 步骤 1 中提取的源文件正文字数

• 判定标准：实际字数必须 ≥ 源文件正文字数。少一个字都不行。
• 若实际字数 < 源文件正文字数，立即判定为截断事故，必须重试步骤 6（重新粘贴），不得继续存草稿。
• 若连续 2 次粘贴实际字数仍 < 源文件正文字数，说明键盘粘贴路径可能也被干扰，应暂停并人工介入。

• 必须确保正文来自你指定的章节文件，不得错章串章。

> 附录：事故核验清单

> - 实际字数是否 ≥ 源文件正文字数？（少一个字都不行）

> - 编辑器内是否能看到大段连续正文（而非仅前几段）？

> - 编辑器内是否包含"#第"行或"## 作者有话说"残留？

> - 字数计数器是否为零（编辑器可能未获取焦点，需重激活后重试）？

步骤 7：添加作者有话说（Quill 编辑器——同样禁用 fill()）

• 作者有话说直接在章节编辑页面出现，无需点击按钮。
• 输入前必须全选清空旧内容（Control+A → Delete），再粘贴本章"作者有话说"内容。
• 粘贴方式同步骤 6：先将内容复制到剪贴板，聚焦编辑器后 Control+V，避免 fill() 造成截断。
• 输入后必须检查计数器（常见 X/300）：
• 若超限，按“保钩子优先”压缩到平台限制内再保存。
• 若未超限，保持原文语义并保存。

步骤 8：保存草稿（更新后）

• 点击“存为草稿”按钮。
• 注意：点击后可能出现“重要提醒”弹窗。
• 若出现弹窗，必须等待弹窗上的“我已阅读并知晓”按钮变为可点击状态（通常约 5 秒），再点击该按钮完成确认。
• 未点击“我已阅读并知晓”前，不得判定为保存成功。
• 等待页面反馈已保存成功（或等价成功提示）。
• 保存成功后，切换到草稿箱选项卡：
• 访问 URL：https://zuozhe.qimao.com/front/book-manage/draft?id={书籍Id}。
• 草稿箱使用七猫作者后台域名 zuozhe.qimao.com。
• 若页面弹出“重要提醒 / 我已阅读并知晓”确认弹窗，必须先等待按钮可用（通常约 5 秒）并点击确认后，草稿才会真正入库。
• 从草稿列表中找到目标章节行，点击“修改”后，从跳转 URL 中提取 cid 作为章节ID。
• 将“章节唯一键 + 章节Id + 更新时间”写回 七猫小说/分发记录.md：
• 若记录不存在：新增一条。
• 若记录已存在：仅更新 章节Id（如变化）和更新时间。

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

> - 使用字段顺序：七猫书籍ID|分部名|卷号|章号|章名

> - 其中：

> - 七猫书籍ID 来自 readme/README.md

> - 分部名 使用当前分部书名；无分部填 NA

> - 卷号、章号 必须是阿拉伯数字

> - 该规则用于彻底避免多部小说下“同卷同章号”冲突。

步骤 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 必须使用新标签页进入作者后台，禁止占用用户正在使用的原标签页。
• 步骤 6（正文输入）必须使用系统剪贴板 + Ctrl+V 方式，绝对禁止使用 fill()、innerHTML、appendChild 等 DOM 直写操作（详见步骤 6 与实操复盘章节）。
• 正文粘贴后必须验证字数：实际字数 < 源文件正文字数 即为截断事故，少一个字都不行，必须重贴。
• 每章进入步骤 3 前，必须先查询 七猫小说/分发记录.md。
• 新建与修改章节的 URL 必须按记录自动分流，禁止混用。
• 每章“存为草稿”成功后，必须把最新 章节Id 回写到 七猫小说/分发记录.md。
• 点击“存为草稿”后若出现“重要提醒”弹窗，必须等待“我已阅读并知晓”按钮可用（通常约 5 秒）再点击确认。
• 每章都必须经过“书名匹配检查”后再写入内容。
• 章节标题必须来自章节文件内容（通常第1行 # 标题行），不得以文件名充当标题。
• 章节号必须是阿拉伯数字，不得写中文数字。
• 七猫按不分卷平台处理，章节编号采用“绝对章节号”口径进行判定与校验。
• 作者有话说直接在章节编辑区输入，无需点击按钮。
• 作者有话说录入前建议先清空编辑框，再粘贴本章文本。
• 作者有话说必须满足平台字数限制（常见 300 字）后再保存。
• 最终动作是“存为草稿”，不是发布。
• 账号密码仅用于当次登录，不写入产物文件、不外泄。

失败与回退处理

• 登录失败：提示账号/密码错误并停止，不继续后续章节。
• 登录被拦截为验证码登录：必须立即暂停流程，等待用户手动完成验证并明确反馈“登录完成”；在收到该反馈前不得继续任何后续步骤。
• 页面元素缺失（如按钮改版）：记录当前失败步骤并停止本章，继续尝试下一章前需先确认页面可操作。
• 书名不匹配：直接停止该书上传流程，要求先修正 readme/README.md 或目标链接。
• 存为草稿失败：本章标记失败，重试后仍失败则保留失败记录并继续下一章（除非用户要求遇错即停）。
• 作者有话说保存失败：本章先不发布，重试“编辑有话说 → 存为草稿”链路；仍失败则记录原因并继续下一章（除非用户要求遇错即停）。
• 分发记录.md 写入失败：本章虽然可能已存草稿，但流程状态必须标记为“部分失败（记录未落盘）”，并立即提示人工补录，禁止静默成功。

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

• 先校验左上角书名，再填任何正文内容；顺序不能反。
• 新建章节后 URL 不会出现章节Id，需在“存为草稿”后回查草稿箱获取章节Id。
• 草稿箱里如果能看到目标章节行，优先点击该行的“修改”，从跳转后的 URL 里提取 cid，这是回查章节ID最稳的方式。
• 上传页第一次点击“存为草稿”后，常会出现“重要提醒 / 我已阅读并知晓”弹窗；必须等该按钮可用（通常约 5 秒）再点击，不先确认或过早点按，保存可能不会真正落到草稿箱。
• 正文粘贴后要观察顶部“已保存/保存中”与正文字数是否增长，避免“看起来贴上了实际未落盘”。
• 作者有话说编辑器与正文编辑器并存，必须确认焦点在有话说编辑区再输入。
• 每章结束以“保存成功”提示为唯一完成信号；没有成功提示就不算完成。

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

• 标题上限必须前置门禁：七猫标题上限按 20 字严格裁剪。实操中第 13/14/15/17/18/19/20/22/25/26/30/36/38/40 章原始标题超过上限，后续统一改短后再执行“修改草稿”才稳定落库。
• 标题输入控件是 textarea，不是 input：章节名定位优先使用 textarea[placeholder*="章节名称"]；若误用 input 会出现“可见但无法填值”或超时。
• 批量改标题应强制走 cid 直达：已存在章节必须使用 book-upload?id={书籍Id}&cid={章节Id} 进入“更新草稿”模式，避免误落到“新建草稿”或改错章。
• “保存成功”与“真正入草稿”不是同一事件：点击“存为草稿/更新草稿”后必须处理“我已阅读并知晓”弹窗，再回草稿箱核对；否则会出现页面提示成功但草稿箱字数/条目未变化。
• 草稿箱检索要用“章号 + 标题前缀”双键：草稿列表长标题会被截断，单纯全标题匹配容易漏检；推荐用 第X章 + 标题前8字 命中后再点“修改”回查 cid。
• 分发记录必须同步章名键：章节标题改短后，分发记录.md 的“章节唯一键（含章名）”也要同步更新，并把最近操作标记为 修改；否则后续“新建/修改模式”判定会漂移。
• 批量结束必须做三项对账：
• 本地章节标题与 分发记录.md 章名 mismatch=0；
• 本地标题超长统计 >20 为 0；
• 草稿箱目标章可见且标题前缀命中。

25章批量实战复盘·七猫新版编辑器Quill（2026-06-20）——正文截断事故深度复盘

> 事故定性：使用 fill() / innerHTML / appendChild 操作 .q-contenteditable.book（Quill 富文本编辑器）会导致编辑器悄无声息地丢弃 40–70% 的正文内容，且无任何错误提示。涉及 25 章中至少 12 章被截断，部分章节仅剩 30%。

根因分析

• 七猫后台的正文编辑器基于 Quill.js 框架，它维护内部 Delta 模型来追踪内容。
• fill()（Playwright 的模拟输入）和 innerHTML（DOM 直写）都绕过 Quill 的 Delta 管道，编辑器无法正确解析这些外部变更，造成内容丢失。
• 同样的问题存在于 fill() 方法在 Playwright Chromium 中——它会逐个字符模拟输入，但对长文本 Quill 会频繁触发自身保护机制导致截断。

唯一正确方法：系统剪贴板 → Ctrl+V

// 正确姿势
await page.locator('.q-contenteditable.book').first().click();
await page.waitForTimeout(200);
await page.keyboard.press('Control+a');
await page.keyboard.press('Delete');
await page.waitForTimeout(200);
await page.keyboard.press('Control+v');
await page.waitForTimeout(3000);  // 关键：给 Quill 处理时间

注意 navigator.clipboard.writeText() 在 Playwright 中需在浏览器上下文启用剪贴板权限，推荐用 PowerShell Set-Clipboard 替代更稳定。

字数校验：粘贴后必须检查（少一个字都不行）

• 粘贴并清理后立即读取 document.body.textContent.match(/当前字数(\d+)/)，并与步骤 1 中提取的源文件正文字数比较。
• 判定标准：实际字数必须 ≥ 源文件正文字数。少一个字都不行。
• 若实际字数 < 源文件正文字数，立即判定为截断事故，必须重新粘贴，不得保存。
• 粘贴后建议滚动编辑器确认正文完整（Playwright 可检查段落数是否与源文件一致）。

粘贴后清理的必须性

Ctrl+V 会将源 .md 文件的全部内容（包括 #第N章 头行和 ##作者有话说/##章节后记 尾部）都带入编辑器。必须在粘贴后用 DOM 操作删除这些元数据行，再触发 input 事件让字数统计同步。

连续批量的提效技巧

• 先用 PowerShell 将各章正文循环写入剪贴板（逐一处理，避免串章）。
• 每章之间的衔接：保存后回到草稿箱 → 点"新建草稿" → 填标题 → 聚焦编辑器 → 全选清空 → 粘贴（此时剪贴板已是下一章的正文）。
• 作者有话说编辑器（.q-contenteditable.font-size-14）也是 Quill 实例，同样推荐用键盘粘贴而非 fill()。
• 章回写分发记录时若无 cid，可保存后去草稿箱点该行的"修改"，从跳转 URL 提取 cid 参数。

截断事故快速自检

| 检查项 | 正常 | 截断 |

|--------|------|------|

| 字数占比 | 实际字数 ≥ 源文字数 | 实际字数 < 源文字数 |

| 首段内容 | 正文第一段 | 标题行或乱序 |

| 编辑框滚动 | 可滚动看到完整正文 | 只有前几段 |

| 段落数 | ≈ 源文段落数 | 远少于源文 |

禁止事项（硬规则）

• ❌ NEVER 使用 fill() 对 .q-contenteditable.book 写入正文
• ❌ NEVER 使用 innerHTML / outerHTML / insertAdjacentHTML 注入正文
• ❌ NEVER 使用 appendChild / insertBefore 逐个添加文本节点
• ❌ NEVER 在未验证字数的情况下就点击"存为草稿"
• ✅ 唯一允许：剪贴板 + Ctrl+V + 字数验证

完成检查清单

• 已读取 七猫小说/readme.md 或 七猫小说/README 并提取必需字段。
• 已按指定章节列表逐章执行上传。
• 已在每章执行前查询 七猫小说/分发记录.md 并正确选择新建/修改 URL。
• 每章均完成：章号、章名、正文、作者有话说、存为草稿。
• 每章均完成绝对章节号计算或校验（不分卷口径）。
• 每章均已记录或更新到 七猫小说/分发记录.md（含章节与章节Id映射）。
• 每章上传前均完成“左上角书名”匹配校验。
• 已输出每章结果（成功/失败及原因）。