前言¶
DSH 的理念是「一切皆插件」,写作工具也不例外。问题是:让模型写小说,事情往往卡在三处。一是没人盯着结构,大纲、章纲、正文散落在对话里,写到几十章就接不上;二是审稿全靠主模型自审,它既写又改,很难客观发现「AI 味」和逻辑漏洞;三是没有回头路,改完一章不知道对大纲有什么影响,伏笔埋了也记不住。
dsh-novel-studio 就是针对这三点做的:把小说写作拆成一条固定流水线,用多个子智能体并行审稿,用不调用模型的确定性扫描压低 AI 味,再在右侧栏用故事图谱把整本书的结构可视化。
这是什么¶
dsh-novel-studio 是 DeepSeek Harness 的小说创作插件,维护者 ggghhh-11,分类为「工作流」,GitHub 仓库 ggghhh-11/dsh-novel-studio,星标 1,许可证 MIT,版本 0.4.0(来自仓库 package.json)。
它解决的问题是:在 DSH 会话里写长篇时,把「一句话想法」推进到「可连载的正文」,中间有模板、有进度、有审稿、有复扫,缺一步可以暂停、可以恢复。
它不是模板合集。模板只保留作者能主观决定的内容,作者生平、创作意图、读者接受史、批评史、文学史定位这些已经剔除。
核心功能¶
一句话定位:意图触发的写作流水线 + 多子智能体评审 + AI 味扫描 + 故事图谱。
流水线顺序固定:设定卡 → 全书大纲 → 章纲 → 正文 → 多子智能体审稿 → 改写复扫。
几个值得单独说的能力:
- 意图触发:说「我想写小说」「开个新坑」,插件在模型调用前弹询问,选「暂不启用」则不创建任何文件,本会话不再问。
- 批量生成:章纲一次 1–500 章,正文一次 1–3 章;每章字数默认 2500,范围 800–8000,正文按目标 ±10% 生成。
- 确定性扫描
novel_scan:不调用模型,检查套话命中(带行号)、句长分布、四字成语密度、比喻标记密度、指代密度、长句占比、嵌套、生僻词,给出 AI 味得分(0–100,越高越好)、可读性得分和必须重写段落。 - 平台风向:内置番茄、起点、晋江、知乎盐选、纯文学、暂不指定的基线,
platform_scan联网检索后归纳 3–6 条当前风向存进platform_brief,写进主模型与审稿角色的提示词。切换平台会清空旧风向。 - 作者风格记忆:把你的改稿与原稿做确定性比对,提取句长、用词替换、标点偏好等,存进
style-memory.json,后续生成与审稿自动带上。 - 故事图谱:故事线/情绪曲线、人物关系图、节奏与篇幅、审校指标四块;没有手写数据时按章节正文自动估算。
安装与启用¶
方式一,web profile 下从 GitHub 安装:
dsh plugin --profile web add github:ggghhh-11/dsh-novel-studio
装完重启 dsh web。仓库里的 cordis.patch.yml 会自动注册插件行,不需要手改 profile 补丁。
方式二,DSH Desktop。desktop profile 由应用独占管理,CLI 的 dsh plugin --profile desktop ... 会被拒绝,所以要走本地 bundle:
git clone https://github.com/ggghhh-11/dsh-novel-studio.git
然后在 DSH「设置 → 插件 → 安装本地 bundle」里选这个目录,或者让 plugin_manager 用 install_bundle 指向它。安装后刷新一次页面,侧边栏「插件」按钮正下方会出现小说图标。
启用有两条路径:
- 对话触发:直接说「我想写小说」,插件弹出询问,选「启用」即进入工作台并展示模板精简版;已有项目时会问「继续该项目 / 新建项目 / 暂不启用」。
- 侧边栏触发:点小说图标 → 「启用小说创作工作台」。只有一个活跃会话时,启用通知直接送进该会话;否则登记请求,下一回合生效。
注意:插件以当前 dsh 进程的权限运行,能读写工作目录里的文件、能发起联网检索。安装前建议先读一遍源码和 LICENSE。
典型用法:一轮写作跑下来¶
以下步骤都来自 README 描述的流程,命令和接口名写全,方便照着试。
先创建项目并填设定卡。模型会先问书名与发表平台,然后自动联网检索该平台的公开信息,再问篇幅、每章字数、审稿子智能体、跳脱值。题材和文风不预设方向,模型基于检索素材和自身判断给出热门与潜力方向,区分事实与判断,再由你确认:
novel_studio(action='brief')
// 保存路线预设、维度回答、自由描述、字数与轮次;也可带 outlineText 或 outlinePath 直接用你写好的大纲
brief 保存后插件不会直接往下走,它会返回「下一步选项」。这时候要先问你要本书大纲、章纲还是正文(用 next 可以拿当前阶段可执行的操作清单):
novel_studio(action='next')
生成全书大纲:
novel_studio(action='outline')
// 返回大纲的生成指令与落盘路径,文本写成 大纲.txt
批量生成章纲。from 是起始章,count 取 1–500,比如一次 30 章:
novel_studio(action='chapter_outline', from=1, count=30)
// 整批写进一个 TXT,例如 第001-030章-章纲.txt
生成正文,单章或批量,可指定章节字数:
novel_studio(action='draft', chapter=1, chapterWords=2500)
正文写完登记,触发右栏文本预览、版本记录与备份:
novel_studio(action='output_done', file='第001章.txt', kind='chapter')
每一步的输出都是 TXT,默认落在项目目录,面板「保存目录」或 outputDir 参数可以改到工作区内任意位置。
停写后恢复,模型会调 resume 问你怎么走:
novel_studio(action='resume')
其中「下次再来」对应 checkpoint,会把进度写入项目目录的 checkpoint.md / checkpoint.json,下次说「继续写」即可恢复。放弃本次写作用 discard,需要 confirm=true 二次确认,并且会删除项目目录。
审稿与改写¶
审稿流程是:主模型写稿 → review_plan → 用 workflow 工具并行子智能体 → 裁决(accept/partial/reject)→ 有实质分歧时 debate_plan 拉相关子智能体交叉质询 → 主模型最终裁决 → 改写 → novel_scan 复扫 → 未达标则下一轮。轮次默认 2,面板里可设 0–4,AI 味阈值 50–95。
审稿角色共 32 个,其中两个专属角色必须每次都在场:
- 通顺度与可读性审校员:查逻辑断裂、指代不清、跳跃、晦涩长句、术语堆砌。
- AI 味猎手:查套话、空泛抒情、机械转折、比喻堆砌、总结陈词、句式整齐划一。
默认按目标取一组,正文是 11 个。review_plan 会显示类似「11/32」。想全开就传:
novel_studio(action='review_plan', roleSet='all')
降本用 lean,默认是 standard,也可以在侧边栏面板里按平台/商业/工艺分组自由勾选。两个工艺角色无论怎么选都会保留。并发过高可能触发模型供应商限流,被限流时换 lean 或分两批;没有 workflow 工具的会话只能降级成逐个 subagent 串行。
多轮后仍不满意时,指出具体问题,插件会生成专项审稿子智能体提示词:
novel_studio(action='custom_review', issue='第三章节奏拖沓,钩子断档')
钩子、图谱与风格记忆¶
生成章纲或正文后,模型会把本章埋设与回收的钩子提交给插件:
novel_studio(action='hooks', hooks=[...], resolved=[...])
右侧栏「钩子」页按「未回收 / 已回收」分组,显示章号、类型(悬念/伏笔/反转/谜题)、内容与状态,面板统计卡显示「钩子 未回收/总数」,长线连载时用来防止伏笔烂尾。
故事图谱在 chart 提交数据后自动打开,没有手写数据就用章节正文自动估算,面板标注「自动估算」:
novel_studio(action='chart')
图谱里看得到张力折线与章末钩子标记、人物关系图、每章字数柱状与钩子折线、审校指标随轮次的变化。
改稿回输有两种方式。想只学写作习惯:
novel_studio(action='learn_style', revised='改稿全文', original='原稿全文')
也可以用文件路径(revisedPath + originalPath),或在右栏「风格」页点「学习这篇改稿」。比对内容是段落/句子级增删改、句长段长与对话占比变化、删掉的 AI 套话、用词替换、标点偏好。
如果改稿动了剧情,插件不只看文风,还会先问你是否同步改大纲:
novel_studio(action='revision_impact')
有影响时选择「同步修改」会生成完整新大纲并保存,旧版自动备份到 history/:
novel_studio(action='outline_revision')
novel_studio(action='outline_apply')
保存后问这版是否符合预期,确认后再选审稿角色组,用 review_plan(target='outline', roles=[...]) 审新大纲。
适用场景与注意¶
适合在 DSH 里写长篇或系列故事的开发者和作者:想按平台风格(番茄、起点、晋江、知乎盐选、纯文学)写,需要大纲到正文的连续推进,需要客观审稿而不是模型自审,需要台账式的钩子与图谱。
不适合的场景:短篇一次性成稿,直接对话更快;只需要文笔润色,用风格记忆那部分就够了,不必跑全流程。
三点注意。第一,插件以当前 dsh 进程权限运行,安装前检查源码与许可证(MIT),对来源不明的第三方插件保持同样的审慎。第二,platform_scan 会联网检索平台公开信息并把素材写进上下文,公司内网或对出网有限制的环境需要先确认。第三,批量正文会稀释质量,插件会提示,追求单章质量时建议 count=1。
小结¶
dsh-novel-studio 把小说写作从「模型自由发挥」变成一条有检查点的流水线:模板收敛设定,流水线保证结构,32 个子智能体并行审稿给出独立意见,确定性扫描负责客观指标,图谱和钩子台账负责长期连载不失控,风格记忆让作者的修改偏好沉淀下来。功能边界清楚,代码量不大,值得用 small 项目试一轮再决定是否全量启用。
目录页:https://www.skillhub.cn/plugins/ggghhh-11/dsh-novel-studio
GitHub:https://github.com/ggghhh-11/dsh-novel-studio