dsh-novel-studio

小说工坊 · dsh-novel-workbench

给 DeepSeek Harness 用的一页式小说创作工作台。

写长篇最难受的不是写不出来，是写着写着人物崩了、伏笔丢了、前文忘了。这个插件不替你写，它做两件事：

• 把这一章需要知道的一切整理好端到你面前（写作包）；
• 读几本你认可的成品书，把它们的写法揉成一套标准，写稿时照着来（成品书库）。

它解决什么

旧做法：每次写新章，翻七八个文件——大纲、人物卡、前几章正文、伏笔清单——翻完上下文也乱了。

这个插件：点一下「开新章」，自动挑出这一章用得上的材料，拼成一份写作包：

近 10 章剧情总结    全文，一条不删
10 章之前           每章一句话
例外：本章要出场的配角在前面出现过 → 把那几章升级成全文
本章大纲            前后各 1 章给全字段
更远的大纲          只在提到相关人物时，带「目标 + 埋」
上一章正文          只取结尾 1400 字（接话用）
人物卡              名字（含别称）出现才读

每次都会告诉你读了什么、省了多少，不是黑盒。

安装

两步都要做：先装包，再把它挂进 profile 的组合层。只做第一步，包装好了但界面里什么都没有。

1. 装包

推荐走 npm（不碰 GitHub，国内配个镜像就能装）：

dsh plugin --profile web add dsh-novel-workbench

连不上 npm、或者想跟最新提交走，就改用 GitHub 源（装出来是同一个包）：

dsh plugin --profile web add github:ShanJun-pro-max/dsh-novel-workbench

`--profile web` 必须写在 `add` 前面。 新版 dsh 把 --profile 定为必填项，而且它属于 plugin 这一层——写成 dsh plugin add --profile web … 会报：

error: required option '--profile <name>' not specified

因为 add 之后的内容会原样转给 pnpm，dsh 自己没读到 --profile。

profile 名怎么选：用 dsh web 就是 web；用桌面版客户端就是 desktop。不确定就看 ~/.dsh/profiles/ 下有哪些目录。

2. 挂进组合

node ./node_modules/dsh-novel-workbench/install.mjs web

脚本只做一件事：把 dsh-novel-workbench 写进 ~/.dsh/profiles/web/package.json 的 dsh.profile.bundles。手动做也行——在那个文件里找到：

"dsh": { "profile": { "bundles": [ "...", "这里加一行 dsh-novel-workbench" ] } }

（这一步别省。dsh plugin add 只把包装进 node_modules，组合层是独立的另一份配置，插件自带的 cordis.patch.yml 靠它才会被应用。）

3. 重启

重启 dsh web，侧栏底部出现「📚 小说工坊」，点开看左侧导航最底部的版本号（最新是 v3.0.5）。

本地开发：

# 改完代码，一条命令走完：体检 → 发 npm → 让 pnpm 拉最新 → 体检安装副本 → 接口冒烟
.\sync.ps1 -Publish

# 只拉最新、不发版
.\sync.ps1

⚠️ 别手动把仓库文件抄进 `~/.dsh/profiles/web/node_modules/dsh-novel-workbench`。

那个目录归 pnpm 管，账记在 node_modules/.modules.yaml 里（含版本号）。手抄进去的文件

一旦版本号变了，安装目录和 pnpm 的账本就对不上，宿主启动时会报

1 entry did not activate → import failed，整个 web 起不来——手抄省两分钟，要用一次

「删插件 + 重装」来还。

更新

# 1. 让它重新解析到最新版（npm 装的就拉最新版本，github 装的就拉最新提交）
dsh plugin --profile web update dsh-novel-workbench

# 2. 重启 dsh web

开工作台看左下角版本号有没有变。（dsh.profile.bundles 里的那一行只需加一次，更新时不用再动。）

⚠️ 重复执行 `add` 是没用的。 对 github: 来源，pnpm 会把解析到的提交写进 pnpm-lock.yaml；

第二次 add 看到 spec 没变，会说 Lockfile is up to date, resolution step is skipped /

Already up to date，然后原样跳过——包还是旧的。必须用 update 才会重新解析。

装了插件市场的话

市场会自己判断有没有新版本：它读你仓库 package.json 的 version，和本地装的比。远端版本号更大 → 已安装列表里出现「更新」按钮，点一下就装。

所以发版时务必改版本号（本项目用 version.ps1）；只推提交不改版本号的话，市场只会标一句「有新提交（未发版）」而不给更新按钮 —— 这是市场的规则，不是插件的问题。

还是旧版本？ 先把依赖清掉再装：

# Windows
rmdir /s /q "%USERPROFILE%\.dsh\profiles\web\node_modules\dsh-novel-workbench"
dsh plugin --profile web update dsh-novel-workbench

从源码装的（file: 方式）更新更简单：

