dsh-novel-craft

dsh-novel-craft

English: docs/README.en.md（只放在仓库里，不进 npm 包——否则 npm 页面会显示英文版）

dsh-novel-craft 是一个跑在 DeepSeek Harness（dsh）上的开源 AI 小说写作插件（MIT 协议，npm 一行安装）。它解决的是「怎么让 AI 写出符合你个人文风的小说」——不用反复调提示词，也不用逐段写评语。

目的：让 AI 写出你觉得对味的文字。

方法：你只点赞、点踩，模型自己总结规律。

读候选稿时顺手点一下——好段落 👍、坏段落 👎。然后让模型把这批点选总结成几条能照着做的写法，写进一份档案。下一轮写稿带着这份档案，写完再点、再总结。它总结出来的东西长这样（我自己的档案）：

## 已验证偏好（作者喜欢什么）
- 让在场群像先静默再爆响
- 危险降临先写器物异动，再写人的闷哼
## 避免的写法（作者不喜欢什么）
- 不要用比喻堆砌来写人群的恐惧
- 不要在施法后补旁白解释动机

这些不是我写的，是我点出来的。每条后面能点「🔍 证据」，看它当年是从哪几段原文里总结的；不认同的直接删掉。

**档案里只有规律，没有原文。**这是这个方法能成立的前提：原文一轮就几千字，带两轮上下文就满了，更别说一本书——带不动的东西，谈不上"持续"。规律是几百字节（我的是 714 字节），每一轮写稿都带得动；而且模型记住的是"怎么写"，不是"这几句长什么样"，前者能迁移到新章节，后者只会被抄。所以它能一轮轮跑下去，越用越对味。

可靠性信号：775 条断言 / 7 个测试文件，每个能力都有真数据用例；发版前请三个独立视角复审，四个高危问题先复现再修。详见「这东西靠谱吗」。

适合谁用 / 不适合谁用

适合：

• 已经在用 DeepSeek Harness（dsh），想让它帮着写小说 / 网文
• 长篇连载作者，需要十几万字不崩的设定与伏笔管理
• 已经有明显个人文风，但说不清自己到底要什么
• 刚开始写、还没形成固定风格 —— 点一轮，同时也是给自己标一次「我喜欢什么」
• 愿意每轮花几分钟点一遍段落，换长期越用越准

不适合：

• 没用过 dsh，也不打算装（本插件依赖 dsh）
• 想让 AI 一键自动生成整本小说
• 想要零投入全自动的

前置条件：Node 22 + DeepSeek Harness。dsh ≥ 0.1.5 在 Node 20 下起 dsh web 会静默退出（不打印、不监听端口），看起来特别像"插件不兼容"，其实是环境问题。

它和别的做法有什么不一样

要让 AI 写出你的味道，常见有四条路。区别不在于谁更聪明，在于你要付出什么：

为什么要做这个

因为原来的两条路都太累。

自己写提示词。"别写那么用力"它听不懂，你得反复调；调好这一次，下次开个新对话又得重来。

逐段给它写评语。 一轮摊开八到十篇候选，每篇两三千字，读完还要说"哪里好"——说不出来，只会觉得"这篇有感觉"。勉强写下的那些"更细腻""节奏不错""有点刻意"，翻译回写作等于没说，第三轮它还是同一个毛病，只是换了个说法。

说到底：**判断很好下，表达很难写。**点一下是一秒钟的事；让你把"我想要什么"讲清楚，你写得动十次，写不动一百次。所以别让你表达，让模型总结。

安装：一行命令

dsh plugin --profile web add dsh-novel-craft

装完重启一次 dsh（宿主半区在启动时装载）。侧栏底部会出现「🎴 抽卡工作台」。

不想装也能先看：把仓库里的 docs/preview.html 用浏览器打开，那是真实组件渲染出来的界面快照，七个页签都能点。

怎么用

一、点它一轮，它就学到一点

选一个放着候选稿的目录（选择器会推荐、记最近、也能浏览，不用记路径），然后读，按键盘：

j/k 换段 · G 标好 · B 标坏 · 空格 取消 · n/p 换篇

读完点「⚗️ 提炼规律」。它把这一批点选总结成条目，你逐条勾选，采纳的才进档案。不勾的不会进去——所以你永远能拦下它总结错的部分。

就这样，一轮一次。你不需要写一句话。

二、写新的一章（候选稿也让模型写）

