剧本管理

「剧本管理」是导入、浏览和配置小说剧本的中枢。上传一部 TXT 文件后，系统会自动识别章节结构并切分，之后可以构建向量索引、提取 NPC 角色卡和世界观条目，然后基于该剧本开始游戏或继续已有存档。

列表中标有「敬请期待」标签的剧本是功能预告，目前无法开始游戏。

入口：顶部导航栏「剧本」，默认显示「我的剧本」列表。「在线剧本库」入口在同一页面右上角。

关键概念

三个视图

• 我的剧本（默认）：列出你已导入或订阅的全部剧本，可查看章节数、字数、切分规则、就绪状态、关联存档数。
• 导入剧本：上传 TXT 文件的全屏页面，包含章节切分预览、模型选择与流水线开关。
• 在线剧本库：浏览其他用户公开分享的剧本，可直接导入（克隆）到自己名下。

章节切分规则（7 种）

导入时系统自动嗅探最合适的规则（置信度 ≥ 85% 显示绿色）。可手动指定：

就绪状态

列表「状态」列显示剧本各模块的就绪情况。缺失项以下拉菜单展示，每条缺失项点击后会跳转到详情面板的对应标签页，方便快速补齐。

向量索引

向量索引分为四个子模块：章节正文（chunks）、NPC 角色卡（cards）、世界书（worldbook）、知识库人物（canon）。各模块可独立触发重建，无需全量重嵌。详情面板「概览」标签的「向量索引」卡片显示各子模块的进度。

分享模式

剧本有四种分享模式（仅作者可设置）：

• 私有：不对外可见
• 公开：出现在在线剧本库，任何人可导入
• 固定快照：选定一个历史版本公开，后续改动不影响订阅者所见
• 浮动最新：始终公开最新版本

常见任务

导入一本新剧本（TXT 上传）

1. 在「我的剧本」列表右上角点「导入剧本」，进入导入页面。
2. 拖入或点击选择 .txt 文件（UTF-8 编码）。
3. 系统弹出「章节切分预览」，展示章节数、总字数、置信度以及前几章标题列表。
4. 如果置信度偏低或章节错位，点「换规则重试」切换规则，直到预览正常。
5. 确认后点「确认导入」。系统在后台依次完成切分、知识库人物提取、NPC 角色卡生成、世界书提取、时间线锚点构建。
6. 导入时可选择提取所用的 LLM 模型，并可关闭「生成角色卡」和「生成世界书」开关以跳过 LLM 阶段（仅切分章节）。

导入剧本包（ZIP 格式）

在「我的剧本」列表右上角点「导入剧本包」，接受 .zip 打包文件（含章节、角色卡、世界书），适合还原从他人处拿到的导出包。

从在线剧本库导入

1. 进入「在线剧本库」视图（顶部导航或列表页切换）。
2. 用搜索框筛选剧本，点卡片上的「导入」按钮。
3. 系统将剧本克隆到你的名下，随后可在「我的剧本」列表找到并开始游戏。
4. 已导入过的剧本显示「已导入」徽标，你自己发布的剧本显示「我的」徽标，不可重复导入。

查看与操作剧本详情

点击列表中的某条剧本，下方展开详情面板，包含以下标签：

• 概览：章节数、字数、切分规则、置信度、存档数、向量索引状态（四子模块）、分享状态
• 参数：script_overrides JSONB 设定，可查看和编辑（JSON 格式）
• 世界书：世界书条目内联编辑器；可触发「从知识库人物反推（免费）」或「LLM 重提富化」两种重建方式
• NPC 角色卡：剧本提取的 NPC 列表；可新增、编辑、设为主角、转为用户角色卡；满 2 张时可触发「AI 复核人名/语义」
• 知识库人物：LLM 抽取的人物/组织/地点等规范化条目（与 NPC 角色卡是不同数据）
• 时间线：故事阶段锚点列表，按故事时间标签分段展示
• 模块：7 个模块的统一重建矩阵，可分模块重做或全量重做
• 知识提取：一键触发全量 LLM 提取（覆盖所有模块）
• 叙事风格：篇幅、镜头、戏剧密度、心理、悬念、引导 6 个剧本级别滑块（仅作者可写）

