Skip to content

QQ-L-XX/novel-deconstruct

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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准确率优化
  • 报告模板优化

About

AI拆书技能 for Claude Code——输入番茄小说链接,自动字体解码→定量扫描→场景级深度拆解→18章结构化报告。融合麦基故事+许荣哲小说课+布兰德成为作家三书体系。

Topics

Resources

License

Stars

6 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages