小说进度可视化
何时使用
- 想快速查看当前项目的正文、大纲、设定文件占比
- 想生成一份可视化进度图用于自查
生成一个 HTML 饼图,展示项目中各类型文件的字数占比。
工作方式
运行 scripts/progress_chart.py,它会自动:
- 扫描项目目录,按类型统计字数
- 在项目根目录生成
progress.html - 用浏览器打开
文件分类规则
| 分类 | 匹配路径 | 说明 |
|---|---|---|
| 大纲 | chapters/e{num}/ch-{seq}/大纲.md |
各章精简剧情纲要 |
| 设定文件 | memory/** |
世界观、角色、物品等设定 |
| 正文 | chapters/e{num}/ch-{seq}/正文.md |
已撰写的章节正文 |
字数统计规则
- 统计中文字符、标点、数字、英文字母
- 排除空白字符和 Markdown 语法标记(
#、*、-、>、|、`、---) - 排除 YAML frontmatter(
---之间的内容)
用户参数
用户可以指定 --output 路径或 --open false 不自动打开浏览器。
默认:输出到项目根目录 progress.html 并自动打开。