���发 ���度百家号

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

上传指定章节到百度百家号并保存草稿

用于把你指定的 1 章或多章，上传到百度百家号对应账号下，并全部保存为草稿。

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

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

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

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

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

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

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

何时使用

• 你已经把待上传章节放入 百度百家号/ 目录。
• 你已经在 百度百家号/README.md 写好账号、密码、作者笔名、小说名称与书籍Id等信息。
• 你希望按固定流程自动完成：登录 → 判断新建/修改模式 → 填写标题与正文 → 基础信息设置 → 保存草稿 → 回写章节Id。

不适用情形

• 你只想做文本润色，不需要打开网站上传。
• 你没有提供百家号账号或必要元数据。
• 目标不是“存草稿”，而是“直接发布”。

输入前置要求（强制）

1) 章节文件目录

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

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

• 必须从章节文件中提取：章节号（阿拉伯数字）、章节标题、正文、作者有话说。
• 若章节文件标题行为 # 1.1.3 三分钟，其中 1.1.3 表示 部号.卷号.章号；提取时必须只取最后一段 3 作为源章号，三分钟 作为“章节标题”。
• 百家号最终上传时虽然使用绝对章节号口径，但绝对章节号只能基于最后一段章号再按本 Skill 的规则换算，不得把 1.1.3、2.4.17 这类三级编号原样带入标题输入框；最终只能写成 第95章 三分钟 一类格式。
• 百家号章节号与章节标题共用一个标题输入框。
• 最终填入值必须是完整字符串：第{绝对章节号}章 {章节标题}。
• 章号 与 标题 之间必须保留 1 个空格，例如：第1章 天降奇缘。
• 若提取到的标题行只有标题文本（如 天降奇缘），则必须自动组装成 第{绝对章节号}章 天降奇缘。

2) 元数据来源

• 必须读取 百度百家号/README.md，至少提取以下信息：
• 百家号用户名
• 百家号密码
• 作者笔名（用于原创证明）
• 百家号书籍ID（按“书籍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 模板（首次创建直接使用）

# 百度百家号分发记录

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

## 字段说明

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

## 记录表

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

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

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

# 百度百家号分发配置

> 用途：存储百家号账号、作者信息与书籍ID。分发流程将读取此文件。

## 账号信息

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

## 作者信息

- 作者笔名：`笔名`

## 书籍信息

### 无分部小说

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

### 有分部小说

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

## 卷名映射

### 分部一书名

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

### 分部二书名

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

## 字段说明

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

## 安全提醒

- 本文件包含明文密码，请妥善保管。
- 本文件应存入 `.gitignore`，不提交到公开仓库。

执行流程（强制按序）

步骤 1：读取本地输入

• 读取并解析 百度百家号/README.md。
• 确认已获得：账号、密码、作者笔名、目标书籍Id（按“书籍Id判定规则”选取）、小说名称，并按“书名判定规则”得到本章目标书名（用于专栏匹配）。
• 读取 百度百家号/分发记录.md，建立“章节唯一键 -> 章节Id”映射（建议唯一键：百家号书籍ID|分部名|绝对章号|章名；无分部时分部名固定为 NA）。
• 读取你指定的章节文件，提取每章：卷号、章号（阿拉伯数字）、章节标题、正文、作者有话说。

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

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

步骤 2：登录百度百家号后台

• 必须新开一个浏览器标签页，并在该新标签页访问：
• https://baijiahao.baidu.com/builder/rc/incomecenter
• 该新标签页仅用于本次百度百家号上传流程，不复用你当前正在进行其他任务的标签页。
• 若出现未登录状态：
• 点击“登录/注册百家号”；
• 在弹出浮层中选择“百度账号登录”；
• 输入 README.md 中的用户名和密码完成登录。
• 登录后保持在百家号作者后台。

步骤 3：新建/修改分流

• 每章开始前，先查 百度百家号/分发记录.md：
• 若已有 章节Id：走修改模式。
• 若无 章节Id：走新建模式。

• 新建模式：
• 访问：
• https://baijiahao.baidu.com/builder/rc/edit?type=pay_read&sub_type=add_chapter&pay_read_type=news_special_column&pay_read_action=add&is_pay_training_camp=&set_id={书籍Id}

• 修改模式：
• 访问：
• https://baijiahao.baidu.com/builder/rc/edit?type=pay_read&article_id={章节Id}&is_pay_training_camp=&set_id={书籍Id}&sub_type=add_chapter&pay_read_action=update&pay_read_type=news_special_column&pay_read_status=draft

步骤 4：填写标题与正文

