dsh-novel-craft

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

dsh-novel-craft

English: [docs/README.en.md](./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 写出你的味道，常见有四条路。区别不在于谁更聪明，在于你要付出什么：

做法 · 你要付出什么 · AI 学到的是什么 · 能跑几轮

自己写提示词 · 反复调，换个对话还得重来 · 这一轮的指令 · 一次

逐段写评语 · 每轮读 8–10 篇、每篇两三千字，还得说清"哪里好" · 一些形容词 · 一两轮就退化

上传风格样本 / 微调模型 · 准备语料、等训练、结果不可控 · 你的句子长什么样 · 看语料量

dsh-novel-craft · 读的时候顺手点一下 · 你的规律（怎么写） · 一轮轮持续

为什么要做这个

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

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

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

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

---

安装：一行命令

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

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

不想装也能先看：把仓库里的 [docs/preview.html](./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 字，接续必须用，包内注明）之外没有任何正文。
• 你标过的段落、证据摘录、批注，全都留在本地，你随时能回查——但写稿时不读。
• 所以上下文里只有几百字节的规律 + 该有的前情与设定。这就是它能一轮轮带着你的口味跑下去的原因。

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

按钮 · 带进去的 · 上限

提炼规律 · 你点过的段落 · ≤40 段 × 240 字，总 ≤20KB

补齐来源 · 证据摘录里的引文 · 每条 160 字

按批注微调 · 被批注的段落 + 前后段各 80 字 · 每段 800 字，单次 ≤20 条

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

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

① 本章任务（你写的）② 作者偏好档案（只有规律）③ 上一章结尾 ④ 前情提要（来自各章剧情总结，不重读正文）

⑤ 本章人物 ⑥ 道具与增益台账 ⑦ 情节节点 ⑧ 未兑现伏笔 ⑨ 禁 AI 腔清单 ⑩ 写作要求

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

---

它不做什么

诚实边界，先说清楚：

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

---

这东西靠谱吗

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

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

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

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

更多细节在 [DEVELOPMENT.md](./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

…(truncated)