Webnovel Serial Pipeline

核心用法

本技能是一套面向Quartz静态站点生成器的韩流网文连载完整工作流，覆盖从前期策划到最终发布的全部环节。使用前需配置WEBNOVEL_QUARTZ_ROOT环境变量指向Quartz仓库根目录，可选配置WEBNOVEL_DRAFT_ROOT草稿目录及NANO_BANANA_KEY封面生成API密钥。

标准执行流程：
1. 前期策划：通过结构化问卷确定题材（职场惊悚/黑色喜剧/现实向浪漫等）、参考作品（《我的大叔》《未生》《D.P.》等）、分级、篇幅及角色设定
2. 创作约束：强制应用"8条防俗规则"——禁止超能力、禁止meme用语、禁止解释性台词、强制潜台词、禁止善恶二分、禁止嘲讽式喜剧、禁止过度特效字体、强调代价而非结局
3. 稿件撰写：在隔离草稿目录完成，通过new_episode.py生成标准化frontmatter
4. 封面处理：Nano Banana Pro生成1K PNG，经ffmpeg转换为质量70-80、最大1200px的WebP
5. 质量检查：lint_episode.py检测重复句式（如같아서链）、作者旁白腔、对话 unnaturalness
6. 安全检查：prepublish_check.py扫描潜在恶意代码标记（含curl/wget检测正则，可能触发杀软误报）
7. 发布确认：必须等待用户明确输入"검수 완료"后，执行publish_review_ok.sh完成复制、索引同步

季度结构：10集标准架构——EP01钩子/触发器→EP02首事件→EP03-04结构暴露→EP05现实约束揭露→EP06-07强迫选择→EP08结构轮廓→EP09不可逆选择→EP10"之后"而非解决

显著优点

• 工业化水准的质量控制：内置成熟度评分卡（0个俗套台词、解释性对话≤20%、≥2人目标冲突、≥1个代价残留），将主观审美转化为可验证指标
• 关系动力学设计：拒绝"闲聊熟络"套路，采用"两次小额亏欠"（A→B的细微关怀行动+B→A的无声现实帮助）推进人物关系，符合韩剧叙事美学
• 安全发布机制：草稿与发布物理隔离，强制人工确认节点，防止半成品外泄；prepublis_check.py的误报设计实为安全特性
• 轻量化图像管线：ffmpeg参数针对Web阅读优化（WebP/70-80质量/1200px上限），平衡视觉品质与加载性能
• Quartz原生集成：自动处理wikilink嵌入、index.md剧集列表同步、6轴标签体系（domain/topic/format/audience/intent/lang）

潜在缺点与局限性

• 文化锁定：全部文档、标签体系及质量标准为韩语网文生态定制，非韩语创作者需大量本地化改造
• 硬依赖外部工具：Nano Banana Pro（封面生成）、ffmpeg（图像处理）、Quartz（站点生成）缺一不可，无法降级为纯Markdown工作流
• 杀毒软件摩擦：prepublis_check.py的恶意模式检测逻辑（含curl/wget正则）及shell脚本调用必然触发部分杀软误报，需用户手动信任
• 人工瓶颈未消除：虽然流程自动化程度高，但核心创作环节（选题、撰稿）仍为纯人工，工具仅提供约束与校验
• 季节结构僵化：10集模板对中短篇连载友好，但长篇连载（50+集）或单元剧格式适配困难

适合人群

• 韩语网文创作者：尤其追求《我的大叔》《未生》式现实质感、拒绝工业糖精的写作者
• Quartz数字花园运营者：希望将创作内容以结构化、可检索方式呈现的站点维护者
• 小型工作室编剧：需要统一团队产出标准、建立可复现的质量控制流程的内容团队
• 对技术容忍度高的作者：能接受环境变量配置、命令行操作及偶发的杀软误报

常规风险

• 误报疲劳：prepublish_check.py的安全扫描特性导致持续被杀软标记，可能训练用户无视安全警告，反而增加真实威胁漏报风险
• 环境配置漂移：依赖WEBNOVEL_QUARTZ_ROOT等环境变量，跨设备同步时需额外管理配置，易因路径错误导致发布到错误位置
• 单点故障：publish_review_ok.sh为关键路径脚本，若其中任一子脚本（lint/copy/sync）失败，可能处于部分发布状态
• 版权灰色地带：Nano Banana Pro生成封面图像的版权归属需确认，商用连载存在潜在法律风险
• 过度约束风险：8条防俗规则与10集结构模板可能抑制实验性叙事，长期套用易导致同质化

