dsh-novel-writer — 网文写作体检

📚 dsh-novel-writer — 给网文作者的本地写作工作台

English | 中文

21 个工具，覆盖「动笔前取材料 → 写完量化自检 → 改稿按优先级复测 → 跨章结构体检 → 收尾清理与诊断」整条流程。 动笔前一次调用取齐 16 项材料（漏读一样就漂移）；改稿不再只丢给你一堆数字，而是按严重度排好的待办（带原句行号、当前值与目标值、原著锚段，只给方向不代写）；跨章层面能查「线断了、人丢了、伏笔忘了」。 句式 / 情感 / 语义全部在本地算：24MB 中文模型随包分发，零 API 花费、正文不出本机。 为 DeepSeek Harness（DSH）打造；同一套能力也可作为 MCP 服务器给 Claude Desktop / Cursor 使用。

官网 · 技术文档（21 个工具的参数与示例） · 安装 · 写作流程 · 60 秒上手 · 看看输出 · 21 个工具 · MCP 服务器

---

完整版本变更见 CHANGELOG.md。

写作流程（一条能走完的闭环）

全程本地、只读优先：开写包与结构视图不写任何文件；改稿台只写自己的清单文件、从不改正文，也不代写正文；语义检索与情感分析零 token。

它解决什么问题

安装

方式一：npm（推荐）

dsh plugin add dsh-novel-writer

（需要指定配置时加 --profile <名称>，如 --profile desktop。）

方式二：从 GitHub 安装

dsh plugin add github:siweina/dsh-novel-writer#main

方式三：MCP（不用 DSH 也能用） —— 见 MCP 服务器

要求 Node ≥ 22.3。安装后重启 DSH（桌面端 / Web），左栏主导航区出现「写作助手功能」入口（DSH 0.2.0+ 官方席位；更早宿主自动回退旧挂载）。

60 秒上手

mkdir -p novels/我的小说     # 把章节文件放进去（第01章.md、第02章.md …）

然后在对话里依次说（这就是完整的一章）：

1. 「给下一章取材料」 → novel_chapter_brief 一次给齐 16 项输入（等于替你跑了 6~8 个工具，且不会漏读）
2. 「写第 7 章」 → 照返回的锚段与骨架写；novel_new_chapter 建文件时还会附上基线 μ
3. 「自检第 7 章」 → novel_style_check 给出相似度、偏差清单与六维对照
4. 「把第 7 章排成改稿清单」 → novel_fix_plan 给出按优先级排好的待办；改完再 verify 复测三态

想让基线对着你亲手写的那些章、而不是全书？面板「风格基线」里把「范围」切到 按部分、在「挑选章节」里勾出标杆章，再点「保存范围」即可：上面这条链上的自检、开写包、改稿台与风格画像都会改用这几章当基线（按书生效；默认「全书」＝旧行为，不动它就跟以前完全一样）。建章（novel_new_chapter）时附的 μ 摘要与锚段用的是同一份范围。

只想先看看家底，就说 「用 novel_style_report 给我的小说做一次风格画像」：

全书 1329 字：六维基线 μ=句法复杂度:2.3 修饰密度:35.6 抽象度:0.5 动作密度:101.7 不确定性:2.1 留白指数:7.0

推荐容差 25%/35%/100%…

看看输出长什么样

开写包（novel_chapter_brief，动笔前一次调用）：

目标：第 8 章《（无标题）》（尚未创建，文件名推导为 第08章.md）

【上一章结尾原文·承接口】…（上一章末尾 300 / 600 字，按 budget 档位） 【待回收伏笔】

• [mu5kjla…] 琥珀色齿轮怀表的来历与停摆的指针（high｜第 1 章埋下，已过 6 章）
• [mu5kjlb…] 海图上红铅笔圈的礁区坐标（high｜第 3 章埋下，已过 4 章）

