migration-guide.md 2.7 KB

v6 → v7 迁移指引

给用过 v6(插件市场版)的作者:v7 换了安装方式和数据格式,老书用一条命令迁过来,原项目不动。

你会得到什么

  • 老书变成一个 v7 书仓库(定稿 / 大纲 / 文风 / 工作区 四个中文目录),正文一个字不丢。
  • v6 的伏笔逐条建档、角色进名册和角色卡、时间线和章摘要归位。
  • 一份人话迁移报告(工作区/迁移报告.md):迁了什么、哪些要校对、哪些如实没迁。
  • 原 v6 项目只读未动——迁移失败自动回退,不满意删掉新目录即可重来。

操作步骤

  1. 卸载市场版插件(v7 不再走插件市场):在原 AI 工具里移除 webnovel-writer 插件;老项目文件夹保留。
  2. 装 v7 工作目录:挑一个存书的文件夹(以后所有书都住这里),在里面运行:

    npx webnovel-writer init
    
  3. 迁移:还在这个工作目录里,运行(把路径换成你的 v6 书项目根目录,就是含 正文/ 的那个文件夹):

    webnovel-writer migrate <v6项目路径>
    

想指定新目录名(比如同名书已存在)加 --dir=<目录名>

  1. 校对:打开新书目录下 工作区/迁移报告.md,按「待校对」一节从上往下过:
    • book.yaml 的书名、题材对不对;
    • 大纲/伏笔/ 里标了「迁移待补」的收尾计划补一句;
    • 各处「迁移待校对-」开头的文件(记忆清单、文风候选、实体变更史)——有用的按提示归位,没用的直接删。
  2. 继续写作:对 AI 说「继续」,就接上正常写章流程了。

迁移了什么、没迁什么

v6 去处
正文(三种历史命名都认) 定稿/正文/(补章档案,章定位标「迁移」)
章摘要 定稿/摘要/章摘要/
伏笔 大纲/伏笔/ 逐条一文件
实体/别名(含 5.4+ 存数据库的) 名册 + 角色卡
时间线 定稿/设定/时间线/
总纲/详细大纲/剧情线 大纲/总纲.md + 大纲/卷纲/
设定集 定稿/设定/ 原样
记忆/文风套路 「迁移待校对-」文件,人工过一遍再入
追读力债务台账、向量库等派生数据 不迁(报告里如实列出)

常见问题

  • 提示"不像 v6 书项目":路径要指到书项目根目录(含 正文/.webnovel/),不是工作目录也不是插件目录。
  • 提示目录已存在:加 --dir=<新名字>
  • state.json 坏了/丢了:照样迁正文、大纲、设定集,报告会说明运行态数据没读到。
  • 迁完想重来:删掉工作目录里的新书目录,重新跑 migrate——v6 原项目始终没动。