nirvanaslash/dsh-bat2exe

dsh-bat2exe

将 Windows .bat / .cmd 启动器变成真正的 .exe —— 直接在 DeepSeek Harness 内完成。

该 EXE 是一个薄壳：它定位自身旁边的批处理文件，并将整个任务交给 cmd.exe。启动器逻辑保持为可编辑的文本，二进制文件中没有硬编码任何工具路径，升级批处理文件所调用的任何内容都无需重新编译。

安装

dsh plugin --profile web add dsh-bat2exe

重启 DSH，然后让 agent 构建一个启动器 —— 或直接调用该工具。

工具

bat2exe_build

| 参数 | 含义 |
|---|---|
| bat | 必填 —— .bat/.cmd 文件的路径（绝对路径，或相对于工作目录的路径） |
| name | 输出可执行文件的名称；默认为批处理文件名加 .exe |
| iconText | 在生成的图标上绘制的字符，最多四个 |
| iconTextColour | 图标文字颜色，格式为 #rrggbb |
| icon | 使用现有的 .ico，而不是渲染一个 |
| startMenuShortcut | 同时写入一个开始菜单快捷方式 |
| desktopShortcut | 同时写入一个桌面快捷方式 |

构建运行四个步骤，全部为本地且离线：

1. 图标 —— 使用内置的 5×7 位图字体，渲染一个带有对角渐变和给定文字的圆角方形底板，然后将其打包为 256×256 ICO。无需图像库，无需外部工具。
2. C# 外壳 —— 生成一个包装器，其唯一职责是从自身所在目录运行批处理文件，转发所有参数并保留退出代码。
3. 编译 —— 使用 .NET Framework 的 csc.exe（当仅存在 .NET SDK 时回退到 dotnet build），并将图标作为资源嵌入。
4. 快捷方式 —— 可选的 .lnk 文件，通过 WScript.Shell 写入。

bat2exe_probe

报告本地工具链 —— C# 编译器路径、.NET SDK 是否存在、PowerShell，以及解析后的默认值 —— 以便在尝试构建之前诊断失败原因。

设置

bat2exe 注册了一个设置命名空间，因此默认值可在设置 → 插件中编辑，而无需手动编辑配置文件补丁：

| 键 | 默认值 | 含义 |
|---|---|---|
| iconText | BAT | 在生成的图标上绘制的文字 |
| iconFrom / iconTo | #12204a / #4a6cf7 | 渐变起点 / 终点 |
| workDir | .bat2exe | .cs、.ico 及其他副产品的存放位置 |
| startMenuShortcut | false | 开始菜单快捷方式的默认值 |
| desktopShortcut | false | 桌面快捷方式的默认值 |

每次调用工具时的参数始终优先于这些默认值。

要求

- Windows。 该流水线编译 Windows PE 并写入 .lnk 文件。
- C# 编译器：.NET Framework 4.x（csc.exe，原版 Windows 上就有）或 .NET SDK。
- 仅创建快捷方式时需要 PowerShell（首选 pwsh，也接受 Windows PowerShell）。

bat2exe_probe 会准确报告找到了其中哪些。

会写入什么

所有内容都位于批处理文件旁边，因此启动器文件夹是自包含的：

DSH-Web.bat            <- 你的启动器（未更改）
DSH-Web.exe            <- 编译后的外壳
.bat2exe/
DSH-Web.ico          <- 生成的（或你提供的）图标
DSH-Web.cs           <- 生成的 C# 源代码，保留以供检查

许可证

MIT