cwjdong-design 网文平台半自动发布
概述
通过固定浏览器 profile 在作者后台完成章节草稿箱投递。核心流程：扫码登录 → 读取本地 MD → 填入后台 → 保存草稿 → 草稿箱核对 → 结束。
参考 fanqie-author-publish (owlco001/owlco001) GitHub 技能包的工作流设计。
触发条件
- 「发布这章到番茄」「把XX章发到后台」「准备草稿」「检查发布状态」
- 任何涉及到作者后台操作章节的请求
能力边界与安全铁律
- 本能力只负责把本地章节送入后台草稿箱并核对，终点是
draft_saved_verified。 - 绝不执行正式发布、确认发布、定时发布或任何使章节对读者可见的动作。
- 草稿保存成功后直接汇报，不再询问用户是否正式发布。
- 用户口语说「发布第 X 章」时，按既定约定解释为「送入草稿箱」；只有用户特别强调正式发布时，明确说明当前能力止于草稿，仍不执行。
- 遇到验证码/风控/页面结构变化 → 立即停止，不要盲点按钮。
- 每步操作后先验证状态，确认成功再继续。
- 关键节点截图留痕（编辑器加载、草稿保存、草稿箱核对）。
- 不要要求用户提供密码。用扫码登录。
通用工作流
1. 登录（Playwright 固定 profile — 番茄已验证）
from playwright.sync_api import sync_playwright
p = sync_playwright().start()
ctx = p.chromium.launch_persistent_context(
user_data_dir='~/.hermes/browser-profiles/fanqie',
headless=False,
)
登录态持久化：同一 user_data_dir 内 cookies 跨会话保持。用户只需在 Playwright Chromium 中手动登录一次（扫码或SMS）。
2. 登录后导航
登录成功后，按以下顺序操作：
- 确认在作家后台首页
- 定位目标作品 → 进入作品管理页
- 进入章节管理 → 选择「新建章节」或「编辑草稿」
3. prepare_draft（准备草稿）
输入：book_name, chapter_title, chapter_body, source_file
输出：草稿已保存 / 失败原因
步骤：
- 确认目标作品、章节标题、正文
- 在编辑器中填入标题
- 填入正文（从本地 MD 文件读取）
- 等待编辑器接收内容后，确认内容正确
- 点击「保存草稿」
- 等待成功提示
- 截图存档
4. review（草稿保存前检查）
检查项：
- 作品名称正确
- 章节标题正确
- 正文非空且无截断
- 「存草稿」按钮可用
输出：ready to save draft / not ready + 阻塞原因
5. reconcile（核对草稿状态）
保存草稿后进入草稿箱，核对：
- 作品名正确
- 章节号、标题正确
- 正文非空，后台字数合理
- 草稿数量与本次投递数量一致
核对成功即结束任务。不要进入发布流程，不要询问是否继续正式发布。
6. reconcile（本地与草稿箱对账）
对比平台章节列表和本地 MD 文件：
- 哪些章已发布
- 哪些是草稿
- 哪些缺失
- 标题是否一致
状态机
pending → backend_opened → book_selected → editor_opened
→ draft_loaded → draft_saved → draft_saved_verified → completed
失败路径：任何步骤异常 → failed_needs_review，报告最后成功步骤和阻塞原因。
输入格式
从本地 MD 文件构造：
{
"book_name": "作品名",
"chapter_title": "第N章 标题",
"chapter_body": "正文内容（从MD读取）",
"action": "prepare_draft|review|reconcile",
"source_file": "/absolute/path/to/chapter.md",
"notes": "可选备注，如：发布前检查结尾伏笔"
}
本地章节 → 后台映射
后台状态 vs 本地 MD 的处理策略：
| 后台状态 | 本地有修改 | 操作 |
|---|---|---|
| 已发布 | 有 | 谨慎：已发布章节不建议覆盖，除非是紧急修文 |
| 定时发布 | 有 | 仅识别并报告状态，不取消定时、不修改、不重新定时 |
| 草稿 | 有 | 直接覆盖草稿内容 |
| 不存在 | — | 新建章节 |
平台特定信息
番茄小说
详细技术细节见
fanqie-publisher技能（BOOK_ID、选择器、弹窗处理、已发布vs待发布分支）。
当前方案：Playwright + 固定浏览器 profile（~/.hermes/browser-profiles/fanqie），不用 Hermes browser 工具。
核心差异：
- 新建章节/草稿：有序号+标题两个字段，有「存草稿」按钮
- 编辑草稿：使用草稿编辑链接，修改后仍只保存草稿
- 已发布章节：只做状态识别，不进入编辑或重新发布流程
- 正文必用 innerHTML：ProseMirror 拒绝所有键盘粘贴/输入
七猫小说
- 同规格技能骨架存在：
qimao-author-publish（GitHub 同仓库） - 页面结构待校准
百度作家平台
- 同规格技能骨架存在：
baidu-author-publish（GitHub 同仓库） - 页面结构待校准
失败处理
任何步骤失败时：
- 立即停止流程
- 记录最后成功步骤
- 能截图就截图
- 告诉用户具体失败点和需要的手动操作
常见失败：
- 登录失效 →
pkill -f "Google Chrome for Testing"后重启，用固定 profile 重新登录 - ProseMirror 不接收内容 → 必须用
innerHTML直接写 DOM，paste/keyboard 全部无效 - 弹窗挡操作 → 先 Escape 两次，再 force=True 点击按钮
- ".first()" 报错 → Playwright 1.60 不用
.first()，直接用 selector - 草稿保存结果不明确 → 返回草稿箱核对章节号、标题、字数；不要点击其他发布相关按钮
- 验证码/风控 → 停止，让用户手动处理
注意事项
- 此技能处理的是已写好章节的草稿箱投递与核对，不具备正式发布能力
- 写作流程见
novel-writing、novel-main等技能 - 平台运营策略见
novel-platform - 不要试图提取/导出/搬运 Cookie，用固定浏览器 profile 保持登录态