详情面板顶部的操作按钮：

• 开始游戏：下拉菜单，可选「继续某个存档」或「开新游戏」
• 查看章节：打开章节浏览/编辑弹窗
• 设定核对：打开 KB 复核界面，确认 AI 提取内容无误
• 版本历史：查看并回滚到历史版本（仅作者可回滚）
• 更多操作下拉：建立向量索引、导出剧本包、公开/取消公开、退订（订阅的剧本）、删除

管理章节（ChaptersModal）

详情面板顶部「查看章节」，打开弹窗：

• 左侧：全部章节列表，点击切换
• 右侧：当前章节标题、字数、正文（懒加载全文）
• 右侧操作：重命名、拆分（按字符位置）、合并上一章、合并下一章
• 顶部「整本重切」：重新选择切分规则对整本重切

建立向量索引

选中剧本 → 详情面板顶部「更多」下拉 →「建立向量索引」，或在「概览」标签的索引子模块卡片上点「重做」。各子模块（章节/角色卡/世界书/知识库人物）可单独重嵌。

设置分享模式

选中自己的剧本 → 详情面板顶部出现「分享模式」选择器 → 选「公开」「固定快照」或「浮动最新」。选择「固定快照」时需要再选择具体的历史版本。公开前系统会检查设定核对状态，未核对的剧本需先完成「设定核对」。

Fork 订阅的剧本

在详情面板顶部的蓝色提示区域点「Fork」，系统以「原标题 (副本)」在你名下创建一份独立副本，后续修改不影响原作者。

查看版本历史与回滚

详情面板顶部「版本历史」按钮 → 打开右侧抽屉，列出全部历史 commit（含提交信息、类型、时间）。作者可点某条 commit 的「回滚」将剧本恢复到该版本。

导出剧本包

详情面板「更多」下拉 →「导出剧本包」→ 下载 .zip 文件（含章节、角色卡、世界书）。

删除或退订剧本

• 自己创建的剧本：「更多」下拉 →「删除」→ 确认。删除会同时清理向量索引，不可撤销。
• 订阅他人的剧本：「更多」下拉 →「退订」→ 确认。只从你的列表移除，不影响原作者。

使用剧本编辑器（高级）

如需对剧本内容做结构化编辑（修改世界书条目、时间线、NPC 设定等），可使用 剧本编辑器——它是 VSCode 风格的多栏 IDE，支持 AI 辅助续写与改写，适合深度编辑场景。

常见问题

导入后章节数不对，怎么办？ 打开「查看章节」→ 点「整本重切」，换一个切分规则试试。推荐先试「中文章节」，再试「自定义」并填写正则。

置信度低于 70% 是什么意思？ 系统识别章节标题的把握很小，实际切分可能错位。建议在预览里逐条检查后手动选规则修正。

为什么建了向量索引还是看不到 NPC 角色卡？ 向量索引（embedding）和 NPC 角色卡提取（extract）是两个独立步骤。NPC 角色卡在导入流水线的「生成角色卡」阶段产生；如果当时关闭了该开关，需要在详情面板「NPC 角色卡」标签触发重建，或在「知识提取」标签重新提取。

状态列显示「缺 N 项」，点开有多条，要一个个处理吗？ 可以逐条点击跳到对应标签页处理，也可以在「模块」标签页集中查看和触发所有模块的重建。

订阅他人剧本能改内容吗？ 不能直接改，但可以先「Fork」一份副本到自己名下，然后对副本进行修改。

删除剧本后存档还在吗？ 不在。删除剧本会同时删除关联的全部向量索引，存档也会失去对应剧本。操作前请确认。

相关

• 存档管理 — 基于剧本开始游戏或管理存档
• 角色卡 — 用户角色卡管理（NPC 转来的卡也在这里）
• 设定核对 — 确认 AI 提取的人物/世界观/时间线内容无误
• 剧本编辑器 — VSCode 风格的剧本深度编辑入口
• 世界书 — 世界观条目说明
• 时间线 — 时间线与故事进度说明