dsh-novel-writer 0.3.0 → 0.5.0

package/INSTALL.md

@@ -1,123 +1,39 @@
-# dsh-novel-writer v0.3.0 — 跨设备安装指南
+# dsh-novel-writer v0.5.0 — 安装指南（v0.3.0 × v0.4.0 合并版）
 
-本目录是一个**完整的、自包含的插件分发件**，宿主端零第三方依赖（仅 Node 内置模块），
-浏览器端仅依赖 Web GUI 自带的 react。将其复制到任何安装了 DSH 的设备即可使用。
+宿主端零第三方依赖；浏览器端依赖 Web GUI 自带的 react。
+本包 UI：侧边栏「句式分析」大开关面板（统一开关位置）；设置 > 插件配置 卡片仅显示状态 + 跳转按钮。
 
 ```
-dsh-novel-writer-v0.3.0/
+dsh-novel-writer-v0.5.0/
 ├── lib/
-│   ├── index.js        # 宿主端插件本体（novel_* 工具 + state 路由）
-│   ├── analysis.js     # 句式模式分析引擎（零依赖）
-│   └── client.js       # 浏览器端（侧边栏「句式分析」开关面板）
-├── package.json        # 包定义（bundle patch + dsh.client 声明）
-├── cordis.patch.yml    # 挂载插件到 loader 树
-├── README.md           # 功能与工具说明
-└── skills/
-    └── novel-writing/
-        └── SKILL.md    # 可选：小说写作技能（含句式分析工作流）
+│   ├── index.js        # 宿主端（8 个 novel_* 工具 + state 路由）
+│   ├── analysis.js     # 句式模式分析引擎（九类/情感/节奏，零依赖）
+│   └── client.js       # 浏览器端（侧边栏面板 + 设置页卡片）
+├── test/               # 引擎与 client 契约测试
+├── package.json
+├── cordis.patch.yml
+├── README.md
+├── INSTALL.md
+└── skills/novel-writing/SKILL.md
 ```
 
-## 一、安装插件
+## 安装
 
-### 方式 A：dsh CLI（推荐）
+1. 把本文件夹放入 profile 的 node_modules（或 `dsh plugin --profile web add <路径>`）；
+2. profile `package.json` 的 `dsh.profile.bundles` 加入 `dsh-novel-writer`；
+3. （可选）把 `skills/novel-writing` 复制到工作区 `.dsh/skills/`；
+4. **重启 web 应用**。
 
-把整个文件夹放到目标设备的任意位置（例如 `D:/tools/dsh-novel-writer`），然后：
+## 验证
 
