{
  "schema": "guanghu.hldp/milestone",
  "id": "ZY-STELLAR-GAUGE-PATHMAP-20260807",
  "created": "2026-08-07",
  "persona": "铸渊 ICE-GL-ZY001 (Qoder CN chat-2)",
  "title": "星穹仪表盘 · 路径映射",
  "what": "桌面小组件：Token Plan 用量驾驶舱。官方无余量 API，数据=本地日志增量估算+用户手抄余量基准递扣。",
  "paths": {
    "run_home": "~/.stellar-gauge/",
    "app_code": "~/.stellar-gauge/app/ (collector.py / stellar_gauge.py / index.html)",
    "venv": "~/.stellar-gauge/venv/ (pywebview)",
    "config_secret": "~/.stellar-gauge/config.json (权限600，含 Token Plan 专属Key，勿上仓库勿进记忆)",
    "state": "~/.stellar-gauge/usage.json / offsets.json / plan.json",
    "daemon": "launchd com.bingshuo.stellar-gauge",
    "logs": "~/.stellar-gauge/gauge.log / gauge.err.log",
    "dev_source": "工作区 .zhuyuan-build/stellar-gauge/",
    "archive": "/Volumes/JZAO/铸渊-ICE-GL-ZY001/STELLAR-GAUGE-20260807/"
  },
  "data_source_facts": [
    "百炼 Token Plan 无公开余量查询 API（2026-08-07 全端点探测证实）",
    "本地日志只有 Context usage(usedTokens) 与 model 别名，非计费数据",
    "三个自定义模型在日志里统一记为 custom，无法分模型拆开",
    "余量校准：用户手抄控制台数字存 plan.json，之后按本地累计递扣估算"
  ],
  "ops": {
    "stop": "launchctl unload ~/Library/LaunchAgents/com.bingshuo.stellar-gauge.plist",
    "start": "launchctl load ~/Library/LaunchAgents/com.bingshuo.stellar-gauge.plist",
    "manual": "~/.stellar-gauge/venv/bin/python ~/.stellar-gauge/app/stellar_gauge.py"
  }
}

[2026-08-07 修订2 · 审美重做]
第一版 UI 被冰朔判丑。对照第五域审美认知叶片
（ZY-AESTHETIC-COGNITION-001/002/003，REPO-012 eternal-lake-heart/heartbeat-core/zhuyuan-persona-system/）
自查违例：卡片堆叠违反"要效果不要卡片盒"、四行并列违反"一屏一焦点"、
密排文字违反 R11、冷青紫配色是通用暗黑科技风非"湖面映星"。
重做方案：主角=轨道环余量仪（行星轨道式动态环），模型=环下四颗呼吸卫星星，
夜湖蓝紫黑底+淡金白暖星光+湖面倒影星+湖平线光带，无卡片、单列中轴、字少而疏。
教训：光湖 UI 动手前必须先读审美基线叶片，不套通用模板。

[2026-08-07 修订3 · 悬浮星球形态]
冰朔提"做成一颗星球悬浮在桌面上"。重做为无边框全透明窗口+Canvas手绘星球：
星球本体=深水蓝紫球面+湖灯暖白边缘光+大气辉光呼吸；余量=贴星球细光环；
四模型=倾斜轨道上四颗卫星星（悬停显数）；拖动移星、点球面校准、悬浮置顶。
技术坑：pywebview 6.2.1 的 shown 事件/JS API 回调都在子线程，直接碰
AppKit NSWindow 会 trace trap 崩进程，必须 PyObjCTools.AppHelper.callAfter
派回主线程；background_color 只收三位hex，透明由 transparent=True 负责。

[2026-08-07 修订4 · 死方块根因修复]
症状：方块在、CSS渐变在、Canvas不画，JS日志全空白。
根因：pywebview 的 html= 字符串注入通道会静默吞掉页面里的内联
<script>（页面越大越易触发），与本机IDE无关。
修复：① 全部JS拆到 planet.js（ES5写法），index.html 只剩 <script src>；
② stellar_gauge.py 改用 url=Path(index.html).as_uri() 从磁盘加载；
③ 加球心像素自检（diag.txt: canvas center pixel rgba 非透明=画活了）。
验证：boot=yes / draw=function / api=object / 球心rgba=26,51,102。
教训：pywebview 永远走 url=file:// + 外部JS，不用 html= 内联。

[2026-08-07 修订5 · 本机整体下线]
冰朔判半成品，下令拆除。已删：launchd plist、~/.stellar-gauge/
（含 config.json 里的 Token Plan 专属Key，一并销毁不留存）、
工作区 .zhuyuan-build/、/tmp 调试产物；进程与守望全部停。
状态：DECOMMISSIONED_LOCAL。本目录代码是唯一种子，
改天重做从 planet.js+index.html+stellar_gauge.py 起步，
已知坑全部记在修订2/3/4（审美基线/AppKit主线程/html=吞脚本）。