yyc12345/SuperScriptMaterializer
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
7b31e3576b
SuperScriptMaterializer/README_ZH.md

5.0 KiB
Raw Blame History

Super Script Materializer

English document

preview_image

超级Virtools脚本物化器（机翻（确信））

将Virtools文档中的所有脚本导出成一个SQLite数据库文件，然后经过Python进行排布处理，最后提供一个本地Web前端查看脚本。这同样适用于Script Hidden的Virtools脚本，也适用于其中含有不可展开的Behavior Graph的脚本。

物化器不能完全恢复脚本的原有排布，无论原有排布是否存在，物化器都将重新自动生成脚本中的各个元素的位置。某些结构的关系可能会改变（例如Export parameter），亦或者是与Virtools中的呈现不同，但是逻辑思路将不会改变。同时物化器不能将已经生成的结构回写成Virtools可接受的格式，因此物化器只能提供无视脚本隐藏的分析功能。

本工程代码源于另两个工程：BearKidsTeam/Script-Materializer（该工程用于将指定脚本导出为JSON文档）和BearKidsTeam/VirtoolsScriptDeobfuscation（该工程能够在Virtools 3.5中提供内置的隐藏脚本解析功能，将解析结果解析为可以被Virtools识别的格式）

本项目分为2个部分，SuperScriptMaterializer是一个C++工程，将生成一个Virtools界面插件用于导出初步数据，SuperScriptViewer是一个Python工程，将解析导出的数据，然后使用Flask提供一个本地Web界面进行脚本查看。

当前最新的commit并不一定可以稳定使用，请访问Release界面获取可以稳定使用的版本。且本程序的开发周期很长，如果您使用了第一个正式版之前的版本，那么您需要重新构建所有数据，因为之前的版本与正式版本不兼容。

使用方法

基本方法

将Virtools插件投入InterfacePlugins目录下，将sqlite3.dll和Dev.exe放在同一目录。如果你使用了Release页面的打包文件，则直接在Virtools根目录解压然后允许合并和覆盖即可。然后启动Virtools，打开需要解析的文档，点击菜单栏的Super Script Materializer-Export all script，保存为export.db，然后等待Virtools提示你已经导出完成。然后同样的操作执行Super Script Materializer-Export environment，并将其保存为env.db。

将export.db和env.db与SuperScriptViewer.py放在一起。然后在此目录中运行python ./SuperScriptViewer.py，等待Python交互界面提示可以打开本地的网页即可。

SuperScriptViewer.py具有一些命令行开关：

  • -i：指定输入的export.db
  • -o：指定输出的decorated.db，如果已经存在将不考虑输入，直接使用输出数据库呈现
  • -e：指定输入的env.db，环境数据库
  • -c：指定数据库编码，可用的编码表可以在这里查看
  • -f：无参数，用于强制重新生成输出数据库，无论输出数据库是否存在

以上选项在基本使用中应该不会用到，因此按上述规则直接放置好文件直接运行即可。

一份指导你如何使用Viewer的文档已内置在Viewer中，可以从Help页面进行查看

使用注意

  • 您需要先安装Virtools 5, Python和任意一种浏览器才能使用本工程。Python需要先安装Flask库。浏览器建议使用Chrome或Firefox，本程序不支持Safari浏览器。
  • 导出插件目前只支持Virtools 5，但Virtools 4已经过测试可以无修改编译运行。
  • 导出插件选择完文件后弹出错误，或者Python交互界面弹出错误，请附带您引起bug的文件以及错误窗口的内容提交bug
  • 如果Python交互界面提示数据库TEXT类型解码失败，或者解析的字符出现乱码，那么可能您需要手动使用-c开关指定数据库文本解码方式。因为Virtools使用多字节编码，依赖于当前操作系统的代码页，SuperScriptMaterializer做了特殊获取以保证大多数计算机可以直接运行，但仍然不能排除一些特殊情况。需要注意的是，指定的编码不是你计算机当前的代码页，而是制作这个Virtools文档的作者的计算机的代码页。
  • 如果您使用本工程的Release页面中提供的已编译好的Virtools界面插件，您需要放入的sqlite3.dll版本应为sqlite-dll-win32-x86-3310100

编译

只有Virtools界面插件需要编译，其余均为解释性语言无需编译。

需要手动配置Virtools插件的编译参数，例如包含路径等，需要指向您自己的Virtools SDK。对于SQLite SDK，您可以从sqlite.org下载，然后使用Visual C++的工具集执行LIB /DEF:sqlite3.def /machine:IX86以获取可以用于编译的文件。

开发计划

在之后的版本中，以下功能将逐步加入：

  • 当前页面搜索和全局搜索
  • Shortcut追踪
  • 在Viewer中移动Block和BB