b

<!-- ===== Layer 1: 永久缓存 ===== --> # 上传指定章节到 B 站并保存草稿 用于把你指定的 1 章或多章，上传到 B 站对应账号下，并全部保存为草稿。 <!-- ===== Layer 3: 场景缓存 ===== --> ## 工作目录路由规则（强制） 本 Skill 执行前，必须按以下规则确定工作目录： 1. **读取项目根目录 `Agents.md`**，检查其中 `主输出平台` 声明 2. 若当前平台（B站）匹配 `主输出平台` → 工作目录为 `小说正文/` 3. 若当前平台不匹配 `主输出平台`，或 `Agents.md` 不存在/未声明 `主输出平台` → 工作目录为 `B站/` 后续所有章节文件路径、README.md、分发记录.md 均基于此工作目录。**明确说明**： - **本平台是主输出平台时** → 章节文件、`README.md`、`分发记录.md` 均在 `小说正文/` 下 - **本平台不是主输出平台时** → 章节文件、`README.md`、`分发记录.md` 均在 `B站/` 下 > **路径说明**：以下各节中所有 `B站/` 形式的路经（如 `B站/README.md`、`B站/分发记录.md`）均为工作目录的示例写法。实际目录由上方「工作目录路由规则」确定：本平台是主输出平台时，所有这些路径对应 `小说正文/`；不是主输出平台时，对应 `B站/`。 ## 何时使用 - 你已经把待上传章节放入 `B站/` 目录。 - 你已经在 `B站/README.md` 写好账号、密码、作者笔名、小说名称、文集映射等信息。 - 你希望按固定流程自动完成：登录 → 判断新建/修改模式 → 填写标题与正文 → 发布设置 → 保存为草稿 → 回写分发记录。 ## 不适用情形 - 你只想做文本润色，不需要打开网站上传。 - 你没有提供 B 站账号或必要元数据。 - 目标不是“保存为草稿”，而是“直接发布”。 ## 输入前置要求（强制） ### 1) 章节文件目录 - 待上传文件必须放在 `B站/` 下。 - 你会明确指定要上传哪些章节（可单章，可多章）。 - 章节标题**不以文件名直接照抄为准**，必须从章节文件内容中提取并规范化后填写到页面标题框。 ### 1.1) 章节标题提取与组装规则（强制） - 必须从章节文件中提取：章节号（阿拉伯数字）、章节标题、正文、作者有话说。 - 若章节文件标题行为 `# 1.1.3 三分钟`，其中 `1.1.3` 表示 `部号.卷号.章号`；提取时必须只取最后一段 `3` 作为源章号，`三分钟` 作为“章节标题”。 - B 站最终上传时虽然使用绝对章节号口径，但绝对章节号只能基于最后一段章号再按本 Skill 的规则换算，不得把 `1.1.3`、`2.4.17` 这类三级编号原样带入标题输入框；最终只能写成 `第95章 三分钟` 一类格式。 - B 站章节号与章节标题共用**一个标题输入框**。 - 最终填入值必须是完整字符串：`第{绝对章节号}章 {章节标题}`。 - `章号` 与 `标题` 之间必须保留 **1 个空格**，例如：`第1章 天降奇缘`。 - 若提取到的标题行只有标题文本（如 `天降奇缘`），则必须自动组装成 `第{绝对章节号}章 天降奇缘`。 ### 2) 元数据来源 - 必须读取 `B站/README.md`，至少提取以下信息： - B 站用户名 - B 站密码 - 作者笔名（用于元信息记录） - 小说名称（小说书名候选；最终以“书名判定规则”确定文集匹配名） - 文集映射信息（书名与 B 站文集名称的对应关系） ### 2.1) 平台校验（强制） 读取 `B站/README.md` 后，必须检查其第一行一级标题是否等于 `# B 站分发配置`： - **匹配** → 继续执行后续流程 - **不匹配** → 立即停止上传，并向用户报错：`README.md 平台标识与当前 Skill 不符：预期"B 站分发配置"，实际读取到"{实际读取到的标题}"。请检查是否将其他平台的 README.md 误放到了当前工作目录。` ### 3) 分发记录来源（强制） - 必须读取 `B站/分发记录.md`： - 若文件不存在，先创建后再执行分发。 - 用于查询“章节 -> 章节Id”映射，判定该章是“新建模式”还是“修改模式”。 ### 4) 书名判定规则（强制） - B 站目录中的“小说名称”即小说书名。 - 若小说无分部：小说书名使用该平台目录 `README.md` 中的“小说名称（小说书名）”。 - 若小说有分部（多部）：小说书名使用该章节所在分部的分部名。 ### 5) 章节Id待定场景的记录规则（强制） > 当前已知：新建草稿后“如何稳定获得章节Id（aid）”方法待定。流程必须支持“先上传、后回填 aid”。 - 若新建后无法获取 `aid`： - 允许先将该章写入分发记录，`章节Id` 字段填 `TBD`； - 同时记录 `草稿定位键`：`B站草稿::{标准标题}`； - 同时记录 `内容指纹`（规范化正文哈希，建议 SHA-1）； - `备注` 标记“待回填章节Id（aid）”。 - 后续任一轮执行若成功识别 `aid`： - 必须把 `章节Id` 从 `TBD` 更新为真实 `aid`，并更新 `更新时间` 与备注。 ### 6) `分发记录.md` 模板（首次创建直接使用） ```markdown # B站分发记录 > 用途：记录“章节唯一键 -> B站章节Id/待回填状态”映射，供分发流程判断“新建模式/修改模式”。 ## 字段说明 - `章节唯一键`：固定格式 `B站文集名|分部名|绝对章号|章名`（无分部时分部名填 `NA`） - `B站文集名`：对应 `B站/README.md` 中目标文集名（按书名判定规则映射） - `章节Id`：编辑地址中的 `aid` 参数（未知时填 `TBD`） - `草稿定位键`：固定格式 `B站草稿::{标准标题}` - `内容指纹`：规范化正文的哈希值（建议 SHA-1） - `最近操作`：`新建` 或 `修改` - `更新时间`：`YYYY-MM-DD HH:mm:ss` - `备注`：可选 ## 记录表 |章节唯一键|B站文集名|章节Id|草稿定位键|内容指纹|最近操作|更新时间|备注| |:--|:--|:--|:--|:--|:--|:--|:--| ``` ### 7) `README.md` 模板（首次创建直接使用） 当 `B站/README.md` 不存在时，必须按以下模板创建： ```markdown # B 站分发配置 > 用途：存储 B 站账号、书籍信息与文集映射。分发流程将读取此文件。 ## 账号信息 - 用户名：`your_username` - 密码：`your_password` ## 作者信息 - 作者笔名：`笔名` ## 书籍与文集映射 ### 无分部小说 | 小说名称 | 目标文集名 | |:--|:--| | 作品名 | 文集名称 | ### 有分部小说 | 分部号 | 分部名 | 目标文集名 | |:--|:--|:--| | 第1部 | 分部一书名 | 文集名称一 | | 第2部 | 分部二书名 | 文集名称二 | ## 卷名映射 ### 分部一书名 | 卷号 | 卷名 | |--:|:--| | 1 | 第一卷 卷标题 | | 2 | 第二卷 卷标题 | ### 分部二书名 | 卷号 | 卷名 | |--:|:--| | 1 | 第一卷 卷标题 | | 2 | 第二卷 卷标题 | ## 字段说明 - `小说名称` / `分部名`：必须精确匹配 SKILL 中的"书名判定规则" - `分部号`：必须使用 `第N部` 规范格式（如 `第1部`、`第2部`），并与 `分部名` 一一对应，不得错位或复用 - `目标文集名`：B 站创作中心已创建的长文合集名称 - `作者笔名`：用于原创声明与元信息记录 ## 安全提醒 - 本文件包含明文密码，请妥善保管。 - 本文件应存入 `.gitignore`，不提交到公开仓库。 ``` ## 执行流程（强制按序） ### 步骤 1：读取本地输入 1. 读取并解析 `B站/README.md`。 2. 确认已获得：账号、密码、作者笔名、目标小说名、目标文集名（按书名判定规则映射）。 3. 读取 `B站/分发记录.md`，建立“章节唯一键 -> 章节Id/草稿定位键/内容指纹”映射。 4. 读取你指定的章节文件，提取每章：卷号、章号（阿拉伯数字）、章节标题、正文、作者有话说。 ### 步骤 1.5：计算绝对章节编号（不分卷口径） 1. 章节编号统一使用“绝对章节编号”口径，不使用卷内局部编号。 2. 计算方式： - 读取 `分发记录.md` 中同一目标文集下全部已记录章节； - 依据 `绝对章号`排序后，计算当前章节的绝对序号。 3. B 站不分卷发布场景，章节号使用绝对章节号，计算公式为： - `绝对章节号 = 前面各卷章节数之和 + 该章节在所在卷的相对章号`。 4. 示例： - 若第1卷有90章、第2卷有100章： - 第1卷第5章 → 绝对章节号第5章； - 第2卷第5章 → 绝对章节号第95章； - 第3卷第5章 → 绝对章节号第195章。 5. 若 `分发记录.md` 不存在或无历史记录，则按上述公式从已知卷章结构计算；无法确定前卷章数时需先补齐台账后再发布。 ### 步骤 2：登录 B 站作者后台 1. **必须新开一个浏览器标签页**，并在该新标签页访问： - `https://member.bilibili.com/platform/home` 2. 该新标签页仅用于本次 B 站上传流程，不复用你当前正在进行其他任务的标签页。 3. 若出现未登录状态： - 进入登录流程并选择“密码登录”； - 输入 `README.md` 中的用户名和密码完成登录。 4. 登录后保持在 B 站创作中心后台。 ### 步骤 3：新建/修改分流 1. 每章开始前，先查 `B站/分发记录.md`： - 若已有有效 `章节Id`（非 `TBD`）：走**修改模式**。 - 若无 `章节Id` 或 `章节Id=TBD`：走**新建模式**。 2. 新建模式： - 访问： - `https://member.bilibili.com/platform/upload/text/new-edit` 3. 修改模式： - 访问： - `https://member.bilibili.com/platform/upload/text/new-edit?aid={章节Id}` ### 步骤 4：填写标题与正文 1. 在标题输入框填写：`第{绝对章节号}章 {章节标题}`。 2. 在正文编辑区粘贴该章正文。 3. 必须确保正文来自你指定的章节文件，不得错章串章。 ### 步骤 5：发布设置（强制） #### 5.1 创作声明（必选） - 在“发布设置”中必须勾选“声明此文章为原创”。 #### 5.2 文集（必选） - 在“发布设置”中点击“选择文集”。 - 在弹窗中勾选与小说名称一致的目标文集。 - 点击“确定”。 ### 步骤 6：保存草稿并回写记录 1. 点击“保存为草稿”。 2. 等待页面反馈保存成功（或等价成功提示）。 3. 写回 `B站/分发记录.md`： - 若已知 `aid`：写入真实 `章节Id`； - 若未知 `aid`：写入 `章节Id=TBD`，并写入 `草稿定位键` 与 `内容指纹`； - 同步更新 `最近操作`、`更新时间` 与 `备注`。 ### 步骤 7：多章循环 - 创建或修改更多章节时，严格循环步骤 3～7。 - 每章都必须重新校验：当前章节是新建还是修改、发布设置是否已完整勾选、分发记录是否已回写。 ### 连续多章提效模式（推荐） > 目标：在不放松现有强制规则的前提下，减少重复点击、重复粘贴与重复判定成本。 #### 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 必须使用**新标签页**进入 B 站后台，禁止占用用户正在使用的原标签页。 - 作者后台入口固定为：`https://member.bilibili.com/platform/home`。 - 登录动作固定为“密码登录 + 输入账号密码”。 - 新建与修改 URL 必须按分发记录自动分流，禁止混用。 - 标题必须使用合并格式：`第X章 标题文本`（`X` 为绝对章节号，章号与标题之间有 1 个空格）。 - “发布设置”两项必须满足：原创声明已勾选 + 已选择匹配文集并确认。 - 每章最终保存动作必须是“保存为草稿”。 - 若新建后仍无法获取 `aid`，必须回写 `TBD` 与定位信息，不得遗漏记录。 - 账号密码仅用于当次登录，不写入产物文件、不外泄。 ## 失败与回退处理 - 登录失败：提示账号/密码错误并停止，不继续后续章节。 - 出现二次验证（验证码/短信验证/风控）：必须立即暂停流程，等待用户手动完成验证并明确反馈“登录完成”；在收到该反馈前不得继续任何后续步骤。 - 页面元素缺失（如“创作声明”“选择文集”改版）：记录失败步骤并停止该章。 - 文集列表无匹配：停止保存，提示先创建或核对文集名称。 - “保存为草稿”失败：本章标记失败；重试后仍失败则保留失败记录并继续下一章（除非用户要求遇错即停）。 - 新建后无法获得 `aid`：按 `章节Id=TBD` 回写并标记“待回填章节Id”，后续继续可执行。 - `分发记录.md` 写入失败：流程标记为“部分失败（记录未落盘）”，并提示人工补录。 ## 实操经验沉淀（B站） - 登录后先确认编辑页可访问，再开始批量分发，能减少中途跳登录页导致的中断。 - 每章保存前先完成“原创声明 + 文集确认”，可避免保存后返工。 - 在 `aid` 方法未确定阶段，使用 `TBD + 草稿定位键 + 内容指纹` 可以稳定跟踪草稿状态。 - 每章结束以“保存为草稿成功”提示为唯一完成信号，没有成功提示就不算完成。 ### 40章批量实战复盘（2026-05-22） #### 成功做法（建议固化） - 先小样本试跑再放量：先跑 `1-2` 章验证“标题/正文/原创声明/文集/保存”全链路，再进入 `5-10` 章小批次，可显著降低整批回滚风险。 - 小批次 + 失败补传：本轮按批次推进后，对失败章单独重试，最终实现 `40 = 40 + 0`（计划 = 成功 + 失败）。 - 对话框自动兜底：编辑页存在离开确认弹窗（beforeunload）时，需统一接管并接受，否则批处理会被中断。 - 先选文集再保存：文集未被实际选中时“确定”按钮会禁用，必须先确认目标文集被勾选后再点“确定/保存”。 - `aid` 不稳定时先落 `TBD`：新建后无法稳定提取 `aid` 时，立即按规则写入 `TBD + 草稿定位键 + 内容指纹`，避免台账缺失。 #### 典型问题与教训（建议规避） - 不要把“成功”仅定义为点击成功：必须以“保存为草稿成功提示”作为章节完成信号；否则容易出现假成功。 - 不要假设每次都能拿到编辑器 iframe：页面偶发加载慢/重载，需显式等待 iframe 与标题输入框可用再填充。 - 不要直接整批一次性跑满：40章直推在页面波动时失败面大，必须分批并在批间落盘。 - 不要忽略 `分发记录.md` 的表格转义影响：`章节唯一键` 含 `|` 时需统一转义/反转义策略，避免后续按列解析错位。 #### 建议补丁（可直接纳入流程） - 批量默认节拍：`预处理 -> 小样本2章 -> 分批5-10章 -> 失败补传 -> 批次对账 -> 总对账`。 - 失败记录最小字段：`章节唯一键 / 失败步骤 / 页面关键提示 / 重试次数 / 最终状态`。 - 台账写入约束：每小批次结束必须落盘；写入失败则标记“部分失败（记录未落盘）”并提示人工补录。 - `aid` 回填单列任务：上传轮与回填轮解耦，后续单独执行“按草稿定位键+内容指纹回填 aid”。 ## 完成检查清单 - 已读取 `B站/README.md` 并提取必需字段。 - 已登录 B 站后台并完成密码登录。 - 已在每章开始前查询 `B站/分发记录.md` 并正确区分新建/修改模式。 - 每章均完成绝对章节号计算或校验（不分卷单序列口径）。 - 每章均完成：标题、正文、发布设置两项、点击“保存为草稿”。 - 每章保存后均已回写 `B站/分发记录.md`（含章节Id或 `TBD` 状态）。 - 已输出每章结果（成功/失败及原因）。