跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
文档处理

webnovel-export

将网文正文导出为 Markdown/TXT/EPUB/HTML/DOCX/PDF 格式。立即使用此 skill 当用户说:导出、导出小说、导出章节、生成电子书、导出 TXT、导出 Markdown、导出 EPUB、导出 HTML、导出 Word、导出 PDF、下载小说、输出正文。

lujih · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add lujih/webnovel-writer-opencode --skill webnovel-export

技能说明


name: webnovel-export description: 将网文正文导出为 Markdown/TXT/EPUB/HTML/DOCX/PDF 格式。立即使用此 skill 当用户说:导出、导出小说、导出章节、生成电子书、导出 TXT、导出 Markdown、导出 EPUB、导出 HTML、导出 Word、导出 PDF、下载小说、输出正文。 compatibility: opencode

正文导出

目标

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

支持格式

格式扩展名依赖说明
Markdown.md无原文拼接,适合存档
TXT.txt无纯文本,去 Markdown 标记
EPUB.epubebooklib电子书,带目录 + CSS 排版
HTML.html无单文件网页,内嵌 CSS + 目录
DOCX.docxpython-docxWord 文档,中文排版(首行缩进)
PDF.pdfweasyprint(可选)印刷品质,自动分页

环境设置

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:确认参数

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

参数何时询问选项
格式用户未指定导出格式Markdown / TXT / EPUB / HTML / DOCX / PDF
范围用户未指定章节范围全部 / 指定范围(1-50)/ 指定卷
书名未指定且需元数据(EPUB/PDF/HTML)默认项目目录名
作者EPUB/DOCX/PDF 未指定—
CSS用户提到"排版""样式"默认内置中文排版 CSS

明确指令示例(直接执行):

  • "导出为 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 "导出完成"

参数说明

参数说明适用格式默认值
--formatmd / txt / epub / html / docx / pdf全部md
--range1-50 / 1,3,5 / all全部all
--volume按卷导出(覆盖 --range)全部—
--output输出文件路径全部导出/{书名}.{ext}
--title书名(元数据)全部项目目录名
--author作者名EPUB/DOCX/PDF—
--cover封面图路径EPUB图片/封面/ 下最新
--cover-size封面裁剪尺寸EPUB1200x1600
--style自定义 CSS 路径EPUB/HTML/PDF内置中文排版 CSS

CSS 自定义

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

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

充分性闸门

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

常见问题

错误原因解决
未找到章节正文/ 目录不存在先用 /webnovel-write 写章节
EPUB 导出失败ebooklib 未安装pip install ebooklib
DOCX 导出失败python-docx 未安装pip install python-docx
PDF 导出失败weasyprint 未安装pip install weasyprint
封面未裁剪Pillow 未安装pip install Pillow,不影响导出
HTML 排版异常CSS 编码问题确保 export-style.css 为 UTF-8