| name | novel-progress |
| description | 项目进度、字数统计、可视化饼图。触发词:”进度””字数””饼图””progress””当前写了多少””字数占比”。 |
| when_to_use | 查看项目进度或生成可视化图表时使用。
只读不写,不修改正文或大纲内容。
|
小说进度可视化
何时使用
- 想快速查看当前项目的正文、大纲、设定文件占比
- 想生成一份可视化进度图用于自查
生成一个 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 并自动打开。