dsh-novel-writer 0.3.0 → 0.4.0

package/README.md

@@ -1,31 +1,25 @@
-# dsh-novel-writer — 小说写作助手插件（v0.3.0）
+# dsh-novel-writer — 小说写作助手插件
 
-DSH（DeepSeek Harness）小说写作助手 bundle 插件。宿主端零第三方依赖（仅 Node 内置模块），
-浏览器端仅依赖 Web GUI 自带的 react。为 AI 提供小说章节库管理、分析与续写辅助能力；
-v0.3.0 新增**句式模式分析**扩展与 **Web UI 开关**。
+DSH（DeepSeek Harness）小说写作助手 bundle 插件。零第三方依赖（仅 Node 内置模块），
+为 AI 提供小说章节库管理、分析与续写辅助能力。
 
-## 功能
+## 功能（对应需求）
 
 1. **章节库**：章节存于 `novels/<书名>/第N章.md`（或 `.txt`/`.markdown`），
    插件提供 `novel_books` / `novel_chapters` / `novel_read` 让 AI 浏览并读取每一章内容。
    章节文件名中的序号支持任意位置与多种写法，例如：
    `第01章.md`、`01-标题.md`、`原稿件-单章-…第一章.txt`、`原稿件-单章-第25章 .txt`
    （阿拉伯数字与中文数字"第一章/第十四章/第三十章"均可识别，自动按章号排序）。
-   文件编码自动探测：UTF-8（含/不含 BOM）、UTF-16 LE/BE（含 BOM 或启发式识别）、GBK/GB18030（无 BOM）。
-2. **分析**：`novel_keywords` 确定性提取全书/单章高频关键词（中文相邻二字词组 + 高频单字 + 英文词）。
-3. **句式模式分析（v0.3.0 新增）**：`novel_sentence_analysis` 对全书/单章输出——
-   - 句式分布：陈述 / 对话 / 心理 / 疑问 / 反问 / 感叹 / 祈使 / 省略留白（比例、句数、均长、例句）；
-   - 排列规律：句式转移、2/3 连句高频模板、段首/段尾句式、纯对话段/纯心理段/混合段统计；
-   - 句长节奏：均值/中位数、短句/长句占比；
-   - 主观情感：轻量情感词典（喜/怒/哀/惧/惊）+ 强度副词加权 → 主导情绪、情绪分布、情感曲线、主观性指数；
-   - 风格指纹：一维紧凑签名，方便 AI 快速比对与复刻作者的句式习惯。
-4. **UI 开关（v0.3.0 新增）**：Web GUI 侧边栏出现「句式分析」入口，面板内两个开关：
-   - **启用句式分析（enabled）**：控制 novel_sentence_analysis 是否可用；
-   - **自动分析（autoAnalyze）**：控制 AI 分析作品时是否主动附带句式报告。
-   开关实时写入宿主端 `~/.dsh/dsh-novel-writer/state.json`，与 `novel_sentence_config` 工具双向同步；
-   宿主端不可达时降级保存在浏览器 localStorage。
-5. **续写**：系统提示词规定续写工作流（先读后写、保持文风与伏笔一致），
+   文件编码自动探测：UTF-8（含/不含 BOM）、UTF-16 LE/BE（含 BOM 或启发式识别）、GBK/GB18030（无 BOM），
+   无需手动转码即可读取（如记事本另存的 Unicode 文本）。
+2. **分析**：`novel_keywords` 确定性提取全书/单章高频关键词（中文相邻二字词组 + 高频单字 + 英文词），
+   配合系统提示词引导 AI 分析剧情脉络、写作手法、词汇偏好与意象母题。
+3. **续写**：系统提示词规定续写工作流（先读后写、保持文风与伏笔一致），
    `novel_new_chapter` 创建新章节文件。
+4. **原稿件批量导入/自动分类**：`novel_import` 扫描存放多本小说稿件的文件夹
+   （支持子文件夹、UTF-16/GBK 等编码、任意位置章号），从文件名与文件头内容双通道
+   提取书名候选并聚合成分组建议（scan 模式），AI 确认后可一键按书分类复制/移动到
+   `novels/<书名>/`（apply 模式）；支持 `book` 强制归并异名同书、`files` 精确指定文件。
 
 ## 提供的工具
 
