dsh-novel-writer 0.5.0 → 0.7.0

package/INSTALL.md

@@ -1,39 +1,36 @@
-# dsh-novel-writer v0.5.0 — 安装指南（v0.3.0 × v0.4.0 合并版）
+# dsh-novel-writer v0.7.0 — 安装指南
 
-宿主端零第三方依赖；浏览器端依赖 Web GUI 自带的 react。
-本包 UI：侧边栏「句式分析」大开关面板（统一开关位置）；设置 > 插件配置 卡片仅显示状态 + 跳转按钮。
+基于 v0.6.0 工程化版的 UI 升级：10 个工具全部带独立 UI 开关（侧边栏「写作助手功能」面板统一管理）。
 
 ```
-dsh-novel-writer-v0.5.0/
+dsh-novel-writer-v0.6.0/
 ├── lib/
-│   ├── index.js        # 宿主端（8 个 novel_* 工具 + state 路由）
-│   ├── analysis.js     # 句式模式分析引擎（九类/情感/节奏，零依赖）
-│   └── client.js       # 浏览器端（侧边栏面板 + 设置页卡片）
-├── test/               # 引擎与 client 契约测试
-├── package.json
-├── cordis.patch.yml
-├── README.md
-├── INSTALL.md
+│   ├── index.js        # 宿主端（10 个工具全开关 + state 路由 + 缓存）
+│   ├── analysis.js     # 句式模式分析引擎（含 fingerprintSimilarity / styleDiffs）
+│   └── client.js       # 浏览器端（侧边栏面板 + 设置页状态卡片）
+├── test/               # 引擎 + client + e2e 测试
+├── package.json / cordis.patch.yml / README.md / INSTALL.md
 └── skills/novel-writing/SKILL.md
 ```
 
 ## 安装
 
-1. 把本文件夹放入 profile 的 node_modules（或 `dsh plugin --profile web add <路径>`）；
+1. 放入 profile 的 node_modules（或 `dsh plugin --profile web add <路径>`）；
 2. profile `package.json` 的 `dsh.profile.bundles` 加入 `dsh-novel-writer`；
-3. （可选）把 `skills/novel-writing` 复制到工作区 `.dsh/skills/`；
-4. **重启 web 应用**。
+3. （可选）复制 `skills/novel-writing` 到工作区 `.dsh/skills/`；
+4. 重启 web 应用。
 
 ## 验证
 
-- 工具列表出现：novel_books / novel_chapters / novel_read / novel_keywords / novel_new_chapter /
-  novel_import / novel_sentence_analysis / novel_sentence_config；
-- 侧边栏出现「句式分析」入口；设置 > 插件配置 出现 novel-writer 状态卡片；
-- `GET /api/dsh-novel-writer/state` 返回 200 JSON。
+- 工具列表出现 10 个 novel_* 工具（含 novel_style_check / novel_plot）；
+- `novel_sentence_analysis` 返回含 `reportFile` / `cache` 字段；
+- 缓存目录 `~/.dsh/dsh-novel-writer/cache/` 出现报告 JSON；
+- 伏笔表文件 `<root>/.novel-writer/<书名>.json`。
 
-## 开关
+## 数据位置
 
-- 默认开启；**唯一开关位置：侧边栏「句式分析」面板**（总开关 enabled + 子开关 autoAnalyze）；
-- 设置 > 插件配置 卡片仅显示状态并提供「打开开关面板」跳转；
-- 持久化 `~/.dsh/dsh-novel-writer/state.json`；兼容读取 `~/.dsh/novel-writer.json`（v0.4.0 stylePattern）；
-- config 支持 `sentenceAnalysis.enabled / autoAnalyze` 与 `stylePattern`（v0.4.0 兼容）。
+| 数据 | 路径 |
+|---|---|
+| 开关状态 | `~/.dsh/dsh-novel-writer/state.json` |
+| 分析报告缓存 | `~/.dsh/dsh-novel-writer/cache/<书>-<hash>.json` |
+| 伏笔登记表 | `<书库根>/.novel-writer/<书>.json` |

package/README.md

@@ -1,56 +1,53 @@
-# dsh-novel-writer — 小说写作助手插件（v0.5.0 合并版）
+# dsh-novel-writer — 小说写作助手插件（v0.7.0：全工具 UI 开关）
 
 DSH（DeepSeek Harness）小说写作助手 bundle 插件。宿主端零第三方依赖（仅 Node 内置模块），
 浏览器端仅依赖 Web GUI 自带的 react。
