核心用法
本技能（webnovel-serial-pipeline）是一套面向 Quartz 静态站点生成器的韩流网络小说连载工作流，覆盖从选题策划到最终发布的完整生产管线：
1. 前期策划阶段（Pre-writing）
- Kickoff 问卷：一次性抛出 6 维度选择题（장르/레퍼런스/수위/에피소드 길이/배경/캐릭터），快速锁定叙事基调
- 8项防俗规则：禁止超能力、禁止 meme、禁止解说式叙事、强制使用潜台词、复杂化善恶二分、情境喜剧而非人身攻击、克制视觉特效、强调"代价"而非简单结局
- 10集季播模板：EP01 埋设钩子→EP02 首事件→EP05 现实约束揭露→EP09 不可逆选择→EP10 余波收尾
2. 生产执行阶段（Pipeline）
- 草稿隔离：
$WEBNOVEL_DRAFT_ROOT与 Quartz 发布目录物理分离，确保"검수 완료"前不公开 - 封面工作流：Nano Banana Pro 生成 1K PNG → ffmpeg 转 webp（quality 70-80, max 1200px）
- 六轴标签系统：
domain/topic/format/audience/intent/lang标准化 frontmatter - 自动化脚本：
new_episode.py创建草稿 →lint_episode.py风格检查 →publish_review_ok.sh一键发布（含 index.md 同步）
3. 质量管控（Quality Gates）
- 成熟度 rubric：零尬词、解说台词≤20%、双人目标冲突、事件必留代价
- 关系推进规则："两次小债务"替代冗长闲聊，用"도현 씨"替代过度亲昵称谓
显著优点
- 工业化成熟度：从 Kickoff 问卷到发布脚本，每个环节都有可执行的检查单和自动化工具
- 安全设计：
.env隔离路径、.env.example模板引导、prepublish_check.py防密钥泄露——体现出对内容安全与运维安全的双重重视 - 叙事纪律：8 项防俗规则不是抽象建议，而是可量化的 rubric（如 "~같아서" 链式重复会被 linter 捕获）
- 本地化深度：针对韩国网剧/网文市场定制（레퍼런스 选项涵盖《나의 아저씨》《D.P.》《더 글로리》等），非通用模板移植
- 渐进式关系设计："两次小债务"规则将东亚人际暧昧转化为可操作的写作技法
潜在缺点与局限性
- 工具链锁定：深度绑定 Quartz + Nano Banana Pro + ffmpeg，迁移成本高；非韩文内容创作者难以复用参考系
- 创作风格窄化：强制现实主义基底（"초능력·과장 금지"）排斥奇幻、科幻、武侠等类型；8 项禁令可能扼杀实验性叙事
- 审核瓶颈："검수 완료"人工确认虽是安全设计，但也成为单点瓶颈，不适合日更高频连载
- 封面依赖外部 API：Nano Banana Pro 需
NANO_BANANA_KEY，成本与可用性不可控 - 季播结构僵化：10 集模板对短篇或长篇连载适应性差（EP05/EP09 强制节点可能削足适履）
适合人群
- 韩流网剧/网文编剧：需快速产出《D.P.》《나의 해방일지》风格现实主义剧集
- Quartz 站点运营者：希望将 Obsidian/Quartz 从笔记工具升级为出版平台的内容创作者
- 小团队内容工作室：1-2 人编剧+技术组合，追求"策划→写作→发布"最小 viable workflow
- 类型文学教学：作为现实主义叙事训练的 rubric 与工具链演示案例
常规风险
- 密钥泄露：尽管有
prepublish_check.py，.env文件仍可能被误提交；建议配合 git pre-commit hook - 版权争议：Nano Banana Pro 生成的封面图像版权归属需确认；剧集参考现实机构/地点可能触发韩国《信息通信网络法》诽谤条款
- 内容合规："청불"分级选项涉及韩国游戏物管理委员会或平台自主审核，技能本身不提供合规检查
- 依赖失效：ffmpeg 参数（
-q:v对应 webp quality）随版本变化，脚本未做版本适配 - 人际规则僵化："两次小债务"规则在高冲突场景（惊悚、犯罪）中可能显得刻意