「🗂 章节」页右上角有个「✍️ 开新章」，四步。

第一步，说清这一章要干什么。 章号、本章设定（目标、必须发生、禁止发生），要几个方向（默认 10 个）。

第二步，挑方向。让它先给一批"场景决策"方向——注意不是换十种形容词，是换怎么讲这个故事：

A 保守精修：以最小改动保留现有骨架，只在细节处收紧
B 配角识货：让同行配角先认出货色，主角的算计藏在他的沉默里
C 双层信息差：让掌柜也在算计，读者比主角先看出一层

方向不顺眼的改名、改说明、取消勾选，剩下的才写。这一步很重要：让它"写十个版本"，你只会拿到十篇形容词不同、决策相同的稿子，挑等于没挑。

第三步，一篇篇写。 每写完一篇立刻落盘（第13章-A-保守精修.txt，沿用你的命名习惯）。看得见"第 3/10 篇"，能中途停，单篇失败只影响那一篇。写完点「🎴 去抽卡选段」，它会顺手把当前卡池切成刚写出来的那个目录——接着就是回到第一步：读、点赞、点踩。

第四步，合并定稿。 你标了赞的段落按稿件顺序列出来，带上你写的那句"为什么用这一段"，成为一张取用段落表。跨篇接不上的地方，它写成 〔此处需过渡〕 标记——不替你补写。那些位置正是"文不文、白不白"的来源，得你自己过。写入正文时原稿自动备份。

三、改稿：它只能改你标过的段落

读到哪儿不对，点那一段按 A 留一条批注（AI 腔 / 啰嗦 / 情绪直给 / 平 / 人物失真 / 逻辑账目 / 信息差 / 其他，外加一句话——注意这里可以写字，因为一处一处指点比逐段写总评省力得多，而且你是在说"这里不对"，不是在解释"我要什么"）。

点「按批注微调」，它只改被批注的那几段。两道防线：

1. 交给模型时只有那几段，它碰不到别的段落；
2. 改完逐字核对，没批注的段落差一个字、或者段落数变了，直接拒绝写回。

采纳前给你逐段前后对照，采纳时原稿先备份。以前那种"点三处、它重写一整章、语感全变了"的事，现在被堵住了。

四、看全局：它在本地算，不喂正文给模型

写到十几万字，"哪里塌了"靠记忆算不出来。「📈 情节」页给你：

• 张力曲线 —— 可以自己点 1–5 标（实线），没标的才用正文估（虚线，每个点都写了估计依据）
• 大纲偏移 —— 这一章该发生的事，在剧情总结里对上了吗
• 伏笔欠账 —— 埋了几条、收了几条、哪条欠太久了
• 字数失衡 / 事件密度 / 评分下滑

还有「🧭 全书」页：立项 → 设定 → 人物 → 大纲 → 逐章正文 → 修订 → 完本，每步该有什么产物、缺了哪样，一目了然，也能一键起草。

那条不能破的线：进写稿上下文的只有规律

这条线是上面"持续学习"的地基，不是洁癖：

• 写稿、写候选、要方向的时候，模型只拿到一个写作包，包里除了上一章结尾（≤900 字，接续必须用，包内注明）之外没有任何正文。
• 你标过的段落、证据摘录、批注，全都留在本地，你随时能回查——但写稿时不读。
• 所以上下文里只有几百字节的规律 + 该有的前情与设定。这就是它能一轮轮带着你的口味跑下去的原因。

但我不想把话说大。有三处你亲手点下的按钮会触发一次辅助调用、带上原文，各有硬上限：

除此之外没有任何路径把正文送进模型。这条我以前写的是"原文不进模型上下文"，属于说大了——"补来源"就会带引文，文案里没写。现在照实写，并把上限都列出来，因为承诺应该能被代码逐行验证。

写作包本身是写稿会话唯一该读的文件，十节：

① 本章任务（你写的）② 作者偏好档案（只有规律）③ 上一章结尾 ④ 前情提要（来自各章剧情总结，不重读正文） ⑤ 本章人物 ⑥ 道具与增益台账 ⑦ 情节节点 ⑧ 未兑现伏笔 ⑨ 禁 AI 腔清单 ⑩ 写作要求

每节都有上限，整包默认 9000 字预算。超了就按"先削补得回来的、后削没它写不了的"顺序削，削了谁、削了多少都写在预算表里。包尾固定列一段「不要读进上下文的东西」，把证据摘录、标注文件、批注、全书合并稿点名列为禁区。

