dsh-novel-solo
A single-author novel-writing plugin for DeepSeek Harness: a subagent concurrency setting plus a complete novel-creation preset (persona). It is tuned for quantized small models — the tool catalog is slimmed and output behavior hardened — so you can run a full-length novel pipeline locally.
Features
- GUI setting: a "Subagent count (1-12)" card under Settings → Plugins, with built-in zh/en i18n.
- Full creation preset: ships the
novel-solo preset with a self-driven persona that follows a fixed pipeline — 叙事方法 (narrative method) → 核心世界观 (core worldview) → 名词索引 (noun index) → 大纲 (outline) → 章节目录 (chapter list) → 人物档案 (character files) → chapter-by-chapter writing → per-chapter review → final whole-book review & assembly.
- Quantized-safe protocol: plain CJK + common punctuation only, no JSON, no escapes, avoids fragile tokens; minimal tool calls, one at a time.
- Review loop: every chapter is reviewed (green/yellow/red) across 7 dimensions (setting / character / catalog / narrative / text rules / AI-cliché / plot logic); each report is written to a markdown file; when all chapters pass, a whole-book review runs and the book is assembled.
- No AI clichés: judges AI-flavor across six dimensions (sentence templates / stock vocabulary / emotion telling / structural sameness / diluted information / character distortion), distinguishing narrator-level repetition from character-level consistency; shared by writing and review.
- Slimmed catalog: hard-disables whole tool rows (shell / jobs / skills / goals / web) inside the preset to shrink the tool schema.
- Versioned writing: each chapter is
第N章-章节名字-vX.md; full-chapter rewrites first copy to v(X+1) and never overwrite older drafts.
Install
dsh plugin --profile web add "dsh-novel-solo"
dsh web
Then open Settings → Plugins; the dsh-novel-solo "Subagent count" card appears.
On first launch the plugin idempotently deploys the preset from template/ to <dshHome>/.agent-presets/novel-solo/ (skips if the target already exists — it never overwrites your edited preset).
Host compatibility
Since 0.1.5, the preset persona uses the @deepseek-ai/dsh-persona config key prefix (the text key used by 0.1.2-rc.1 was removed). This template therefore targets DSH 0.1.5-rc.2 and later.
Each host home keeps its own .agent-presets/novel-solo/agent.cordis.yml. Homes provisioned by older hosts (e.g. 0.1.2-rc.1) keep their text: copy and still work when you switch back; a fresh home provisions the prefix: template. To hand-upgrade an older home, rename the persona row's text: to prefix: (the complete / includeRuntimeContext keys are unchanged).
How the subagent count takes effect
DSH's agent/request waterfall only lets a plugin rewrite LLM routing/config — it cannot inject or rewrite system/messages — so "GUI → model prompt" dynamic injection cannot go through the request waterfall. This plugin uses a two-stage wiring instead:
- On save,
N is written to ~/.dsh/.dsh-novel-solo-data/agent-count.json (the single source of truth).
- The persona's sync anchor
并发上限 N=<number> is rewritten in place (by default in the deployed preset ~/.dsh/.agent-presets/novel-solo/agent.cordis.yml). The persona then decides: N=1 the main agent does everything itself; N>1 writing/review tasks are delegated to subagents while the main agent only dispatches and silently waits.
Note: the persona is loaded each time a preset session starts. A GUI change edits files, so running sessions pick up the new N only after a restart / new session.
Preset at a glance
template/agent.cordis.yml (deployed to ~/.dsh/.agent-presets/novel-solo/agent.cordis.yml) includes:
| Section | Content |
|---|
| Division of labor | concurrency anchor N=1 (default), with N=1 / N>1 execution paths |
| Quantized-safe rules | top-priority constraints on output and tool calls |
| Six-doc standard structures | per-field templates for 叙事方法 / 核心世界观 / 名词索引 / 大纲 / 章节目录 / 人物档案 |
| Writing & review rules | chapter rules, AI-cliché lists, A–G review dimensions + green/yellow/red, md review reports, whole-book review & assembly |
| Tool usage standards | per-tool rules for read/write/edit/glob/grep/subagent, etc. |
| Project & discipline | project dir {{cwd}}/项目名/, one thing at a time, etc. |
Tool slimming
The preset hard-disables these rows via 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. It keeps tool-fs (read/write/edit), tool-fs-search (glob/grep), str-replace-editor (view/create/str_replace/insert), tool-pwsh (filesystem management only: rename/delete files & folders), subagent/subagent_fork, list_agents, etc.
It also ships a preset-scoped vendored plugin (active only for sessions mounting the novel-solo preset):
template/plugins/llm-tool-choice-pin/index.mjs — pins toolChoice to auto for the llama provider so retained tools like edit stay callable (avoids per-request tool decisions under small models).
File structure
lib/index.js node half: registers the dsh-novel-solo settings namespace (settings service), file store + persona-anchor sync + preset deploy
lib/client.js browser half: registers the settings.plugin.item card (key=dsh-novel-solo), renders the 1-12 selector
cordis.patch.yml inserted into the web profile on install
template/ the novel-solo preset (agent.cordis.yml + preset.yml + vendored plugin), shipped with the package
package.json dsh.client metadata so the plugin is recognizable by the plugin market/manifest
Environment variables
| Variable | Purpose | Default |
|---|
DSH_HOME | dsh home directory | ~/.dsh |
DSH_NOVEL_PERSONA_YAML | target YAML for the concurrency-anchor rewrite (can point to any preset) | <dshHome>/.agent-presets/novel-solo/agent.cordis.yml |
DSH_NOVEL_PERSONA_MD | extra persona md file to also sync (optional) | none |
DSH_NOVEL_SKIP_DEPLOY | 1 skips preset deployment | none |
DSH_NOVEL_REDEPLOY | 1 forcibly overwrites an existing preset (use with care) | none |
Test environment
This plugin was tested end-to-end with a local model:
- Runtime: llama.cpp (
llama-b10615-bin-win-cuda-13.3-x64)
- Model:
Qwen3.6-35B-A3B-Uncensored-HauhauCS-Aggressive-IQ4_XS.gguf
- Context:
ctx=65536, reasoning on
- Hardware: laptop RTX 4060 8GB + 32GB RAM + AMD 7840H CPU
- Measured on a ~10k-char novel: 22 token/s, 98% cache hit; 78.8k input / 36.9k output / 2.3M cache; 22 turns / 63 steps, 1h03m42s total
Key server flags (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
References
This plugin's design is inspired by sailoumili/novel-writer.
License
MIT License
Copyright (c) 2026 Tkingxiao
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
