lornshrimp/分发-my fiction
用于将 `My Fiction/` 目录内指定章节批量上传到 My Fiction 作者后台并保存。支持按 `My Fiction/README.md` 读取账号、密码、书籍Id、书名与书籍信息校验,自动进入新建/修改章节页,填写单一章节标题输入框,录入正文与作者有话说,保存后循环处理下一章。关键词:My Fiction 上传、作者后台、章节保存、批量传章、作者有话说、英文平台。
npx skills add https://github.com/lornshrimp/Lorn.NovelWriteSkills --skill 分发-My Fiction
<!-- ===== Layer 1: 永久缓存 ===== -->
用于把你指定的 1 章或多章,上传到 My Fiction 对应作品下,并按后台要求保存。
<!-- ===== Layer 3: 场景缓存 ===== -->
本 Skill 执行前,必须按以下规则确定工作目录:
Agents.md,检查其中 主输出平台 声明主输出平台 → 工作目录为 小说正文/主输出平台,或 Agents.md 不存在/未声明 主输出平台 → 工作目录为 My Fiction/后续所有章节文件路径、README.md、分发记录.md 均基于此工作目录。明确说明:
README.md、分发记录.md 均在 小说正文/ 下README.md、分发记录.md 均在 My Fiction/ 下> 路径说明:以下各节中所有 My Fiction/ 形式的路经(如 My Fiction/README.md、My Fiction/分发记录.md)均为工作目录的示例写法。实际目录由上方「工作目录路由规则」确定:本平台是主输出平台时,所有这些路径对应 小说正文/;不是主输出平台时,对应 My Fiction/。
My Fiction/ 目录。My Fiction/README.md 写好账号、密码、My Fiction 书籍Id、书名等信息。My Fiction/ 下。# 1.1.3 三分钟,其中 1.1.3 表示 部号.卷号.章号;提取时必须只取最后一段 3 作为源章号,三分钟 作为“章节标题”。1.1.3、2.4.17 这类三级编号原样带入标题输入框;最终只能写成 Chapter 95 三分钟 一类格式。Chapter {绝对章号} {章节标题}。Chapter、绝对章号 与 标题 之间必须保留 1 个空格,例如:Chapter 1 天降奇缘。Chapter 12 Night Visitor),且章号一致,则可直接使用。夜半来客),则必须自动组装成 Chapter {绝对章号} 夜半来客。_My Fiction版)带入标题输入框。分发记录.md 或本地卷章台账存在历史记录,则必须优先依据历史记录续接绝对章号,避免重复编号。My Fiction/README.md,至少提取以下信息:6a01207e51867;按“书籍Id判定规则”选取当前章节对应值)读取 My Fiction/README.md 后,必须检查其第一行一级标题是否等于 # My Fiction 分发配置:
README.md 平台标识与当前 Skill 不符:预期"My Fiction 分发配置",实际读取到"{实际读取到的标题}"。请检查是否将其他平台的 README.md 误放到了当前工作目录。My Fiction/分发记录.md:README.md 中的“小说名称(小说书名)”。README.md 中与“小说名称(小说书名)”成对维护的书籍Id。分发记录.md 模板(首次创建直接使用)当 My Fiction/分发记录.md 不存在时,必须按以下模板创建:
# My Fiction 分发记录
> 用途:记录“章节唯一键 -> My Fiction 章节Id”映射,供分发流程判断“新建模式/修改模式”。
## 字段说明
- `章节唯一键`:固定格式 `MyFiction书籍ID|绝对章号|章名`
- `MyFiction书籍ID`:对应 `My Fiction/README.md` 中书籍Id(16 进制字符串)
- `章节Id`:章节保存后返回的章节Id
- `最近操作`:`新建` 或 `修改`
- `更新时间`:`YYYY-MM-DD HH:mm:ss`
- `备注`:可选
## 记录表
|章节唯一键|MyFiction书籍ID|章节Id|最近操作|更新时间|备注|
|:--|--|--|:--|:--|:--|
README.md 模板(首次创建直接使用)当 My Fiction/README.md 不存在时,必须按以下模板创建:
# My Fiction 分发配置
> 用途:存储 My Fiction 书籍信息。分发流程需要用户手动登录,不读取密码。
## 书籍信息
### 无分部小说
| 小说名称 | My Fiction 书籍ID |
|:--|:--|
| 作品名 | 6a01207e51867 |
### 有分部小说
| 分部号 | 分部名 | My Fiction 书籍ID |
|:--|:--|:--|
| 第1部 | 分部一书名 | 6a01207e51867 |
| 第2部 | 分部二书名 | 6a01207e51868 |
## 字段说明
- `小说名称` / `分部名`:必须精确匹配 SKILL 中的"书名判定规则"
- `分部号`:必须使用 `第N部` 规范格式(如 `第1部`、`第2部`),并与 `分部名` 一一对应,不得错位或复用
- `My Fiction 书籍ID`:16进制字符串,从 My Fiction 作者后台获取(例如 `6a01207e51867`)
## 登录方式
- **本文件不存储密码**。分发流程将在浏览器打开 My Fiction,需要你在浏览器中**手动登录**。
- 确保登录账号拥有上述书籍的编辑权限。
## 注意事项
- 分发流程会检查登录状态;如未登录,需要你手动完成登录后再继续。
- 书籍ID 为十六进制格式,请勿混淆为十进制。
My Fiction/README.md。My Fiction/分发记录.md,建立“章节唯一键 -> 章节Id”映射(建议唯一键:MyFiction书籍ID|绝对章号|章名)。Chapter {绝对章号} {章节标题}。https://write.myfiction.com/my-storiesMy Fiction/分发记录.md 中该章节是否已有 章节Id。https://write.myfiction.com/my-stories/chapter/new?book_id={书籍ID}https://write.myfiction.com/my-stories/chapter/edit?book_id={书籍ID}&real_chapter_id=6a01207e51867&_chap_order_id=1book_id 使用 My Fiction/README.md 中的 16 进制书籍Id。real_chapter_id 必须替换为该章实际章节Id。_chap_order_id 使用该章在当前绝对章节序列中的顺序值。README.md 中的目标书名。Chapter {绝对章号} {章节标题}。Chapter、章号与标题之间只有一个空格。.public-DraftEditor-content),以下方法按可靠性排序:page.keyboard.insertText(bodyText) — 逐字符模拟输入,Draft.js 能正确捕获并更新内部状态与字数统计。代价是耗时较长(约 15 秒 / 10K 字符)。document.execCommand('insertText', false, text) — 一次性注入纯文本,Draft.js 可识别但极端大文本可能引发 React 内部状态错误。el.innerHTML 或 el.textContent — Draft.js 依赖内部 ContentState,绕过 React 的 DOM 操作不会触发字数统计更新,且可能引发"Application error"客户端异常。placeholder="Enter author's note here.")。https://write.myfiction.com/my-stories/chapter/edit?book_id={书籍ID}&real_chapter_id={章节ID}{章节ID},将其视为本章的最终 章节Id。My Fiction/分发记录.md:章节Id(如变化)和更新时间。最近操作 根据本次模式写为 新建 或 修改。> 章节唯一键生成规则(强制):
> - 使用字段顺序:MyFiction书籍ID|绝对章号|章名
> - 其中:
> - MyFiction书籍ID 来自 My Fiction/README.md
> - 绝对章号 必须是阿拉伯数字,且按不分卷口径持续累加
> - 章名 为章节标题
> - 该规则用于避免多章节并行分发时的同章号冲突。
章节Id:分发记录.md 决定新建/修改模式,不得沿用上一章模式。> 目标:在不放松现有强制规则的前提下,减少重复点击、重复粘贴与重复判定成本。
分发记录.md)。{平台目录}/.cache/content_parts/no_part/v{卷号}/*.txt、{平台目录}/.cache/content_parts/p{分部号}/v{卷号}/*.txt + 映射表),浏览器阶段只做“取数据→填写→保存”。1) 打开目标地址(按记录走新建或修改);
2) 填标题;
3) 填正文;
4) 填平台扩展字段(如作者话/发布设置);
5) 保存草稿;
6) 提取章节Id;
7) 回写记录。
分发记录.md;计划 = 成功 + 失败,且成功章均完成 章节Id 回写。> D / E / F 三节统一执行口径:优先保证批次连续性与可回滚性;安全验证类提示一律按阻断处理;数据通道异常必须可降级。
scripts/content_parts_server.mjs:/parts/v/{卷号}/{章号}/parts/p/{分部号}/v/{卷号}/{章号}/parts/{章号} 仅限单批次临时使用。分发记录.md 的实时查询。content_parts_server)时必须提供降级路径:服务不可用时自动回退到本地文件读取,不中断批次执行。计划章数 = 成功章数 + 失败章数,且成功章均完成 章节Id 回写。https://write.myfiction.com/my-stories,并在需要登录时等待用户手动完成登录。My Fiction/分发记录.md。https://write.myfiction.com/my-stories/chapter/new?book_id={书籍ID},修改模式必须使用 https://write.myfiction.com/my-stories/chapter/edit?book_id={书籍ID}&real_chapter_id={章节ID}&_chap_order_id={顺序},二者不得混用。Chapter {绝对章号} {章节标题},且中间保留一个空格。SAVE 后 URL 应变更为 https://write.myfiction.com/my-stories/chapter/edit?book_id={书籍ID}&real_chapter_id={章节ID};若未变化,必须继续确认,不得直接默认成功。章节Id 时,不得把本章标记为完全成功。My Fiction/README.md 或目标书籍Id。章节Id 获取失败:本章标记“部分成功(已保存,但章节Id未确认)”,要求人工补录章节Id,禁止静默成功。My Fiction/分发记录.md 写入失败:本章虽然可能已保存,但流程状态必须标记为“部分失败(记录未落盘)”,并立即提示人工补录,禁止静默成功。.public-DraftEditor-content。Draft.js 依赖内部 ContentState,任何绕过 React 的 DOM 操作(如直接设置 innerHTML)都不会触发字数统计更新,且可能引发 "Application error" 客户端异常。page.keyboard.insertText(bodyText) 逐字符模拟键入,Draft.js 可完整捕获并更新内部状态与 Word count。实测 10K 字符约需 15 秒,必须预留足够等待时间(waitForTimeout(15000))。document.execCommand('insertText', false, text) 一次性注入纯文本,Draft.js 可识别但超长文本(>15K 字符)可能触发 React 内部状态偏移错误。keyboard.insertText(),注入后无需点击额外按钮,直接 SAVE 即可。Set-Clipboard 对大文本(>10K 字符)不稳定,Get-Clipboard 可能返回长度为 0。clip.exe 在非交互式终端中可能因权限问题失败("拒绝访问")。keyboard.insertText() 或 execCommand,避免依赖系统剪贴板作为数据传输通道。page.addScriptTag({ path: dataFile }) 将章节数据(标题、正文、作者有话说)注入到 window.__chapter* 全局变量。page.evaluate(() => window.__chapterBody) 读取数据后传给编辑器。ConvertTo-Json 将正文序列化为 JSON 字符串(自动处理换行、引号、Unicode 转义),写入 .js 文件。write.myfiction.com 的登录步骤必须留给用户手动完成;这是硬边界,不要替用户"代劳"到过线。beforeunload 弹窗:每次从章节编辑页(/chapter/edit 或 /chapter/new)离开时,页面会弹出 beforeunload 确认框。必须尽早设置 page.on('dialog', async dialog => { await dialog.accept(); }),否则每次导航都会被中断。SAVE 后最终章节 URL 会变成 https://write.myfiction.com/my-stories/chapter/edit?book_id={书籍ID}&real_chapter_id={章节ID};该 URL 是提取章节Id 的优先来源。My Stories → Story Manage → Drafts 列表页逐章点击 Edit 获取。real_chapter_id。ERR_NETWORK_IO_SUSPENDED 状态,表现为所有网络请求挂起且页面无法加载。open_browser_page({ forceNew: true }) 重新建立连接。分发记录.md,避免进度丢失。> 用法:每次分发前按顺序快速过一遍;有任意一项不满足,就先修正再上传。
My Fiction/README.md 可读到用户名、密码、16 进制书籍Id、书名。README.md 一致。章节Id 走新建(/chapter/new?book_id={书籍ID}),有 章节Id 走修改(/chapter/edit?book_id={书籍ID}&real_chapter_id={章节ID}&_chap_order_id={顺序})。Chapter {绝对章号} {章节标题}(Chapter + 阿拉伯数字 + 一个空格)。章节Id(URL 变更为 /my-stories/chapter/edit?book_id={书籍ID}&real_chapter_id={章节ID})。My Fiction/分发记录.md,且 章节唯一键 已按模板记录。章节Id 未拿到、记录未写入:必须标记失败/部分成功并说明阻塞点。My Fiction/README.md 并提取必需字段。My Fiction/分发记录.md 并正确选择新建/修改 URL。章节Id。My Fiction/分发记录.md(含章节与章节Id映射)。Take lornshrimp/分发-my fiction from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.