@dsh-external/dsh-novel-writer

🎯 使用场景

场景	怎么做
从零开一本新书	打开工坊 → 输入书名/选题材 → 或用「五步向导」逐步引导
已有完本/定好的设定	用「模板复制」克隆一本带完整设定骨架的新书，直接开写正文
想要热门题材方向	「市场调研」→ 引导 web_search 查榜单热词 → 落盘选题参考
把本地网文 txt/md 收进 DSH 续写	「导入本地书籍」→ 自动建书分章 → 可直接继续润色/续写
保证不崩设定	世界书固化设定 + 账本巡检 + 一致性校验在写作时自动织入
写完投稿	「导出 txt」或 Markdown / 平台排版下载

---

📖 功能使用指南

下面按功能逐个说明「在界面哪里点 / 在对话里怎么说」，两种方式共用同一份数据与流程，随你习惯。

1️⃣ 创建一本书（九阶段流程的起点）

• 界面：打开「大肥鱼的小说工坊」抽屉 → 顶部输入书名 → 选题材（27 种，按分组排列）→ 点「创建」。
• 对话：「创建项目，写本玄幻小说」「新书，仙侠」「开本都市文」。
• 创建后进入项目详情，看到当前阶段（初始为 topic 选题）与各阶段状态。

也可以先点「一键导入示例《青云问道》」，一步得到一本带世界书条目的示例书，边看边学。

2️⃣ 走完九阶段（选题→…→完本）

• 阶段链：选题 → 设定 → 人设 → 大纲 → 分卷 → 细纲 → 正文 → 修订 → 完本，前一阶段未批准不能进入下一阶段（门禁）。
• 怎么推进：
  • 对话：说「生成世界观设定」「设计人设」「写全书大纲」，模型会用相应模板产出该阶段文档；完成后说「提交设定」走 novel_commit → 校验通过即批准解锁下一阶段。
  • 界面：目前阶段推进主要通过对话里的 agent 工具完成（novel_phase / novel_commit），舞台右上角会显示当前阶段与门禁状态。
• 产物自动存 docs/.md + 留历史版本（versions//v），随时可回退。

3️⃣ 写正文（一键写章）

• 界面：项目详情 → 选章节号 → 点「一键写章并保存」→ 模型按「全书设定＋本卷/本章细纲＋前文＋世界书命中等」的上下文包自动写一章 → 已自动存盘，统计/账本/审计联动。
• 对话：「帮我写下一章」「写第 5 章」「继续写」。
• 写好后左侧编辑框/B 面板可看到正文与字数（达标徽标）。不满意就点「一键润色」或手动改。

4️⃣ 润色与撤销

• 一键润色：点「一键润色」→ 模型重构式润色（整句重写/大胆扩写/可新增细节段，只守情节人物底线）→ 改动按段落列成建议，每条可单独采纳/拒绝，顶部原文视图会随采纳/撤销实时变化（采纳的段变绿显示润色文、新增段实时插入）→ 「确认保存」按你采纳的改动写入章节，或「放弃还原」恢复原文。
• 撤销：编辑区上方「↶ 撤销（N）」按钮。手动编辑、写章回填、润色应用都会记录历史，可连续点击逐步还原到任意之前的状态。

5️⃣ 建世界书（固化设定，不崩设定）

• 入口：项目详情右下「本书世界书」，或抽屉列表里书籍行的「世界书」按钮。
• AI 一键生成：世界书面板先在上方「栏目」下拉选一本书 → 点「AI 一键生成设定」→ 按书名+题材自动生成 4-6 条核心设定（世界观/主角/宗门/境界等）并绑定本书。
• 手动：点「+ 新建条目」→ 填名称/内容/触发关键词（逗号分隔）/是否常驻/优先级，并「绑定到本书」。
• 导入已有设定：lorebook_import_entries（Operit / SillyTavern / 角色卡格式，可直接发文件）。
• 导出到酒馆：世界书面板点「导出到酒馆」→ 下载 novel-lorebook-export.json → 在 SillyTavern「Import」导入即可当前置设定（也可对话 lorebook_export_entries format=sillytavern）。
• 写作时命中的条目会自动注入上下文包（每书独立栏目，Lorebook）。

