文档扫描工具

要解决什么问题

项目交付或知识归档时，目录往往层级深、文件类型杂：视频、Office 文档、PDF 混在一起。人工逐个打开看页数、时长和体积，既慢又容易漏；用普通 tree 或文件管理器导出，也拿不到 PPT/Word/PDF 页数、视频时长 这类汇总字段，更谈不上按类型一眼区分。

技能如何工作

本技能走一条固定流水线：扫描目录 → 收集文件信息 → 生成 Excel 文件树。

• 递归扫描：遍历目标路径下所有子文件夹与文件。
• 信息提取：记录文件大小；对 .mp4 等视频用 OpenCV（cv2）读时长；对 Word/PDF/PPT 统计页数；Excel 类主要记录大小与类型。
• 导出结构：工作表名为「文件树」，列包括名称（超链接）、类型、文件类型、大小(MB)、时长、页数、完整路径；名称列可点击打开本地文件或文件夹。
• 可读性：按文件类型给行着色（视频黄 / PPT 橙 / Word 蓝 / Excel 绿 / PDF 红）。
• 可选过滤与列：可只扫描 video / ppt / word / excel / pdf / other 等类型，并自定义导出哪些列。

交互使用时，会先确认目录存在，再询问是否按类型过滤、输出路径（默认可为目录下的 文件树.xlsx），然后执行扫描并回报结果；也支持直接运行脚本或 Python 调用。

适用边界与注意点

• 视频时长依赖 opencv-python；未安装时视频时长会显示为「未知」，其它列仍可用。
• 页数与格式解析受具体文件版本与损坏情况影响，异常文件应在结果里单独核对。
• 超链接指向本地路径，适合内网归档、交付清单自检；不适合当作对外发布的静态链接页面。