Story Import

核心用法

story-import 是一款面向小说作者的项目逆向工程工具，用于将已有小说（无论是半成品还是完本）反向解析为可续写的标准项目结构。触发方式包括 /story-import 命令或自然语言如「导入小说」「反向解析」等。

显著优点

1. 智能篇幅分流：自动检测长篇/短篇，长篇走 Phase 3-L 路径（对接 story-long-write），短篇走 Phase 3-S 路径（对接 story-short-write），无需人工判断。

2. 深度复用分析管道：不重复发明轮子，直接调用 story-long-analyze / story-short-analyze 的完整拆解管道，获得章节摘要、角色分析、剧情节奏、情绪模块等结构化资产。

3. 工程化迁移：将拆文库产物自动迁移为可续写的项目结构——长篇生成 设定/、大纲/、正文/、追踪/ 等完整工程目录；短篇生成 正文.md、设定.md、小节大纲.md 的轻量结构。

4. 环境感知与降级：自动检测 story-setup 部署状态，未部署时提供「先去 setup」或「串行降级」两种选择，确保产物完整。

5. 残稿友好：识别最后一章是否为残稿，记录用户续写策略，支持基于残章直接续写。

潜在缺点与局限性

• 依赖前置技能：深度分析阶段完全依赖 story-long-analyze / story-short-analyze，若对应 skill 不可用则核心功能失效。

• 大型作品需增量：超过 200 章的作品需分批导入，首期仅前 50 章 + 概要，后续需手动触发增量补充。

• 部分字段需人工复核：章首/章尾钩子、核心梗三分法、伏笔回收等字段标为 [待补充]，需作者后续补全。

• 文风/节奏文件强依赖：story-long-write 日更循环强依赖 剧情/节奏.md、剧情/情绪模块.md 和 文风.md，v12 新契约拆文库缺失时必须修复重跑，不能静默跳过。

适合人群

• 已有小说想继续续写但缺乏项目管理的网文作者
• 想分析自己旧作结构并建立可复用写作资产的创作者
• 从其他平台迁移作品、需要重建大纲和角色追踪的作者

常规风险

1. 数据丢失风险：Phase 2 分析中断时需依赖进度文件恢复，建议在长作品导入时保持会话稳定。

2. 版本兼容风险：pre-v12 旧拆文库与 v12 新契约产物存在字段差异，导入报告需明确标记 legacy_deconstruction，避免日更时错误回退。

3. 角色状态遗漏：追踪/角色状态.md 是日更写前准备的关键依赖，若遗漏将导致续写永久降级，必须在导入完成报告中确认已生成。

4. 卷划分争议：原文无明确卷界时，候选方案需用户确认，机械硬切可能导致叙事结构割裂。

核心用法

story-import 是一款面向网文作者的专业逆向工程工具，核心功能是将已完成的或半成品小说反向解析为标准化、可续写的项目结构。其工作流程分为四个阶段：Phase 1 确认导入源并检测环境；Phase 2 调用 story-long-analyze 或 story-short-analyze 拆解管道进行深度分析；Phase 3 按篇幅类型（长篇/短篇）分别迁移为对应写作工程结构；Phase 4 激活项目并输出质量报告。工具支持自动篇幅检测、环境兼容性检查、并行/串行处理降级、以及增量导入策略（>200章作品）。

显著优点

1. 工程化思维：不同于简单的文本分析，本工具以"重建可续写工程"为目标，输出包含设定、大纲、正文、追踪、对标等完整目录结构，与 story-long-write / story-short-write 形成闭环工作流。
2. 智能篇幅分流：通过结构信号、字数统计、用户声明三重判定，自动路由到长篇（Phase 3-L）或短篇（Phase 3-S）迁移路径，避免人工判断失误。
3. 深度复用生态：完整调用 story-long-analyze / story-short-analyze 的拆解管道，不重复发明方法论；同时生成 拆文库/ 作为永久性分析资产，供后续对标使用。
4. 严谨的缺失处理机制：对 v12 新契约拆文库的关键文件（剧情/节奏.md、剧情/情绪模块.md、文风.md）实施 fail-fast 拦截，避免生成残缺项目导致日更阶段降级。
5. 角色状态追踪：专门实现角色状态反推算法，生成 追踪/角色状态.md，这是 story-long-write 日更循环的关键依赖，填补多数拆书工具的数据断层。

潜在缺点与局限性

1. 环境依赖较重：深度分析阶段依赖 story-setup 部署的专业 agent（如 chapter-extractor），未部署时虽可降级为串行处理，但速度显著变慢。
2. 多 Skill 协同复杂：涉及 story-setup、story-long-analyze、story-short-analyze、story-long-write、story-short-write、story-review 等多个技能，新手需要理解整个生态的协作关系。
3. 卷划分需人工确认：原文无明确卷界时，工具仅提供候选划分方案，必须等待用户确认，无法全自动完成。
4. 部分字段需后补：细纲中的章首/章尾钩子、题材定位的核心梗三分法等，因无法从原文稳定反推，标记为 [待补充]，依赖作者后续完善。
5. 大型作品需分批处理：超过200章的作品采用增量导入策略，首期仅导入前50章，完整导入需要多次交互。

适合的目标群体

• 已有存稿的网文作者：希望将已有作品转化为可管理的写作工程，以便后续续写或修改。
• 多平台迁移的作者：需要将其他平台的已发布作品重新整理为标准化项目结构。
• 续写需求明确的用户：明确需要继续写作已有作品，而非仅做拆书分析。
• 使用 story-long-write / story-short-write 生态的用户：作为该写作工作流的标准入口之一。

常规风险

1. 性能风险：大型作品（>500章）的分块处理可能消耗大量 token；未部署 agent 时的串行降级显著降低处理速度。
2. 依赖项风险：核心功能依赖其他 analyze 技能，若对应 skill 版本更新导致接口变化，可能影响导入流程。
3. 文件覆盖风险：对标视图中已有旧文风文件会被覆盖，虽在报告中告知，但用户若未阅读报告可能意外丢失历史版本。
4. 残稿处理风险：最后一章为残稿时，工具仅记录用户决定（基于残章续写 / 先补完再导入），不会自动修复残稿内容，选择失误可能导致续写质量下降。
5. 隐私与版权：用户需自行管理输入的小说内容和生成的项目文件，避免敏感或受版权保护的内容泄露。