| name | fanqie-publisher |
| description | Automate Fanqie Novel publishing with a staged-preview gate that guarantees WhatsApp-shown text ≡ Fanqie-published text. |
| allowed-tools | Bash(playwright-cli:*) Bash(node:*) Bash(python:*) Bash(go:*) Bash(fanqie-publisher:*) |
Fanqie Publisher Skill
自动化发布番茄小说章节的技能。本技能的首要保证：
老板在 WhatsApp 上看到的正文 ≡ 番茄后台发布出去的正文。
这个等式由 CLI 的 prepare → publish 闸门在代码层强制实现，
openclaw 无论如何都不允许绕过。
环境前置（已就绪，仅供确认）
fanqie-publisher CLI：which fanqie-publisher 应返回 /opt/homebrew/bin/fanqie-publisher。playwright-cli：which playwright-cli 应返回 /opt/homebrew/bin/playwright-cli。- Chrome 浏览器 + 持久化 profile（
~/.playwright/fanqie-profile）：已登录过番茄作家后台。
🚫 禁令（违反 = 任务失败）
绝对禁止 用任何 MCP / 内置浏览器工具走 fanqie 发布流程：
mcp_openclaw_browser 及任何 browser.* / page.* MCP 工具- OpenClaw 内置的 Chrome profile
- 手动 goto、点击、填表模拟
唯一合法路径：run_shell_command → fanqie-publisher prepare ... → fanqie-publisher publish ...。
绝对禁止 在 chapter.txt 里写入以下尾注行（即使 CLI 会兜底过滤，也必须自律不写）：
第X章完 / 第X章终 / 第X章结 / 第X章束 / 第X章末本章字数：XXXX / 单独一行的 完 / 终（完） / (完) / （终） / (终)
写入路径规范
- 章节正文 必须 覆盖写入到：
/Users/hyz/.openclaw/workspace/chapter.txt。只有一个 chapter.txt，每章覆盖。不要写 /tmp/、不要写 chapter_<N>.txt。
- 总稿备份 必须 追加到：
/Users/hyz/Desktop/重生1982.txt。
预检
test -w /Users/hyz/.openclaw/workspace/ && echo "workspace writable"
test -w /Users/hyz/Desktop/重生1982.txt && echo "desktop writable"
如果任一失败，汇报「当前是只读模式，请切到 Default 模式（Shift+Tab）后重试」并停止。
工作流（严格按 4 步执行）
1. 生成正文并保存
cat > /Users/hyz/.openclaw/workspace/chapter.txt <<'EOF'
<正文内容>
EOF
printf "\n\n" >> /Users/hyz/Desktop/重生1982.txt
cat /Users/hyz/.openclaw/workspace/chapter.txt >> /Users/hyz/Desktop/重生1982.txt
2. 字数校验
fanqie-publisher validate --content-file /Users/hyz/.openclaw/workspace/chapter.txt --minHan 3000
- 成功：
{"ok":true,"step":"validate","hanCount":3050,...}
- 失败（Exit 2）：
{"ok":false,"code":"CONTENT_TOO_SHORT",...}
失败处理（强制）：
- 先回滚桌面备份：
APPENDED=$(wc -c < /Users/hyz/.openclaw/workspace/chapter.txt)
ORIG=$(($(wc -c < /Users/hyz/Desktop/重生1982.txt) - APPENDED - 2))
python3 -c "import os; os.truncate('/Users/hyz/Desktop/重生1982.txt', $ORIG)"
- 立刻扩写到 >= 3000 汉字，重写
chapter.txt，重走第 1、2 步。
- 不允许放弃，不允许「让用户手动粘贴」的兜底方案。
3. Prepare —— 过滤并暂存，同步给老板确认
字数校验通过后，必须执行 prepare 命令：
fanqie-publisher prepare --content-file /Users/hyz/.openclaw/workspace/chapter.txt
这个命令做两件事：
- stdout 打印过滤后正文（= 番茄上发布出去的完整正文，字符级一致）
- 副作用：在
/Users/hyz/.openclaw/workspace/.chapter-staged.txt 写入同一份正文作为发布暂存
发给老板的 WhatsApp 消息里的正文段落，必须是这条命令的 stdout 原样复制。
禁止自行重新生成、改写、删改；禁止把 chapter.txt 的原文直接发（那份还没过滤）。
前后可以写闲聊（「老板这章写完了」「反转够不够劲」），但正文段必须是 prepare stdout。
4. Publish —— 把已暂存的内容推到番茄
老板确认后执行：
fanqie-publisher publish \
--novel "重生1982：我有一片禁忌海" \
--volume "第三卷：轮回终结" \
--title "第八十二章 针影之下，锈蚀的记忆"
注意：publish 不再接受 --file 参数（传了会被忽略 + 警告）。发布内容一律从第 3 步产生的 .chapter-staged.txt 读取。
闸门行为（CLI 代码层强制）：
| 情况 | 结果 |
|---|
.chapter-staged.txt 不存在 | NO_STAGED_CONTENT 报错退出（code 3）；必须先 prepare |
| staged 文件超过 10 分钟 | STAGED_EXPIRED 报错退出（code 3）；必须重新 prepare |
| publish 成功 | 自动删除 staged 文件，下次必须重新 prepare |
因此：
- 如果 prepare 之后修改了
chapter.txt：publish 用的还是旧 staged（= WhatsApp 给老板看的）。要让新内容生效，必须重新 prepare → 贴新 stdout 给老板 → 再 publish。
- 如果跳过 prepare 直接 publish：CLI 拒绝。
首次登录（profile 失效时）
playwright-cli open https://fanqienovel.com/main/writer/book-manage --browser=chrome --headed --persistent
故障排查
| 现象 | 原因 | 处置 |
|---|
validate 报 CONTENT_TOO_SHORT | 汉字数 < 3000 | 按「失败处理」扩写并重校 |
publish 报 NO_STAGED_CONTENT | 没先 prepare | 运行 prepare → 贴 stdout 给老板 → 再 publish |
publish 报 STAGED_EXPIRED | 暂存超 10 分钟 | 重新 prepare，确保 WhatsApp 展示与最终发布一致 |
| publish 卡在「等待页面加载」 | 登录 session 失效 | 跑一次首次登录命令重新授权 |
Cannot find module 'playwright' | 绕过了 CLI 直接跑底层脚本 | 必须通过 fanqie-publisher publish 调用 |
写 /tmp/ 或桌面被拒 | 运行在 Plan Mode / 沙盒 | 切到 Default 模式后重试 |
多语言引擎
默认 Node.js。需要 Go 引擎时追加 --engine go：
fanqie-publisher publish --engine go --novel "..." --volume "..." --title "..."
（staged 文件闸门同样生效，与引擎无关。）