它不做什么

诚实边界，先说清楚：

• 不替你写正文。 它写候选和初稿，选和改是你的——这不是谦虚，是设计前提。
• 不做"AI 通读全书"。 正文不进模型是上面那条线，所以情节体检是本地字符串统计，识别不了"语义上的重复"。
• 不保证平台过审，也没有封面、排版、发布、数据抓取。
• 不替你决定节奏。 张力曲线可以手工标，估计值只是虚线参考。

这东西靠谱吗

775 条断言 / 7 个测试文件，每个能力都有真数据用例（不需要浏览器、不需要起 dsh）。测的是"作者会怎么用它"：微调用例会断言"只有被批注的那一段变了，其余段落逐字相同"，开新章用例会验"写入正文前先备份原稿"。

发版前我请了三个独立视角，把宿主半区、浏览器半区、还有上面那句承诺各查了一遍。四个高危都先复现再修，复现脚本固化成了回归测试：

• 分片请求会把中文正文里的字悄悄变成替换符（实测 4 万字每份 2 个坏字）
• 按住 G 连标时，标注会互相覆盖（实测并发标 5 段只活下来 1 段）
• 手写的偏好档案会被换成空骨架，规律全丢
• 保存路径没校验，../../… 能写到作品目录外面

前两个都不报错，只是悄悄丢东西——这类最该怕，所以现在每个都有测试守着。

更多细节在 DEVELOPMENT.md（改这个仓库前先读）和 Commit 记录里。

常见问题

dsh-novel-craft 是什么？ 一个跑在 DeepSeek Harness（dsh）上的开源 AI 小说写作插件，MIT 协议。核心能力是「偏好校准」：你读候选稿时点 👍/👎，模型把你的点选提炼成几条写作规律，下一轮写稿自动带上，越用越接近你的口味。

我需要先装什么才能用？ Node 22 + DeepSeek Harness。装完插件必须重启一次 dsh（宿主半区在启动时装载）。dsh ≥ 0.1.5 用 Node 20 起 dsh web 会静默退出，看起来很像插件不兼容，其实是环境问题——兼容脚本会自己找 Node 22。

要写提示词吗？ 不用。整个流程里你唯一要做的是点赞和点踩。这是它和"自己调提示词"最大的区别——判断很好下，表达很难写。

它记住的是我的文风吗？怎么做到的？ 记住的是"规律"，不是"句子"。偏好档案里只有规律，没有原文（作者自己那份 714 字节）。因为原文一轮就几千字，带两轮上下文就满了；规律几百字节，每一轮都带得动。而且模型学到的是"怎么写"，能迁移到新章节——学到句子只会被抄。

写稿时它会把我的正文送给模型吗？ 不会。写稿、写候选、要方向时，模型只拿到一个"写作包"，除了上一章结尾（≤900 字）之外没有任何正文。三个例外全是你亲手点下的按钮：提炼规律（≤40 段 × 240 字，总 ≤20KB）、补齐来源（每条 160 字）、按批注微调（每段 800 字 + 前后段各 80 字）。这三个上限写在代码里，可以逐行验证。

和 Sudowrite、NovelAI、LAIKA 这类工具有什么区别？ 那类工具的思路通常是"让 AI 模仿你的文本"——上传风格样本，或微调一个模型。dsh-novel-craft 的思路是"让 AI 学会你的判断"——你只点赞点踩，模型从中提炼出规律。前者学的是句子长什么样，后者学的是怎么写；前者要你准备语料，后者只要你点几下。

中文网文能写吗？英文呢？ 为中文创作场景设计——界面是中文，禁 AI 腔清单针对中文文风。仓库提供英文 README，但清单本身是中文语境的。

写到几十万字会不会崩？ 不会因为上下文爆炸而崩。正文不进模型是硬约束，进上下文的只有规律 + 前情提要（来自各章剧情总结，不重读正文）+ 本章设定，整包默认 9000 字预算，超了按明确顺序削减并记账。诚实说一个限制：情节体检是本地字符串统计，识别不了语义层面的重复。

免费吗？ 插件本身 MIT 开源、免费。调用模型会消耗你 dsh 自己的额度——默认取 dsh 当前默认模型，想省钱可在设置里填 dsh-novel-craft 的 distillProvider / distillModel。

