xCyclopedia 项目使用教程

1. 项目目录结构及介绍

xCyclopedia 项目的目录结构如下：

xcyclopedia/
├── assets/
├── output/
├── script/
├── .gitignore
├── LICENSE
└── README.md

目录介绍：

• assets/: 存放项目相关的静态资源文件。
• output/: 存放项目生成的输出文件，包括 JSON 和 CSV 格式的数据。
• script/: 存放项目的脚本文件，用于收集和处理可执行文件的数据。
• .gitignore: Git 忽略文件，指定哪些文件或目录不需要被版本控制。
• LICENSE: 项目的开源许可证文件，本项目使用 MIT 许可证。
• README.md: 项目的说明文件，包含项目的基本介绍、使用方法和贡献指南。

2. 项目启动文件介绍

xCyclopedia 项目的主要启动文件是 script/ 目录下的 PowerShell 脚本。以下是主要的启动脚本：

• Get-Xcyclopedia.ps1: 该脚本用于递归遍历指定目录中的所有可执行文件，并收集其运行时数据、文件元数据、数字签名信息等。
• Get-ComObjects.ps1: 该脚本用于遍历所有 COM 对象，收集其相关信息，如 CLSID、ProgIDs、文件路径等。

使用方法：

# 启动 Get-Xcyclopedia 脚本
.\script\Get-Xcyclopedia.ps1 -save_path "c:\xCyclopedia\out\" -target_path "$env:windir\system32" -target_file_extension "exe"

# 启动 Get-ComObjects 脚本
.\script\Get-ComObjects.ps1 -save_path "c:\xCyclopedia\out\" -create_instance $true

3. 项目配置文件介绍

xCyclopedia 项目没有传统的配置文件，但可以通过命令行参数进行配置。以下是一些常用的配置参数：

Get-Xcyclopedia.ps1 配置参数：

• -save_path: 指定输出文件的保存路径。
• -target_path: 指定要遍历的目录路径。
• -target_file_extension: 指定要收集的可执行文件的扩展名（默认为 "exe"）。
• -execute_files: 是否执行文件以收集运行时数据（默认为 $false）。
• -take_screenshots: 是否在执行文件时截取屏幕截图（默认为 $false）。

Get-ComObjects.ps1 配置参数：

• -save_path: 指定输出文件的保存路径。
• -create_instance: 是否创建 COM 实例以收集更多信息（默认为 $false）。

通过这些配置参数，用户可以根据自己的需求定制 xCyclopedia 项目的运行方式。