# 更新日志

版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)：`主版本.次版本.修订号`。

- **主版本**：有破坏性变更（旧数据需要迁移）
- **次版本**：加功能
- **修订号**：只修 bug

发新版时，记得同时改 `package.json` 和界面显示的版本号——用 `.\version.ps1 2.6.0` 一条命令搞定。

---

## [3.0.0] - 2026-10-20

### 改名

**包名 dsh-novel-studio → dsh-novel-workbench**

原因很实在：`dsh-novel-studio` 这个包名在 npm 上**已经被别人占了**（维护者 winterchenhuan，v0.3.0，2026-08-22 发布的一个「创作台」插件）。不光是发不了 npm——更麻烦的是：有人照着旧名字敲 `dsh plugin add dsh-novel-studio`，装上来的是**别人的插件**。

改的是**包名**，不是仓库名（GitHub 仓库还叫 dsh-novel-studio），所以：

| 变 | 不变 |
| --- | --- |
| `package.json` 的 `name` | GitHub 仓库地址 |
| `cordis.patch.yml` 里的 id / name | 作品里的数据目录 `.dsh-novel-studio/`（改了旧稿、指令、归属表全断） |
| `install.mjs` 写进 `dsh.profile.bundles` 的名字 | 侧栏入口、界面、所有功能 |
| `lib/index.js` 导出的 `name`（配置键） |  |
| 安装目录 `node_modules/dsh-novel-workbench` |  |

### 已经装过的人要做的（一次性）

```bash
dsh plugin --profile web remove dsh-novel-studio
dsh plugin --profile web add github:ShanJun-pro-max/dsh-novel-studio
node ./node_modules/dsh-novel-workbench/install.mjs web
```

然后重启 dsh web。**作品目录里的东西一样不动**（候选稿、标注、指令、回收站都在 `.dsh-novel-studio/` 下）；但插件名变了，配置键也变了，工作台里要重新选一次作品目录。

顺带：npm 上 `dsh-novel-workbench` 已确认没有占位（registry 返回 404）。

---
## [2.33.1] - 2026-10-19

### 修复

**关掉面板再打开，还停在回收站视图**

回收站视图的状态是页面级 `showTrash`，关面板时没复位，下次打开就直接进回收站，让人以为指令全没了。

现在三个关闭口（关闭按钮、点遮罩）都会复位，打开按钮也会先置回两栏——**每次打开都从「禁止 / 要做」两栏开始**，回收站要点按钮才进。

---

## [2.33.0] - 2026-10-19

### 新增

**指令也有回收站了**

删指令以前是「删了就没了」，手滑删掉一条好不容易想出来的约束，只能凭记忆重写。现在删除只是挪进回收站：

- 指令面板顶部多一个「🗑 回收站（N）」——里面有货时变橙色，点一下切到回收站视图；
- 回收站里每条都标着它原来在哪一栏（禁止 / 要做），带「恢复」和「✕ 彻底删」；
- 有「清空回收站」，清空前会二次确认；
- 恢复回去立刻重新生效（`on` 也回到启用）。

存哪儿：还是 `指令.json`，多了一个 `trash` 数组，里面留 `deletedAt`（ISO 时间）。出厂那 11 条被删也一样进回收站，「↺ 恢复出厂」不会动回收站。

---

## [2.32.2] - 2026-10-19

### 修复

**指令面板两处不便**

1. **条目多了滑不动**：两栏的列表容器只写了 `overflow: auto`，但高度链条没锁死（父级用的是 `flex: 1` 而不是 `flex: 1 1 0`，行也可能被压扁），内容一多就被弹层的 `overflow: hidden` 裁掉，滚轮没地方滚。现在整条链都改成 `flex: 1 1 0` + `minHeight: 0`，列表显式 `overflowY: auto` + `overscrollBehavior: contain`，每行 `flexShrink: 0`；弹层高度也从 `min(680px, 100%)` 改成 `min(760px, calc(100vh - 40px))`，边距更稳。

2. **加一条时看不全输入的内容**：原来是一行 `<input>`，长句超出就看不见前面打的字。现在换成两行 `<textarea>`：

   - 自动换行，打多长都看得见；
   - **回车提交**，**Shift + 回车换行**（占位提示里写了）。

---

## [2.32.1] - 2026-10-19

### 调整

**加回一条：「不用书面词、雅词」**

回滚到 10 条之后，作者点名要这一条——它是读稿时唯一没争议的毛病（「倾过去」该写「靠过去」）。加回来，但**和「用词挑最普通的」合成一句**，不分两条：

> 不用书面词、雅词：日常口语怎么说就怎么写——写「靠过去」不写「倾过去」，写「问一句」不写「询问」，写「走之前说了句」不写「道别」；动词挑最普通的（看、走、拿、放、说、靠），能具体就不抽象。

分两条写会让模型当成两个任务分别去检查，更容易绕；合成一句，它记住的是「口语怎么说就怎么写」。

现在 11 条（禁止 8 + 要做 3），指令块 490 → 588 字。

---

## [2.32.0] - 2026-10-19

### 回滚

**出厂指令退回最初的 10 条**

从 25 条一路加到 31、32 条，试下来是走反了：规则越细，稿子越僵——为了躲开「不用书面词」就冒出一堆「像是想好了才说」的绕句，为了守「段落 35–45 字」就把句子压得生硬。第13章四版对照里，条数最多的 C/D 反而是作者读着最别扭的两版。

所以回滚：

- 出厂回到最初的 **10 条**（禁止 7 + 要做 3）：不解释动机、情绪不直接命名、不用身体感受代替情节推进、不写总结式收尾、不堆比喻、人称时间线不跳、不复述设定；每段至少一个具体的东西、对白按人分层、段落长短交错。
- 指令块从 1695 字降到 **490 字**（占 prompt 约 5%）。
- 25 / 31 / 32 条那几版的内容不再保留——要用的自己往两栏里加。

结论记在这儿，免得以后又犯：**指令是底线，不是风格指南**。条数一多，模型会拿「遵守条数」代替「把话写顺」。

---

## [2.31.0] - 2026-10-19

### 调整

**指令 31 条 → 32 条：按你读稿后的三条反馈改**

三版对照你看完之后给了三条具体意见，都指向同一个地方——**句子和用词的自然度**，不是结构：

| 你的反馈 | 对应改法 |
| --- | --- |
| C 太生硬、僵直，比如「说得顺了口」 | 新增「句子要念得顺：读着打结的长句必须拆开或改成口语；不写『说完才发觉自己把…说得顺了口』这种自己补一句点评的别扭句」 |
| A 出现莫名其妙的语句（结尾那类） | 「结尾不抒情不点题」扩成「不写要靠猜的象征动作」：段尾和结尾都不写「手指在被子底下掐了一下掌心」这种读者得猜含义的动作 |
| B 用词太正式，倾过去该写成靠过去 | 新增「不用书面词、雅词」，直接拿这组当例子；再新增「用词挑最普通的：看、走、拿、放、说、靠——动词能具体就不抽象」 |

另外新增「不写绕圈的对照句」（「像是…又不是…」这种），并把三组重复的条目合并（对话口语化 + 短句、控制节奏 + 不急爽文、细节饱满 + 写景带人物动作），所以总数只涨 1 条、指令块 1695 字。

---

## [2.30.0] - 2026-10-19

### 调整

**出厂指令 25 条 → 31 条：把 A/B 实测暴露的 6 个缺口补上**

拿第13章做了对照（同一章、同一方向、只差指令开关）：

| 毛病 | 有指令 | 无指令 |
| --- | --- | --- |
| 解释动机 | 1 | **3** |
| 总结式收尾 | 0 | **1** |
| 旁白说教 | 0 | **1** |
| 比喻词 | **4** | 0 |

对照结果说明三件事：解释动机/旁白说教/总结收尾**光靠模型自觉不够**，得写进禁止栏；**明喻没人管就会多**（旧的 25 条里只有「不堆成语」，没有数量上限）；段落长度也得写死。

于是补了 6 条（禁止 10 → 14、要做 15 → 17）：

**禁止栏新增 4 条**

- 不解释动机：不写「他这么做是因为…」「原来是为了…」
- 旁白不说教：不写「他终于懂得」「人总是这样」
- 明喻不超三处：一章之内「像／像是／仿佛／似乎／宛如」最多三次，不连着用
- 结尾不抒情不点题：最后一段不写象征性动作，落到一件具体的事或一句话上就停

**要做栏新增 2 条**

- 段落 35–45 字：一个意思合成一段，不写一句话一行；对白按人换气，一人一段
- 情绪落到具体的东西上：写他手里攥着的东西、桌上吃剩的半瓣橘子、鞋跟敲地的声音

顺手把「不直白点明情绪」的例句加了「他心里发闷」——A 篇就犯了这一处，原来的词表没覆盖到。

指令块 1296 → 1482 字。

---

## [2.29.1] - 2026-10-19

### 修复

**候选稿第一行带 markdown 井号**

模型经常把标题写成 `## 第13章 萧烬出手`，于是候选稿文件的第一行就带着井号。合稿时 `normalizeChapterText` 会洗掉，但候选稿本身、抽卡面板里看着别扭。

`cleanDraftText` 现在只对**首行**去掉行首的 `#`（1–6 个都认），正文里出现的 `#` 不动。

---

## [2.29.0] - 2026-10-19

### 调整

**指令改成「一个按钮 + 左右两栏」**

上一版把 25 条按六个分组平铺在页面上，又长又碎，看着像文档而不是工具。

现在页面上只有一行摘要和**一个按钮**：

```
📌 指令   [要做 15 条]  [禁止 10 条]                     打开指令面板
```

点开是左右两栏（占屏幕八成）：

| ✅ 要 AI 做的 | 🚫 禁止 AI 做的 |
| --- | --- |
| 15 条：人设真实、赋予缺陷、配角独立、间接表达情绪、语言贴合身份、逻辑自洽、细节饱满、风格统一、控制节奏、对话口语化、短句为主、允许废话、文字质朴… | 10 条：摒弃套路、不写全能主角、不靠降智巧合、不直白点明情绪、不直白描写外貌、不用 AI 过渡句、不写总结式收尾、对话不说教、不堆成语、不过度描写 |

两栏各自能勾选 / 删除 / 加一条（各自底部有输入框），改完立刻落盘。

**数据也跟着分侧**：`指令.json` 的条目多了 `side`（`do` / `dont`），老数据没有这个字段时按措辞推断（以「不／禁／杜绝／拒绝／摒弃…」开头的算禁止）。

**提示词里分成两块**，比混在一起数序号清楚：

```
【写作指令（硬约束）】

必须做到：
1. …
禁止出现：
1. …
```

---

## [2.28.0] - 2026-10-19

### 调整

**出厂指令换成 25 条、分六组**

原来那 10 条是我自己按「最常返工」挑的；作者给了一份成体系的版本，覆盖更全，直接换掉：

