Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

dsh-novel-forge

by huangziyuan-generalversion 1.7.4i★ 50iRuns on your computerRepository ↗
Registry nameio.github.huangziyuan-general/dsh-novel-forge

How to install

What it does

中文长篇写作 MCP Server:24 个工具,用硬门禁治理 AI 写长篇的失忆、设定崩坏与 AI 味

  • Connects Runs on your computer
  • Account or key No key needed · 1 setting to fill in (NOVEL_FORGE_ROOT)
  • Category Other

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity34/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness12/12Full marks for a release or code change within 30 days
Still answering0/8The cloud endpoint answered at the last check
Usage score46/100

Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install dsh-novel-forge. Follow https://mcp.popnx.com/i/huangziyuan-general-dsh-novel-forge.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 19, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude, with some setup first

1 setting(s) to fill in (NOVEL_FORGE_ROOT) · Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone

Let AI install it

Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server dsh-novel-forge for Claude on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "dsh-novel-forge": { "command": "npx", "args": [ "-y", "dsh-novel-forge" ], "env": { "NOVEL_FORGE_ROOT": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For NOVEL_FORGE_ROOT, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the dsh-novel-forge tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Fill in 1 setting(s)

    These are program settings, not keys. No sign-up needed; fill them in as the maker describes.

    • NOVEL_FORGE_ROOT 小说工作区根目录(一本小说 = 工作区里的一个目录);GUI 客户端 cwd 不可控,务必显式设置

    Descriptions are as written by the maker.

  3. Open the Claude desktop app’s settings file

    SettingsDeveloperEdit Config

  4. Paste these settings and save the file

    {
      "mcpServers": {
        "dsh-novel-forge": {
          "command": "npx",
          "args": [
            "-y",
            "dsh-novel-forge"
          ],
          "env": {
            "NOVEL_FORGE_ROOT": "your-value"
          }
        }
      }
    }
  5. Quit Claude and open it again

  6. Try it

    Use dsh-novel-forge and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using dsh-novel-forge or shows a dsh-novel-forge tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

ChatGPT cannot connect dsh-novel-forge yet

dsh-novel-forge runs on your computer, but ChatGPT can only connect servers that run on the web

What you can do instead

A · Use an app that can connect dsh-novel-forge

  • 1 setting(s) to fill in (NOVEL_FORGE_ROOT) · Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
  • 1 setting(s) to fill in (NOVEL_FORGE_ROOT) · Install Node.js on your computer first (one time)
  • 1 setting(s) to fill in (NOVEL_FORGE_ROOT) · Install Node.js on your computer first (one time)
  • 1 setting(s) to fill in (NOVEL_FORGE_ROOT) · Install Node.js on your computer first (one time)

B · Others in Other that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Works with Claude Code, with some setup first

1 setting(s) to fill in (NOVEL_FORGE_ROOT) · Install Node.js on your computer first (one time)

Let AI install it

Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server dsh-novel-forge for Claude Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user dsh-novel-forge --env NOVEL_FORGE_ROOT=your-value -- npx -y dsh-novel-forge 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For NOVEL_FORGE_ROOT, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the dsh-novel-forge tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Fill in 1 setting(s)

    These are program settings, not keys. No sign-up needed; fill them in as the maker describes.

    • NOVEL_FORGE_ROOT 小说工作区根目录(一本小说 = 工作区里的一个目录);GUI 客户端 cwd 不可控,务必显式设置

    Descriptions are as written by the maker.

  3. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  4. Paste this command and press Enter

    claude mcp add --scope user dsh-novel-forge --env NOVEL_FORGE_ROOT=your-value -- npx -y dsh-novel-forge
  5. Type /mcp in Claude Code

    You should see dsh-novel-forge listed as connected

  6. Try it

    Use dsh-novel-forge and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using dsh-novel-forge or shows a dsh-novel-forge tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor, with some setup first

1 setting(s) to fill in (NOVEL_FORGE_ROOT) · Install Node.js on your computer first (one time)

Let AI install it

Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server dsh-novel-forge for Cursor on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "dsh-novel-forge": { "command": "npx", "args": [ "-y", "dsh-novel-forge" ], "env": { "NOVEL_FORGE_ROOT": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For NOVEL_FORGE_ROOT, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the dsh-novel-forge tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Fill in 1 setting(s)

    These are program settings, not keys. No sign-up needed; fill them in as the maker describes.

    • NOVEL_FORGE_ROOT 小说工作区根目录(一本小说 = 工作区里的一个目录);GUI 客户端 cwd 不可控,务必显式设置

    Descriptions are as written by the maker.

  3. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  4. Fill in your key

    In the dsh-novel-forge settings, NOVEL_FORGE_ROOT is empty; add your key and save

  5. Open the AI chat in Cursor in Agent mode

  6. Try it

    Use dsh-novel-forge and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using dsh-novel-forge or shows a dsh-novel-forge tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code, with some setup first

1 setting(s) to fill in (NOVEL_FORGE_ROOT) · Install Node.js on your computer first (one time)

Let AI install it

Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server dsh-novel-forge for VS Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "dsh-novel-forge": { "type": "stdio", "command": "npx", "args": [ "-y", "dsh-novel-forge" ], "env": { "NOVEL_FORGE_ROOT": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For NOVEL_FORGE_ROOT, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the dsh-novel-forge tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Fill in 1 setting(s)

    These are program settings, not keys. No sign-up needed; fill them in as the maker describes.

    • NOVEL_FORGE_ROOT 小说工作区根目录(一本小说 = 工作区里的一个目录);GUI 客户端 cwd 不可控,务必显式设置

    Descriptions are as written by the maker.

  3. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  4. Fill in your key

    In the dsh-novel-forge settings, NOVEL_FORGE_ROOT is empty; add your key and save

  5. Open the AI chat in VS Code in Agent mode

  6. Try it

    Use dsh-novel-forge and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using dsh-novel-forge or shows a dsh-novel-forge tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

JSON settings are under “For developers” below

Stuck? Ask people who use dsh-novel-forge💬 Discussion →
For developers: Terminal commands and JSON settings

Installed on your computer

Claude Code

claude mcp add --scope user dsh-novel-forge --env NOVEL_FORGE_ROOT=your-value -- npx -y dsh-novel-forge

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "dsh-novel-forge": {
      "command": "npx",
      "args": [
        "-y",
        "dsh-novel-forge"
      ],
      "env": {
        "NOVEL_FORGE_ROOT": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "dsh-novel-forge": {
      "command": "npx",
      "args": [
        "-y",
        "dsh-novel-forge"
      ],
      "env": {
        "NOVEL_FORGE_ROOT": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "dsh-novel-forge": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "dsh-novel-forge"
      ],
      "env": {
        "NOVEL_FORGE_ROOT": "your-value"
      }
    }
  }
}

Values you fill in

  • NOVEL_FORGE_ROOT required env
    小说工作区根目录(一本小说 = 工作区里的一个目录);GUI 客户端 cwd 不可控,务必显式设置

Descriptions are as written by the maker.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
2,070/wk
Connection
Runs on your computer
Latest versioni
1.7.4
Categoryi
Other
Published to registryi
Nov 19, 2026
Code last changedi
Nov 18, 2026
Maker
huangziyuan-general
Packages
npm: dsh-novel-forge
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account huangziyuan-general, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed yesterday

  • ✓ Pass

    Has a licence

    Uses MIT

  • – Not applicable

    Endpoint responds

    This one runs on your computer; there is no internet endpoint

  • – Not applicable

    Sign-in with OAuth

    Runs on your computer and uses local settings instead

  • … Not checked yet

    No hidden instructions in tool descriptions

    Runs on your computer; we can only read tool lists from internet endpoints

Published vulnerabilities (OSV.dev)

Not checked yet

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/huangziyuan-general-dsh-novel-forge.svg)](https://mcp.popnx.com/en/servers/huangziyuan-general-dsh-novel-forge)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Otheri

  • More stars than 98% of the other 20749 servers in this category
  • Published to the registry more recently than 99% of the other 20749 servers in this category
  • Basic checks equal to or better than 99% of the other 20749 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is dsh-novel-forge safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed yesterday, and the latest version (1.7.4) reached the registry today.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.

What can I use instead?

In the same category: World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.

by koala73Widely used★ 90.9KUpdated 3 days ago

Runs in the cloud✓ service owner · worldmonitor.app

openstatus

Manage monitors, status pages, incidents and maintenances in your openstatus workspace.

by openstatusHQWidely used★ 9.3KUpdated 2 months ago

Runs in the cloud✓ service owner · openstatus.dev

Oh My Posh Validator

Validate oh-my-posh configurations and segment snippets against the official schema.

by JanDeDobbeleerWidely used★ 23.8K Stars for the whole repoUpdated 30 days ago

Runs in the cloud✓ service owner · ohmyposh.dev

Strata

MCP server for progressive tool usage at any scale (see https://klavis.ai)

by Klavis-AIGrowing★ 5.8KUpdated 14 months ago

Runs in the cloudRepo archived✓ klavis.ai

Jitsu

Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.

by jitsucomWidely used★ 5.1KUpdated 4 months ago

Runs in the cloud✓ service owner · jitsu.com
Compared with similar ones
This one
dsh-novel-forge
World MonitoropenstatusOh My Posh ValidatorStrataJitsu
Runs whereInstalls on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to install
Needs a keyNoNoNoNoNoNo
Add with + in ClaudeNoNoNoNoNoNo
Basic checks3/34/44/44/41/44/4
LicenseMITAGPL-3.0AGPL-3.0MITApache-2.0MIT
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

dsh-novel-forge · 小说锻炉

中文文档 | English

DeepSeek Harness(DSH)的中文长篇写作插件。它不是「提示词合集」,而是把一致性、门禁、审计做进工具层与数据层:模型负责动笔,插件负责把写坏、写歪、写穿的地方拦在落盘之前。

适合谁: 多角色 / 多卷 / 连载几十上百章、会被「设定崩了」「前文失忆」「悬念泄底」「AI 味太重」卡住的长篇作者。

它替你挡住的事(全部代码化,可对着源码核):

  • 同章改值 → 冲突拒绝,不静默覆盖
  • 隐藏人物 → 档案不进上下文,正文出现其名 → 内容门禁拦下
  • 细纲漏写场景 → 拒稿;旧版 → 永不覆盖
  • 长篇检索 → 零依赖本地跑,百章后仍能找回前文

安装方式 | 界面一览 | 功能硬约束表 | 24 个工具

它能干什么(30 秒)

  • 建书:novel_project init 一句话建书,九阶段状态机引导 立意→设定→人物→大纲→分卷→细纲→正文,缺什么列什么。
  • 写章:novel_write_chapter 走多道落盘门禁(机审/账本/内容/细纲契约/熔断),写坏写穿拦在落盘前。
  • 全书体检:novel_audit 零 token 确定性数字——死人复活/账本矛盾/伏笔逾期/章号缺口一次列全。
  • 平台审稿:novel_audit platform 五张平台表(起点/番茄/晋江/七猫/飞卢),敏感自查七类带行号改法。
  • 批量起草:并发生成、串行过门禁、断点续跑,单章失败不回滚整批。
  • 章节听书 / 润色校对:面板旁路引擎,产物是提案,你点「应用」才生效。
  • 长篇检索:novel_search 按记忆碎片把段落找回来,百章后不「看不见前文」。

觉得有用?顺手点个 ⭐ 让更多长篇作者看见:github.com/huangziyuan-general/dsh-novel-forge

为什么不是又一个「提示词合集」

多数写作插件的约束写在系统提示里——模型心情好就守,赶进度就绕。本插件把「有明确对错」的部分做进代码,设计主线只有一条:

代码强制 > 提示词自觉。 凡是「靠模型自觉」的约束都会失效;一致性、门禁、审计必须是工具层/数据层的硬约束。

三条可在仓库里对着源码核的事实:

  1. 三条入口共用一份判定链:面板「💾 保存」、novel_write_chapter、REST 写入走同一套门禁代码(机审/账本冲突/内容门禁/细纲契约)——没有旁路;唯一的放行开关显式记审计。
  2. 模型无法自批提案:修订提案模型只能登记、不能应用——「应用」是面板里用户的主权动作(模型侧没有 apply 工具);细纲批准记录批准通道,看板统计「工具自批占比」(真机实证某连载本曾 168/168 全自批,正是大纲漂移的第一缺口)。
  3. 审计零 token:机审、去 AI 味扫描、平台审稿、一致性校验、账本时点推演全部是纯本地计算——逐章审计成本为 0,数字不经过模型之手。

结果证明(仓库内可核)

不靠形容词,靠三条能对着源码与数据核的事实:

证据含义在哪核
某连载本 151 章,细纲「场景数+拍数」标定全量通过字数/场景估算不是拍脑袋,是真机数据拟合lib/outline-overlap.js 标定说明 + novel_outline 契约段
某连载本曾 168/168 细纲全自批正是「工具自批占比」看板捕捉到的大纲漂移第一缺口——自批率 100% 时插件报警看板「工具自批占比」+ novel_project 审计段
同章连续驳回 3 次即拒写熔断是代码行为(不是提醒),改完细纲/契约自动解除lib/gate.js 熔断逻辑

界面一览

右侧栏「锻炉」面板实机渲染(以下均为虚构示例数据,非真实书目):

| 项目列表 | 详情 · 基本信息(全书体检仪表盘) | | 润色守卫拦下(核心卖点:代码拒绝,理由给全) | 批量起草(并发生成·串行过门禁·断点续跑) | | 章节听书 | 世界书 |

以上是 lib/client.js 的真实渲染(非手绘 mock):npm run preview 生成预览页后跑 assets/mockups/shoot-real.cjs 即可复现,浅色/深色两套随宿主主题。

看完了演示觉得有用?这就是它每天在你写长篇时替你挡下的事。顺手点个 ⭐ 让更多人看见:

github.com/huangziyuan-general/dsh-novel-forge

AI 写作通病与硬约束

AI 长篇写作的通病不是玄学,每一个都有对应的工程解法。先给最痛的 5 条,完整 23 条全表在下面折叠区:

最痛硬约束落点
设定/战力崩坏事实账本:同章改值=冲突拒绝novel_ledger
模型看不见前文写前简报按预算组装上下文包,百章后仍能找回段落novel_briefing / novel_search
悬念提前泄底隐藏人物档案不进上下文,正文出现其名=门禁拦下novel_scene
AI 味太重八维结构性扫描(纯本地,零模型费用)novel_noai_scan
多角色千人一腔语言基因卡结构化注入,审稿核对禁忌词novel_character voice

完整 23 条硬约束全表(含字数/平台审稿/批量起草/会话疲劳等)

AI 写作通病本插件的硬约束落点
口头跳阶段阶段门禁:细纲未批准,novel_write_chapter 直接拒绝novel_outline approve
跨章复读/水文8 字 shingle 与前文重复检测,超阈值拒绝保存novel_write_chapter 机审
章节字数失控机审门槛默认 2000–4000 字(网文连载单章标准,目标 3000);写前简报带「本章字数目标」段novel_write_chapter / novel_briefing
章末无钩子章末钩子启发式(问句/悬念/省略/感叹),缺了给警告novel_audit
偷偷覆盖正文提案制:修订走提案→用户确认→生成新版本,旧版永不覆盖novel_propose
审稿放水机审与模型审分离:审计产出确定性数字,模型审稿必须引用证据novel_audit
写偏/漏写细纲细纲契约段(必写场景 / 禁止偏离项)由代码算覆盖率与偏离度,命中禁项拒绝落盘novel_write_chapter
长篇上下文爆炸契约在场时只注入本章出场人物的卡,世界书按白名单取novel_briefing
设定没定就想写大纲九阶段状态机:每阶段入场条件由代码判定,缺什么直接列出来novel_project phase
第一章就写不够字数细纲按「场景数 + 拍数」估算本章能写多少(真机 151 章标定),撑不到下限就驳回并点名哪个场景只有一拍;写前简报再给逐场景字数预算
面板改稿绕过门禁面板「💾 保存」与写章共用同一套判定(只豁免细纲流程门禁):短稿/占位符/死人复活/泄底一律 409 并摆出原文,需要时给一次显式「仍要保存(记审计)」面板编辑区
同一章反复写不对熔断:同章连续驳回 3 次即拒写(不是提醒),改完细纲/契约自动解除novel_write_chapter
不合平台口味平台审稿五张表:起点看结构/章末钩子/移动端段长,番茄看前 1000 字爽点/打脸/憋屈时长,晋江看字数足额/开篇忌虐,七猫看强情绪快节奏/章末钩子,飞卢看极快节奏/金手指前置/爽点密度novel_audit platform
踩平台红线敏感自查七类,命中给行号与改法novel_audit censor
内部工序占满主对话旁路直调:润色/校对/打标/起草走独立流,不占主对话、不写会话记录;结果只出提案lib/engine.js
批量起草绕过门禁并发生成、串行提交:每章仍过同一道门禁,单章失败不回滚整批draft-batch
批量起草中途断了断点检查点:每章提交后落盘 .novel/batch-checkpoint.json,resume:true 从断点续跑——已落盘章自动跳过、只重试未完成的draft-batch resume
同一会话连写越写越短会话疲劳检测(同口径):本会话首稿逐章变短(后半 < 前半 75%)、或首稿均值低于其它会话首稿 70%、或连写 ≥8 章即警示;「创建新会话并交接」一键建新会话(有归档能力就建+归档一次完成),交接摘要自动进剪贴板面板疲劳横幅

安装方式

小说锻炉支持两种接入方式,先选路线再看对应小节:

  • DSH 用户:作为 DeepSeek Harness 插件安装,获得完整写作面板 → 方式 A
  • Claude Desktop / Cursor / 任意 MCP 客户端:无需 DSH,直接挂载 MCP Server,在对话中调用 novel_* 工具 → 方式 B

如果你只是想在 Cursor 或 Claude Desktop 里让 AI 写长篇时受约束,走方式 B 即可。

方式 A:DSH 插件安装

前提:已安装 DeepSeek Harness(DSH)并跑通模型;Node ≥ 22(22.19+ / 24+ 可启用检索索引,否则自动降级,不影响其他功能)。

第 1 步 · 安装插件(任选其一):

# 从 npm(0.16.0 起已发布;安装量计入 dshmarket「Most installed」榜)

dsh plugin --profile web add npm:dsh-novel-forge

从 GitHub 公开仓库(⚠️ github: 简写经 pnpm 走 SSH——机器要配好 GitHub SSH key

且 ~/.ssh/known_hosts 里有 github.com 主机指纹,否则更新报 Host key verification failed;

没配 SSH 就用上面的 npm 源,公共仓库拉取无需任何凭据)

dsh plugin --profile web add github:huangziyuan-general/dsh-novel-forge

本地开发(符号链接,改码即生效)

dsh plugin --profile web add link:/path/to/dsh-novel-forge

第 2 步 · 重启 DSH web,然后浏览器硬刷新(客户端 bundle 在进程启动时快照,不重启等于没装)。

第 3 步 · 验证安装:右侧栏出现「🔨 锻炉」独立 tab;在会话里让模型「列出小说工具」,应能看到 24 个 novel_* 工具。同时 agent 预设「小说锻炉」已自动部署到 ~/.dsh/.agent-presets/novel-forge/(已存在则跳过,永不覆盖;DSH_NOVEL_FORGE_REDEPLOY=1 强制重铺,DSH_NOVEL_FORGE_SKIP_DEPLOY=1 关闭)。

装完想立刻开写?三步走:

第 4–6 步 · 建书 → 九阶段 → 面板收结果

第 4 步 · 建第一本书:在会话里直接对模型说,例如:

用 novel_project init 建一本玄幻书《示例书名》,一句话立意是「废柴觉醒了不该属于他的力量」。

第 5 步 · 跟着九阶段走:模型会按 立意→设定→人物→大纲→分卷→细纲→正文 的顺序引导,每个阶段缺什么、插件会直接列出来。写章前必须先 novel_outline approve 批准该章细纲——这是设计,不是故障。

第 6 步 · 到面板收结果:右侧栏「锻炉」tab 里阅读/听书、点润色/校对(产物是提案,你在面板点「应用」才生效)、跑全书体检、导出整本。

宿主版本要求与依赖面清单见 COMPATIBILITY.md。

方式 B:MCP 客户端安装

无需安装 DSH(Node ≥ 20)。把下面配置放进客户端的 MCP 设置,即可在对话中调用全部 novel_* 工具:

{

"mcpServers": { "novel-forge": { "command": "npx", "args": ["-y", "dsh-novel-forge@latest"], "env": { "NOVEL_FORGE_ROOT": "/你的小说工作区" } } } }

  • Claude Desktop:写入 ~/Library/Application Support/Claude/claude_desktop_config.json(Windows:%APPDATA%\Claude\claude_desktop_config.json)后重启。
  • Cursor:写入 ~/.cursor/mcp.json 后重启。
  • Claude Code:一行接入——claude mcp add novel-forge -e NOVEL_FORGE_ROOT=/你的小说工作区 -- npx -y dsh-novel-forge@latest(加 -s user 所有项目可用;命令里必须带 @latest——npm 11 对裸包名的直跑解析有缺陷,会报 command not found / 连接关闭)。

NOVEL_FORGE_ROOT = 小说工作区根目录(一本小说 = 工作区里的一个目录),GUI 客户端的 cwd 不可控,务必显式设置。Codex / 任意 stdio 客户端的接入、全局安装与源码路径变体、环境变量说明与常见问题见 [docs/INSTALL-MCP.md](docs/INSTALL-MCP.md)。

会话与面板的分工

  • **会话里(模型 + novel_* 工具)**:一切创作动作——建书、大纲、细纲、写章、账本、审计。写章必须走会话(简报 + 多道落盘门禁是多轮闭环)。
  • 面板(右侧栏「锻炉」):阅读与听书、润色/校对(旁路引擎,产物为提案)、全书体检、黄金三章诊断、批量起草(含断点续跑)、提案审批(应用/丢弃)、书卡管理(改名/删除/克隆)、会话疲劳监测与一键交接。

典型会话流:

novel_project init → novel_project phase(看九阶段看板,按提示补齐入场条件)

→ novel_outline save_book → novel_character save(建语言基因卡) → novel_worldbook add(固化核心设定)→ novel_project phase stage:outline/volume(分卷) → 循环: novel_outline save_chapter + approve → novel_briefing(拿上下文包;有场景契约就按契约裁剪) → 按细纲成稿 → novel_write_chapter(门禁/机审/账本/内容门禁/契约指标/熔断/落盘) → novel_noai_scan + novel_audit(证据)→ 你自己(或让模型引用证据)审稿 → 发书前:novel_audit platform:qidian|fanqie|jjwxc|qimao|feilu + novel_audit censor:true → 修订:novel_propose propose → 用户在面板确认 → 生成 v2(旧版永不覆盖)

面板功能一览

功能入口说明
项目列表「🔨 锻炉」tab按会话过滤(项目跟会话走);改名/删除/克隆;>8 本出筛选框
认领旧书列表底部0.5.0 之前建的无归属书,一键认领到当前会话
🎛 创作驾驶舱详情页顶部打开书自动聚合进度、体检、大纲、提案、诊断与本书字数口径;“前 3 + 最近 12”章抽样做平台审稿汇总,先看硬伤和下一步动作,再决定继续写或改稿
📋 基本信息详情页档案/大纲/角色卡/时间线总览;读章(📖 阅读卡)、保存、导出、黄金三章诊断
🎧 章节听书详情页目录 + 语音连播(暂停/继续/停止、读完自动接下一章);每行 📖 阅读 / ▶ 朗读,看听独立
一键润色 / 机械校对章节「☑ 审稿项」可勾选本次处理项并填写作者指导,未选意见不进提示词;走旁路引擎,产物是提案,不直接改正文;校对守卫更严(篇幅上限 1.06)
持久批注审稿项引文、段落哈希与邻近上下文共同锚定;正文改版后精确或唯一邻近重定位,不可靠时标失效,不静默猜位置;解决/重开均保留记录
档案抽取提案详情页提案区novel_extract 从旧稿提出人物/世界书候选,每项带已核验原文证据;面板逐项编辑、勾选后应用,未选项保留,人工改档冲突不覆盖
全书体检详情页死人复活/账本矛盾/伏笔超期/叙事契约违约/章号断档/人物卡缺失,零 token
黄金三章诊断基本信息卡钩子/开场/冲突/灌输四维数字 + 总评,纯词表零 token
批量起草详情页并发生成、串行提交;逐章成败、失败阶段/原因、路由、调用次数、耗时与 tokens 写入断点,重开面板仍可查;并发上限 4、默认 1;中断后从断点续跑;上下文超限只降可选材料并重建一次
失败正文恢复批量起草卡生成失败或门禁驳回的可用正文留作恢复候选;取回只进编辑器,不直接落章,也不覆盖未保存草稿,仍须显式保存并过门禁;候选按保留策略自动清理(最近 20 个 / 30 天)
前章影响章节按写章时记录的来源指纹列出直接、传递及不可判定的后章;只提示复核,不自动重写或定稿
会话疲劳与交接详情页横幅会话内首稿趋势退化 / 首稿均值低于其它会话 70% / 连写 ≥8 章即警示(写章进度卡带会话状态行,文案标清「首稿=门禁驳回前的初稿」);「创建新会话并交接」一键建新会话+归档旧会话,交接摘要自动进剪贴板,粘到新会话即可无缝续写
提案审批详情页查看提案全文 → 应用 / 丢弃;也可按原稿、提案、当前稿逐段三路合并,冲突默认保留当前稿,版本或哈希变化即拒绝;旧版永不覆盖

24 个工具

工具职责硬约束
novel_projectinit / status / phase(九阶段看板与入场判定) / set_stage / repair / check / promise / promise_template / promise_review / preference / platform / chars题材模板与偏好存储零 token;promise_review 复用 annotate,默认复核最近三章、引文逐字核验,只给建议不进门禁;偏好必须经用户明确确认,不能削弱硬约束
novel_outline全书大纲 / 第N章细纲 / 批准写章门禁的钥匙
novel_character人物卡 + 语言基因卡(voice:句长/逻辑/口头禅/绝不说/小动作/语域,结构化存储)写章单独注入成区块;audit voice:true 核对禁忌词
novel_worldbook世界书条目(add/update/list/remove + import/export)设定只认这里;update 保 id;缺触发词不再报错——先抽本书已知实体名,抽不到转常驻并给可见警告
novel_scene场景契约(save/get/list/delete):本章场景/出场人物/隐藏人物/世界书白名单/禁项隐藏人物档案不进上下文且正文不许出现其名;契约外人物不注入(省 token)
novel_briefing写前上下文包(细纲→承诺书→场景契约→人物卡→语言基因卡→账本→叙事契约→伏笔→世界书→上章结尾→锚段→写作样稿(表达校准))一致性供给侧;按契约裁剪 cast 与世界书
novel_write_chapter写章落盘门禁→机审→账本→内容门禁(六维)→细纲契约指标→版本化;与同章细纲长段逐字重合只告警并记 minor 债,场景摘要和显式原话段豁免
novel_ledger事实账本(含 note)+ 时点推演(status_at 第 n 章快照 / timeline 演化线)+ 伏笔埋/收/改期 + 回收证据校验 + 认知账本 + 叙事契约(pledge/deadline/secret)+ 写作样稿库(sample_* 六动作)同章改值拒绝;章号超前拒绝;超期伏笔告警;回收章必须已写且正文命中关键词(force 记审计);契约到期未兑现写章时点名,broken 且仍有到期伏笔未还 → 拒绝落盘;补录不改历史;认知倒退显形
novel_relation关系账本:人物/组织之间的关系状态线(盟友/仇敌/师徒/信任度…):update 登记推进 / query 当前值 / status_at 时点推演 / timeline 演化线(A,B) 与 (B,A) 自动归一同一对;同章同对同维度改值=冲突拒绝;正文仍按旧值写 → 内容门禁每章 warning
novel_arc弧线账本:单人物维度随章推进(成长/无畏/信任度/嫌疑度…):update 登记推进 / query 当前读数 / status_at 时点 / diagnose 全书停走诊断stalled(≥15 章未推进)命中时写章链自动落 major 质量债;no-move(全书≥20章只推进过一次)warning;零 token 纯函数
novel_quality书级质量债:view 看欠了多少账 / 最重是哪章 / 现在该不该继续写;settle 结清某章的债三级口径(minor 质量债 / major 需重规划 / hard 硬门禁放行);局部瑕疵不阻塞全书,硬门禁放行必须回头核对
novel_noai_scan八维去 AI 味扫描纯本地零费用
novel_audit确定性章节审计 + 契约指标 + continuity 全书一致性 + voice 语言基因核对 + platform 起点/番茄/晋江/七猫/飞卢五平台审稿 + censor 敏感自查七类机审证据;平台体检表给出可执行改法
novel_style文笔六维基线(μ±σ 带)+ 氛围光谱 12 轴:build 建基线 / check 对照(含主导氛围漂移)纯本地零费用;只报数不贴标签
novel_propose提案 / 列表修订走提案,用户在面板应用;旧版永不覆盖

| novel_import | 本地书籍导入(preview/import/backfill 门禁回补;file 支持 .md/.txt/.docx——docx 按 Word 标题样式与「第N章」规则切分) | 纯函数切分章节;建书+版本化落盘;docx 走 readBytes 字节通道(文本通道会解坏二进制),拒 zip6

Only the beginning is shown; read the rest in the repo