【相关人物】- 林昭：守码头的女人，父亲失踪后回到旧宅　- 沈砚：随船出海的人 【世界观用语】欧式中世纪沿海城邦；点烛不烧香｜禁用：上香、烧香、时辰、老夫 【风格基线】complexity μ=2.42 modifierDensity μ=22.2 abstractDensity μ=10.06 actionDensity μ=122.45 …（取样范围：全书除本章外的 7 章） 【原著锚段·照这个味道写】[对话] … [心理] … 【上一章自检】第 7 章六维对照：全部维度在容差带内 ✓ 【本章禁用清单】- 禁词：上香（建议改用：点烛）　- 禁词：时辰（建议改用：钟点） 【开写清单】□ 先读锚段再动笔　□ 承接上一章结尾　□ …（共 8 步） 【降级/提示】- 钩子记录里没有第 7 章的钩子（上一章钩子未回填）

改稿台（novel_fix_plan，把诊断变成排好序的待办）：

改稿台：共 13 项待办（严重度降序 → 难度升序）。抽象度过高 ×3、衔接缺失 ×1、禁用词 ×3、语用不符 ×5、句式偏离 ×1。

备注：留白指数 虽出带但差值 8.36 < 门槛 12，已按「无量级差异」忽略 ← 不误报的绝对量级闸

• [抽象度过高] 严重度 5 / 难度 2（第 5 行） id：fix-abstract-5-c2c156d4 现状：abstractDensity 47.9　目标：0.55~6.95 原句：林昭大概说不清那种感觉。她隐隐觉得… 方向：抽象度偏离：全章 47.9（基线 3.75，偏差 +1177.3%），本段 74.38。这句抽象词过密，改成具体动作或物件。 锚段：林昭把它捏在掌心，翻过来看背面。背面刻着一行小字，被磨得只剩半边。她认出了父亲的名字。
• [语用不符] 严重度 4 / 难度 2（第 15 行） 现状：客套禁词「承蒙」（第 15 行）　目标：避免该类客套表达 方向：「承蒙」属世界观说话方式规范里明确不用的客套表达（honorBad）。这是说法层面的替换，不要顺手改剧情。

风格自检（新章 vs 全书基线）：

相似度 0.946 · verdict: high

偏差清单：心理占比略多 · 对话占比略少 · 短句占比略少 · 主导情绪由 anger 变为 joy fixAnchors：3 条原著锚段（对话 / 心理 / 描写各一条，供逐句对照修正）

语义检索（自然语言，本地向量）：

查询「与那盏没有点的灯有关的段落」→

第02章.md 0.619 对街那盏灯，亮了。 第01章.md 0.593 阿澈的目光越过老周的肩膀，落在对街那栋小楼上…

段落结构：共 34 段（对话 5 / 心理 0 / 混合 15 / 叙述 14）

为什么不用在线 AI 写作工具

致非中文用户：本插件为中文小说分析写作而设计——句式、情感、意象等核心能力以及内置的语义模型，全部针对中文语料构建与调优。在深耕中文的同时兼顾英文等其他语言，确实超出了我目前的能力范围。若因此给您带来不便，我深感抱歉，恳请谅解。

---

功能

1. 写作台三件套：novel_chapter_brief 开写包——动笔前一次调用取齐材料（上一章承接口 / 本章方向 / 相关人物 / 待回收伏笔 / 用语规范 / 风格基线 / 锚段与骨架 / 禁用清单 / 开写清单，两档 budget：compact / full），取不到的材料进 degraded 并说明原因，只读不写盘；novel_fix_plan 改稿台——把风格诊断变成按优先级排好的待办（原句行号定位 + 当前值与目标值 + 原著锚段 + 改写方向），plan / verify / mark 三态复测，只给方向、不生成正文；novel_plot { action: "graph" } 结构视图——伏笔埋设跨度 / 人物连续缺席 / 剧情线空档 / 时间线顺序 / 大纲对照。另有场景化提示词（general / writing / revising / auditing / setup，general 即旧行为）。
2. 风格画像报告（novel_style_report）：6 维测量报告——文风指纹 / 高频词汇 / 题材流派 / 情感量化 / 氛围光谱 12 轴 / 语义风格距离。测量与判断分离：插件只报数不贴标签，AI 判断可回传存盘（.novel-writer/style-reports/），续写保持风格一致。
3. 氛围光谱 12 轴：噩梦感 / 焦虑压抑 / 温馨治愈 / 甜宠日常 / 催泪虐心 / 黑暗残酷 / 悬疑神秘 / 热血激昂 / 荒诞无厘头 / 孤独疏离 / 文艺唯美 / 情欲暧昧——证据链可追溯，0 token。
4. 本地语义引擎：bge-small-zh 中文模型（24MB 随插件分发）本地 CPU 推理——novel_semantic_search 自然语言搜全书语义相关段落（带章节定位），语义级风格对比、语义隐性情感，懒加载 + 自动回退。
5. 句式模式分析：九类句式分布、排列规律、句长节奏、情感曲线、风格指纹与节奏建议，带缓存与报告导出。