| 组 | 条数 | 管什么 |
| --- | --- | --- |
| 一、全场景通用 | 5 | 摒弃套路 / 人设真实 / 逻辑自洽 / 细节饱满 / 风格统一 |
| 二·1 人物塑造 | 4 | 赋予缺陷 / 配角独立 / 间接表达情绪 / 语言贴合身份 |
| 二·2 对话描写 | 4 | 真实口语化 / 短句为主 / 允许废话 / 拒绝说教 |
| 二·3 情节与节奏 | 3 | 反烂俗套路 / 合理铺垫 / 控制节奏 |
| 二·4 文笔与叙述 | 4 | 重细节轻抒情 / 感官体验 / 文字质朴 / 拒绝过度描写 |
| 三、避坑禁令 | 5 | AI 过渡句 / 直白外貌 / 主角光环 / 快餐爽文 / 机械情绪 |

**指令列表支持分组**：条目多了以后，编了号的小标题（`〔三、避坑禁令〕`）会把组分开，作者在页面上也能看到分组。

**编号跨组连续**（1–25）而不是每组重数——这样「第 8 条」在作者和模型嘴里指的是同一条。

新加的自定义指令落在「我的补充」组里。

提示词里这一段约 1300 字，占写作包体量的三分之一左右；嫌重可以把不适用于本书的条目停用，停用的不进提示词。

---

## [2.27.0] - 2026-10-19

### 新增

**指令：写稿的硬约束清单**

偏好档案要分析成品小说才长出来，新书一开始是空的——那段时间 AI 全靠默认手感写，最常犯的错（解释动机、情绪直给、用身体感受顶替情节、总结式收尾）没人管。指令就是补这个洞：**不看题材、每一章都必须遵守的清单**，第一次开写就生效。

左栏新增「📌 指令」页：

- 出厂自带 10 条，覆盖最常返工的那几类（不解释动机 / 情绪不直接命名 / 不用心跳加速铺陈 / 不写总结式收尾 / 不堆比喻 / 不复述设定 / 段落长短交错…）；
- 勾选框控制这一条进不进提示词，🗑 删除，输入框「＋ 添加」新增——**改完立刻落盘**，没有「保存」按钮；
- 删多了点「↺ 恢复出厂」拿回那 10 条；
- 「看模型收到的原文」直接显示拼进提示词的那一段，怀疑模型没照做时先看这里。

存哪儿：`<作品>/.dsh-novel-studio/指令.json`（`{ items: [{id, text, on}] }`）。

**拼进提示词的位置很关键**：放在最末尾，紧挨「请写出第N章…」那句，并写明

> 以上指令是作者定的硬约束，优先级高于写作包里的建议与风格说明：**每一条都必须遵守**。与写作包里任何写法冲突时，以这里为准。

写作包三四千字，塞中间会被后面的前情、台账、情节节点冲淡——这和「避免的写法」最后再提醒一遍是同一个道理。

---

## [2.26.1] - 2026-10-19

### 调整

**建卡按钮改叫「✨ 读前文 + 设定生成」**

上一版已经让建卡读设定资料了，但界面文案还停在老话上：说明写「这个人只在前文出现过，没有设定」，按钮叫「分析前文生成」——看着就像它只看正文。

现在：

- 按钮：`✨ 读前文 + 设定生成`（生成中显示「模型在读前文和设定…」）；
- 说明：「模型会读他出场的正文段落，也会查世界观、人物设定、写作口径、细纲这些设定资料，再生成卡片——设定和正文冲突时以设定为准，生成后还能改。」；
- 生成后多一行交代读了什么：`读了第 2、5 章的 6 段，大纲 3 处，设定资料 2 份（设定/世界观.md、细纲.md）共 5 处`（设定里没提到他就写「设定资料里没有提到他」）。

**单个字段的「猜」也读设定了**

不知道「兽族」填什么时，点字段旁的星标——以前只喂正文 + 大纲 + 同书同字段样例，现在同样带上设定资料里提到他的行，并注明「设定比正文权威」。

---

## [2.26.0] - 2026-10-19

### 新增 / 修复

**1. 同一个文件不再在两个类别里重复出现**

症状：`人物设定` 里是 `主要人物列表.json`，展开 `角色卡` 又看到它；更麻烦的是**每张角色卡都出现两次**（角色卡 60 个，实际只有 30 个角色）。

原因：作品里的 `人物/` 往往是指向 `设定/人物/` 的目录链接（junction），两个目录列出的是同一批文件，而清单按路径字符串去重，同一个文件就有了两条不同路径。

现在按**解析后的真实路径**（`realpath`）判断「是不是同一个文件」：列目录时去重、跨类别时也不重复算。实测角色卡 60 → 30，`主要人物列表.json` 只留在「人物设定」里。

**2. 识别出的文件可以勾选，不用整锅端**

以前「🔍 识别」只有「按这个认领」，全都要。现在每条前面有复选框，顶部有「☑ 全选 / ☐ 全不选」，按钮上写着「认领选中的 N 个」。

**3. 模型把同一个文件判给两个类别时，自动取舍**

后出现的重复项会被标成「与「X」重复，跳过」，置灰、默认不勾、也不能勾。一份文件只进一个类别。

**4. 可以把文件拖到别的类别里**

左栏的文件行现在能拖（光标变抓手），拖到任意类别行上松手就改归属，自动从原类别摘掉并归到新类别（服务端新增 `files.move`）。改完会告诉你是从哪挪到哪。

**5. 补角色卡时会读设定资料，不只看正文**

以前建卡只喂「正文里提到他的段落」+「大纲」+ 一张样卡的字段名。现在额外读 `设定/世界观.md`、`设定/人物设定.md`、`人物/主要人物列表.json`、`设定/_口径.md`、`设定/00-原始设定案.md`、`设定/立项.md`、`细纲.md` 里提到这个人的行，并在提示词里写明：**设定比正文更权威**，正文里顺口提的写法与设定冲突时以设定为准。

---

## [2.25.8] - 2026-10-19

### 调整

**「类型回收站」改成居中弹层，按钮上带数量**

以前它是个塞在页面最底下的窄条，点一下才展开，展开后也只有 200px 高——第一次用根本注意不到它存在。

现在：

- 顶部那个按钮会显示数量（`♻ 类型回收站（2）`），**里面有东西时变成橙色**，一眼能看出有没有待处理的；
- 打开后是居中弹层（和「新建文件」「目录选择」一样的样式），标题栏写清「N 个」，列表更高、更好点；
- 弹层里补了一句说明：「删掉的类型整个放在这里（含它的全部内容），能恢复，也能彻底删」；
- 空的时候也不再只写一个「空的」，改成「还没有删过类型」。

打开偏好档案页时会静默读一次清单，所以按钮上的数字一进来就是准的（读不到就当作空，不弹错误）。

---

## [2.25.7] - 2026-10-19

### 调整

**设置页的「版本 / 检查更新」整块去掉了**

那个「🔍 检查更新」按钮查的是 GitHub，网络稍差就只回一句「检查失败：Error」，既没用也难看。而且作者决定走插件市场更新——市场本来就会提示新版本并负责安装，插件再自查一遍是重复的。

一起去掉的还有：

- 左下角版本号下面的橙色「新版本 vX」小标；
- 点小标弹出的那个更新面板（一键更新 / 复制命令）；
- 服务端 `update.check` / `update.apply`，以及只为它存在的 `lib/server/net.js`（走代理发请求的那套）。

**保留的是版本号**：左侧导航最底部仍然显示 `v2.25.7`，一眼能看出装的是哪一版。

---

## [2.25.6] - 2026-10-19

### 新增

**回收站里多了「设定文件」一栏**

上一版加了删除键，删掉的文件只能自己翻 `.dsh-novel-studio/回收站/设定文件/` 去找，看着像「删了就没了」。

现在回收站页面是三栏：**设定文件 / 候选稿 / 正文**。设定文件那一栏能看到文件、看到它原来在哪个路径、能「查看 / 恢复 / 彻底删」。

恢复是**原路返回**：删的时候会在 `回收站/设定文件/索引.json` 里记下原相对路径，恢复时按它放回去（`人物/佟佳华.json` 就回 `人物/佟佳华.json`），不是靠文件名猜。原位置如果已经有同名文件会拒绝并提示，不覆盖。

「清空回收站」也会一并清掉这一栏。

实测：

```
删 1 = 细纲.md
删 2 = 人物/佟佳华.json
回收站条目 = 佟佳华.json ⇐ 人物/佟佳华.json | 细纲.md ⇐ 细纲.md
恢复 = 人物/佟佳华.json | 文件存在 = true
```

---

## [2.25.5] - 2026-10-19

### 新增

**设定文件能删了**

文件编辑区以前只有「✎ 编辑 / 关闭」，建错了（比如手滑建个空的 细纲.md）没法撤。

现在多一个「🗑 删除」：

- 先弹确认，写清去向；
- 不是物理删除——文件移到 `<作品>/.dsh-novel-studio/回收站/设定文件/`，文件名前面带时间戳（`2026-10-19T12-11-12 细纲.md`），随时能手动拿回来；
- 顺手把它从「文件归属.json」里摘掉，免得清单继续指着一个不存在的路径。

实测：绑过归属再删，删完该项回到 ✗、其他文件为空、回收站里能看到那个文件。

---

## [2.25.4] - 2026-10-19

### 修复

**点了一个缺文件的项之后，点别的项都换不出来**

先点「细纲」（缺文件）→ 右边弹出「✗ 还没有「细纲」」。这时再点左边任何一个**有文件**的项（大纲、立项…），右边还死死停在那个「还没有」面板上，看上去就是"点了没反应、加载不出来"。

原因：那个面板由 `missingKey` 控制，而只有缺文件的项才会改它；点已有项时只展开了类别，`missingKey` 一直没清。上一版只补了「文件建好后自动消失」，没覆盖「点了别的项」。

现在三处都会清掉它：

- 点任意一个**有文件**的项：清掉并展开，**顺带打开它的第一个文件**（点类别就是要看内容，不用再点一次）；
- 点任意一个文件（含「其他文件」里的）；
- 新建成功、打开新文件时。

---

## [2.25.3] - 2026-10-19

### 修复

**「识别」永远认不出细纲/项目说明/原始设定案**

识别是把文件名丢给模型、让模型回一个类别 key。可那段提示词里**写死了八个类别**——后来清单加到 11 项，模型却根本不知道有「细纲」「项目说明」「原始设定案」这三项，于是这三个永远认不出来，`沉星_总大纲.md`、`第一卷细纲.md` 只能一直躺在「其他文件」里。

现在提示词按 `CHECK_SPEC` 生成：清单加一项，识别跟着加；顺带把每一项的默认路径和备选路径也写进去（"大纲一般叫 大纲.md，也可能叫 设定/大纲.md…"），并补了一条名字规则——带「总大纲/全书大纲」算大纲，带「细纲/分卷」算细纲。

**认领完看不出变化**

以前保存后只弹一句「已认领 N 个文件」，左边清单的类别是折叠的，看上去跟没动一样。现在：

- 保存后自动把认领到的类别**展开**，文件直接列出来；
- toast 写清对应关系，例如「已认领 2 个：大纲 ← 沉星_总大纲.md；细纲 ← 第一卷细纲.md」。

---

## [2.25.2] - 2026-10-19

### 调整

**「新建文件 → 放在哪儿」不再只有四个选项**

以前写死 根目录 / 设定 / 人物 / 剧情（上一版加了 细纲），想建在 `设定/人物/` 或者自己开的 `细纲/第一卷/` 里就没门。

