# 分发 番茄小说

> 用于将“番茄小说/”目录内指定章节批量上传到番茄小说网写作后台并保存为草稿。支持按 README.md 读取账号、密码、书籍ID、书名与卷名校验，自动执行登录、章节信息填写、正文粘贴、作者有话说添加与存草稿循环。关键词：番茄上传、保存草稿、批量传章、番茄写作后台、作者有话说。

- Skill: `lornshrimp/skill-6` (Agent Skill)
- Install (CLI): `npx skillmds@latest add lornshrimp/skill-6`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lornshrimp/skill-6/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/skill-6

---



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

# 上传指定章节小说到番茄小说网并保存为草稿

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


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

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

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

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

后续所有章节文件路径、README.md、分发记录.md 均基于此工作目录。**明确说明**：
  - **本平台是主输出平台时** → 章节文件、`README.md`、`分发记录.md` 均在 `小说正文/` 下
  - **本平台不是主输出平台时** → 章节文件、`README.md`、`分发记录.md` 均在 `番茄小说/` 下

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

## 何时使用

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

## 不适用情形

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

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

### 1) 章节文件目录

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

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

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

### 2) 元数据来源

- 必须读取 `番茄小说/README.md`，至少提取以下信息：
  - 番茄小说网用户名
  - 番茄小说网密码
   - 小说书籍 ID（纯数字，如 `7605776437705985086`；按“书籍Id判定规则”选取当前章节对应值）
   - 小说名称（小说书名，用于当前上传目标）
  - 每一卷卷名
### 2.1) 平台校验（强制）

读取 `番茄小说/README.md` 后，必须检查其第一行一级标题是否等于 `# 番茄小说分发配置`：
  - **匹配** → 继续执行后续流程
  - **不匹配** → 立即停止上传，并向用户报错：`README.md 平台标识与当前 Skill 不符：预期"番茄小说分发配置"，实际读取到"{实际读取到的标题}"。请检查是否将其他平台的 README.md 误放到了当前工作目录。`
### 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 中 `publish/` 后的数字
- `最近操作`：`新建` 或 `修改`
- `更新时间`：`YYYY-MM-DD HH:mm:ss`
- `备注`：可选

## 记录表

|章节唯一键|书籍ID|章节Id|最近操作|更新时间|备注|
|:--|--:|--:|:--|:--|:--|
```
### 6) `README.md` 模板（首次创建直接使用）

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

```markdown
# 番茄小说分发配置

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

## 账号信息

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

## 书籍信息

### 无分部小说

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

### 有分部小说

| 分部号 | 分部名 | 书籍ID |
|:--|:--|:--|
| 第1部 | 分部一书名 | 7605776437705985086 |
| 第2部 | 分部二书名 | 7605776437705985087 |

## 卷名映射

### 分部一书名

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

### 分部二书名

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

## 字段说明

- `小说名称` / `分部名`：必须精确匹配 SKILL 中的"书名判定规则"
- `分部号`：必须使用 `第N部` 规范格式（如 `第1部`、`第2部`），并与 `分部名` 一一对应，不得错位或复用
- `书籍ID`：通常为大整数（如 `7605776437705985086`）

## 安全提醒

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

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

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

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

1. **必须新开一个浏览器标签页**，并在该新标签页访问：
   - `https://fanqienovel.com/main/writer/book-manage`
2. 该新标签页仅用于本次番茄上传流程，不复用你当前正在进行其他任务的标签页。
3. 若出现登录态失效或未登录：
   - 必须切换到“密码登录”
   - 使用 `README.md` 中的用户名和密码登录
4. 若密码登录后页面提示“为保证账号安全，请使用手机验证码登录”或同类提示：
   - 必须立即暂停流程，等待用户手动完成验证并明确反馈“登录完成”
   - 在收到“登录完成”反馈前，不得继续任何后续步骤、不得伪造成功态

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

1. 在访问前，先查询 `番茄小说/分发记录.md` 中该章节是否已有 `章节Id`。
2. 若该章节 **没有** 章节Id（新建模式），访问：
   - `https://fanqienovel.com/main/writer/{书籍ID}/publish/?enter_from=newchapter`
3. 若该章节 **已有** 章节Id（修改模式），访问：
   - `https://fanqienovel.com/main/writer/{书籍ID}/publish/{章节Id号}`
4. 页面加载后，记录当前 URL；从 `publish/` 后到 `?` 前（若无 `?` 则到路径结尾）的纯数字即该章节 `章节Id`。
5. `{书籍ID}` 必须来自 `README.md`，且是数字串。

### 步骤 4：校验左上角书名与卷名

1. 检查页面左上角显示是否匹配：
   - `“{小说名} 第X卷：{卷名}”`
2. 示例：`归墟 第一卷：门禁不认我`
3. 若不匹配：
   - 立即停止当前章上传
   - 返回错误说明（书名/卷名不一致）
   - 禁止继续盲传到错误作品

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

目标区域格式为：`第_章 未命名草稿`

1. 将 `_` 替换为阿拉伯数字章节号（如 `5`）。
2. 将 `未命名草稿` 替换为实际章节标题（来源于文件内容，通常为第1行 `# ` 标题行），不得使用文件名。

### 步骤 6：填写正文

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

### 步骤 7：添加作者有话说

