Style Analyzer

---

name: style-analyzer description: 文本风格分析器 - 分析写作风格特征并生成 Voice Profile 配置文件。当需要捕捉作者风格、创建 Voice Profile 或分析文本特征时使用。

---

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 参数

修辞手法检测基于关键词匹配，可能不完全准确