现在打开对话框时读一次磁盘，把作品里**真实存在的目录**都列出来（两层深度），排序稳定；末尾还有一个「其它目录…（自己填）」，填相对路径即可，目录不存在会自动建。

服务端的限制也一起放开：以前只接受那四个目录，现在只要在作品目录内部、不是隐藏目录（含插件自己的 `.dsh-novel-studio`）就行。归档/备份这类下划线开头的目录不出现在选项里。

---

## [2.25.1] - 2026-10-19

### 修复

**缺「细纲」时点「＋ 现在建一个」，会建出一个空目录**

多文件项的默认位置是个目录（`细纲/`），而作者真正要的是根目录下那个 `细纲.md`。点「现在建一个」会把 `dir` 填成 `细纲`、文件名空着，等于让你手动补。

现在每一项都带 `createHint`，缺项时直接预填正确位置：

- 细纲 → 根目录 `细纲.md`
- 角色卡 → `人物/`，文件名留给你填
- 剧情总结 → `剧情/`，文件名留给你填

单文件项还是按默认路径填，行为不变。

---

## [2.25.0] - 2026-10-19

### 新增

**清单里加了「细纲」**

分卷/分章细纲以前只能躺在「其他文件」里没人认。现在有独立一项，而且是**按文件名认**的：只要名字里带「细纲」，放在根目录、`设定/`、`细纲/` 都算数，几卷就几个文件，全都列出来。

「新建」对话框的目录选项也加了 `细纲/（分卷细纲）`。

### 修复

**大纲放在 `设定/` 里就认不出来**

以前每个单文件项只认一个固定路径（`大纲.md` 必须在根目录）。可作者的习惯差别很大——把大纲放进 `设定/` 完全合理。现在每一项都有一组备选路径，按顺序找，谁在就用谁：

| 项 | 默认 | 也认 |
| --- | --- | --- |
| 大纲 | `大纲.md` | `设定/大纲.md`、`设定/00-大纲.md`、`设定/全书大纲.md` |
| 立项 | `设定/立项.md` | `立项.md`、`设定/设定案.md` |
| 世界观 | `设定/世界观.md` | `世界观.md`、`设定/世界观设定.md`、`设定/世界观设定集.md` |
| 人物设定 | `设定/人物设定.md` | `人物设定.md`、`设定/人物.md`、`设定/人物总表.md` |
| 写作口径 | `设定/_口径.md` | `设定/口径.md`、`口径.md`、`设定/写作口径.md` |
| 道具与台账 | `设定/道具与增益台账.md` | `设定/道具与台账.md`、`道具与增益台账.md` |
| 角色卡 | `人物/` | `设定/人物/`（没有做目录链接的作品也能认） |

归属表里手工绑过的路径仍然优先，备选路径只是兜底。

**「✗ 还没有「大纲」」和左边的 ✓ 自相矛盾**

右边那个「还没有…」面板是点缺文件项时打开的，但打开后不会自己收。你点完之后文件被绑定好了、左边变成 ✓，右边还挂着一句「还没有」——因为判断里没再查一次「它现在还缺吗」。现在补上了：文件一旦就位，这个面板立刻消失。

---

## [2.24.2] - 2026-10-19

### 调整（投稿插件市场前的准备）

**peerDependencies 精简成真实依赖**

以前声明了 `@deepseek-ai/cordis`、`@deepseek-ai/schemastery`、`@deepseek-ai/dsh-llm` 三个。核对代码后：

- `@deepseek-ai/cordis` 一行都没 import —— 删掉；
- `@deepseek-ai/schemastery` 只用于 `lib/index.js` 的配置 schema，宿主提供，标成 `optional`（可选 peer 不会被 pnpm 自动安装，也就不会引发 ERESOLVE）；
- `@deepseek-ai/dsh-llm` 是动态 import（`lib/core/llm.js`，失败可降级），保持 `optional`。

效果：别人 `dsh plugin add` 时不会再看到 `Issues with peer dependencies found`。

**给仓库加了 `dsh-plugin` topic**（投稿市场的硬要求之一）。

**投稿条目已备好**：`awesome-dsh-plugin` 的 `data/plugins/ShanJun-pro-max__dsh-novel-studio.yml`，分类 `workflow`，中英双描述。仓库创建时间未满 24 小时，等达标后再开 PR。

---

## [2.24.1] - 2026-10-19

### 修复

**查到的「最新版本」会慢半拍**

v2.24.0 是从 `raw.githubusercontent.com` 读版本的。raw 走 CDN 边缓存，刚发完版那几分钟不同边缘节点回的还不一样 —— 实测同一个 URL，一条路拿到 2.23.2、另一条路拿到 2.24.0。

现在先走 **GitHub API** 的 `contents/package.json`（响应头 `cache-control` 只缓存 60 秒），拿不到才退回 raw。

**设置页的「检查更新」绕过缓存**

自动自查缓存 6 小时，点「🔍 检查更新」时带 `force: true` 强制重查 —— 刚发完版想看结果不用等缓存过期。

**Windows 上「一键更新」直接失败**

`dsh` 在 Windows 上是 `dsh.cmd`，`spawn` 直接起会 `EINVAL`。改成借 `cmd.exe /c dsh …` 起。

实测（真跑了一次）：退出码 0，pnpm 输出回显正常，8.9 秒装完，插件文件被真正替换。

---

## [2.24.0] - 2026-10-19

### 新增

**左侧导航底部：有新版就亮橙色小标，点一下就能更新**

插件市场不知道这个插件更新了（它不在市场里），所以改成插件自己查：

- 打开工作台 1.5 秒后，悄悄去 GitHub 读一次 `main` 分支的 `package.json`，比版本号；
- 有新版本 → 版本号下面出现橙色 `新版本 vX.Y.Z`；
- 点它 → 弹层里写清「当前 vA → 最新 vB」，两个按钮：
  - **⬆ 一键更新**：后端跑 `dsh plugin --profile <你正在用的 profile> add github:ShanJun-pro-max/dsh-novel-studio`，把 pnpm 输出的最后 12 行回显出来；
  - **📋 复制命令**：自动更新失败（比如文件被占用）时，复制命令自己到终端跑。
- 更完提示「重启 dsh web 才生效」。查询结果缓存 6 小时，失败一律静默 —— 没网的时候插件照常能用。

**设置页加「🔍 检查更新」**

有些网络环境下橙色小标不会出现，得能查原因。设置页底部现在有「版本」一节，点一下就告诉你：已经是最新 / 有新版本 vX / 查不到（附原因）。

**为什么要自己实现一个联网小工具**

`raw.githubusercontent.com` 在国内经常直连不通，而机器上的代理往往只写在 npm（`npm_config_proxy`）或 git 配置里，Node 的 `fetch` 不会自动用。

新增 `lib/server/net.js`：先从一组环境变量（`HTTPS_PROXY` / `ALL_PROXY` / `npm_config_proxy` …）里找代理，找到就走 HTTP CONNECT 隧道 + TLS 自己发请求（含 chunked 解码），找不到才退回 `fetch`。实测本机：直连失败 292ms，走代理 563ms 拿到版本号。

---

## [2.23.2] - 2026-10-19

### 修复

**「↓ 下一级」永远是灰的，按不动**

上一版把它接在「前进」语义上：只有在历史里往后退过，才有「前进」。可「↑ 上一级」每次都把当前位置当作新的一格追加进历史，所以**你永远不可能退回去**，前进自然一直不可用。

改成两个按钮各记各的：

- `↑ 上一级` 时，把**现在待的这一层**压进一个栈，然后上去；
- `↓ 下一级` 从栈里弹一层，跳回去；
- 走别的路（点「进入」、手打路径、浏览…）就清空这个栈 —— 免得跳去一个跟当前无关的地方。

顺带：在盘符根（`D:\`）时 `parent` 是空串，原来按「↑ 上一级」会跳到默认起始目录；现在这种情况下按钮直接置灰。

---

## [2.23.1] - 2026-10-19

### 精简

**目录选择框的按钮砍到三个**

上一版那一行挤了「前往 / ↑ 上一级 / ← / → / 📂 浏览…」五个按钮，又乱又重复：

- 「前往」跟回车是同一个动作 —— 删掉，输入框里按回车就跳（占位提示已经写了）；
- 「← 后退」和「↑ 上一级」功能重叠 —— 删掉「←」；
- 「→ 前进」改成 **「↓ 下一级」**，意思更直白：按了「↑ 上一级」之后，用它在原地回到刚才那一层。

现在是：`[路径输入框]  ↑ 上一级  ↓ 下一级  📂 浏览…`

---

## [2.23.0] - 2026-10-19

### 新增

**「📂 浏览…」：弹系统的文件夹选择窗口**

目录选择框里点这个按钮，会打开操作系统自己的「选择文件夹」对话框，一路点进去挑，选完自动跳到那个目录。

| 平台 | 做法 |
| --- | --- |
| Windows | PowerShell 起 `FolderBrowserDialog`（必须 `-STA`） |
| macOS | `osascript` 的 `choose folder` |
| Linux | 不支持，提示直接粘贴路径 |

几个实现细节：

- 脚本用 `-EncodedCommand`（UTF-16LE + base64）传过去，中文标题不会被控制台编码搞坏；
- 挂了一个 `TopMost` 的隐藏 owner 窗体，减少「对话框开在浏览器后面」的概率；
- 用户点取消返回 `canceled:true`，不报错；
- 后端最多等 5 分钟，超时就杀掉进程当取消 —— 不让 HTTP 请求永远挂着；
- 真的起不来（比如没有窗口会话）时，把 stderr 前 300 字带回来，界面提示「没打开选择窗口：…」，路径输入框照样能用。

---

## [2.22.0] - 2026-10-19

### 新增

**目录选择框：可以手打路径，也能前进 / 后退**

「选择作品根 / 候选目录」那个框以前只有「自动扫出来的位置」+ 一层层点文件夹 + 一个「↑ 上一级」，既不能自己填路径，翻上去之后也回不来。

现在路径那一行是**可编辑的输入框**：

- 直接粘贴绝对路径，回车（或点「前往」）跳过去；
- `↑ 上一级` 到上一层，**并记进历史**；
- `←` 后退、`→` 前进 —— 翻上来之后一键回去，不用再一层层点下去。

历史存在 ref 里（不进渲染状态），快速连点也不会读到过期的位置。

---

## [2.21.3] - 2026-10-19

### 修复

**别人装不上：README 里的命令少写了 `--profile`**

有人照 README 敲：

```bash
dsh plugin add github:ShanJun-pro-max/dsh-novel-studio
# error: required option '--profile <name>' not specified
```

新版 dsh 把 `--profile` 定为必填，而且它属于 `plugin` 这一层——`add` 后面的一切都会原样转给 pnpm，dsh 自己读不到。正确写法（`dsh plugin --help` 的示例也是这个顺序）：

```bash
dsh plugin --profile web add github:ShanJun-pro-max/dsh-novel-studio
```

README 四处命令全部改正，并补进「常见问题」。

**装完包，界面里却什么都没有**

`dsh plugin add` 只把包装进 profile 的 `node_modules`；插件自带的 `cordis.patch.yml`（往 UI 插侧栏入口的那一层）要等包名出现在 profile `package.json` 的 **`dsh.profile.bundles`** 里才会被应用。这一步以前只在我自己机器上做过，别人的 profile 里是空的。

新增 `install.mjs`：把包名写进 `dsh.profile.bundles`，可重复执行（已存在就跳过），并先检查包是否真的装了。

```bash
node ./node_modules/dsh-novel-studio/install.mjs web
```

README 的安装改成「装包 → 挂进组合 → 重启」三步。

---

## [2.21.2] - 2026-10-19

### 修复

**合稿定稿后，正文里「不见了」**

合稿写入**还没有正文的新章**时，文件名生成漏了「第」：

```
写成：正文/012章-未命名.txt      ← chapterNumberOf 认不出来
应为：正文/第012章-论坛事件升级.txt
```

`chapterNumberOf` 只认「第N章」或 `chNN`，所以那个文件既不进章节表、也读不到；下次合稿还会再写一遍同名文件。现在按作者的既有习惯命名：`第` + 三位章号 + `-` + 章标题。

**Markdown 标题行把标题吞了**

候选稿首段常写成 `## 第12章 论坛事件升级`。`normalizeChapterText` 的标题正则 `^第N章` 匹配不上带井号的行，于是标题为空、井号行原样留在正文里，文件名退化成「未命名」。

