Preface¶
When writing a novel in DSH using dialogue, a common problem is the model “verbally jumping stages”—starting the main text before establishing character settings, or modifying settings while writing, making it difficult to align character progression, foreshadowing, and timelines after a million words. Relying solely on prompt constraints for stage progression lacks verifiable artifacts and rollback mechanisms, and long-form consistency can easily collapse.
Big Fatty’s Novel Workshop (dsh-novel-writer) breaks down web novel creation into a nine-stage gated process, using agent tools to enforce progression, integrating world book setting injection, fact ledgers, and one-click chapter writing/polishing, grounding topic selection to completion in auditable local project data. Below, we introduce what it is, what it can do, and how to install and get started.
What This Is¶
Big Fatty’s Novel Workshop is a web novel creation plugin for DeepSeek Harness (DSH), maintained by akira399, categorized as a “Workflow” in the SkillHub directory, with the GitHub repository akira399/dsh-novel-writer currently having about 13 stars.
Plugin positioning: a nine-stage gated creation process, overlaid with world book (lorebook) setting injection, local book import, AI one-click polishing, de-AI-ification, golden three chapters diagnostics, million-word consistency assurance, and market research and template replication. Package name @dsh-external/dsh-novel-writer, with the current latest release version being v0.1.7.
Core Features¶
Nine-Stage Gated Creation Process¶
The stage chain is: Topic → Setting → Character Design → Outline → Volume → Detailed Outline → Main Text → Revision → Completion.
Previous stage must be approved before entering the next; users can explicitly approve or revert. Each stage’s artifact is written to docs/<stage>.md, with historical versions saved in versions/<phase>/v<n>, allowing reversion to any version. Each commit, approval, and rollback is recorded in audit.jsonl.
Advancing stages and submitting artifacts requires using agent tools like novel_phase, novel_commit, etc., to prevent the model from merely verbally claiming “stage completed.”
World Book (Lorebook) Setting Injection¶
- Keyword or regex triggers, supporting persistent injection; entries are bound by book, with each book having independent columns.
- Import supports three formats: Operit, SillyTavern, and Character Cards.
- The world book panel can “Export to Tavern,” downloading native SillyTavern lorebook JSON; or use
lorebook_export_entries format=sillytavernin dialogue. - AI can generate 4–6 core settings by book name and genre with one click and bind them to the book.
- Token budget trimming during injection to avoid exceeding long context limits.
Quality Assurance¶
- De-AI-ification: Built-in 234-word, 5-category lexicon, with density scoring and one-click rewriting (
novel_depolish). - Golden Three Chapters Diagnostics: Rule-based offline scoring (hook, opening, conflict, exposition, word count, dialogue), with optional model-layer deep diagnostics.
- Four-Family Validation: Structure, content, plot, consistency; automatically checked on submission, or triggered via dialogue with
novel_validate.
Million-Word Consistency¶
- Fact Ledger:
<JSONPatch>within chapters automatically records character progression, item, location states; supports conflict detection and auditing. - Timeline: Normalization and inversion detection within book time; foreshadowing registration and recovery tracking; world book automatic sedimentation suggestions.
- Three-Layer Context Memory (L1 full book settings + L2 volume/chapter detailed outlines/pre-text + L3 summary/variables/world book), with constant budget; README states stress testing at 1 million words without exceeding limits.
One-Click Chapter Writing and Polishing¶
- One-Click Chapter Writing: Generates main text based on context packs and automatically saves to disk, linked to chapter statistics, ledger, and audit; emphasizes following the current chapter’s detailed outline, full book settings, and previous text facts.
- One-Click Polishing: Restructural polishing—full sentence rewriting, expansion, adding details after paragraphs; changes split into per-paragraph suggestions, each individually accept or reject; original text view updates in real-time with acceptance, with intra-paragraph word-level diff highlighting; supports step-by-step undo.
Local Import and Supporting Capabilities¶
- Import local
.txt/.md, automatically detect chapters and create a book (md supports frontmatter genre/title). - 27 genre tags (Xuanhuan, Xianxia, Wuxia, Western Fantasy, Urban, etc.).
- Revision (proofreading/rhythm/style), export (txt/markdown/platform formatting).
- Market research (
web_searchguidance, saved toreports/market.md), template replication, inspiration library, foreshadowing, glossary, ledger queries.
GUI Workbench and Agent Collaboration¶
- Sidebar “Big Fatty’s Novel Workshop” drawer: project list, create, details, one-click chapter writing, polishing, diagnostics, import, world book management.
- Built-in 41
novel_*/lorebook_*agent tools, 60 prompt templates; skillnovel-writing-workflowautomatically registers with plugin activation. - Agent preset “Big Fatty’s Novel Workshop”: select in mode selector when creating a new session, anchoring the nine-stage gated creation persona; presets, skills, and tools collaborate through three channels, with dialogue-driven and GUI sharing the same project data.
Installation and Activation¶
Requires installed DSH (cross Windows/macOS/Linux; runtime Node ≥18). README emphasizes installing the latest version: older versions v0.1.0 and v0.1.1 may report requires options.key and fail to load in some hosts. Current latest is v0.1.7.
Download dsh-external-dsh-novel-writer-*.tgz (highest version number; do not use v0.1.0/v0.1.1) from releases/latest, then execute:
dsh plugin --profile web add <absolute path to the tgz>
dsh plugin list
Confirm dsh-novel-writer appears in the list and is enabled, then refresh the DSH page (Ctrl+Shift+R).
After installation, you should see:
- Sidebar entry for “Big Fatty’s Novel Workshop.”
- Settings → Plugin Configuration shows the same-name card (enable switch + data directory, default
~/.dsh/dsh-novel-writer). - New sessions automatically include skill
novel-writing-workflow. - New session mode selector offers preset “Big Fatty’s Novel Workshop.”
If the entry doesn’t appear: refresh the page first, restart DSH, and confirm the enable switch is on in the plugin list.
Advanced users can build from source (requires Node ≥22 and 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
Typical Usage¶
Data directory defaults to ~/.dsh/dsh-novel-writer/:
lorebook/ World books (entries/groups/settings)
projects/ Projects (book.json, docs/, chapters/, audit.jsonl, ledger.json, etc.)
Three-Minute Quick Start¶
- Open sidebar “Big Fatty’s Novel Workshop” → Click “One-Click Import Example ‘Qingyun Dao问道’” or input book title to create.
- Enter project details → “One-Click Chapter Writing” → Generate main text based on context packs and auto-save; if unsatisfied, use “One-Click Polishing.”
- Or in dialogue directly say: “Create a project, write a Xuanhuan novel,” “Help me write the next chapter,” “De-AI this paragraph,” “Diagnose the opening,” “Clone ‘Qingyun Dao问道’ as template,” “Research Xianxia market trends,” “Import local txt.”
Complete the Nine Stages¶
After creation, current stage is topic (Topic Selection). In dialogue say “Generate world settings,” “Design character profiles,” “Write full book outline,” the model uses templates to produce that stage’s document; after completion say “Submit setting” to use novel_commit, upon validation approval unlocks the next stage. Artifacts stored in docs/<stage>.md, history in versions/<stage>/v<N>.
Chapter Writing, Polishing, and World Books¶
- Project details select chapter number → “One-Click Chapter Writing and Save”; or dialogue “Help me write the next chapter.”
- After “One-Click Polishing,” accept suggestions per paragraph, confirm save or abandon and restore; edit area “Undo” can step-by-step revert history.
- Project details “This Book’s World Book” or list row “World Book” button: AI one-click generate settings, manually create new entries, import existing settings, export to tavern.
Import and Export¶
- Project list “Import Local Books” select
.txt/.md, auto-split chapters and create book, can continue writing and polishing. - After writing, can export txt, Markdown, or platform-formatted files for submission.
Applicable Scenarios and Notes¶
Who It’s For
- Authors writing web novels from scratch in DSH, continuing local txt/md, or needing gated processes and setting ledgers to ensure long-form consistency.
- Users accustomed to dialogue-driven creation (select agent preset + skill guidance) or preferring GUI button-click chapter writing/polishing (both share data).
Notes
- Plugins run with the current DSH process permissions, with project and world book data stored locally in
~/.dsh/dsh-novel-writer; before installation, recommend reading repository source code and license files to assess if usage requirements are met. - SkillHub (directory page) is a community plugin directory, not officially affiliated with DeepSeek / Hong Fang; installation packages are based on GitHub releases.
- DSH ecosystem philosophy is “everything is a plugin”; this plugin depends on peer dependencies provided by DSH host like cordis, dsh-tools, dsh-skill, requiring DSH and plugin versions to match.
Conclusion¶
Big Fatty’s Novel Workshop constrains web novel creation from “casual chat” to nine-stage gating, world books, ledgers, and rollbackable artifacts, providing one-click chapter writing, paragraph-level polishing, and golden three chapters diagnostics as practical tools. If you’re already using DSH for long-form writing, you can start by installing v0.1.7, importing the example “Qingyun Dao问道,” or creating a new book to verify the process.
- Directory page: https://www.skillhub.cn/plugins/akira399/dsh-novel-writer
- GitHub: https://github.com/akira399/dsh-novel-writer