card: versioned filenames + models.json

README.md

@@ -79,9 +79,9 @@ only on a GPU (~1.5x at batch 8, FP16); on CPU use batch 1.
 
 | file | classes | MB |
 |---|---:|---:|
-| `full/birdnet_v3.0_fp32.onnx` | 11,560 | 557 |
-| `full/birdnet_v3.0_fp16.onnx` | 11,560 | 279 |
-| `full/birdnet_v3.0_labels.txt` | 11,560 | - |
+| `full/birdnet-v3.0-preview3.1-fp32-b1.onnx` | 11,560 | 557 |
+| `full/birdnet-v3.0-preview3.1-fp16-b1.onnx` | 11,560 | 279 |
+| `full/birdnet-v3.0-preview3.1-labels-b1.txt` | 11,560 | - |
 
 ## Why regional models
 
@@ -173,6 +173,17 @@ grouping.
 | `new-caledonia` | <img src="regional/new-caledonia/coverage.png" width="210"> | 168 | 125.4 | 62.9 |
 | `new-zealand` | <img src="regional/new-zealand/coverage.png" width="210"> | 266 | 129.1 | 64.7 |
 
+## File naming and versioning
+
+Files are named `birdnet-<upstream>-[<region>-]<variant>-b<build>.onnx`, where
+`upstream` is the BirdNET release these weights come from (`v3.0-preview3.1`) and
+`build` is this repo's build revision of that conversion. A new upstream release
+or a new conversion always gets a new filename; a published file's bytes never
+change. `models.json` is the machine-readable index: it lists every file with its
+variant, checksum, input contract, and which backends it actually runs on
+(including where a backend is *not* supported), plus a `selection` map from
+hardware/backend to the file to download.
+
 ## Deployment
 
 - Point your host at a tile's model + its `_labels.txt` (matching counts) and