dsh-novel-writer 3.2.1 → 3.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 siweina
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -8,7 +8,7 @@ English | [**中文**](./README.md)
 [![GitHub release](https://img.shields.io/github/v/release/siweina/dsh-novel-writer.svg?style=flat-square)](https://github.com/siweina/dsh-novel-writer/releases)
 [![DSH plugin](https://img.shields.io/badge/DSH-plugin-4b8bbe.svg?style=flat-square)](https://github.com/deepseek-ai/deepseek-harness)
 
-A novel-writing assistant plugin for **DeepSeek Harness (DSH)** (v3.2.0): chapter library management, sentence-pattern analysis, emotion purification & quantification, **12-axis vibe spectrum**, **style portrait report**, **six-dimension style baseline band**, **writing sentinels (bridge/OOC/outline drift)**, plot & settings management, local semantic search (0 token), webnovel signal detection, **original mode with creation files (bible/dynamic outline/hook backfill)**, batch import, and AI-assisted continuation writing. Zero third-party dependencies on host. **Requires Node ≥ 22.3.**
+A novel-writing assistant plugin for **DeepSeek Harness (DSH)**: chapter library management, sentence-pattern analysis, emotion purification & quantification, **12-axis vibe spectrum**, **style portrait report**, **six-dimension style baseline band**, **writing sentinels (bridge/OOC/outline drift)**, plot & settings management, local semantic search (0 token), webnovel signal detection, **original mode with creation files (bible/dynamic outline/hook backfill)**, batch import, and AI-assisted continuation writing. The semantic engine depends on `onnxruntime-web` and `@huggingface/tokenizers` (auto-installed with the package). **Requires Node ≥ 22.3.**
 
 > **A note to non-Chinese users**: This plugin is designed specifically for Chinese-language novel analysis and writing — its core capabilities (sentence-pattern analysis, emotion quantification, imagery detection) and its built-in semantic model are all built and tuned for Chinese text. Fully supporting English or other languages alongside Chinese is beyond my current capability. I sincerely apologize for any inconvenience this may cause.
 
@@ -39,14 +39,14 @@ After installing, **restart the web app** to activate (host registers 16 tools +
 
 1. **Style portrait report** (`novel_style_report`): 6-dimension measurement — style fingerprint / high-frequency lexicon / genre-theme / emotion quantification / 12-axis vibe spectrum / semantic style distance. **Measurement-judgment separation**: the plugin only reports numbers, never labels; AI judgment can be saved back to `.novel-writer/style-reports/` for consistent continuation writing.
 2. **12-axis vibe spectrum**: nightmare / angst / heartwarming / fluff / tearjerker / dark / mystery / blaze / absurd / lonesome / aesthetic / sensual — with traceable evidence, 0 token.
-3. **Local semantic engine**: bge-small-zh Chinese model (23MB, shipped with the plugin) local CPU inference — `novel_semantic_search` finds semantically related passages with natural language (with chapter location), semantic style comparison, semantic implicit emotion; lazy loading + graceful fallback.
+3. **Local semantic engine**: bge-small-zh Chinese model (24MB, shipped with the plugin) local CPU inference — `novel_semantic_search` finds semantically related passages with natural language (with chapter location), semantic style comparison, semantic implicit emotion; lazy loading + graceful fallback.
 4. **Sentence-pattern analysis**: 9 categories, arrangement patterns, rhythm, emotion curve, style fingerprint + guidance, with cache & report export.
 5. **Emotion purification & quantification**: strong/weak emotion-word grading, pollution detection, caveat warning + AI re-verification; Valence sliding window → variance V / delta Δ / conflict index C + implicit imagery carriers.
 6. **Worldview & pragmatics detection**: auto cultural-baseline detection with confidence; speechStyle title/honorifics/rituals/tone norms; genre & theme + webnovel signals.
 7. **Writing toolkit**: plot tracking / five settings tables (characters·locations·items·timeline·worldview) / chapter summaries / continuity audit / batch import / style check / continuation writing.
 8. **Per-tool UI toggles**: "Writing Assistant" sidebar panel (master + grouped tool toggles + feature toggles), plain-language labels, data-dir usage & semantic-engine status display.
 9. **Style Baseline**: Six writing metrics (syntactic complexity / modifier density / abstraction / action density / hedging / gap index) + per-chapter μ±σ baseline band; `novel_style_report` outputs the band, `novel_style_check` compares new chapters (in-band ✓ / out-of-band ⚠); per-metric ±% tolerance configurable in the sidebar (**recommended = 1.5× σ of the book's chapter variance**, rounded, clamped to ±10%~100%; leave blank to use recommended) — free theme, writing style kept inside the band.
-10. **Writing sentinels (v3.2.0)**: `novel_continuity_check` extended — ①**bridge check** (`chapter`: time jumps / semantic distance / character continuity / hook handoff, with quoted evidence) ②**OOC check** (`ooc`: per-character emotion baseline deviation) ③**outline drift** (`outline`: direction vs body keyword overlap); **brief mode** for report tools.
+10. **Writing sentinels**: `novel_continuity_check` extended — ①**bridge check** (`chapter`: time jumps / semantic distance / character continuity / hook handoff, with quoted evidence) ②**OOC check** (`ooc`: per-character emotion baseline deviation) ③**outline drift** (`outline`: direction vs body keyword overlap); **brief mode** for report tools.
 11. **Original mode & creation files**: fill in creation settings in the sidebar (worldview/characters/forbidden/main conflict/genre/extras, blank = model decides, per-book profile library); novel_outline maintains creation files (bible/characters/outline/hooks/status), enforcing the bible → outline → hook chain with dynamic batches (10→20→30 chapters) to prevent plot jumps and OOC.
 12. **Experience & stats**: main panel **library stats** (per-book chapters/total chars/7-day active chars, 🔥 green), **🎬 demo** (built-in sample, no files, runs the 6-dim baseline), **📊 report history** (analysis/style-reports browsing); actionable error hints; slimmer tool descriptions.
 

package/README.md

@@ -8,7 +8,7 @@
 [![GitHub release](https://img.shields.io/github/v/release/siweina/dsh-novel-writer.svg?style=flat-square)](https://github.com/siweina/dsh-novel-writer/releases)
 [![DSH plugin](https://img.shields.io/badge/DSH-plugin-4b8bbe.svg?style=flat-square)](https://github.com/deepseek-ai/deepseek-harness)
 
-为 **DeepSeek Harness (DSH)** 打造的小说写作助手插件（v3.2.0）：章节库管理、句式分析、情感净化与量化、氛围光谱、**风格画像报告**、**文笔六维基线带**、**写作哨兵三件套（衔接/OOC/大纲走偏）**、伏笔设定管理、本地语义检索（0 token）、网文信号识别、**原创模式与创作资料管理（设定书/动态大纲/钩子回填）**、批量导入与 AI 续写辅助。宿主端零第三方依赖，浏览器端仅依赖 Web GUI 自带的 react。**要求 Node ≥ 22.3。**
+为 **DeepSeek Harness (DSH)** 打造的小说写作助手插件：章节库管理、句式分析、情感净化与量化、氛围光谱、**风格画像报告**、**文笔六维基线带**、**写作哨兵三件套（衔接/OOC/大纲走偏）**、伏笔设定管理、本地语义检索（0 token）、网文信号识别、**原创模式与创作资料管理（设定书/动态大纲/钩子回填）**、批量导入与 AI 续写辅助。语义引擎依赖 `onnxruntime-web` 与 `@huggingface/tokenizers`（随包自动安装），浏览器端仅依赖 Web GUI 自带的 react。**要求 Node ≥ 22.3。**
 
 > **致非中文用户**：本插件为中文小说分析写作而设计——句式、情感、意象等核心能力以及内置的语义模型，全部针对中文语料构建与调优。在深耕中文的同时兼顾英文等其他语言，确实超出了我目前的能力范围。若因此给您带来不便，我深感抱歉，恳请谅解。
 
@@ -39,14 +39,14 @@ dsh plugin --profile web add github:siweina/dsh-novel-writer#main
 
 1. **风格画像报告**（novel_style_report）：6 维测量报告——文风指纹 / 高频词汇 / 题材流派 / 情感量化 / 氛围光谱 12 轴 / 语义风格距离。**测量与判断分离**：插件只报数不贴标签，AI 判断可回传存盘（`.novel-writer/style-reports/`），续写保持风格一致。
 2. **氛围光谱 12 轴**：噩梦感 / 焦虑压抑 / 温馨治愈 / 甜宠日常 / 催泪虐心 / 黑暗残酷 / 悬疑神秘 / 热血激昂 / 荒诞无厘头 / 孤独疏离 / 文艺唯美 / 情欲暧昧——证据链可追溯，0 token。
-3. **本地语义引擎**：bge-small-zh 中文模型（23MB 随插件分发）本地 CPU 推理——`novel_semantic_search` 自然语言搜全书语义相关段落（带章节定位），语义级风格对比、语义隐性情感，懒加载 + 自动回退。
+3. **本地语义引擎**：bge-small-zh 中文模型（24MB 随插件分发）本地 CPU 推理——`novel_semantic_search` 自然语言搜全书语义相关段落（带章节定位），语义级风格对比、语义隐性情感，懒加载 + 自动回退。
 4. **句式模式分析**：九类句式分布、排列规律、句长节奏、情感曲线、风格指纹与节奏建议，带缓存与报告导出。
 5. **情感净化 + 量化**：强/弱情绪词分级、污染源检测、caveat 预警 + AI 复核；Valence 滑动窗口 → 方差 V / 斜率 Δ / 矛盾指数 C + 隐性意象载体。
 6. **世界观与语用检测**：文化基准自动判断（西/东/混合）+ 置信度；speechStyle 称谓/客套/仪式/语气规范；题材流派 + 网文信号。
 7. **写作辅助全家桶**：伏笔登记表 / 设定五张表（人物·地点·道具·时间线·世界观）/ 章节摘要 / 连贯性审计 / 批量导入 / 风格自检 / 续写辅助。
 8. **全工具 UI 开关**：侧边栏「写作助手功能」面板（总开关 + 工具开关分组 + 功能开关），大白话文案，显示数据目录占用与语义引擎状态。
 9. **风格基线**：文笔六维测量（句法复杂度/修饰密度/抽象度/动作密度/不确定性/留白指数）+ 按章节 μ±σ 基线带；`novel_style_report` 输出基线带，`novel_style_check` 对照新章偏差（带内 ✓ / 出带 ⚠）；侧边栏可自定义每维 ±% 容差（**推荐值 = 原著章节波动的 1.5 倍 σ**，自动取整、限 ±10%~100%；输入框留空即用推荐）——原创/续写时主题自由、写法保持在基线带内。
-10. **写作哨兵三件套（v3.2.0）**：`novel_continuity_check` 扩展——①**衔接检查**（chapter 参数：时间硬跳/语义距离/人物延续/钩子承接四路检测，带原文引用）②**OOC 检测**（ooc 参数：角色情绪基线偏离）③**大纲走偏**（outline 参数：方向行 vs 正文关键词重合）；报告工具支持 **brief 精简模式**。
+10. **写作哨兵三件套**：`novel_continuity_check` 扩展——①**衔接检查**（chapter 参数：时间硬跳/语义距离/人物延续/钩子承接四路检测，带原文引用）②**OOC 检测**（ooc 参数：角色情绪基线偏离）③**大纲走偏**（outline 参数：方向行 vs 正文关键词重合）；报告工具支持 **brief 精简模式**。
 11. **原创模式与创作资料**：侧边栏填写创作设定（世界观/角色/禁忌/主线/题材/额外要求，留空=模型自定，多书独立设定库）；novel_outline 维护创作资料（创作设定/人物/剧情大纲/钩子记录/创作状态卡），原创强制「设定书→大纲→钩子」链，动态批次（10→20→30 章）防剧情跳跃与角色 OOC。
 12. **体验与统计**：主面板**书库统计卡**（每本章数/总字数/近 7 天活跃字数，活跃🔥标绿）、**🎬 体验演示**（内置示例不落盘跑六维基线）、**📊 报告历史**（analysis/style-reports 列表浏览）；错误提示带解决步骤；工具说明压缩省 token。
 

package/cordis.patch.yml

@@ -1,4 +1,4 @@
-# dsh-novel-writer v2.0.0 bundle patch: 14 tools (incl. novel_semantic_search) + local embedding engine.
+# dsh-novel-writer v3.5.0 bundle patch: 16 tools (incl. novel_semantic_search) + local embedding engine.
 # dsh-novel-writer bundle patch: mounts the novel-writing assistant plugin
 # into the profile's loader tree. The entry's name is the plugin package
 # itself, resolved from the profile's node_modules.

package/lib/analysis.js

@@ -131,6 +131,8 @@ export function splitBlocks(text) {
   let current = [];
   for (const line of lines) {
     const trimmed = line.trim();
+    // v3.5.0 #51：Markdown 标题（# 开头）不是句子——跳过（含空行场景）
+    if (/^#{1,6}\s/.test(trimmed)) continue;
     if (trimmed === "") {
       if (current.length > 0) {
         blocks.push(current.join("\n").trim());
@@ -154,6 +156,13 @@ export function splitSentences(block) {
   let buffer = "";
   for (let i = 0; i < block.length; i += 1) {
     const ch = block[i];
+    // v3.5.0 #50b：无标点换行也是句边界（逐行排版正确分句，整篇不再算 1 句）
+    if (ch === "\n" || ch === "\r") {
+      const lineSentence = buffer.trim();
+      if (lineSentence !== "") sentences.push(lineSentence);
+      buffer = "";
+      continue;
+    }
     buffer += ch;
     if (TERMINATORS.includes(ch)) {
       while (i + 1 < block.length && TERMINATORS.includes(block[i + 1])) {
@@ -267,7 +276,7 @@ export function classifySentence(raw) {
 /** 单字情感词的多字搭配排除（"叹气"不算"气"、"笑道"不算"笑"）。 */
 const EMOTION_EXCLUDE = {
   joy: { "笑": ["笑道", "说笑", "玩笑", "搞笑", "笑话", "苦笑", "冷笑", "嘲笑", "嬉笑", "傻笑", "微笑", "笑死", "笑呵呵", "笑眯眯"] },
-  anger: { "气": ["叹气", "运气", "客气", "一口气", "服气", "脾气", "争气", "节气", "淘气", "景气", "暖气", "口气", "名气", "勇气", "底气", "俗气", "风气", "香气", "水气", "湿气", "潮气", "和气", "生气勃勃"] },
+  anger: { "气": ["叹气", "运气", "客气", "一口气", "服气", "脾气", "争气", "节气", "淘气", "景气", "暖气", "口气", "名气", "勇气", "底气", "俗气", "风气", "香气", "水气", "湿气", "潮气", "和气", "生气勃勃"], "生气": ["生气勃勃"] },
   sorrow: { "悲": ["慈悲"], "哭": ["哭丧"] },
   fear: { "怕": ["哪怕", "只怕", "生怕"] },
   surprise: { "愣": ["愣住"] }
@@ -296,10 +305,12 @@ function emotionOf(text) {
         // 单字词的搭配排除（如"叹气"中的"气"）
         const exclude = EMOTION_EXCLUDE[emotion]?.[word];
         if (exclude !== void 0) {
+          // v3.5.0 #54：窗口按最长排除词取（"生气勃勃"=4 字，旧窗口永远命不中）
+          const maxLen = Math.max(4, ...exclude.map(function (x) { return x.length; }));
           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);
+          const prevFour = text.slice(Math.max(0, idx - maxLen), idx + maxLen);
           let excluded = false;
           for (const bad of exclude) {
             if (two.includes(bad) || prevTwo === bad || nextTwo === bad || prevFour.includes(bad)) {
@@ -682,7 +693,8 @@ export function valenceSeries(text, winChars = 100) {
 
 /** v1.6.0 三指标：方差 V + 相邻撕裂 V_adj + 斜率 Δ（最小二乘+鲁棒版）+ 矛盾指数 C。 */
 export function valenceStats(text) {
-  const { series, posWords, negWords } = valenceSeries(text);
+  // v3.5.0 #57：一次 valenceSeries 取全部（旧版窗口统计二次调用，大书白扫一遍词表）
+  const { series, posWords, negWords, windowPosNeg } = valenceSeries(text);
   const n = series.length;
   if (n === 0) return { windows: 0 };
   const mean = series.reduce((x, y) => x + y, 0) / n;
@@ -701,7 +713,7 @@ export function valenceStats(text) {
   const third = Math.max(1, Math.floor(n / 3));
   const headMean = series.slice(0, third).reduce((x, y) => x + y, 0) / third;
   const tailMean = series.slice(-third).reduce((x, y) => x + y, 0) / third;
-  const { windowPosNeg } = valenceSeries(text);
+  // v3.5.0 #57：复用上面的 windowPosNeg（不再二次扫描）
   const totalWords = posWords + negWords;
   const posRatio = totalWords === 0 ? 0 : posWords / totalWords;
   const negRatio = totalWords === 0 ? 0 : negWords / totalWords;
@@ -856,7 +868,8 @@ export function emotionalQuantification(text, perChapter, blocks, semResolver =
  */
 export function analyzeText(text, options = {}) {
   const top = Number.isInteger(options.top) ? options.top : 8;
-  const maxSentences = Number.isInteger(options.maxSentences) ? options.maxSentences : 20000;
+  // v3.5.0 #63：maxSentences 钳制 ≥1（0/负数会让 slice(0,-5) 产生错误语义）
+  const maxSentences = Math.max(1, 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 = [];
@@ -1269,7 +1282,8 @@ const DENSITY_SENSE = {
 /** 细节密度统计（v0.8.0）：动作链/物件名词/感官词，按千字归一。 */
 export function densityOf(text) {
   const sentences = splitSentences(text);
-  const totalChars = text.replace(/\s/g, "").length;
+  // v3.5.0 #62：分母口径统一（含空白，与 style-metrics 的 per1000 一致，跨模块数值可比）
+  const totalChars = String(text).length;
   let actionVerbs = 0;
   let actionChainSentences = 0;
   let objectHits = 0;

package/lib/client.js

@@ -14,6 +14,8 @@ window.__ModuleLoader__.load({
   id: "dsh-novel-writer",
   factory: (require) => {
     var module = { exports: {} };
+    // v3.5.0 R1：rawTimer 必须在 createController 闭包外/顶部声明（旧位置在渲染函数内，api 方法访问不到 → ReferenceError）
+    var rawTimer = null;
     var exports = module.exports;
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     let react = require("react");
@@ -30,7 +32,7 @@ var css = `
   html[data-dsh-novel-writer-active]:not([data-dsh-ssh-active]):not([data-dsh-taskboard-active]) [class*=centerCol]>:not([data-dsh-novel-writer-view]){display:none!important}
   [data-dsh-frame][data-sidebar-collapsed] .nwEntry{justify-content:center;width:100%;padding:0}
   [data-dsh-frame][data-sidebar-collapsed] .nwEntryLabel{display:none}
-  .nwSectionTitle{.nwTolVer{font-size:10px;color:var(--dsw-alias-label-tertiary,#94a3b8);margin:-2px 0 2px;letter-spacing:.03em}.nwTolCard{background:var(--dsw-alias-bg-layer-1,#fff);border:1px solid var(--dsw-alias-border-l2,#e2e8f0);border-radius:12px;padding:4px 14px 8px;margin:8px 0 4px;box-shadow:0 1px 4px rgba(15,23,42,.05)}.nwTolRow{display:flex;align-items:center;gap:10px;padding:9px 2px}.nwTolRow+.nwTolRow{border-top:1px dashed var(--dsw-alias-border-l2,#eef2f7)}.nwTolName{flex:1;min-width:0;font-size:13px;color:var(--dsw-alias-label-primary,#334155);font-weight:500;display:flex;align-items:center;gap:8px;white-space:nowrap}.nwTolIcon{font-size:15px;opacity:.9;flex-shrink:0}.nwTolField{width:66px;flex-shrink:0;display:flex;flex-direction:column;align-items:stretch;gap:3px}.nwTolInput{width:100%;height:30px;padding:0 4px;box-sizing:border-box;border:1px solid var(--dsw-alias-border-l2,#d4d4d8);border-radius:8px;font-size:13px;text-align:center;color:var(--dsw-alias-label-primary,#18181b);background:var(--dsw-alias-bg-layer-2,#fafafa);transition:border-color .18s,box-shadow .18s,background .18s;-moz-appearance:textfield}.nwTolInput::-webkit-outer-spin-button,.nwTolInput::-webkit-inner-spin-button{-webkit-appearance:none;margin:0}.nwTolInput:hover{border-color:#a1a1aa}.nwTolInput:focus{outline:none;border-color:#6366f1;box-shadow:0 0 0 3px rgba(99,102,241,.16);background:#fff}.nwTolInput::placeholder{color:#c4c8d0;font-size:11px}.nwTolCaption{font-size:10px;color:var(--dsw-alias-label-tertiary,#94a3b8);text-align:center}.nwTolSep{width:14px;flex-shrink:0;font-size:12px;color:var(--dsw-alias-label-tertiary,#b0b8c4);text-align:center}.nwTolPct{width:14px;flex-shrink:0;font-size:13px;color:var(--dsw-alias-label-secondary,#64748b);text-align:left}.nwTolBtns{display:flex;gap:12px;margin-top:16px}.nwBtnPrimary{background:linear-gradient(135deg,#6366f1,#8b5cf6);border:none;color:#fff;font-weight:600;font-size:13px;padding:9px 20px;border-radius:10px;cursor:pointer;box-shadow:0 2px 6px rgba(99,102,241,.28);transition:transform .15s,box-shadow .15s,opacity .15s}.nwBtnPrimary:hover{transform:translateY(-1px);box-shadow:0 4px 12px rgba(99,102,241,.38)}.nwBtnPrimary:active{transform:translateY(0);box-shadow:0 1px 3px rgba(99,102,241,.3)}.nwBtnDone{background:linear-gradient(135deg,#10b981,#34d399);box-shadow:0 2px 6px rgba(16,185,129,.3)}.nwBtnGhost{background:transparent;border:1px solid var(--dsw-alias-border-l2,#cbd5e1);color:var(--dsw-alias-label-secondary,#475569);font-size:13px;padding:9px 18px;border-radius:10px;cursor:pointer;transition:background .15s,border-color .15s,transform .15s}.nwBtnGhost:hover{background:var(--dsw-alias-bg-layer-2,#f1f5f9);border-color:#a1a1aa;transform:translateY(-1px)}.nwUpdateBar{display:block;margin:4px 0 8px;padding:7px 10px;border-radius:6px;background:#e8f5e9;color:#1b5e20;font-size:12px;text-decoration:none;border:1px solid #a5d6a7;cursor:pointer}.nwUpdateBar:hover{background:#c8e6c9}font-size:13px;font-weight:700;margin-top:6px}
+  .nwSectionTitle{display:flex;align-items:center;gap:6px;font-weight:700;font-size:13px;margin-top:6px}.nwTolVer{font-size:10px;color:var(--dsw-alias-label-tertiary,#94a3b8);margin:-2px 0 2px;letter-spacing:.03em}.nwTolCard{background:var(--dsw-alias-bg-layer-1,#fff);border:1px solid var(--dsw-alias-border-l2,#e2e8f0);border-radius:12px;padding:4px 14px 8px;margin:8px 0 4px;box-shadow:0 1px 4px rgba(15,23,42,.05)}.nwTolRow{display:flex;align-items:center;gap:10px;padding:9px 2px}.nwTolRow+.nwTolRow{border-top:1px dashed var(--dsw-alias-border-l2,#eef2f7)}.nwTolName{flex:1;min-width:0;font-size:13px;color:var(--dsw-alias-label-primary,#334155);font-weight:500;display:flex;align-items:center;gap:8px;white-space:nowrap}.nwTolIcon{font-size:15px;opacity:.9;flex-shrink:0}.nwTolField{width:66px;flex-shrink:0;display:flex;flex-direction:column;align-items:stretch;gap:3px}.nwTolInput{width:100%;height:30px;padding:0 4px;box-sizing:border-box;border:1px solid var(--dsw-alias-border-l2,#d4d4d8);border-radius:8px;font-size:13px;text-align:center;color:var(--dsw-alias-label-primary,#18181b);background:var(--dsw-alias-bg-layer-2,#fafafa);transition:border-color .18s,box-shadow .18s,background .18s;-moz-appearance:textfield}.nwTolInput::-webkit-outer-spin-button,.nwTolInput::-webkit-inner-spin-button{-webkit-appearance:none;margin:0}.nwTolInput:hover{border-color:#a1a1aa}.nwTolInput:focus{outline:none;border-color:#6366f1;box-shadow:0 0 0 3px rgba(99,102,241,.16);background:#fff}.nwTolInput::placeholder{color:#c4c8d0;font-size:11px}.nwTolCaption{font-size:10px;color:var(--dsw-alias-label-tertiary,#94a3b8);text-align:center}.nwTolSep{width:14px;flex-shrink:0;font-size:12px;color:var(--dsw-alias-label-tertiary,#b0b8c4);text-align:center}.nwTolPct{width:14px;flex-shrink:0;font-size:13px;color:var(--dsw-alias-label-secondary,#64748b);text-align:left}.nwTolBtns{display:flex;gap:12px;margin-top:16px}.nwBtnPrimary{background:linear-gradient(135deg,#6366f1,#8b5cf6);border:none;color:#fff;font-weight:600;font-size:13px;padding:9px 20px;border-radius:10px;cursor:pointer;box-shadow:0 2px 6px rgba(99,102,241,.28);transition:transform .15s,box-shadow .15s,opacity .15s}.nwBtnPrimary:hover{transform:translateY(-1px);box-shadow:0 4px 12px rgba(99,102,241,.38)}.nwBtnPrimary:active{transform:translateY(0);box-shadow:0 1px 3px rgba(99,102,241,.3)}.nwBtnDone{background:linear-gradient(135deg,#10b981,#34d399);box-shadow:0 2px 6px rgba(16,185,129,.3)}.nwBtnGhost{background:transparent;border:1px solid var(--dsw-alias-border-l2,#cbd5e1);color:var(--dsw-alias-label-secondary,#475569);font-size:13px;padding:9px 18px;border-radius:10px;cursor:pointer;transition:background .15s,border-color .15s,transform .15s}.nwBtnGhost:hover{background:var(--dsw-alias-bg-layer-2,#f1f5f9);border-color:#a1a1aa;transform:translateY(-1px)}.nwUpdateBar{display:block;margin:4px 0 8px;padding:7px 10px;border-radius:6px;background:#e8f5e9;color:#1b5e20;font-size:12px;text-decoration:none;border:1px solid #a5d6a7;cursor:pointer}.nwUpdateBar:hover{background:#c8e6c9}
   .nwNavEntry{display:flex;align-items:center;justify-content:space-between;width:100%;box-sizing:border-box;padding:8px 10px;margin:4px 0;border:1px solid var(--dsw-alias-border);border-radius:8px;background:var(--dsw-alias-surface-1);cursor:pointer;text-align:left;color:inherit;font:inherit}
   .nwNavEntry:hover{border-color:#22c55e}
   .nwNavEntryText{flex:1;min-width:0;padding-right:8px}
@@ -231,6 +233,7 @@ var css = `
       "toolGroup.create.desc": "新建章节与调整开关配置。",
       "group.allOn": "全部开启",
       "group.allOff": "全部关闭",
+      "group.onCount": "{n} 开",
       "group.partial": "部分开启（点一下全部开启）",
       "panel.toolsHint": "全部默认开启。关闭后 AI 调用该工具会收到明确提示；可随时在此重新开启。",
       "panel.loading": "正在读取开关状态…",
@@ -333,6 +336,7 @@ var css = `
       "creation.deleted": "已删除该书设定",
       "creation.newed": "已创建设定，开始填写",
       "creation.needName": "请先输入新书书名",
+      "stats.pending": "统计未就绪（宿主未提供，点刷新重试）",
       "stats.empty": "书库为空——在 novels/ 放一本小说，或让 AI 原创一本",
       "stats.title": "书库统计",
       "stats.week": "7天",
@@ -358,6 +362,7 @@ var css = `
     var en = {
       "entry.label": "Writing Assistant",
       "entry.tooltip": "Writing assistant switches (dsh-novel-writer): analysis / style check / plot tracking etc.",
+      "panel.back": "Back",
       "panel.title": "Writing Assistant",
       "panel.desc": "Manage the writing-assistant features: sentence-pattern analysis, style check, plot tracking, import, etc. Disabled tools return a clear notice when called.",
       "panel.enabled": "Enable writing assistant",
@@ -413,7 +418,11 @@ var css = `
       "toolGroup.analyze": "📊 Analysis",
       "toolGroup.settings": "📚 Settings",
       "toolGroup.create": "✍️ Creation",
-      "panel.toolsHint": "All on by default. Disabled tools return a clear notice; re-enable anytime here.",
+"group.allOn": "All on",
+      "group.allOff": "All off",
+      "group.onCount": "{n} on",
+      "group.partial": "Partially on (click to toggle all)",
+            "panel.toolsHint": "All on by default. Disabled tools return a clear notice; re-enable anytime here.",
       "panel.loading": "Loading switch state…",
       "panel.saved": "Saved to the host state file",
       "panel.localOnly": "Host unreachable; kept in this browser only (defaults may return after restart).",
@@ -513,6 +522,7 @@ var css = `
       "creation.deleted": "Profile deleted",
       "creation.newed": "Profile created, start filling",
       "creation.needName": "Please enter a book name first",
+      "stats.pending": "Stats pending (host unavailable — press refresh)",
       "stats.empty": "Library empty — put a novel in novels/, or ask AI to create one",
       "stats.title": "Library stats",
       "stats.week": "/7d",
@@ -617,6 +627,8 @@ var css = `
         getSnapshot: function () { return state; },
         set: function (patch) {
           Object.assign(state, patch);
+          // v3.5.0 R4：每次状态变更自增版本号（竞态守卫用，对象引用比较是死代码）
+          state.rev = (state.rev || 0) + 1;
           listeners.forEach(function (fn) { fn(state); });
         },
         subscribe: function (fn) {
@@ -626,22 +638,24 @@ var css = `
         refresh: function () {
           if (api.getSnapshot().refreshing) return Promise.resolve(null);
           api.set({ refreshing: true, revealMsg: "", revealErr: false });
+          // v3.5.0 R4：记录请求发起时的版本号——返回时版本未变（用户没操作）才用远端覆盖开关/设定
+          var revAt = api.getSnapshot().rev;
           return fetchState().then(function (remote) {
             api.set({
               enabled: !!remote.enabled,
               autoAnalyze: !!remote.autoAnalyze,
-              tools: remote.tools || {},
-              features: remote.features || {},
+              // v3.5.0 R4：请求期间版本未变（用户没操作）才用远端覆盖开关——慢请求不覆盖用户刚切的
+              tools: (api.getSnapshot().rev === revAt ? (remote.tools || {}) : api.getSnapshot().tools || {}),
+              features: (api.getSnapshot().rev === revAt ? (remote.features || {}) : api.getSnapshot().features || {}),
               plotsDir: remote.plotsDir || "",
               dataDir: remote.dataDir || "",
               dataDirSize: remote.dataDirSize || 0,
               embeddingStatus: remote.embeddingStatus || null,
-              styleTolerance: remote.styleTolerance || null,
-              creationProfile: remote.creationProfile || null,
-              creationProfiles: remote.creationProfiles || {},
+              styleTolerance: (api.getSnapshot().rev === revAt ? (remote.styleTolerance || null) : api.getSnapshot().styleTolerance || null),
+              creationProfile: (api.getSnapshot().rev === revAt ? (remote.creationProfile || null) : api.getSnapshot().creationProfile || null),
+              creationProfiles: (api.getSnapshot().rev === revAt ? (remote.creationProfiles || {}) : api.getSnapshot().creationProfiles || {}),
               books: remote.books || [],
-              booksStats: remote.booksStats || [],
-            booksStats: remote.booksStats || [],
+              booksStats: typeof remote.booksStats === "undefined" ? null : (remote.booksStats || []),
               dirs: remote.dirs || null,
               file: remote.file || "",
               hostOk: true,
@@ -693,8 +707,8 @@ var css = `
           if (navigator.clipboard && navigator.clipboard.writeText) {
             navigator.clipboard.writeText(dir).then(function () { done(true); }, function () { done(false); });
           } else {
-            // 非安全上下文降级：显示路径文本供手动复制
-            done(true);
+            // v3.5.0 #45：非安全上下文实际没复制成功——如实报失败并给出路径
+            done(false);
           }
         },
         setToggle: function (fn) { toggleRef = fn; },
@@ -702,25 +716,32 @@ var css = `
         setToolGroupOpen: function (patch) { api.set({ toolGroupOpen: Object.assign({}, (this.state && this.state.toolGroupOpen) || {}, patch) }); },
         rawToggle: function (wantOn) {
           if (!wantOn) {
+            if (rawTimer) { clearInterval(rawTimer); rawTimer = null; }
             if (toggleRef) toggleRef({ features: { rawWriting: false } });
             api.set({ rawModal: false, rawCountdown: 0, rawPromiseOpen: false, rawPromiseText: "", rawPromiseOk: false });
             return;
           }
           api.set({ rawModal: true, rawCountdown: 3, rawPromiseOpen: false, rawPromiseText: "", rawPromiseOk: false });
-          var timer = setInterval(function () {
+          // v3.5.0 #43：timer 存模块级引用，取消/确认时统一清理（防双定时器竞争）
+          if (rawTimer) clearInterval(rawTimer);
+          rawTimer = setInterval(function () {
             var n = api.getSnapshot().rawCountdown - 1;
-            if (n <= 0) { clearInterval(timer); api.set({ rawCountdown: 0 }); }
+            if (n <= 0) { clearInterval(rawTimer); rawTimer = null; api.set({ rawCountdown: 0 }); }
             else api.set({ rawCountdown: n });
           }, 1000);
         },
-        rawConfirm: function () { api.set({ rawModal: false, rawPromiseOpen: true, rawPromiseText: "", rawPromiseOk: false }); },
-        rawCancel: function () { api.set({ rawModal: false, rawCountdown: 0, rawPromiseOpen: false, rawPromiseText: "", rawPromiseOk: false }); },
+        rawConfirm: function () { if (rawTimer) { clearInterval(rawTimer); rawTimer = null; } api.set({ rawModal: false, rawPromiseOpen: true, rawPromiseText: "", rawPromiseOk: false }); },
+        rawCancel: function () { if (rawTimer) { clearInterval(rawTimer); rawTimer = null; } api.set({ rawModal: false, rawCountdown: 0, rawPromiseOpen: false, rawPromiseText: "", rawPromiseOk: false }); },
         rawSetPromise: function (text) {
-          var ok = String(text || "").indexOf("绝不传播") !== -1 && String(text || "").length >= 5;
+          // v3.5.0 #36：按当前语言校验（中文"绝不传播" / 英文"never distribute"）
+          var isEn = typeof document !== "undefined" && (document.documentElement.lang || "zh").toLowerCase().startsWith("en");
+          var kw = isEn ? "never distribute" : "绝不传播";
+          var ok = String(text || "").toLowerCase().indexOf(kw) !== -1 && String(text || "").length >= 5;
           api.set({ rawPromiseText: text || "", rawPromiseOk: ok });
         },
         rawPromiseConfirm: function () {
           if (!api.getSnapshot().rawPromiseOk) return;
+          if (rawTimer) { clearInterval(rawTimer); rawTimer = null; }
           if (toggleRef) toggleRef({ features: { rawWriting: true } });
           api.set({ rawPromiseOpen: false, rawPromiseText: "", rawPromiseOk: false, rawModal: false, rawCountdown: 0 });
         }
@@ -788,7 +809,8 @@ var css = `
         if (placed) rootObserver.observe(root, { childList: true, subtree: true });
       };
       var waitObserver = new MutationObserver(function () { tryPlace(); });
-      waitObserver.observe(document.body, { childList: true, subtree: true });
+      // v3.5.0 #44：observe 失败容错（不影响 mountPanel 挂载）
+      try { waitObserver.observe(document.body, { childList: true, subtree: true }); } catch (e) { /* body 不可观察时静默降级 */ }
       var rootObserver = new MutationObserver(function () {
         if (root === void 0 || !root.isConnected) {
           placed = false;
@@ -843,7 +865,7 @@ var css = `
             el("div", { className: "nwNavEntryHint" }, hint)
           ),
           el("div", { className: "nwNavEntryRight" },
-            count === null ? null : el("span", { className: "nwBadge " + (count > 0 ? "nwBadgeOn" : "nwBadgeOff") }, count + " 开"),
+            count === null ? null : el("span", { className: "nwBadge " + (count > 0 ? "nwBadgeOn" : "nwBadgeOff") }, (t("group.onCount") || "{n} 开").replace("{n}", count)),
             el("span", { className: "nwNavEntryArrow" }, "›")
           )
         );
@@ -1032,7 +1054,8 @@ var TOOL_GROUPS = [
         );
       } else if (view === "baseline") {
         // v3.0.0：风格基线——六维文笔指标 ±% 容差带（左=允许低于，右=允许高于）
-        var NW_METRICS = [
+  var DEFAULT_TOL = { low: "", high: "" };
+  var NW_METRICS = [
           ["complexity", "句法复杂度", "📐"], ["modifierDensity", "修饰密度", "🎨"], ["abstractDensity", "抽象度", "☁️"],
           ["actionDensity", "动作密度", "⚡"], ["hedgeDensity", "不确定性", "🌫️"], ["gapIndex", "留白指数", "🕳️"]
         ];
@@ -1123,9 +1146,12 @@ var TOOL_GROUPS = [
         );
             } else if (view === "reports") {
         // v3.2.0：报告历史（加载在入口 onClick 触发，此处纯渲染防 React 345 循环）
+        var reportReqId = 0;
         var openReport = function (file) {
+          var reqId = ++reportReqId;
           props.controller.set({ reportContent: "读取中…" });
-          fetch("/api/dsh-novel-writer/reports?read=" + encodeURIComponent(file), { headers: { accept: "application/json" } }).then(function (r2) { return r2.json(); }).then(function (d) {
+          fetch("/api/dsh-novel-writer/reports?read=" + encodeURIComponent(file), { headers: { accept: "application/json" } }).then(function (r2) { if (!r2.ok) throw new Error("HTTP " + r2.status); return r2.json(); }).then(function (d) {
+            if (reqId !== reportReqId) return; // v3.5.0 #47：快速切换时丢弃过期响应
             props.controller.set({ reportContent: d.ok ? JSON.stringify(d.content, null, 2) : ("读取失败：" + (d.error || "")) });
           }).catch(function () { props.controller.set({ reportContent: "读取失败（网络/路由不可用）" }); });
         };
@@ -1202,6 +1228,11 @@ var TOOL_GROUPS = [
           var newBookName = state.creationNewBook || "";
           var createNewBook = function () {
             var nb = String(newBookName || "").trim();
+            // v3.5.0 #49：客户端校验——路径分隔符/Windows 保留字符直接提示
+            if (nb && (/[\\/:*?"<>|]/.test(nb) || /[.\s]+$/.test(nb) || /^(con|prn|aux|nul|com[1-9]|lpt[1-9])$/i.test(nb))) {
+              props.controller.set({ revealMsg: "书名含非法字符（\\ / : * ? \" < > | 或结尾点/空格/系统保留名）", revealErr: true });
+              return;
+            }
             if (!nb) {
               var elInp = document.getElementById("nwNewBookInput");
               if (elInp) { elInp.focus(); elInp.style.borderColor = "#ef4444"; elInp.style.boxShadow = "0 0 0 3px rgba(239,68,68,.15)"; }
@@ -1220,7 +1251,7 @@ var TOOL_GROUPS = [
                 isDefault ? el("div", { style: { fontSize: "10px", color: "#cbd5e1", marginTop: "1px" } }, t("creation.defaultHint")) : null
               ),
               el("button", { type: "button", onClick: function () { props.controller.set({ creationBook: name, creationDraft: null, creationDirty: false }); props.controller.openView("creation-form"); } }, t("creation.edit")),
-              isDefault ? null : el("button", { type: "button", onClick: function () { var patch = {}; patch[name] = null; props.toggle({ creationProfiles: patch }); var nb = (props.controller.getSnapshot().books || []).filter(function (b) { return b !== name; }); props.controller.set({ books: nb, revealMsg: t("creation.deleted"), revealErr: false }); } }, t("creation.delete"))
+              isDefault ? null : el("button", { type: "button", onClick: function () { var patch = {}; patch[name] = null; props.toggle({ creationProfiles: patch }); props.controller.set({ revealMsg: t("creation.deleted"), revealErr: false }); } }, t("creation.delete"))
             );
           }
           body = el("div", null,
@@ -1314,6 +1345,8 @@ var TOOL_GROUPS = [
         var onFeatures = detailFeatures.filter(function (k) { return f[k] !== false; }).length;
         var onTools = ALL_TOOLS.filter(function (k) { return tools[k] !== false; }).length;
         body = el("div", null,
+          // v3.5.0 #37：保存失败/宿主不可达提示条
+          (state.saveFailed || state.hostOk === false) ? el("div", { key: "saveBanner", style: { padding: "7px 10px", marginBottom: "8px", borderRadius: "8px", background: "#fef3c7", border: "1px solid #fcd34d", color: "#92400e", fontSize: "11px", lineHeight: "1.5" } }, state.hostOk === false ? t("panel.localOnly") : t("panel.saveFailed")) : null,
           // v2.6.5：更新提示条（有新版才显示，点击跳 GitHub Release）
           state.updateCheck && state.updateCheck.updateAvailable && state.updateCheck.releaseUrl
             ? el("a", { className: "nwUpdateBar", href: state.updateCheck.releaseUrl, target: "_blank", rel: "noopener noreferrer" },
@@ -1373,7 +1406,9 @@ var TOOL_GROUPS = [
           el("div", { key: "statsCard", style: { marginTop: "10px", padding: "10px 12px", borderRadius: "10px", border: "1px solid #e2e8f0", background: "#fff" } },
             el("div", { style: { fontSize: "12px", fontWeight: "600", color: "#475569", marginBottom: "6px" } }, "📚 " + t("stats.title")),
             el("div", { style: { display: "flex", flexDirection: "column", gap: "5px" } },
-              (state.booksStats || []).length === 0
+              state.booksStats === null
+                ? el("div", { style: { fontSize: "11px", color: "#f59e0b" } }, t("stats.pending"))
+                : (state.booksStats || []).length === 0
                 ? el("div", { style: { fontSize: "11px", color: "#94a3b8" } }, t("stats.empty"))
                 : (state.booksStats || []).slice(0, 6).map(function (bs) {
                     var charsText = bs.chars >= 10000 ? (bs.chars / 10000).toFixed(1) + "万" : String(bs.chars || 0);
@@ -1390,7 +1425,7 @@ var TOOL_GROUPS = [
           // v3.2.0：报告历史入口
           el("button", { key: "reportsEntry", type: "button", style: { display: "flex", alignItems: "center", width: "100%", marginTop: "8px", padding: "9px 12px", borderRadius: "10px", border: "1px solid #e2e8f0", background: "#fff", cursor: "pointer", textAlign: "left" }, onClick: function () {
             props.controller.set({ reportsGroups: null, reportContent: null, reportLoading: true });
-            fetch("/api/dsh-novel-writer/reports", { headers: { accept: "application/json" } }).then(function (r2) { return r2.json(); }).then(function (d) {
+            fetch("/api/dsh-novel-writer/reports", { headers: { accept: "application/json" } }).then(function (r2) { if (!r2.ok) throw new Error("HTTP " + r2.status); return r2.json(); }).then(function (d) {
               props.controller.set({ reportsGroups: d.groups || [], reportLoading: false });
             }).catch(function () { props.controller.set({ reportsGroups: [], reportLoading: false }); });
             props.controller.openView("reports");
@@ -1404,7 +1439,7 @@ var TOOL_GROUPS = [
             el("button", { type: "button", disabled: state.demoLoading, style: { display: "flex", alignItems: "center", gap: "8px", width: "100%", background: "transparent", border: "none", padding: 0, cursor: state.demoLoading ? "default" : "pointer", textAlign: "left" }, onClick: function () {
               if (state.demoLoading) return;
               props.controller.set({ demoLoading: true });
-              fetch("/api/dsh-novel-writer/demo", { headers: { accept: "application/json" } }).then(function (r2) { return r2.json(); }).then(function (d) {
+              fetch("/api/dsh-novel-writer/demo", { headers: { accept: "application/json" } }).then(function (r2) { if (!r2.ok) throw new Error("HTTP " + r2.status); return r2.json(); }).then(function (d) {
                 props.controller.set({ demoReport: d.ok ? d.report : ("演示失败：" + (d.error || "")), demoLoading: false });
               }).catch(function () { props.controller.set({ demoReport: "演示失败（网络/路由不可用）", demoLoading: false }); });
             } },
@@ -1606,6 +1641,7 @@ var TOOL_GROUPS = [
             creationProfile: remote.creationProfile || null,
             creationProfiles: remote.creationProfiles || {},
             books: remote.books || [],
+            booksStats: typeof remote.booksStats === "undefined" ? null : (remote.booksStats || []),
             dirs: remote.dirs || null,
             file: remote.file || "",
             source: "host",
@@ -1619,6 +1655,12 @@ var TOOL_GROUPS = [
           controller.set({
             enabled: typeof local.enabled === "boolean" ? local.enabled : true,
             autoAnalyze: typeof local.autoAnalyze === "boolean" ? local.autoAnalyze : true,
+            // v3.5.0 #38：完整恢复本地降级状态
+            tools: local.tools || {},
+            features: local.features || {},
+            styleTolerance: local.styleTolerance || null,
+            creationProfile: local.creationProfile || null,
+            creationProfiles: local.creationProfiles || {},
             source: "local",
             hostOk: false,
             loading: false
@@ -1663,7 +1705,8 @@ var TOOL_GROUPS = [
         controller.set({ hostOk: false, saveFailed: true, source: "local" });
         try {
           var snapshot = controller.getSnapshot();
-          localStorage.setItem(STORAGE_KEY, JSON.stringify({ enabled: snapshot.enabled, autoAnalyze: snapshot.autoAnalyze }));
+          // v3.5.0 #38：宿主不可达时完整持久化（刷新不丢 tools/features/容差/设定）
+          localStorage.setItem(STORAGE_KEY, JSON.stringify({ enabled: snapshot.enabled, autoAnalyze: snapshot.autoAnalyze, tools: snapshot.tools || {}, features: snapshot.features || {}, styleTolerance: snapshot.styleTolerance || null, creationProfile: snapshot.creationProfile || null, creationProfiles: snapshot.creationProfiles || {} }));
         } catch (error) { /* ignore */ }
       };
             controller.setToggle(toggle);

package/lib/embedding.js

@@ -23,6 +23,8 @@ try {
   }
 } catch { /* 旧 Node：回退纯 JSON 缓存 */ }
 const MODEL_DIR = path.join(__dirname, "models");
+const MODEL_NAME = "bge-small-zh-v1.5"; // v3.5.0 #55：索引缓存模型标识（换模型旧缓存作废）
+const EMBED_DIM = 128; // v3.5.0 #55：缓存向量维度（降采样后）
 const EMBEDDING_CACHE_ROOT = ".novel-writer";
 
 let enginePromise = null;
@@ -113,8 +115,11 @@ async function embedMany(chunks) {
   const worker = async () => {
     while (cursor < chunks.length) {
       const i = cursor; cursor += 1;
-      const vec = await embed(chunks[i].text);
-      out[i] = vec ? { id: chunks[i].id, text: chunks[i].text, vec } : null;
+      // v3.5.0 #53：单块容错——一块 embed 抛错（WASM 抖动/超长）不拖垮整本书索引
+      try {
+        const vec = await embed(chunks[i].text);
+        out[i] = vec ? { id: chunks[i].id, text: chunks[i].text, vec } : null;
+      } catch { out[i] = null; }
     }
   };
   await Promise.all(Array.from({ length: 4 }, worker));
@@ -279,6 +284,8 @@ function loadIndex(root, book) {
   try {
     const data = readIndexData(root, book);
     if (!data) return null;
+    // v3.5.0 #55：与 loadIndexMeta 一致——model/dim 不符视为无缓存
+    if (data.model !== MODEL_NAME || data.dim !== EMBED_DIM) return null;
     return data.items.map((item) => ({ id: item.id, text: item.t, vec: item.v, chapter: item.ch ?? null }));
   } catch { return null; }
 }
@@ -288,6 +295,8 @@ function loadIndexMeta(root, book) {
   try {
     const data = readIndexData(root, book);
     if (!data) return { items: null, fp: null };
+    // v3.5.0 #55：缓存校验 model/dim——换模型/维度变化时旧缓存作废（触发重建），防 cosine 恒 0
+    if (data.model !== MODEL_NAME || data.dim !== EMBED_DIM) return { items: null, fp: null };
     return {
       items: data.items.map((item) => ({ id: item.id, text: item.t, th: item.th ?? null, vec: item.v, chapter: item.ch ?? null })),
       fp: data.fp ?? null