zhuyuan-ice-gl-zy001/STELLAR-GAUGE-20260807/PATH-MAP.hdlp
2026-08-20 00:01:53 +08:00

65 lines
4.1 KiB
Text
Executable file
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

{
"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=吞脚本)。