The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Dsh Novel Writer — 网文写作体检 listing page.
English | 中文
18 个工具,覆盖「动笔前取材料 → 写完量化自检 → 改稿按优先级复测 → 跨章结构体检」整条流程。 动笔前一次调用取齐 16 项材料(漏读一样就漂移);改稿不再只丢给你一堆数字,而是按严重度排好的待办(带原句行号、当前值与目标值、原著锚段,只给方向不代写);跨章层面能查「线断了、人丢了、伏笔忘了」。 句式 / 情感 / 语义全部在本地算:24MB 中文模型随包分发,零 API 花费、正文不出本机。 为 DeepSeek Harness(DSH)打造;同一套能力也可作为 MCP 服务器给 Claude Desktop / Cursor 使用。
🔗 官网:https://siweina.github.io/dsh-novel-writer/ · 技术文档(18 个工具的参数与示例):https://siweina.github.io/dsh-novel-writer/tools/
官网 · 技术文档 · 安装 · 写作流程 · 60 秒上手 · 看看输出 · 18 个工具 · MCP 服务器
| 步骤 | 你说什么 | 用哪个工具 | 拿到什么 |
|---|---|---|---|
| ① 取材料 | 「给下一章取材料」 | novel_chapter_brief | 一次调用取齐 16 项输入:上一章结尾原文(承接口)/ 上一章钩子 / 本章大纲方向 / 相关人物卡 / 待回收伏笔(含埋了多久)/ 世界观用语规范与禁词 / 六维基线 / 原著锚段与句式骨架 / 上一章自检结论 / 禁用清单 / 开写清单——缺哪项、为什么、怎么补写在 degraded 里 |
| ② 动笔 | 「写第 N 章」 | novel_new_chapter · write | 新章文件(自动附基线 μ 摘要与原著锚包);锚段只用来校准语感(不照骨架造句),数字只做事后校验 |
| ③ 自检 | 「自检这一章」 | novel_style_check · novel_sentence_analysis | 相似度 + 偏差清单 + 六维对照(带内 ✓ / 出带 ⚠)。只有偏离明显(≥2 倍容差)或读起来确实别扭时才改——单一维度轻微出带属正常波动,不要为对齐数字改文 |
| ④ 改稿 | 「把这章排成改稿清单」 | novel_fix_plan | 按「严重度 → 难度 → 行号」排序的待办(默认上限 12 条),每条带原句行号、当前值/目标值、锚段与改写方向;分批改(同段同类合并),改完最多 verify 一次 |
| ⑤ 跨章体检 | 「看看全书结构」 | novel_plot { action: "graph" } | 伏笔埋设跨度 / 人物连续缺席区间 / 剧情线最大空档 / 时间线顺序 / 大纲方向与正文的偏离 |
全程本地、只读优先:开写包与结构视图不写任何文件;改稿台只写自己的清单文件、从不改正文,也不代写正文;语义检索与情感分析零 token。
省 token 模式(v5.1.0 新增):侧边栏「精简工作流」开关(或
novel_sentence_config传leanWorkflow=true)打开后只保留一条原则——工具按需调用:不主动跑自检、不复测清单、不登记伏笔/钩子/摘要;报告类工具未显式传brief时默认走精简输出(风格画像实测 181 字符 vs 完整 1725 字符)。v5.1.0 成本与手感修复:v5.0.0 曾把「写完必须自检 + 收尾三件」「改稿逐条 mark + 反复 verify」写成必做清单,一章从 3 次调用涨到 6 次、改稿要 30+ 次;同时"照骨架造句"与"任一维度出带必改"会让文章越改越僵。本版全部改回按需:写一章 2 次调用起,改稿清单上限 40 → 12 条、同一维度只报最严重的 1 段,并明确了出带不等于缺陷(抒情/心理/留白段读起来不别扭就保留,可用
mark标skip)。
| 你的困扰 | 这里给的答案 |
|---|---|
| "我续写的这段,读起来不像我自己写的" | 文笔六维基线:从句法复杂度 / 修饰密度 / 抽象度 / 动作密度 / 不确定性 / 留白指数六个维度算出原著的 μ±σ,新章逐维对照,出带标 ⚠ |
| "AI 说文风变了,但说不清哪儿变了" | 风格自检:相似度 + 偏差清单(哪类句式多了、句长偏了多少、主导情绪有没有换) |
| "动笔前要翻六七个工具,还老漏读一样" | 开写包:一次调用取齐 16 项材料;取不到的在 degraded 里说明缺什么、怎么补——漏读正是文风漂移与设定矛盾的头号来源 |
| "知道这章有问题,但不知道先改哪句" | 改稿台:按「严重度 → 难度 → 行号」排好待办,每条给原句行号 / 当前值与目标值 / 原著锚段 / 改写方向;改完可三态复测 |
| "线断了、人丢了、伏笔忘了——写到后面才崩" | 结构视图:跨章算出伏笔埋设跨度、人物连续缺席区间、剧情线最大空档、时间线顺序、大纲与正文的偏离 |
| "分析小说要花钱调 API" | 语义检索与情感分析全本地推理,零 token 花费 |
| "伏笔埋了忘了收" | 伏笔登记表:add / list / scan / done,自动记录每条伏笔在哪些章被提到 |
| "人物设定前后打架" | 设定五张表 + 连贯性审计(衔接 / OOC / 大纲走偏三件套) |
| "报告看不懂" | 全是表格化数字 + 原文锚段,可以直接截图分享 |
方式一:npm(推荐)
方式二:从 GitHub 安装
方式三:MCP(不用 DSH 也能用) —— 见 MCP 服务器
要求 Node ≥ 22.3。安装后重启 Web 应用,侧边栏出现「写作助手功能」面板。
然后在对话里依次说(这就是完整的一章):
novel_chapter_brief 一次给齐 16 项输入(等于替你跑了 6~8 个工具,且不会漏读)novel_new_chapter 建文件时还会附上基线 μnovel_style_check 给出相似度、偏差清单与六维对照novel_fix_plan 给出按优先级排好的待办;改完再 verify 复测三态只想先看看家底,就说 「用 novel_style_report 给我的小说做一次风格画像」:
开写包(novel_chapter_brief,动笔前一次调用):
改稿台(novel_fix_plan,把诊断变成排好序的待办):
风格自检(新章 vs 全书基线):
语义检索(自然语言,本地向量):
段落结构:共 34 段(对话 5 / 心理 0 / 混合 15 / 叙述 14)
| 本插件 | 在线 AI 写作工具 | 通用文本分析库 | |
|---|---|---|---|
| 正文是否离开本机 | 否 | 是 | 视实现 |
| 花费 | 0(本地推理) | 按 token 计费 | 自建 |
| 中文小说专用 | 是 | 通用 | 否 |
| 风格基线(μ±σ) | 有 | 少见 | 无 |
| 与 DSH 集成 | 18 工具 + 侧边栏开关 | 无 | 无 |
| 非 DSH 用户可用 | 可以(MCP) | 可以 | 需自己封装 |
致非中文用户:本插件为中文小说分析写作而设计——句式、情感、意象等核心能力以及内置的语义模型,全部针对中文语料构建与调优。在深耕中文的同时兼顾英文等其他语言,确实超出了我目前的能力范围。若因此给您带来不便,我深感抱歉,恳请谅解。
novel_chapter_brief 开写包——动笔前一次调用取齐材料(上一章承接口 / 本章方向 / 相关人物 / 待回收伏笔 / 用语规范 / 风格基线 / 锚段与骨架 / 禁用清单 / 开写清单,两档 budget:compact / full),取不到的材料进 degraded 并说明原因,只读不写盘;novel_fix_plan 改稿台——把风格诊断变成按优先级排好的待办(原句行号定位 + 当前值与目标值 + 原著锚段 + 改写方向),plan / verify / mark 三态复测,只给方向、不生成正文;novel_plot { action: "graph" } 结构视图——伏笔埋设跨度 / 人物连续缺席 / 剧情线空档 / 时间线顺序 / 大纲对照。另有场景化提示词(general / writing / revising / auditing / setup,general 即旧行为)。.novel-writer/style-reports/),续写保持风格一致。novel_semantic_search 自然语言搜全书语义相关段落(带章节定位),语义级风格对比、语义隐性情感,懒加载 + 自动回退。novel_style_report 输出基线带,novel_style_check 对照新章偏差(带内 ✓ / 出带 ⚠);侧边栏可自定义每维 ±% 容差(推荐值 = 原著章节波动的 1.5 倍 σ,自动取整、限 ±10%~100%;输入框留空即用推荐)——原创/续写时主题自由、写法保持在基线带内。novel_continuity_check 扩展——①衔接检查(chapter 参数:时间硬跳/语义距离/人物延续/钩子承接四路检测,带原文引用)②OOC 检测(ooc 参数:角色情绪基线偏离)③大纲走偏(outline 参数:方向行 vs 正文关键词重合);报告工具支持 brief 精简模式。每个工具的参数、返回结构与示例,见在线工具手册。
| 工具 | 说明 |
|---|---|
novel_books | 列出章节库全部作品 |
novel_chapters | 列出某作品章节清单 |
novel_read | 阅读某章正文(分段) |
novel_keywords | 关键词:二字组/三字组/疑似人名 |
novel_new_chapter | 创建新章节文件 |
novel_import | 原稿件批量导入/分类 |
novel_sentence_analysis | 句式模式分析(九类/情感净化/量化/曲线/指纹) |
novel_sentence_config | 查看/修改工具与功能开关(含提示词场景) |
novel_style_check | 风格自检(规则+语义双维度) |
novel_style_report | 风格画像报告(6 维测量 + AI 判断分离) |
novel_plot | 伏笔/剧情线登记表;action: "graph" 结构视图(伏笔埋设跨度 / 人物连续缺席 / 剧情线空档 / 时间线顺序 / 大纲对照) |
novel_settings | 设定管理(人物/地点/道具/时间线/世界观) |
novel_summary | 章节摘要(长书续写辅助) |
novel_continuity_check | 连贯性审计 + 衔接/OOC/大纲走偏哨兵 |
novel_semantic_search | 语义检索(本地 embedding,0 token) |
novel_outline | 创作资料管理(创作设定/人物/大纲/钩子/状态卡) |
novel_chapter_brief | 开写包——动笔前一次调用取齐材料(上一章承接口/本章方向/相关人物/待回收伏笔/用语规范/风格基线/锚段与骨架/禁用清单/开写清单) |
novel_fix_plan | 改稿台——把风格诊断变成按优先级排好的待办(带行号定位与锚段),改完可复测;只给方向不生成正文 |
包里自带一个 stdio MCP 服务器(mcp/server.mjs),把 18 个工具原样暴露给任何 MCP 客户端,
例如 Claude Desktop、Cursor。它是跑在你自己电脑上的本地进程,不需要服务器、不需要联网、不需要常驻。
客户端配置示例(claude_desktop_config.json / Cursor mcp.json):
书库根目录优先级:--root > 环境变量 DSH_NOVEL_WRITER_ROOT > 当前工作目录。
细节见 mcp/README.md。
<书库根>/.novel-writer/:plots(伏笔)/ settings(设定)/ summaries(摘要)/ analysis(分析报告)/ audits(连贯性审计 + 改稿清单 fix-plan-*.json)/ embedding(语义索引)/ style-reports(风格画像)。
运行时依赖(npm install 自动安装,均为公开包):
onnxruntime-web ^1.24.3 —— 本地 ONNX 推理(WASM 后端),用于语义检索与语义风格距离;@huggingface/tokenizers ^0.1.0 —— 中文分词(WASM);react ^18.2.0(浏览器端复用 DSH Web GUI 自带的 React,不额外打包)。本地模型:lib/models/ 随包分发 bge-small-zh-v1.5 量化模型(约 24MB,ONNX)与分词器
(tokenizer.json.gz,加载时解压)。全部推理在本机 CPU 完成,不上传任何文本。
权限与外部服务:
novels/ 与其数据目录 <root>/.novel-writer/,
以及插件自身的开关文件 ~/.dsh/dsh-novel-writer/state.json。例外一处:novel_import 的 src
按设计可以指向任意目录(用于把别处的旧稿导入书库),mode:"apply" + move:true 会删除源文件——
删改范围由调用方决定,请只在明确知道源目录内容时使用。例外仅此一处:MCP 服务器默认把这个 src
也限制在书库根内(见下方 MCP 一节)。ctx.skills 注册自带 novel-writing 技能(v4.3.0 起),只读取包内
skills/novel-writing/SKILL.md,不写入任何技能目录、不需要改宿主配置;宿主没有 skills 服务时静默跳过。allowLanState 默认关闭,局域网访问默认拒绝。mcp/server.mjs):工具参数里的 root 必须落在启动时 --root 指定的书库根之内,
越界会被拒绝并回退;novel_import 的 src 默认也限根内,确需导入外部目录时用
--allow-external-src 显式放开(v4.3.0 起)。单行报文上限 4 MiB,超限整行丢弃;stderr 默认只记一行错误摘要,
不回显正文与堆栈(需要完整堆栈用 DEBUG=1);长任务可用 notifications/cancelled 取消。详见
mcp/README.md 第 0 节。api.github.com)检查新版本——3 秒超时、24 小时缓存、
失败静默降级;请求不含任何书籍内容。explorer / macOS open / Linux xdg-open),
以数组参数直调、不经 shell。失败边界:
兼容范围:Node.js >= 22.3(engines.node);DSH >= 0.1.1-rc.2(dsh.engines.dsh)。