Show Me The Story [v3] —— 用 AI 系统化写长篇小说的本地工具
单文件、零折腾、数据留在本地。接上你习惯的 OpenAI 兼容 API，从设定、分卷大纲到逐章创作与全书优化，形成一条可控的长篇创作流水线。
- 项目仓库：show-me-the-story
- 界面语言：中文 / English，可随时切换
- 支持平台：Windows, Linux, MacOS
- 许可证：MIT
这是什么？
Show Me The Story 是一款面向网文 / 长篇小说作者的 AI 辅助写作工具。它不是在线 SaaS，也不是只能聊天出片段的通用对话框——而是一套面向长篇的完整小说生产流水线：
- 管理多个故事项目
- 结构化维护角色、世界观、组织与人物关系
- AI 生成全书 / 分卷大纲，支持无限追加新卷
- 导入已有正文，按章分析且可在中断后恢复
- 按章写作、审核、确认，带一致性检查、伏笔追踪与叙事记忆
- 段落级编辑与 AI 修订；可选「去 AI 味」润色、章节衔接优化、全书优化
- 全局写作助理可查询和操作项目资料
全部跑在你自己的电脑上，通过浏览器界面操作。发布包是单个可执行文件，前端界面已内嵌，无需单独部署 Node 或数据库。
适合谁用？
| 你可能正在…… | 这个工具能帮你 |
|---|---|
| 有完整构思，想快速拉出百章甚至千章量级大纲 | 先生成卷骨架，再按卷生成章节大纲，前情自动压缩 |
| 已经写了一部分，想接着往下写 | 导入已有正文，逐章分析；中断后可从检查点恢复并生成后续大纲 |
| 怕 AI 写着写着人设崩塌、前后矛盾 | 结构化设定 + 写前一致性检查 + 章后事实核查 + 叙事记忆 |
| 想埋长线伏笔又怕后面忘了 | 内置伏笔系统，写作时自动注入活跃伏笔 |
| 讨厌一股「AI 腔」 | 可选技能包去 AI 味 |
| 习惯自己调 API、换模型 | 支持任意 OpenAI 兼容接口，配置保存在本地 |
如果你只是偶尔让 AI 写几百字段子，这款工具可能偏重；但如果你想系统化地推进一部长篇，它会比通用聊天窗口顺手得多。
核心功能一览
1. 多项目管理与本地数据
每个故事是独立项目，设定、进度、章节和聊天记录互不干扰。启动后先选项目或新建，随时切换；项目语言可在创建时选择中文或英文，决定 AI 提示词与生成正文的语言。
v3 的章节正文采用分章文件存储：大型作品不会再因一个不断膨胀的进度文件而拖慢读写，前端也会按需加载章节正文。
2. 故事配置与结构化设定
- 基础配置：书名、梗概、写作风格、每章目标字数、核心写作提示词等
- 角色：姓名、性格、背景、外貌等字段化维护
- 世界观：条目化管理设定细节
- 组织：可勾选成员，方便群体关系维护
- 关系图谱：Canvas 力导向图可视化人物 / 组织 / 世界观之间的关联，支持拖拽与缩放
修改关键设定后，若已有已确认章节，可触发设定协调——AI 会比对新旧设定与正文，尽量自动兼容，并刷新待写章节的大纲。
3. 大纲阶段：短篇直接写，长篇按卷写
- 根据故事配置生成全书章节大纲
- 大纲确认后进入写作阶段
- 支持提出修订意见让 AI 改大纲
- 支持 inline 编辑单章 pending 大纲
- 层级大纲：先生成卷级骨架，再逐卷生成章节大纲；已完成卷会压缩为摘要，避免超长篇上下文失控
- 无限连载：可追加新卷，并自动扩展总章节数与生成新卷大纲
- 导入已有作品：粘贴全文后本地切章 → 预览确认 → 逐章分析大纲与摘要；任意时刻停止后均可恢复
若已有确认过的章节，会拒绝「整本重新生成大纲」，避免覆盖已完成内容；需要追加章节请用「生成后续大纲」。
4. 写作阶段（重头戏）
每章经历 待写 → 生成中 → 待审核 → 已确认 的状态流转：
- 流式输出：生成过程实时显示，长章节也不会卡死页面
- 写前检查：对照前情与上一章结尾，发现大纲与已写剧情冲突时自动微调本章大纲
- 章节脉络约束：写作时注入后续章节大纲摘要，减少「提前剧透式」误写
- 事实核查：章后自动核查人设、时间线、伏笔、重复事件等，不通过则自动重写（最多 3 次）
- 定向修订：可对任意章节（含已确认章）提出修改意见，最小化改动，不影响其他章
- 段落 Block 编辑：正文按自然段拆分为稳定 Block，可手动编辑、插入、删除，或让 AI 只修订某个段落
- 引用式修订：框选正文后引用到修改意见，AI 优先只重写命中的自然段
- 自动确认模式：开启后，每章生成完毕自动确认并继续下一章，适合通宵赶稿（随时可关）
- 章节衔接优化：已确认 ≥ 2 章时，可批量检查相邻章开头是否生硬，仅必要时微调开头
- 叙事记忆：每章完成后提取大纲未覆盖的关键细节，在后续写作和核查中持续注入
- 导出：支持导出 TXT、复制单章内容
5. 伏笔、叙事记忆与全书优化
AI 可建议伏笔，也可手动创建。伏笔有生命周期（已埋下 → 推进中 → 已回收 / 已放弃），写作时会把与本章相关的活跃伏笔注入 prompt。
叙事记忆会记录角色、地点、物品、事件与承诺等不易写进大纲的细节，并附带原文片段，降低长篇写作中“写过却忘了”的概率。
全书章节全部确认后，还可进行全书诊断、一致性核查和优化路线图：先审阅报告与工单，再按选择执行定向修订或润色，避免让 AI 不加区分地重写整本书。
6. 技能（Skill）系统
内置若干可选技能文件，默认全部关闭，由作者按需启用：
功能性流程（大纲、正文、核查）默认不注入技能，避免无意改变文风；只有你明确开启才会生效。
7. 全局写作助理
独立聊天界面，带工具调用能力，可读写项目内的角色、章节、大纲、伏笔等。适合「帮我查一下第三章谁出场了」「把某角色性格改一下」这类交互式操作。
日常核心流程（生成 / 确认 / 修订）都通过页面按钮直接完成，不依赖聊天间接操作。
典型使用流程
新建项目 → 填写 API 配置与故事设定
↓
（可选）AI 生成初始角色 / 世界观
↓
生成大纲 / 分卷骨架 → 审阅 / 修改 → 确认大纲
↓
逐章生成 → 审阅 → 确认（或开启自动确认连写）
↓
（可选）去 AI 味润色、优化章节衔接、全书诊断与定向优化 → 导出全文
续写已有作品时，在大纲页选择「导入已有内容」，先检查本地切章预览，再启动逐章分析；中断后可直接恢复，完成后生成后续大纲或追加新卷。
安装与运行
环境要求
- 一个 OpenAI 兼容 的 API（Base URL + API Key + 模型名）
- 操作系统：Linux / Windows / macOS（Release 提供多平台预编译包）
从源码构建
# 推荐：一键构建（含前端）
task build
# 运行（默认端口 48090，可用 PORT 环境变量修改）
./show-me-the-story.exe
浏览器访问 http://localhost:48090 即可。
开发模式
task dev # 编译并启动 Go 后端
数据存放位置
- 全局 API 配置：
api.json（与程序同目录） - 各故事项目：
storys/{项目名}/下，含进度、设定、章节正文、聊天记录等
数据全在本地，换电脑时拷贝整个目录即可迁移。
v3 兼容性提示：v3 使用新的项目存储格式。为保护正文，v3 会将旧版或无法识别的工程显示为不兼容且不会打开；请使用创建该工程的原版本程序继续操作。本版本不提供自动迁移。
技术特点（给折腾党看的）
- Go 后端零第三方依赖，标准库实现 HTTP、SSE、文件存储
- 单二进制分发，前端 Vite + Svelte 构建产物通过 embed 内嵌
- 异步任务互斥：同一时间只跑一个 AI 任务，避免并发写乱数据；可随时停止
- 流式 SSE 推送：生成过程实时可见，前端做了节流、尾部窗口与按需章节加载优化，长篇不卡顿
- API 调用无限重试：网络抖动自动退避重试；401/403/404 等配置错误会立即报错
- 大书上下文换挡：完成的卷压缩为卷摘要，仅保留当前卷的详细章节大纲，支持超长篇持续写作
使用建议
- 先写好故事配置再生成大纲——梗概、风格、核心提示词越具体，大纲质量越稳定。
- 角色和世界观尽量结构化维护——写作时会自动匹配注入，比每次在聊天里重复描述靠谱。
- 不要跳过审核——至少前几章手动确认，确认 AI 文风与叙事节奏符合预期后再开自动确认。
- 模型选择——长文写作建议用上下文窗口较大的模型；核查与大纲可用同一模型，也可按成本分层。超长篇可优先使用分卷大纲。
- 技能默认关闭是刻意的——需要改文风时再开润色类技能，避免干扰主线生成。
已知局限
- 依赖外部 LLM API，质量与成本取决于你所选模型与服务商
- 本质是辅助工具，不是一键出完美成书；大纲、正文仍建议人工审阅
- 同一时间只能执行一个 AI 任务，批量操作需排队
- v3 与旧版工程不兼容，且暂无自动迁移；升级前请确认仍可使用旧版本程序打开旧工程
小结
Show Me The Story 把长篇创作拆成了可复用的流程：设定 → 分卷大纲 → 分章写作 → 核查与记忆维护 → 全书优化 → 导出。全程本地可控、项目可管理，既能从零开书，也能导入已有作品后继续连载。
欢迎试用、反馈使用体验，也欢迎交流提示词调优、模型搭配与长篇实战心得。