@@ -36,44 +30,49 @@ v0.3.0 新增**句式模式分析**扩展与 **Web UI 开关**。
 | `novel_read` | 阅读某章正文（行号 + 字数统计，offset/limit 分段） |
 | `novel_keywords` | 提取高频关键词（可单章或全书） |
 | `novel_new_chapter` | 创建新章节文件（自动取下一个章号） |
-| `novel_sentence_analysis` | **句式模式分析**（句式分布/排列规律/段落结构/句长/情感曲线/风格指纹） |
-| `novel_sentence_config` | 查看/修改句式分析开关（与 Web UI 开关同步） |
+| `novel_import` | 扫描原稿件文件夹，自动识别/分类多本小说章节到 `novels/<书名>/`（scan 预览 / apply 执行，支持 book 强制归并与 files 精确导入） |
+| `novel_style_pattern` | **（受 stylePattern 开关控制）** 句式模式分析：把句子分为陈述/环境/心理/对话/疑问/反问/感叹七类，输出占比、高频组合与按章节的压缩排列序列，用于模仿原文叙事节奏 |
 
 ## 安装（web profile）
 
 ```sh
-dsh plugin --profile web add D:/tools/dsh-novel-writer-v0.3.0
+dsh plugin --profile web add D:/Deep\ Seek插件库/novel-writer
 ```
 
-或手动等价操作：把本文件夹放入 profile 的 `node_modules`，并在 profile `package.json` 的
-`dsh.profile.bundles` 中加入 `dsh-novel-writer`。安装后**重启 web 应用**生效：
-宿主端注册新工具与 `/api/dsh-novel-writer/state` 路由，浏览器端挂载侧边栏「句式分析」开关。
+或手动等价操作：在 profile 的 `package.json` 的 `dsh.profile.bundles` 中加入
+`dsh-novel-writer`，并在 profile `node_modules` 中链接本包。安装后重启 web 应用生效。
 
 ## 配置
 
-插件 config 支持 `root`（章节库根目录）与 `sentenceAnalysis`（默认开关）：
+插件 config 支持 `root`：章节库根目录（默认取会话工作区，即 `novels/` 所在位置）。
+在 profile 的 `cordis.patch.yml` 中可覆盖（顶层数组元素直接是条目，无需 `patch:` 包装）：
 
 ```yaml
-- patch:
-    - id: novel-writer
-      config:
-        root: 'D:/我的小说库'
-        sentenceAnalysis:
-          enabled: true      # 默认启用（UI 开关优先于此处）
-          autoAnalyze: true   # 默认自动附带句式分析
+- id: novel-writer
+  config:
+    root: 'D:/我的小说库'
 ```
 
-## 版本记录
+### stylePattern 开关（句式模式仿写拓展）
 
-### v0.3.0（本版本）
-- **新增**：句式模式分析（novel_sentence_analysis）：句式分布、排列规律、段落结构、句长节奏、情感曲线、风格指纹；
-- **新增**：Web UI 开关（侧边栏「句式分析」面板）：enabled / autoAnalyze，宿主端 state 文件持久化 + 浏览器降级；
-- **新增**：novel_sentence_config 工具，与 UI 开关双向同步；
-- **新增**：宿主端 `/api/dsh-novel-writer/state` 路由（loopback 围栏）；
-- 更新 SKILL.md / 系统提示词中的句式分析工作流。
+`stylePattern`（布尔，**默认 false 关闭**）：控制 `novel_style_pattern` 工具与
+"句式模式仿写"提示词——分析原文陈述/反问/心理/对话等句子的排列节奏，引导续写时保持相近
+叙事节奏。
 
-### v0.2.0
-- 修复章节序号提取（任意位置、中文数字）；新增 UTF-8/UTF-16/GBK 编码自动探测；通过 37 章全量压力测试。
+> ⚠️ **已知风险**：该功能可能让整体文风变得更僵硬（机械套用句式模板）。默认关闭；
+> 开启后模型侧也内置了"模式是参考、僵硬时优先自然表达"的约束，但仍建议按需使用。
 