现在先剥掉 `#{1,6}` 再判断，并且支持连着几行标题（`第12章` 下一行又跟 `## 第12章 xxx`），取第一个非空标题。

### 调整

**合稿只认勾选，不再回退「👍 即选中」**

以前 `picks.json` 不存在时会拿 👍 当选中，等于把「标了好」和「这段要用」混在一起。作者要的是：**勾选 = 进合稿的材料，👍/👎 = 只喂偏好档案**。

现在只读 `picks.json`；一章没勾过就明确报「这一章还没有勾选任何段落：先在候选稿里勾上要进合稿的段（左边那个方框）」，不再猜。

**文案跟着改**

- 合稿确认框：「把第N章里**勾选**的段落按顺序拼起来，写入正文？勾选＝这一段进合稿；👍/👎 只影响偏好档案，不参与合稿。」
- 合稿完成 toast 报出文件名的「新建 / 写入」与前后备份情况。
- 删除确认框按章列出「第11章 9 篇 · 第12章 11 篇 · 第13章 8 篇」，全选按钮显示「全选全部（N）」——全选是跨章生效的，别再让人以为只清当前这一章。

---

## [2.21.1] - 2026-10-19

### 修复

**「📂 目录」在 Windows 上可能只打开文件夹、不选中文件**

`explorer.exe` 对参数的引号很挑。原来把 `/select,` 和路径拼成一个字符串，Node 再按空格自动加引号，结果是 `"/select,C:\path with space\file"`，explorer 有时整串当目录处理。

改成两个独立参数 `['/select,', 路径]`，这是各家 npm 包（open-file-explorer 等）通用的写法。

---

## [2.21.0] - 2026-10-19

### 新增

**复制按钮 —— 一键把整篇拷走**

候选稿工具栏和正文编辑区工具栏都加了「📋 复制」：

- 候选稿：把这一篇的所有段落按顺序拼起来（段间空行）整段复制；
- 正文：复制当前这一章的全文。

GUI 走 `navigator.clipboard`（`127.0.0.1` 算安全上下文）；桌面版是 `file://`、拿不到剪贴板 API，退回隐藏 `textarea` + `execCommand('copy')` 的老办法。两条路都不通报错，不会静默失败。

**打开文件所在地**

「📂 目录」调用新增的后端方法 `path.reveal`，在系统的文件管理器里选中这个文件：

| 平台 | 命令 |
| --- | --- |
| Windows | `explorer.exe /select,<路径>` |
| macOS | `open -R <路径>` |
| Linux | `xdg-open <所在目录>` |

只允许作品目录内部的路径（`resolve` 后必须落在作品根之下），不给它变成「打开任意文件」的口子；文件不存在直接报错；系统没打开就把路径回传，界面提示用户手抄。

---

## [2.20.2] - 2026-10-19

### 调整

**「顶 / 底」从浮动按钮改成工具栏按钮**

v2.20.1 是「藏起来，鼠标靠近才浮现」，但浮出来的位置还是压在段尾的 👍/👎 上——想点按钮就得先压过它，还是挡。

现在干脆不浮了，直接放进工具栏：

- 候选稿阅读区：`☑ 全勾本篇 / ☐ 全不勾 / 清空 / ⤒ 顶 / ⤓ 底 / 📕 合稿定稿`
- 正文编辑区：`← 返回 … ⤒ 顶 / ⤓ 底 / 保存`

工具栏是本来就有的那一行，不再有任何东西盖在正文上。

**正文编辑区也能一键到顶 / 到底**

正文是 `<textarea>`，给它挂个 `ref`：`⤒ 顶` 把 `scrollTop` 置 0，`⤓ 底` 置 `scrollHeight`。长章节改到一半想回开头，不用再狂滚鼠标。

---

## [2.20.1] - 2026-10-19

### 调整

**「顶 / 底」按钮改成鼠标靠过去才浮现**

v2.20.0 里它常驻在阅读区右下角，正好压在段尾的 👍/👎 上面，点不到也看着碍事。

现在平时完全隐藏（`opacity: 0` + `pointerEvents: none`，所以不抢点击），鼠标移到阅读区右下角那一小片区域才淡入；鼠标移开阅读区就消失。

回归顶部 / 到底部两个功能本身不变。

---

## [2.20.0] - 2026-10-19

### 新增

**候选稿批量勾选**

删除候选稿以前只能一篇一篇勾。现在多了两层全选：

- 每章标题前的方框 —— 一次选中这一章的全部候选稿；
- 列表底部「全选 / 取消全选」—— 选中全书所有候选稿。

删的仍然是「移进回收站」，能恢复。全选是「按当前列表」算的，不会把别章的漏掉或多选。

**阅读区一键到顶 / 到底**

候选稿动辄上万字，滚到一半想回开头很费劲。阅读区右上角加了「顶 / 底」两个小按钮，一个到全文开头，一个到最末尾。

### 修复

**换一篇候选稿，还停在上次的滚动位置**

阅读器只有一套滚动容器，切换候选稿时没有重置滚动，于是「打开第 12 章滚到底 → 再打开第 13 章」会直接停在第 13 章的末尾。现在换稿自动回到顶部。

**点工作台外面收起，再点开就又回到章节页了，写稿也断了**

根因是外壳 `Shell` 在收起时 `return null`，把整个 `Studio` 卸载掉：页面状态、开着的候选稿、正在跑的写稿循环全部归零。写稿循环是前端一轮一轮调接口的，组件一卸载，进度条和后续轮次就没了。

现在收起只把外层 `display: none`，组件始终挂着，状态留在内存里；第一次打开之前仍然不渲染，不额外发请求。

---

## [2.19.0] - 2026-10-19

### 改名

**状态目录 `.dsh-novel-craft` → `.dsh-novel-studio`**

插件早先是从 `dsh-novel-craft` 改过来的，但作品目录里那个状态文件夹一直还叫旧名——新建的作品也在用旧名。这次一起改掉：

| 位置 | 旧名 | 新名 |
| --- | --- | --- |
| 作品状态目录 | `<作品>/.dsh-novel-craft/` | `<作品>/.dsh-novel-studio/` |
| 用户级类型库 | `~/.dsh/novel-craft-types/` | `~/.dsh/novel-studio-types/` |

**老作品不用手动迁移。** 读取路径时按「新名 → 旧名 → 新名」的顺序探测：新目录在就用新目录；新目录不在、旧目录在，就继续用旧目录。所以你现有的候选稿、备份、回收站、文件归属表、偏好档案、标注全都照旧能读能用，不用动任何文件夹。

**这两处故意没改**，改了会坏：

- `<!-- dsh-novel-craft:auto:begin -->` / `end` 这对标记——改了就认不出老档案里已生成的自动区块，会重复追加；
- 客户端里清理旧版说明行的 `dsh-novel-craft` 检测——改了就清不掉老版本留下的说明行。

### 修复

- `lib/core/workspace.js` 用了 `existsSync` 却没 import（`node --check` 只查语法，不报这个；运行时探测状态目录才会炸），补上。
- 因为上面这条，`stateDirOf` 的旧目录回落逻辑其实走不到——修完才真正生效。

---

## [2.18.0] - 2026-10-19

### 修复

**「其他文件」里塞了一堆其实已经归位的文件**

你的项目实测：

```
其他文件 4个
  大纲.md        根目录    ← 和 设定/00-大纲.md 是硬链接
  说明.md        根目录    ← 项目说明，确实没归位
  人物设定.md    设定      ← 已绑进「人物设定」，但清单漏了
  立项.md        设定      ← 归属表错绑到 00-原始设定案.md
```

四个问题，四种原因：

**① 立项绑错了文件**

`文件归属.json` 里写着 `"立项": ["设定/00-原始设定案.md"]`——那是 40KB 的原始设定案，真正的立项是 10KB 的 `设定/立项.md`。

**② 硬链接被当成两个文件**

`根目录/大纲.md` 和 `设定/00-大纲.md` 是同一个文件的硬链接，路径不同但内容相同。原来只按**路径**去重，所以硬链接那条漏到「其他文件」。

现在加了**内容指纹**（大小 + 前 200 字），硬链接、复制出来的副本都会认出来：

```js
const mark = (full, bytes) => coveredMark.set(String(bytes), { full, sig: null })
// 惰性算签名：只在遇到同大小文件时才去读，省 IO
```

**③ 多文件类只标记了第一个**

```js
files: list.map(...)          // 展示用，全列
for (const f of list) mark()  // ← 原来没有这一行
```

归属表里绑了两个文件时（`人物/主要人物列表.json` + `设定/人物设定.md`），只有第一个进了 covered，第二个漏到「其他文件」。现在归属表里**绑了几个就标记几个**。

**④ 「说明.md」没有对应的类别**

`CHECK_SPEC` 里加了两项：

| 类别 | 默认路径 | 说明 |
| --- | --- | --- |
| 项目说明 | `说明.md` | 作品结构、目录约定 |
| 原始设定案 | `设定/00-原始设定案.md` | 最初完整的设定稿 |

### 结果

修正后的清单：

```
✓ 大纲        ✓ 立项        ✓ 世界观      ✓ 人物设定
✓ 写作口径    ✓ 道具与台账   ✓ 项目说明    ✓ 原始设定案
✓ 角色卡(31)  ✓ 剧情总结(11)

其他文件：（空）
```

---

## [2.17.2] - 2026-10-19

### 修复

**「识别」把角色卡当成了待认领的文件**

场景：新建了 `人物/小程.json`，点「🔍 识别」，弹窗说「认出 1 个：角色卡 ← 小程.json」。

**它本来就是角色卡，不该被送去让模型分类。**

原因在 `files.scan` 的 known 集合：

```js
for (const spec of CHECK_SPEC) {
  if (spec.multi !== true) known.add(spec.def)   // 只把「单文件类」的默认路径存进去
}
```

多文件类（角色卡、剧情总结）的 `def` 是**目录**（`人物`、`剧情`），不是文件路径，所以没进 known。`人物/小程.json` 一比对不在里面，就被当成新文件了。

