dsh-novel-writer 2.0.0 → 2.0.2

package/README.en.md

@@ -1,20 +1,104 @@
-# dsh-novel-writer — Novel Writing Assistant Plugin (v2.0.0)
+# 📚 dsh-novel-writer — Novel Writing Assistant
 
-A DSH (DeepSeek Harness) bundle plugin. **v2.0.0 ships a local semantic embedding engine (bge-small-zh-v1.5 ONNX, bundled, CPU inference, 0 token cost)** — semantic capabilities without any API fees.
+English | [**中文**](./README.md)
 
-## Tools (14, each with an independent UI switch)
-novel_books / novel_chapters / novel_read / novel_keywords / novel_new_chapter / novel_import / novel_sentence_analysis / novel_sentence_config / novel_style_check / novel_plot / novel_settings / novel_summary / novel_continuity_check / **novel_semantic_search (new in v2.0.0)**
+[![npm version](https://img.shields.io/npm/v/dsh-novel-writer.svg?style=flat-square&color=blue)](https://www.npmjs.com/package/dsh-novel-writer)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg?style=flat-square)](LICENSE)
+[![GitHub stars](https://img.shields.io/github/stars/siweina/dsh-novel-writer.svg?style=flat-square&color=orange)](https://github.com/siweina/dsh-novel-writer/stargazers)
+[![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)
 
-## v2.0.0 — Semantic Layer
-- **Local engine** (lib/embedding.js): Xenova/bge-small-zh-v1.5 (quantized), 512-dim Chinese vectors, ~23MB, bundled; @huggingface/tokenizers + onnxruntime-web (WASM), local CPU, 0 token / 0 API cost;
-- **Lazy load** (~0.3s first call); automatic fallback to pure-rule mode if unavailable;
-- **Index cache**: per-book vectors at `.novel-writer/embedding/<book>.json` — repeated searches are instant;
-- **novel_semantic_search**: natural-language search across the whole book (foreshadowing clues, emotional scenes, setting mentions) — matches by meaning even when keywords differ;
-- **novel_style_check upgrade**: adds semantic similarity (target chapter vs rest of book) alongside rule-based fingerprint similarity;
-- **Switch: semanticEmbedding** — default ON (probe-based: auto-enabled when the model is present); turn it off in the sidebar「写作助手功能」panel to fully return to rule-only mode.
+A novel-writing assistant plugin for **DeepSeek Harness (DSH)**: chapter library management, sentence-pattern analysis, emotion purification & quantification, style checking, plot tracking, settings management, worldview/pragmatics detection, **local semantic search (0 token)**, batch import, and AI-assisted continuation writing. Zero third-party dependencies on host.
 
-## History (v0.3 → v1.6)
-Sentence-pattern analysis; emotion purification + AI review (strong/weak lexicon, pollution caveat); emotion quantification (Valence sliding window: variance/slope/conflict + implicit imagery + complexity score); worldview/genre/theme detection (modern/western/eastern + 15 genres + 35 themes); pragmatic-style review; settings tables (5) + foreshadowing registry + summaries + continuity audit + style check; analysis cache & report export (`.novel-writer/analysis/`).
+---
 
-## Size
-~95MB total (23MB quantized model + 70MB runtime); zip 31MB. If disk is tight, disable the semantic switch and delete `lib/models/` + `node_modules/` to go back to rule-only.
+## Installation
+
+**Option 1: npm (recommended)**
+
+```sh
+dsh plugin --profile web add dsh-novel-writer
+# or
+npm install dsh-novel-writer
+```
+
+**Option 2: From GitHub**
+
+```sh
+dsh plugin --profile web add github:siweina/dsh-novel-writer#main
+```
+
+After installing, **restart the web app** to activate (host registers 14 tools + state/reveal routes; browser mounts the "Writing Assistant" sidebar toggle panel).
+
+---
+
+## v2.0.0 New: Local Semantic Engine (0 token)
+
+- 🧠 **Built-in Chinese semantic model** (bge-small-zh-v1.5 quantized, 23MB, shipped with the plugin): 512-dim vectors, local CPU inference, **zero API cost**;
+- 🔍 **novel_semantic_search**: search the whole book with natural language for semantically related passages (foreshadowing/emotional scenes/settings), even without matching keywords;
+- 📊 **Semantic style comparison**: novel_style_check adds a semantic-similarity dimension beyond rule-based fingerprints;
+- 💭 **Semantic implicit emotion**: emotion prototype sentences scan the book index to find "imagery passages outside the word list";
+- 🪶 Lazy loading + automatic fallback to pure-rule mode (never breaks existing features).
+
+---
+
+## Features
+
+1. **Chapter library**: chapters in `novels/<book>/第N章.md` (or .txt/.markdown); auto encoding detection (UTF-8/UTF-16/GBK).
+2. **Sentence-pattern analysis**: 9 categories, arrangement patterns, rhythm, emotion curve, style fingerprint + guidance, with cache & report export.
+3. **Emotion purification**: strong/weak emotion-word grading, pollution-source detection, caveat warning + AI re-verification, cleanDominant true baseline.
+4. **Emotion quantification** (v1.6.0): Valence mapping + sliding window → variance V / delta Δ / conflict index C; implicit imagery carriers + explicit-implicit conflict; complexity score + composite emotion pairs.
+5. **Style check**: chapter vs book → similarity + deviation list + advice.
+6. **Plot tracking**: foreshadowing/plot-hook registry (open/done), typed fields + auto mention tracking.
+7. **Settings management**: five tables — characters / locations / items / timeline / worldview.
+8. **Worldview & pragmatics detection**: auto cultural-baseline detection with confidence; speechStyle title/honorifics/rituals/tone norms.
+9. **Genre & theme detection**: primary/secondary themes + genre, low-frequency noise filtered.
+10. **Chapter summaries**: per-chapter digest + key events for long-book continuation.
+11. **Continuity audit**: settings conflicts + pragmatics conflicts with replacement suggestions.
+12. **Batch import**: auto-detect book names & chapter numbers, classified import.
+13. **Continuation writing**: read-first workflow; keeps style/foreshadowing/worldview consistent.
+14. **Per-tool UI toggles**: "Writing Assistant" sidebar panel (master + per-tool + feature toggles).
+
+---
+
+## Provided Tools (14)
+
+| Tool | Description |
+|------|-------------|
+| `novel_books` | List all books in library |
+| `novel_chapters` | List a book's chapters |
+| `novel_read` | Read a chapter (paginated) |
+| `novel_keywords` | Keywords: bigram/trigram/name candidates |
+| `novel_new_chapter` | Create new chapter file |
+| `novel_import` | Batch import manuscripts |
+| `novel_sentence_analysis` | Sentence-pattern analysis |
+| `novel_sentence_config` | View/set tool & feature toggles |
+| `novel_style_check` | Style check (rule + semantic) |
+| `novel_plot` | Plot/foreshadowing tracker |
+| `novel_settings` | Settings management (+worldview) |
+| `novel_summary` | Chapter summaries |
+| `novel_continuity_check` | Continuity audit |
+| `novel_semantic_search` | **Semantic search** (v2.0.0, local embedding, 0 token) |
+
+---
+
+## Configuration
+
+```yaml
+- id: novel-writer
+  config:
+    root: 'D:/my-novel-library'
+    allowLanState: false   # true = allow state save from LAN GUI access
+```
+
+---
+
+## Data Directory
+
+Under `<library-root>/.novel-writer/`: `plots` / `settings` / `summaries` / `analysis` / `audits` / `embedding` (semantic index cache).
+
+---
+
+## License
+
+[MIT](./LICENSE)

package/README.md

@@ -1,55 +1,104 @@
-# dsh-novel-writer — 小说写作助手插件（v2.0.0）
+# 📚 dsh-novel-writer — 小说写作助手
 
-DSH（DeepSeek Harness）小说写作助手 bundle 插件。**v2.0.0 集成本地语义嵌入引擎（bge-small-zh-v1.5 ONNX，随插件分发，本地 CPU 推理，0 token 成本）**，在不增加任何 API 费用的前提下获得语义级能力。
+[**English**](./README.en.md) | 中文
 
-## 工具清单（14 个，全部带独立 UI 开关）
+[![npm version](https://img.shields.io/npm/v/dsh-novel-writer.svg?style=flat-square&color=blue)](https://www.npmjs.com/package/dsh-novel-writer)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg?style=flat-square)](LICENSE)
+[![GitHub stars](https://img.shields.io/github/stars/siweina/dsh-novel-writer.svg?style=flat-square&color=orange)](https://github.com/siweina/dsh-novel-writer/stargazers)
+[![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)
 
-novel_books / novel_chapters / novel_read / novel_keywords / novel_new_chapter / novel_import / novel_sentence_analysis / novel_sentence_config / novel_style_check / novel_plot / novel_settings（设定管理）/ novel_summary（章节摘要）/ novel_continuity_check（连贯性审计）/ **novel_semantic_search（语义检索，v2.0.0 新增）**
+为 **DeepSeek Harness (DSH)** 打造的小说写作助手插件：章节库管理、句式模式分析、情感净化与量化、风格自检、伏笔登记、设定管理、世界观/语用检测、**本地语义检索（0 token）**、批量导入与 AI 续写辅助。宿主端零第三方依赖，浏览器端仅依赖 Web GUI 自带的 react。
 
-## v2.0.0 新增能力（语义层）
+---
 
-### 本地语义嵌入引擎（embedding.js）
-- 模型：Xenova/bge-small-zh-v1.5（512 维中文向量，约 91MB），随插件分发，开箱即用；
-- 运行时：**@huggingface/tokenizers**（官方轻量分词，294KB 零依赖）+ onnxruntime-web（WASM 推理），本地 CPU，0 token、0 API 费用；
-- 懒加载：首次调用才加载（约 0.3s）；加载失败自动回退纯规则，不影响任何既有功能；
-- 索引缓存：每书向量落盘 `.novel-writer/embedding/<书>.json`，重复检索秒开（47 万字约 3100 段，首次建索引约 20-30s，之后命中缓存）。
+## 安装
 
-### 新工具：novel_semantic_search（语义检索）
-用自然语言描述在全书中检索语义相关段落——找伏笔线索、情感场景、设定提及，**即使原文没有相同关键词也能命中**（如搜「压抑克制的时刻」能命中没有"压抑"二字的段落）。
+**方式一：npm（推荐）**
 
-### novel_style_check 升级：语义级风格对比
-规则指纹相似度（句式/句长/情绪）之外，新增**语义相似度**（目标章 vs 全书其余部分向量余弦），双维度判定风格一致性。
+```sh
+dsh plugin --profile web add dsh-novel-writer
+# 或
+npm install dsh-novel-writer
+```
 
-### 功能开关：语义增强（semanticEmbedding）
-- **默认开启（探测式）**：模型存在即自动启用；用户可在侧边栏「写作助手功能」面板关闭，关闭后语义检索返回提示、风格检查跳过语义维度；
-- 关闭后插件完整回退到 v1.6.0 纯规则能力。
+**方式二：从 GitHub 安装**
 
-## 历史能力（v0.3 → v1.6 累积）
-- 句式模式分析（九类句式分布/排列/段落/句长/情感曲线/风格指纹/密度）；
-- 情感净化 + AI 复核（强/弱情绪词分级、污染预警 caveat、强制抽查）；
-- 情感量化（Valence 滑动窗口：方差/斜率/矛盾指数 + 隐性意象 + 复杂度评分）；
-- 世界观/流派/题材检测（modern/western/eastern + 15 流派 + 35 题材，主副题材）；
-- 语用级审查（称谓/客套/仪式/语气，中西/现代禁用词）；
-- 设定管理五张表 + 伏笔登记 + 章节摘要 + 连贯性审计 + 风格自检；
-- 分析缓存与报告导出（`.novel-writer/analysis/`）。
+```sh
+dsh plugin --profile web add github:siweina/dsh-novel-writer#main
+```
 
-## 功能开关（侧边栏「写作助手功能」面板）
-- 总开关 enabled；autoAnalyze；14 个工具级开关；
-- 功能级：emotionCaveat（情感净化预警）/ genreTheme（题材与流派检测）/ emotionComplexity（情感量化）/ **semanticEmbedding（语义增强，v2.0.0）**。
+安装后**重启 web 应用**生效（宿主端注册 14 个工具与 state/reveal 路由，浏览器端挂载侧边栏「写作助手功能」开关面板）。
 
-## 目录结构
-```
-dsh-novel-writer-v2.0.0/
-├── lib/
-│   ├── index.js        # 宿主端（14 工具 + state 路由 + 开关门禁）
-│   ├── analysis.js     # 规则引擎（句式/情感净化/情感量化/题材）
-│   ├── embedding.js    # 本地语义嵌入引擎（bge-small-zh ONNX）
-│   ├── models/         # 模型文件（onnx/model.onnx 91MB + tokenizer）
-│   └── client.js       # 浏览器端（侧边栏面板 + 全部开关）
-├── node_modules/       # @huggingface/tokenizers + onnxruntime-web（随插件分发）
-├── test/               # 引擎 + client + e2e 测试
-└── skills/novel-writing/SKILL.md  # 模型使用指南
+---
+
+## v2.0.0 新增：本地语义引擎（0 token）
+
+- 🧠 **内置中文语义模型**（bge-small-zh-v1.5 quantized，23MB，随插件分发）：512 维向量，本地 CPU 推理，**零 API 费用**；
+- 🔍 **novel_semantic_search**：用自然语言搜全书语义相关段落（伏笔/情感场景/设定提及），即使原文没有相同关键词也能命中；
+- 📊 **语义级风格对比**：novel_style_check 在规则指纹之外新增语义相似度维度；
+- 💭 **语义隐性情感**：情感原型句扫全书索引，发现"词表外疑似意象段落"；
+- 🪶 懒加载 + 失败自动回退纯规则（不影响任何既有功能）。
+
+---
+
+## 功能
+
+1. **章节库管理**：章节存放于 `novels/<书名>/第N章.md`（或 .txt/.markdown），编码自动探测（UTF-8/UTF-16/GBK）。
+2. **句式模式分析**：九类句式分布、排列规律、句长节奏、情感曲线、风格指纹与节奏建议，带缓存与报告导出。
+3. **情感净化**：强/弱情绪词分级、污染源检测、caveat 预警 + AI 复核闭环、cleanDominant 真实基调。
+4. **情感量化**（v1.6.0）：Valence 效价映射 + 滑动窗口 → 方差 V / 斜率 Δ / 矛盾指数 C；隐性意象载体 + 显隐冲突；复杂度评分 + 复合情感共现。
+5. **风格自检**：章节 vs 全书 → 相似度 + 偏差清单 + 续写建议。
+6. **伏笔登记表**：open/done 状态、字段化登记、章节提及自动追踪。
+7. **设定管理**：人物/地点/道具/时间线/世界观 五张表。
+8. **世界观与语用检测**：自动判断文化基准（西/东/混合）+ 置信度；speechStyle 称谓/客套/仪式/语气规范。
+9. **题材与流派检测**：主副题材 + 流派识别，低频噪音自动过滤。
+10. **章节摘要**：每章摘要 + 关键事件，长书续写先读摘要。
+11. **连贯性审计**：设定矛盾 + 语用冲突候选，带建议替换。
+12. **批量导入**：原稿件自动识别书名与章节号分类导入。
+13. **续写辅助**：先读后写、保持文风/伏笔/世界观一致。
+14. **全工具 UI 开关**：侧边栏「写作助手功能」面板（总开关 + 每工具开关 + 功能开关）。
+
+---
+
+## 提供的工具（14 个）
+
+| 工具 | 说明 |
+|------|------|
+| `novel_books` | 列出章节库全部作品 |
+| `novel_chapters` | 列出某作品章节清单 |
+| `novel_read` | 阅读某章正文（分段） |
+| `novel_keywords` | 关键词：二字组/三字组/疑似人名 |
+| `novel_new_chapter` | 创建新章节文件 |
+| `novel_import` | 原稿件批量导入/分类 |
+| `novel_sentence_analysis` | 句式模式分析（九类/情感净化/量化/曲线/指纹） |
+| `novel_sentence_config` | 查看/修改工具与功能开关 |
+| `novel_style_check` | 风格自检（规则+语义双维度） |
+| `novel_plot` | 伏笔/剧情线登记表 |
+| `novel_settings` | 设定管理（人物/地点/道具/时间线/世界观） |
+| `novel_summary` | 章节摘要（长书续写辅助） |
+| `novel_continuity_check` | 连贯性审计（设定矛盾+语用冲突候选） |
+| `novel_semantic_search` | **语义检索**（v2.0.0，本地 embedding，0 token） |
+
+---
+
+## 配置
+
+```yaml
+- id: novel-writer
+  config:
+    root: 'D:/我的小说库'
+    allowLanState: false   # true=局域网访问 GUI 时也允许保存开关
 ```
 
-## 体积说明
-**约 95MB**（模型 23MB + 运行时 70MB），zip 31MB；已移除 transformers.js/onnxruntime-node/sharp 全家桶（省 85%）。如磁盘紧张可在「语义增强」开关关闭后删除 `lib/models/` 与 `node_modules/`，插件回到纯规则模式。
+---
+
+## 数据目录
+
+`<书库根>/.novel-writer/`：`plots`（伏笔）/ `settings`（设定）/ `summaries`（摘要）/ `analysis`（分析报告）/ `audits`（审计）/ `embedding`（语义索引缓存）。
+
+---
+
+## 许可证
+
+[MIT](./LICENSE)

package/lib/index.js

@@ -1643,10 +1643,11 @@ function registerNovelStyleCheck(ctx, config) {
             if (!allTexts[i]) continue;
             for (const p of embedding.chunkText(allTexts[i])) allChunks.push({ ...p, id: String(i) + "|" + p.id });
           }
-          let index = embedding.loadIndex(root, book + "__style");
+          const styleCacheKey = book + "__style_" + String(chapterArg).replace(/[\\/:*?"<>|]/g, "_");
+          let index = embedding.loadIndex(root, styleCacheKey);
           if (!index || index.length === 0) {
             index = await embedding.embedMany(allChunks);
-            embedding.saveIndex(root, book + "__style", index);
+            embedding.saveIndex(root, styleCacheKey, index);
           }
           // 目标章段落向量 vs 其他章段落向量，平均余弦作为语义风格相似度
           const targetChunks = allChunks.filter((ch) => ch.id.startsWith("0|"));
@@ -1664,6 +1665,9 @@ function registerNovelStyleCheck(ctx, config) {
               note: semSim >= 0.55 ? "语义风格高度一致" : semSim >= 0.45 ? "语义风格中等一致" : "语义风格存在差异，注意写法口吻",
               enabled: true
             };
+          } else {
+            // v2.0.0 修复：样本不足时也返回对象（schema 要求 semantic 为 object）
+            semantic = { enabled: false, note: "语义对比样本不足（目标章或基准章为空）" };
           }
         } catch (e) { semantic = { enabled: false, note: "语义对比失败：" + String(e).slice(0, 80) }; }
       } else {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-novel-writer",
-  "version": "2.0.0",
-  "description": "小说写作助手插件（v2.0.0）：本地语义嵌入（bge-small-zh ONNX，0 token）——语义检索/语义风格对比/情感量化/世界观题材流派/语用审查，14 工具全 UI 开关",
+  "version": "2.0.2",
+  "description": "小说写作助手插件（v2.0.2）：本地语义嵌入（bge-small-zh ONNX，0 token）——语义检索/语义风格对比/情感量化/世界观题材流派/语用审查，14 工具全 UI 开关",
   "type": "module",
   "main": "lib/index.js",
   "exports": {
@@ -38,4 +38,4 @@
     "onnxruntime-web": "^1.24.3"
   },
   "license": "MIT"
-}
+}