---
name: 分发-知乎小说
description: 用于将“知乎小说/”目录内指定章节批量上传到知乎作者后台并保存稿件。支持按 README.md 读取账号、密码、知乎书籍ID与书名校验，自动执行登录、进入作品管理、按新建/修改分流填写平台合规标题与正文、保存稿件，并回写章节Id到分发记录。关键词：知乎上传、保存稿件、批量传章、知乎作者后台、中长篇作品、增加小节。
argument-hint: 给我 chapterPath 或 chapterPaths（位于“知乎小说/”目录），我会按 README.md 的账号与书籍信息逐章上传并保存稿件，同时回写章节Id。
---

# 上传指定章节到知乎并保存稿件

用于把你指定的 1 章或多章，上传到知乎作者后台对应作品下，并全部保存为稿件。

## 何时使用

- 你已经把待上传章节放入 `知乎小说/` 目录。
- 你已经在 `知乎小说/README.md` 写好账号、密码、知乎书籍ID、书名信息。
- 你希望按固定流程自动完成：登录 → 进入作品管理 → 判断新建/修改模式 → 填写章节标题与正文 → 保存稿件 → 回写章节Id。

## 不适用情形

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

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

### 1) 章节文件目录

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

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

- 必须从章节文件中提取：章节号（阿拉伯数字）、章节标题、正文。
- 知乎章节标题框是**单一输入框**，且当前实测存在 **15 字上限**。
- 标题填写应以平台可保存为最高优先级：
   - 优先使用精简标题文本（建议不带 `第X章` 前缀），控制在 15 字内。
   - 若原始标题超限，必须先压缩标题，再执行保存稿件。
- 分卷/章号信息不强制写入知乎标题框，应通过分发记录保持“卷号/章号/章名”的映射一致性。

### 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` 模板（首次创建直接使用）

```markdown
# 知乎小说分发记录

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

## 字段说明

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

## 记录表

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

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

```markdown
# 知乎小说分发配置

> 用途：存储知乎账号与书籍信息。分发流程将读取此文件。

## 账号信息

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

## 书籍信息

### 无分部小说

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

### 有分部小说

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

## 字段说明

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

## 注意事项

- 知乎章节标题有 15 字上限，超限将被截断
- 分发流程会自动压缩标题至 15 字内

## 安全提醒

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

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

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

### 步骤 1.5：计算绝对章节编号（沿用七猫口径）

1. 章节编号统一使用“绝对章节编号”口径，不使用局部编号口径。
2. 计算方式：
   - 读取 `分发记录.md` 中同一目标书籍Id下全部已记录章节；
   - 依据 `卷号`、`章号`排序后，计算当前章节在全书中的绝对序号。
3. 对知乎不分卷发布场景，章节号使用绝对章节号，计算公式为：
   - `绝对章节号 = 前面各卷章节数之和 + 该章节在所在卷的相对章号`。
4. 示例：
   - 若第1卷有90章、第2卷有100章：
   - 第1卷第5章 → 绝对章节号第5章；
   - 第2卷第5章 → 绝对章节号第95章；
   - 第3卷第5章 → 绝对章节号第195章。
5. 若 `分发记录.md` 不存在或无历史记录，则按上述公式从已知卷章结构计算；无法确定前卷章数时需先补齐台账后再发布。
6. 绝对章节编号主要用于分发记录与校验，不强制写入站内标题框。

### 步骤 2：登录知乎作者后台

1. **必须新开一个浏览器标签页**，并在该新标签页访问：
   - `https://www.zhihu.com/author-platform/home/management`
2. 该新标签页仅用于本次知乎上传流程，不复用你当前正在进行其他任务的标签页。
3. 若出现未登录状态：
   - 进入登录流程后选择“密码登录”。
   - 输入 `README.md` 中的用户名和密码完成登录。
4. 登录成功后，必须停留在作品管理页：
   - `https://www.zhihu.com/author-platform/home/management`

### 步骤 3：进入作品管理并定位目标作品（新建模式前置）

> 本步骤是知乎新建章节的硬前置：**新增章节不能靠手改 URL 进入，必须从页面左下角“增加小节”按钮进入。**

1. 在作品管理页选择“中长篇作品”。
2. 在作品列表中定位目标作品：
   - 作品名称列会显示“作品名称 + 作品ID”。
   - 作品名称可点击。
3. 点击目标作品名称进入内容编辑页。
4. 在内容编辑页左上角校验书名是否与 `README.md` 中目标书名一致。
   - 不一致则立即停止，不得继续上传。
5. 若进入后出现“编辑器使用说明”等浮层：
   - 先关闭浮层，再执行“增加小节/填写正文/保存稿件”。
   - 未关闭前不得误判为按钮失效或页面改版。

### 步骤 4：新建/修改分流

1. 每章开始前，先查 `知乎小说/分发记录.md`：
   - 若已有 `章节Id`：走**修改模式**。
   - 若无 `章节Id`：走**新建模式**。

2. 修改模式：
   - 直接访问：`https://www.zhihu.com/author-platform/writer?id={章节Id}&step=2`
   - 再次确认页面仍属于目标书籍。

3. 新建模式（必须通过按钮进入）：
   - 在目标作品内容编辑页点击左下角“增加小节”按钮。
   - 跳转后会进入新建章节地址，URL 形如：
     - `https://www.zhihu.com/author-platform/writer?id={章节Id}&step=2`
   - 从 URL 中提取新生成的 `{章节Id}`（纯数字）。

### 步骤 5：填写章节标题与正文

