siweina/dsh-novel-writer

English | 中文
**20 个工具，覆盖「动笔前取材料 → 写完量化自检 → 改稿按优先级复测 → 跨章结构体检」整条流程。**
动笔前**一次调用取齐 16 项材料**（漏读一样就漂移）；改稿不再只丢给你一堆数字，而是**按严重度排好的待办**（带原句行号、当前值与目标值、原著锚段，**只给方向不代写**）；跨章层面能查「线断了、人丢了、伏笔忘了」。
句式 / 情感 / 语义全部**在本地算**：24MB 中文模型随包分发，**零 API 花费、正文不出本机**。
为 DeepSeek Harness（DSH）打造；同一套能力也可作为 **MCP 服务器**给 Claude Desktop / Cursor 使用。
官网 · 技术文档（20 个工具的参数与示例） · 安装 · 写作流程 · 60 秒上手 · 看看输出 · 20 个工具 · MCP 服务器
---
完整版本变更见 CHANGELOG.md。
写作流程（一条能走完的闭环）
| 步骤 | 你说什么 | 用哪个工具 | 拿到什么 |
|---|---|---|---|
| ① **取材料** | 「给下一章取材料」 | 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。
它解决什么问题
| 你的困扰 | 这里给的答案 |
|---|---|
| "我续写的这段，读起来不像我自己写的" | **文笔六维基线**：从句法复杂度 / 修饰密度 / 抽象度 / 动作密度 / 不确定性 / 留白指数六个维度算出原著的 μ±σ，新章逐维对照，出带标 ⚠ |
| "AI 接着往下写，几章之后文风越来越像 AI 自己，不像原著了" | **基线范围（按全书 / 按部分）**：基线不必再从全书取样——勾出你认作标杆的那几章（比如你亲手写的前 30 章），自检 / 开写包 / 改稿台 / 风格画像 / 建章都**只用**这几章当基准，正在检查的那一章永远排除在外。**插件不判定「你漂移了」，只告诉你「相对你选的标杆，这章偏了多少」**（回应 issue #1「风格漂移」） |
| "AI 说文风变了，但说不清哪儿变了" | **风格自检**：相似度 + 偏差清单（哪类句式多了、句长偏了多少、主导情绪有没有换） |
| "动笔前要翻六七个工具，还老漏读一样" | **开写包**：一次调用取齐 16 项材料；取不到的在 degraded 里说明缺什么、怎么补——**漏读正是文风漂移与设定矛盾的头号来源** |
| "知道这章有问题，但不知道先改哪句" | **改稿台**：按「严重度 → 难度 → 行号」排好待办，每条给原句行号 / 当前值与目标值 / 原著锚段 / 改写方向；改完可三态复测 |
| "线断了、人丢了、伏笔忘了——写到后面才崩" | **结构视图**：跨章算出伏笔埋设跨度、人物连续缺席区间、剧情线最大空档、时间线顺序、大纲与正文的偏离 |
| "分析小说要花钱调 API" | 语义检索与情感分析**全本地推理**，零 token 花费 |
| "伏笔埋了忘了收" | **伏笔登记表**：add / list / scan / done，自动记录每条伏笔在哪些章被提到 |
| "人物设定前后打架" | **设定五张表 + 连贯性审计**（衔接 / OOC / 大纲走偏三件套） |
| "报告看不懂" | 全是**表格化数字 + 原文锚段**，可以直接截图分享 |
| "出错了只给一句话，说不清为什么**反复**出错" | **诊断报告**（novel_diagnose）：读本地事件日志 + **五处体检**（书库根 / 书库内容 / 数据目录损坏 / 语义引擎 / 开关快照），聚合「工具 × 书名」反复出问题的组合、高频失败类型与可执行建议；报告走**分享层**（自由文本整体剔除、错误一律归类成固定 code），**可安全贴进 issue**——报 bug 请用面板「复制诊断包」或本工具的 report，**不要**直接附本机日志文件。本地日志**以元数据为主**（工具名 / 书名 / 章号 / 状态 / 耗时 / 计数 / 路径 / 错误 code），**但自由文本字段（错误消息等）经收敛后至多保留一句（≤160 字）**——所以**本机**日志里可能出现被错误消息回显的输入片段；**日志文件不出本机**，只有**离开本机**的内容才整体剔除自由文本 |
安装
**方式一：npm（推荐）**
（需要指定配置时加 --profile ，如 --profile desktop。）
**方式二：从 GitHub 安装**
**方式三：MCP（不用 DSH 也能用）** —— 见 MCP 服务器
要求 **Node ≥ 22.3**。安装后**重启 DSH**（桌面端 / Web），左栏主导航区出现「写作助手功能」入口（DSH 0.2.0+ 官方席位；更早宿主自动回退旧挂载）。
60 秒上手
然后在对话里依次说（这就是完整的一章）：
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 给我的小说做一次风格画像」**：