Initial commit

STELLAR-GAUGE-20260807/PATH-MAP.hdlp

@@ -0,0 +1,65 @@
+{
+  "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=吞脚本）。