// readme

香港身份证预约配额看板

监控香港入境处六大人事登记办事处的智能身份证预约配额,约 2 分钟检测一次, 放号时通过邮件 / 飞书群提醒订阅者。第三方公益工具,非入境处官方服务;只做监控提醒,不做任何代抢代约。

看板入口

它怎么工作

cron-job.org(每2分钟)──▶ GitHub Actions
                            │  python -m quota_monitor.run
                            │  ├─ 抓入境处公开配额接口(只读,一次一请求)
                            │  ├─ 与上一轮快照 diff → 放号事件
                            │  └─ commit data/ + 刷新 jsDelivr 缓存

        index.html 看板(手机优先,90 秒自动刷新)
        邮件 + 飞书通知(放号事件触发,带防抖冷却)

相比同类工具的改进

  • 手机优先:日期做行纵向滚动,6 办事处一屏放下,不用横向拖表格
  • 色盲友好:状态格颜色+文字双通道(有/少/满)
  • 防通知轰炸:官方接口存在负载均衡数据抖动(实测同一分钟内 304↔346 格波动),通知层带单格冷却期,不会每轮都轰炸一次
  • 内地直连:邮件订阅与飞书通知链路全程国内直达,无需科学上网
  • 深浅双主题、摘要卡直接回答「最早哪天能约」

个性化订阅…

The Undervalued Score +

How much a project earns versus how much attention it actually gets. Above 50 means the work is outrunning its audience. Recomputed nightly from commit velocity, contributor effort, issue resolution, fork utility, release cadence, and project maturity — divided by a logarithmic reach factor.

score  = signal / reach

signal = 0.25·commit_velocity   // commits in last 90 days (cap 30)
       + 0.20·contributor_work  // unique authors × velocity (cap 100)
       + 0.20·issue_resolution  // closed ÷ total issues
       + 0.20·fork_ratio        // forks ÷ stars (proxy for real usage)
       + 0.10·release_cadence   // releases in 90 days (cap 3)
       + age_bonus              // +0 to +0.30 after 6 months
       + homepage_bonus         // +0.05 if homepage is set

reach  = log₁₀(stars + watchers + 10)
The Health Score +

Is the project alive and maintained right now? A 0–100 pulse recomputed nightly from commit recency, rhythm, how fast issues close, and how quickly PRs get merged.

health = 0.35·recency       // days since last commit (90d decay)
       + 0.25·cadence       // commit rhythm consistency
       + 0.20·issue_health  // closed ÷ total issues
       + 0.20·pr_health     // merged ÷ total PRs
Health bands +

The colour and label on every card come straight from the health score.

Healthy   80 – 100   active, responsive, regular releases
Stable    60 – 79    maintained, steady, no alarms
Quiet     40 – 59    slowing down — watch this one
At Risk    0 – 39    going dark · candidate for rescue
// Tags — what each label means +

Tags are independent behavioral signals computed nightly. A project can hold multiple at once. They drive the home page sections.

solo_builder      one person holds > 80% of commits (last 180d)
needs_contributors has open "help wanted" or "good first issue" labels
hidden_gem        < 100 stars · active in last 3 months · documented
legacy_hero       repo > 5 years old · committed this year
fork_magnet       forks/stars > 0.5 · used as template or dependency
release_machine   5+ releases in the last 90 days
under_pressure    > 10 open issues · ≤ 2 contributors · health ≥ 60
community_watch   watchers > stars · devs tracking before the public
community_hub     GitHub Discussions enabled · > 20 discussions
funded            maintainer has active funding channel
Why rank against stars at all? +

Stars are an outcome, not effort. A project with 8 stars and daily commits is doing more interesting work than one coasting on 8k. We measure the building, then divide by the attention already received — so the genuinely undervalued rise to the top.

// stars   = lagging indicator
// commits = leading indicator
// we rank by the leading one