1. 先确认当前章的绝对章节编号（来自步骤 1.5）。
2. 在章节标题输入框填写平台合规标题（建议不带 `第X章` 前缀）。
3. 必须确保标题长度不超过 15 字（界面通常显示为 `X/15`）。
4. 若标题超限（如 `27/15`），先压缩标题后再保存稿件。
5. 在正文编辑区粘贴该章正文。
6. 知乎无“作者有话说”输入区域，**不要尝试填写作者有话说**。

### 步骤 6：保存稿件并回写记录

1. 点击页面底部“保存稿件”按钮。
2. 等待页面反馈保存成功（或等价成功提示）。
3. 将“章节唯一键 + 章节Id + 更新时间”写回 `知乎小说/分发记录.md`：
   - 若记录不存在：新增一条。
   - 若记录已存在：更新 `章节Id`（如变化）和更新时间。

### 步骤 7：多章循环（知乎特有）

- 对每个指定章节重复步骤 4～6，直到全部章节完成。
- **强制规则**：当要继续新增下一章时，不能依赖手改 URL 进入新建页；必须回到作品内容编辑页，再次点击左下角“增加小节”按钮，获取新的章节 URL 与新的章节Id。
- 只有“修改已有章节”时，才允许直接通过 `writer?id={章节Id}&step=2` URL 进入。

## 关键边界与硬规则

- 必须只上传用户明确指定的章节，不得擅自扩展范围。
- 步骤 2 必须使用**新标签页**进入知乎后台，禁止占用用户正在使用的原标签页。
- 作者后台入口固定为：`https://www.zhihu.com/author-platform/home/management`。
- 新建章节必须从“中长篇作品 → 目标作品 → 左下角增加小节”链路触发；禁止通过拼接 URL 伪造新建。
- 修改章节地址固定为：`https://www.zhihu.com/author-platform/writer?id={章节Id}&step=2`。
- 每章最终保存动作必须是“保存稿件”。
- 章节标题必须满足知乎编辑器当前 15 字上限；超限必须先压缩再保存。
- 不要求在知乎标题中强行写入 `第X章`；卷号/章号以分发记录台账为准。
- 章节编号统一采用“绝对章节编号”口径进行判定与校验；知乎不分卷场景按单序列连续递增。
- 知乎没有“作者有话说”输入位，分发流程中不做该字段写入。
- 每章保存成功后必须回写 `知乎小说/分发记录.md`。
- 账号密码仅用于当次登录，不写入产物文件、不外泄。

## 失败与回退处理

- 登录失败：提示账号/密码错误并停止，不继续后续章节。
- 出现二次验证（验证码/滑块）：必须立即暂停流程，等待用户手动完成验证并明确反馈“登录完成”；在收到该反馈前不得继续任何后续步骤。
- 登录后若再次触发二次验证（接口 400/403 或验证弹窗）：仍按“必须暂停并等待用户反馈登录完成”处理，不得假定登录态永久有效。
- 页面元素缺失（如“中长篇作品”或“增加小节”按钮改版）：记录失败步骤并停止该章。
- 关键浮层遮挡（如编辑器使用说明）导致按钮无法点击：先关闭浮层再重试，仍失败才按“页面元素缺失”处理。
- 书名校验不一致：直接停止该书上传流程，禁止盲传。
- “保存稿件”失败：本章标记失败；重试后仍失败则保留失败记录并继续下一章（除非用户要求遇错即停）。
- `分发记录.md` 写入失败：流程标记为“部分失败（记录未落盘）”，并提示人工补录。

## 实操经验沉淀（知乎）

- 先完成“中长篇作品 + 作品名称点击进入 + 左上角书名校验”，再填正文，能显著降低传错书风险。
- 新建章节时，`writer?id={章节Id}&step=2` 里的 `id` 就是章节Id，保存后应立即回写记录。
- 连续新增多章时，每一章都要重新点击“增加小节”获取新章节Id；不要复用上一个新建页 URL。
- 知乎编辑器标题位当前实测为 15 字上限；超限会阻断稳定保存，需先压缩标题再点“保存稿件”。
- 页面首次进入可能弹出“编辑器使用说明”浮层，会遮挡“增加小节/保存稿件”等按钮；必须先关闭浮层。
- 每章以“保存稿件成功”提示作为唯一完成信号，没有成功提示就不算完成。

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

- `知乎小说/分发记录.md` 首次不存在时，必须先按模板创建，否则新建/修改分流无法执行。
- 标题规则应以平台门禁优先：本次原始标题 `第1章 做了三年田野纪录片，有一次素材让我现在还没想通` 显示 `27/15`，需压缩为可保存标题后再提交。
- 登录后仍可能在后续请求中出现验证或风控（如 captcha 接口异常）；必须立即暂停并等待用户明确反馈“登录完成”，不可当作一次性动作。
- 判定保存成功时建议交叉验证三项：
   - 页面出现“已保存到云端/保存成功”等成功信号；
   - 目录小节数/条目发生预期变化；
   - 当前 writer URL 可稳定访问并用于回写章节Id。

## 完成检查清单

- 已读取 `知乎小说/README.md` 并提取必需字段。
- 已在作品管理页选择“中长篇作品”并定位目标作品。
- 已通过点击作品名称进入内容编辑页，并完成左上角书名校验。
- 已在每章开始前查询 `知乎小说/分发记录.md`，正确区分新建/修改模式。
- 新建章节均通过“增加小节”按钮进入，并获取新章节Id。
- 修改章节均通过 `writer?id={章节Id}&step=2` 地址进入。
- 每章均完成绝对章节编号计算或校验（知乎不分卷场景按单序列口径）。
- 每章均完成：平台合规标题输入（≤15字）、正文填写、点击“保存稿件”。
- 每章保存后均已回写 `知乎小说/分发记录.md`（含章节与章节Id映射）。
- 已输出每章结果（成功/失败及原因）。