VBASeismograph 使用与安装教程

1. 项目目录结构及介绍

VBASeismograph 项目目录结构如下：

VBASeismograph/
├── LICENSE
├── README.md
├── example_stomped_docs.txt
└── vba_seismograph.py

• LICENSE：项目的许可文件，本项目采用 MIT 许可协议。
• README.md：项目的说明文档，包含项目的介绍、安装、使用方法等信息。
• example_stomped_docs.txt：一个示例文档，用于展示项目检测到的 VBA stomping。
• vba_seismograph.py：项目的主程序文件。

2. 项目的启动文件介绍

项目的主程序文件为 vba_seismograph.py。该文件负责执行以下功能：

• 解析命令行参数。
• 读取 Office 文件中的 VBA 源代码。
• 使用 pcodedmp 库对 VBA 源代码进行反编译。
• 检测反编译后的 p-code 与原始 VBA 源代码之间的差异。
• 输出检测到的差异信息。

使用以下命令运行程序：

python vba_seismograph.py [选项] [文件名]

3. 项目的配置文件介绍

VBASeismograph 需要配置环境变量 PCODEDMP_DIR 来指定 pcodedmp 库的安装路径。根据您的操作系统和安装位置，您可以在 shell 配置文件（如 .bashrc 或 .cshrc）中添加以下内容：

对于 bash 用户：

export PCODEDMP_DIR=/path/to/your/pcodedmp

对于 csh 用户：

setenv PCODEDMP_DIR /path/to/your/pcodedmp

确保将 /path/to/your/pcodedmp 替换为实际的 pcodedmp 库安装路径。

完成环境变量的配置后，重新加载 shell 配置文件或重启终端，即可使用 VBASeismograph 项目。