Repository navigation
NetStats v2.00
GitHub tag v2.00 · App version 2.0.0 (build 27) · macOS 14 or later
通用安装包 / Universal binary: Apple Silicon (arm64) + Intel (x86_64). Both slices target macOS14 or later. Installation-copy launch was verified on Apple Silicon; Intel execution was not tested on physical hardware.
签名说明 / Signing: 本次应用采用临时签名（ad-hoc），没有 Developer ID 签名或 Apple 公证。若首次打开被系统拦截，请在确认下载来源后，按 Apple 官方说明到“系统设置 → 隐私与安全性”允许打开此应用。此安装包不代表 Gatekeeper 公证通过。
The app is ad-hoc signed and is not Developer ID signed or notarized. macOS may require an explicit user approval on first launch; see Apple’s instructions above.
安装 / Install
- 下载本页 Assets 中的 NetStats-2.0.0.dmg。
- 打开 DMG，将 NetStats.app 拖到 Applications（应用程序）。
- 从应用程序打开 NetStats，点击菜单栏图标使用卡片与设置。升级前请先退出旧版。
Download the DMG from Assets, open it, drag NetStats.app to Applications, then launch it from Applications. Quit an older running copy before upgrading.
更新 / What's new
- 共享玻璃卡片：菜单栏和实体刘海入口共用 360 pt 自适应卡片；底部 Dock 点击切换网络、设备、日历、天气、剪切板、暂存架，每项都有独立开关。保留原 Native / Terminal 详细监控和 Clash 信息。
- 网络与设备：上下行速度、短历史趋势和会话流量；CPU、GPU 型号及可用负载、内存、启动盘容量。磁盘读写明确标为全部设备合计；无法读取的 GPU 负载显示不可用。
- 日历与天气：授权后浏览日程；通过用户配置并测试成功的 Apple 天气快捷指令获取当前天气，提供缓存、手动刷新和超时处理。
- 剪切板历史：文字与图片在本机持久保存，支持搜索、分页、预览、复制、暂停、排除应用及清空。默认保留 30 天，文字和图片数量分别可设上限，默认不限量。
- 文件暂存架：拖入、拖出、打开、移除、重新关联文件引用。仅保存引用，移除条目不会删除原文件；拖出采用复制语义。
- 刘海交互：连续悬停 1 秒展开，移出 300 毫秒收起；有效文件拖到刘海 500 毫秒展开暂存架。编辑、子弹窗和拖放期间保持卡片展开。
The menu bar and optional physical-notch entrance now share a compact adaptive glass card and a click-to-switch six-feature Dock. The release adds network trends, device information, calendar browsing, a configurable Apple Weather Shortcuts bridge, local text/image clipboard history, and a persistent file-reference shelf. Existing Native / Terminal monitoring and Clash information remain available through Details.
首次配置与隐私 / Setup and privacy
- 初始启用网络、设备与暂存架。刘海入口默认关闭，仅在具有实体刘海的内置屏幕上可用；在设置中开启。
- 日历、天气和剪切板默认关闭，在设置中主动启用和配置。日历请求系统“完整访问”权限，但 NetStats 只查询日程；创建和编辑交给系统 Calendar。
- 新版 macOS 需允许后台剪切板读取后才自动记录；可随时暂停、清空、调整 1–30 天保留期限及文字/图片数量限制。历史保存在本机，没有额外的应用层加密。
- 天气需先建立独立系统快捷指令，并在 NetStats 中测试连接成功，随后按 15 分钟缓存刷新；无需 NetStats 的 WeatherKit 密钥。见 天气快捷指令配置说明。
- 系统指标、剪切板历史和文件引用在本机处理。公网 IP/位置查询会请求
ipinfo.io，可在设置中关闭；天气快捷指令可能使用 Apple 网络或定位服务。 - 卡片无需新增辅助功能、输入监控或录屏授权。
Network, Device and Shelf start enabled. The notch entrance, Calendar, Weather and Clipboard start disabled. Calendar requires an explicit Full Access grant; the product only reads events. Clipboard collection requires the applicable system permission and offers pause, clear, retention and count controls. Weather runs only the configured shortcut after a successful connection test. Optional public-IP lookup can be disabled.
Read the privacy details and permission model.
验证范围 / Validation scope
发布前已通过 PR CI 的 Debug/Release 构建、67项自动测试和原有逻辑检查；通用DMG通过镜像校验、只读挂载、应用签名与安装复制检查，并在Apple Silicon上完成启动验证。开发测试覆盖存储、隐私控制、保留策略、悬停计时与屏幕几何，以及测试子进程的超时/取消。离屏渲染不代表真实桌面的玻璃或硬件表现。
日历/剪切板首次授权、真实天气快捷指令、实体刘海拖放、前台输入、全屏/外接屏变化以及睡眠唤醒仍需在目标 Mac 上验收。
PR CI passed Debug/Release builds, 67 automated tests and existing logic checks. The universal DMG passed image checksum, read-only mount, strict app-signature and install-copy checks; the installed copy launched on Apple Silicon. Real permission grants, the actual weather shortcut, physical-notch dragging, foreground input, full-screen/external-display changes and sleep/wake remain hands-on acceptance items.
This release does not publish the npm package or automatically update the separate Homebrew tap. Use the attached DMG for this version.