webnovel-export

正文导出

目标

将网文正文导出为多种格式，便于发布或存档。导出是只读操作，不修改项目文件。

支持格式

环境设置

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}"

test -d "${PROJECT_ROOT}/正文" || { echo "错误: ${PROJECT_ROOT}/正文/ 不存在，无章节可导出"; exit 1; }

执行流程

Step 0：确认参数

若用户指令未明确包含以下参数，必须先询问用户：

明确指令示例（直接执行）：

• "导出为 EPUB" → 格式明确
• "导出第 1-50 章为 DOCX" → 格式和范围明确
• "导出全部为 PDF" → 格式和范围明确

模糊指令示例（必须询问）：

• "导出小说" → 格式不明
• "导出" → 所有参数不明
• "下载小说" → 同上

推荐一次性告知所有格式让用户选择，减少来回。

Step 1：列出章节

python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" export list

确认章节数量和范围。

Step 2：导出

# Markdown
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" export export --format md

# TXT
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" export export --format txt

# EPUB（需 ebooklib）
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" export export --format epub --author "作者名"

# HTML（单文件，含目录和内嵌 CSS）
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" export export --format html

# DOCX（中文排版：首行缩进、宋体、1.8 倍行距）
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" export export --format docx --author "作者名"

# PDF（需 weasyprint，未安装时提示安装）
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" export export --format pdf

# 指定范围
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" export export --format docx --range 1-50

# 按卷导出
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" export export --format epub --volume 1

# 自定义样式
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" export export --format html --style "${PROJECT_ROOT}/export-style.css"

# 自定义输出路径
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${PROJECT_ROOT}" export export --format txt --output "${PROJECT_ROOT}/导出/第一卷.txt"

Step 3：验证

ls -la "${PROJECT_ROOT}/导出/" && echo "导出完成"

参数说明

CSS 自定义

项目根目录放置 export-style.css 自动生效。默认排版：

• 首行缩进 2em
• 1.8 倍行距
• 章节标题居中
• 场景分隔符 * * *
• 思源宋体 / 宋体

充分性闸门

• 正文/ 目录存在且有章节文件
• 导出命令返回码为 0
• 导出/ 下有非空输出文件

常见问题