前言¶

在番茄作家后台发章，常见做法是打开浏览器，逐章粘贴标题和正文，再处理内容检测、发布设置、定时排期等弹窗。章节写在本地 Markdown 里时，每一步都是重复劳动，还容易漏选选项或排错日期。

下面介绍 SkillHub 上的社区 Skill「番茄章节发布器」（@user_3b614548/fanqie-chapter-publisher，当前版本 2.8.5）。它用 Playwright headless Chromium 驱动页面填表；环境不满足时，会降级为半自动辅助模式，生成可复制使用的发布清单。

这是什么¶

番茄章节发布器面向「本地 Markdown 章节 → 番茄作家后台」这条链路：自动登录态管理、填表、处理常见弹窗，并支持定时发布、预检与发布结果校验。发布者为 SkillHub 用户 user_3b614548，分类为 office-efficiency，来源为社区（community），标签标明 requires_api_key=false，无需单独配置 API Key。

Skill 坐标：@user_3b614548/fanqie-chapter-publisher。
SkillHub 页面：https://www.skillhub.cn/skills/user_3b614548/fanqie-chapter-publisher
API 入口：https://api.skillhub.cn/user_3b614548/fanqie-chapter-publisher

在支持 Playwright 的环境下，Agent 可按 SKILL.md 调用脚本完成发布；不支持时仍可通过辅助模式推进流程，而不是完全不可用。

核心功能¶

以下能力均来自官方简介与版本说明，按使用顺序归纳。

浏览器自动化发布¶

• 使用 Playwright headless Chromium 打开番茄作家后台，对本地 Markdown 章节做自动填表与提交。
• 登录态管理：支持通过 EditThisCookie 导出、导入 Cookie，减少每次手动登录。
• 弹窗与设置：处理内容检测弹窗；在发布设置里处理例如 AI 相关选项（选否）与定时发布。
• 按字数排期：支持按约 6000 字/天 的节奏做定时发布排期。
• 跨章重复预检：发布前做章节间重复检查，降低后台风控类问题。

发布流程增强（v2.4.0 及以后）¶

• 需求对齐：--plan 形式的需求对齐表单。
• 发布前预检、发布后列表验证；失败时 截图 便于排查。
• 试读比例 可参数化；支持 多标签。

已排期章节标题（v2.7.0）¶

• 对已排期章节标题做批量编辑：--edit-title-map，传入 JSON 映射。

短故事发布（v2.8.0 及以后）¶

• 覆盖短故事从存草稿、封面、分类、协议、付费节点到「继续发布」等 UI 流程（官方文档文末有「短故事发布 UI 流程」说明）。
• 配套脚本（名称以 Skill 包内为准）：
• make_short_cover.py：本地封面生成
• manage_short_drafts.py：草稿箱管理
• compare_short_publish_status.py、build_publish_plan.py：发布状态核对与计划构建

发布结果真值校验（v2.8.1）¶

• 发布结果改为查询后台接口校验；若未确认发布成功，返回 status=unverified 且 退出码 1，避免脚本误报成功。

重复度门禁（v2.8.2）¶

• 在浏览器启动前做 重复度门禁：与 story-writer-pro/repetition_metrics 共用标定判据（10 字同头出现次数 >8 视为 -3026 风险），写作门禁与发布预检一致。
• 批处理增加离线预扫与拒绝码解析修复。

运行状态路径（v2.8.4 / v2.8.5）¶

• 状态文件不再使用已废弃的 ~/.fanqie-*.json，统一为 <项目根>/state/*.json（含 storage_state、publish-state、log-file 等默认值）。
• 新增 fanqie_paths.py 统一解析路径；可用环境变量 FANQIE_PROJECT_ROOT 覆盖项目根；首次运行自动创建目录。
• v2.8.5 起，文档中已移除从未实现的 --project-dir 与「发布后自动归档」描述，避免按旧文档配置。

降级模式¶

当 Playwright 或 Chromium 不可用时，Skill 进入 半自动辅助模式：生成复制即用的发布清单，由人在后台完成剩余步骤。

自然语言触发¶

在 Agent 对话中可使用例如：发布番茄章节、发布到番茄、上架番茄、发布章节、填番茄后台、fanqie publish。

安装与启用¶

SkillHub 官方给出的安装方式，是让 AI 按统一安装说明拉取指定坐标：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_3b614548/fanqie-chapter-publisher。

将上述提示发给 Cursor、Claude Code 等支持 SkillHub 的客户端即可；具体 CLI 子命令以 skillhub.md 为准。安装完成后，Skill 以通用 SKILL.md 形式被 Agent 加载，无需 requires_api_key。

运行前请在本机准备好 Playwright 与 Chromium（用于全自动路径）。若仅使用半自动模式，对浏览器依赖的要求以 SKILL.md 为准。

状态与日志默认落在项目下的 state/ 目录；若章节仓库不在当前工作目录，可设置：

export FANQIE_PROJECT_ROOT=/path/to/your/novel-project

典型用法¶

官方页面未在摘要中列出完整 shell 示例，典型流程可按能力拆分理解：

1. 安装 Skill后，在对话中用触发词说明要发布的 Markdown 章节路径或排期需求。
2. 首次登录：按 SKILL.md 用 EditThisCookie 导出番茄后台 Cookie，导入到 Skill 管理的登录态（对应 state/ 下 storage 相关文件）。
3. 长篇章节：走自动填表 → 处理内容检测与发布设置弹窗 → 按需定时排期（约 6000 字/天）；发布前可走预检与重复度门禁，发布后依赖接口校验（失败时退出码 1、status=unverified）。
4. 对齐发布计划：需要与人对齐发布策略时，使用带 --plan 的流程。
5. 改已排期标题：准备 JSON 映射，使用 --edit-title-map。
6. 短故事：按文末 UI 流程说明，必要时调用 make_short_cover.py、manage_short_drafts.py 等脚本完成封面与草稿、再用核对脚本对照后台状态。

若环境缺少 Playwright，Agent 应走半自动清单模式，而不是强行启动无头浏览器。

适用场景与注意¶

适合谁

• 习惯用 Markdown 写章、再在番茄作家后台发布的连载作者或协作者。
• 希望把「填表、弹窗、定时、预检、结果校验」交给 Agent，人只处理异常或审核的场景。
• 同时发长篇章节与短故事，且愿意维护本地章节文件与 state/ 登录态、发布状态。

限制与注意

• 依赖番茄作家后台页面结构；后台改版时可能需要等待 Skill 更新（当前以 2.8.5 为准）。
• 全自动路径依赖 Playwright/Chromium；CI 或无图形依赖的环境需确认能否安装浏览器，否则应预期半自动模式。
• 重复度门禁较严（10 字同头 >8 即风险），批处理前会做离线预扫，可能被主动阻断，需先改文再发。
• 旧文档中的 ~/.fanqie-*.json、--project-dir、自动归档等描述已失效，请以 state/*.json 与 FANQIE_PROJECT_ROOT 为准。
• SkillHub 统计（以抓取资料为准）：评分 100000，下载 1534 次；社区 Skill，使用前请自行评估合规与平台规则。

结尾¶

番茄章节发布器把本地 Markdown 与番茄作家后台之间的重复操作收成一条可脚本化、可预检、可校验的流水线；在浏览器自动化不可用时仍保留半自动清单。需要安装或更新时，请打开 SkillHub 官方页面：https://www.skillhub.cn/skills/user_3b614548/fanqie-chapter-publisher。