改法：多文件类的目录整个跳过——

```js
const knownDirs = []   // 人物/ 剧情/
...
if (knownDirs.some((kd) => low.startsWith(kd + '/'))) continue
```

**顺带处理目录链接**

你的项目里 `人物` 是 `设定/人物` 的目录链接，同一个文件会以两条路径出现：

```
人物/小程.json        ← 从链接进
设定/人物/小程.json   ← 从真实目录进
```

只认 `人物/` 前缀的话，第二条还是会被当候选。现在两种情况都跳过：

```js
if (low.startsWith(kd + '/')) return true                    // 人物/xxx
if (low.startsWith('设定/' + kd + '/')) return true          // 设定/人物/xxx
```

---

## [2.17.1] - 2026-10-19

### 改进

**档案编辑区加了常驻保存按钮**

原来保存按钮在页面最右上角，而档案正文往往几千字——想保存得先滚回去。

现在路径条右侧直接放一个：

```
C:\Users\...\作者偏好档案.md        [未保存]  [💾 保存档案]
                ↑ 有改动才出现      ↑ 没改动时是灰的
```

- 有未保存改动时按钮变蓝、旁边出现黄色「未保存」
- 没改动时按钮置灰，点不动
- 用同一个 `save()`（带去重和自动备份）

**报告按钮文案更明确**

`追加到偏好档案` → `📥 追加到档案`，配合悬停提示「把这份报告写进偏好档案（直接落盘）」，避免误以为只是加进编辑框。

---

## [2.17.0] - 2026-10-19

### 修复（数据丢失）

**先追加小说分析、再提炼规律，前面追加的内容会消失**

两条写档案的路径行为不一致：

| 操作 | 原来的做法 |
| --- | --- |
| ✨ 提炼规律 | 后端 `distill.apply`：**读文件 → 合并 → 写回** |
| 追加到偏好档案 | 前端 `setText(旧 + 新)`：**只改编辑框，文件没动** |

于是：

```
① 追加小说分析  → 编辑框有，文件没有
② 点提炼规律    → 后端读文件（不含分析）→ 合并规律 → 写回
③ load() 刷新   → 编辑框被后端内容覆盖，分析没了
```

**新接口 `profile.append`**

追加操作也改成走后端落盘：

```
读文件 → 去重检查 → 覆盖前备份 → 拼接 → 写回 → 前端重新加载
```

- 同一段内容已在档案里就跳过，不重复加
- 覆盖前自动备份到 `.dsh-novel-craft/备份/`
- 追加后提示「已写进档案（N 字）」

**未保存改动有提醒**

编辑框里有没保存的改动时点追加，会先问：

> 编辑框里有还没保存的改动。继续追加会用磁盘上的档案覆盖这些改动，确定吗？

因为追加后要重新加载文件内容，编辑框里的未保存修改会被冲掉。

---

## [2.16.4] - 2026-10-19

### 改进

**任务行支持双击打开 / 收起**

不用再瞄准右边那个小按钮了——双击整行任意位置就能切换：

```
文字文稿1.docx  [70块] [扫0] [读0] [无报告] [打开] [✕]
                    ↑ 双击这里也行
```

- 整行 `cursor: pointer`，鼠标移上去变手型
- 悬停提示「双击打开」/「双击收起」
- 文件名 `userSelect: none`，双击不会误选文字

按钮照旧可以点，两种方式都行。

---

## [2.16.3] - 2026-10-19

### 修复

**同一本小说，txt 版比 docx 版多出 26 万字**

实测：

| 文件 | 字数 | 开头 |
| --- | --- | --- |
| `20191110083945593.txt` | 663353 | `����TXT����http://www.wxia.net` |
| `文字文稿1.docx` | 404314 | `温叙长得相貌堂堂，名校出身…` |

**txt 是 GBK 编码，被按 UTF-8 读了**——网文中转站打包的 txt 基本都是 GBK。一个汉字变成 2–3 个 `�`，字数虚高 64%，内容全是乱码，模型读不出任何东西。

现在 `decodeText` 会先探测：

```
1. 按 UTF-8 解码，统计替换字符 U+FFFD 比例和中文占比
2. 乱码 < 1% 且中文 > 5% → 就是 UTF-8，直接用
3. 否则依次试 GB18030、GBK，哪个乱码更少、中文更多就用哪个
4. 都不行退回 UTF-8
```

用 `TextDecoder`（Node 自带 ICU 支持），**不引入任何依赖**。

### 注意

旧任务的原文已经写成乱码了，改代码救不回来——需要重新上传。

---

## [2.16.2] - 2026-10-19

### 修复

**任务列表每行的标签数量不一样，看着像 bug**

原来是按条件显示：

```jsx
t.scanned > 0  ? <Chip>扫{t.scanned}</Chip>  : null
t.digested > 0 ? <Chip>读{t.digested}</Chip> : null
t.hasReport    ? <Chip>有报告</Chip>        : null
```

刚上传的只有「70块」，跑完全程的是「113块 扫49 读9 有报告」——**两行对不齐**。

现在四个标签**固定显示**，没跑到的用灰色半透明（`opacity: 0.45`）：

```
文字文稿1.docx      [70块] [扫0] [读0] [无报告]   [打开] [✕]
                    ↑ 灰    ↑ 灰   ↑ 灰
20191110083945593   [113块] [扫49] [读9] [有报告]  [打开] [✕]
                    ↑ 绿     ↑ 蓝   ↑ 绿
```

扫过变绿、精读过变蓝、有报告变绿，一眼就能看出每条任务走到哪一步。

**顺带给 `Chip` 组件加了 `style` 参数**——它原来只接受 `tone` / `children` / `title`，传 `style` 会被静默忽略。

---

## [2.16.1] - 2026-10-19

### 修复

**跑完一步，任务面板就自己收起来了**

v2.16.0 把 `openTask` 改成了 toggle。但**粗扫、精读、汇总这三处跑完都会调它刷新数据**——而此时任务本来就开着，toggle 一看「已经打开了」就当成「再点一次该收起」，于是每跑完一步面板自动关闭。

拆成两个函数：

| 函数 | 用途 | 行为 |
| --- | --- | --- |
| `reloadTask(id)` | 内部刷新 | **强制打开**，刷新数据 |
| `openTask(id)` | 任务行按钮 | toggle，开着就收 |

三处内部调用全部改用 `reloadTask`：

```
scanAll     跑完粗扫 → reloadTask   ← 保持展开
digestAll   跑完精读 → reloadTask   ← 保持展开
summarize   跑完汇总 → reloadTask   ← 保持展开
按钮点击        → openTask         ← toggle
```

现在：选完文件面板展开 → 跑粗扫、精读、汇总全程保持展开 → 只有点「收起」才收。

---

## [2.16.0] - 2026-10-19

### 改进

**任务行的「打开」变成开关**

之前「打开」只能打开，想收起得另找地方。现在它是 toggle：

| 状态 | 按钮 | 点击 |
| --- | --- | --- |
| 任务收起 | 白底 `打开` | 展开「判定理由 + 这本书的写法」 |
| 任务展开 | **绿底绿字加粗** `收起` | 收回去 |

```
20191110083945593.txt  [113块] [扫49] [读9] [有报告] [收起] [✕]
                                    ↑ 绿色，点一下收回去
```

展开状态的颜色和「✓ 已精读」「剧情总结齐全」同一套绿。

### 说明

前面几版我一直以为问题是内部那个「展开 49 块的判定理由」，改来改去（`useState` → `useRef` → `<details>` → 修 `<summary>` 位置）都没解决——因为要的不是那个。

现在对齐了：**外层任务行的「打开/收起」控制整个详情区**，内部的判定折叠保持原样。

---

## [2.15.6] - 2026-10-19

### 修复

**`<details>` 展开后收不回去**

上一版把 CSS 写成了 `<details>` 的第一个子元素：

```jsx
<details className="ns-verdicts">
  <style>...</style>        ← 抢了 summary 的位置
  <summary>展开…</summary>
  <div>列表</div>
</details>
```

**HTML 规范要求 `<summary>` 必须是 `<details>` 的第一个子元素**，否则浏览器不把它当折叠标题，整个开合机制就失效了——表现就是「点得开、收不回」。

改成用 `Fragment` 包一层，把 `<style>` 挪到 `<details>` 外面：

```jsx
<>
  <style>...</style>
  <details className="ns-verdicts">
    <summary>展开…</summary>     ← 又回到第一个子元素
    <div>列表</div>
  </details>
</>
```

顺带把 CSS 选择器从 `.ns-verdicts summary` 改成 `.ns-verdicts>summary`（直接子元素），避免深层误匹配；`summary` 加 `display: block`，让它整行都可点。

---

## [2.15.5] - 2026-10-19

### 修复

**判定理由「只能开、不能收，按钮也不变绿」**

用 `useState` 控制展开状态，但 `LearnPanel` 每次父组件重渲染都会重新执行函数体。虽然组件引用是稳定的，但点击后触发的重渲染把状态绕了一圈，实际表现就是：

- 点一次 → 展开了
- 再点 → 没有收起
- 颜色 → 始终是初始的灰色

试过 `useRef` + `forceTick` 也不行——重挂时 ref 同样重置。

**改成原生 `<details>` / `<summary>`**，开合完全交给浏览器，不经过 React 状态：

```jsx
<details className="ns-verdicts">
  <summary>展开　49 块的判定理由</summary>
  <div>...列表...</div>
</details>
```

颜色靠 CSS 的 `[open]` 属性选择器（内联样式表达不了选择器，所以注入一段 style）：

```css
.ns-verdicts summary::before{content:"▸\00a0\00a0";}
.ns-verdicts[open] summary::before{content:"▾\00a0\00a0";}
.ns-verdicts[open] summary{
  background: rgba(52,199,89,0.14);
  border-color: #34c759;
  color: #34c759;
  font-weight: 600;
}
```

现在：

| 状态 | 表现 |
| --- | --- |
| 收起（默认） | `▸ 展开　49 块的判定理由` 白底灰边 |
| 展开 | `▾ 展开　49 块的判定理由` **绿底绿边绿字加粗** |

点一次展开、点一次收起，箭头和颜色都跟着变。

---

## [2.15.4] - 2026-10-19

### 改进

**判定理由改回默认收起，展开时按钮变绿**

上一版改成默认展开，理解错了——要的是「默认收起，点开拓展开、再点收起」，而且**展开时按钮要有醒目的颜色**。

现在：

| 状态 | 按钮 |
| --- | --- |
| 收起（默认） | 白底灰边 · `▸ 展开　49 块的判定理由` |
| 展开 | **绿底绿边绿字加粗** · `▾ 收起　49 块的判定理由` |

绿色用的是 `#34c759`，和「✓ 已精读」「剧情总结齐全」同一套，视觉统一。

---

## [2.15.3] - 2026-10-19

### 改进

**判定理由默认展开**

之前默认收起，要手动点「▸ 查看 49 块的判定理由」才展开。用户反馈「收起后就找不到了」——干脆默认摊开：

- 默认 `showVerdicts: true`，打开任务就能看见判定
- 按钮文案改成 `<▾ 收起 / ▸ 展开>　N 块的判定理由`，一眼知道当前什么状态
- 列表高度 200 → 260，一次多看几条

