# 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=<目录名>`。
4. **校对**：打开新书目录下 `工作区/迁移报告.md`，按「待校对」一节从上往下过：
   - `book.yaml` 的书名、题材对不对；
   - `大纲/伏笔/` 里标了「迁移待补」的收尾计划补一句；
   - 各处「迁移待校对-」开头的文件（记忆清单、文风候选、实体变更史）——有用的按提示归位，没用的直接删。
5. **继续写作**：对 AI 说「继续」，就接上正常写章流程了。

## 迁移了什么、没迁什么

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

## 常见问题

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