-**v0.5.0 = v0.3.0（深度句式分析 + 侧边栏开关）与 v0.4.0（批量导入 + 设置页卡片）的合并版**。
+**v0.7.0 在 v0.6.0 基础上为全部 10 个工具增加独立 UI 开关（侧边栏「写作助手功能」面板统一管理）**：分析缓存与报告导出、风格自检、伏笔登记表、
+关键词三字组/疑似人名、情感词典去噪、祈使句与环境分类改进、局域网开关可选放行。
 
-## 功能
-
-1. **章节库**：章节存于 `novels/<书名>/第N章.md`（或 `.txt`/`.markdown`），
-   `novel_books` / `novel_chapters` / `novel_read` 浏览与读取。
-   章号任意位置 + 中文数字识别；UTF-8 / UTF-16 LE/BE / GBK 编码自动探测。
-2. **分析**：`novel_keywords` 提取全书/单章高频关键词（中文二字词组 + 英文词）。
-3. **句式模式分析**：`novel_sentence_analysis` 对全书/单章输出——
-   - 九类句式：陈述 / 环境 / 心理 / 对话 / 疑问 / 反问 / 感叹 / 祈使 / 省略留白（比例、句数、均长、例句）；
-   - 排列规律：句式转移、2/3 连句高频模板、段首/段尾句式、**按章节的压缩节奏序列**（S×8 ENV×2 PSY×3…）；
-   - 句长节奏：均值/中位数、短句/长句占比；
-   - 主观情感：情感词典（喜/怒/哀/惧/惊）+ 强度副词加权 → 主导情绪、情绪分布、情感曲线、主观性指数；
-   - 风格指纹 + 给模型的**节奏建议**（guidance）。
-   ⚠️ 风险约束：句式模式是"参考节奏"而非"模板套用"，模型在机械复刻导致僵硬时会优先回归自然表达。
-4. **原稿件批量导入**：`novel_import` 扫描存放多本小说的文件夹（支持子文件夹、多编码、任意位置章号），
-   从文件名与文件头双通道提取书名候选并分组（scan 预览），AI 确认后一键复制/移动到 `novels/<书名>/`（apply）；
-   支持 `book` 强制归并异名同书、`files` 精确指定、`move` 移动模式。
-5. **续写**：先读后写、保持文风与伏笔一致，`novel_new_chapter` 创建新章节文件。
-
-## 提供的工具
+## 工具清单（10 个，全部带独立 UI 开关）
 
 | 工具 | 说明 |
 |---|---|
 | `novel_books` | 列出章节库全部作品 |
 | `novel_chapters` | 列出某作品章节清单 |
-| `novel_read` | 阅读某章正文（offset/limit 分段） |
-| `novel_keywords` | 提取高频关键词 |
+| `novel_read` | 阅读某章正文（offset/limit 分段，编码自动探测） |
+| `novel_keywords` | 关键词：二字组 + **三字组** + **疑似人名** + 英文词 |
 | `novel_new_chapter` | 创建新章节文件 |
-| `novel_import` | **原稿件批量导入/自动分类（v0.4.0）** |
-| `novel_sentence_analysis` | **句式模式分析（v0.3.0 深度 + v0.4.0 节奏）** |
+| `novel_import` | 原稿件批量导入/自动分类（含**异名同书提示**） |
+| `novel_sentence_analysis` | 句式模式分析（九类/情感曲线/章节节奏/指纹，**带缓存与报告文件**） |
 | `novel_sentence_config` | 查看/修改句式分析开关 |
+| `novel_style_check` | **风格自检（v0.6.0 新增）**：章节 vs 全书指纹对比 + 偏差清单 |
+| `novel_plot` | **伏笔/剧情线登记表（v0.6.0 新增）**：list/add/update/done/delete |
+
+## v0.6.0 新增能力
 
