Windows软件清单查询工具 - 使用说明文档

📋 工具简介

Windows软件清单查询工具是一个基于kuai格式开发的Python脚本，能够全面扫描Windows系统中已安装的软件，工具采用现代化的HTML界面设计，提供精美的卡片式展示和强大的交互功能。

✨ 主要功能特色

🎨 智能图标提取

• 多源图标获取：从exe、ico、png、bmp等多种格式文件中提取真实软件图标
• 智能路径解析：自动解析注册表DisplayIcon、快捷方式目标、安装目录等多个来源
• 图标优化处理：自动调整图标尺寸，转换为base64格式便于展示
• 默认图标分类：根据软件类型和名称提供合适的Emoji默认图标

📁 智能路径推断

• 多维度分析：结合注册表InstallLocation、DisplayIcon、UninstallString等信息
• 快捷方式追踪：在桌面和开始菜单中搜索相关快捷方式，解析目标路径
• 目录智能搜索：在常见安装路径中基于软件名称和发布商进行智能匹配
• 路径有效性验证：自动排除临时目录、缓存目录等无效路径

📅 时间智能推断

• 多源时间获取：从注册表InstallDate、目录创建时间、文件时间等获取安装日期
• 时间格式处理：支持多种时间格式的解析和标准化
• 推断方式标注：清晰标注时间数据的来源和可靠性

🔍 高级扫描模式

• 标准模式：仅显示用户安装的软件，过滤系统组件和更新补丁
• 深层扫描模式：显示所有注册表条目，包括系统组件、子组件、系统更新等
• 智能分类：自动识别和分类不同类型的软件条目

📊 现代化界面

• 响应式设计：支持桌面端和移动端自适应显示
• 卡片式布局：现代化的卡片设计，信息展示清晰直观
• 渐变背景：精美的渐变色背景和毛玻璃效果
• 动画效果：流畅的hover动画和交互反馈

🚀 强大的交互功能

• 实时搜索：支持软件名称、发布商、版本等关键词实时搜索
• 多维筛选：按软件类型、安装日期等条件进行筛选
• 灵活排序：支持名称、日期、大小、发布商等多种排序方式
• CSV导出：一键导出筛选结果为Excel兼容的CSV文件
• 快捷键操作：Ctrl+F快速搜索，Ctrl+S快速导出

🛠️ 使用方法

环境要求

• Windows 11 操作系统
• Python 3.11.0 或更高版本
• 以下Python包（kuai客户端会自动安装）：
  • pywin32：Windows API调用
  • Pillow：图像处理

运行步骤

1. 启动脚本：在kuai客户端中加载并运行main.py
2. 配置参数：根据需要选择是否开启深层扫描模式
3. 等待扫描：脚本会自动扫描系统并提取软件信息（可能需要几分钟）
4. 查看报告：扫描完成后会自动生成HTML报告并在浏览器中打开

参数说明

深层扫描模式

• 开启：显示所有注册表条目，包括系统组件、更新补丁、子组件等
• 关闭：仅显示用户安装的软件，与Windows控制面板"程序和功能"显示内容一致

建议：

• 普通用户建议关闭深层扫描，获得更简洁的软件列表
• 系统管理员可开启深层扫描，获得完整的系统组件信息

🔧 技术实现原理

注册表扫描

脚本扫描以下注册表位置：

• HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall
• HKEY_CURRENT_USER\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall
• HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall

智能推断算法

1. 图标提取优先级：

   • DisplayIcon注册表项 → 快捷方式目标 → 安装目录ico文件 → 卸载程序exe → 主程序exe → 默认图标

2. 路径推断优先级：

   • 注册表InstallLocation → DisplayIcon推断 → UninstallString推断 → 智能目录搜索

3. 日期推断优先级：

   • 注册表InstallDate → 目录创建时间 → 主程序文件时间

数据处理流程

1. 第一阶段：扫描注册表，获取基础软件信息
2. 第二阶段：对每个软件进行智能推断，提取图标
3. 第三阶段：生成HTML报告，处理前端交互

📊 报告功能详解

统计信息

• 总计条目：显示扫描到的软件总数
• 安装目录获取率：成功推断安装目录的软件比例
• 图标信息获取率：成功提取图标的软件比例
• 安装日期获取率：获得安装日期信息的软件比例

搜索和筛选

• 搜索范围：软件名称、发布商、版本号
• 筛选条件：软件类型、安装日期状态
• 排序选项：名称、日期、大小、发布商（升序/降序）

数据导出

导出的CSV文件包含以下列：

• 软件名称、发布商、版本、安装日期、安装大小
• 安装目录、推断方式、图标路径、图标来源
• 软件类型（仅深层扫描模式）

⚠️ 重要注意事项

数据准确性

• 注册表数据：直接从Windows注册表读取，准确性较高
• 推断数据：通过算法智能推断，仅供参考，不保证100%准确
• 标注说明：报告中小字标注显示数据来源和推断方式

权限要求

• 需要管理员权限才能完整访问系统注册表
• 某些受保护的软件信息可能无法获取

性能影响

• 深层扫描会增加处理时间和系统负载
• 图标提取过程可能消耗较多内存和CPU资源

兼容性

• 主要针对Windows 11设计，其他Windows版本可能存在兼容性问题
• 某些特殊软件的信息可能无法正确识别

🐛 故障排除

常见问题

Q：扫描时间过长怎么办？ A：这是正常现象，智能推断需要时间。可以关闭深层扫描模式来减少处理时间。

Q：某些软件没有图标显示？ A：可能是因为：

• 软件没有标准的图标文件
• 图标文件路径无效或损坏
• 权限不足无法访问图标文件

Q：安装目录显示不正确？ A：推断的安装目录仅供参考，可能因为：

• 软件使用了非标准的安装位置
• 注册表信息不完整或错误
• 算法无法正确匹配目录

Q：导出的CSV文件乱码？ A：请使用支持UTF-8编码的软件打开，如Excel 2016及以上版本。

性能优化建议

• 关闭其他大型程序，确保足够的系统资源
• 在SSD硬盘上运行可以提高扫描速度
• 定期清理系统注册表可以提高扫描效率

📄 免责声明

本工具显示的安装目录、图标路径等信息多为算法推断结果，仅供参考使用。作者不对信息的准确性和完整性承担责任。请用户在使用过程中注意验证重要信息的正确性。