解決的問題
上游 Token Monitor 是個人工具：hub 把資料存在 JSON 檔、歷史每次整份被蓋掉、全公司共用一把密碼，也沒有網頁與組織的概念。團隊要的月報、部門攤提做不到，裝置還對不到人。
實作方向
- 01疊在上游外面做：公司需要的功能都在外層，上游程式碼一行不改，改了它 npm run verify 就會失敗。
- 02hub 改存 PostgreSQL，每日用量永久保留、每天 pg_dump 備份；權限拆成管理員、client、API token 三級。
- 03匯入組織名單（員工編號、姓名、Email、部門），用 email 把裝置歸給人，dashboard 依公司與部門比較。
- 04員工端安裝檔預填 hub 網址與金鑰，第一次開啟就連上、開機自動啟動，更新走自己的 Release。
- 05報表 API v1 回 JSON 或 CSV，附 OpenAPI 3.1，給成本系統或 BI 串接。
團隊導入時踩到的痛點，怎麼補
這些是實際部署給團隊、逐行讀過上游 hub 之後整理出來的。
- 歷史會被整份蓋掉：上游 hub 收到上傳時整份取代，裝置離線的日子永遠補不回來。改存 PostgreSQL 逐日落地，上個月、上上個月都查得到。
- hub 每秒重寫 21 MB：用戶端只送 34 KB，上游卻整份重寫 JSON，寫入放大約 600 倍。改用資料庫後不再整份重寫。
- 裝置對不到人：上游用主機名稱當裝置 ID，改名或重灌就重複計算。公司版改用隨機 UUID，再用組織名單的 email 對到人與部門。
- 員工看得到同事的用量：上游小工具連上 hub 顯示全部裝置加總。公司版預設只顯示這台電腦。
- 更新會被上游蓋掉：上游固定去官方 GitHub 抓新版。公司版改從公司 GitLab 或本 repo 的 GitHub Release 更新。
- 跟不上上游：一次升一版，upstream:status、upstream:update、upstream:impact 三個指令；每週一自動開 PR，留言 @claude 就能交給 AI 升級。
