feat: add anonymous launch counting

Author: WeikangLin93

CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.2.4
+
+- Add privacy-friendly anonymous launch counting via Hits.
+- Document the opt-out environment variable for launch counting.
+
 ## 0.2.3
 
 - Clarify that browser-only ChatGPT login is not enough; the widget needs local Codex auth files.

README.md

@@ -5,6 +5,8 @@ A lightweight **Windows desktop floating widget** for monitoring Codex usage.
 
 ## 本次更新 / What's New
 
+- **匿名启动统计**：启动时后台请求一次公开 Hits 计数端点，帮助估算实际使用量；不发送 token、账号或用量数据，可用环境变量关闭。  
+  Anonymous launch counting pings a public Hits counter once on startup to estimate real usage; it sends no tokens, account data, or usage data and can be disabled by environment variable.
 - **更清晰的日间/夜间界面**：根据背景亮度自动切换文字、状态和圆环底轨颜色，浅色背景也能读清楚。  
   Better day/night readability with adaptive text and ring colors.
 - **后台刷新**：网络请求放到后台 Job，不会因为接口慢或网络波动卡住悬浮窗。  
@@ -53,6 +55,8 @@ The previews use sample data and are for UI demonstration only.
   Stores generated config/cache under the user's AppData folder.
 - token 刷新写回前会备份并原子写入认证文件  
   Backs up and atomically writes auth files when refreshing tokens.
+- 启动时会后台请求一次 `https://hits.sh/github.com/WeikangLin93/codex-usage-widget/app-launch.svg` 做匿名启动计数；不会发送 token、账号、用量百分比或本机路径。若要关闭，启动前设置环境变量 `CODEX_USAGE_WIDGET_DISABLE_TELEMETRY=1`。  
+  On startup, the widget requests `https://hits.sh/github.com/WeikangLin93/codex-usage-widget/app-launch.svg` once for anonymous launch counting; it does not send tokens, account data, usage percentages, or local paths. To opt out, set `CODEX_USAGE_WIDGET_DISABLE_TELEMETRY=1` before launching.
 
 ---
 

VERSION

@@ -1 +1 @@
-0.2.3
+0.2.4

codex_usage_widget.ps1

@@ -1,4 +1,4 @@
-Add-Type -AssemblyName System.Windows.Forms
+Add-Type -AssemblyName System.Windows.Forms
 Add-Type -AssemblyName System.Drawing
 
 # 修复 WinForms 事件线程偶发“无可用 Runspace”异常
@@ -111,6 +111,20 @@ $script:pendingRestoreAt = $null
 $script:refreshJob = $null
 $script:nextRefreshAt = Get-Date
 $script:isRefreshing = $false
+$script:telemetryJob = $null
+
+function Start-LaunchTelemetry {
+  if ($env:CODEX_USAGE_WIDGET_DISABLE_TELEMETRY -eq "1") { return }
+  if ($script:telemetryJob -and $script:telemetryJob.State -eq "Running") { return }
+
+  $telemetryUrl = "https://hits.sh/github.com/WeikangLin93/codex-usage-widget/app-launch.svg?label=launches"
+  $script:telemetryJob = Start-Job -ArgumentList $telemetryUrl -ScriptBlock {
+    param($url)
+    try {
+      Invoke-WebRequest -Uri $url -UseBasicParsing -TimeoutSec 5 | Out-Null
+    } catch {}
+  }
+}
 
 function Format-Remaining([int]$seconds) {
   if ($seconds -lt 0) { $seconds = 0 }
@@ -487,10 +501,16 @@ $form.Add_FormClosing({
     try { Remove-Job -Job $script:refreshJob -Force -ErrorAction SilentlyContinue } catch {}
     $script:refreshJob = $null
   }
+  if ($script:telemetryJob) {
+    try { Remove-Job -Job $script:telemetryJob -Force -ErrorAction SilentlyContinue } catch {}
+    $script:telemetryJob = $null
+  }
   $notify.Visible = $false
   $notify.Dispose()
 })
 
+Start-LaunchTelemetry
 Start-UsageRefresh
 Apply-VisibilityPolicy
 [System.Windows.Forms.Application]::Run($form)
+