-## UI 开关（统一在一处）
+1. **分析缓存 + 报告导出**：novel_sentence_analysis 结果自动缓存到 `~/.dsh/dsh-novel-writer/cache/<书名>-<hash>.json`，
+   返回值带 `reportFile` / `cache`（hit/miss）字段；章节未改动时重复分析秒回，传 `fresh=true` 强制重算。
+2. **风格自检 novel_style_check**：任意章节 vs 全书其余章节 → 余弦相似度 + 句式/句长/情绪偏差清单 + 续写建议（写完新章自动查一次，防止文风漂移）。
+3. **伏笔登记表 novel_plot**：`novels 根目录/.novel-writer/<书名>.json` 持久化；续写前 list 查看未回收伏笔。
+4. **关键词升级**：新增三字组与疑似人名（"XX说/道/问"与"XX小姐/导师"模式），人名不再被拆成"露西+西亚"。
+5. **情感词典去噪**：单字词搭配排除（"叹气"不算"气"、"笑道"不算"笑"）、否定过滤（"不害怕"不计）、副词距离窗口化（"非常开心"才加权）。
+6. **分类改进**：祈使句支持"快睡吧，明天还要上班"式（命令动词开头+吧）；环境词表扩充（晚风/晨曦/森林/群山…）。
+7. **情感曲线粒度可调**：`curveSegments` 参数（1-50，默认 20）。
+8. **novel_import 异名同书提示**：scan 结果中组名包含/高重合时列出 `maybe` 字段，提示用 `book` 合并。
+9. **局域网开关可选放行**：config `allowLanState: true` 时，state 路由对同源局域网请求放行（默认仍仅 loopback）。
 
-- **唯一开关位置：侧边栏「句式分析」面板**——状态横幅 + **总开关「启用句式分析」**（enabled）+ 子开关「分析作品时自动使用」（autoAnalyze）；
-- **设置 > 插件配置** 的 novel-writer 卡片仅**显示状态**（已启用/已关闭、自动分析开/关），并提供「打开开关面板」按钮跳转；
-- 也可让 AI 用 `novel_sentence_config` 查看/修改。
-- 状态写入 `~/.dsh/dsh-novel-writer/state.json`；同时**只读兼容** v0.4.0 的 `~/.dsh/novel-writer.json`（stylePattern）与 config.stylePattern。
-- 开关默认**开启**；宿主端路由 `/api/dsh-novel-writer/state`（loopback 围栏 + 可选注入，headless 自动跳过）。
+## UI 开关（v0.7.0：10 个工具全开关）
 
-## 安装（web profile）
+- **唯一开关位置：侧边栏「写作助手功能」面板**——总开关（enabled，控制句式分析/风格自检）+ 自动分析（autoAnalyze）+ **10 个工具各自独立开关**（全部默认开启）；
+- 关闭的工具，AI 调用时会收到明确提示；novel_sentence_config 可查/改全部开关（含 tools 字段）；
+- 设置 > 插件配置 卡片仅显示状态 + 「打开开关面板」跳转；
+- 持久化 `~/.dsh/dsh-novel-writer/state.json`；兼容 v0.4.0 的 novel-writer.json / config.stylePattern；
+- 默认开启；路由 `/api/dsh-novel-writer/state`（loopback 围栏，可选局域网放行）。
+
+## 安装
 
 ```sh
 dsh plugin --profile web add D:/tools/dsh-novel-writer
 ```
 
-或手动：把本文件夹放入 profile 的 `node_modules`，并在 profile `package.json` 的
-`dsh.profile.bundles` 中加入 `dsh-novel-writer`。安装后**重启 web 应用**生效。
+或手动：放入 profile 的 node_modules + `dsh.profile.bundles` 加 `dsh-novel-writer`；重启 web 应用。
 
 ## 配置
 
@@ -61,23 +58,12 @@ dsh plugin --profile web add D:/tools/dsh-novel-writer
     sentenceAnalysis:
       enabled: true
       autoAnalyze: true
