Skip to content

zcode-speed-panel 0.4.0

Choose a tag to compare

@github-actions github-actions released this 18 Sep 10:48

新增:网络流量与上传监控

监控 ZCode 的网络流量,重点回答"我的东西有没有在背后被上传、传了多少"。完整面板新增「网络流量与上传监控」卡(双栏布局,不遮挡底部速度曲线):

  • 整机上传/下载速度与当日总量(真实值):操作系统接口计数器实测,当日累计跨重启续算。口径注意:整机 = 本机全部应用的流量,非仅 ZCode——卡上有显式标注与悬停说明。
  • 会话 / 非会话上传拆分
    • 会话流量(≈ 估算):按当日 token 用量估算 API 对话的上传/下载量级(上传只计未缓存提示——实测缓存命中的上下文不重发);
    • 快照工件(真实值):ZCode 把整个工作区打包加密上传云端(checkpoint 快照,含 .git 历史)时,按接受事件如实累计工件大小,上传进行中卡片脉冲提示;
    • 快照上传记录列表:逐工作区列出已上传快照——时间 / 工作区 / 加密后大小 / 状态(上传中 ⬆、待传、已接受 ✓),最多 12 行滚动。
  • ZCode 连接归属(Windows):会话进程(CLI)与桌面端进程(快照上传等非会话流量)各持有几条外连,悬停可看远端地址。整机上传飙升 + 桌面端新连接 + "快照上传进行中"同时出现,就是一次快照上传的现场证据。
  • checkpoints 目录被 ACL 封锁时如实显示"不可读"(封锁本身即防护,此时监控不到新上传)。

为什么按进程的字节数有的是估算:Windows / macOS 非管理员下没有"按进程直测网络字节"的公开 API(本机实验定论详见项目文档 key-rules #14:socket 流量不进进程 IO 计数、唯一的每连接字节 API 已失效、ETW 需管理员)。面板对每层口径都做了明确标注,不把估算值当真实值展示。

其他

  • 调试日志(~/.zcode/speed-panel-debug.jsonl)新增 net 事件(快照接受/上传起止)与 tick 的网络字段(整机速率、两组连接数、上传中标志),网络问题可对账排查。
  • 新增持久化文件 ~/.zcode/speed-panel-net.json(网络当日累计)。
  • 网络监控仅完整面板显示;悬浮窗/桌宠形态不变。