前言¶
在 DSH 里用对话写长篇小说，常见问题是模型「口头跳阶段」——还没定好人设就开始写正文，或边写边改设定，百万字后人物境界、伏笔与时间线难以对齐。纯靠提示词约束阶段推进，缺少可校验的产物与回滚手段，长文一致性也容易崩。
大肥鱼的小说工坊（dsh-novel-writer）把网文创作拆成九阶段门禁流程，用 agent 工具硬约束推进，配合世界书设定注入、事实账本与一键写章/润色，把选题到完本落在可审计的本地项目数据上。下面介绍它是什么、能做什么，以及如何安装与上手。
这是什么¶
大肥鱼的小说工坊是面向 DeepSeek Harness（DSH）的网络小说创作插件，由 akira399 维护，在 SkillHub 目录分类为「工作流」，GitHub 仓库 akira399/dsh-novel-writer 当前约 13 stars。
插件定位：九阶段门禁式创作流程，叠加世界书（lorebook）设定注入、本地书籍导入、AI 一键润色、去 AI 味、黄金三章诊断、百万字一致性保障，以及市场调研与模板复制。包名 @dsh-external/dsh-novel-writer，当前最新发布版本为 v0.1.7。
核心功能¶
九阶段门禁式创作流程¶
阶段链为：选题 → 设定 → 人设 → 大纲 → 分卷 → 细纲 → 正文 → 修订 → 完本。
前一阶段未批准不能进入下一阶段；用户可显式放行或回退。每阶段产物写入 docs/<阶段>.md，历史版本保存在 versions/<phase>/v<n>，可回退任意版本。每次 commit、放行、回滚记入 audit.jsonl。
推进阶段、提交产物需走 novel_phase、novel_commit 等 agent 工具，避免模型仅口头宣称「已完成某阶段」。
世界书（lorebook）设定注入¶
- 关键词或正则触发，支持常驻注入；条目按书绑定，每本书独立栏目。
- 导入支持 Operit、SillyTavern、角色卡三种格式。
- 世界书面板可「导出到酒馆」，下载 SillyTavern 原生 lorebook JSON；也可在对话中用
lorebook_export_entries format=sillytavern。 - 可按书名与题材 AI 一键生成 4–6 条核心设定并绑定本书。
- 注入时有 token 预算裁剪，避免长上下文超限。
质量保障¶
- 去 AI 味：内置 234 词、5 类词库，带密度评分与一键改写（
novel_depolish）。 - 黄金三章诊断：规则层离线评分（钩子、开场、冲突、灌输、字数、对话），可选模型层深度诊断。
- 四族校验：结构、内容、剧情、一致性；提交时自动检查，也可对话触发
novel_validate。
百万字一致性¶
- 事实账本：章节内
<JSONPatch>自动记录人物境界、物品、地点状态；支持冲突检测与巡检。 - 时间线：书内时间归一与倒挂检测；伏笔登记与回收跟踪；世界书自动沉淀建议。
- 上下文包三层记忆（L1 全书设定 + L2 卷章细纲前文 + L3 摘要/变量/世界书），预算恒定；README 称压测 100 万字未超限。
一键写章与润色¶
- 一键写章：按上下文包生成正文并自动落盘，联动章节统计、账本与审计；强调遵循本章细纲、全书设定与前文事实。
- 一键润色：重构式润色——整句重写、扩写、可在段后添加细节；改动按段落拆成建议，每条可单独采纳或拒绝；原文视图随采纳实时更新，段内字级 diff 标亮；支持逐步撤销。
本地导入与配套能力¶
- 导入本地
.txt/.md，自动识别章节并建书（md 支持 frontmatter 题材/书名）。 - 27 类题材标签（玄幻、仙侠、武侠、西幻、都市等）。
- 修订（校对/节奏/文风）、导出（txt/markdown/平台排版）。
- 市场调研（
web_search引导，落盘reports/market.md）、模板复制、灵感库、伏笔、术语表、账本查询。
GUI 工作台与 agent 协同¶
- 侧边栏「大肥鱼的小说工坊」抽屉：项目列表、创建、详情、一键写章、润色、诊断、导入、世界书管理。
- 内置 41 个
novel_*/lorebook_*agent 工具、60 个提示词模板；技能novel-writing-workflow随插件启用自动注册。 - agent 预设「大肥鱼的小说工坊」：新建会话时在模式选择器选用，即锚定九阶段门禁创作 persona；预设、技能与工具三通道协同，对话驱动与 GUI 共用同一份项目数据。
安装与启用¶
需已安装 DSH（跨 Windows/macOS/Linux；运行时 Node ≥18）。README 强调务必安装最新版：旧版 v0.1.0、v0.1.1 在部分宿主会报 requires options.key 无法加载。当前最新为 v0.1.7。
从 releases/latest 下载 dsh-external-dsh-novel-writer-*.tgz（版本号最大；勿用 v0.1.0/v0.1.1），然后执行：
dsh plugin --profile web add <该 tgz 绝对路径>
dsh plugin list
确认列表中出现 dsh-novel-writer 且已启用后，刷新 DSH 页面（Ctrl+Shift+R）。
装好后应看到：
- 侧边栏出现「大肥鱼的小说工坊」入口。
- 设置 → 插件配置出现同名卡片（启用开关 + 数据目录，默认
~/.dsh/dsh-novel-writer）。 - 新会话自动带出技能
novel-writing-workflow。 - 新建会话模式选择器可选预设「大肥鱼的小说工坊」。
若入口未出现：先刷新页面，再重启 DSH，并在插件列表确认启用开关已打开。
进阶用户可用源码构建（需 Node ≥22 与 Git）：
git clone https://github.com/akira399/dsh-novel-writer.git && cd dsh-novel-writer
npm install && npm run verify && npm run build && npm pack
dsh plugin --profile web add ./dsh-external-dsh-novel-writer-0.1.7.tgz
典型用法¶
数据目录默认 ~/.dsh/dsh-novel-writer/：
lorebook/ 世界书（entries/groups/settings）
projects/ 项目（book.json、docs/、chapters/、audit.jsonl、ledger.json 等）
三分钟快速上手¶
- 打开侧边栏「大肥鱼的小说工坊」→ 点「一键导入示例《青云问道》」或输入书名创建。
- 进入项目详情 →「一键写章」→ 按上下文包出正文并自动存盘；不满意可「一键润色」。
- 或在对话中直接说：「创建项目，写本玄幻小说」「帮我写下一章」「把这段去 AI 味」「诊断一下开头」「克隆《青云问道》当模板」「调研下仙侠市场行情」「导入本地 txt」。
走完九阶段¶
创建后当前阶段为 topic（选题）。在对话中说「生成世界观设定」「设计人设」「写全书大纲」，模型用模板产出该阶段文档；完成后说「提交设定」走 novel_commit，校验通过即批准并解锁下一阶段。产物存于 docs/<阶段>.md，历史在 versions/<阶段>/v<N>。
写章、润色与世界书¶
- 项目详情选章节号 →「一键写章并保存」；或对话「帮我写下一章」。
- 「一键润色」后按段落采纳建议，确认保存或放弃还原；编辑区「撤销」可逐步还原历史。
- 项目详情「本书世界书」或列表行「世界书」按钮：AI 一键生成设定、手动新建条目、导入已有设定、导出到酒馆。
导入与导出¶
- 项目列表「导入本地书籍」选
.txt/.md，自动分章建书，可续写润色。 - 写完可导出 txt、Markdown 或平台排版文件投稿。
适用场景与注意¶
适合谁
- 在 DSH 里从零写网文、续写本地 txt/md、或需要门禁流程与设定账本保障长文一致性的作者。
- 习惯对话驱动创作的用户（选 agent 预设 + 技能引导），或偏好 GUI 点按钮写章/润色的用户（两者数据互通）。
注意事项
- 插件以当前 DSH 进程的权限运行，项目与世界书数据落在本地
~/.dsh/dsh-novel-writer；安装前建议阅读仓库源码与许可证文件，自行评估是否满足使用要求。 - SkillHub（目录页）是社区插件目录，与 DeepSeek / 幻方无官方从属关系；安装包以 GitHub releases 为准。
- DSH 生态理念是「一切皆插件」；本插件依赖 DSH 宿主提供的 cordis、dsh-tools、dsh-skill 等 peer 依赖，需保持 DSH 与插件版本匹配。
结尾¶
大肥鱼的小说工坊把网文创作从「随口聊」收束到九阶段门禁、世界书、账本与可回滚产物上，并提供一键写章、段落级润色与黄金三章诊断等落地工具。若你已在用 DSH 写长篇，可从安装 v0.1.7 包、导入示例《青云问道》或创建新书开始验证流程。
- 目录页：https://www.skillhub.cn/plugins/akira399/dsh-novel-writer
- GitHub：https://github.com/akira399/dsh-novel-writer
