webnovel-serial-pipeline

WebNovel Serial Pipeline 是一套专为 Quartz 静态站点生成器设计的端到端网络小说出版工作流，特别针对韩剧风格的连载内容进行了深度优化。该技能通过标准化的管道处理，将创作、编辑、格式转换和发布流程无缝整合，解决了传统多步骤发布中的碎片化和质量不一致问题。

核心用法涵盖从项目初始化到最终发布的完整生命周期。用户首先需要配置 WEBNOVEL_QUARTZ_ROOT 环境变量指向 Quartz 站点根目录，随后通过 check_deps.sh 验证 ffmpeg 等依赖。创作阶段遵循严格的"8规则"质量框架，包括禁止超自然设定、避免解释性叙述、强制使用潜台词等，确保内容符合成熟电视剧的叙事标准。每集内容需经过 lint_episode.py 风格检查（检测重复用词和作者评论语调），配合 prepublish_check.py 安全扫描后，方可通过 publish_review_ok.sh 一键发布到 Quartz 站点并自动同步索引。

显著优点在于其工业级的质量管控体系。通过预设的成熟度检查清单（如对话比例、冲突设计）和季节结构模板（10集叙事弧线），帮助作者维持专业水准。自动化工具链支持 Nano Banana Pro 封面生成、PNG 到 WebP 的批量转换（优化至1200px/质量70-80），以及剧集索引的自动同步，大幅减少重复劳动。安全设计方面，采用"草稿隔离+人工确认"机制，仅在用户明确输入"검수 완료"后才执行发布，配合预发布安全检查脚本，有效防止敏感信息泄露。

潜在缺点包括生态锁定：该工具深度绑定 Quartz 文件结构和韩国网络文学惯例，迁移至其他平台（如 Hugo、Jekyll）需要大量适配。T3 来源（个人开发者）虽经代码审计，但长期维护稳定性仍存不确定性。此外，工作流假设用户具备基础命令行操作能力，对纯 GUI 用户不够友好。韩语优化的内容规则（如敬语系统、特定文化背景）也可能限制其在其他语言环境中的直接应用。

适合的目标群体主要是使用 Quartz 构建个人知识库或内容站点的网络小说作者，特别是创作现实主义戏剧、办公室惊悚等韩剧风格内容的创作者。同时也适合小型出版团队进行连载内容的标准化管理。

使用风险方面，尽管代码本身通过 A 级安全认证，但用户需注意环境变量配置错误可能导致文件写入到非预期位置。虽然脚本包含路径存在性检查，但建议首次使用时在测试目录验证。此外，prepublish_check.py 包含用于检测恶意代码的正则模式（如匹配 curl/wget），可能被部分杀毒软件误报，用户需提前列入白名单。依赖项 ffmpeg 和 python3 需用户自行维护版本安全。