Turn a Windows .bat / .cmd launcher into a real .exe — from inside DeepSeek Harness.
The EXE is a thin shell: it locates the batch file next to itself and hands the
whole job to cmd.exe. The launcher logic stays editable text, no tool path is baked
into the binary, and upgrading whatever the batch file calls needs no recompilation.
dsh plugin --profile web add dsh-bat2exeRestart DSH, then ask the agent to build a launcher — or call the tool directly.
| Parameter | Meaning |
|---|---|
bat |
required — path to the .bat/.cmd file (absolute, or relative to the working directory) |
name |
output executable name; defaults to the batch name with .exe |
iconText |
up to four characters drawn on a generated icon |
iconTextColour |
icon text colour as #rrggbb |
icon |
use an existing .ico instead of rendering one |
startMenuShortcut |
also write a Start Menu shortcut |
desktopShortcut |
also write a Desktop shortcut |
The build runs four steps, all local and offline:
- Icon — renders a rounded-square plate with a diagonal gradient and the given text, using a built-in 5×7 bitmap font, then packs it as a 256×256 ICO. No image library, no external tool.
- C# shell — emits a wrapper whose only job is to run the batch file from its own directory, forwarding all arguments and preserving the exit code.
- Compile —
csc.exefrom the .NET Framework (falling back todotnet buildwhen only the .NET SDK is present), with the icon embedded as a resource. - Shortcuts — optional
.lnkfiles, written throughWScript.Shell.
Reports the local toolchain — C# compiler path, .NET SDK presence, PowerShell, and the resolved defaults — so a failure can be diagnosed before a build is attempted.
bat2exe registers a settings namespace, so defaults are editable in
Settings → Plugins rather than by hand-editing a profile patch:
| Key | Default | Meaning |
|---|---|---|
iconText |
BAT |
text drawn on a generated icon |
iconFrom / iconTo |
#12204a / #4a6cf7 |
gradient start / end |
workDir |
.bat2exe |
where *.cs, *.ico and other by-products go |
startMenuShortcut |
false |
default for the Start Menu shortcut |
desktopShortcut |
false |
default for the Desktop shortcut |
Per-call tool arguments always win over these defaults.
- Windows. The pipeline compiles a Windows PE and writes
.lnkfiles. - A C# compiler: .NET Framework 4.x (
csc.exe, present on stock Windows) or the .NET SDK. - PowerShell for shortcut creation only (
pwshpreferred, Windows PowerShell accepted).
bat2exe_probe reports exactly which of these were found.
Everything lives next to the batch file, so a launcher folder is self-contained:
DSH-Web.bat <- your launcher (unchanged)
DSH-Web.exe <- the compiled shell
.bat2exe/
DSH-Web.ico <- generated (or your supplied) icon
DSH-Web.cs <- the emitted C# source, kept for inspection
MIT