convez.ai
SkillEscrita & ConteúdoAvançado
QQ-L-XX

Novel Deconstruct — Desconstrutor de Romances com IA

QQ-L-XX/novel-deconstruct

Análise estrutural profunda de romances: decodificação automática + varredura quantitativa + relatório 18-dimensional

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill Python para Claude Code que realiza análise estrutural profunda de romances da web. Extrai automaticamente capítulos, decodifica fontes, realiza varredura quantitativa e gera relatório detalhado de 18 dimensões analíticas (estrutura narrativa, índices textuais, arcos de personagens, diagnóstico de escrita) usando frameworks de Robert McKee, Xu Rongzhe e Dorothy Brande.

Instalação

$npx convez-ai QQ-L-XX/novel-deconstruct

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
21
Forks
3
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Análise estrutural detalhada de romances para escritores estudarem técnicas narrativas
  • Diagnóstico de qualidade textual: variação sentencial, densidade de palavras-chave, padrões de diálogo
  • Rastreamento de arcos de valor e evolução de personagens ao longo de capítulos
  • Identificação de técnicas de escrita (hooks, estrutura em sete passos, conflito em três camadas)
  • Detecção de palavras-fadiga e padrões que indicam IA gerada vs. escrita autêntica

Veredito

Ferramenta especializada e sofisticada para análise narrativa profunda, útil para escritores que estudam técnica e críticos que querem dissecação estrutural rigorosa. Limitações: suporte inicial apenas a Fanqie Novel (primeiros 10 capítulos gratuitos), OCR ~95% de precisão, requer Python 3.11+. Não é ferramenta de escrita direta, mas de aprendizado técnico via desconstrução.

README

A tradução para o português deste README ainda está na fila.

Novel Deconstruct — AI 拆书技能

让 AI 成为你的专业拆书搭档。输入番茄小说等平台的链接,自动抓取、解码、定量扫描、场景级深度拆解,输出 18 章结构化拆书报告。

License: MIT Platform: Claude Code Python: 3.11+

什么是拆书?

拆书(Novel Deconstruction)是对网络小说进行系统性的写作技法分析——不是写书评、不是读后感,而是用麦基《故事》的结构理论、许荣哲《小说课》的技法框架、布兰德《成为作家》的创作理念,逐章逐场景地解剖一本小说的骨骼和肌肉。

你得到什么?

一份 18 章的结构化拆书报告,包含:

层次内容细度
宏观结构七步骨架分析、八幕结构全景、激励事件定位、冲突三层验证全书级
定量扫描10章 × 8项指标(句长/短句比/了密度/对话比)+ 6类疲劳词扫描数据级
场景拆解逐场景切分→逐段功能标注→鸿沟检查→技法点评→钩子评估段落级
价值追踪10章 × 6维度变化矩阵(处境/关系/认知/情绪/钩子类型)章节级
人物分析面具与真相、弧光轨迹、群像功能(出场→完成→退场)人物级
文字诊断疲劳词超标项、「让」字专项统计、情绪标签词区分对话/旁白词级

快速开始

1. 安装技能

# 克隆到 Claude Code 技能目录
git clone https://github.com/QQ-L-XX/novel-deconstruct.git \
  ~/.claude/skills/novel-deconstruct

2. 安装依赖

pip install fonttools brotli Pillow ddddocr requests

3. 开始拆书

在 Claude Code 中,发送一个番茄小说链接,然后说 「拆书」:

https://fanqienovel.com/page/7519389279345200152 帮我拆一下这本书

技能会自动触发,完整流程:

获取元数据 → 抓取章节 → 解码字体 → 定量扫描
→ 场景级深度拆解 → 价值变化追踪 → 结构层分析
→ 输出18章拆书报告到桌面

分析框架

本技能融合以下理论体系:

  • 罗伯特·麦基《故事》:七步骨架、鸿沟推进机制、激励事件、对抗力量升级
  • 许荣哲《小说课》:一波三折、三番四震、冰山对话
  • 多萝西娅·布兰德《成为作家》:写改分离、诚实原创、冷却期修改
  • 中国传统叙事理论:一波三折、以景写情、镜头感对话
  • 反AI工程规则:疲劳词阈值、句式检测、活人感动作顺序、手机排版

支持平台

平台状态说明
番茄小说 (fanqienovel.com)✅ 完整支持字体解码 + API抓取,前10章全文
起点中文网🔜 计划中
晋江文学城🔜 计划中
用户直接粘贴文本✅ 支持跳过抓取,直接分析

工具脚本

脚本功能
tools/decode_font.py番茄字体解码器:下载woff2 → fontTools解析cmap → ddddocr OCR → 映射JSON
tools/fetch_novel.py章节批量抓取器:章节列表 → 采样策略 → 逐章请求+解码 → 保存TXT

报告示例

拆解《我在末世经营中餐厅爆火》(冰可乐代喝,650章,番茄小说):

## 十二、逐章定量扫描(Ch1-10)

| Ch | 字数 | 场景数 | 句均长 | 短句% | 长句% | 了/段 | 对话% | 情绪标签词 |
|----|------|--------|--------|-------|-------|-------|-------|-----------|
| 1 | 2261 | 4 | 20.9 | 40 | 22 | 0.4 | 3.0 | 0 |
| 7 | 2132 | 1 | 14.3 | 64 | 13 | 0.4 | 5.4 | 0 |

关键发现:Ch7句均长仅14.3字、短句占比64%
——这是「把所有人都带过来」的高潮章节,所有指标指向作者在有意识地加速。

已知局限

  • 番茄小说第11章起需要登录/VIP,免费章节仅能获取前10章全文
  • 第三方镜像站不稳定,可能随时失效
  • 字体每次请求可能不同,需每次重新OCR建映射(~15秒)
  • OCR准确率约95%,个别形近字可能误识别

协作工具

本技能设计为与以下工具配合使用:

  • awesome-novel-skill:AI小说创作工作流。拆书分析出的技法规律,可以注入到 awesome-novel-skill 的写作风格设定中进行实战应用

许可证

MIT License

贡献

欢迎提交 Issue 和 Pull Request。特别欢迎:

  • 新平台抓取适配(起点/晋江/纵横等)
  • 新分析维度
  • OCR准确率优化
  • 报告模板优化
Ver o original no GitHub

Bom para

Relacionados