6️⃣ 导入本地书籍

• 界面：项目列表「导入本地书籍」→ 选一个本地 .txt / .md 网文文件 → 自动识别章节标题（含"第一章/楔子/番外"等）并建书 → 全部正文按章同步，可直接续写/润色。
• 对话：「导入本地 txt」。

7️⃣ 质量体检（诊断 / 去 AI 味 / 校验）

• 结构诊断：项目详情底部「结构诊断」→「诊断本章」→ 得分与问题（钩子/开场/冲突/灌输/字数/对话）。
• 去 AI 味：对话「把这段去 AI 味」→ novel_depolish 检测并改写（内置 234 词 5 类词库）。
• 四族校验：提交时自动跑结构/内容/剧情/一致性；也可对话「校验这章」手动触发 novel_validate。

8️⃣ 保持一致性（长文不崩设定）

• 事实账本：章节内 `` 自动落账（人物境界/物品/地点状态）。
• 巡检：对话「跑一遍一致性巡检」→ novel_consistency_audit 查账本冲突、时间线倒挂、伏笔超期，并给出世界书沉淀建议。
• 查账本：「林远现在什么境界」「查一下账本」→ novel_ledger。
• 伏笔/时间线：对话「登记个伏笔，第 3 章埋，第 20 章回收」「记录第 5 章书内时间『第三日』」→ novel_foreshadow / novel_timeline。

9️⃣ 修订与导出

• 修订：对话「修订第 3 章，校错别字」→ novel_revise（校对/节奏/文风三模式，产出新版本不覆盖原稿）。
• 导出：界面项目详情「导出 txt」（带 BOM，可直接投稿）；对话「导出成稿」→ novel_export（txt / markdown / 平台排版）。

🔟 市场调研 & 模板复制

• 市场调研（选题用）：对话「调研下仙侠的市场行情」→ novel_market_research mode=prompt 给你一组 web_search 检索词 → 模型检索后以 mode=report 把榜单热词/读者偏好/同类卖点落盘 reports/market.md → 选题报告里引用。
• 模板复制（克隆设定骨架）：对话「以《青云问道》为模板开本新书」→ novel_clone_project 复制字数目标/风格/禁用词 + 已完成的阶段设定文档（选题/设定/人设/大纲/分卷/细纲），正文不复制，状态机重置——直接对着现成设定写正文。

1️⃣1️⃣ 灵感 / 术语表

• 对话「记个灵感：雨夜剑冢」「建个术语表：玄天宗——地域宗门」→ novel_idea / novel_glossary（选题拉取聚合、术语注入防用词漂移）。

1️⃣2️⃣ 用「创作模式预设」开新会话

• 新建会话 → 预设选择器选「大肥鱼的小说工坊」→ 直接对话「创建项目，写本玄幻小说」即进入创作模式（persona + 技能方法 + 41 个工具自动就位）。

💡 提示：几乎每个功能都有对应的 novel_* 工具，模型在创作模式下会自己调用并提示你确认（写操作）。你不必记命令，用大白话提需求即可；想知道有哪些能力，对话里说「小说工坊能做什么」。

---

⚙️ 配置

设置	默认	说明
enabled	true	插件总开关（关闭即注销工具/技能，数据保留）
dataDir	~/.dsh/dsh-novel-writer	数据根目录
uiHidden	false	隐藏侧边栏「大肥鱼的小说工坊」入口（存于浏览器本地，任何环境可用；即时生效）

设置入口：设置 → 插件 → 大肥鱼的小说工坊（0.2.0 起由 settings.plugins.tab 提供）。 这些字段也可直接写在 profile 的 cordis.patch.yml 里；写入后会重新装配插件（普通配置变更走 Loader 的常规更新生命周期，无需手动重启）。

项目级（创建时/模板复制保留）：27 题材、每章字数目标（默认 2000-4000）、风格（视角/禁用词/AI 味词）、阶段门禁开关。

---