v1.0.3 — Windows Defender false-positive mitigation

ASM2HEX2 v1.0.3 发布说明

安全 / 防误报

部分 Windows Defender / SmartScreen 版本会对 未代码签名 的 MinGW 静态链接程序给出机器学习启发式告警，例如：

• Trojan:Win32/Sabsik.FL.A!ml

这是 误报（False Positive），不是程序被植入木马。本仓库源码公开，Windows 构建仅静态链接 wxWidgets / Keystone / Capstone 与 MinGW 运行库，不包含网络后门或加密矿工逻辑。

本版本针对误报的构建改进

1. 嵌入 VERSIONINFO（产品名、作者、版本、项目 URL）
2. 嵌入 application manifest（asInvoker、常见控件、DPI）
3. 取消全量 -s strip，仅 --strip-debug（全量剥离容易触发 Sabsik 类 ML 规则）
4. 编译优化由 -Os 调整为 -O2（更接近常规应用布局）

仍为 静态链接 MinGW 运行库：不依赖 libgcc / libstdc++ / libwinpthread DLL。

若仍被拦截

1. 到 Microsoft Security Intelligence 误报提交 选择 Software developer，上传 ASM2HEX-win64.exe 并注明 open-source GUI 工具与仓库地址。
2. 临时允许：Windows 安全中心 → 保护历史记录 → 允许；或添加文件夹排除（仅当你信任该来源）。
3. 优先从本 GitHub Release 下载，核对文件大小/发布说明。
4. 长期方案：使用 Authenticode 代码签名证书 签名发布包（最有效降低 SmartScreen）。

下载

Windows 仅提供 ZIP（不解压不直接提供 .exe 下载，降低浏览器/SmartScreen 对裸 exe 的拦截）：

平台	文件	说明
Windows x64	ASM2HEX-win64.zip	解压后得到 ASM2HEX.exe
Linux x64	ASM2HEX-linux-x64.tar.xz	解压后运行 ASM2HEX
macOS	ASM2HEX-macos-arm64.tar.xz	解压后运行 ASM2HEX（若有）

# Windows
展开 ASM2HEX-win64.zip → 运行 ASM2HEX.exe

变更

• src/win/asm2hex.rc + asm2hex.manifest：版本与清单资源
• CMake Windows：链接资源文件；去掉全量 -s；静态运行库保留

版本

• 上一版本：v1.0.2
• 本版本：v1.0.3（Windows 误报缓解补丁）

v1.0.2 — Static multi-platform binaries

ASM2HEX2 v1.0.2 发布说明

Multi-platform static-linked prebuilt binaries.

亮点

• Windows x64：全静态 MinGW 链接（无 libgcc / libstdc++ / libwinpthread DLL 依赖），仅依赖系统 DLL
• Linux x64：静态链接 wxWidgets、Keystone、Capstone 与 libgcc/libstdc++；GTK/X11 仍为系统共享库（Linux GUI 常规方式）
• macOS arm64：静态链接 wxWidgets + 引擎；系统 Framework 保持动态（Cocoa 常规方式）
• 保留 v1.0.1 的 Linux CMake 修复（#2）

下载

平台	文件
Windows x64	ASM2HEX-win64.exe 或 ASM2HEX-win64.7z
Linux x64	ASM2HEX-linux-x64 或 ASM2HEX-linux-x64.tar.xz
macOS Apple Silicon	ASM2HEX-macos-arm64 或 ASM2HEX-macos-arm64.tar.xz

使用

• Windows：直接运行 ASM2HEX-win64.exe（Win7+）
• Linux：chmod +x ASM2HEX-linux-x64 && ./ASM2HEX-linux-x64（需 GTK3 运行库）
• macOS：chmod +x ASM2HEX-macos-arm64 && ./ASM2HEX-macos-arm64（首次可能需在「隐私与安全性」中允许）

从源码静态构建

# Windows (MinGW + Ninja)
powershell -File scripts/build_win_static.ps1

# Linux
./scripts/build_linux_static.sh

GitHub Actions workflow：.github/workflows/release-binaries.yml（Windows / Linux / macOS）。

变更摘要

• CMake：-static / -static-libgcc / -static-libstdc++ 放到 link 选项（此前误放在 compile 导致仍依赖 MinGW DLL）
• CMake：修复 CMAKE_RUNTIME_OUTPUT_DIRECTORY 顺序，产物输出到 out/
• 新增跨平台静态构建脚本与 Release CI
• Linux 优先使用 dep/lib/linux/*.a 静态引擎库

版本

• 上一版本：v1.0.1
• 本版本：v1.0.2

v1.0.1 — Linux CMake build fixes (#2)

ASM2HEX2 v1.0.1 发布说明

Patch release focused on Linux build fixes reported in open issues.

修复 (Fixes)

#2 Linux 下编译遇到的几个问题

按社区反馈与 diff 修复 CMakeLists.txt 的 Linux 分支（Windows / macOS 分支保持不变）：

1. src/cstool 加入 include 路径 — 解决 cstool 头文件找不到的问题
2. 链接 wxWidgets 静态库 — 按依赖顺序链接 stc → scintilla → adv / html → core → base
3. 可选链接 gspell — 通过 pkg_check_modules(GSPELL gspell-1)（非 REQUIRED），找到时链接 ${GSPELL_LIBRARIES}
4. 链接 Xxf86vm — 补齐 X11 相关符号

另外在 Linux include 路径中补齐 dep/keystone/include 与 dep/capstone/include，与 Windows/macOS 一致。

构建说明

Windows

mkdir build && cd build
cmake .. -G Ninja -DCMAKE_BUILD_TYPE=Release
cmake --build .

可执行文件：out/ASM2HEX.exe 或 build/ASM2HEX.exe（视 CMake 输出目录配置而定）。

Linux

1. 按 doc/linux.pdf 准备静态 wxWidgets（dep/linux/）
2. 安装系统依赖（GTK3、X11 等）；如需拼写检查相关符号可安装 libgspell-1-dev
3. 配置并编译：

mkdir build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
cmake --build .

回归检查（CMake 结构）

python3 tests/test_cmake_linux_fixes.py

版本

• 上一版本：v1.0.0
• 本版本：v1.0.1（fix-only patch）

致谢

感谢在 #2 中提供复现与参考 diff 的报告者。

v1.0.0

ASM2HEX2 v1.0.0 发布说明

新特性

• 支持 Windows (MinGW64)、macOS、Linux 多平台编译与运行
• 集成 wxWidgets 跨平台 GUI，界面友好
• 支持汇编代码与十六进制互转，适配多种架构
• 内置 Capstone/Keystone 引擎，支持反汇编与汇编
• 支持批量转换、文件拖拽、剪贴板操作
• 丰富的错误提示与日志输出
• 提供自动化脚本一键配置 MinGW64 和 wxWidgets 环境（Windows）
• CMake 构建系统，支持体积优化编译参数

优化与修复

• Windows 版本默认静态链接，减小依赖
• 优化编译参数，减小可执行文件体积
• 兼容新版 wxWidgets 3.2.3
• 修复部分平台下路径和环境变量问题

使用说明

1. 按照 dep 目录下脚本/文档配置依赖环境
2. 使用 CMake 进行跨平台编译
3. 运行 out/ASM2HEX.exe（或对应平台可执行文件）

致谢

感谢 wxWidgets、Capstone、Keystone 等开源项目。

---

如有问题请查阅 README 或提交 issue。