-```sh
-dsh plugin --profile web add D:/tools/dsh-novel-writer
-```
-
-### 方式 B：手动等价操作
-
-1. 把本文件夹（或链接）放入 profile 的 `node_modules`：
-
-   ```sh
-   # 在 <DSH_HOME>/profiles/<profile名> 目录下
-   npm install D:/tools/dsh-novel-writer
-   # 或手动建立 junction 链接（Windows）：
-   # mklink /J <profile>\node_modules\dsh-novel-writer D:/tools/dsh-novel-writer
-   ```
-
-2. 编辑该 profile 的 `package.json`，在 `dsh.profile.bundles` 数组中加入：
-
-   ```json
-   "dsh-novel-writer"
-   ```
-
-3. **重启 web 应用**。宿主端注册 `novel_*` 系列工具（含新增的 novel_sentence_analysis / novel_sentence_config）
-   与 `/api/dsh-novel-writer/state` 路由；浏览器端加载 client half，侧边栏出现「句式分析」入口。
-
-> 插件的 `cordis.patch.yml` 由 bundle 自动应用（`package.json` 中 `dsh.bundle.patch` 已声明），无需手动往 profile 的 patch 文件里加条目。
-
-## 二、（可选）安装技能 SKILL.md
-
-把 `skills/novel-writing` 整个文件夹复制到工作区的 `.dsh/skills/` 下：
-
-```
-<工作区>/.dsh/skills/novel-writing/SKILL.md
-```
-
-新会话中即会出现 `novel-writing` 技能（含句式模式分析工作流）。
-
-## 三、UI 开关（v0.3.0）
-
-Web GUI 侧边栏会出现「句式分析」入口，点击打开面板：
-
-- **启用句式分析（enabled）**：关掉后 `novel_sentence_analysis` 返回"已关闭"状态；
-- **自动分析（autoAnalyze）**：关掉后 AI 仅在用户明确要求时使用句式分析。
-
-状态实时写入宿主端 `~/.dsh/dsh-novel-writer/state.json`；
-也可在对话中让 AI 执行 `novel_sentence_config` 查看/修改。若浏览器无法访问宿主端路由
-（例如未重启/非 web 环境），开关降级保存在浏览器 localStorage，并以提示文字告知。
-
-## 四、准备章节库
-
-章节库存放于**会话工作区**（或插件 config `root` 指定的目录）下的 `novels/` 文件夹：
-
-```
-<工作区>/novels/<书名>/
-├── 第01章.md          # 或 .txt / .markdown
-└── 原稿件-单章-…第一章.txt   # 序号在任意位置、中文数字均可识别
-```
-
-支持的文件命名与编码：
-
-- 章号任意位置：`第01章.md`、`01-标题.md`、`原稿件-单章-…第一章.txt`、`原稿件-单章-第25章 .txt`
-- 阿拉伯数字 + 中文数字（第一章/第十四章/第三十章），自动按章号排序
-- 编码自动探测：UTF-8（含/不含 BOM）、UTF-16 LE/BE（含 BOM 或启发式）、GBK/GB18030（无 BOM）
-
-## 五、验证安装
-
-安装并重启后，在会话中应能看到以下工具：`novel_books`、`novel_chapters`、
-`novel_read`、`novel_keywords`、`novel_new_chapter`、`novel_sentence_analysis`、
-`novel_sentence_config`。可先执行 `novel_books` 确认能列出书库，再执行
-`novel_sentence_analysis` 验证句式分析。
-
-若 `root` 需要指向其他目录（默认会话工作区），在 profile 的 `cordis.patch.yml` 中覆盖：
-
-```yaml
-- patch:
-    - id: novel-writer
-      config:
-        root: 'D:/我的小说库'
-        sentenceAnalysis:
-          enabled: true
-          autoAnalyze: true
-```
-
----
-
-## 版本记录
-
-### v0.3.0（本分发件）
-- **新增**：句式模式分析引擎（lib/analysis.js）：陈述/对话/心理/疑问/反问/感叹/祈使/省略留白 的分布、
-  排列规律（转移/模板/段首段尾）、句长节奏、情感曲线（喜/怒/哀/惧/惊）与风格指纹；
-- **新增**：novel_sentence_analysis / novel_sentence_config 工具；
-- **新增**：Web UI 开关（侧边栏「句式分析」面板，client half）+ 宿主端 /api/dsh-novel-writer/state 路由；
-- 更新系统提示词与 SKILL.md 的句式分析工作流。
+- 工具列表出现：novel_books / novel_chapters / novel_read / novel_keywords / novel_new_chapter /
+  novel_import / novel_sentence_analysis / novel_sentence_config；
+- 侧边栏出现「句式分析」入口；设置 > 插件配置 出现 novel-writer 状态卡片；
+- `GET /api/dsh-novel-writer/state` 返回 200 JSON。
 
-### v0.2.0
-- 修复章节序号提取（任意位置、中文数字）；UTF-8/UTF-16/GBK 编码自动探测；37 章全量压力测试通过。
+## 开关
 
-### v0.1.0
-- 章节库管理、novel_keywords、novel_new_chapter。
+- 默认开启；**唯一开关位置：侧边栏「句式分析」面板**（总开关 enabled + 子开关 autoAnalyze）；
+- 设置 > 插件配置 卡片仅显示状态并提供「打开开关面板」跳转；
+- 持久化 `~/.dsh/dsh-novel-writer/state.json`；兼容读取 `~/.dsh/novel-writer.json`（v0.4.0 stylePattern）；
+- config 支持 `sentenceAnalysis.enabled / autoAnalyze` 与 `stylePattern`（v0.4.0 兼容）。

package/README.md

@@ -1,79 +1,83 @@
-# dsh-novel-writer — 小说写作助手插件（v0.3.0）
+# dsh-novel-writer — 小说写作助手插件（v0.5.0 合并版）
 
 DSH（DeepSeek Harness）小说写作助手 bundle 插件。宿主端零第三方依赖（仅 Node 内置模块），