• 在标题输入框填写：第{绝对章节号}章 {章节标题}。
• 在正文编辑区粘贴该章正文。
• 必须确保正文来自你指定的章节文件，不得错章串章。

步骤 5：基础信息设置（强制）

5.1 已选专栏（必检）

• 在“基础信息”区域确认“已选专栏”。
• 必须确保当前已选专栏名称与“书名判定规则”得到的目标书名一致。
• 不一致时必须停止保存并先纠正专栏选择。

5.2 本章节进推荐（必选）

• “本章节进推荐”必须勾选。

5.3 付费设置（必选）

• “付费设置”必须选择“本章节免费”。

5.4 原创证明（必选）

• “原创证明”必须选择“个人原创”。

5.5 拓展设置（必选）

• “拓展设置”必须勾选“支持用户打赏”。

步骤 6：保存草稿

• 点击“存草稿”。
• 等待页面反馈保存成功（或等价成功提示）。

步骤 7：新建章节提取章节Id

• 对于新建章节，保存后会得到新的 URL，形如：
• https://baijiahao.baidu.com/builder/rc/edit?type=pay_read&article_id={章节Id}&sub_type=add_chapter&set_id={书籍Id}&pay_read_type=news_special_column&pay_read_action=update&pay_read_status=draft
• 从 URL 中提取 article_id 作为新的章节Id。
• 将“章节唯一键 + 章节Id + 更新时间”写回 百度百家号/分发记录.md：
• 若记录不存在：新增一条；
• 若记录已存在：更新 章节Id（如变化）和更新时间。

步骤 8：多章循环

• 创建或修改更多章节时，严格循环步骤 3～8。
• 每章都必须重新校验：当前章节是新建还是修改、基础信息必选项是否全部满足。

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

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

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://baijiahao.baidu.com/builder/rc/incomecenter。
• 登录动作固定链路为“登录/注册百家号”→“百度账号登录”→输入账号密码。
• 新建与修改 URL 必须按分发记录自动分流，禁止混用。
• 标题必须使用合并格式：第X章 标题文本（X 为绝对章节号，章号与标题之间有 1 个空格）。
• 百家号章节编号统一采用绝对章节号口径进行判定与校验。
• “基础信息”五项必须满足：已选专栏一致 + 本章节进推荐 + 本章节免费 + 个人原创 + 拓展设置支持。
• 每章最终保存动作必须是“存草稿”。
• 新建章节保存后必须从新 URL 提取 article_id 并回写 百度百家号/分发记录.md。
• 账号密码仅用于当次登录，不写入产物文件、不外泄。

失败与回退处理

• 登录失败：提示账号/密码错误并停止，不继续后续章节。
• 出现二次验证（验证码/短信验证/风控）：必须立即暂停流程，等待用户手动完成验证并明确反馈“登录完成”；在收到该反馈前不得继续任何后续步骤。
• 页面元素缺失（如“基础信息”区域字段改版）：记录失败步骤并停止该章。
• 已选专栏与目标书名不一致：停止保存，先校正专栏后再继续。
• “存草稿”失败：本章标记失败；重试后仍失败则保留失败记录并继续下一章（除非用户要求遇错即停）。
• 分发记录.md 写入失败：流程标记为“部分失败（记录未落盘）”，并提示人工补录。

实操经验沉淀（百度百家号）

标题填充（关键）

• 标题区是 contenteditable 段落（ref=e193），不是标准 <input>。type_in_page 工具对该元素不可靠。
• 可靠方法：用 Playwright 定位 locator('text=请输入标题').locator('..') → click() → Control+A 全选 → keyboard.type(标题文本, {delay: 0})。
• 标题格式固定为 第{绝对章节号}章 {章节标题}，章号与标题之间 1 个空格。
• 标题字数计数器（N/64）可用来验证填充是否成功。

正文填充（关键，禁止剪贴板）

• 禁止使用剪贴板：剪贴板易被其他操作覆盖，不可靠。
• 必须使用本地 HTTP 正文服务器（scripts/bjh_body_server.mjs）：

  # 启动服务器（异步，上传期间保持运行）
  node scripts/bjh_body_server.mjs --dir "百度百家号/第1卷" --port 8765

• 服务器接口：
• GET /ch/{章号} → 纯文本正文（已自动去除标题行）
• GET /ch/{章号}/title → 纯文本标题
• GET /health → 健康检查 + 可用章号列表
• Playwright 中通过 fetch 获取正文并直接注入 iframe：

  const chNum = 36;
  const resp = await fetch(`http://127.0.0.1:8765/ch/${chNum}`);
  const bodyText = await resp.text();

  const iframe = page.frameLocator('iframe').first();
  const bodyEl = iframe.locator('body').first();
  // 清空后用 evaluate 设置 textContent（比 innerHTML 更安全）
  await bodyEl.evaluate(el => { el.textContent = ''; });
  await bodyEl.evaluate((el, text) => { el.textContent = text; }, bodyText);