核心用法

该 Skill 构建了一套完整的韩语网络小说连载发布流水线，专为 Quartz 静态站点托管设计。核心工作流程遵循"草稿→审查→发布"的安全模式：

前期策划阶段：提供结构化的创作问卷（장르/레퍼런스/수위/길이/배경/캐릭터），一次性锁定作品基调；内置"8项幼稚化防止规则"（유치함 방지）和成熟度自动检查清单，确保输出品质符合现实主义韩剧风格（나의 아저씨/미생/D.P.等参考系）。

生产执行阶段：

• new_episode.py：创建标准化草稿模板
• to_webp.sh：调用 ffmpeg 将 Nano Banana Pro 生成的 1K 封面 PNG 转换为轻量 WebP（q70-80，最大1200px）
• lint_episode.py：检查重复句式（如 ~같아서 链）、作者旁白腔调、对话自然度
• prepublish_check.py 安全扫描：检测潜在恶意代码模式（curl/wget/PowerShell 等）
• publish_episode.py：经用户确认"검수 완료"后，将草稿从归档区移动至 Quartz 公开目录
• sync_index.py：自动更新系列 index.md 的章节列表

关键设计：强制"双小债务"关系推进法（작은 빚 2번）替代冗长闲聊，每集以单一尖锐钩子结尾，10集季播结构遵循"触发→推进→揭露→选择→不可逆→余波"的成熟叙事节拍。

显著优点

1. 出版级品控内置：不依赖创作者自我约束，通过 lint 脚本和成熟度 rubric 将"설명충 금지""밈 금지"等抽象原则转化为可执行检查
2. 安全优先的发布流程：prepublish_check.py 作为 ClawHub 预发布安全扫描器，主动检测数据外泄风险；用户需明确确认"검수 완료"才触发移动操作，防止误发
3. 视觉轻量优化：自动化 ffmpeg 封面转换确保移动端阅读体验
4. 现实主义美学框架：预设的参考系选择和 8 项防幼稚规则，有效引导作品走向成熟群像剧风格，避免新手常见的超能力依赖或善恶二元论
5. 零外部依赖风险：纯标准库实现（argparse, pathlib, shutil, subprocess, re, datetime），无第三方包供应链攻击面

潜在缺点与局限性

1. 误报警告：prepublish_check.py 包含的 curl/wget/PowerShell 检测正则，虽为安全特性，但可能被粗粒度杀毒软件误报为恶意代码特征
2. 韩语语境限定：设计范式深度绑定韩国剧集叙事传统（"아저씨"称谓文化、청불分级体系、지상파 드라마 pacing），移植至其他文化语境需大幅调整
3. Quartz 生态依赖：文件路径结构、wikilink 嵌入语法、index.md 标记约定均针对 Quartz 设计，迁移至 Hugo/Hexo 等平台需重写 sync/publish 脚本
4. Nano Banana Pro 隐性依赖：封面生成步骤默认接入该图像生成服务，未配置 NANO_BANANA_KEY 时需手动替代
5. 无版本控制集成：草稿归档与 Quartz 发布之间的 Git 操作需用户自行处理

适合人群

• 追求出版级连载品质的独立韩语网络小说创作者
• 使用 Quartz 搭建个人作品站点的技术写作者
• 需要结构化叙事框架防止创作偏航的新手（借助参考系选择和防幼稚规则）
• 重视发布安全、担心误操作公开未完成稿件的谨慎型用户

常规风险

| 风险类别 | 说明 | 缓解措施 |

|---------|------|---------|

| 误发风险 | 用户未充分检查即确认"검수 완료" | 强制人工确认节点；prepublish 安全扫描前置 |

| 路径配置错误 | `WEBNOVEL_QUARTZ_ROOT` 指向错误导致文件混乱 | `check_deps.sh` 依赖检查脚本验证路径存在性 |

| 杀毒软件误报 | prepublish_check.py 的正则模式触发警报 | 文件顶部已声明安全特性；建议沙箱先行测试 |

| ffmpeg 可用性 | 封面转换依赖本地 ffmpeg 安装 | check_deps.sh 验证依赖；提供纯 Python 回退方案建议 |

| 内容合规 | 청불/15세分级选择需匹配实际内容 | 内置 rubric 仅检查技术成熟度，不审查实质内容合法性 |

该 Skill 本质是将韩剧编剧室的生产规范转化为可执行代码，适合将创作视为工程而非纯粹灵感活动的严肃作者。