dsh-novel-solo

DeepSeek Harness 的「单核写作」插件：一个 子 agent 并发数量设置 + 一套完整的小说创作预设（persona）。面向量化小模型做了充分的工具瘦身与输出加固，适合在本机用本地模型跑长篇小说流水线。

特性

GUI 设置：在插件页提供「子 agent 数量（1-12）」设置卡片（0.1.7 在左侧栏「插件」，0.1.6 在「设置 → 插件」），随插即用，支持中/英双语。
完整创作预设：随插件附带 novel-solo 预设，内置自驱写作 persona——按固定流水线完成叙事方法 → 核心世界观 → 名词索引 → 大纲 → 章节目录 → 人物档案 → 逐章写作 → 章节审核 → 全书终审与合订。
量化安全协议：输出只用常用汉字/普通标点、禁 JSON、禁转义、少用易崩 token；非必要不调工具、一次只调一个。
审核闭环：每章必审（绿黄红三色），A–G 七个维度（设定/人物性格/目录/叙事/正文规则/禁AI腔/剧情逻辑），审核报告落盘为 md；全书完成后统一终审并合订为单本书。
禁AI腔：按六维度判定（句式模板/词汇套话/情绪直给/结构雷同/信息稀释/人物失真），区分叙述层重复与人设层一致，写作与审核共用。
工具瘦身：预设内行级禁用 shell/jobs/skills/goals/web 等整行工具，压缩工具目录 schema。
版本化写作：每章 第N章-章节名字-vX.md，整章重写先复制 v(X+1)、旧版永不覆盖。

安装

dsh plugin --profile web add "dsh-novel-solo"
dsh web

打开插件页——0.1.7 是左侧栏的「插件」，0.1.6 是「设置 → 插件」——即可看到 dsh-novel-solo 的「子 agent 数量」卡片。

0.1.7 之前的宿主还会把 template/ 里的预设幂等铺设到 <dshHome>/.agent-presets/novel-solo/（那是旧宿主唯一的预设入口；目标已存在则跳过，绝不覆盖你已编辑的预设）。0.1.7 起不再铺设，预设就是 profile patch 里的一行声明。

宿主版本兼容性

本插件支持 DSH 0.1.6-alpha.1 / 0.1.6-alpha.2，以及 0.1.7-alpha.1 起往后的每一个宿主版本，按宿主自身版本二选一走哪条路。版本探测由两半各做一次、口径一致：cordis.patch.yml 里 preset-novel-solo 行的 disabled: !!js，以及 lib/index.js 的 isLegacyHost，都从 ctx.profileContext.installAnchor 读宿主版本，读不出来一律退回 0.1.6 路径。0.1.7 及以后的宿主（含 0.2.0）走同一条路。

	0.1.6	0.1.7 及以后
预设交付	铺设 `template/` 到 `<dshHome>/.agent-presets/novel-solo/`	patch 里的声明行 `@deepseek-ai/dsh-agent-preset`
`N` 存哪里	插件自己向 settings 服务注册的 `dsh-novel-solo` 命名空间	本包的 `Config`（`count` 标了 `volatile`），由宿主投影进 profile patch
卡片挂载	`settingsScope` + `settings.plugin.item` 插槽	`configForms` + `plugins.item` 插槽

两条路都在真宿主上跑过：0.1.7 一侧用 0.1.7-rc.1 验证（卡片出现在「插件」页、保存落进 cordis.patch.yml、预设进入选择器）；0.1.6 一侧因为本机没有 0.1.6 的宿主可执行文件，只做了同一版本门控的离线验证。0.1.7-rc.2、0.2.0-rc.1、0.2.0-rc.2 与 0.2.1-alpha.1 是读那几个版本的宿主源码核对的，没有实跑：预设行的字段、settings.configure / configForms 两个接口、plugins.item 插槽和 profileContext.installAnchor 与 0.1.7-rc.1 完全一致。

