dsh-novel-writer

A web-novel creation plugin for DeepSeek Harness (DSH): nine-phase gated creation workflow + lorebook injection + AI-taste removal + golden-three-chapters diagnosis + million-word consistency + one-click chapter writing.

• 中文 | English

Features

Install

Needs DSH installed (Windows/macOS/Linux; runtime Node ≥18). This release targets DSH Desktop / CLI 0.2.0-rc.2 or newer (@deepseek-ai/cordis 4.0.4). The v0.1.x line targets 0.1.0-rc.6 and fails to load on 0.2.0 — see the version table below.

A — Let an AI install it (recommended)

Paste this to any command-capable AI:

Install the DSH plugin "大肥鱼的小说工坊" (dsh-novel-writer), latest 0.2.x only. From https://github.com/akira399/dsh-novel-writer/releases/latest download the newest dsh-external-dsh-novel-writer-*.tgz (highest version; not v0.1.x, which targets the old DSH) → run dsh plugin --profile web add <absolute tgz path> → confirm with dsh plugin list → tell me to refresh the DSH page (Ctrl+Shift+R). Report any error first.

B — Manual install

Download the newest dsh-external-dsh-novel-writer-*.tgz from https://github.com/akira399/dsh-novel-writer/releases/latest, then:

dsh plugin --profile web add <path-to-tgz>
dsh plugin list        # dsh-novel-writer listed = success

C — Build from source (advanced)

Needs 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.2.0.tgz

(Use Git Bash on Windows for the shell build script.)

After install: the sidebar-footer "大肥鱼的小说工坊" entry and the Settings → Plugins tab appear; if not, refresh/restart DSH and check the plugin is enabled.

Version compatibility

0.2.0 adaptation: DSH removed the @deepseek-ai/dsh-client-runtime package, the settingsNamespace() / settings.register() API, and the settings.plugin.item slot. This version uses ctx.configForms plus the settings.plugins.tab and sidebar.footer.action slots.

Quick start

1. Open the drawer → "Import demo 《青云问道》" (or create your own project)
2. Open project detail → "Write chapter" → the session writes from the context packet → review & save
3. Or just chat: "create a fantasy novel project", "write the next chapter", "remove AI taste", "diagnose the opening"

Data lives in ~/.dsh/dsh-novel-writer/ by default.

Feature usage guide

Every capability is reachable two ways — the GUI drawer and plain chat. Example triggers:

• Create a book: drawer "create" + pick a genre (27) · chat: "create a xianxia novel project"
• Walk the 9 phases: chat "generate the worldbuilding", "design the characters", "submit the outline" → novel_phase / novel_commit
• Write a chapter: drawer "一键写章并保存" · chat: "write the next chapter"
• Polish + diff: drawer "一键润色" → review marked changes → 确认保存 / 放弃还原; undo with the "↶ 撤销" button
• Worldbook (lorebook): drawer "本书世界书" → "AI 一键生成设定" or "+ 新建条目"; import Operit/SillyTavern/character-card
• Import a local book: drawer "导入本地书籍" (txt/md) → auto-chapters & builds a book
• Quality checks: drawer "结构诊断"; chat "把这章去 AI 味", "校验这章" → novel_validate
• Consistency: chat "跑一遍一致性巡检" → novel_consistency_audit; "林远现在什么境界" → novel_ledger; foreshadow/timeline via chat
• Revise & export: chat "修订第 3 章查错别字" → novel_revise; drawer "导出 txt" or chat "导出成稿"
• Market research & clone: chat "调研下仙侠市场" → novel_market_research; "以《青云问道》做模板开新书" → novel_clone_project
• Start a session: new session → preset picker → "大肥鱼的小说工坊" → just chat your intent

Tip: you don't need to memorize commands — the creation-mode agent picks the right novel_*/lorebook_* tool for you and asks for confirmation on writes. Ask "what can the workshop do?" anytime.

Interaction with DSH

• 41 agent tools: novel_* + lorebook_* + novel_prompts
• Two-phase chapter protocol: novel_write_chapter (context packet) → model writes → novel_commit_chapter (stats/ledger/audit)
• Skill: novel-writing-workflow
• GUI API: /api/novel-writer/* (fence-header protected)

Security

Local-only storage; audit-logged writes; LLM helper calls reuse the session's model route; GUI routes require a custom fence header; disabled plugin returns 503.

Known limitations

• Model-layer features degrade to detection/rule layers when no model route is available
• One-click chapter text backfill is best-effort (manual paste supported)
• Scheduled serialization (browser cron) not yet implemented
• Sediment suggestions require confirmation before writing to the lorebook

Development

npm run typecheck   # host + client
npm test            # vitest (331 specs)
npm run build       # tsc host + tsdown client (pure Node; no bash needed on Windows)
npm run build:host:bash   # only when a host hard-codes `bash scripts/build.sh`
node scripts/simulate-1m.mjs   # million-word consistency stress test

Target DSH version: 0.2.0-rc.2 (@deepseek-ai/cordis 4.0.4). When upgrading DSH, update peerDependencies / devDependencies and dsh.client.inject, then re-run npm run verify.

Module discipline: one module → tests → review per step (see docs/MODULE-LOG.md).

License

MIT