World Monitor
Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.
中文长篇写作 MCP Server:24 个工具,用硬门禁治理 AI 写长篇的失忆、设定崩坏与 AI 味
一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり
| 人気 | 34/80 | GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます |
|---|---|---|
| 新しさ | 12/12 | 30 日以内のリリースかコード更新で満点 |
| 応答中 | 0/8 | 前回の確認でクラウドのエンドポイントが応答 |
| 利用スコア | 46/100 |
品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)
使っているAIアプリを選んで、設定をコピーしてください。
ひとことで AI にインストールしてもらう
dsh-novel-forge をインストールして。https://mcp.popnx.com/i/huangziyuan-general-dsh-novel-forge.md に従い、コマンドを見せて、私が OK するまで実行しないで。パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る
チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月17日
まず:どの AI を使っていますか?
使っているアプリを選ぶと、下に手順が表示されます。
Claude につなげますが、先に準備が必要です
設定を 1 項目入力 (NOVEL_FORGE_ROOT) · 先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Claude に MCP server dsh-novel-forge を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "dsh-novel-forge": { "command": "npx", "args": [ "-y", "dsh-novel-forge" ], "env": { "NOVEL_FORGE_ROOT": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) NOVEL_FORGE_ROOT は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、dsh-novel-forge のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -vMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v
一度入れれば、Node.js を使うすべてのツールで使えます
これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。
NOVEL_FORGE_ROOT 小説ワークスペースのルートディレクトリ(1 冊の小説 = ワークスペース内の 1 ディレクトリ)。GUI クライアントの cwd は制御できないため、必ず明示的に設定してください 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
SettingsDeveloperEdit Config
{
"mcpServers": {
"dsh-novel-forge": {
"command": "npx",
"args": [
"-y",
"dsh-novel-forge"
],
"env": {
"NOVEL_FORGE_ROOT": "your-value"
}
}
}
}dsh-novel-forge を使って、私に何ができるか教えて、1 つやってみせて✓ Claude が dsh-novel-forge を使っていると言うか、回答に dsh-novel-forge のツール名が出れば接続成功です
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
ChatGPT はまだ dsh-novel-forge につなげません
dsh-novel-forge はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません
A · dsh-novel-forge につなげるアプリを使う
B · その他 の中で ChatGPT につなげる別のサーバー
同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました
Claude Code につなげますが、先に準備が必要です
設定を 1 項目入力 (NOVEL_FORGE_ROOT) · 先にパソコンへ Node.js を入れてください(1 回だけ)
このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Claude Code に MCP server dsh-novel-forge を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user dsh-novel-forge --env NOVEL_FORGE_ROOT=your-value -- npx -y dsh-novel-forge 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) NOVEL_FORGE_ROOT は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、dsh-novel-forge のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -vMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v
一度入れれば、Node.js を使うすべてのツールで使えます
これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。
NOVEL_FORGE_ROOT 小説ワークスペースのルートディレクトリ(1 冊の小説 = ワークスペース内の 1 ディレクトリ)。GUI クライアントの cwd は制御できないため、必ず明示的に設定してください 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く
claude mcp add --scope user dsh-novel-forge --env NOVEL_FORGE_ROOT=your-value -- npx -y dsh-novel-forgedsh-novel-forge が一覧にあり、接続済みと表示されれば OK です
dsh-novel-forge を使って、私に何ができるか教えて、1 つやってみせて✓ Claude Code が dsh-novel-forge を使っていると言うか、回答に dsh-novel-forge のツール名が出れば接続成功です
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Cursor につなげますが、先に準備が必要です
設定を 1 項目入力 (NOVEL_FORGE_ROOT) · 先にパソコンへ Node.js を入れてください(1 回だけ)
このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Cursor に MCP server dsh-novel-forge を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "dsh-novel-forge": { "command": "npx", "args": [ "-y", "dsh-novel-forge" ], "env": { "NOVEL_FORGE_ROOT": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) NOVEL_FORGE_ROOT は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、dsh-novel-forge のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -vMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v
一度入れれば、Node.js を使うすべてのツールで使えます
これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。
NOVEL_FORGE_ROOT 小説ワークスペースのルートディレクトリ(1 冊の小説 = ワークスペース内の 1 ディレクトリ)。GUI クライアントの cwd は制御できないため、必ず明示的に設定してください 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
dsh-novel-forge の設定で NOVEL_FORGE_ROOT が空です。自分のキーを入れて保存します
dsh-novel-forge を使って、私に何ができるか教えて、1 つやってみせて✓ Cursor が dsh-novel-forge を使っていると言うか、回答に dsh-novel-forge のツール名が出れば接続成功です
メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
VS Code につなげますが、先に準備が必要です
設定を 1 項目入力 (NOVEL_FORGE_ROOT) · 先にパソコンへ Node.js を入れてください(1 回だけ)
このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの VS Code に MCP server dsh-novel-forge を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "dsh-novel-forge": { "type": "stdio", "command": "npx", "args": [ "-y", "dsh-novel-forge" ], "env": { "NOVEL_FORGE_ROOT": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) NOVEL_FORGE_ROOT は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、dsh-novel-forge のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -vMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v
一度入れれば、Node.js を使うすべてのツールで使えます
これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。
NOVEL_FORGE_ROOT 小説ワークスペースのルートディレクトリ(1 冊の小説 = ワークスペース内の 1 ディレクトリ)。GUI クライアントの cwd は制御できないため、必ず明示的に設定してください 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
dsh-novel-forge の設定で NOVEL_FORGE_ROOT が空です。自分のキーを入れて保存します
dsh-novel-forge を使って、私に何ができるか教えて、1 つやってみせて✓ VS Code が dsh-novel-forge を使っていると言うか、回答に dsh-novel-forge のツール名が出れば接続成功です
メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください
JSON 設定は下の「開発者向け」にあります
Claude Code
claude mcp add --scope user dsh-novel-forge --env NOVEL_FORGE_ROOT=your-value -- npx -y dsh-novel-forgeClaude 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"
}
}
}
}NOVEL_FORGE_ROOT 必須 env説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。
パソコン上で動かせるアプリ
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック
レジストリ名は、リポジトリを所有するGitHubアカウント huangziyuan-general で確認済みです
コードの最終更新:昨日
MITを使用
これはパソコンで動くため、インターネット上のエンドポイントはありません
パソコンで動き、代わりにローカルの設定を使います
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです
OSV.dev に dsh-novel-forge@1.7.3 の登録はありません
このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月17日
作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。
[](https://mcp.popnx.com/en/servers/huangziyuan-general-dsh-novel-forge)質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。
まだレビューはありません
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。
あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。
GitHubリポジトリの最終更新は昨日、最新バージョン(1.7.3)がレジストリに届いたのは一昨日です。
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。
同じカテゴリには:World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu
同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。
カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.
Manage monitors, status pages, incidents and maintenances in your openstatus workspace.
Validate oh-my-posh configurations and segment snippets against the official schema.
MCP server for progressive tool usage at any scale (see https://klavis.ai)
Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.
| これ dsh-novel-forge | World Monitor | openstatus | Oh My Posh Validator | Strata | Jitsu | |
|---|---|---|---|---|---|---|
| 動く場所 | パソコンにインストールが必要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 |
| キーが必要 | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ |
| Claude で + から追加 | いいえ | いいえ | いいえ | いいえ | いいえ | いいえ |
| 基本チェック | 3/3 | 4/4 | 4/4 | 4/4 | 1/4 | 4/4 |
| ライセンス | MIT | AGPL-3.0 | AGPL-3.0 | MIT | Apache-2.0 | MIT |
| 料金 | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし |
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
中文文档 | English
DeepSeek Harness(DSH)的中文长篇写作插件。它不是「提示词合集」,而是把一致性、门禁、审计做进工具层与数据层:模型负责动笔,插件负责把写坏、写歪、写穿的地方拦在落盘之前。
适合谁: 多角色 / 多卷 / 连载几十上百章、会被「设定崩了」「前文失忆」「悬念泄底」「AI 味太重」卡住的长篇作者。
它替你挡住的事(全部代码化,可对着源码核):
安装方式 | 界面一览 | 功能硬约束表 | 24 个工具
novel_project init 一句话建书,九阶段状态机引导 立意→设定→人物→大纲→分卷→细纲→正文,缺什么列什么。novel_write_chapter 走多道落盘门禁(机审/账本/内容/细纲契约/熔断),写坏写穿拦在落盘前。novel_audit 零 token 确定性数字——死人复活/账本矛盾/伏笔逾期/章号缺口一次列全。novel_audit platform 五张平台表(起点/番茄/晋江/七猫/飞卢),敏感自查七类带行号改法。novel_search 按记忆碎片把段落找回来,百章后不「看不见前文」。觉得有用?顺手点个 ⭐ 让更多长篇作者看见:github.com/huangziyuan-general/dsh-novel-forge
多数写作插件的约束写在系统提示里——模型心情好就守,赶进度就绕。本插件把「有明确对错」的部分做进代码,设计主线只有一条:
代码强制 > 提示词自觉。 凡是「靠模型自觉」的约束都会失效;一致性、门禁、审计必须是工具层/数据层的硬约束。
三条可在仓库里对着源码核的事实:
novel_write_chapter、REST 写入走同一套门禁代码(机审/账本冲突/内容门禁/细纲契约)——没有旁路;唯一的放行开关显式记审计。不靠形容词,靠三条能对着源码与数据核的事实:
| 证据 | 含义 | 在哪核 |
|---|---|---|
| 某连载本 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即可复现,浅色/深色两套随宿主主题。
看完了演示觉得有用?这就是它每天在你写长篇时替你挡下的事。顺手点个 ⭐ 让更多人看见:
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 章即警示;「创建新会话并交接」一键建新会话(有归档能力就建+归档一次完成),交接摘要自动进剪贴板 | 面板疲劳横幅 |
小说锻炉支持两种接入方式,先选路线再看对应小节:
novel_* 工具 → 方式 B如果你只是想在 Cursor 或 Claude Desktop 里让 AI 写长篇时受约束,走方式 B 即可。
前提:已安装 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
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。
无需安装 DSH(Node ≥ 20)。把下面配置放进客户端的 MCP 设置,即可在对话中调用全部 novel_* 工具:
{
"mcpServers": { "novel-forge": { "command": "npx", "args": ["-y", "dsh-novel-forge@latest"], "env": { "NOVEL_FORGE_ROOT": "/你的小说工作区" } } } }
~/Library/Application Support/Claude/claude_desktop_config.json(Windows:%APPDATA%\Claude\claude_desktop_config.json)后重启。~/.cursor/mcp.json 后重启。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 章即警示(写章进度卡带会话状态行,文案标清「首稿=门禁驳回前的初稿」);「创建新会话并交接」一键建新会话+归档旧会话,交接摘要自动进剪贴板,粘到新会话即可无缝续写 |
| 提案审批 | 详情页 | 查看提案全文 → 应用 / 丢弃;也可按原稿、提案、当前稿逐段三路合并,冲突默认保留当前稿,版本或哈希变化即拒绝;旧版永不覆盖 |
| 工具 | 职责 | 硬约束 |
|---|---|---|
novel_project | init / 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