细节密度口径（v7.0.0）：动作 / 物件 / 视觉 / 听觉 / 嗅觉 / 触觉 / 温度七个通道的词表加了上下文豁免层——「一点」「根本」「一样」「痛苦」「干净」「温柔」这类虚词搭配不再计数（同一章实测降约 15%~20%），报告会多渲染一行口径说明；同一章的新旧数值不可直接比较，跨章比较只用同一口径的数值。

1. 情感净化 + 量化：强/弱情绪词分级、污染源检测、caveat 预警 + AI 复核；Valence 滑动窗口 → 方差 V / 斜率 Δ / 矛盾指数 C + 隐性意象载体。

情感复杂度与置信度联动（v6.6.5）：结论不可采信时（污染命中阈值、全文零情感词命中，或没有可用的 clean 情感计数）不再给顶格结论——complexity.level 标为 unknown，并附 reliable: false 与 reliabilityNote 说明原因，渲染文本里也会单独一行写出这句警告；score 保留数值便于跨章对比。成人向内容 / 感官描写密集的文本，情感维度本就不适用，建议改用节奏、爽点、对话密度等维度。

1. 世界观与语用检测：文化基准自动判断（西/东/混合）+ 置信度；speechStyle 称谓/客套/仪式/语气规范；题材流派 + 网文信号。
2. 写作辅助全家桶：伏笔登记表 / 设定五张表（人物·地点·道具·时间线·世界观）/ 章节摘要 / 连贯性审计 / 批量导入 / 风格自检 / 续写辅助。
3. 全工具 UI 开关：左栏「写作助手功能」入口 + 主栏面板（DSH 0.2.0 官方席位；老宿主 < 0.2.0 自动回退旧挂载）——首页按「写作资料 / AI 行为 / 功能与工具 / 记录与维护 / 高级」分区，一个页面只讲一件事；工具行统一由 PreferenceRow 承载，开关本身就是状态（开着的开关不再整行变蓝、也不再贴「已开启」），描述只写「对你有什么用」，工具 ID 与参数不进主文案。颜色全走 --dsw-alias-* 语义 token（三主题与官方同源）、控件用官方 UI primitives、DeepSeek 蓝只留给「唯一主操作」与需要注意的状态，各级页面等宽。

v6.7.0 面板视觉改版：lib/client.js 渲染层重写、视觉系统 CSS 4.6 KB → 19.4 KB、52 枚线图标（每个工具行一枚专属图标），文件路径 / 数据目录占用 / state.json 统一收进页面底部的「存储位置」折叠区，首页「功能与工具」的「语义模型」一行显示引擎状态；功能面完全不变（8 个视图 / 工具集 / 后端路由在 6.7.0 内零改动），设计规格见仓库内 tools/UI-REDESIGN.md。 界面底座（方案 A）：源码分块 + 构建链装配（构建失败不写盘、--check 校验源与产物一致）、统一组件（PreferenceRow 单一行模式、GroupCard 分组卡、StorageDisclosure 存储位置折叠区等）、页面级 push-pop 过渡动画（零 state / 零 hook）。

1. 风格基线：文笔六维测量（句法复杂度/修饰密度/抽象度/动作密度/不确定性/留白指数）+ 按章节 μ±σ 基线带；novel_style_report 输出基线带，novel_style_check 对照新章偏差（带内 ✓ / 出带 ⚠）；面板「风格基线」页的「文风六项指标」分区可自定义每维 ±% 容差（每维一行：指标名 + 「低于」「高于」两个百分比输入框；推荐值 = 原著章节波动的 1.5 倍 σ，自动取整、限 ±10%~100%；输入框留空即用推荐）——原创/续写时主题自由、写法保持在基线带内。

