Release packaging: archives, workflow, download-first docs, Windows notes

- tools/build_release.sh: builds the Linux tar.gz and Windows zip from a
  git ref (default HEAD) using an explicit `git archive` pathspec
  allowlist: decoder (__init__.py, pd.py, gsmtap_stream.py), setup/start
  scripts, tools/vs_reader.py, READMEs, LICENSE and the README-referenced
  resources/ images.  v* tags must match pd.py VERSION.  Both archives
  are listed and extracted and checked for VERSION, py_compile, bash -n,
  .bat CRLF / .sh LF and tar exec bits; SHA256SUMS uses sha256sum or
  shasum.  Builds into a staging dir and only then replaces dist/.
- .github/workflows/release.yml: on a v* tag push run the unit tests,
  verify tag == pd.py VERSION, build, then upload into an existing
  release or create a draft and publish it; release-<tag> concurrency.
- README/RUS: Installation documents both ways (release download
  recommended; source checkout for development), SHA256SUMS verification,
  and the Windows prerequisites verified against sigrok.org (0.7.2
  release installer as the tested version, nightly caveat, VC++ 2010
  redist, bundled fx2lafw firmware and Zadig, per-port driver binding).
- start.bat: accept --opt=value alongside the original --opt value form
  (the usage text advertised the = form while the parser required a
  space); usage corrected and notes the core subset.
- .gitignore: dist/.
- AGENTS: release packaging, build verification and release process
  (commit docs/workflow first, then tag and push, auto-generated notes).

No decoder behavior change; VERSION stays 1.9.7.

start.bat

@@ -36,27 +36,43 @@ if /i "%~1"=="--no-rst"      ( set "RST="            & shift & goto :argloop )
 if /i "%~1"=="--no-vcc"      ( set "VCC="            & shift & goto :argloop )
 if /i "%~1"=="-h"            ( goto :usage )
 if /i "%~1"=="--help"        ( goto :usage )
+rem Value options also accept the --opt=value form (usage shows the space form).
+for /f "tokens=1,* delims==" %%A in ("%~1") do (
+    if /i "%%A"=="--clk"        ( set "CLK=%%B"        & shift & goto :argloop )
+    if /i "%%A"=="--data"       ( set "DATA=%%B"       & shift & goto :argloop )
+    if /i "%%A"=="--rst"        ( set "RST=%%B"        & shift & goto :argloop )
+    if /i "%%A"=="--vcc"        ( set "VCC=%%B"        & shift & goto :argloop )
+    if /i "%%A"=="--samplerate" ( set "SAMPLERATE=%%B" & shift & goto :argloop )
+    if /i "%%A"=="--clock"      ( set "CLOCK=%%B"      & shift & goto :argloop )
+    if /i "%%A"=="--host"       ( set "HOST=%%B"       & shift & goto :argloop )
+    if /i "%%A"=="--port"       ( set "PORT=%%B"       & shift & goto :argloop )
+    if /i "%%A"=="--pcap"       ( set "PCAP=%%B"       & shift & goto :argloop )
+    if /i "%%A"=="--protocol"   ( set "PROTOCOL=%%B"   & shift & goto :argloop )
+)
 echo Unknown option: %~1
 exit /b 1
 
 :usage
 echo Usage: %~n0 [OPTIONS]
-echo   --clk=CH          CLK channel        default: %CLK%
-echo   --data=CH         I/O channel        default: %DATA%
-echo   --rst=CH          RST channel        default: %RST%
-echo   --vcc=CH          VCC channel        default: %VCC%
-echo   --samplerate=SR   Sample rate        default: %SAMPLERATE%
-echo   --clock=MODE      native/detect/sample_as_clock
-echo   --host=IP         GSMTAP destination default: 127.0.0.1
-echo   --port=N          GSMTAP port        default: 4729
-echo   --pcap=FILE       Also write decoded events to FILE (no spaces in path)
+echo   --clk CH          CLK channel        default: %CLK%
+echo   --data CH         I/O channel        default: %DATA%
+echo   --rst CH          RST channel        default: %RST%
+echo   --vcc CH          VCC channel        default: %VCC%
+echo   --samplerate SR   Sample rate        default: %SAMPLERATE%
+echo   --clock MODE      native/detect/sample_as_clock
+echo   --host IP         GSMTAP destination default: 127.0.0.1
+echo   --port N          GSMTAP port        default: 4729
+echo   --pcap FILE       Also write decoded events to FILE (no spaces in path)
 echo   --debug           Full decoder + sigrok output (all annotation rows + -l 4).
 echo
 echo   By default only decoded APDUs and decoder warnings/errors are shown.
-echo   --protocol=MODE   T=0 (default), T=1, or auto (mid-session decode)
+echo   --protocol MODE   T=0 (default), T=1, or auto (mid-session decode)
 echo   --no-rst          Disable RST tracking
 echo   --no-vcc          Disable VCC tracking
 echo.
+echo   The --clk=CH form also works.  start.bat supports this core subset;
+echo   start.sh has the full option set.
+echo.
 echo To log output on Windows use redirection: %~n0 ... ^> capture.log 2^>^&1
 exit /b 0