Repository navigation
v5.2.0 — 托盘状态灯
本页会随勘误就地更新。规范全文以
main为准。
范围
新增 tools/tray/persona_tray.py:Windows 系统托盘,只读守护进程写出的 ops/persona-status.json。
绿=正常、黄=有任务在忙、红=有任务失败或状态超过 3 分钟没更新;双击看各任务最近一次结果;
菜单可打开日志、打开记忆库、退出。只显示,不代办任何任务。
依赖:pystray + Pillow(python -m pip install pystray Pillow)。
证据
- 实机启动 6 秒无异常退出;
- 状态解析覆盖四态:正常 / 忙碌 / 失败 / 状态文件缺失(灰色「读取中」);
- 字段与
persona_daemon写出的persona-status.json(at/tasks.*.ok/busy/msg)逐项对应。
边界
- 不含界面注入,不含记忆写回,不替代守护进程;托盘本身不产生任何数据;
- 仅 Windows;状态文件缺失时只显示灰色,不做重试;
- 同时含一处抓取器修复:无虚拟列表时回退到
document.body,避免整次抓取直接报错(单独提交1efb7ae)。
修订记录
2026-11-09 首版。托盘是「常驻程序看得见」的第一步;后续每个小功能单独切版本。