核心能力

面向已经准备好章节文件的作者，以及协助作者操作后台的 AI Agent。项目通过 Playwright 将本地 Markdown 章节填入番茄小说作者后台，核对后再发布，入口统一为 [`scripts/publish_fanqie.js`](./scripts/publish_fanqie.js)。

• 先看解析，再操作后台：从 Markdown 提取章节号、标题和正文，支持本地预览。
• 分阶段核对：可以只填编辑器，也可以推进到最终发布弹窗；真实提交需要 --confirm-publish 和用户当轮明确授权。
• 检查正文输入是否一致：填充后回读正文，逐字符比对中文、Emoji 和换行；不一致时中止当前章节。
• 单章起步，再批量或定时：支持目录选章、分卷选择，以及番茄后台原生定时发布。
• 保留本地操作记录：保存登录态、阶段截图和章节记录；可显式开启本地记录去重。

快速安装

git clone https://github.com/amm10090/fanqie-publisher-skill.git
cd fanqie-publisher-skill
npm install

运行前需要自行准备：

• Node.js 与 npm；脚本使用 Node.js 内置的 fetch。
• Python 3，用于解析章节。
• 可通过 CDP 连接的 Chromium / Chrome 浏览器。
• 能访问目标作品后台的番茄小说作者账号；需要登录时由本人扫码。

下文命令均在仓库根目录执行。`npm install` 安装项目依赖，不会替你启动浏览器、开启调试端口或完成登录。

快速开始

先完成单章预览和填充，再决定是否发布。示例中的 `/path/to/chapters` 请替换为自己的**绝对路径**。

1. 准备章节并预览

一份 `.md` 文件对应一章，使用 **UTF-8、无 BOM** 编码。文件名建议统一补零，例如 `第001章_启程.md`，内容如下：

# 第001章 启程

天亮时，他推开了门。

街道尽头，第一班车正在等候。

python3 scripts/prepare_chapters.py \
  --dir "/path/to/chapters" \
  --preview

对上述示例，预览会列出 `第001章 启程`，正文字符数为 `26`。解析器优先使用文件第一行的一级标题；没有该标题时从文件名推导。填入后台时，章节号为 `1`，显示标题为 `启程`，首行标题不进入正文。

目录只读取当前层的 Markdown 文件，并按文件名排序，不递归子目录。正文按纯文本处理，不负责将 Markdown 标记转换为富文本样式。预览中的“字数”按正文字符数计算，包含正文中的空白和换行，不等同于后台计数。

2. 配置目标作品，再连接浏览器

**当前版本的目标作品写在源码中。** 首次连接前，检查 [`scripts/publish_fanqie.js`](./scripts/publish_fanqie.js) 顶部的 `BOOK_ID` 和 `BOOK_NAME`，改为自己的作品；`DRAFT_URL` 与 `CHAPTER_MANAGE_URL` 由它们生成。当前没有 `--book-id` 或 `--book-name` 命令参数。

启动自己的 Chromium / Chrome，并准备可访问的 CDP 地址。以下示例使用 `http://127.0.0.1:9222`；如果使用其他地址，应在登录和发布命令中保持一致。调试端口只向可信本机环境开放。

node scripts/login_fanqie.js --cdp http://127.0.0.1:9222

脚本连接浏览器；需要登录时切换到二维码流程，等待人工扫码。登录态保存在 `state/fanqie-storage-state.json`，二维码截图保存在 `state/login-qr.png`。若当前会话已登录，则刷新保存登录态。

3. 只填充一章，不提交发布

node scripts/publish_fanqie.js \
  --