chore: initial sanitized public snapshot

2026-07-18 16:01:12 +08:00
commit 7c6b6a3746
321 changed files with 76896 additions and 0 deletions
@@ -0,0 +1,77 @@
+# aria2-rust-pro 1.0.0
+
+`aria2-rust-pro 1.0.0` is the first public release of this independently
+maintained Rust implementation.
+
+This release establishes a versioned baseline for the project:
+
+- a public Git tag for the Rust 2024 workspace
+- Cargo-native local packaging and Docker export workflows
+- repository-local migration, deployment, and compatibility documentation
+
+## Project Sources
+
+- [Aria2-Pro-Core](https://github.com/P3TERX/Aria2-Pro-Core) is the direct
+  compatibility and migration reference for the enhanced deployment profile.
+- [aria2](https://github.com/aria2/aria2) is the upstream project whose public
+  CLI, configuration, and RPC contracts guide this implementation.
+
+## Highlights
+
+- independently maintained Rust 2024 implementation informed by those sources
+- Cargo-native release packaging and Docker export automation
+- compatibility-led CLI, configuration, JSON-RPC, and XML-RPC development
+
+## Compatibility Notes
+
+- version smoke preserves the upstream-compatible first line
+  `aria2 version 1.37.0`
+- Docker images keep the `aria2c` entrypoint shape by symlinking
+  `aria2c -> aria2-rust-pro`
+- migration and deployment guides remain in-repo under `docs/migration/` and
+  `docs/deployment/`
+
+## Artifacts
+
+The release includes these built artifacts:
+
+- `aria2-rust-pro-v1.0.0-x86_64-pc-windows-msvc.zip`: Windows x86_64 archive
+  with the executable, debug symbols, release documentation, a manifest, and
+  an individual SHA-256 checksum.
+- `aria2-rust-pro-v1.0.0-x86_64-unknown-linux-gnu.tar.gz`: Linux x86_64
+  archive with the executable, release documentation, a manifest, and an
+  individual SHA-256 checksum.
+- `aria2-rust-pro-v1.0.0-aarch64-unknown-linux-gnu.tar.gz`: Linux arm64
+  archive with the executable, release documentation, a manifest, and an
+  individual SHA-256 checksum.
+- `aria2-rust-pro-docker-v1.0.0.tar`: Linux amd64 Docker image archive tagged
+  `aria2-rust-pro:v1.0.0`, with a manifest and individual SHA-256 checksum.
+- `RELEASE-SHA256SUMS.txt`: aggregate SHA-256 checksums for the four primary
+  archives.
+
+Load the Docker archive with:
+
+```sh
+docker load -i aria2-rust-pro-docker-v1.0.0.tar
+```
+
+Verify an archive before use with its adjacent `.sha256` file or the aggregate
+checksum list.
+
+## Verification
+
+The repository release workflow is intended to perform:
+
+- workspace fast gates
+- nightly `cargo udeps`
+- `cargo deny`
+- release version smoke
+- daemon-free Docker smoke
+- daemon-backed Docker smoke
+- local release packaging
+- Docker image export
+
+## Known Limits
+
+- macOS and Windows arm64 archives are not included in this release
+- broader multi-platform release archives remain future work