安装
一个可执行文件，无需账户，没有后台服务。安装程序可以把程序和数据目录放在不同位置，应用程序也可以直接从构建文件夹运行而无需安装。
系统要求
| 项目 | 要求 |
|---|---|
| 操作系统 | Windows 10 或更新版本 |
| 架构 | x86 是主要构建；项目中存在 x64 配置，但不属于标准解决方案 |
| 运行时 | Microsoft Visual C++ 2015–2022 Redistributable（x86） |
| CAN | J2534 Pass-Thru 适配器及其厂商驱动 |
| DoIP | 车辆可访问的以太网适配器，IP 和端口设置正确 |
| 磁盘 | 一个可写的工作区目录 |
从源代码构建还需要带工具集 v145、C++20 和 MSBuild 的 Visual Studio。
安装
- 安装程序尚未发布。发布后请从发布页下载
bmsetup.exe。 - 运行安装程序。默认程序目录为
Program Files\BlackMagic；安装程序还会要求指定数据目录。 - 如果 Windows 提示需要 Visual C++ 可再发行组件，请安装 x86 包并重新运行安装程序。
- 从开始菜单启动 BlackMagic。
安装程序从不会覆盖已有的用户数据；升级时只添加缺失的文件。默认情况下，卸载会保留数据文件夹和全局设置。
静默安装
powershell
bmsetup.exe /VERYSILENT /DIR="C:\Program Files\BlackMagic" /DATAPATH="D:\BM\data"无效的 /DATAPATH 会以非零退出码中止，且不会弹出阻塞对话框，因此该命令可安全用于脚本。
免安装运行
BlackMagic.exe 可以直接从构建文件夹启动。工作文件和日志会创建在所选择的工作区中；全局设置仍写入 %APPDATA%\BlackMagic。
设置
View → Settings（Alt+,）包含三组：
- PassThru Interface — J2534 驱动；切换后应用会重新连接。
- User preferences — 启动时打开上次项目、FPS limit、配色（Light / Dark / Classic）、字体缩放、拖动速度、撤销深度（0–100）以及数值的外部编辑器。
- Automation — 允许 AI/MCP 修改项目、允许实时写入 ECU，并在 write DID、routine start、IO control、memory write 和 raw UDS 前询问。危险操作默认需要确认。
未签名构建
当前构建未进行代码签名。首次运行时 Windows SmartScreen 可能显示警告；只有在文件来自官方下载页时才使用 More info → Run anyway。
首次启动
应用会要求选择工作区目录。工作区是普通文件夹，因此可以放在任何具有写权限的驱动器上。布局见工作区。
更新与卸载
- 更新：运行较新的安装程序；数据目录会保留。
- 交互式卸载会询问是否保留数据文件夹和
%APPDATA%\BlackMagic\config_global.json。回答 No 会删除配置，并且仅当数据文件夹带有安装程序的标记文件时才删除该文件夹。 - 静默卸载始终保留数据文件夹和全局配置。