-浏览器端仅依赖 Web GUI 自带的 react。为 AI 提供小说章节库管理、分析与续写辅助能力；
-v0.3.0 新增**句式模式分析**扩展与 **Web UI 开关**。
+浏览器端仅依赖 Web GUI 自带的 react。
+**v0.5.0 = v0.3.0（深度句式分析 + 侧边栏开关）与 v0.4.0（批量导入 + 设置页卡片）的合并版**。
 
 ## 功能
 
 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 连句高频模板、段首/段尾句式、纯对话段/纯心理段/混合段统计；
+   `novel_books` / `novel_chapters` / `novel_read` 浏览与读取。
+   章号任意位置 + 中文数字识别；UTF-8 / UTF-16 LE/BE / GBK 编码自动探测。
+2. **分析**：`novel_keywords` 提取全书/单章高频关键词（中文二字词组 + 英文词）。
+3. **句式模式分析**：`novel_sentence_analysis` 对全书/单章输出——
+   - 九类句式：陈述 / 环境 / 心理 / 对话 / 疑问 / 反问 / 感叹 / 祈使 / 省略留白（比例、句数、均长、例句）；
+   - 排列规律：句式转移、2/3 连句高频模板、段首/段尾句式、**按章节的压缩节奏序列**（S×8 ENV×2 PSY×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. **续写**：系统提示词规定续写工作流（先读后写、保持文风与伏笔一致），
-   `novel_new_chapter` 创建新章节文件。
+   - 主观情感：情感词典（喜/怒/哀/惧/惊）+ 强度副词加权 → 主导情绪、情绪分布、情感曲线、主观性指数；
+   - 风格指纹 + 给模型的**节奏建议**（guidance）。
+   ⚠️ 风险约束：句式模式是"参考节奏"而非"模板套用"，模型在机械复刻导致僵硬时会优先回归自然表达。
+4. **原稿件批量导入**：`novel_import` 扫描存放多本小说的文件夹（支持子文件夹、多编码、任意位置章号），
+   从文件名与文件头双通道提取书名候选并分组（scan 预览），AI 确认后一键复制/移动到 `novels/<书名>/`（apply）；
+   支持 `book` 强制归并异名同书、`files` 精确指定、`move` 移动模式。
+5. **续写**：先读后写、保持文风与伏笔一致，`novel_new_chapter` 创建新章节文件。
 
 ## 提供的工具
 
 | 工具 | 说明 |
 |---|---|
-| `novel_books` | 列出章节库全部作品（章节数、总字数） |
-| `novel_chapters` | 列出某作品章节清单（章号/标题/字数/行数/更新时间） |
-| `novel_read` | 阅读某章正文（行号 + 字数统计，offset/limit 分段） |
-| `novel_keywords` | 提取高频关键词（可单章或全书） |
-| `novel_new_chapter` | 创建新章节文件（自动取下一个章号） |
-| `novel_sentence_analysis` | **句式模式分析**（句式分布/排列规律/段落结构/句长/情感曲线/风格指纹） |
-| `novel_sentence_config` | 查看/修改句式分析开关（与 Web UI 开关同步） |
+| `novel_books` | 列出章节库全部作品 |
+| `novel_chapters` | 列出某作品章节清单 |
+| `novel_read` | 阅读某章正文（offset/limit 分段） |
+| `novel_keywords` | 提取高频关键词 |
+| `novel_new_chapter` | 创建新章节文件 |
+| `novel_import` | **原稿件批量导入/自动分类（v0.4.0）** |
+| `novel_sentence_analysis` | **句式模式分析（v0.3.0 深度 + v0.4.0 节奏）** |
+| `novel_sentence_config` | 查看/修改句式分析开关 |
+
+## UI 开关（统一在一处）
+
+- **唯一开关位置：侧边栏「句式分析」面板**——状态横幅 + **总开关「启用句式分析」**（enabled）+ 子开关「分析作品时自动使用」（autoAnalyze）；
+- **设置 > 插件配置** 的 novel-writer 卡片仅**显示状态**（已启用/已关闭、自动分析开/关），并提供「打开开关面板」按钮跳转；
+- 也可让 AI 用 `novel_sentence_config` 查看/修改。
+- 状态写入 `~/.dsh/dsh-novel-writer/state.json`；同时**只读兼容** v0.4.0 的 `~/.dsh/novel-writer.json`（stylePattern）与 config.stylePattern。
+- 开关默认**开启**；宿主端路由 `/api/dsh-novel-writer/state`（loopback 围栏 + 可选注入，headless 自动跳过）。
 
 ## 安装（web profile）
 
 ```sh
-dsh plugin --profile web add D:/tools/dsh-novel-writer-v0.3.0
+dsh plugin --profile web add D:/tools/dsh-novel-writer
 ```
 