cd /path/to/dsh-novel-workbench
git pull

然后重启 dsh web。

快速开始

1. 准备作品目录

插件按约定找文件。最小结构：

你的小说/
├─ 大纲.md              ← 全书章节骨架
├─ 正文/
│  ├─ 第001章-标题.txt
│  └─ 第002章-标题.txt
└─ 剧情/
   ├─ 第1章 剧情总结.md
   └─ 第2章 剧情总结.md

全部可选，缺什么插件会标红提醒你补。推荐再放：

├─ 设定/
│  ├─ 立项.md
│  ├─ 世界观.md
│  ├─ 人物设定.md
│  ├─ _口径.md          ← 名字表、时间线、写作禁忌
│  └─ 道具与增益台账.md
└─ 人物/
   ├─ 陆铮.json
   └─ 萧烬.json

2. 配置

侧栏 → 小说工坊 → ⚙️ 设置：

字段 · 说明 候选目录 · 抽卡候选稿落点，如 …/作品/.dsh-novel-studio/候选稿/第12章 作品根 · 留空则从候选目录向上自动探测 模型 · 留空用 dsh 当前默认模型

3. 开始用

• 章节 — 看全书进度，点标题编辑，点「📝 总结」一键生成剧情总结
• 候选稿 — 「✍️ 开新章」让模型给写作方向 → 写多篇候选 → 逐段 👍/👎 → 合稿定稿
• 情节 — 张力曲线、伏笔欠账、一致性检查、别称识别
• 偏好档案 — 标过的段落压成可复用的写作规律，按「类型」跨书继承
• 作品分析 — 偏好档案页的这个按钮：灌几本成品书，一键分析后把它们的写法融成一套标准，写进偏好档案供生成时照着写
• 回收站 — 删掉的章节 / 候选稿 / 类型都能找回
• 设定 — 浏览、编辑、新建、归档所有设定文件

核心功能

开新章

① 这一章写什么   → 编辑本章设定（目标 / 禁止发生 / 出场人物 / 要求）
② 方向          → 模型给 3–16 个写法方向，勾选要写的
③ 写候选        → 一次一篇，看得见进度，可随时停
④ 完成          → 去候选稿逐段标 👍/👎

写稿时不会跳页，状态不会丢。

弹窗右侧是「📊 开章体检」（默认展开，可收起）：

块 · 看什么 · 花钱吗 📈 张力曲线 · 第 1 章到上一章的张力和一句该做的动作 · 不花（本地算） 🔍 结构问题 · 只挑和这一章有关的：刚塌陷、全书偏平、上一章字数失衡/大纲对不上 · 不花 🧭 下一章往哪写 · 写作包里已给模型的节奏简报；「🤖 让模型给 3 条走向」可一键填进额外要求 · 点按钮才花 📌 这一章要注意 · 本章设定有没有写目标、有没有写禁止发生、相关欠账、目标字数 · 不花 🧵 还没收的欠账 · 未兑现的埋点，和本章人物有关的排前面 · 不花

剧情总结带索引头

---
chapter: 11
characters: [陆铮, 萧烬, 闫振军, 柯朗]
location: [城东老院子]
planted: [萧烬体质收不住, 闫振军单独留话]
paid: []
---

# 第11章 剧情总结

## 核心剧情点
- ...（正文照旧，怎么写都行）

头上 6 行给机器查，下面照旧给你写。 有了它才能查「李满在第几章退场」。

characters 用规则提取（扫正文里出现的已知角色名），不调模型——比模型准，而且免费。

别称识别

小说里没人一直叫全名。插件会扫出「李哥」「萧先生」这类称呼，并且：

• 共现分析：抓每次出现的前后 50 字，看这段窗口里还出现了谁

「萧总」出现 3 次
  第4章 "小程。""萧总。""我给他那张卡"   附近：萧烬
  第4章 "稍等。""萧总，没有记录。"        附近：萧烬
                                → 推测：萧烬

• 同姓不排除：「萧先生」可能是萧烬也可能是萧宗平，两个都列出来
• 你拍板：机器只给依据，标 ✓ 建议选它 / ⚠ 说不准是谁

采纳后写进角色卡 "别称": ["李哥"]，索引、一致性检查、写作包选人三处都认。

情节体检

检查 · 说明 张力曲线 · 按正文冲突信号估分，标出「中段塌陷」「全程平缓」 伏笔欠账 · 大纲里「埋 / 收」配对，找出该收没收的 一致性 · 总结漏记人、有卡没出场、总结缺索引头（纯规则，不花钱）

偏好档案按类型继承

写完一本兽人小说，建个类型「兽人校园」。下本同类型的书绑同一个类型，自动继承所有偏好规律。

类型库在 ~/.dsh/novel-studio-types/，跨书共用。删错能恢复。