• 此方案完全消除剪贴板竞态风险，正文直接由 Node.js 文件系统 → HTTP → Playwright 注入，不经过 OS 剪贴板。

批量预处理提效

• 打开浏览器前一次性完成：章节号提取、绝对章节号计算、新建/修改模式预判。
• 不需要预处理正文文件到临时目录——正文服务器直接读原始章节文件并实时去标题行。
• 字体大小"19"会自动从上一章继承，无需每章设置。

• 五项必设：本章节免费、本章节进推荐、个人原创、支持用户打赏、已选专栏匹配。
• 设置顺序：先点 text=本章节免费（默认是"本章节付费"），再点 text=个人原创。
• "支持用户打赏"和"本章节进推荐"默认通常已勾选，但仍需每章复核。
• 专栏名可能显示为简写（如"陆深被写进案卷"而非"刑警陆深被写进案卷"），应以 set_id 一致性和"已添加N篇"计数器为准。

保存草稿（时机与验证）

• 填完正文后等待页面自动保存提示变为"已保存"再点击"存草稿"按钮。
• 保存按钮定位：button:has-text("存草稿")。
• 保存成功后 URL 从 pay_read_action=add 切到 pay_read_action=update&pay_read_status=draft，同时出现 article_id= 参数。
• 从 page.url() 提取 article_id，这是回写分发记录的最稳定来源。

单章 Playwright 完整模板

推荐将整章操作合并到一个 run_playwright_code 调用中，减少工具往返：

const CH = 36; // 当前绝对章节号
const TITLE = '第36章 排班写"休息、不在岗"，为何仍无法排除安全主管进入NVR机房';

// 1. 从正文服务器获取正文
const resp = await fetch(`http://127.0.0.1:8765/ch/${CH}`);
const bodyText = await resp.text();

// 2. 填标题
const titleArea = page.locator('text=请输入标题').locator('..');
await titleArea.click();
await page.keyboard.press('Control+a');
await page.keyboard.type(TITLE, {delay: 0});
await page.waitForTimeout(300);

// 3. 填正文（注入 iframe）
const iframe = page.frameLocator('iframe').first();
const bodyEl = iframe.locator('body').first();
await bodyEl.evaluate(el => { el.textContent = ''; });
await bodyEl.evaluate((el, text) => { el.textContent = text; }, bodyText);
await page.waitForTimeout(500);

// 4. 基础设置
await page.click('text=本章节免费');
await page.waitForTimeout(200);
await page.click('text=个人原创');
await page.waitForTimeout(200);

// 5. 存草稿
await page.click('button:has-text("存草稿")');
await page.waitForTimeout(3000);

// 6. 返回 article_id
return page.url();

• 每章结束后立即回写分发记录，不要等全部完成再批量回写。

常见失败与修复

| 失败现象 | 原因 | 修复 |

|:--|:--|:--|

| "标题不能为空" | type_in_page 未真正填入标题 | 改用 Playwright 键盘输入标题 |

| 存草稿无反应 | 页面未完成自动保存 | 等待"已保存"状态后再点击 |

| 正文粘贴后格式错乱 | 剪贴板被覆盖或 Control+V 异步失败 | 改用 HTTP 正文服务器 + textContent 注入 |

| 正文未填入 | evaluate 中 textContent 被 CSP 或编辑器拦截 | 降级为 innerHTML：el.innerHTML = text.replace(/\n/g, '<br>') 后手动触发编辑器 input 事件 |

批次大小建议

• 5 章/批是最佳平衡点：速度快、失败面小、回滚成本低。
• 每批完成后做对账：计划章数 = 成功章数 + 失败章数，且成功章均完成章节Id回写。

完成检查清单

• 已读取 百度百家号/README.md 并提取必需字段。
• 已登录百度百家号后台，并按规定链路完成账号登录。
• 已在每章开始前查询 百度百家号/分发记录.md 并正确区分新建/修改模式。
• 每章均完成绝对章节号计算或校验（不分卷单序列口径）。
• 每章均完成：标题、正文、基础信息五项、点击“存草稿”。
• 新建章节均已从新 URL 提取 article_id。
• 每章保存后均已回写 百度百家号/分发记录.md（含章节与章节Id映射）。
• 已输出每章结果（成功/失败及原因）。