docs: count desktop .dmg and .exe downloads per platform

shields.io cannot split downloads by asset: its wildcards silently report 0 (a
tag whose .dmg had 39,877 downloads returns 0 for *.dmg), exact asset names
embed the version so they break every release, and dynamic/json rejects every
filter expression. A daily workflow sums the counts from the desktop releases
repo and publishes them as shields endpoint documents on the orphan badges
branch, which main's protection rules do not block.

The badges move into the hero row in for-the-badge style, matching the rest of
that row rather than adding a fourth style to the README.

Author: elkaix

.github/workflows/desktop-download-badges.yml

@@ -0,0 +1,81 @@
+# Refreshes the per-platform desktop download counters behind the README badges.
+#
+# shields.io cannot do this on its own: its asset wildcards silently report 0
+# (a tag whose .dmg had 39,877 downloads returns 0 for `*.dmg`), exact asset
+# names embed the version so they break on every release, and `dynamic/json`
+# rejects every filter expression. So we sum the counts here and publish them
+# as shields `endpoint` documents.
+#
+# The documents land on the orphan `badges` branch, never on `main` — `main` is
+# protected and rejects pushes from everyone, CI included.
+name: Desktop Download Badges
+
+on:
+  schedule:
+    # Once a day is plenty; the counters move slowly and the API is rate-limited.
+    - cron: '17 4 * * *'
+  workflow_dispatch: {}
+
+permissions:
+  contents: write
+
+concurrency:
+  group: desktop-download-badges
+  cancel-in-progress: true
+
+jobs:
+  refresh:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout the badges branch
+        uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # pinned from v4
+        with:
+          ref: badges
+          persist-credentials: true
+
+      - name: Sum the .dmg and .exe download counts
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          RELEASES_REPO: PyModel/pythinker-desktop-releases
+        run: |
+          set -euo pipefail
+
+          # --paginate walks every release, so the totals cover the whole
+          # history rather than just the latest tag.
+          gh api --paginate "repos/${RELEASES_REPO}/releases" > releases.json
+
+          write_badge() {
+            local suffix="$1" label="$2" out="$3"
+            local total
+            total="$(jq --arg s "$suffix" '
+              [ .[].assets[]
+                | select(.name | ascii_downcase | endswith($s))
+                | .download_count
+              ] | add // 0
+            ' releases.json)"
+            jq -n --arg label "$label" --arg message "$total" '{
+              schemaVersion: 1,
+              label: $label,
+              message: $message,
+              color: "4D6BFE"
+            }' > "$out"
+            echo "${label}: ${total}"
+          }
+
+          write_badge '.dmg' 'macOS .dmg' desktop-dmg.json
+          write_badge '.exe' 'Windows .exe' desktop-exe.json
+
+          rm -f releases.json
+
+      - name: Publish if the counts moved
+        run: |
+          set -euo pipefail
+          if git diff --quiet -- desktop-dmg.json desktop-exe.json; then
+            echo 'Counts unchanged; nothing to publish.'
+            exit 0
+          fi
+          git config user.name 'github-actions[bot]'
+          git config user.email 'github-actions[bot]@users.noreply.github.com'
+          git add desktop-dmg.json desktop-exe.json
+          git commit -m 'chore: refresh desktop download counts'
+          git push origin badges

README.md

@@ -11,6 +11,9 @@
 
 [![npm version](https://img.shields.io/npm/v/@pymodel/pythinker-code?style=for-the-badge&logo=npm&logoColor=white&color=CB3837&label=pythinker-code)](https://www.npmjs.com/package/@pymodel/pythinker-code)
 [![Downloads](https://img.shields.io/npm/dm/@pymodel/pythinker-code?style=for-the-badge&logo=npm&logoColor=white&color=2b89ff&label=downloads)](https://www.npmjs.com/package/@pymodel/pythinker-code)
+[![Desktop downloads](https://img.shields.io/github/downloads/PyModel/pythinker-desktop-releases/total?style=for-the-badge&logo=github&logoColor=white&label=desktop&color=4D6BFE)](https://github.com/PyModel/pythinker-desktop-releases/releases)
+[![macOS .dmg](https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2FPyModel%2Fpythinker-code%2Fbadges%2Fdesktop-dmg.json&style=for-the-badge&logo=apple&logoColor=white)](https://github.com/PyModel/pythinker-desktop-releases/releases/latest)
+[![Windows .exe](https://img.shields.io/endpoint?url=https%3A%2F%2Fraw.githubusercontent.com%2FPyModel%2Fpythinker-code%2Fbadges%2Fdesktop-exe.json&style=for-the-badge&logo=windows&logoColor=white)](https://github.com/PyModel/pythinker-desktop-releases/releases/latest)
 [![Node.js](https://img.shields.io/badge/Node.js-26%2B-339933?style=for-the-badge&logo=nodedotjs&logoColor=white)](https://github.com/PyModel/pythinker-code/blob/main/package.json)
 [![License: MIT](https://img.shields.io/badge/License-MIT-16a34a.svg?style=for-the-badge)](https://github.com/PyModel/pythinker-code/blob/main/LICENSE)
 [![CI](https://img.shields.io/github/actions/workflow/status/PyModel/pythinker-code/ci.yml?branch=main&label=CI&style=for-the-badge&logo=githubactions&logoColor=white)](https://github.com/PyModel/pythinker-code/actions/workflows/ci.yml?query=branch%3Amain)
@@ -21,10 +24,6 @@
 [![Docs](https://img.shields.io/badge/docs-online-0284c7.svg?style=flat-square)](https://pymodel.github.io/pythinker-code/)
 [![Homepage](https://img.shields.io/badge/home-code.pythinker.com-ec4899.svg?style=flat-square)](https://code.pythinker.com)
 
-<a href="https://github.com/PyModel/pythinker-desktop-releases/releases"><img src="https://img.shields.io/github/downloads/PyModel/pythinker-desktop-releases/total?style=flat&label=desktop%20downloads&color=4D6BFE" alt="Total desktop downloads"></a>
-<a href="https://github.com/PyModel/pythinker-desktop-releases/releases/latest"><img src="https://img.shields.io/badge/macOS-.dmg-4D6BFE?style=flat&logo=apple&logoColor=white" alt="Download the macOS .dmg"></a>
-<a href="https://github.com/PyModel/pythinker-desktop-releases/releases/latest"><img src="https://img.shields.io/badge/Windows-.exe-4D6BFE?style=flat&logo=windows&logoColor=white" alt="Download the Windows .exe"></a>
-
 <br />
 
 <a href="https://code.pythinker.com">Website</a> &nbsp;·&nbsp;