小说工坊 · dsh-novel-workbench
给 DeepSeek Harness 用的一页式小说创作工作台。
写长篇最难受的不是写不出来，是写着写着人物崩了、伏笔丢了、前文忘了。这个插件不替你写，它做的是把「写这一章需要知道的一切」整理好端到你面前。
它解决什么
旧做法：每次写新章，翻七八个文件——大纲、人物卡、前几章正文、伏笔清单——翻完上下文也乱了。
这个插件：点一下「开新章」，自动挑出这一章用得上的材料，拼成一份写作包：
近 10 章剧情总结 全文，一条不删
10 章之前 每章一句话
例外：本章要出场的配角在前面出现过 → 把那几章升级成全文
本章大纲 前后各 1 章给全字段
更远的大纲 只在提到相关人物时，带「目标 + 埋」
上一章正文 只取结尾 1400 字（接话用）
人物卡 名字（含别称）出现才读
每次都会告诉你读了什么、省了多少，不是黑盒。
安装
两步都要做：先装包，再把它挂进 profile 的组合层。只做第一步，包装好了但界面里什么都没有。
1. 装包
dsh plugin --profile web add github:ShanJun-pro-max/dsh-novel-studio
--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，侧栏底部出现「📚 小说工坊」，点开看左侧导航最底部的版本号（最新是 v2.21.2）。
本地开发：
dsh plugin --profile web add file:/path/to/dsh-novel-studio
node /path/to/dsh-novel-studio/install.mjs web
更新
# 1. 让它重新解析仓库的最新提交
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-studio
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 个写法方向，勾选要写的
③ 写候选 → 一次一篇，看得见进度，可随时停
④ 完成 → 去候选稿逐段标 👍/👎
写稿时不会跳页，状态不会丢。
剧情总结带索引头
---
chapter: 11
characters: [陆铮, 萧烬, 闫振军, 柯朗]
location: [城东老院子]
planted: [萧烬体质收不住, 闫振军单独留话]
paid: []
---
# 第11章 剧情总结
## 核心剧情点
- ...（正文照旧，怎么写都行）
头上 6 行给机器查，下面照旧给你写。 有了它才能查「李满在第几章退场」。
characters 用规则提取（扫正文里出现的已知角色名），不调模型——比模型准，而且免费。
别称识别
小说里没人一直叫全名。插件会扫出「李哥」「萧先生」这类称呼，并且：
- 共现分析：抓每次出现的前后 50 字，看这段窗口里还出现了谁
「萧总」出现 3 次
第4章 "小程。""萧总。""我给他那张卡" 附近：萧烬
第4章 "稍等。""萧总，没有记录。" 附近：萧烬
→ 推测：萧烬
- 同姓不排除：「萧先生」可能是萧烬也可能是萧宗平，两个都列出来
- 你拍板：机器只给依据，标
✓ 建议选它 / ⚠ 说不准是谁
采纳后写进角色卡 "别称": ["李哥"]，索引、一致性检查、写作包选人三处都认。
情节体检
| 检查 | 说明 |
|---|
| 张力曲线 | 按正文冲突信号估分，标出「中段塌陷」「全程平缓」 |
| 伏笔欠账 | 大纲里「埋 / 收」配对，找出该收没收的 |
| 一致性 | 总结漏记人、有卡没出场、总结缺索引头（纯规则，不花钱） |
偏好档案按类型继承
写完一本兽人小说，建个类型「兽人校园」。下本同类型的书绑同一个类型，自动继承所有偏好规律。
类型库在 ~/.dsh/novel-studio-types/，跨书共用。删错能恢复。
数据存在哪
| 内容 | 位置 |
|---|
| 章节正文 | <作品>/正文/ |
| 剧情总结 | <作品>/剧情/ |
| 人物卡 | <作品>/人物/*.json |
| 候选稿 | <作品>/.dsh-novel-studio/候选稿/第N章/ |
| 标注 | <作品>/.dsh-novel-studio/候选稿/第N章/.dsh-novel-studio/marks.json |
| 偏好档案 | <作品>/.dsh-novel-studio/作者偏好档案.md |
| 备份 | <作品>/.dsh-novel-studio/备份/ |
| 类型库 | ~/.dsh/novel-studio-types/ |
全部是普通文件，随时能用编辑器打开、能用 Git 管理、能手动改。
安全设计
| 机制 | 说明 |
|---|
| 删除 | 一律先进回收站，可恢复；回收站里再「彻底删」才真删 |
| 覆盖 | 改正文 / 总结 / 设定文件前自动备份到 .dsh-novel-studio/备份/ |
| 未保存 | 改正文没保存就切页面 / 关窗口，会弹确认 |
| 路径 | 只能读写作品目录内的 .md / .txt / .json，越界拒绝 |
| 接口 | 只接受本机回环请求 |
常见问题
入口没出现？
重启 dsh web。还不行就 Ctrl + F5 硬刷新（浏览器会缓存旧 bundle）。
装的时候报 error: required option '--profile <name>' not specified？
把 --profile web 挪到 add 前面：dsh plugin --profile web add github:…。
--profile 属于 plugin 这一层，写在 add 之后会被当成要转给 pnpm 的参数，dsh 自己读不到。
装/更新时报 ERR_PNPM_GIT_RESOLVE_FAILED、Connection was reset？
这一步是 pnpm 在跑 git ls-remote 解析仓库，和插件本身无关——机器连不上 github.com。三选一：
# 1) 先开代理（最常见）
# 2) 只给 git 配代理，端口换成你自己的
git config --global http.https://github.com.proxy http://127.0.0.1:7890
# 3) 有 SSH key 的话走 SSH 传输（pnpm 输出里推荐的那条）
git config --global url."git@github.com:".insteadOf "https://github.com/"
同一屏里那句 git-hosted plugins build on install via their prepare script 是 dsh 的通用提示，
这个包没有 prepare 脚本，忽略即可。
「这个 dsh 没挂 LLM 服务」？
开新章、生成总结、识别别称这些要调模型。在设置里指定模型，或确认 dsh 已有默认模型。
文件明明在，清单却标红？
点那个 ✗，右边有三个选项：手动新建 / 让模型去文件夹里找 / 知道了。
找到后归属关系会记在 .dsh-novel-studio/文件归属.json，以后就认了。
总结里的 HTML 注释是什么？
<!-- dsh-novel-craft:auto:begin --> 那对，是提炼规律时标记自动生成区块用的。别删。
开发
# 语法检查
npm run check
# 装到本地 profile
dsh plugin --profile web add file:$(pwd)
结构：
lib/
├─ index.js 插件入口（注册唯一 RPC 端点 /novel-studio/api/）
├─ client.js 前端（宿主只加载这一个文件，不能拆）
├─ server/
│ ├─ api.js 74 个业务接口
│ ├─ context.js 路径约定、项目识别、配置读写
│ ├─ summary.js 总结提示词、头部解析、输出清洗
│ ├─ distill.js 提炼规律
│ └─ pack-assemble.js 写作包取材策略
└─ core/ 纯逻辑（读文件、合稿、分章、情节分析）
后端只有一个 HTTP 端点，前端用 { a: '动作名' } 分发。加功能只加一个方法。
改完代码必须重启 dsh web 才生效。
功能总览
完整的功能说明、设计思路、数据存放位置、已知限制，见 功能总览.md。
更新日志
每个版本改了什么，见 CHANGELOG.md。
License
MIT