基线范围（v6.5.5，按书选择）：基线不必永远是全书——面板「风格基线」里选全书（默认，等于旧行为）/ 按部分，再用章节选择器勾出你认作标杆的章，基线就只用这几章（是「只用」，不是「不够再补」）。这是给「AI 续写越写越像 AI 自己」准备的：从第 2 章续写起，模型参考的其实是它自己写的上一章，而从全书取样的基线自己也在漂（书越长 AI 占比越高）。把标杆钉死在你亲手写的那些章上，插件就能回答「相对这几章，新章偏了多少」——它不判断你有没有漂移，那一项本就不可判定。正在检查的那一章永远排除（否则等于拿自己跟自己比）；勾中的章少于 3 章时推荐容差自动放宽到至少 ±25%，所以单章也能当基线；取不到的章（已改名 / 已删除，或正文过短无法测量）会被跳过并如实计数，一章都取不到时自动回退「按全书」并在返回体里写明原因。范围按书保存（<书库根>/.novel-writer/baseline/<书名>.json），换书互不影响。 六维口径未变（v7.0.0）：本次只换了细节密度的词表，这六维的算法与数值都没动，新旧报告可以直接比。

1. 写作哨兵三件套：novel_continuity_check 扩展——①衔接检查（chapter 参数：时间硬跳/语义距离/人物延续/钩子承接四路检测，带原文引用）②OOC 检测（ooc 参数：角色情绪基线偏离）③大纲走偏（outline 参数：方向行 vs 正文关键词重合）；报告工具支持 brief 精简模式。
2. 原创模式与创作资料：面板「原创设定」填写创作设定（世界观 / 角色设定 / 不允许的事件 / 主线目的 / 题材偏好 / 额外要求，留空=模型自定，多书独立设定库）；novel_outline 维护创作资料（创作设定/人物/剧情大纲/钩子记录/创作状态卡），原创强制「设定书→大纲→钩子」链，动态批次（10→20→30 章）防剧情跳跃与角色 OOC。
3. 体验与统计：首页「写作资料」卡底部一行书库概况（「书库 3 部 · 13 章 · 5.0 万字」，点开是每本书的章数 / 字数 / 7 天未动，以及每本书旁的删除整本书…快捷入口）；首页第一个分区里还有一行「删除整本书」——点进去是独立页面：选书 → 看清清理清单 → 勾选执行，页面下方就是回收站（恢复 / 彻底删除）。原来独立的「书库统计」卡已并入书库概况这一行；「记录与维护」里有体验演示（内置示例不落盘跑六项文风指标，不保存任何内容）、报告历史（已保存的句式分析与风格报告，按书分组，每份都可单独删除——删除走回收站，仍可恢复）与诊断报告（统计窗口 + 一键复制诊断包，用于贴进 issue）；错误提示带解决步骤；工具说明压缩省 token。

v7.0.0 修尺子：细节密度词表去噪、动作链示例改为完整句等距抽样 3 条、面板「诊断报告」页新增「度量口径」区可一键重建旧口径缓存（只删派生缓存，不动你选的基线范围）。

1. 非净化模式（`rawWriting`，默认关闭，6.9.0 重做）：一个写作约束开关，不是模型能力开关；开启需双重确认 + 承诺输入。开启后分三层工作——动笔前：开写包多出【非净化模式·目标带】（原著「把场面绕过去」的写法密度，处/千字，启发式；本章目标带；一条硬约束：留在场景里 / 细节密度对齐原著 / 不用省略号或跳场带过 / 不用总结代称 / 不插评论与免责）；动笔时：模型若在开头就自我刹车（「这一段我不展开」这类），llm/stream 那一层会丢弃这次输出并只重试一次（重试只在系统消息尾部追加写作指令，不改你的输入）；写完后：novel_style_check 给出「本章 X 处/千字 vs 原著 Y 处/千字」与一句结论（clean / new / similar / softer / much-softer / more-explicit）——干的是「有没有被绕过去」的核对，不是评分。已知边界：直白度量是启发式（只数明确的淡化写法）；重试只一次且只认三类自我刹车特征；这一层依赖宿主 llm/stream，服务缺失时安静跳过并在日志留痕；效果取决于模型本身，插件不保证产出。

---

提供的工具（21 个）

每个工具的参数、返回结构与示例，见在线工具手册。

| `nov