note-summarizer

用途：把学习资料整理为结构化知识点大纲，并导出 .docx 摘要文档，适合需要从 Word/PPT/Text/Markdown 输入生成可分享层级文档的可复现流程。主要能力：支持 .docx、.pptx、.txt、.md 多格式输入；导出含 Heading 1/2/3 大纲的 Word 文档；为每个小节生成要点项目符号摘要，可配置条数上限；可选保留原始标题层级；可选处理图片，复制到输出文档对应小节；纯本地处理，不访问网络，尽量不记录用户内容。使用方式：需 Python 3.9+（仓库基线为 3.10+），安装 python-docx、python-pptx、Pillow（执行 python -m pip install python-docx python-pptx pillow）。可交互运行 python scripts/note_summarizer.py，或使用 JSON 配置：python scripts/note_summarizer.py --json input.json。配置字段包括 inputs（输入文件路径数组）、output（输出 .docx 路径）、keep_headings（默认 true）、max_bullets_per_section（默认 6）、image_mode（copy 或 skip，默认 copy）、max_image_long_edge（默认 1600）。运行前先确认输入路径、输出路径、范围过滤、阈值和领域约束；可用 python -m py_compile scripts/note_summarizer.py 和 python scripts/note_summarizer.py --help 做基本检查。适用场景：课堂笔记清洗为带每节要点的提纲、把 Word+PPT+Markdown 多来源笔记合并为统一学习摘要、保留 H1/H2/H3 层级并归纳要点、把源材料图片放入导出 Word 对应小节、需要离线本地文件的笔记总结流程。限制：仅处理本地文件，不访问网络；只读取用户提供路径并只写入指定输出路径；第三方包未显式固定版本，如需严格环境控制应自行添加版本锁定；输出效果依赖输入文档的标题结构，图片复制受 max_image_long_edge 限制；其他收费、平台支持或具体效果信息暂未提供。