3步让前作续写接力：ainovel-cli已有小说语义导入管线（/import）实战

3步让前作续写接力：ainovel-cli已有小说语义导入管线（/import）实战

【免费下载链接】ainovel-cli✨多agent实现全自动AI小说生成项目地址: https://gitcode.com/gh_mirrors/ai/ainovel-cli

ainovel-cli是一款多 Agent 全自动 AI 小说生成引擎，它的/import语义导入管线能让你在3 步内把手头已有的小说（txt / md）"语义编译"进项目，自动识别章节、提取人物与伏笔、重建世界观和大纲，然后无缝接力续写——无需写正则、无需手工整理设定，中断了也能从断点精确恢复。

为什么要用 /import 语义导入？

想让 AI 接着你的旧作往下写，传统做法是把整本书丢给模型"总结一下"，但常见问题很多：

• 章节切分靠正则：换个标题格式就切歪，前言、番外可能悄悄丢字；
• 长书一次性总结必截断：50+ 章的正文塞进一次调用，输出 JSON 直接被掐断；
• 中途失败就前功尽弃：导到一半报错，只能从头再来。

ainovel-cli 的/import走的是分阶段语义编译管线：模型负责理解"这段文字是什么意思"，代码负责保证"每个字都有去向、失败可诊断、崩溃可恢复"。管线全景设计见 docs/import-pipeline.md，核心实现位于 internal/host/imp/。

第 1 步：启动导入，一句话发起

在新启动目录的欢迎界面（导入只能进入空书）输入：

/import ~/我的小说.txt

面板会实时显示各阶段进度：源文件快照（ingest）→ 模型识别章节边界（segment）→ 逐章提取事实（analyze）→ 分层归纳全书（synthesize）→ 发布（publish）。其中切分完成后会主动停下，等你核对。

💡 源文件支持txt/md，UTF-8 与 GB18030 编码自动识别；解码不可靠会明确报错，而不是静默乱码。

第 2 步：核对章节切分，按 y 确认

这是整条管线里唯一需要你出手的环节。预览面板会列出：

• 卷 / 章总数与全部章节标题（可滚动）；
• 每章起止行号，方便对照原稿；
• 空章、超长章和模型标记"存疑"的边界；
• 前言、尾注等附属文本的范围与摘要。

确认无误后按y放行；切分不对就按Esc关闭面板，用自然语言纠正后重新识别（见下文）。

切分不标准？用大白话指挥：

/import --guide=幕间·X 也是独立章节

--guide接受任意自然语言说明（可含空格，置于命令最后），例如"番外篇也算独立章节"。它会被落盘为切分的语义输入，指导变化后旧切分自动失效重做——全程不需要你写一行正则。

第 3 步：坐等分析完成，验收后续写

确认后管线自动跑完剩余全部阶段，把原文逐字落盘为已完成章节，同时重建：故事前提、角色档案、世界规则、分层大纲、卷弧结构、终局方向指南针（Compass）。

完成后默认停在验收 Hold——等你检查设定和章节状态，确认无误再用正常入口（如/next）恢复创作，引擎就会带着完整的伏笔台账和角色状态继续往下写。

常用选项速查表

前三个选项会持久化到intent.json，崩溃恢复后依然遵守；--yes只授权切分确认，不会替你跳过导入完成的验收 Hold，只有显式--continue才接力续写。

断点恢复：中断了怎么办？

写一本书可能跑上数小时，断网、Ctrl+C、断电都很正常。每个阶段的产物都落在meta/import/工作区，并按输入指纹绑定：

• 重跑/import只会补做缺失部分，已完成的章节分析直接复用，不重复调用模型、不重复付费；
• 重启后欢迎界面会主动提示"发现未完成的导入（已分析 N/M 章），输入 /import 从断点恢复"；
• 恢复完成前，引擎被门禁挡住，不会把半成品当成完整的书去续写；
• 模型输出失败时的原始响应保存在meta/import/failures/，排查有据可查。

你不需要记住"导到第几章了"——恢复动作完全由工作区事实推导。

导入背后发生了什么？

一条管线的六个阶段，各司其职：

1. 确定性读取：解码、归一化、建立稳定行坐标，一字不删；
2. 语义切分：模型判断哪行是章标题、卷标题还是前言，代码校验"全文每段非空文本恰好属于一个区域"；
3. 逐章事实提取：按模型输入/输出双预算组批，串行提取每章的核心事件、伏笔更新、角色状态变化；
4. 分层综合：长书先归纳区间摘要再合并为全书合成，短书一步到位；
5. 组装验证：卷弧必须连续覆盖 1..N 章，角色与规则满足类型约束；
6. 幂等发布：复用正式提交流程逐章落盘，digest 相同则跳过，不同则报冲突。

这套设计让"模型越强、导入越准"，而坐标、顺序、幂等这些簿记始终由代码兜底——详见 docs/import-pipeline.md 与 internal/host/imp/runner.go。切分、分析、综合三类语义函数还可在配置roles中分别指定模型档位（import_segment/import_analyze/import_synthesize），把机械性更强的切分指到更便宜的模型省成本，参考 config.example.jsonc。

新手注意事项

• 📌只能导入空书：不支持把另一本书并入已有作品；
• 📌原文逐字落盘：因此导入适合"续写同一本书"；如果只想借鉴设定做全新创作，直接用普通方式起新书更合适；
• 📌故事状态存疑时会停下：综合判定为uncertain时，用--story=open|closed明确后重跑即可；
• 📌导入期间引擎不创作：与写作、评审等写操作互斥，同一本书只允许一个导入任务；
• 📌想看完整过程：每次导入有专属日志<书目录>/logs/import.log，含全部进度事件转录。

小结

三步走，前作即刻接力：

1. /import 我的小说.txt启动语义导入；
2. 核对章节标题，按y确认（切歪了就--guide用大白话纠正）；
3. 等待分析综合完成，验收后继续续写——中断也不怕，/import从断点恢复。

配合 scripts/install.sh 安装 ainovel-cli，你的一部长篇旧作就能以"设定 + 伏笔 + 角色状态"完整形态接入创作引擎。更多能力（实时干预、逐章验收、EPUB 导出）见项目 README。

【免费下载链接】ainovel-cli✨多agent实现全自动AI小说生成项目地址: https://gitcode.com/gh_mirrors/ai/ainovel-cli