1. 点击“作者有话说”。
2. 点击“+添加”。
3. 选择“添加图文”。
4. 在出现的输入框中**先全选清空旧内容**，再输入该章“作者有话说”内容，避免与历史文本拼接。
5. 输入后必须检查计数器（常见为 `X/300`）：
   - 若超限，按“保钩子优先”压缩到平台限制内再保存。
   - 若未超限，保持原文语义并保存。
6. 点击有话说区域内“保存/完成”（若页面存在该按钮），确认有话说已落盘。

### 步骤 8：保存草稿

1. 点击右上角“存草稿”。
2. 等待页面反馈已保存成功（或等价成功提示）。
3. 保存成功后，将“章节唯一键 + 章节Id + 更新时间”写回 `番茄小说/分发记录.md`：
   - 若记录不存在：新增一条。
   - 若记录已存在：仅更新 `章节Id`（如变化）和更新时间。

> 章节唯一键生成规则（强制）：
> - 使用字段顺序：`书籍ID|分部名|卷号|章号|章名`
> - 其中：
>   - `书籍ID` 来自 `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 必须使用**新标签页**进入作者后台，禁止占用用户正在使用的原标签页。
- 每章进入步骤 3 前，必须先查询 `番茄小说/分发记录.md`。
- `publish/{章节Id}` 与 `publish/?enter_from=newchapter` 两种地址必须按记录自动分流，禁止混用。
- 每章“存草稿”成功后，必须把最新 `章节Id` 回写到 `番茄小说/分发记录.md`。
- 每章都必须经过“书名/卷名匹配检查”后再写入内容。
- 章节标题必须来自章节文件内容（通常第1行 `# ` 标题行），不得以文件名充当标题。
- 章节号必须是阿拉伯数字，不得写中文数字。
- 番茄是分卷平台，章节号必须使用所在卷内的相对章节号，不做跨卷累加。
- “作者有话说”必须通过“作者有话说 → +添加 → 添加图文”路径录入。
- 作者有话说录入前必须先清空编辑框，再粘贴本章文本。
- 作者有话说必须满足平台字数限制（常见 300 字）后再保存。
- 最终动作是“存草稿”，不是发布。
- 账号密码仅用于当次登录，不写入产物文件、不外泄。
- 默认**不使用系统剪贴板**作为正文主通道；正文应优先使用“直接写入编辑器”的方式，避免被外部应用覆盖导致错章/串章。
- 仅在页面控件限制导致无法直接写入时，才允许剪贴板作为应急方案；且必须执行“剪贴板防污染检查”（见下文）。

## 失败与回退处理

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

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

- 先校验左上角书名+卷名，再填任何正文内容；顺序不能反。
- 新建页在首次进入后，URL 常会变成 `.../publish/{章节Id}?`，该 `章节Id` 必须提取并回写到分发记录。
- 正文粘贴后要观察顶部“已保存/保存中”与正文字数是否增长，避免“看起来贴上了实际未落盘”。
- 作者有话说编辑器常与正文编辑器并存，必须确认焦点在有话说编辑区再输入。
- 每章结束以“保存成功”提示为唯一完成信号；没有成功提示就不算完成。

### 本轮 1–40 章新增经验（2026-05-20 回写）

- “添加图文”经常不会直接出现，必须先点一次精确文本“添加”再选“添加图文”；不要用宽匹配 `text=添加`，容易命中“添加更多设定”等无关元素。
- 若本章流程超时，不要立刻重传整章；先读当前页状态（章号/章名/正文字数/保存态），很多情况下正文已落盘，只需补“作者有话说 + 存草稿 + 复开校验”。
- 标题提取需容错：有些章节 `#` 标题不带 `1.1.X` 编号，章号应回退到文件名解析；若 `#` 标题带编号（如 `# 1.1.27 ...`），上传前要剥离前缀，只填纯标题文本。
- 新建页回看时优先使用干净 URL `.../publish/{章节Id}` 复核；部分带 `?enter_from=newchapter` 的地址可能影响稳定复开。
- 分发记录必须“每章即时回写”，不要批量后补；一旦中断，已上传章节也不会丢失映射。
- 若误写了未实际上传成功的记录，必须立即从 `分发记录.md` 回滚，保持“台账事实与后台事实一致”。
- 作者有话说常超 300 字，实操中应默认准备“保钩子优先”的压缩版本，优先保留：本章回报点 → 风险判断 → 下一章驱动。
- 大批量场景下，系统剪贴板存在被其他应用覆盖的现实风险；因此应将“直接写入编辑器”设为默认，剪贴板仅保留为应急通道。

### 剪贴板防污染检查（仅应急通道启用）

1. 粘贴前记录本章正文长度（或摘要哈希）作为基准。
2. 粘贴后立刻检查页面正文字数是否达到预期阈值（不得仅看“已保存到云端”）。
3. 若字数明显偏小/偏大、出现上一章片段、或标题与正文语义不一致，立即执行：
   - 全选正文清空
   - 重新装载本章正文
   - 再次粘贴并复核字数
4. 连续两次异常即判定“剪贴板污染风险”，本章改为“直接写入编辑器”方案，不再使用粘贴。
5. 若流程耗时较长（>10分钟）或存在多应用并行，默认跳过剪贴板，直接走非剪贴板方案。

## 完成检查清单

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