上传指定章节到百度百家号并保存草稿
用于把你指定的 1 章或多章,上传到百度百家号对应账号下,并全部保存为草稿。
工作目录路由规则(强制)
本 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. 浏览器阶段采用“固定入口 + 重复节拍”
- 对于每一章,保持统一节拍:
- 打开目标地址(按记录走新建或修改);
- 填标题;
- 填正文;
- 填平台扩展字段(如作者话/发布设置);
- 保存草稿;
- 提取章节Id;
- 回写记录。
- 除“目标地址”和“填入文本”外,其余动作应尽量保持同一套定位器与顺序,避免每章临时切换策略。
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映射)。 - 已输出每章结果(成功/失败及原因)。