点一次收起、再点一次展开，行为不变。

---

## [2.15.2] - 2026-10-19

### 修复

**「查看判定理由」掉到最底下，还点不开**

两个原因叠在一起：

1. **档案页根容器没有滚动** —— 它是 `height: 100%` 的 flex 列，但没有 `overflow`。内容一长就溢出，只能靠内部元素各自滚，外面完全够不着。
2. **判定区块排在报告后面** —— 报告本身 320px 高，把判定按钮推到了视口之外。

改法：

- 根容器加 `overflowY: auto`，整页可以整体滚动
- 判定按钮**挪到报告上方**（步骤条之后立刻就是它），随时点得到
- 报告高度 320 → 180，给判定区块腾位置
- 删掉下面那个重复的判定区块

---

## [2.15.1] - 2026-10-19

### 修复

**粗扫永远扫不完，卡在第一步出不去**

前端用「已判定条数」当下一批的起点：

```js
let from = task.verdicts.filter((v) => v.decided).length   // ← 错
```

模型一批请求 40 块，可能只回 30 条判定。于是：

```
扫了 0-39，回了 30 条  →  from 算成 30
下一批又扫 30-69       →  30-39 重复扫
回了 25 条            →  from 算成 55
下一批又扫 55-94       →  重复更多
```

**永远追不上总块数**，循环停不下来。

改成按**已扫过的最大序号 + 1** 推进，并加了两道保护：

- 循环轮数上限（`ceil(total/10) + 5`），超了就停下、保留已扫结果
- 某一批 `to` 没有前进就停，提示「再点一次会从断点继续」

**后端也修了同一类问题**

`learn.scan` 原来按 `from + batchSize` 返回下一批起点，模型少回几条，那几块就被**永久跳过**。改成只推进到「这一批真正拿到判定的最后一块」，没判到的下一批重来。另外返回 `scanned`（累计已判定数）便于前端显示真实进度。

**精读不再死等粗扫 100%**

以前要求 `decidedCount >= 总块数` 才解锁第二步。现在只要有 ≥1 块被判为重要，就能开始精读——扫不完也能干活。

### 移除

- 工具条上的「🧹 清理旧说明」按钮。旧档案已经手工清理过了，留着多余。

---

## [2.15.0] - 2026-10-19

### 新增

**偏好档案保存时自动合并重复条目**

档案里经常有这种情况——两批提炼出来的规律在说同一件事：

```
- 用连续小动作写忍痛：停、挪、扶、垫
- 用连贯小动作写隐忍，让疼痛藏在动作停顿里    ← 说的是同一件事
```

现在「保存档案」会自动合并，只动 `## 小节` 下的 `- 条目`，标题、引用块、正文段落一概不碰。

保存后提示：

```
已保存，并合并了 1 条重复：用连贯小动作写隐忍，让疼痛藏在动作停顿里
```

覆盖前自动备份到 `.dsh-novel-craft/备份/`，合并错了还能找回。

**🧹 清理旧说明**

旧版本（dsh-novel-craft 时期）的档案开头会留几行插件说明：

```
> 由 dsh-novel-craft 抽卡工作台自动汇总：...
> 原文证据在「证据摘录.md」...
> 自动块（begin / end 之间）每次提炼重写...
> 候选目录：D:\...
<!-- dsh-novel-craft:auto:begin -->
- 标注：127 段（👍 127 / 👎 0）
<!-- dsh-novel-craft:auto:end -->
```

这些不是你的内容，只是历史遗留。工具条新增「🧹 清理旧说明」，一键去掉所有含旧插件名的引用行和自动块注释，改完点保存生效。

### 改进

**去重判得更准**

原来的双字滑窗只能抓字面重复，「连续小动作」vs「连贯小动作」这种抓不到。加了同义字归一表：

```
连续 ⇄ 连贯    隐忍 ⇄ 忍痛    表象 ⇄ 表面
铺陈 ⇄ 展开    直接 ⇄ 直给
```

并把重复阈值从 55% 降到 45%。

实测那段真实档案：

```
原文 8 条 → 保留 7 条，删 1 条
  ✕ 用连贯小动作写隐忍，让疼痛藏在动作停顿里
```

**已知限制**：语义相同但用词完全不同的（「让旁人只看见表象，用一句判断带出破绽」vs「让旁人只凭观察起疑，当事人用平常话挡回去」）——前半句几乎一样、后半句完全不同，字面判重抓不到，只能靠人工合并。

---

## [2.14.3] - 2026-10-19

### 修复

**上传的任务删不掉**

后端 `learn.delete` 早就写好了，前端一直没接按钮——任务列表只有「打开」，用过的书只能堆着。

现在：

- 每行末尾加 **✕**，删单个（弹确认：会连切块、判定、精读结果、报告一起删）
- 标题行加 **🗑 清空全部**，一次清干净（同样确认）
- 标题显示任务总数：「以往的任务（2）」
- 超过 8 个时提示「还有 N 个任务没显示（用「清空全部」一起删）」

---

## [2.14.2] - 2026-10-19

### 修复

**粗扫判定太松，50/52 块全被判为「重要」**

实测一本书 113 块，判定 52 块、其中 50 块要精读——96%。等于没有筛选，精读成本失控，而且大量块在提炼同一种写法。

三处一起收紧：

**① 粗扫：从「找值得的」改成「默认跳过」**

```
默认跳过。只有同时满足两条才 keep：
1. 这一段里有「别的段落身上学不到的写法」
2. 看得出具体的手法，不是笼统的「写得好」

一律跳过：过渡、赶路、吃饭、睡觉、闲聊；和别处写法雷同的段落
（同样的手法出现第二次就不算新东西）；只推进剧情没有亮点的；景物铺陈。

最多挑出 20%。挑不够也没关系，宁可少不可多。
```

**② 精读：PREFER+AVOID 从 9 条降到 6 条**

并加了一条硬约束：

> 只写这一段**独有**的手法。不确定这是不是这本书的普遍写法，就别写——后面会汇总，重复的会被去掉。

**③ 汇总：同一件事只留一条**

```
- 用 8-15 条（原来 8-20）
- 同一件事只留一条：多段都在说「短句推进」，合并成一句更精确的，不要写成两条
- 宁可少而准，不要多而水
```

### 代码层强制去重

提示词说了不等于模型照做——实测它嘴上答应「只留一条」，还是会写出「短句推进」和「用短句推进」两条。所以加了一层机械兜底：

**双字滑窗比字面重合度**（中文没空格，不能按空格分词；和 `core/plot.js` 抽大纲关键词是同一个思路）：

```
「短句推进节奏」  → 短句/句推/推进/进节/节奏
「用短句推进节奏」→ 用短/短句/句推/推进/进节/节奏
              重合 5/5 = 100%  →  判重复，丢掉
```

重合度 ≥ 55% 就当同一件事。全停用词的条目退化成整串相等判断。

单块精读和汇总报告**两层都去重**。

实测：

```
PREFER 原文 3 条（含 1 条重复）→ 去重后 2 条
AVOID  原文 2 条（完全相同）    → 去重后 1 条
```

**已知限制**：语义相同但用词完全不同的（「对话不单独成行」vs「对话要独立成段」）字面去不掉，只能靠提示词约束。

---

## [2.14.1] - 2026-10-19

### 改进

**三个按钮白成一片，不知道下一步该点哪个**

粗扫 / 精读 / 汇总原来都是同一个白底按钮样式，做完一步之后看不出来该往哪走。改成步骤条：

```
[✓ ① 粗扫挑重要块]  [▸ ② 精读 47 块]  [○ ③ 汇总成报告]
   绿色打勾做完了      蓝色高亮该点这个    灰色还没轮到
```

- **▸ 蓝色实心** —— 现在该点这个
- **✓ 绿色描边** —— 这一步已经做完了
- **○ 灰色半透明** —— 还轮不到，点不了

状态是推导出来的，不是记的：粗扫全判完了就变绿；有重要的块没精读过，② 就是蓝的；精读完 ③ 变蓝。

**报告被挤到最下面，滚不上去**

页面上依次是：任务列表 → 步骤条 → 60 条判定理由 → 报告。报告在最底下，得滚过一大片才看得到，而且 `maxHeight` 一截就没法整段读。

调成：

- 判定理由**默认收起**，变成一行「▸ 查看 113 块的判定理由」，点开才展开（限高 200，最多 60 条）
- 报告挪到步骤条正下方，边框改成主题色描边，一眼能找到
- 报告区独立滚动（`maxHeight: 320`），不跟整页抢

现在的顺序是：任务 → **步骤条 → 报告** → 折叠的判定理由。

---

## [2.14.0] - 2026-10-19

### 新增

**从成品小说学习**

偏好档案以前只能从你标的 👍👎 里提炼（127 条标注只出 9 条规律）。现在可以传一整本别人的小说，分析它的写法。

**四步流程**

```
上传 .txt / .md / .docx / .epub
  ↓ 自动切块（按章节标题切，切不出来按 8000 字硬切）
① 粗扫 —— 每块只给开头 200 字 + 结尾 100 字，模型判断「值不值得精读」
  ↓ 只挑 10–25% 的块（每个「重要」判定都带理由，你能看见）
② 精读 —— 重要块全文喂进去，提炼这一段的写作手法
  ↓ 每块产出 STYLE / STRENGTH / PREFER / AVOID
③ 汇总 —— 归纳成「风格 / 水准 / 可复用规律 / 避坑」四段报告
  ↓
[追加到偏好档案] —— 一键写进档案，和标 👍👎 提炼的结果合并在一起
```

**为什么分两阶段**：20 万字一次塞给模型，它只记得开头和结尾。粗扫一次只花 300 字/块，但决定了哪些块值得花大价钱精读——「给的内容多」和「每个字真被读到」才能同时成立。

**报告长这样**

```
## 风格
- 段落 3–4 句，对话不单独成行
- 少用形容词，靠动作

## 水准
- 强在打斗节奏，短句推进快
- 弱在场景过渡常硬切

## 可复用规律
- 伤痛先写醒来的钝感，再写翻身试探
- 忍到极限只写一个抓紧又松开

## 避坑
- 不用「然而」「就在这时」
```

### 文件解析（零依赖）

`package.json` 依然没有任何 dependencies：

- `.txt` / `.md` —— 直读，去 BOM、统一换行
- `.docx` —— 用 Node 内置 `zlib.inflateRawSync` 解 zip，提取 `word/document.xml`，去 XML 标签、还原实体
- `.epub` —— 同样解 zip，按 `container.xml` → `opf` → `spine` 的顺序拼章节

不引入 `mammoth` / `jszip` / `adm-zip`，安装不会变慢，也不会因为某个库装不上而整包失败。

### 接口

| 接口 | 作用 |
| --- | --- |
| `learn.import` | 上传（base64）→ 解析 → 切块 → 落盘 |
| `learn.scan` | 粗扫一批块（默认 40 块/次，可断点续扫） |
| `learn.digest` | 精读一块 |
| `learn.summarize` | 汇总成报告 |
| `learn.list` / `learn.get` / `learn.delete` | 任务管理 |

任务存在 `~/.dsh/novel-learn/<任务号>/`：全书原文、每块单独存、扫描判定、精读结果、报告。**中途停下不会丢进度。**

