Style Analyzer - 文本风格分析器
Overview
分析文本的写作风格特征，自动生成 Voice Profile 配置文件，包含风格标签、语速、语气、情感倾向等。用于保持小说创作的风格一致性。
使用场景：
- 需要捕捉作者的写作风格
- 需要为小说项目创建 Voice Profile
- 需要分析文本的句式/词汇/节奏特征
- 需要量化风格特征用于后续生成
分析维度
| 维度 | 分析内容 | 输出 |
|---|---|---|
| Voice Profile | 风格标签、语速、语气、情感倾向 | labels, pace, tone, sentiment |
| 句式特征 | 平均句长、长短句比例、修辞手法 | average_length, ratios, rhetorical_devices |
| 词汇特征 | 词性比例、高频词、词汇丰富度 | adj/verb/noun_ratio, frequent_words |
| 节奏特征 | 段落长度、标点分布、对话比例 | paragraph_length, punctuation, dialogue_ratio |
CLI 使用
# 基本用法
python3 scripts/analyze_style.py --input novel.txt --output style.yml
# 指定样本大小
python3 scripts/analyze_style.py \
--input novel.txt \
--output style.yml \
--sample-size 2000
# 分析结果输出到终端 + 保存 YAML
python3 scripts/analyze_style.py -i text.txt -o style.yml
参数说明
| 参数 | 必填 | 说明 |
|---|---|---|
--input / -i | ✅ | 输入文本文件路径 |
--output / -o | ✅ | 输出 YAML 配置文件路径 |
--sample-size / -s | ❌ | 分析样本大小（默认 1000 字符） |
输出 YAML 格式
voice_profile:
labels:
- 简洁
- 快速
- 紧凑
- 对话性强
pace: 快速
tone: 随意
sentiment: 0.15
sentence_features:
average_length: 28.5
long_sentence_ratio: 0.15
short_sentence_ratio: 0.65
rhetorical_devices:
metaphor: 3
simile: 2
vocabulary_features:
adj_ratio: 0.12
verb_ratio: 0.18
noun_ratio: 0.35
most_frequent_words:
- - 主角
- 15
- - 说道
- 12
unique_words_ratio: 0.68
rhythm_features:
average_paragraph_length: 156
punctuation_distribution:
period: 45
comma: 78
question: 12
exclamation: 5
dialogue_ratio: 0.35
风格标签说明
| 标签 | 含义 | 触发条件 |
|---|---|---|
| 简洁 | 句子简短 | 平均句长 ≤ 40 字符 |
| 复杂 | 句子较长 | 平均句长 > 40 字符 |
| 快速 | 节奏紧凑 | 平均句长 < 30 字符 |
| 舒缓 | 节奏缓慢 | 平均句长 ≥ 30 字符 |
| 紧凑 | 标点密集 | 每句平均字符 < 30 |
| 娓娓道来 | 叙述舒缓 | 每句平均字符 ≥ 30 |
| 互动性 | 有问句 | 包含？或! |
| 对话性强 | 对话多 | 包含引号对话 |
| 节奏感强 | 标点丰富 | 包含，、； |
语速分类
| 语速 | 条件 |
|---|---|
| 缓慢 | 平均句长 > 50 字符 |
| 适中 | 平均句长 30-50 字符 |
| 快速 | 平均句长 < 30 字符 |
语气分类
| 语气 | 条件 |
|---|---|
| 正式 | 正式标记词 > 随意标记词 × 2 |
| 随意 | 随意标记词 > 正式标记词 × 2 |
| 中性 | 介于两者之间 |
正式标记词：因此、然而、综上所述、基于此、由此可见
随意标记词：我觉得、我想、你知道、其实、就是说
情感倾向
范围：-1.0 到 1.0
- 正值：积极情感（好、美、喜欢、爱、快乐等）
- 负值：消极情感（坏、丑、讨厌、恨、悲伤等）
- 0 附近：中性情感
依赖
- Python 3.8+
- rich (终端渲染)
- PyYAML (配置文件解析)
安装依赖：
pip install -r scripts/requirements.txt
与其他技能集成
与 smart-prompt-builder 集成
# 1. 分析风格
python3 ../style-analyzer/scripts/analyze_style.py \
--input reference_text.txt \
--output style.yml
# 2. 使用生成的 Voice Profile 构建提示词
python3 ../smart-prompt-builder/scripts/build_prompt.py \
--scene-type description \
--style-file style.yml \
--context '{"scene": "森林"}'
与 novel-writer 集成
# 1. 分析参考文本风格
python3 ../style-analyzer/scripts/analyze_style.py \
--input author_sample.txt \
--output style.yml
# 2. novel-writer 使用 style.yml 保持风格一致
注意事项
- 样本大小建议 ≥ 500 字符，以获得准确的风格分析
- 支持 UTF-8 和 GBK 编码的文本文件
- 输出 YAML 可直接用于 smart-prompt-builder 的 --style-file 参数
- 修辞手法检测基于关键词匹配，可能不完全准确