不想装插件能先看效果吗？ 能。用浏览器打开仓库里的 docs/preview.html，那是真实组件渲染的界面快照，七个页签都能点。

我的数据存在哪？ 全在本地，随作品走。标注存在作品自己的 .dsh-novel-craft/ 目录，不写全局配置。

它不能做什么？ 不替你写正文；不做"AI 通读全书"；不保证平台过审；没有封面、排版、发布、数据抓取；不替你决定节奏。

项目成熟度如何？ 2026 年 9 月开源，还很新。可靠性信号：775 条断言 / 7 个测试文件；发版前三个独立视角复审；四个高危问题先复现再修，并固化成回归测试。

兼容性

dsh 是一组各自独立发版的包——同一个公开版本里，CLI 可能是 0.1.5-rc.2 而客户端运行时还是 0.1.1-rc.2。所以本插件不锁版本号，peer 依赖声明为 *，运行时从你的 profile 解析。

实测跑通的：0.1.0-rc.7（作者日常）、0.1.2-rc.1、0.1.5-rc.1（latest）、0.1.5-rc.2（next）、0.1.6-alpha.1。

一条命令自证：

node scripts/check-dsh-compat.mjs next    # 或 latest / alpha / 具体版本号

它会在临时目录里真装一份那个版本的 dsh、按 profile 的方式挂上插件、用独立 DSH_HOME 起服务，断言宿主路由可用、客户端半区进了启动清单、半区能正确下发。跑完自动清理，不影响你正在用的实例。

dsh ≥ 0.1.5 需要 Node 22。用 Node 20 起 dsh web 会静默退出（不打印、不监听端口），看起来特别像"插件不兼容"。兼容脚本会自己找 Node 22，找不到就把启动失败判成环境问题、跳过，而不是报兼容性失败。

两个写给插件作者的坑：行的 apply 可能早于服务挂载（同步 apply 里 ctx.get('webServer') 会是 undefined，本插件因此改成 ctx.inject 等就绪 + 超时兜底）；客户端 bundle 的下发地址变了（新版是组合脚本 /plugins/??a/client.js,b/client.js&rev=…）。

出处与致谢

• 禁 AI 腔六维度清单（skills/novel-writing）改编自 dsh-novel-solo（MIT, Copyright (c) 2026 Tkingxiao）
• 运行平台 DeepSeek Harness（MIT）：用它公开的插槽、客户端服务与 LLM 服务，未复制其源码；辅助模型调用的写法参考了平台内 dsh-session-title-llm 的公开实现
• **"推理档位要关掉"**这条经验来自官方 Discussion #6857——我们在真机上踩过同一个坑：模型想了一堆、正文一个字都没留下
• 包布局约定参考社区集合仓库 linxiecoder/deepseek-harness-plugins，让 dsh plugin add 直接可用

完整条目与许可证原文见 THIRD_PARTY_NOTICES.md。

npm install
npm test        # 7 个文件 775 条断言

dsh-novel-craft-plugin/
├── package.json         # dsh.bundle.patch + dsh.client.platform=web
├── cordis.patch.yml     # 安装时把插件行插进 profile 组合
├── lib/index.js         # 宿主半区：settings + 23 条回环路由 + 模型调用编排
├── lib/client.js        # 浏览器半区：工作台本体（七个页签，无 JSX）
├── lib/core/            # 十个模块，彼此只共享 text.js
│   ├── text.js          #   分段/字数/安全读写/章号解析 + 写队列与原子写
│   ├── workspace.js     #   作品根识别、章节看板、人物卡、轮次目录
│   ├── pack.js          #   写作包 + 上下文预算
│   ├── annotate.js      #   批注读写 + 微调拼装与逐字核对
│   ├── ledger.js        #   台账解析 + 账目体检
│   ├── plot.js          #   张力曲线 + 伏笔欠账 + 情节诊断
│   ├── pipeline.js      #   七阶段定义、产物检查、门禁、起草提示词
│   ├── provenance.js    #   规律 → 证据
│   ├── draft.js         #   开新章：方向、候选、合并、定稿归一化
│   └── llm.js           #   一次性模型调用（六个调用点共用）
├── test/                # 7 个测试文件
├── DEVELOPMENT.md       # 改这个仓库前先读（不进 npm 包）
└── LICENSE, THIRD_PARTY_NOTICES.md