插件能不能加载，在它的代码跑起来之前就定完了：从 0.1.7-rc.1 起宿主会拿 peerDependencies 里每一个 @deepseek-ai/dsh* 范围去比对当前版本，对不上就把整行禁用。所以这份清单以一个开区间收尾——>=0.1.7-alpha.1，不写上界——因为本插件不绑定任何特定宿主构建：走哪条路由它自己的版本门控在装载时才决定，那么一个还没人核对过的版本也该照常把插件跑起来，而不是被一道失败即关的检查整个挡掉。开区间之前被点名的版本才是真正逐一比对过的。开区间不承诺的是契约变更后的行为：将来若出事，先坏的会是声明式预设行，而那一次的修改属于 patch 文件，不属于范围。engines.dsh 只是把同一份清单复述给读者看，宿主并不解析它。装到此前拒绝本插件的宿主上要重启 dsh web，因为这个判定发生在 profile 组装阶段。

0.1.5 起 persona 使用 @deepseek-ai/dsh-persona 的新配置字段 prefix（0.1.2-rc.1 的旧字段 text 已移除），更老的宿主需要手工把 persona 行的 text: 改名成 prefix:（complete / includeRuntimeContext 不变）。每个宿主 home 各持一份铺设副本，旧 home 的 text: 副本切回旧宿主仍可用。

子 agent 数量如何影响行为

DSH 的 agent/request 瀑布只允许插件改写 LLM 路由/config，不能注入或改写 system/messages，所以「GUI → 模型提示」的动态注入不能走请求瀑布。本插件改用文件中转：

设置卡片把 N 存进宿主设置（见上表），那里才是事实源。
装载时 node 半区把它镜像到 <dshHome>/.dsh-novel-solo-data/agent-count.json。
persona 行在预设装载时用 !!js 读 template/persona.md，把文件里的同步锚点 并发上限 N=<数字> 换成镜像里的数字。persona 据此决定：N=1 全部由主代理一人完成；N>1 写作/审核交给子代理、主代理只派活并静默等待。

注意：镜像和 persona 都是在宿主装载插件的过程中解析的，所以改完数量要重启宿主才会进到提示词。0.1.7 的 volatile 设置在 node 侧没有变更回调，实时推送做不了。

预设内容速览

persona 正文在 template/persona.md；template/agent.cordis.yml（同步进 cordis.patch.yml）负责它周围的工具行。内容：

区块	内容
分工模式	并发上限锚点 `N=1`（默认），N=1 / N>1 两种执行路径
量化安全铁律	输出与工具调用的最优先级约束
六类文档标准结构	叙事方法 / 核心世界观 / 名词索引 / 大纲 / 章节目录 / 人物档案逐字段模板
写作与审核规范	正文规则、禁AI腔清单、章节审核 A–G + 绿黄红、审核报告 md、全书终审与合订
工具使用标准	read/write/edit/glob/grep/subagent 等逐工具铁律
项目与纪律	项目目录 `{{cwd}}/项目名/`、一次只做一件事等

工具瘦身

预设通过行级 disabled: true 硬禁用：tool-bash、tool-jobs、skill-filesystem、tool-skill、tool-goal、plan-mode、subagent_codex、subagent_claude_code、workflow-worker-thread、tool-workflow、tool-ralph、tool-todo、tool-web。保留 tool-fs（read/write/edit）、tool-fs-search（glob/grep）、str-replace-editor（view/create/str_replace/insert）、tool-pwsh（已解禁，仅做文件系统管理：改文件夹/文件名、删除文件夹/文件）、subagent/subagent_fork、list_agents 等。

随包还携带一个 preset 作用域的 vendored 插件（仅对挂载 novel-solo 预设的会话生效）：

template/plugins/llm-tool-choice-pin/index.mjs（出口名 dsh-novel-solo/plugins）— 把 llama provider 的 toolChoice 钉为 auto，让 edit 等保留工具可被调用（小模型下避免每次请求都做工具决策）。