-    # stylePattern: true   # v0.4.0 兼容写法（任一生效即开启）
-```
+    allowLanState: false   # true=局域网访问 GUI 时也允许保存开关
 
-## 版本记录
+## v0.7.0 更新内容
 
-### v0.5.0（合并版）
-- 合并 v0.3.0 与 v0.4.0：九类句式（新增"环境"）、章节压缩节奏序列、guidance 节奏建议、采样上限；
-- 新增 novel_import 批量导入（v0.4.0）；开关同时出现在侧边栏面板与官方设置页；
-- 路由改可选注入 ctx.inject(["webServer"])，headless 兼容；保留 loopback 围栏；
-- 兼容读取 v0.4.0 的 novel-writer.json / config.stylePattern；提示词内置"僵硬时优先自然表达"约束。
-
-### v0.4.0（他人改版，已并入）
-- novel_import 批量导入自动分类；novel_style_pattern 轻量句式分析（环境类/压缩序列/guidance）；
-- 官方设置页插件配置卡片；ctx.inject 可选注入；开关默认关闭 + 风险提示。
-
-### v0.3.0（本系列）
-- 句式模式分析深度版（情感曲线/句长/段落/指纹）；侧边栏开关面板；state 路由。
-
-### v0.2.0 / v0.1.0
-- 章节库、关键词、新建章节；编码探测。
+- **10 个工具全部带独立 UI 开关**（侧边栏「写作助手功能」面板）：novel_books / novel_chapters / novel_read / novel_keywords / novel_new_chapter / novel_import / novel_sentence_analysis / novel_sentence_config / novel_style_check / novel_plot，默认全开；
+- UI 更名：侧边栏入口/面板/横幅由「句式分析」改为「写作助手功能」；设置页卡片同步；
+- novel_sentence_config 升级：支持 tools 参数（如 `{ novel_plot: false }`）与返回各工具开关状态；
+- 关闭的工具调用时返回明确提示（模型可见）。
+```

package/lib/analysis.js