### 修复

- `learn.delete` 一开始用 `statSafe` 判断目录是否存在——它对**目录**永远返回 `exists:false`，于是删不掉任务。改用 `readdir` 探测。
- 解析器的分节正则（`parseDigest` / `parseSummaryReport`）在「懒惰匹配 + 多行标志」下会吞掉整段，只解析出第一条。改成按行扫描——找到 key 行就开始收集 `- ` 行，遇到下一个 key 停。

---

## [2.13.0] - 2026-10-19

### 新增

**写作包里带上「本书节奏现状」**

情节体检发现的「中段塌陷」「全程平缓」，以前只有你自己在情节页看得到。模型写新章时完全不知道前面写得平不平，于是每章都从一个理想状态开始，接着平。

现在 `packFor` 会算一遍张力曲线，把结论写进包的第 ⑫ 节：

```
## ⑫ 本书节奏现状（写之前先看一眼）

- 全书还没有一章张力到 4（最高 3 分）。读者容易觉得「一直在铺垫」，
  这一章挑最该爆的那个点明显加码。
- 最近章节张力：第6章 2分，第7章 2分，第8章 2分，第9章 2分，第10章 3分，第11章 2分
```

**三条规则**（纯规则生成，不调模型）：

| 条件 | 提示 |
| --- | --- |
| 最近三章平均 ≤ 2 | 「别再靠对话和铺垫推进——安排一个当场就炸的冲突，或者让某个一直在忍的人翻脸」 |
| 最近三章平均 ≥ 3.5 | 「可以稍微缓一口气，但别彻底松掉，留个钩子」 |
| 全书最高 ≤ 3（且已写 10 章以上） | 「读者容易觉得一直在铺垫，这一章挑最该爆的点明显加码」 |

最后一行总是列出最近 6 章的分数，让它自己看得见趋势。

### 修复

- 算张力时必须喂**带正文的 chapters**。一开始传的是 `readWorkspace` 的章节列表（只有路径没有内容），结果每章都估成 1 分，简报就变成「最近三章 1/1/1」，误导模型。改用 `plotInputs` 的数据后，第 6–9 章 2 分、第 10 章 3 分，和情节页显示的一致。

---

## [2.12.0] - 2026-10-19

### 新增

**单个字段也能让模型猜**

「兽族」不知道写什么、「职业」想不出来——以前只能整张卡重新生成，别的字段也跟着被覆盖。现在每个字段标题旁多了一个 **✨**：

```
兽族  ✨  ✕
[                          ]
```

点一下，模型只猜这一个字段，猜出来直接填进去。再点一次可以换一个答案；不想要就改掉或者点 ✕ 删字段。

**它怎么猜**

材料三样，和整卡生成一样，但更聚焦：

1. 这个角色出现过的段落（最多 4 章，每章 2 段）
2. 大纲里提到他的行
3. **同书其他角色这个字段是怎么填的** —— 这条是关键，保证全书风格一致（别人都是兽人，就不会给他填「人类」）

**提示词里的规矩**

> 材料里有依据就照实说；没有依据但同书其他角色这个字段有规律，就按规律给一个合理的值。只输出值本身，不要解释，不要引号，一个词或短语（不超过 20 字）。完全没线索时，给一个最普通、不抢戏的设定。

### 接口

- `people.fieldGuess` — 猜单个字段，返回 `{ value }`，`maxTokens: 200`

参数校验都测过：

```
空角色名    → 要指定角色名
空字段名    → 要指定字段名
正文没这人  → 正文里找不到「张不存在」，没法猜
没挂模型    → 这个 dsh 没挂 LLM 服务，这一步要模型
```

---

## [2.11.1] - 2026-10-19

### 修复

**人物卡字段写死成兽人小说专用的了。**

建卡弹窗原来固定 5 个字段：姓名 / 身份 / **兽族** / **境界** / 剧情重要性。这个插件不只服务兽人小说——写都市、悬疑、仙侠的时候「兽族」毫无意义。

改成**字段由内容决定**：

- **模型生成**时让它自己判断这本书需要哪些字段：
  > 字段由你按这本书的类型自己定，不要套固定模板。兽人小说可能要「兽族」，仙侠要「境界」，都市可能要「职业」「年龄」，悬疑可能要写「可疑之处」。只保留对这部书有用、能防止前后写矛盾的字段，4–7 个为宜。
- **照已有卡对齐**：这本书已经有别的卡，就把那些字段名给它，保持全书一致。
- **前端动态渲染**：卡片对象里有什么字段就渲染什么，不再预设。多行字段（备注/说明/外形/背景）自动用 textarea。
- **可增删**：底部有「＋ 添加字段」，每个字段标题旁有「✕」可删。

给模型看的样例也改了：以前把一整张卡塞进去，现在只给字段名列表——省 token，也避免它照着抄别人的设定。

---

## [2.11.0] - 2026-10-19

### 新增

**没卡的角色，可以一键建卡了**

`consistency.check` 那条「无卡角色」提示下面，现在每个名字都挂着按钮：

```
ℹ 提示  无卡角色
这些人在剧情总结里反复出现，但没有角色卡：小程、小叶、赵琪琪

[✚ 小程] [✚ 小叶] [✚ 赵琪琪]
```

点进去弹窗，两种填法：

- **✨ 分析前文生成** —— 模型读这个人出场过的所有段落 + 大纲里提到他的行 + 一张已有卡当格式样例，生成草稿
- **手动填** —— 姓名 / 身份 / 兽族 / 境界 / 剧情重要性 / 备注

生成后**字段可改**，确认了再保存。弹窗会告诉你「读了第 4、7 章的 3 段，大纲 2 处」。

**关键约束**（写进提示词）：

- 只写材料里能看出来的，看不出来的字段留空，**不许编**
- 「备注」专写容易忘的点：怎么称呼他、和谁有关系、有什么特征

### 接口

- `people.cardDraft` — 给一个没卡的角色生成草稿（不写盘）
- `people.cardSave` — 写入 `人物/<名字>.json`，覆盖前自动备份
- `consistency.check` 现在额外返回 `names`（无卡角色名单），并在 issue 上带 `names`

### 安全

- 已有卡的角色拒绝生成草稿
- 正文里一次都没出现过的人拒绝（没法凭空造卡）
- 写入前校验 `card` 必须是对象
- 覆盖已有文件前备份到 `.dsh-novel-craft/备份/`

实测拒绝路径：

```
给已有卡的陆铮建卡   → 已经有这个角色的卡了
给「张不存在」建卡   → 正文里找不到，没法凭空造一张卡
card 传 null/字符串/数组/数字 → 卡片内容不合法
没挂模型             → 这个 dsh 没挂 LLM 服务，这一步要模型
```

---

## [2.10.1] - 2026-10-19

### 修复

**字号设置存进去了，界面却没变。**

`state` 接口有两个返回分支：没有项目时返回一个空骨架，有项目时返回完整数据。我在两个分支里都加了 `readFontSize` / `uiScale` 吗——**只加在了空骨架那个**。正常使用时走的是有项目的分支，前端从那里读不到字段，于是一直用默认值。

配置文件里明明写着 `readFontSize: 15`、`uiScale: 1.1`，界面纹丝不动。

两个分支现在都返回了。

---

## [2.10.0] - 2026-10-19

### 改进

**勾选框重画**

原生 `<input type="checkbox">` 在深色背景上是一块突兀的方框，勾上后还会带系统默认的蓝。改成自绘的 15×15 圆角小方块：未勾是细边框空心，勾上填充主题蓝并显示 ✓，0.12 秒过渡。

**字号可调**

设置页新增两块：

- **阅读字号** —— 小 / 标准 / 大 / 特大 / 巨大（12 / 13.5 / 15 / 17 / 19 px）
  作用于候选稿段落和正文编辑区。点一下即保存，不用点「保存配置」。
- **界面缩放** —— 标准 / 110% / 120% / 135%
  整体放大导航和那些 10–11px 的说明文字，用 CSS `zoom` 实现，改完立即生效。

配置项：`readFontSize`、`uiScale`。`config.save` 会校验范围（字号 9–28，缩放 0.8–1.6），传超范围的值直接忽略。

---

## [2.9.0] - 2026-10-19

### 新增

**「这句写得好」和「这段我要用」拆成两件事**

以前 👍 一个动作管两件事：喂偏好档案 + 进合稿。但一句漂亮话可能来自一个你根本不选它做本章的候选稿——标注和取材本来就该分开。

现在每段前面多了一个 **☐ 勾选框**：

| 操作 | 管什么 |
| --- | --- |
| ☐ 勾选 | **只决定进不进合稿** |
| 👍 / 👎 | **只决定喂不喂偏好档案** |

- 左侧竖条颜色区分：**蓝** = 已勾进合稿，**绿** = 标了好，**红** = 标了不好
- 「全选本篇 / 清空本篇」改成 **「☑ 全勾本篇 / ☐ 全不勾」**，管的是勾选而不是标注
- 勾选状态存在候选目录的 `.dsh-novel-craft/picks.json`，和 `marks.json` 互不干扰

**老数据不用迁移**：`picks.json` 不存在时，自动退回「👍 即进合稿」，第 11 章那 127 段标好的照旧能合。

### 接口

- `draft.pick` — 勾/取消一段进合稿
- `draft.pickAll` — 一篇候选稿全勾或全不勾

---

## [2.8.0] - 2026-10-19

### 修复（最重要的一个）

**按需取材策略从来没生效过。**

`packFor` 直接调 `buildPack`，把所有章节总结和全部大纲节点一股脑塞进去；我在 `pack-assemble.js` 里写的 `assemblePack`（近 10 章全文 / 早期只给要点 / 配角回查升级 / 大纲窗口）**是一次都没被调用过的死代码**。

现在 `packFor` 真正走 `assemblePack` 了。实测第 12 章的包：

```
近 10 章剧情总结   全文 10 章
第 1 章            因配角回查升级成全文
大纲               近窗 3 个 + 相关回查 8 个（共 120）
人物卡             9 / 29（名字或别称出现才读）
```

### 新增

**写作包里带上情节体检的结论**

- **⑧ 未兑现的伏笔**：从大纲「埋/收」里算出还欠着的，只放和本章人物相关的、或已经欠了 10 章以上的，最多 12 条。这一节以前一直是空的，因为调用方没传 `debts`。
- **⑪ 还没建卡的角色**：在剧情总结里出现过、人物卡里却没有的人。附一句提醒：「先从已有章节里找出他们的身份、外形、说话方式，保持一致；没写过的细节不要凭空定，模糊带过。」

实测第 12 章：伏笔 12 条（全书共 206 条）、无卡角色 3 个（小叶、赵琪琪、小程）。

**伏笔碎片清洗**

大纲里「埋：」后面常是整句，解析器按标点切开会留下碎片（`脖子上的浅旧疤（来历不明` / `他自己说不上来）`）。现在过滤掉括号不配对、以标点开头、不足 5 字的碎片。

### 接口

- `pack.preview` — 预览写作包：返回字数、读了哪些章节/大纲/人物，可选返回全文。不调模型。

---

## [2.7.5] - 2026-10-19

### 修复