-### v0.1.0
-- 章节库管理、novel_keywords、novel_new_chapter。
+**Web 设置开关（推荐）**：重启 web 后，打开 **设置 > 插件配置**，会看到
+「小说写作助手 novel-writer」卡片，勾选「开启句式模式仿写（stylePattern）」即可——
+改动写入 `$DSH_HOME/novel-writer.json`，**即时生效，无需重启**（工具未开启时调用会返回明确提示）。
+
+也可在 profile 的 `cordis.patch.yml` 中配置（顶层数组元素直接是条目）：
+
+```yaml
+- id: novel-writer
+  config:
+    root: ''
+    stylePattern: true
+```
+
+开关判定优先级：`$DSH_HOME/novel-writer.json` 中的持久化值 或 loader 配置的 `stylePattern`，任一为 true 即开启。

package/client.js

@@ -0,0 +1,72 @@
+/**
+ * dsh-novel-writer 客户端设置卡片。
+ *
+ * 注册进官方设置页的「插件配置」槽位（settings.plugin.item），提供
+ * stylePattern（句式模式仿写）开关。读写走宿主端的 /novel-writer-config
+ * 同源路由，绕开 rc.6 的 settings namespace 白名单限制；改动即时生效。
+ *
+ * 格式说明（与官方客户端插件一致）：
+ *   - window.__ModuleLoader__.load({ id: <包名>, factory })
+ *   - factory 返回 { name, inject, apply } —— inject 声明本插件使用的服务名
+ *     （缺少 inject 声明会导致 ctx.locale / ctx.slots 等被服务门禁拦截）。
+ */
+window.__ModuleLoader__.load({
+  id: "dsh-novel-writer",
+  factory: (require) => {
+    const React = require("react");
+    const { createElement: h, useEffect, useState } = React;
+
+    const name = "novel-writer-config";
+    const inject = ["slots"];
+
+    function NovelWriterConfigCard() {
+      const [enabled, setEnabled] = useState(null);
+      const [busy, setBusy] = useState(false);
+      useEffect(() => {
+        let alive = true;
+        fetch("/novel-writer-config", { method: "GET" })
+          .then((r) => r.json())
+          .then((j) => { if (alive) setEnabled(j.stylePattern === true); })
+          .catch(() => { if (alive) setEnabled(false); });
+        return () => { alive = false; };
+      }, []);
+      const toggle = (next) => {
+        setBusy(true);
+        fetch("/novel-writer-config", {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({ stylePattern: next })
+        })
+          .then((r) => r.json())
+          .then((j) => setEnabled(j.stylePattern === true))
+          .catch(() => {})
+          .finally(() => setBusy(false));
+      };
+      return h("div", { style: { padding: "12px 0", borderBottom: "1px solid var(--dsw-alias-border-l2, #e5e7eb)" } },
+        h("div", { style: { fontWeight: 600 } }, "小说写作助手 novel-writer"),
+        h("div", { style: { color: "var(--dsw-alias-text-l2, #888)", fontSize: 12, margin: "4px 0 8px" } },
+          "句式模式仿写：分析原文陈述/反问/心理/对话等句子的排列节奏来模仿文风。⚠️ 可能让文风变僵硬，默认关闭；改动即时生效。"),
+        h("label", { style: { display: "flex", alignItems: "center", gap: 8, cursor: "pointer" } },
+          h("input", {
+            type: "checkbox",
+            checked: enabled === true,
+            disabled: busy || enabled === null,
+            onChange: (e) => toggle(e.target.checked)
+          }),
+          h("span", null, "开启句式模式仿写（stylePattern）")
+        )
+      );
+    }
+
+    function apply(ctx) {
+      ctx.slots.inject("settings.plugin.item", () => ctx.slots.register({
+        name: "settings.plugin.item",
+        id: "novel-writer-config",
+        order: 105,
+        inject: () => ({})
+      }, NovelWriterConfigCard));
+    }
+
+    return { name, inject, apply };
+  }
+});

package/cordis.patch.yml

@@ -1,12 +1,6 @@
 # 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
+# into the profile's loader tree. The entry's `name` is the plugin package
 # itself, resolved from the profile's node_modules.
-#
-# v0.3.0: the same row now carries BOTH halves — the node half (exports ".")
-# runs in the host process (novel_* tools + /api/dsh-novel-writer/state
-# routes for the UI switch), and the dsh.client declaration in package.json
-# makes the browser half (exports "./client") load in the web GUI, mounting
-# the 「句式分析」 sidebar entry with the enable switch.
 - insert:
     - id: novel-writer
       name: 'dsh-novel-writer'