Endfield Charge Plus · 终末地风格状态栏HUD+
下载与每版更新说明请查看本仓库 Releases。README 保留通用安装和使用说明。
多实例 HUD、自定义字体与采样间隔、常驻点击轮播、实际 FPS、世界时钟及按类别排列的内置方案；详见软件设置与 更新说明。
简体中文 · English ｜ Windows 10 / 11 · Linux x64 · macOS 13+
不止于电量提示，让需要的信息以你喜欢的方式出现在屏幕上。
Endfield Charge Plus（ECP）是基于 QinAnze/zmd-charge 二次开发的桌面状态栏 HUD。它延续原项目的终末地风格电量动画，并将原本的电源提示扩展为可常驻、可唤出、可轮播的多数据 HUD：从 CPU / GPU 和网络状态，到 DeepSeek API 与自定义 HTTP/JSON 数据，都能组合成自己的显示方案。
⬇️ Windows：Microsoft Store（推荐） · Windows 下载 · macOS 下载 · Linux 下载 · Android 发布 · 🌐 项目网站 · 原项目
本项目为非官方社区二次开发作品，与《明日方舟：终末地》开发方及发行方无隶属、授权或背书关系。
Windows 版在本仓库维护；Linux 版 Endfield Charge Plus For Linux 提供 APT 命令安装与四种独立安装包；macOS 版 Endfield Charge Plus For MacOS 在独立仓库维护，目前提供 Apple Silicon 与 Intel 两种 DMG。使用方法见下方下载章节。
⚠️ macOS 版本目前尚未进行真实 Mac 实机测试。 当前仅完成 CI macOS 环境中的构建、原生采集、界面、DMG 挂载与启动等自动化验证，因此可能仍存在与具体机型、macOS 版本、刘海屏、多显示器或系统权限相关的兼容性问题。
✨ Plus 版带来了什么？
下表与后文功能详解以 Windows 版为准；Linux 与 macOS 版本会按平台及设备能力调整可用变量和行为，详见各自安装章节与独立仓库说明。
| 方向 | 原项目的核心体验 | Endfield Charge Plus 的扩展 |
|---|---|---|
| 显示内容 | 以电源插拔和电池状态为中心 | 扩展为系统监控、时间、网络探测、API 与自定义数据 HUD |
| 显示方式 | 电源事件触发的短暂弹出 | 按需唤出 / 持续显示；持续显示可选置顶或桌面层（不置顶） |
| 唤出交互 | 电源状态变化 | 保留电源插拔提示；鼠标移至目标屏幕顶部中央，还可唤出当前方案 |
| 自定义 | 电量主题与动画 | 方案管理、变量模板、进度环、左右图标、颜色规则和两种动画模式 |
| 多方案 | 以电池 HUD 为主 | 内置多类方案、自定义方案，以及可排序的自动轮播队列 |
| 扩展能力 | 本机电量信息 | 内置变量、17 类动态磁盘变量模板和实际探测到的风扇变量，并可接入 HTTP/JSON 数据源 |
⬇️ 下载与使用
Windows：Microsoft Store / winget（推荐）
ECP 已上架微软商店。前往 Microsoft Store 获取 Endfield Charge Plus，按页面提示安装，安装完成后启动应用即可。
也可以使用 winget，在 PowerShell 或 Windows 终端中粘贴并运行：
winget install --id 9P3PLD3LX7W6 --source msstore --exact
该命令通过 Microsoft Store 源安装同一个应用；首次使用时按提示确认即可。如果系统找不到 winget，请安装或更新微软商店中的「应用安装程序」，也可以直接使用上方商店链接。
Windows：GitHub 便携版
需要免安装版本时，前往 GitHub Releases 下载适合你设备的便携版 ZIP。解压后直接运行其中的 EndfieldChargePlus.exe，无需安装，也无需另装 .NET 运行时。
首次使用只需几步：
- 通过 Microsoft Store 或 winget 安装并启动 ECP；使用 GitHub 便携版时，将 ZIP 解压到固定目录后运行
EndfieldChargePlus.exe。程序通过系统托盘驻留。 - 从托盘菜单打开设置，在「显示与位置」中选择目标显示器、HUD 位置和显示方式。
- 进入「HUD 内容与数据」，选择内置方案，或创建自己的 HUD；点击预览查看效果。
- 点击保存并应用。配置自动保存，重新启动后继续使用；可按需开启 Windows 开机启动。
默认会以系统 - 内存方案启动；首次界面语言跟随 Windows：中文系统使用简体中文，其他系统使用 English，也可以手动切换。
Linux：独立仓库 Releases
Endfield Charge Plus For Linux 由 Linux 独立仓库维护和发布。
前往 Linux Releases 查看可用版本、安装包和校验文件。APT 安装、包格式选择、依赖及验证范围以 Linux README 为准。
macOS：独立仓库 Releases
Endfield Charge Plus For MacOS 由 macOS 独立仓库维护和发布。
前往 macOS Releases 查看可用版本、Apple Silicon / Intel DMG 和校验文件。安装、签名及兼容性说明以 macOS README 为准。
Android：独立仓库
Endfield Charge Plus For Android 仓库已建立，可下载版本和发布状态以 Android Releases 为准。
各平台的版本和安装包在各自仓库分发，不与本仓库的 Windows 发布标签绑定。
🎛️ 功能一览（Windows）
| 功能 | 说明 |
|---|---|
| 两种显示方式 | 关闭「一直显示」时，HUD 按事件或鼠标唤出后自动收回；开启后持续更新当前方案。 |
| 置顶 / 桌面层 | 持续显示模式可选始终置顶或桌面层（不置顶）；HUD 支持点击穿透，不妨碍正常操作。 |
| 电源插拔提示 | 接通 / 断开电源时优先展示电池方案，插电使用完整动画、拔电使用简洁动画。 |
| 鼠标唤出 | 在非持续显示模式下，将鼠标移到目标屏幕顶部中央，即可临时显示当前非电池方案。 |
| 多显示器与位置 | 指定目标显示器，选九宫格预设位置或自定义 X/Y 坐标，并调整缩放与不透明度。 |
| 方案与动画 | 内置电池、CPU、GPU、内存、磁盘、网络、时间、DeepSeek 等方案；支持新建、另存、编辑与预览；完整 / 简洁动画可选。 |
| 自动轮播 | 按自定义队列依次切换方案，支持添加、删除、上移、下移，另设轮播间隔与切换动画。 |
| 高级变量库 | 内置变量、17 类按实际盘符生成的磁盘变量模板，以及按实际传感器生成的独立风扇变量；覆盖硬件、系统、网络、进程、安全和开发者工具等。 |
| 自由组合显示 | 标题、主副数值、百分比圆环、左右图标均可按变量模板配置；支持格式化、表达式及条件颜色规则。 |
| 网络包探测 | 指定 IPv4 / IPv6 / 域名及端口，使用 ICMP、TCP 或 UDP 探测，查看延迟、丢包等状态。 |
| DeepSeek API | 配置自己的 API Key 后显示余额、当前高峰 / 低谷、时段进度与倒计时；以北京时间判定，并提供本地时区切换时间变量。 |
| HTTP / JSON 数据源 | 配置请求地址、Header、刷新间隔和 JSON 字段映射，把自有接口数据接入 HUD。 |
| 日常维护 | 中英双语、托盘操作、开机启动、配置导入 / 导出 / 备份、日志和 GitHub 更新检查。 |
🧩 变量与自定义示例
变量不仅能单独显示，也可以参与模板、计算和进度显示。例如：
{cpu.usage|0} CPU 使用率
{memory.used_bytes|gb:1} 已用内存（GB）
{network.download_bps|speed} 网络下载速度
{deepseek.balance|0.00} DeepSeek API 余额
变量不等于模拟数值。 内置变量均有对应的读取或计算实现；实际能否读到取决于设备、驱动、权限、相关服务及第三方程序。无法获取时会显示不可用信息。完整 Key、格式和说明请在软件的「变量库」中查看。
DeepSeek API 需要用户自行提供 Key；HTTP/JSON 接口由用户自行配置。涉及密钥与自定义 Header 时，请参阅 隐私说明。
💻 Windows 运行要求与源码构建
- 系统： Windows 10 / 11，支持 x64、x86 和 ARM64。
- Portable 包： ZIP 内只有自包含的
EndfieldChargePlus.exe，不需要另行安装 .NET。首次启动时自动解压内置原生依赖。 - 自行编译： Windows 环境及 .NET 8 SDK。
# 编译源码 dotnet build EndfieldChargePlus.csproj -c Release # 示例：发布 x64 自包含单文件 ./scripts/package-windows.ps1 -Runtime win-x64
构建 x86 或 ARM64 时将 win-x64 换为 win-x86 或 win-arm64。所有架构均输出单个 EXE；帧率采集器根据 Windows 系统架构选择内置 x64 或 ARM64 版本。
微软商店提交包固定包含 x64 与 x86（32 位），不包含 ARM64。ARM64 作为独立单文件 EXE / portable ZIP 提供。先发布 x64/x86 单文件，再运行：
./scripts/package-store.ps1
该脚本使用 Windows SDK MakeAppx 校验并导出 MSIXBUNDLE / MSIXUPLOAD；每次使用全新暂存目录，避免旧 ARM64 包混入。商店包版本参数独立于产品显示版本，版本修改仍需用户明确要求。
📄 来源与许可
ECP 基于 QinAnze/zmd-charge 修改与扩展。感谢原作者 QinAnze 的开源工作；原项目的来源和许可在此明确保留。本项目新增贡献采用 MIT License。详情参见 NOTICE.md，数据处理说明参见 PRIVACY.md。
© 2026 GlacierGlimmer_冰川雪貓