Releases: GlacierGlimmer/zmd-charge-plus
Release list
ECP v0.1.0
Endfield Charge Plus v0.1.0
Endfield Charge Plus（ECP）是一款终末地风格的桌面状态栏 HUD，基于 zmd-charge 二次开发，将系统状态、硬件监控与自定义信息整合为简洁的悬浮显示界面。
目前 ECP 已提供 Windows、Linux 与 macOS 版本：
- Windows：本仓库维护，提供 Microsoft Store、winget 与 GitHub 便携版。
- Linux：由 Endfield Charge Plus For Linux 独立仓库维护，同时在本 Release 提供 Linux x64 安装包。
- macOS：由 Endfield Charge Plus For MacOS 独立仓库维护，目前提供 Apple Silicon 与 Intel Mac 版本。
本仓库标签对应 Windows 源码。
⚠️ macOS 版本目前尚未进行真实 Mac 实机测试。当前已经在 CI 的 Apple Silicon 与 Intel macOS 环境中完成构建、原生数据采集、逐变量读取、方案渲染、界面、DMG 挂载、启动及单实例等自动化验证，但 CI 测试不能替代真实硬件测试，仍可能存在特定 Mac 机型、macOS 版本、刘海屏、多显示器、缩放、电池及系统权限相关的兼容性问题。
✨ 主要功能（Windows）
- 灵活的 HUD 显示：支持持续显示、置顶或不置顶；电源插拔时显示电池状态，也可以将鼠标移动至目标屏幕顶部中央唤出当前方案。
- 点击穿透：HUD 显示时不阻挡下方窗口的鼠标交互。
- 自定义方案：支持内置方案、自定义方案、位置及透明度设置，并提供完整与简洁动画。
- 自动轮播：按自定义顺序循环展示多个 HUD 方案。
- 丰富的数据变量：涵盖 CPU、内存、GPU、电池、磁盘、网络及时间等信息，支持自定义表达式与格式化显示。
- 扩展数据源：支持 DeepSeek API、HTTP/JSON 数据、网络包探测及自定义数据展示。
- 中英文界面：支持简体中文与 English，可根据系统语言自动选择，也可以手动切换。
📦 下载与使用
Windows：Microsoft Store（推荐 / Recommended）
ECP 已上架微软商店，推荐通过 Microsoft Store 获取 Endfield Charge Plus。安装完成后启动应用即可。
ECP is now available on Microsoft Store, the recommended installation channel. Install it from the Store page, then launch the app.
winget 安装 / Install with winget
在 PowerShell 或 Windows 终端中复制并运行以下命令：
Copy and run this command in PowerShell or Windows Terminal:
winget install --id 9P3PLD3LX7W6 --source msstore --exact该命令通过 Microsoft Store 源安装同一个应用。首次使用时按提示确认；如果找不到 winget，可直接使用上方商店链接。
This installs the same app from the Microsoft Store source. Review any prompts on first use. If winget is unavailable, use the Store link above.
Windows：GitHub 便携版 / Portable downloads
需要免安装版本时，可下载本页 Assets 中对应架构的 ZIP：
For a portable version, download the ZIP for your architecture from Assets below:
| 下载文件 / Download | 适用设备 / Device |
|---|---|
| EndfieldChargePlus-v0.1.0-win-x64-portable.zip | 常见 Intel / AMD 64 位 Windows 电脑 / Most 64-bit Intel / AMD Windows PCs |
| EndfieldChargePlus-v0.1.0-win-x86-portable.zip | 32 位 Windows 设备 / 32-bit Windows devices |
下载对应压缩包，解压后运行 EndfieldChargePlus.exe 即可。程序采用自包含发布，无需额外安装 .NET 运行时。
Extract the ZIP and run EndfieldChargePlus.exe. The portable packages are self-contained; no separate .NET runtime is required.
首次启动后可通过系统托盘打开设置、预览 HUD、调整显示方式及管理方案。
After launching, open Settings from the system tray to preview the HUD, adjust its display behavior and manage profiles.
SHA256SUMS.txt 提供 Windows 发行文件的 SHA-256 完整性校验值。
SHA-256 checksums for the Windows release files are available in SHA256SUMS.txt.
Linux：APT 命令安装（推荐 Debian / Ubuntu / Kali 等）
Linux 版名称为 Endfield Charge Plus For Linux，源码与详细文档位于 Linux 独立仓库。本仓库的 v0.1.0 Release 同时提供 Linux 安装包。
在 Linux 终端中依次执行以下两条命令。第一条配置 APT 软件源 的签名密钥和源地址并刷新索引，第二条安装应用：
curl -fsSL https://apt.x-neko.com/install.sh | sudo bash
sudo apt-get install endfield-charge-plus-for-linux目前提供 amd64 / x86_64 包。添加软件源后，更新应用：
sudo apt update
sudo apt install --only-upgrade endfield-charge-plus-for-linux卸载应用：
sudo apt-get remove endfield-charge-plus-for-linux安装后从应用菜单或运行 endfield-charge-plus-for-linux 启动。
Linux：直接下载安装包
四种格式均包含 .NET 运行时，无需另装 .NET：
Linux 包使用 SHA256SUMS 校验；Windows ZIP 使用 SHA256SUMS.txt。在 Linux 下载目录中可运行：
sha256sum --ignore-missing -c SHA256SUMS手动安装示例：
# Debian / Ubuntu / Kali：手动安装 DEB
sudo apt install ./EndfieldChargePlusForLinux-v0.1.0-linux-x64.deb
# Fedora 等 RPM 系
sudo dnf install ./EndfieldChargePlusForLinux-v0.1.0-linux-x64.rpm
# AppImage
chmod +x EndfieldChargePlusForLinux-v0.1.0-linux-x64.AppImage
./EndfieldChargePlusForLinux-v0.1.0-linux-x64.AppImage
# tar.gz 便携包
tar -xzf EndfieldChargePlusForLinux-v0.1.0-linux-x64.tar.gz
cd EndfieldChargePlusForLinux-v0.1.0-linux-x64
./EndfieldChargePlusAppImage 缺少 FUSE 时，可用：
./EndfieldChargePlusForLinux-v0.1.0-linux-x64.AppImage --appimage-extract-and-runLinux 要求 x86_64、glibc 2.35+、OpenSSL 3、X11 或 XWayland；Wayland 下的顶部唤出、置顶等行为受桌面合成器限制。
当前不提供 ARM64、32 位、Alpine/musl 或纯原生 Wayland 版本。
变量库按实际硬件能力筛选，移除 Windows 专属与未实现项目，不用假零值填补缺失传感器；可用变量数量因设备而异。
完整依赖、功能和测试范围见：
Linux packages above are identical to the Linux v0.1.0 release.
For English installation instructions, see README.en.md.
macOS：DMG 安装包（Beta）
macOS 版名称为 Endfield Charge Plus For MacOS，由独立仓库维护：
GlacierGlimmer/zmd-charge-plus-for-macos
当前版本为 v0.1.1-beta，要求 macOS 13+，同时提供 Apple Silicon 与 Intel Mac 版本。
macOS 安装包不包含在本页 Assets 中，请前往 macOS Releases 下载。
| 下载文件 | 适用设备 |
|---|---|
| EndfieldChargePlusForMacOS-v0.1.1-beta-osx-arm64.dmg | Apple Silicon（M1 / M2 / M3 / M4 / M5 等，推荐） |
| EndfieldChargePlusForMacOS-v0.1.1-beta-osx-x64.dmg | Intel 64 位 Mac |
两种 DMG 均为自包含发布，无需单独安装 .NET 运行时。
打开 DMG 后，将应用拖入 Applications（应用程序），然后启动应用。
macOS 版目前提供：
- 菜单栏驻留
- 点击穿透 HUD
- 简体中文 / English 双语界面
- HUD 方案管理
- 时间数据
- 网络探测
- HTTP / JSON 数据源
- DeepSeek API
- 原生 macOS 系统与硬件数据采集
系统数据通过 Mach / sysctl / IOPowerSources / APFS / Metal 等 macOS 原生接口获取，并根据当前设备实际检测能力筛选可用变量。
Windows 专属变量，以及目前无法可靠获取的部分 GPU 使用率、温度、风扇与实时 CPU 频率等数据不会显示为虚假的 0。
API Key 存储于 macOS 登录钥匙串，应用配置目录为：
~/Library/Application Support/EndfieldChargePlusForMacOS
⚠️ macOS 实机测试状态
当前 macOS 版本尚未进行真实 Mac 实机测试。
目前 CI 会分别在 Apple Silicon 与 Intel macOS 环境执行：
- 构建
- 原生数据采集
- 逐变量读取
- HUD 方案渲染
- 界面检查
- DMG 创建与挂载
- 应用启动
- 单实例检查
但 CI 环境验证不能替代真实 Mac 硬件测试。
因此当前 Beta 版本仍可能存在与以下情况相关的兼容性问题：
- 不同 Mac 机型
- 不同 macOS 13+ 系统版本
- 刘海屏 MacBook
- 多显示器
- 混合缩放
- 电池状态
- 系统权限
- 窗口层级及桌面行为
如果遇到相关问题，请前往：
进行反馈。
macOS 签名说明
当前 DMG 使用 ad-hoc 签名，尚未经过 Apple Developer ID 签名及 Apple 公证（Notarization）。
首次启动时 macOS 可能阻止直接运行。
此时可以前往：
系统设置 → 隐私与安全性 → 仍要打开
允许应用启动。
无需关闭 Gatekeeper，也无需关闭 SIP。
macOS Release 同时提供 SHA256SUMS-MacOS.txt 用于完整性校验。
完整功能、限制与后续更新请查看：
📄 项目与许可
本项目基于 QinAnze/zmd-charge 进行二次开发，遵循 MIT License。
Windows 主版本：
GlacierGlimmer/zmd-charge-plus
Linux 版本：
GlacierGlimmer/zmd-charge-plus-for-linux
macOS 版本：