文件结构

lib/index.js        node 半区：宿主版本探测、数量镜像、设置接缝（0.1.7 volatile Config 表单 / 0.1.6 命名空间）、旧宿主预设铺设
lib/client.js       浏览器半区：「子 agent 数量」卡片，分别挂到 plugins.item（0.1.7）与 settings.plugin.item（0.1.6）
cordis.patch.yml    安装进 web profile 的层：插件行 + 声明式 novel-solo 预设行（0.1.7 以下禁用该行）
cordis.yml          开发用 overlay：只插插件行、不带预设
template/           novel-solo 预设（agent.cordis.yml + persona.md + preset.yml + vendored 插件），随包分发
scripts/sync-preset-patch.mjs  把 template/agent.cordis.yml 同步进 patch 的生成区，`--check` 校验一致性
package.json        dsh.bundle / dsh.client 元数据，使插件可被插件市场/清单识别

npm run check 会语法检查两半区，并重跑上面的 patch/模板一致性校验。

环境变量

变量	作用	默认
`DSH_HOME`	dsh 根目录	`~/.dsh`
`DSH_NOVEL_SKIP_DEPLOY`	`1` 时跳过预设铺设（只影响旧宿主路径）	无
`DSH_NOVEL_REDEPLOY`	`1` 时强制覆盖已存在的预设（慎用）	无

特殊说明

本插件在以下环境使用本地模型完成完整测试：

运行框架：llama.cpp（llama-b10615-bin-win-cuda-13.3-x64）
测试模型：Qwen3.6-35B-A3B-Uncensored-HauhauCS-Aggressive-IQ4_XS.gguf
上下文：ctx=65536，reasoning on
设备：笔记本 RTX 4060 8G + 32G 内存 + AMD 7840H CPU
实测成绩（约 1 万字文本小说）：22 token/s，缓存命中 98%；输入 78.8k / 输出 36.9k / 缓存 2.3M；22 轮 63 步，总耗时 1 小时 03 分 42 秒

关键启动参数（llama-server）：

llama-server.exe -m <model.gguf> --no-mmproj --load-mode none --n-cpu-moe 30 -c 65536 -ngl 999 -t 12 -b 1024 -ub 512 -ctk q8_0 -ctv q8_0 -fa on --fit off --no-warmup --poll 0 --temp 0.85 --top-k 20 --top-p 0.95 --min-p 0.05 --repeat-penalty 1.35 --presence-penalty 0.2 --frequency-penalty 0.2 --dry-multiplier 0.8 --dry-base 1.75 --jinja --reasoning on --reasoning-effort medium --reasoning-budget 2048 --reasoning-format deepseek --reasoning-preserve --cont-batching -np 1 --alias "qwen3.6-novel-nsfw-reason" --port 8090 --host 127.0.0.1 --ui --keep -1 --cache-ram 4096 --ctx-checkpoints 64

参考来源

本插件的设计参考自 sailoumili/novel-writer。

许可证

MIT License

特此免费授予任何获得本软件及相关文档文件（以下简称「软件」）副本的人，无限制地处理本软件，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售本软件的副本，并允许向其提供本软件的人这样做，前提是满足以下条件：

本软件按「原样」提供，不提供任何明示或暗示的担保，包括但不限于适销性、特定用途适用性和非侵权性的担保。在任何情况下，作者或版权持有人均不对因本软件或本软件的使用或其他交易而产生、或与之相关的任何索赔、损害或其他责任负责，无论是基于合同、侵权或其他方式。

dsh-novel-solo

安装

源码

标签

说明文档

dsh-novel-solo

特性

安装

宿主版本兼容性

子 agent 数量如何影响行为

预设内容速览

工具瘦身

文件结构

环境变量

特殊说明

参考来源

许可证