dsh-novel-writer 3.9.0 → 3.9.1

package/README.en.md

@@ -90,6 +90,15 @@ After installing, **restart the web app** to activate (host registers 16 tools +
 
 Under `<library-root>/.novel-writer/`: `plots` / `settings` / `summaries` / `analysis` / `audits` / `embedding` / `style-reports`.
 
+## Changelog
+
+### v3.9.1 (2026-09-05)
+
+- 🐛 Fix: per-chapter style analysis (semantic implicit emotion) previously searched the whole book and leaked hits from other chapters into the report; it is now scoped to the chapter, and stale out-of-scope caches are recomputed and written back automatically.
+- 🐛 Fix: `brief=true` previously still returned the full report and anchor payload (token saving never worked); it now returns a single compact brief and omits `dimensions` / `semantic` / anchors / skeletons.
+- 🔧 Tweak: the brief now follows `METRIC_ORDER` with Chinese dimension labels, consistent with the full report.
+- 🧹 Chore: removed the BOM and normalized formatting in `package.json`; `description` bumped to v3.9.1.
+
 ---
 
 ## License

package/README.md

@@ -90,6 +90,15 @@ dsh plugin --profile web add github:siweina/dsh-novel-writer#main
 
 `<书库根>/.novel-writer/`：`plots`（伏笔）/ `settings`（设定）/ `summaries`（摘要）/ `analysis`（分析报告）/ `audits`（审计）/ `embedding`（语义索引）/ `style-reports`（风格画像）。
 
+## 更新日志
+
+### v3.9.1（2026-09-05）
+
+- 🐛 修复：单章风格分析（语义隐性情感）此前按整书检索，会把其他章节的意象命中混入本章报告；现改为按章节范围检测与检索，越界的旧缓存会自动重算并写回，不再重复触发。
+- 🐛 修复：`brief=true` 精简模式此前仍返回完整报告与锚包，未达到省 token 的目的；现仅返回一行精简简报，并省略六维 `dimensions` / `semantic` / 锚点包等冗余字段。
+- 🔧 优化：简报按 `METRIC_ORDER` 顺序输出并使用中文维度标签，与完整报告口径一致。
+- 🧹 整理：`package.json` 去除 BOM、恢复规范排版，`description` 更新至 v3.9.1。
+
 ---
 
 ## 许可证

package/lib/index.js

@@ -930,17 +930,29 @@ function featureEnabled(state, name) {
   return features[name] !== false;
 }
 
-/** v2.0.0 语义隐性情感增强：规则意象表之外，用情感原型句扫全书索引找"词表外疑似意象段落"。 */
-async function enrichSemanticImplicit(state, root, book, result, exec) {
+/** v2.0.0 语义隐性情感增强：规则意象表之外，用情感原型句扫全书索引找"词表外疑似意象段落"。
+ * v3.9.1 修复：scope=章节文件名时只在章节范围内检测/复用——此前整书检索会把别章命中混入本章报告，
+ * 且单章缓存命中时旧版越界结果会被直接复用（早退），须校验 hits 的 chapter 全部落在 scope 内才早退。 */
+async function enrichSemanticImplicit(state, root, book, result, exec, scope) {
   try {
     if (!semanticFeatureEnabled(state, "semanticImplicit")) return result;
     if (!(await embedding.isAvailable())) return result;
     // v3.9.0 修正：缓存已带 semanticImplicit（miss 路径算好写盘的）→ 直接复用，不再重建索引全量读盘
-    if (result?.emotion?.quantification?.semanticImplicit) return result;
+    const existed = result?.emotion?.quantification?.semanticImplicit;
+    if (existed) {
+      const hits = Array.isArray(existed.hits) ? existed.hits : [];
+      // v3.9.1 范围校验：单章分析时命中必须全部落在本章；全书分析（scope=undefined）不做约束
+      const inScope = scope === void 0 || hits.length === 0 || hits.every((h) => h.chapter === scope);
+      if (inScope) return result;
+      delete result.emotion.quantification.semanticImplicit; // 越界旧缓存 → 重算修正
+    }
     const dir = bookDir(root, book);
     const chapters = await scanChapters(dir);
+    // v3.9.1：单章范围只读该章文本（避免整书读盘与检索越界）；全书照旧
+    const targets = scope === void 0 ? chapters : chapters.filter((c) => c.file === scope);
+    if (targets.length === 0) return result;
     const chunks = [];
-    for (const chapter of chapters) {
+    for (const chapter of targets) {
       const text = await readTextFile(join(dir, chapter.file), exec);
       // v2.6.0：章节标记直接用文件名（chunkText 只认"第X章"标题行，无标题行时检索结果无法定位章节）
       for (const p of embedding.chunkText(text)) chunks.push({ ...p, id: chapter.file + "|" + p.id, chapter: chapter.file });
@@ -948,11 +960,18 @@ async function enrichSemanticImplicit(state, root, book, result, exec) {
     // v2.5.0 修复轮 4：内容指纹失效重建——章节更新后旧缓存不再命中（不靠版本号）
     // v2.6.0：增量构建——指纹变化时只对新/变化的段落做推理，其余复用旧向量
     const { items: cachedIndex, fp: cachedFp } = embedding.loadIndexMeta(root, book);
-    const indexFp = embedding.fingerprint(chunks);
-    let index = cachedIndex;
-    if (!index || index.length === 0 || cachedFp !== indexFp) {
-      index = await embedding.buildIndexIncremental(chunks, cachedIndex);
-      embedding.saveIndex(root, book, index, indexFp);
+    let index;
+    if (scope !== void 0) {
+      // v3.9.1 单章范围：复用全书缓存中本章向量（增量只补缺失段），不写盘——避免污染全书指纹缓存
+      const cachedForScope = (cachedIndex || []).filter((it) => it.chapter === scope);
+      index = await embedding.buildIndexIncremental(chunks, cachedForScope);
+    } else {
+      const indexFp = embedding.fingerprint(chunks);
+      index = cachedIndex;
+      if (!index || index.length === 0 || cachedFp !== indexFp) {
+        index = await embedding.buildIndexIncremental(chunks, cachedIndex);
+        embedding.saveIndex(root, book, index, indexFp);
+      }
     }
     const implicit = await embedding.detectImplicitEmotions(index);
     if (result.emotion?.quantification) {
@@ -1783,7 +1802,14 @@ function registerNovelSentenceAnalysis(ctx, config) {
       }
       if (cachedHit) {
         // v3.9.0 复查修正：先 enrich（缓存自带 semanticImplicit → 早退零读盘）再裁剪——emotionComplexity 关闭时也不会触发全量重读
-        await enrichSemanticImplicit(state, root, book, cachedHit, exec);
+        // v3.9.1 修复：单章分析传 scope，语义隐性情感只算本章——旧版越界缓存（全书记录）命中后会自动重算修正
+        const siBefore = cachedHit?.emotion?.quantification?.semanticImplicit;
+        await enrichSemanticImplicit(state, root, book, cachedHit, exec, chapterArg !== void 0 ? selected[0].file : void 0);
+        // v3.9.1 修复：越界旧缓存被重算（对象被替换）→ 写回缓存，避免每次命中重复重算
+        const siAfter = cachedHit?.emotion?.quantification?.semanticImplicit;
+        if (siBefore && siAfter && siBefore !== siAfter) {
+          try { await atomicWriteJson(reportFile, { ...cachedHit, cachedAt: new Date().toISOString(), ver: CACHE_VERSION }); } catch { /* 缓存修正写回失败不阻塞 */ }
+        }
         if (!featureEnabled(state, "emotionCaveat") && cachedHit.emotion) {
           cachedHit.emotion = cropEmotion(cachedHit.emotion);
         }
@@ -1824,7 +1850,8 @@ function registerNovelSentenceAnalysis(ctx, config) {
         }
       } catch { /* 语义裁决失败不阻塞 */ }
       // v3.9.0 复查修正：先 enrich 后写缓存——缓存文件必须含 semanticImplicit，命中路径才能早退复用（否则每次命中仍全量读盘重建索引）
-      await enrichSemanticImplicit(state, root, book, result, exec);
+      // v3.9.1 修复：单章分析传 scope，语义隐性情感只算本章（此前整书检索，把别章命中混入本章报告）
+      await enrichSemanticImplicit(state, root, book, result, exec, chapterArg !== void 0 ? selected[0].file : void 0);
       try {
         await mkdir(cacheDir, { recursive: true });
         await atomicWriteJson(reportFile, { ...result, cachedAt: new Date().toISOString(), ver: CACHE_VERSION });
@@ -3028,11 +3055,17 @@ function registerNovelStyleReport(ctx, config) {
       const promptLine = judgment
         ? "\n✅ 风格判断已保存：" + (saved.savedAt || "（存盘失败）")
         : "\n📌 请结合上述六个维度数据判断本书的风格气质、读者感受与写法特征，";
-      if (args?.brief === true && result.baseline) {
-        const dims = Object.keys(result.baseline).filter(function (k) { return result.baseline[k] && typeof result.baseline[k].mu === "number"; });
-        result.brief = "全书 " + result.chars + " 字：六维基线 μ=" + dims.map(function (k) { return k + ":" + result.baseline[k].mu.toFixed(1); }).join(" ") + "；推荐容差 " + dims.map(function (k) { return result.baseline[k].recTol + "%"; }).slice(0, 3).join("/") + "…。";
+      // v3.9.1 修复：brief=true 时真正精简输出（此前仅附加 brief 字段、report 仍全文+锚包，未达省 token 目的）
+      const briefMode = args?.brief === true;
+      if (briefMode && result.baseline) {
+        // v3.9.1 优化：按 METRIC_ORDER 顺序输出、用中文标签（与完整报告一致）
+        const dims = METRIC_ORDER.filter(function (k) { return result.baseline[k] && typeof result.baseline[k].mu === "number"; });
+        result.brief = "全书 " + result.chars + " 字：六维基线 μ=" + dims.map(function (k) { return METRIC_LABELS[k] + ":" + result.baseline[k].mu.toFixed(1); }).join(" ") + "；推荐容差 " + dims.map(function (k) { return result.baseline[k].recTol + "%"; }).slice(0, 3).join("/") + "…。";
       }
       if (judgment) await noteRoot(root); // v3.9.0：判断保存记录书库根
+      const briefReport = briefMode && result.brief
+        ? "【风格画像·精简】《" + book + "》\n" + result.brief + promptLine + "\n（brief=true：完整六维/氛围/锚包请省略 brief 重新调用）"
+        : "";
       return cleanOutput({
         book,
         chars: result.chars,
@@ -3040,13 +3073,12 @@ function registerNovelStyleReport(ctx, config) {
         // v3.0.0：文笔六维基线带（novel_style_check 对照用）
         baseline: result.baseline ?? null,
         baselineChapterCount: result.baselineChapterCount ?? 0,
-        report: reportText + promptLine + (judgment ? "" : "然后将判断结论通过 aiJudgment 参数回传，插件会存入 .novel-writer/style-reports/ 供后续续写参考。"),
-        dimensions: { fingerprint: analysis.fingerprint, culture: result.culture, genre: result.genre?.dominant, theme: result.theme?.dominant, emotion: emotion.cleanDominant, vibe: Object.fromEntries(vibe.axes.slice(0, 12).map((a) => [a.name, a.score])) },
-        semantic: semantic.map((s, i) => ({ ...s, discrim: i === 0 && semantic.length >= 2 ? Math.round((semantic[0].score - semantic[1].score) * 1000) / 1000 : null })),
+        report: briefReport !== "" ? briefReport : reportText + promptLine + (judgment ? "" : "然后将判断结论通过 aiJudgment 参数回传，插件会存入 .novel-writer/style-reports/ 供后续续写参考。"),
+        dimensions: briefMode ? void 0 : { fingerprint: analysis.fingerprint, culture: result.culture, genre: result.genre?.dominant, theme: result.theme?.dominant, emotion: emotion.cleanDominant, vibe: Object.fromEntries(vibe.axes.slice(0, 12).map((a) => [a.name, a.score])) },
+        semantic: briefMode ? void 0 : semantic.map((s, i) => ({ ...s, discrim: i === 0 && semantic.length >= 2 ? Math.round((semantic[0].score - semantic[1].score) * 1000) / 1000 : null })),
         ...(judgment ? { saved: { savedAt: saved.savedAt, ...(saved.error ? { error: saved.error } : {}) }, savedJudgment: judgment } : {}),
-        anchors: anchorPkg.anchors,
-        skeletons: anchorPkg.skeletons,
-        message: judgment ? (saved?.error ? "风格画像报告已生成，但判断保存失败：" + saved.error : "风格画像报告已生成，判断结果已保存") : "风格画像报告已生成（仅测量数据，判断请由 AI 完成并回传保存）"
+        ...(briefMode ? {} : { anchors: anchorPkg.anchors, skeletons: anchorPkg.skeletons }),
+        message: judgment ? (saved?.error ? "风格画像报告已生成，但判断保存失败：" + saved.error : "风格画像报告已生成，判断结果已保存") : (briefMode ? "风格画像简报已生成（精简）" : "风格画像报告已生成（仅测量数据，判断请由 AI 完成并回传保存）")
       });
     }
   });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-novel-writer",
-  "version": "3.9.0",
-  "description": "小说写作助手插件（v3.9.0）：句式/情感/意象分析、伏笔设定管理、本地语义检索、氛围光谱、风格画像报告、文笔六维基线带、原创模式与创作资料、写作哨兵（衔接/OOC/大纲）。",
+  "version": "3.9.1",
+  "description": "小说写作助手插件（v3.9.1）：句式/情感/意象分析、伏笔设定管理、本地语义检索、氛围光谱、风格画像报告、文笔六维基线带、原创模式与创作资料、写作哨兵（衔接/OOC/大纲）。",
   "type": "module",
   "main": "lib/index.js",
   "exports": {