dsh-novel-writer 4.3.0 → 4.3.1

package/README.en.md

@@ -1,5 +1,7 @@
 # 📚 dsh-novel-writer — on-device style checkup for novel writers
 
+> 🌐 **[Project site](https://siweina.github.io/dsh-novel-writer/)** · [Technical docs — implementation details, formulas and limits for all 16 tools](https://siweina.github.io/dsh-novel-writer/tools/)
+
 English | [中文](./README.md)
 
 [![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)
@@ -8,6 +10,7 @@ English | [中文](./README.md)
 [![Node](https://img.shields.io/badge/node-%3E%3D22.3-339933.svg?style=flat-square)](https://nodejs.org)
 [![DSH](https://img.shields.io/badge/DSH-%E2%89%A50.1.1--rc.2-4b8bbe.svg?style=flat-square)](https://github.com/deepseek-ai/deepseek-harness)
 [![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)
+[![siweina/dsh-novel-writer MCP server](https://glama.ai/mcp/servers/siweina/dsh-novel-writer/badges/score.svg)](https://glama.ai/mcp/servers/siweina/dsh-novel-writer)
 
 **16 tools that turn "my writing drifted" into numbers you can act on.**
 Sentence, emotion and style-baseline analysis all run **on your machine**: a 24MB Chinese model ships with the package,

package/README.md

@@ -1,5 +1,7 @@
 # 📚 dsh-novel-writer — 给网文作者的本地章节体检
 
+> 🌐 **[在线主页](https://siweina.github.io/dsh-novel-writer/)** · [完整技术文档（16 个工具的实现细节、公式与约束）](https://siweina.github.io/dsh-novel-writer/tools/)
+
 [English](./README.en.md) | 中文
 
 [![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)
@@ -8,6 +10,7 @@
 [![Node](https://img.shields.io/badge/node-%3E%3D22.3-339933.svg?style=flat-square)](https://nodejs.org)
 [![DSH](https://img.shields.io/badge/DSH-%E2%89%A50.1.1--rc.2-4b8bbe.svg?style=flat-square)](https://github.com/deepseek-ai/deepseek-harness)
 [![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)
+[![siweina/dsh-novel-writer MCP server](https://glama.ai/mcp/servers/siweina/dsh-novel-writer/badges/score.svg)](https://glama.ai/mcp/servers/siweina/dsh-novel-writer)
 
 **16 个工具，把"文风跑偏"变成可量化的数字。**
 句式 / 情感 / 风格基线全部**在本地算**：24MB 中文模型随包分发，**零 API 花费、正文不出本机**。

package/cordis.patch.yml

@@ -1,4 +1,4 @@
-# dsh-novel-writer v4.3.0 bundle patch: 16 tools (incl. novel_semantic_search) + local embedding engine.
+# dsh-novel-writer v4.3.1 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/core.js

@@ -375,14 +375,31 @@ export async function chapterStats(bookPath, chapter, exec) {
 }
 export function findChapter(chapters, chapterArg) {
   const needle = String(chapterArg).trim();
+  const lower = needle.toLowerCase();
+  // v4.3.1 修正（P0）：精确文件名（含省略扩展名的文件名）**优先于**章号解析。
+  // 旧版把章号匹配放在最前，于是「第03章 重逢.md」这种完整文件名也会被 parseChapterNumber 解析出章号 3，
+  // 命中同章的另一个文件；被抢走的那一份用章号/文件名/标题三条路都读不到（永久不可达，实测复现）。
+  const plain = lower.replace(/\.(md|markdown|txt)$/i, "");
+  const byFile = chapters.find((c) => {
+    const file = c.file.toLowerCase();
+    return file === lower || file.replace(/\.[^.]+$/, "") === plain;
+  });
+  if (byFile) return byFile;
   const asNumber = parseChapterNumber(needle);
   if (asNumber !== void 0) {
-    const byNumber = chapters.find((c) => c.number === asNumber);
-    if (byNumber) return byNumber;
+    const matched = chapters.filter((c) => c.number === asNumber);
+    // v4.3.1 修正（P0）：同章号多文件不再"静默取排序后的第一个"——那会让另一份永远读不到。
+    // 改为拒绝并列出候选；候选文件名可直接回传给 chapter 参数（文件名匹配已在上方优先）。
+    if (matched.length > 1) {
+      throw new Error(
+        `第 ${asNumber} 章有 ${matched.length} 个文件，无法确定要哪一份：` +
+        matched.map((c) => c.file).join("、") +
+        `。请把 chapter 参数写成其中一个文件名（可省略扩展名）来指定；` +
+        `或用 novel_continuity_check 查看同章号清单后改名。`
+      );
+    }
+    if (matched.length === 1) return matched[0];
   }
-  const lower = needle.toLowerCase();
-  const byFile = chapters.find((c) => c.file.toLowerCase() === lower);
-  if (byFile) return byFile;
   // v4.0.0 修正：纯数字参数必须"章号完全相等"，否则 findChapter("1") 会子串命中第 10/11/12 章
   // v4.3.0 修正：这里原有一段 `chapters.find(c => String(c.number) === needle)` 的"精确查找"，
   // 恒为无效代码——走到此处说明没有任何章号的数值等于 asNumber，而 c.number 是 parseChapterNumber 产出的
@@ -2278,6 +2295,22 @@ export function formatChapters(value) {
     const number = chapter.number === void 0 ? "?" : String(chapter.number).padStart(2, "0");
     lines.push(`- 第${number}章 ${chapter.title} — ${chapter.chars} 字 / ${chapter.lines} 行 (${chapter.file}, 更新于 ${chapter.updated.slice(0, 10)})`);
   }
+  // v4.3.1：同章号多文件提示。这类书按章号读取会被 findChapter 拒绝（避免静默读错稿），
+  // 但列表里两条只是"同名条目"，不主动说明的话用户不知道磁盘上是两份文件——必须在这里就看见。
+  const dupByNumber = new Map();
+  for (const chapter of value.chapters) {
+    if (chapter.number === void 0) continue;
+    const list = dupByNumber.get(chapter.number) ?? [];
+    list.push(chapter.file);
+    dupByNumber.set(chapter.number, list);
+  }
+  const conflicts = [...dupByNumber.entries()].filter(([, files]) => files.length > 1);
+  if (conflicts.length > 0) {
+    lines.push("", `⚠️ 同章号多文件 ${conflicts.length} 组（按章号读取会因歧义被拒绝；请改名到空闲章号，或用 novel_import 重新导入自动避让）：`);
+    for (const [number, files] of conflicts) {
+      lines.push(`  第${String(number).padStart(2, "0")}章: ${files.join(" / ")}`);
+    }
+  }
   lines.push("", "</content>");
   return lines.join("\n");
 }

package/lib/index.js

@@ -1964,6 +1964,24 @@ function registerNovelContinuityCheck(ctx, config) {
         };
       }
       const candidates = [];
+      // v4.3.1（P0）：同章号多文件检测。findChapter 现在会在章号命中多个文件时拒绝执行（不再静默读错稿），
+      // 所以在审计里先把撞号清单摆出来，否则用户只看到"读取失败"却不知道哪几章撞了。
+      const dupByNumber = new Map();
+      for (const c of chapters) {
+        if (c.number === void 0) continue;
+        const list = dupByNumber.get(c.number) ?? [];
+        list.push(c.file);
+        dupByNumber.set(c.number, list);
+      }
+      for (const [number, files] of dupByNumber) {
+        if (files.length > 1) {
+          candidates.push({
+            type: "同章号多文件",
+            detail: `第 ${number} 章有 ${files.length} 个文件共用同一章号：${files.join("、")}——按章号读取会被拒绝（需改用文件名指定）`,
+            chapters: files
+          });
+        }
+      }
       // v3.2.0：大纲 vs 实际偏离检查
       // v4.0.0 修正：移到全书读取之前——大纲模式不用 chapterTexts，旧版先无条件读完全书再进分支，
       // 且分支内又对每章整读一遍再 slice(0,600)（同一章读两遍，第一遍纯浪费）

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "dsh-novel-writer",
-    "version": "4.3.0",
-    "description": "小说写作助手插件（v4.3.0）：句式/情感/意象分析、伏笔设定管理、本地语义检索、氛围光谱、风格画像报告、文笔六维基线带、原创模式与创作资料、写作哨兵（衔接/OOC/大纲）；附 stdio MCP 服务器（Claude Desktop / Cursor 可用）。",
+    "version": "4.3.1",
+    "description": "小说写作助手插件（v4.3.1）：句式/情感/意象分析、伏笔设定管理、本地语义检索、氛围光谱、风格画像报告、文笔六维基线带、原创模式与创作资料、写作哨兵（衔接/OOC/大纲）；附 stdio MCP 服务器（Claude Desktop / Cursor 可用）。",
     "mcpName": "io.github.siweina/dsh-novel-writer",
     "type": "module",
     "main": "lib/index.js",

package/server.json

@@ -3,7 +3,7 @@
   "name": "io.github.siweina/dsh-novel-writer",
   "title": "dsh-novel-writer — 网文写作体检",
   "description": "Offline toolkit: 16 tools for Chinese web-novel style, plot-thread and continuity audits.",
-  "version": "4.3.0",
+  "version": "4.3.1",
   "repository": {
     "url": "https://github.com/siweina/dsh-novel-writer",
     "source": "github"
@@ -13,7 +13,7 @@
     {
       "registryType": "npm",
       "identifier": "dsh-novel-writer",
-      "version": "4.3.0",
+      "version": "4.3.1",
       "runtimeHint": "npx",
       "packageArguments": [
         {