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 操作,先把命令给我看,等我同意后再运行。粘贴到能在你电脑上工作的 AI(如 Claude Code、Cursor)。它会读取我们的步骤,先给你看命令,等你同意。无需密钥,无需注册。 · 查看 AI 会读取的全文
通过 3/3 项检查 · 在你的电脑上运行 · ✓ 命令已检查 2026年11月19日
第一步:你用哪个 AI?
选择你用的应用,步骤会显示在下方。
可连接 Claude,但需要先准备
需要填写 1 项设置(NOVEL_FORGE_ROOT) · 需要先在电脑上安装 Node.js(只需一次) · 仅限电脑上的 Claude 应用(Windows 或 Mac),网页和手机不可用
把这段话复制到 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 小说工作区根目录(一本小说 = 工作区里的一个目录);GUI 客户端 cwd 不可控,务必显式设置 说明为自动翻译,变量名保持原样;不确定时请查看原文。
SettingsDeveloperEdit Config
{
"mcpServers": {
"dsh-novel-forge": {
"command": "npx",
"args": [
"-y",
"dsh-novel-forge"
],
"env": {
"NOVEL_FORGE_ROOT": "your-value"
}
}
}
}用 dsh-novel-forge 告诉我你能帮我做什么,然后做一件给我看✓ 如果 Claude 说正在使用 dsh-novel-forge,或回答中出现 dsh-novel-forge 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同
ChatGPT 暂时无法连接 dsh-novel-forge
dsh-novel-forge 需要安装在你的电脑上,而 ChatGPT 只能连接在网上运行的服务器
A · 使用能连接 dsh-novel-forge 的应用
B · 其他 类中能连接 ChatGPT 的其他服务器
从同类中使用较多的里挑选,仅限用地址即可连接、无需密钥的
可连接 Claude Code,但需要先准备
需要填写 1 项设置(NOVEL_FORGE_ROOT) · 需要先在电脑上安装 Node.js(只需一次)
把这段话复制到 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 小说工作区根目录(一本小说 = 工作区里的一个目录);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-forge应能看到 dsh-novel-forge 在列表中并显示已连接
用 dsh-novel-forge 告诉我你能帮我做什么,然后做一件给我看✓ 如果 Claude Code 说正在使用 dsh-novel-forge,或回答中出现 dsh-novel-forge 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同
可连接 Cursor,但需要先准备
需要填写 1 项设置(NOVEL_FORGE_ROOT) · 需要先在电脑上安装 Node.js(只需一次)
把这段话复制到 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 小说工作区根目录(一本小说 = 工作区里的一个目录);GUI 客户端 cwd 不可控,务必显式设置 说明为自动翻译,变量名保持原样;不确定时请查看原文。
在 dsh-novel-forge 的设置中,NOVEL_FORGE_ROOT 还是空的,填入你的密钥并保存
用 dsh-novel-forge 告诉我你能帮我做什么,然后做一件给我看✓ 如果 Cursor 说正在使用 dsh-novel-forge,或回答中出现 dsh-novel-forge 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 Cursor 帮助页面核实 · 你的界面可能因版本略有不同
可连接 VS Code,但需要先准备
需要填写 1 项设置(NOVEL_FORGE_ROOT) · 需要先在电脑上安装 Node.js(只需一次)
把这段话复制到 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 小说工作区根目录(一本小说 = 工作区里的一个目录);GUI 客户端 cwd 不可控,务必显式设置 说明为自动翻译,变量名保持原样;不确定时请查看原文。
在 dsh-novel-forge 的设置中,NOVEL_FORGE_ROOT 还是空的,填入你的密钥并保存
用 dsh-novel-forge 告诉我你能帮我做什么,然后做一件给我看✓ 如果 VS Code 说正在使用 dsh-novel-forge,或回答中出现 dsh-novel-forge 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 VS Code 帮助页面核实 · 你的界面可能因版本略有不同
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
它在你的电脑上运行,没有互联网端点
在你的电脑上运行,改用本地设置
它在你的电脑上运行;我们只能读取互联网端点的工具列表
尚未检查
如果你是作者,可把这段代码贴到 README。徽章会链接回本页。
[](https://mcp.popnx.com/en/servers/huangziyuan-general-dsh-novel-forge)提问、分享技巧或报告无法使用。按“有帮助”数量排序。
还没有评价
与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。
它在 3 项适用的基础检查中通过了 3 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。
注册中心没有列出必需的密钥,不过有些服务器会在首次使用时要求你登录。
它在你的电脑上运行。你的 AI 应用会在需要时启动它,数据不会经过作者的服务器(除非它自己调用在线服务)。
GitHub 仓库最后更新于昨天,最新版本(1.7.4)于今天进入注册中心。
支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。你的电脑上还需要有 Node.js。
同一分类中有:World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu
同一分类、其他作者、命令已通过检查。官方的排在前面,再按星标排序。
如何看卡片:↓ 每周下载量i★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况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