-或手动等价操作：把本文件夹放入 profile 的 `node_modules`，并在 profile `package.json` 的
-`dsh.profile.bundles` 中加入 `dsh-novel-writer`。安装后**重启 web 应用**生效：
-宿主端注册新工具与 `/api/dsh-novel-writer/state` 路由，浏览器端挂载侧边栏「句式分析」开关。
+或手动：把本文件夹放入 profile 的 `node_modules`，并在 profile `package.json` 的
+`dsh.profile.bundles` 中加入 `dsh-novel-writer`。安装后**重启 web 应用**生效。
 
 ## 配置
 
-插件 config 支持 `root`（章节库根目录）与 `sentenceAnalysis`（默认开关）：
-
 ```yaml
-- patch:
-    - id: novel-writer
-      config:
-        root: 'D:/我的小说库'
-        sentenceAnalysis:
-          enabled: true      # 默认启用（UI 开关优先于此处）
-          autoAnalyze: true   # 默认自动附带句式分析
+- id: novel-writer
+  config:
+    root: 'D:/我的小说库'
+    sentenceAnalysis:
+      enabled: true
+      autoAnalyze: true
+    # stylePattern: true   # v0.4.0 兼容写法（任一生效即开启）
 ```
 
 ## 版本记录
 
-### v0.3.0（本版本）
-- **新增**：句式模式分析（novel_sentence_analysis）：句式分布、排列规律、段落结构、句长节奏、情感曲线、风格指纹；
-- **新增**：Web UI 开关（侧边栏「句式分析」面板）：enabled / autoAnalyze，宿主端 state 文件持久化 + 浏览器降级；
-- **新增**：novel_sentence_config 工具，与 UI 开关双向同步；
-- **新增**：宿主端 `/api/dsh-novel-writer/state` 路由（loopback 围栏）；
-- 更新 SKILL.md / 系统提示词中的句式分析工作流。
+### v0.5.0（合并版）
+- 合并 v0.3.0 与 v0.4.0：九类句式（新增"环境"）、章节压缩节奏序列、guidance 节奏建议、采样上限；
+- 新增 novel_import 批量导入（v0.4.0）；开关同时出现在侧边栏面板与官方设置页；
+- 路由改可选注入 ctx.inject(["webServer"])，headless 兼容；保留 loopback 围栏；
+- 兼容读取 v0.4.0 的 novel-writer.json / config.stylePattern；提示词内置"僵硬时优先自然表达"约束。
+
+### v0.4.0（他人改版，已并入）
+- novel_import 批量导入自动分类；novel_style_pattern 轻量句式分析（环境类/压缩序列/guidance）；
+- 官方设置页插件配置卡片；ctx.inject 可选注入；开关默认关闭 + 风险提示。
 
-### v0.2.0
-- 修复章节序号提取（任意位置、中文数字）；新增 UTF-8/UTF-16/GBK 编码自动探测；通过 37 章全量压力测试。
+### v0.3.0（本系列）
+- 句式模式分析深度版（情感曲线/句长/段落/指纹）；侧边栏开关面板；state 路由。
 
-### v0.1.0
-- 章节库管理、novel_keywords、novel_new_chapter。
+### v0.2.0 / v0.1.0
+- 章节库、关键词、新建章节；编码探测。

package/lib/analysis.js

