小说文风质检 umairrrkhan/dsh-novel-quality-analyzer

DSH Novel Quality Analyzer

这是 DeepSeek Harness 的社区小说分析插件，用来检查章节和故事片段里的词汇多样性、陈词滥调、重复词和重复句。

当前版本：1.1.1

分析全部在浏览器本地运行。不需要 API key，不发起 LLM 请求，也不需要分析订阅。

这个插件只做写作风格诊断，不评判情节、文学质量、原创性、抄袭或 AI 作者身份。

演示

片段分析

分析器会在你的片段旁边显示风格评分、词数和词汇多样性。

DSH Novel Quality Analyzer displaying diagnostics for a 90-word excerpt

短样本处理

不足 50 词的片段只显示各项指标，不给风格评分。

DSH Novel Quality Analyzer showing an unscored 44-word excerpt

安装

要求：

- Node.js 22.22.2 或更高版本；推荐 Node 24 LTS。
- DeepSeek Harness，且已有支持 Web 的配置档。
- 支持 Intl.Segmenter 的现代浏览器。

安装或更新插件：

dsh plugin --profile web add dsh-novel-quality-analyzer@latest

把 web 换成你已有的配置档名称。

查看配置档配置并启动：

dsh --profile web --dump-config
dsh --profile web

把插件装进一个只有基础配置的新配置档，并不会装上 Web UI。首次搭建 Harness，请参照官方快速开始。

也可以从 GitHub 安装：

dsh plugin --profile web add github:umairrrkhan/dsh-novel-quality-analyzer

生成的浏览器 bundle 已提交到仓库，所以从 Git 安装不需要先构建插件。

使用方法

1. 在 DeepSeek Harness 里打开一个会话。
2. 点击输入框工具栏上的 Analyze writing。
3. 把章节或片段粘贴到 Story excerpt。
4. 停顿 250 ms 后结果自动更新。
5. 结合上下文查看标出的短语和重复。
6. 点击 Copy report，或手动复制完整报告。
7. 清空或关闭面板即可丢弃片段。

插件不会读取聊天记录，也不会改动你的输入框草稿。

功能

| 功能 | 报告内容 |
| 词统计 | 总词数和唯一词数 |
| 词汇多样性 | 默认 100 词窗口上的移动平均多样性 |
| 陈词滥调检测 | 每一处匹配，附带限定长度的位置证据 |
| 实词重复 | 高频词，不含常见虚词 |
| 重复句子 | 归一化 token 后重复出现的完整句子 |
| 句子指标 | 平均句长，以及超过 35 词的句子数 |
| 阅读时间 | 按每分钟 200 词估算 |
| 风格评分 | 透明的启发式评分，逐项扣分 |
| 报告导出 | 可复制的纯文本诊断摘要 |

界面提供英文和中文标签。文本分析以英文为主。

理解结果

词汇多样性

插件同时报告原始独立词比例和滑动平均多样性。

滑动指标使用 100 词滑动窗口，减少摘录长度带来的影响。样本较小时，实际窗口会更短。

陈词滥调

当前短语列表包括：

- suddenly
- unbeknownst
- out of nowhere
- unknown to them
- before he knew it
- little did they know
- little did he know
- little did she know

所有匹配到的出现都会计数。每个短语最多返回五个示例区间。

区间使用 JavaScript UTF-16 偏移量，结束位置为开区间。

重复

实词满足以下条件时会被标记：

- 至少包含四个字母。
- 默认至少出现六次。
- 不在常见虚词排除列表中。

最多返回八个重复词示例。

重复句子检测只考虑至少八个词的句子，最多返回五个示例。

人名、对话、反复出现的主题、刻意重复都可能是合理的。每处标记都要结合上下文判断。

风格评分

评分计算方式：

100
− cliché penalty
− content-repetition penalty
− low-diversity penalty
− duplicate-sentence penalty

结果限制在 0–100。各项扣分会包含在分析输出中。

高分意味着触发的风格标记很少，并不代表故事写得好。

少于 50 词的样本不评分。检测到中文、日文或泰文文本时也不评分，因为分词器无法可靠切分这些语言。

限制与隐私

- 默认上限：每段摘录 200,000 个 UTF-16 字符串单元。
- 超限输入会被拒绝，不会静默截断。
- 更长的长篇小说请逐章分析。
- 支持 Unicode 字母、重音符号和撇号。
- 独立数字和标点不计入词数。
- 其他语言尚未验证。
- 分析在防抖后同步运行；接近输入上限时，性能较弱的设备可能卡顿。
- 插件不会把摘录发送到任何服务，也不会保存到持久化存储。
- 导出的报告可能包含重复句子的短片段。
- Harness 的其他功能有各自的数据处理方式。

JavaScript API

分析器也可以在 Harness 界面之外使用：

npm install dsh-novel-quality-analyzer

import {
analyzeStory,
DEFAULT_OPTIONS,
formatReport,js
} from 'dsh-novel-quality-analyzer/analysis';

const result = analyzeStory(storyText);

console.log(result.words);
console.log(result.score);
console.log(result.penalties);
console.log(formatReport(result));

可选设置： js const result = analyzeStory(storyText, { maxCharacters: 200_000, diversityWindow: 100, repetitionMinimum: 6, minimumScoredWords: 50, });

选项必须是正整数。API 支持最大字符数 1,000,000，最大多样性窗口 1,000 词。

输入无效、选项未知或文本过大时，会抛出 TypeError 或 RangeError。结果是 JSON 兼容的，score 可能为 null。

开发 bash
git clone https://github.com/umairrrkhan/dsh-novel-quality-analyzer.git
cd dsh-novel-quality-analyzer
npm ci
npm run check

常用命令： bash
npm run build
npm test
npm run benchmark
npm pack --dry-run

编辑：

- lib/analyzer.js —— 共享的分析实现。
- src/client.js —— Harness 浏览器界面。

编辑后运行 npm run build。不要手动编辑生成的 client.js。

这个包没有任何运行时 npm 依赖。React 和 UI 基础组件由 Harness 提供；构建和测试依赖仅用于开发。

验证

1.1.1 版通过了：

- Node 22.22.2 上的 28 项自动化测试。
- Node 24 上的 28 项自动化测试。
- 生成的浏览器打包产物一致性检查。
- 包内容检查与产物上传。
- 一次全新的公共 npm 安装与分析器冒烟测试。
- 验证已安装的 README 与发布源一致。

查看通过的 GitHub Actions 运行记录。

测试使用真实的 React，配合模拟浏览器和 Harness 服务。完整的实机 Harness 验收测试仍未验证。

DeepSeek Harness 是开发者预览版，API 仍在变化。集成是按 0.2.0-rc.2 版已发布的会话接口和 UI 基础组件接口检查的。

报告与发布说明

- 实现与质量报告
- 发布验证
- 更新日志
- 公共 npm 包

1.1.1 版修复了不受支持的 Node 22 测试命令参数，并包含更新后的 npm README。

GitHub 和 npm 显示的是两份独立的 README。编辑这个文件会更新 GitHub；要更新 npm 打包的 README，需要再发布一个包版本。

许可证

MIT。

由 umairrrkhan 维护。这是独立的社区插件，不是 DeepSeek 官方产品。