核心功能
story-import 是一款面向小说创作者的逆向工程工具,核心任务是将用户已有的成品书或半成品书解析为标准化的写作项目结构,使其无缝接入 story-long-write(长篇日更)或 story-short-write(短篇续写)的后续创作流程。
工作流程
Phase 1:确认导入源
识别用户输入(文件路径、目录或粘贴文本),自动检测书名、章节数、字数、篇幅类型(长篇/短篇),确认用户意图是"完整写作工程"还是"仅拆文库分析"。同步检测 story-setup 基础设施是否已部署,未部署时提示用户选择是否先运行 setup。
Phase 2:深度分析
根据篇幅类型调用对应的拆解管道:
- 长篇:运行 story-long-analyze 的完整 6 阶段管道(Stage 0-6),产出逐章深度拆解、摘要、角色、剧情、设定、拆文报告、文风等全套资产
- 短篇:运行 story-short-analyze 的完整管道,产出拆文报告、情节节点、写作手法
产物统一落盘至 拆文库/{书名}/,作为后续迁移的输入。
Phase 3:结构迁移
将分析结果迁移为可续写的项目结构:
- 长篇:生成
{书名}/目录,含 设定/、大纲/、正文/、追踪/、参考资料/ 及题材定位、文风等文件,适配 story-long-write 日更循环 - 短篇:生成
{标题}/目录,含 设定.md、小节大纲.md、正文.md、对标/ 等,适配 story-short-write 逐场景写作
Phase 4:项目激活
执行质量检查、生成导入完成报告(含待补充项清单)、设置 .active-book,使项目可被对应写作 skill 识别并接手。
显著优点
- 零门槛续写:无需从零搭建项目,已有作品直接转化为工程化写作资产
- 方法论复用:深度分析阶段复用成熟的 story-long-analyze/story-short-analyze 管道,不重复造轮子
- 长短篇兼容:自动按篇幅分流,长篇走长篇路径,短篇走短篇路径,产物结构截然不同
- 工程化思维:交付物是可续写的"写作工程"而非一次性分析文档,
拆文库/是工程的一部分(喂给对标/),保留不丢弃 - 质量门控:长篇 Stage 3-4 含置信度/覆盖率/重叠率检查,短篇各阶段有完成标志验证
- 增量导入:超 200 章大型作品支持首期导入+分批补充策略
潜在局限
- 依赖前置技能:需 story-setup 部署基础设施才能获得完整并行分析能力,未部署时降级为串行处理
- 文风依赖 Stage 6:若 analyze 管道未完成 Stage 6,文风文件缺失会导致后续日更被 fail-fast 拦截
- 卷划分需确认:原文无明确卷界时,候选方案需用户确认后才写定,增加交互步骤
- 残稿处理保守:对最后一章残稿仅记录用户决定,不替用户选择"续写"或"补完"
- 角色状态反推复杂:依赖拆文库多文件产物,若前期分析质量不足会影响最终状态准确性
适合人群
- 已有半成品小说想系统续写的网文作者
- 想学习自己完本作品结构、提取可复用资产的研究型作者
- 多平台迁移需求的创作者(如从其他平台导出文本转为本地工程化管理)
- 需要建立"对标书"拆文库并同步文风给日更循环的技术型写作者
常规风险
- 数据完整性风险:大型作品分块处理时,若中断后恢复机制未正确追踪进度,可能导致章节遗漏
- 别名归并误差:角色别名自动合并置信度阈值(≥0.85)可能产生误判,需人工复核
- 时间线提取依赖标记:时间线.md 依赖原文时间标记,若原文时间表述模糊则输出精度下降
- 短篇误建长篇目录:迁移时若未严格按篇幅分流,可能误建追踪/、大纲/ 等短篇不需要的目录
技术定位
story-import 处于写作流水线的前置位置(导入 → 分析 → 迁移 → 激活),是"已有作品 → 可续写工程"的桥梁。与 story-setup(基础设施部署)、story-long-analyze/story-short-analyze(深度拆文)、story-long-write/story-short-write(续写创作)、story-review(质量审查)形成完整闭环。