- ci/windows-ci.sh is the one definition of every Windows step (toolchain, clippy, build, tests and UI self-test under Wine, packaging, test bundle); verify, release and next only call it. - release.yml: a windows job builds, tests and packages alkane-toolkit-vX.Y.Z-windows-x86_64.zip; the release job waits for it and attaches the zip next to the Linux tarball. next.yml does the same for -rc candidates, verify.yml runs the Windows gates on PRs. - windows-native.yml (advisory, never gates a release) runs main's cross-built unit tests and UI self-test on real Windows 11 through the self-hosted VM runner (label alkane-windows). - CI image: ci/images/alkane-ci.Dockerfile layers mingw-w64, Wine with a ready prefix, the rustup target and a prebuilt wxMSW prefix on the previously verified image; ci/images/build-image.sh pushes it and pins the digest. wx prefix/cache scripts take a linux|windows argument. - CI checks the wx-rs patch queue; versioning treats the GUI build script, Windows resources and assets as release-relevant; the workflow contract test covers the Windows gates. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Alkane Toolkit
The code quality grade reports GUI Clippy and first-party Rust formatting checks from the last successful main build. Test coverage has a separate badge.
Desktop miner discovery and monitoring. The Rust GUI uses wxWidgets through a patched wx-rs bridge. In-app image flashing is disabled while that path is reworked.
Run locally
scripts/build-wx-linux.sh
scripts/build-gui-linux.sh
ALKANE_FAKE_SCAN=1 ~/.cache/alkane-tk-target/release/alkane-toolkit
The first command builds wxWidgets 3.3.3 once. Linux needs GTK 3. Fake scan
uses offline fixtures and does not contact hardware. For Windows and macOS,
use the matching scripts/build-gui-*.sh script.
Current scope
- Discover miners by CIDR or IP range with vendored asic-rs.
- Show model, firmware, health, hashrate, temperatures, fans, PSU, and workers.
- Filter and sort the desktop table; inspect probes with
miner_probe. - Use controls supported by the selected firmware and restore supported aftermarket firmware to stock.
Discovery is read-only. Control and restore actions change miners. Check the selected devices before applying them. See the implementation plan and firmware matrix for planned coverage.
Development
WX_RS_WXCONFIG="$HOME/.cache/wx-3.3.3-linux/bin/wx-config" \
CARGO_TARGET_DIR="$HOME/.cache/alkane-tk-target" \
cargo test -p alkane-gui --offline
Keep build output off the source share. main runs full CI and publishes
qualifying releases; next builds -rc candidates. Badges measure host
code, not installation support. See the public
benchmark history.
Firmware safety
Installation must follow the SDK install rules: use the exact board's packer and boot-switch procedure, verify through an independent channel, and never write bootloader or secure regions.
License
MIT. Vendored dependencies keep their own terms.