@@ -22,7 +22,8 @@ export const CATEGORY_LABELS = Object.freeze({
   exclamation: "感叹",
   imperative: "祈使",
   ellipsis: "省略留白"
-});
+}
+);
 
 /** 输出固定顺序。 */
 export const CATEGORY_ORDER = Object.freeze([
@@ -85,8 +86,8 @@ const QUESTION_WORDS = ["谁", "什么", "为什么", "怎么", "怎样", "如
 const IMPERATIVE_HARD = ["请", "快", "赶紧", "立刻", "马上", "别", "不要", "莫", "勿", "不许", "不准", "滚", "住手", "放手", "站住", "听我说", "给我", "让", "快点儿", "快点"];
 const IMPERATIVE_START = ["走", "来", "去", "坐", "站", "停", "开始", "出发", "算了吧", "算了", "吃", "喝", "看", "听", "说", "做", "干", "起来", "坐下", "住口"];
 
-/** 环境描写标记词（天色/天气/景物类名词，来自 v0.4.0）。 */
-const ENV_MARKERS = /夜色|月光|晨光|暮色|夕阳|黄昏|清晨|深夜|夜空|天边|星光|灯火|细雨|微风|大雨|暴雨|风雪|薄雾|浓雾|云层|远山|山影|河面|湖水|街道|巷子|烛火|窗|雨声|风声|树影|落叶|残雪|霜|天色/;
+/** 环境描写标记词（天色/天气/景物类名词，来自 v0.4.0，v0.6.0 扩充）。 */
+const ENV_MARKERS = /夜色|月光|晨光|暮色|夕阳|黄昏|清晨|深夜|夜空|天边|星光|灯火|细雨|微风|大雨|暴雨|风雪|薄雾|浓雾|云层|远山|山影|河面|湖水|街道|巷子|烛火|窗|雨声|风声|树影|落叶|残雪|霜|天色|晚风|夜风|晨曦|晚霞|晴空|雨滴|溪水|江水|海浪|沙漠|草原|森林|群山|雪地|庭院|檐下|廊下/;
 
 /** 句尾结束符。 */
 const TERMINATORS = "。！？…";
@@ -98,7 +99,8 @@ const QUOTE_PAIRS = [["“", "”"], ["「", "」"], ["『", "』"], ["‘", "
 export function splitBlocks(text) {
   const normalized = String(text).replace(/\r\n/g, "\n").replace(/\r/g, "\n");
   const lines = normalized.split("\n");
-  const hasBlank = lines.some((line) => line.trim() === "");
+  // 段落分隔符 = 前后都有内容的"中间空行"；仅开头/结尾的空行不算分段。
+  const hasBlank = lines.some((line, index) => line.trim() === "" && index > 0 && index < lines.length - 1);
   const blocks = [];
   let current = [];
   for (const line of lines) {
@@ -206,11 +208,11 @@ function isExclamation(text) {
 }
 
 function isImperative(text) {
-  if (!/(吧[。！？]?|！)$/.test(text)) return false;
+  if (!/吧/.test(text) && !/[！!]$/.test(text)) return false;
   for (const verb of IMPERATIVE_HARD) {
     if (text.includes(verb)) return true;
   }
-  return new RegExp("^(你|您|我们|咱们|大家)?(" + IMPERATIVE_START.join("|") + ")").test(text);
+  return new RegExp("^(你|您|我们|咱们|大家)?(" + IMPERATIVE_START.join("|") + ")").test(text) && /吧/.test(text);
 }
 
 /**
@@ -236,22 +238,63 @@ export function classifySentence(raw) {
   return { type: "statement", text, quoted: false };
 }
 
-/** 情感词计数（含强度副词加权）。 */
+/** 单字情感词的多字搭配排除（"叹气"不算"气"、"笑道"不算"笑"）。 */
+const EMOTION_EXCLUDE = {
+  joy: { "笑": ["笑道", "说笑", "玩笑", "搞笑", "笑话", "苦笑", "冷笑", "嘲笑", "嬉笑", "傻笑", "微笑", "笑死", "笑呵呵", "笑眯眯"] },
+  anger: { "气": ["叹气", "运气", "客气", "一口气", "服气", "脾气", "争气", "节气", "淘气", "景气", "暖气", "口气", "名气", "勇气", "底气", "俗气", "风气", "香气", "水气", "湿气", "潮气", "和气", "生气勃勃"] },
+  sorrow: { "悲": ["慈悲"], "哭": ["哭丧"] },
+  fear: { "怕": ["哪怕", "只怕", "生怕"] },
+  surprise: { "愣": ["愣住"] }
+};
+
+/** 情感词前紧邻的否定字（"不害怕"不计入恐惧）。 */
+const EMOTION_NEGATORS = new Set(["不", "没", "无", "别", "莫", "未"]);
+
+/** 情感词计数（v0.6.0：扫描式匹配 + 搭配排除 + 否定过滤 + 副词窗口加权）。 */
 function emotionOf(text) {
   const scores = { joy: 0, anger: 0, sorrow: 0, fear: 0, surprise: 0 };
   const words = { joy: [], anger: [], sorrow: [], fear: [], surprise: [] };
-  let weight = 1;
-  for (const adverb of STRONG_ADVERBS) {
-    if (text.includes(adverb)) { weight = Math.max(weight, 1.5); break; }
-  }
-  for (const adverb of MILD_ADVERBS) {
-    if (text.includes(adverb)) { weight = Math.min(weight, 0.6); break; }
-  }
+  const hitWords = new Set();
   for (const [emotion, list] of Object.entries(EMOTION_WORDS)) {
     for (const word of list) {
-      if (text.includes(word)) {
+      let from = 0;
+      while (from < text.length) {
+        const idx = text.indexOf(word, from);
+        if (idx === -1) break;
+        // 单字词的搭配排除（如"叹气"中的"气"）
+        const exclude = EMOTION_EXCLUDE[emotion]?.[word];
+        if (exclude !== void 0) {
+          const two = text.slice(Math.max(0, idx - 1), idx + 2);
+          const prevTwo = text.slice(Math.max(0, idx - 1), idx + 1);
+          const nextTwo = text.slice(idx, idx + 2);
+          const prevFour = text.slice(Math.max(0, idx - 2), idx + 2);
+          let excluded = false;
+          for (const bad of exclude) {
+            if (two.includes(bad) || prevTwo === bad || nextTwo === bad || prevFour.includes(bad)) {
+              excluded = true;
+              break;
+            }
+          }
+          if (excluded) { from = idx + word.length; continue; }
+        }
+        // 否定过滤："不害怕"不计入
+        const prevChar = idx > 0 ? text[idx - 1] : "";
+        if (EMOTION_NEGATORS.has(prevChar)) { from = idx + word.length; continue; }
+        // 副词窗口加权：词前 6 字符内出现的强/弱副词生效一次
+        const window = text.slice(Math.max(0, idx - 6), idx);
+        let weight = 1;
+        for (const adverb of STRONG_ADVERBS) {
+          if (window.includes(adverb)) { weight = Math.max(weight, 1.5); break; }
+        }
+        for (const adverb of MILD_ADVERBS) {
+          if (window.includes(adverb)) { weight = Math.min(weight, 0.6); break; }
+        }
         scores[emotion] += weight;
-        words[emotion].push(word);
+        if (!hitWords.has(word)) {
+          hitWords.add(word);
+          words[emotion].push(word);
+        }
+        from = idx + word.length;
       }
     }
   }
@@ -321,6 +364,7 @@ export function buildGuidance(ratios, topPatterns, chapterSequences) {
 export function analyzeText(text, options = {}) {
   const top = Number.isInteger(options.top) ? options.top : 8;
   const maxSentences = Number.isInteger(options.maxSentences) ? options.maxSentences : 20000;
+  const curveSegments = Number.isInteger(options.curveSegments) ? Math.min(Math.max(options.curveSegments, 1), 50) : 20;
   const blocks = splitBlocks(text);
   const sentences = [];
   const blockMeta = [];
@@ -509,7 +553,7 @@ export function analyzeText(text, options = {}) {
       })
       .sort((a, b) => b.count - a.count || a.word.localeCompare(b.word))
       .slice(0, 12),
-    curve: emotionCurve(blockMeta, 20)
+    curve: emotionCurve(blockMeta, curveSegments)
   };
 
   // 主观性指数（启发式 0-100）
@@ -616,3 +660,57 @@ function buildFingerprint(categories, lengths, style, emotion, motifs) {
   const motif = motifs.length > 0 ? motifs[0].pattern : "-";
   return parts.join(" ") + " | len:" + lengths.avg + " subj:" + style.subjectivityIndex + " emo:" + emotion.dominant + " | motif:" + motif;
 }
+
+/** 两篇文本的风格指纹相似度（0~1）：句式分布 + 句长 + 主观性的余弦相似度。 */
+export function fingerprintSimilarity(a, b) {
+  const vectorOf = (r) => {
+    const v = [];
+    const catMap = new Map((r.categories ?? []).map((x) => [x.type, x.ratio ?? 0]));
+    for (const type of CATEGORY_ORDER) v.push(catMap.get(type) ?? 0);
+    const len = r.lengths?.avg ?? 0;
+    v.push(Math.min(len, 100) / 100);
+    v.push(r.lengths?.shortRatio ?? 0);
+    v.push(r.lengths?.longRatio ?? 0);
+    v.push((r.style?.subjectivityIndex ?? 0) / 100);
+    return v;
+  };
+  const va = vectorOf(a);
+  const vb = vectorOf(b);
+  let dot = 0;
+  let na = 0;
+  let nb = 0;
+  for (let i = 0; i < va.length; i += 1) {
+    dot += va[i] * vb[i];
+    na += va[i] * va[i];
+    nb += vb[i] * vb[i];
+  }
+  if (na === 0 || nb === 0) return 0;
+  return Math.round((dot / (Math.sqrt(na) * Math.sqrt(nb))) * 1000) / 1000;
+}
+
+/** 风格偏差清单：b 相对 a 的显著差异（阈值可调）。 */
+export function styleDiffs(a, b, threshold = 0.06) {
+  const diffs = [];
+  const catA = new Map((a.categories ?? []).map((x) => [x.type, x.ratio]));
+  const catB = new Map((b.categories ?? []).map((x) => [x.type, x.ratio]));
+  for (const type of CATEGORY_ORDER) {
+    const d = (catB.get(type) ?? 0) - (catA.get(type) ?? 0);
+    if (Math.abs(d) >= threshold) {
+      diffs.push({
+        dimension: CATEGORY_LABELS[type] + "占比",
+        diff: Math.round(d * 1000) / 10,
+        note: d > 0 ? "偏高" : "偏低"
+      });
+    }
+  }
+  if (b.lengths && a.lengths) {
+    const lenDiff = b.lengths.avg - a.lengths.avg;
+    if (Math.abs(lenDiff) >= 5) diffs.push({ dimension: "平均句长", diff: Math.round(lenDiff * 10) / 10, note: lenDiff > 0 ? "偏长" : "偏短" });
+    const shortDiff = (b.lengths.shortRatio ?? 0) - (a.lengths.shortRatio ?? 0);
+    if (Math.abs(shortDiff) >= 0.08) diffs.push({ dimension: "短句占比", diff: Math.round(shortDiff * 1000) / 10, note: shortDiff > 0 ? "偏高" : "偏低" });
+  }
+  if (b.emotion && a.emotion && b.emotion.dominant !== a.emotion.dominant) {
+    diffs.push({ dimension: "主导情绪", diff: 0, note: "由「" + (a.emotion.dominant ?? "?") + "」变为「" + (b.emotion.dominant ?? "?") + "」" });
+  }
+  return diffs;
+}