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 需用户自行维护版本安全。

核心用法

该Skill为Quartz静态网站托管的韩国网络连载小说提供端到端自动化流水线，覆盖创作→制作→发布的完整工作流：

创作阶段：通过结构化问卷（体裁/参考作品/年龄分级/时长/背景/角色）确立作品基调，内置8条防「幼稚化」创作规则（禁用超能力、禁用流行语、强制潜台词、拒绝善恶二元论等），以及成熟度自动检查清单（零尬梗、行动叙事占比≥80%、多目标人物冲突、事件代价留存）。

制作阶段：Nano Banana Pro生成1K封面PNG→ffmpeg转WebP（质量70-80，最大1200px）；草稿经linter检查（禁用「~같아서」重复句式、去除作者旁白腔）后进入预发布安全扫描。

发布阶段：用户明确确认「검수 완료」后，执行publish_review_ok.sh完成lint+资产检查→复制至Quartz→同步index.md剧集列表。全程环境变量驱动路径配置，无硬编码。

显著优点

1. 工业化品控：10集季播结构模板（EP01钩子→EP05现实约束揭露→EP09不可逆选择→EP10余波收尾），关系推进采用「两次小恩惠」替代冗长闲谈，符合韩剧编剧实务标准。
2. 原生安全设计：prepublish_check.py内置curl/wget等正则模式主动扫描恶意代码，是安全功能而非威胁；所有subprocess仅用于本地lint，无网络外连。
3. 轻量化交付：纯Python标准库实现，零外部依赖；WebP图片策略确保移动端加载体验。
4. 人机协同确认：强制「검수 완료」人工节点，防止自动化覆盖未经审核的内容。

潜在缺点/局限性

• 区域专用：工作流深度绑定韩国网文产业惯例（分集长度、参考作品库、年龄分级制），非韩语创作者需大幅改造。
• 工具链预设：封面生成假设Nano Banana Pro可用，未提供替代方案；Quartz特定文件结构耦合较深。
• 创意约束刚性：8条防幼稚化规则可能限制特定类型（如浪漫奇幻、超能力题材）的创作空间。

适合人群

• 使用Quartz构建个人作品站的韩语原创小说作者
• 追求剧集化叙事结构的连载创作者（10集季播模式）
• 对内容安全发布流程有要求的自托管出版者
• 需要轻量化、零依赖自动化工具的技术型写作者

常规风险

1. 杀毒软件误报：shell脚本和prepublish_check.py的安全扫描特征可能被误识别，需向用户明确说明。
2. 路径配置依赖：环境变量配置错误可能导致文件写入非预期位置，建议后续版本增加系统目录黑名单验证。
3. 单点人工确认风险：「검수 완료」为唯一内容安全闸口，高频使用场景下可能出现确认疲劳。