Webnovel Writer 快速入门指南:/webnovel-init 如何帮你 7 步搭好书的第一副骨架
【免费下载链接】webnovel-writer基于 Claude Code 的长篇网文辅助创作系统,解决 AI 写作中的「遗忘」和「幻觉」问题,支持 200 万字量级 连载创作。项目地址: https://gitcode.com/GitHub_Trending/we/webnovel-writer
Webnovel Writer是一套基于 Claude Code 的长篇网文辅助创作系统,解决 AI 写作中的「遗忘」和「幻觉」问题。而它的起点就是/webnovel-init——一条命令,通过分阶段问答,帮你把新书的设定集、总纲和初始状态一次搭好,生成可直接进入规划与写作的项目骨架。本文将带你走完「初始化一本书」的完整路径。
为什么第一副骨架这么重要
长篇连载最难的不是写出第一章,而是写到第 80 章、200 章以后仍然保持:
- 角色动机不漂移
- 战力、时间线、世界规则不互相打架
- 伏笔有登记、有推进、有回收
/webnovel-init做的事,就是把这些「必须记住、不能写崩」的约束,在你动笔之前就沉淀成结构化文件,而不是留在聊天记录里。它不是「先生成再返工」,而是先收集、再生成——信息不齐,它拒绝开工。
7 步交互流程:一次把核心设定问全
整个初始化是一场分波次的深度问答,每一轮只问「当前缺失且会阻塞下一步」的信息,你已经答过的不会重复问。
Step 1:预检与上下文加载
系统先确认工作目录可写、入口脚本就位,并加载最小参考(system-data-flow.md、genre-tropes.md),输出一份「已知信息清单」和「待收集清单」。
Step 2:故事核与商业定位
必收信息:
| 字段 | 说明 |
|---|---|
| 书名 | 将直接生成项目目录名 |
| 题材 | 支持A+B复合题材,如「修仙+系统流」 |
| 目标规模 | 总字数或总章数 |
| 一句话故事 / 核心冲突 | 全书主线锚点 |
| 目标读者 / 平台 | 商业定位 |
系统内置37 个中文网文题材模板(位于 webnovel-writer/templates/genres/),涵盖修仙、系统流、规则怪谈、古言、宫斗宅斗、无限流、克苏鲁等主流方向,完整列表见 docs/guides/genres.md。你自由描述「玄幻、修真」这类别名,系统也会自动映射到标准题材。
Step 3:角色骨架与关系冲突
必收:主角姓名、主角欲望、主角缺陷(会害他付代价的那种)、主角结构、感情线配置、反派分层(小/中/大)与镜像对抗。这一步直接决定后续角色卡的质量。
Step 4:金手指与兑现机制
必收:金手指类型(可以为「无金手指」)、风格、可见度、不可逆代价、成长节奏。系统流要给系统性格和升级节奏,重生文要给重生时间点和记忆完整度——这些细节正是长连载里最容易写崩的地方。
Step 5:世界观与力量规则
必收:世界规模(单城/多域/大陆/多界)、力量体系类型、势力格局、社会阶层与资源分配。题材相关字段(货币体系、宗门层级、境界链)按题材按需追问。
Step 6:创意约束包(差异化核心)✨
这是/webnovel-init最独特的环节:系统会生成 2-3 套创意包,每套包含一句话卖点、1 条反套路规则、2-3 条硬约束、主角缺陷驱动、反派镜像和开篇钩子,并展示五维评分辅助你决策。三问筛选很犀利:为什么这题材必须这么写?换常规主角会不会塌?卖点能否一句话讲清?
Step 7:一致性复述与最终确认
系统把五大核心(故事核、主角核、金手指核、世界核、创意约束核)汇总成「初始化摘要草案」交你确认。你未明确确认,不执行生成;只改局部,则回到对应步骤最小重采集。
充分性闸门:不合格就不开工
在执行生成脚本之前,有一个硬性检查(定义在 SKILL.md 的「充分性闸门」一节):
- ✅ 书名、题材(可复合)已确定
- ✅ 目标规模可计算
- ✅ 主角姓名 + 欲望 + 缺陷完整
- ✅ 世界规模 + 力量体系类型完整
- ✅ 金手指类型已确定
- ✅ 创意约束已确定(或你明确拒绝并记录原因)
字段结构可参考 init-collection-schema.md,生成逻辑在 init_project.py。
初始化后你会得到什么
命令跑完,工作区下会按书名生成一个干净的书项目目录:
project-root/ ├── .story-system/ # 合同、章节提交和事件审计 ├── .webnovel/ # 状态、索引、摘要、备份和长期记忆 ├── 正文/ # 章节正文 ├── 大纲/ # 总纲、卷纲、时间线和章纲 ├── 设定集/ # 世界观、角色、力量体系等设定 └── 审查报告/ # 章节审查报告关键产出物:
| 文件 | 作用 |
|---|---|
.webnovel/state.json | 运行时状态,title/genre/目标规模已写入 |
设定集/世界观.md | 世界规则 + 参考题材模板注入 |
设定集/主角卡.md | 欲望、缺陷、原型 |
设定集/反派设计.md | 反派分层与镜像对抗 |
大纲/总纲.md | 核心主线/暗线、创意约束、爽点里程碑 |
.webnovel/idea_bank.json | 你选定的创意包与约束 |
.story-system/MASTER_SETTING.json | 全书「合同」种子,后续规划的调性/禁忌参照 |
同时会生成.env.example(RAG 配置模板),复制为.env填入 API Key 后即可启用语义检索;不填也能用,系统会自动退回 BM25 关键词检索。
最终报告怎么看:四种总状态
初始化结束时,你会收到一份作者友好的最终报告,而不是原始 JSON 或报错日志。报告以一句总状态开头:
- 已完成:目标产物和关键校验都通过,可以进入下一步
- 部分完成:主要产物已保留,有跳过项或待确认的小尾巴
- 需要你处理:系统停在安全位置,需要你拍板
- 未完成:关键产物未可信生成,按报告建议重跑
下面固定三段:产生的文件与完成情况、过程中遇到的问题、下一步建议。失败也不会全量重来——系统采用「最小回滚」,只补缺失文件,不全量重问。
下一步:从骨架走向正文
初始化完成后,推荐按主链推进:
/webnovel-plan 1 # 规划第 1 卷:拆卷、拆章、补时间线 /webnovel-write 1 # 写第 1 章:备上下文、起草、审查、提交 /webnovel-doctor # 随时体检项目文件、数据库和依赖更多命令用法见 docs/guides/commands.md。
常见问题
Q:初始化大概要回答多少问题?A:分波次提问,只问当前阻塞项。信息给得越完整,轮次越少;答过的内容不会重复问。
Q:只有模糊脑洞,没有完整设定能做吗?A:可以。Step 6 的创意约束包就是为模糊想法设计的——系统会生成候选方案并评分,你只需挑选和裁决。
Q:选错题材能重开吗?A:重新运行/webnovel-init即可,系统会识别已有文件,只补缺失部分。
总结:/webnovel-init的价值在于把「开书前的所有关键决策」变成带闸门的结构化流程——先问全、再确认、后生成。骨架搭得越扎实,后续/webnovel-plan和/webnovel-write就越少返工。
【免费下载链接】webnovel-writer基于 Claude Code 的长篇网文辅助创作系统,解决 AI 写作中的「遗忘」和「幻觉」问题,支持 200 万字量级 连载创作。项目地址: https://gitcode.com/GitHub_Trending/we/webnovel-writer
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考