@@ -1,20 +1,22 @@
 /**
- * dsh-novel-writer — 句式模式分析引擎 (v0.3.0 扩展)
+ * dsh-novel-writer — 句式模式分析引擎 (v0.5.0 合并版)
  *
- * 零依赖、确定性规则实现。用于分析中文小说的句式构成与排列规律：
- *   - 句式分类：陈述 / 对话 / 心理 / 疑问 / 反问 / 感叹 / 祈使 / 省略留白
- *   - 排列规律：句式转移（二元转移计数）、高频句式模板（2/3 连句）、段首段尾句式
- *   - 风格特征：句长分布、短长句占比、对话/心理密度、主观性指数
- *   - 主观情感：内置轻量情感词典（喜/怒/哀/惧/惊）与强度副词加权，输出情感曲线
- *   - 风格指纹：一维紧凑签名，便于快速比对作者的句式习惯
+ * 融合 v0.3.0（深度分析）与 v0.4.0（轻量节奏参考）两版引擎：
+ *   - 九类句式：陈述 / 环境 / 心理 / 对话 / 疑问 / 反问 / 感叹 / 祈使 / 省略留白
+ *   - 排列规律：句式转移、2/3 连句模板、段首段尾句式、按章节的压缩排列序列（跑长编码）
+ *   - 风格特征：句长分布、短长句占比、对话/心理/环境密度、主观性指数、风格指纹
+ *   - 主观情感：轻量情感词典（喜/怒/哀/惧/惊）+ 强度副词加权，输出情感曲线
+ *   - 节奏建议：给模型的 guidance 文本（句式分布 + 高频组合 + 章节节奏序列）
+ *   - 采样上限：maxSentences 保护超长文本（默认 20000 句）
  *
- * 所有统计均为可复现的启发式规则，不调用任何外部服务。
+ * 零依赖、确定性规则，不调用任何外部服务。
  */
 
 export const CATEGORY_LABELS = Object.freeze({
   statement: "陈述",
-  dialogue: "对话",
+  environment: "环境",
   psychology: "心理",
+  dialogue: "对话",
   question: "疑问",
   "rhetoric-question": "反问",
   exclamation: "感叹",
@@ -24,10 +26,16 @@ export const CATEGORY_LABELS = Object.freeze({
 
 /** 输出固定顺序。 */
 export const CATEGORY_ORDER = Object.freeze([
-  "statement", "dialogue", "psychology", "question",
+  "statement", "environment", "psychology", "dialogue", "question",
   "rhetoric-question", "exclamation", "imperative", "ellipsis"
 ]);
 
+/** 短码（压缩序列/指纹用）。 */
+export const TYPE_CODE = Object.freeze({
+  statement: "S", environment: "ENV", psychology: "PSY", dialogue: "DLG", question: "Q",
+  "rhetoric-question": "RQ", exclamation: "EX", imperative: "IMP", ellipsis: "…"
+});
+
 const EMOTION_LABELS = Object.freeze({
   joy: "喜", anger: "怒", sorrow: "哀", fear: "惧", surprise: "惊", neutral: "中性"
 });
@@ -60,7 +68,7 @@ const PSYCH_MARKERS = [
   /心里|内心|心底|心头/
 ];
 
-/** 反问强标记（与疑问区分：这些词 + 疑问语气 → 反问）。 */
+/** 反问强标记（与疑问区分）。 */
 const RHETORIC_MARKERS = [
   /难道|岂不|岂非|岂能|岂敢|岂止|何尝|何曾|何必|何须|何苦|何不|谈何|莫非|岂|不成/,
   /哪(能|敢|会|曾|配|有|里)/,
@@ -77,6 +85,9 @@ const QUESTION_WORDS = ["谁", "什么", "为什么", "怎么", "怎样", "如
 const IMPERATIVE_HARD = ["请", "快", "赶紧", "立刻", "马上", "别", "不要", "莫", "勿", "不许", "不准", "滚", "住手", "放手", "站住", "听我说", "给我", "让", "快点儿", "快点"];
 const IMPERATIVE_START = ["走", "来", "去", "坐", "站", "停", "开始", "出发", "算了吧", "算了", "吃", "喝", "看", "听", "说", "做", "干", "起来", "坐下", "住口"];
 
+/** 环境描写标记词（天色/天气/景物类名词，来自 v0.4.0）。 */
+const ENV_MARKERS = /夜色|月光|晨光|暮色|夕阳|黄昏|清晨|深夜|夜空|天边|星光|灯火|细雨|微风|大雨|暴雨|风雪|薄雾|浓雾|云层|远山|山影|河面|湖水|街道|巷子|烛火|窗|雨声|风声|树影|落叶|残雪|霜|天色/;
+
 /** 句尾结束符。 */
 const TERMINATORS = "。！？…";
 
@@ -202,7 +213,10 @@ function isImperative(text) {
   return new RegExp("^(你|您|我们|咱们|大家)?(" + IMPERATIVE_START.join("|") + ")").test(text);
 }
 
-/** 对单个句子做句式分类（含优先级与引语/心理合并规则）。 */
+/**
+ * 单句分类（优先级：对话 > 心理 > 反问 > 疑问 > 感叹 > 祈使 > 环境 > 省略 > 陈述）。
+ * 引语优先：引号内的直接引语算对话；引号内含心理标记（内心独白）算心理。
+ */
 export function classifySentence(raw) {
   const text = String(raw).trim();
   if (text === "") return { type: "statement", text, quoted: false };
@@ -217,11 +231,12 @@ export function classifySentence(raw) {
   if (isQuestion(text)) return { type: "question", text, quoted: false };
   if (isExclamation(text)) return { type: "exclamation", text, quoted: false };
   if (isImperative(text)) return { type: "imperative", text, quoted: false };
+  if (ENV_MARKERS.test(text)) return { type: "environment", text, quoted: false };
   if (/…+$/.test(text)) return { type: "ellipsis", text, quoted: false };
   return { type: "statement", text, quoted: false };
 }
 
-/** 情感词计数（含强度副词加权）。返回各情感得分与命中的词语。 */
+/** 情感词计数（含强度副词加权）。 */
 function emotionOf(text) {
   const scores = { joy: 0, anger: 0, sorrow: 0, fear: 0, surprise: 0 };
   const words = { joy: [], anger: [], sorrow: [], fear: [], surprise: [] };
@@ -264,21 +279,57 @@ function median(values) {
   return sorted.length % 2 === 1 ? sorted[mid] : round((sorted[mid - 1] + sorted[mid]) / 2, 2);
 }
 
+/** 跑长编码压缩排列序列（来自 v0.4.0）：S×8 ENV×2 PSY×3 … */
+export function compressSequence(codes, maxRuns = 48) {
+  const runs = [];
+  for (const code of codes) {
+    const last = runs[runs.length - 1];
+    if (last !== void 0 && last.code === code) last.n += 1;
+    else runs.push({ code, n: 1 });
+  }
+  const parts = runs.slice(0, maxRuns).map((run) => run.code + "×" + run.n);
+  if (runs.length > maxRuns) parts.push("…(共" + runs.length + "段)");
+  return parts.join(" ");
+}
+
+/** 生成给模型的节奏建议文本（来自 v0.4.0 buildGuidance，适配九类）。 */
+export function buildGuidance(ratios, topPatterns, chapterSequences) {
+  const ratioText = CATEGORY_ORDER
+    .filter((code) => (ratios[code] ?? 0) > 0)
+    .map((code) => TYPE_CODE[code] + " " + Math.round((ratios[code] ?? 0) * 100) + "%")
+    .join(" · ");
+  const patternText = topPatterns.length > 0
+    ? topPatterns.slice(0, 5).map((p) => p.pattern + " ×" + p.count).join("、")
+    : "（样本过短，未形成高频组合）";
+  const lines = [
+    "句式分布：" + ratioText,
+    "高频句式组合：" + patternText
+  ];
+  if (chapterSequences.length > 0) {
+    lines.push("章节节奏（压缩序列，" + CATEGORY_ORDER.map((code) => TYPE_CODE[code] + "=" + CATEGORY_LABELS[code]).join(" ") + "）：");
+    for (const item of chapterSequences.slice(0, 12)) lines.push("  " + item.chapter + ": " + item.sequence);
+  }
+  return lines.join("\n");
+}
+
 /**
- * 全书/单章句式模式分析主入口。
+ * 全书/单章句式模式分析主入口（v0.5.0 合并版）。
  * @param text 正文文本。
- * @param options { top: 句式模板返回条数（默认 8） }
+ * @param options { top: 句式模板条数（默认 8）, maxSentences: 采样上限（默认 20000）, chapterTexts: [{chapter, text}] 可选分章输入 }
  * @returns 结构化分析结果（与 novel_sentence_analysis 输出 schema 一致）。
  */
 export function analyzeText(text, options = {}) {
   const top = Number.isInteger(options.top) ? options.top : 8;
+  const maxSentences = Number.isInteger(options.maxSentences) ? options.maxSentences : 20000;
   const blocks = splitBlocks(text);
   const sentences = [];
   const blockMeta = [];
   for (let b = 0; b < blocks.length; b += 1) {
+    if (sentences.length >= maxSentences) break;
     const parts = splitSentences(blocks[b]);
     const meta = { sentences: [], opening: void 0, closing: void 0 };
     for (const part of parts) {
+      if (sentences.length >= maxSentences) break;
       const classified = classifySentence(part);
       const record = {
         text: part,
@@ -472,10 +523,12 @@ export function analyzeText(text, options = {}) {
 
   const dialogueRatio = totalSentences === 0 ? 0 : counts.dialogue / totalSentences;
   const psychologyRatio = psychRatio;
+  const environmentRatio = totalSentences === 0 ? 0 : counts.environment / totalSentences;
   const questionRatio = totalSentences === 0 ? 0 : (counts.question + counts["rhetoric-question"]) / totalSentences;
   const style = {
     dialogueRatio: round(dialogueRatio, 4),
     psychologyRatio: round(psychologyRatio, 4),
+    environmentRatio: round(environmentRatio, 4),
     questionRatio: round(questionRatio, 4),
     exclamationRatio: round(exclaimRatio, 4),
     shortSentenceRatio: lengths.shortRatio,
@@ -486,6 +539,21 @@ export function analyzeText(text, options = {}) {
     firstPersonDensity: round(firstPersonDensity, 2)
   };
 
+  // 分章节奏序列（可选：调用方传入各章文本）
+  const chapterPatterns = [];
+  if (Array.isArray(options.chapterTexts)) {
+    for (const item of options.chapterTexts) {
+      const chapterCodes = splitSentences(String(item.text)).slice(0, maxSentences).map((s) => classifySentence(s).type);
+      chapterPatterns.push({
+        chapter: String(item.chapter),
+        sequence: compressSequence(chapterCodes.map((type) => TYPE_CODE[type]))
+      });
+    }
+  }
+
+  const ratios = Object.fromEntries(CATEGORY_ORDER.map((type) => [type, totalSentences === 0 ? 0 : round(counts[type] / totalSentences, 4)]));
+  const guidance = buildGuidance(ratios, motifs, chapterPatterns);
+
   const fingerprint = buildFingerprint(categories, lengths, style, emotion, motifs);
 
   return {
@@ -498,6 +566,8 @@ export function analyzeText(text, options = {}) {
     lengths,
     style,
     emotion,
+    chapterPatterns,
+    guidance,
     fingerprint
   };
 }
@@ -542,8 +612,7 @@ function emotionCurve(blockMeta, maxSegments) {
 
 /** 一维风格指纹。 */
 function buildFingerprint(categories, lengths, style, emotion, motifs) {
-  const codeOf = { statement: "S", dialogue: "D", psychology: "P", question: "Q", "rhetoric-question": "R", exclamation: "E", imperative: "I", ellipsis: "L" };
-  const parts = categories.map((category) => codeOf[category.type] + ":" + Math.round(category.ratio * 1000) / 10);
+  const parts = categories.map((category) => TYPE_CODE[category.type] + ":" + Math.round(category.ratio * 1000) / 10);
   const motif = motifs.length > 0 ? motifs[0].pattern : "-";
   return parts.join(" ") + " | len:" + lengths.avg + " subj:" + style.subjectivityIndex + " emo:" + emotion.dominant + " | motif:" + motif;
 }

package/lib/client.js

@@ -91,7 +91,14 @@ window.__ModuleLoader__.load({
       "banner.off": "句式分析已关闭",
       "banner.offSub": "AI 不会执行句式分析",
       "badge.on": "已开启",
-      "badge.off": "已关闭"
+      "badge.off": "已关闭",
+      "card.title": "小说写作助手 novel-writer",
+      "card.desc": "句式模式分析：分析原文陈述/环境/心理/对话/疑问/反问/感叹等句子的排列节奏来辅助模仿文风。⚠️ 若机械套用导致文风僵硬，模型会优先回归自然表达。",
+      "card.status": "句式模式分析：已启用 · 自动分析：开",
+      "card.statusOff": "句式模式分析：已关闭",
+      "card.statusAutoOff": "句式模式分析：已启用 · 自动分析：关",
+      "card.hint": "开关统一在侧边栏「句式分析」面板（也可让 AI 用 novel_sentence_config 调整），本卡片仅显示状态。",
+      "card.open": "打开开关面板"
     };
     var en = {
       "entry.label": "Sentence Analysis",
@@ -113,7 +120,14 @@ window.__ModuleLoader__.load({
       "banner.off": "Sentence analysis is OFF",
       "banner.offSub": "the AI will not run it",
       "badge.on": "ON",
-      "badge.off": "OFF"
+      "badge.off": "OFF",
+      "card.title": "Novel Writer (dsh-novel-writer)",
+      "card.desc": "Sentence-pattern analysis: reads the rhythm of statements/environment/inner-thought/dialogue/questions etc. to help mimic the author's style. ⚠️ If mechanical imitation stiffens the prose, natural expression wins.",
+      "card.status": "Sentence analysis: ON · auto-analyze: ON",
+      "card.statusOff": "Sentence analysis: OFF",
+      "card.statusAutoOff": "Sentence analysis: ON · auto-analyze: OFF",
+      "card.hint": "Switches live in the sidebar 'Sentence Analysis' panel (or ask the AI to run novel_sentence_config); this card only shows status.",
+      "card.open": "Open the switch panel"
     };
     function dictionary() {
       return (typeof document !== "undefined" && (document.documentElement.lang || "zh").toLowerCase().startsWith("en")) ? en : zh;
@@ -332,6 +346,56 @@ window.__ModuleLoader__.load({
         react.createElement("div", { className: "nwFoot" }, t("panel.foot"))
       );
     }
+    /** 官方设置页「插件配置」槽位卡片（v0.5.0 统一版）：状态只读 + 跳转按钮，开关只在侧边栏面板。 */
+    function NovelWriterSettingsCard(props) {
+      var state = props.controller.getSnapshot();
+      var force = react.useState(0)[1];
+      react.useEffect(function () {
+        return props.controller.subscribe(function () { force(function (n) { return n + 1; }); });
+      }, []);
+      state = props.controller.getSnapshot();
+      var statusKey = state.enabled ? (state.autoAnalyze ? "card.status" : "card.statusAutoOff") : "card.statusOff";
+      return react.createElement(
+        "div",
+        { style: { padding: "12px 0", borderBottom: "1px solid var(--dsw-alias-border-l2, #e5e7eb)" } },
+        react.createElement("div", { style: { fontWeight: 600 } }, t("card.title")),
+        react.createElement("div", { style: { color: "var(--dsw-alias-text-l2, #888)", fontSize: 12, margin: "4px 0 8px" } }, t("card.desc")),
+        react.createElement("div", { style: { display: "flex", alignItems: "center", gap: 10, marginTop: 4 } },
+          react.createElement(
+            "span",
+            {
+              style: {
+                display: "inline-flex", alignItems: "center", gap: 6,
+                fontSize: 12, fontWeight: 700, lineHeight: 1,
+                padding: "4px 10px", borderRadius: 999,
+                background: state.enabled ? "rgba(34,197,94,.14)" : "rgba(239,68,68,.10)",
+                color: state.enabled ? "#15803d" : "#b91c1c",
+                border: "1px solid " + (state.enabled ? "#22c55e" : "#ef4444")
+              }
+            },
+            react.createElement("span", null, state.enabled ? "●" : "○"),
+            react.createElement("span", null, t(statusKey))
+          ),
+          react.createElement(
+            "button",
+            {
+              type: "button",
+              style: {
+                appearance: "none", font: "inherit", cursor: "pointer",
+                border: "1px solid var(--dsw-alias-border-l2, #d1d5db)", borderRadius: 8,
+                background: "var(--dsw-alias-bg-layer-3, #fff)", color: "inherit",
+                padding: "5px 12px", fontSize: 12
+              },
+              onClick: function () {
+                if (typeof props.onOpenPanel === "function") props.onOpenPanel();
+              }
+            },
+            t("card.open")
+          )
+        ),
+        react.createElement("div", { style: { color: "var(--dsw-alias-text-l2, #888)", fontSize: 12, marginTop: 8 } }, t("card.hint"))
+      );
+    }
     function mountPanel(controller, toggle) {
       var container;
       var root;
@@ -467,6 +531,21 @@ window.__ModuleLoader__.load({
       } catch (error) {
         console.warn("[dsh-novel-writer] UI mount failed:", error);
       }
+      // 官方设置页「插件配置」卡片（v0.4.0 合并；slots 服务由 inject 声明）
+      try {
+        ctx.slots.inject("settings.plugin.item", function () {
+          return ctx.slots.register({
+            name: "settings.plugin.item",
+            id: "novel-writer-config",
+            order: 105,
+            inject: function () { return {}; }
+          }, function () {
+            return react.createElement(NovelWriterSettingsCard, { controller: controller, toggle: toggle, onOpenPanel: openPanel });
+          });
+        });
+      } catch (error) {
+        console.warn("[dsh-novel-writer] settings card mount failed:", error);
+      }
       ctx.effect?.(function () {
         return function () {
           for (var i = 0; i < disposers.length; i += 1) {