webnovel-publish

小说自动发布

目标

将已完成小说章节自动发布到目标平台。首次需手动扫码登录，后续全自动运行。

支持平台

环境设置

export SCRIPTS_DIR="${PWD}/.opencode/scripts"
test -d "${SCRIPTS_DIR}" || { echo "错误: 未找到 ${SCRIPTS_DIR}，请确保当前目录是 webnovel-writer 仓库根目录"; exit 1; }

export PROJECT_ROOT="$(python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PWD}" where)"
test -n "$PROJECT_ROOT" && test -f "${PROJECT_ROOT}/.webnovel/state.json" || { echo "错误: PROJECT_ROOT 解析失败，请用 --project-root 显式指定"; exit 1; }
echo "项目路径: ${PROJECT_ROOT}"

python -c "import playwright" 2>/dev/null || { echo "请先安装: pip install playwright && playwright install chromium"; exit 1; }

交互式流程

Step 0：确认参数

若用户指令模糊，按优先级询问：

可直接执行：

• "发布到番茄" → 平台明确，进入菜单流程
• "上传第 90-95 章" → 操作和范围明确
• "发布全部到番茄" → 平台和范围明确

Step 1：首次配置（登录）

python -X utf8 "${SCRIPTS_DIR}/webnovel.py" publish setup-auth --platform fanqie

弹出浏览器窗口，扫码登录后自动保存认证状态。后续无需重复。
认证存储在 ~/.webnovel-publish/browser_data/{platform}/。

Step 2：查看书单

python -X utf8 "${SCRIPTS_DIR}/webnovel.py" publish list-books --platform fanqie

确认目标书籍是否存在，获取 book_id。

Step 3：创建新书

# 交互式（会询问书名、简介）
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" publish create-book \
  --platform fanqie \
  --project-root "${PROJECT_ROOT}"

# 非交互式（跳过确认）
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" publish create-book \
  --platform fanqie \
  --project-root "${PROJECT_ROOT}" \
  --yes \
  --abstract "自定义简介"

自动从 state.json 读取：书名、题材、简介、主角名。
创建成功后自动绑定 book_id 到项目（写入 .webnovel/publish_config.json）。

Step 4：上传章节

# 上传全部（使用项目绑定的 book_id）
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" publish upload \
  --platform fanqie \
  --project-root "${PROJECT_ROOT}"

# 指定 book_id 或书名（首次上传自动绑定）
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" publish upload \
  --platform fanqie \
  --book 7631548393474493502 \
  --project-root "${PROJECT_ROOT}"

# 指定范围
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" publish upload \
  --platform fanqie \
  --range 90-95 \
  --project-root "${PROJECT_ROOT}"

# 跳过交互确认（脚本/CI 环境）
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" publish upload \
  --platform fanqie \
  --yes \
  --project-root "${PROJECT_ROOT}"

已上传章节自动跳过，支持断点续传。
上传日志存储在 ~/.webnovel-publish/upload_log/{project_name}/{platform}_{book_id}.json。

Step 5：草稿管理（新增功能）

5.1 清理重复草稿

# 预览模式（不实际删除，查看哪些章节有重复）
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" publish clean-drafts \
  --platform fanqie \
  --project-root "${PROJECT_ROOT}" \
  --dry-run

# 清理重复草稿（同章节号保留最新修改时间的，删除旧版本）
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" publish clean-drafts \
  --platform fanqie \
  --project-root "${PROJECT_ROOT}"

# 跳过确认
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" publish clean-drafts \
  --platform fanqie \
  --project-root "${PROJECT_ROOT}" \
  -y

适用场景：多次上传同一章导致草稿箱有重复，想保留最新版本删除旧版本。

5.2 清空草稿箱

# 清空草稿箱所有章节（跳过已发布的）
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" publish clear-drafts \
  --platform fanqie \
  --project-root "${PROJECT_ROOT}"

适用场景：想清空草稿箱重新开始，但不删除已正式发布的章节。

5.3 删除全部草稿

# 删除草稿箱全部章节（包括已发布的，需二次确认 yes）
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" publish delete-drafts \
  --platform fanqie \
  --project-root "${PROJECT_ROOT}"

# 跳过确认（危险操作）
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" publish delete-drafts \
  --platform fanqie \
  --project-root "${PROJECT_ROOT}" \
  -y

危险操作：会删除所有草稿，包括已发布状态的章节，并清除上传记录。

5.4 发布草稿

# 发布草稿箱中的章节（将草稿改为已发布状态）
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" publish publish-drafts \
  --platform fanqie \
  --range 1-10 \
  --project-root "${PROJECT_ROOT}"

# 发布全部草稿
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" publish publish-drafts \
  --platform fanqie \
  --project-root "${PROJECT_ROOT}"

适用场景：章节已在草稿箱，想批量发布到正式站。
注意：发布时会用草稿箱现有的 item_id，标题和内容从本地文件读取。

参数说明

子命令列表

自动绑定机制

• 首次 create-book 成功后自动绑定 book_id 到 .webnovel/publish_config.json
• 首次 upload --book <id> 成功后自动持久化绑定
• 后续 upload 无需传 --book，自动从绑定读取
• 多书项目：用 --book 指定目标即可

卸载与重置

# 清除认证状态
rm -rf ~/.webnovel-publish/browser_data/

# 清除上传日志
rm -rf ~/.webnovel-publish/upload_log/

# 清除项目绑定
rm "${PROJECT_ROOT}/.webnovel/publish_config.json"

充分性闸门

• Playwright 已安装且 Chromium 可用
• 平台认证状态有效
• 目标书籍 book_id 已知或在书单中
• 上传日志一致（不会重复上传）
• 章节文件存在且非空

常见问题