- **「选择候选目录」时扫描结果点不了**：扫描出来的几乎都是「作品根」，而选择器只在类型完全匹配（`kind === 想要的类型`）时才显示「用这个」，于是三本书全摆在那儿，一个都点不了。
- 现在选候选目录时，点作品根会**自动推导**到它下面的 `候选稿/第{下一章}章`，按钮文字改成「用它的候选目录」，选完提示选了哪本的哪一章。

新接口 `dir.candidateOf`：给一个作品根，返回它的候选目录和下一章号（只推导，不保存）。

实测：

```
烈虎擒龙  → 已有 10 章 → 候选目录 …\候选稿\第11章
当前书    → 已有 11 章 → …\候选稿\第12章
非作品目录 → 拒绝
```

---

## [2.7.4] - 2026-10-19

### 修复

- **刷新点了像没反应**：按钮确实重新读了盘，但文件没变时界面当然一样，所以看不出来。现在每处刷新都有反馈：
  - 顶栏：按钮变「↻ 读取中…」，完成后提示「已重新读取：11 章 · 3.2 万字」
  - 回收站：「回收站已重新读取：N 项」
  - 设定： 「已重新读取设定文件清单」
- **顶栏刷新管不到独立页面**：顶栏刷新只更新全局 `state`，在回收站或设定页点它不会重读那两页自己的数据。现在顶栏刷新会广播事件，回收站和设定页收到后一起重读。

（情节页没接广播——它会重新分析全书，几秒钟，不该被顺手触发。）

---

## [2.7.3] - 2026-10-19

### 修复

排查了全插件的「改了看不到变化」问题，补齐缺的刷新入口：

| 页面 | 之前 | 现在 |
| --- | --- | --- |
| 章节 | 有 ↻ 刷新 | 加了强制清缓存，真能读到新字数 |
| 候选稿 | 靠顶部刷新 | 靠顶部刷新 |
| 回收站 | **没有刷新** | 底部加了「↻ 刷新」 |
| 情节 | 卡片内有「↻ 重新分析」 | 不变 |
| 偏好档案 | 靠顶部刷新 | 靠顶部刷新 |
| 设定 | **没有刷新**，且 `reload` 写了没人调 | 工具条加了「↻」 |
| 设置 | 靠顶部刷新 | 靠顶部刷新 |

后端只有一处缓存（项目识别 30 秒），已支持 `force: true` 强制清。

---

## [2.7.2] - 2026-10-19

### 修复

- **换一本书，扫描结果就少一本**：起点只取「当前作品的父目录」，切进深目录后视野跟着收窄——在 `Documents` 下能看到 3 本，切到 `novels/烈虎擒龙` 后只剩 2 本，本层的另一本看不见了。改成从当前作品**往上爬 3 级**（爬到盘符根就停），加上用户文档目录兜底，取并集。现在不管切到哪本，都能看到全部。
- **右上角「↻ 刷新」点了没反应**：它只调 `state`，而 `state` 有 30 秒的项目缓存，外部改过文件后点刷新看不出任何变化。改成 `state` 支持 `force: true` 强制清缓存重读磁盘，刷新按钮默认带上。

两种位置实测都是 3 本：

```
在 deepseek harness小说 下
  起点: D:\18708\Documents | D:\18708 | C:\Users\18708\Documents
  → deepseek harness小说(当前) / 烈虎擒龙 / 万物皆有你

在 烈虎擒龙 下
  起点: ...\novels | ...\deepseek harness | D:\18708\Documents | C:\Users\18708\Documents
  → 烈虎擒龙(当前) / 万物皆有你 / deepseek harness小说
```

---

## [2.7.1] - 2026-10-19

### 修复

- **扫描起点错了**：`dir.discover` 默认从「当前作品目录」往下扫，只能看到这本书内部，隔壁的兄弟作品（比如同一父目录下的另一本书）根本扫不到。改成从当前作品的**父目录**起扫，深度从 3 提到 4，能覆盖 `Documents/分类/作品集/某本书` 这种层级。
- 扫描结果里标出哪一本是**当前在写**的，并排在最前面。

实测（不传任何参数，直接打开目录选择器）：

```
起点: D:\18708\Documents
  [作品根] deepseek harness小说     正文、剧情、设定、大纲   ← 当前在写
  [作品根] 烈虎擒龙                 正文、大纲
  [作品根] 万物皆有你               正文
```

---

## [2.7.0] - 2026-10-19

### 新增

**顶栏能换书了**
- 工作台顶部的书名变成按钮，带 ▾，点一下弹出和设置页同一个目录选择器
- 一打开就能看见「扫描到的位置」，三本书列在最上面，各自带「作品根」标签
- 选中即切换，顶部提示切到了哪本、下一章候选目录落在哪

**切书时自动推导候选目录**
- 只改 `projectDir` 会留个坑：候选目录还指着旧书，下一章会写错地方
- 新接口 `book.switch` 连候选目录一起算：新作品下 `.dsh-novel-craft/候选稿/第{已有最大章号+1}章`
- 不是作品根的目录直接拒绝，给明确原因

实测：

```
切到「烈虎擒龙」        → 认出 10 章 → 候选目录自动设为 第11章
切回「deepseek harness小说」→ 11 章  → 第12章
切到 configs/（不是作品） → 拒绝：里面要有 正文/ 或 剧情/ 或 大纲.md
```

### 接口

- `book.switch` — 切换作品并同步推导候选目录

---

## [2.6.0] - 2026-10-19

### 新增

**设置页的目录不用手打了**
- 两个输入框后面各加一个「📂 浏览」按钮，打开目录选择器
- 作品根那行多一个「清空」，一键回到自动探测

**目录选择器会自己认路**
- 打开就扫描，把「像作品的地方」列在最上面，不用一层层翻
  - **作品根**：目录里有 `正文/` 或 `剧情/` 或 `大纲.md`
  - **候选目录**：路径里有 `候选稿/第N章`
- 每个识别到的位置带标签，点「用这个」直接回填
- 下面还能正常浏览：点文件夹进入、↑ 上一级、「用当前目录」

实测在 `Documents` 下扫 3 层，三本书全被认出来：

```
[作品根] D:\...\novels\烈虎擒龙        特征：正文、大纲
[作品根] D:\...\novels\万物皆有你      特征：正文
[作品根] D:\...\deepseek harness小说   特征：正文、剧情、设定、大纲
```

### 接口

- `dir.list` — 列一个目录下的子文件夹，标出每个的识别结果
- `dir.discover` — 从起点往下扫 3 层，揪出所有作品根和候选目录（上限 60 个）

只读目录项，不读文件内容，很快也不动任何东西。

---

## [2.5.1] - 2026-10-19

### 修复

- 侧栏入口按钮写了 `width: 100%`，在「设置旁边的可选动作」这个**水平排列**的插槽里独占整行，把同插槽的其它插件（词库、设置等）挤成竖排、还溢出到了工作台弹窗上。改成按内容自适应，加 `whiteSpace: nowrap` 和 `flexShrink: 0`，不再抢别人的位置。
- 侧栏收成 56px 图标轨道时（`wide: false`）只显示 📚 图标，不再硬塞文字。

---

## [2.5.0] - 2026-10-18

首个公开版本。从 `dsh-novel-craft` 重写而来，保留可用的内核，换掉难用的外壳：代码量约为旧版一半，界面从「弹窗套弹窗」改成一页式。

### 新增

**七个页面**
- 📖 章节 — 全书进度、点标题编辑正文、一键生成剧情总结
- ✍️ 候选稿 — 多标签阅读、逐段 👍/👎、合稿定稿
- 🗑 回收站 — 章节 / 候选稿 / 类型三分区，能看、能恢复、能彻底删
- 📈 情节 — 张力曲线、伏笔欠账、一致性检查、别称识别
- 📋 偏好档案 — 全书级一份，按类型跨书继承
- 📁 设定 — 浏览、编辑、新建、归档所有设定文件
- ⚙️ 设置 — 候选目录、作品根、模型

**开新章**
- 四步向导：本章设定 → 模型给方向 → 逐篇写候选 → 完成
- 写稿不跳页，状态不丢；可随时中断，已写的不会丢
- 每次显示「这次给模型读了什么」：大纲几个节点、总结几章、人物卡几张

**写作包按需取材**
- 近 10 章剧情总结给全文
- 10 章之前每章只给一句话
- 本章要出场的配角若在早期出现过 → 把那几章升级成全文
- 大纲只带本章前后各 1 章；更远的仅在提到相关人物时带「目标 + 埋」
- 上一章正文只取结尾 1400 字；人物卡名字出现才读

**剧情总结**
- 一键生成 / 批量补全 / 手改
- 结构化索引头：`chapter` `characters` `location` `planted` `paid`
- `characters` 用**规则**从正文提取（不调模型，比模型准且免费）
- 老总结没有头部也能用——从正文「出场人物」节兜底提取

**角色索引与别称**
- 扫全书统计每个角色出现在哪几章、首次/最后出场
- 别称识别：从正文猜「李哥」「萧先生」这类称呼
- 共现分析：抓每次出现的前后 50 字，看窗口里还出现了谁，推测指向
- 同姓不排除，冲突项列出双方上下文，由作者拍板
- 采纳后写入角色卡 `"别称"`，索引 / 一致性检查 / 写作包选人三处都认

**偏好档案**
- 全书级：存在作品根，不再换章就丢
- 类型库：`~/.dsh/novel-craft-types/`，跨书共用，按类型继承规律
- 提炼规律：标过的段落 → 模型压成「喜欢 / 避免」两类规律 → 勾选采纳
- 提炼有「证据」：每条规律能展开看是从哪几段来的

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

**设定文件管理**
- 一份清单列出这本书该有哪些文件，缺的标红
- 点项展开 → 点文件在右侧看 / 改
- `＋ 新建` 手动建文件
- `🪄 归档` 粘贴内容，模型判断该放进哪个文件，确认后才写
- `🔍 识别` 扫描文件夹，模型认领现有文件属于哪一类

### 修复

- 保存正文无反应（调用了未定义的 `enqueueWrite`）
- 换章后偏好档案消失（档案存在候选目录，改为作品根）
- 回收站看不到候选稿（只扫根目录，改为分区扫描）
- 候选稿段落只能标「好」（补 👎，三态可切）
- 全选要一段段点（加「全选本篇」）
- 「近 10 章全文」实际只给 5 条（`pack.js` 内部写死上限）
- 写作包带回的相关大纲节点被二次筛选丢掉
- 文件「明明在却读不到」（前端传绝对路径，后端又拼了一次作品根）
- 设定页「应有文件」和「已有文件」两坨重复

### 变更

- 后端从「每个动作一个 HTTP 路由」改成**单端点 RPC**：`POST /novel-studio/api/` + `{ a: '动作名' }`
- 客户端插件入口修正：`module.exports = {...}` 会覆盖 `exports.apply`，导致宿主拿不到注册入口、界面无入口
- 角色卡新增 `别称` 字段（可选，向后兼容）
- 界面左下角显示完整版本号，方便确认更新成功

### 安全

- 删除一律先进回收站，可恢复
- 改正文 / 总结 / 设定文件前自动备份到 `.dsh-novel-craft/备份/`
- 未保存就切页面 / 关窗口会弹确认
- 文件读写只能在工作目录内，越界拒绝
- 接口只接受本机回环请求