{"title":"快捷替换流程不适用于所有安装方式","detail":"README 的直接替换流程面向 Linux、OpenWrt 上默认服务名为 komari-agent 的已有安装；Windows、首次安装、自定义服务名或路径等场景需查看脚本参数或 Release。"}

{"title":"自更新会跟随本项目而非官方 Go 仓库","detail":"Agent 启动后检查本仓库 Release 并下载更高版本；需要固定部署版本时可关闭自更新。"}

{"title":"替换已有探针时保留连接配置","detail":"针对 Linux 和 OpenWrt 上默认服务名为 komari-agent 的已有 Go Agent，替换脚本保留面板地址、Token 和上报间隔，自动识别架构并重启原服务。"}

{"title":"自更新下载失败可回退到代理池","detail":"自更新优先直连 GitHub；Release API、二进制资产或 SHA256SUMS 任一步直连失败，都会回退到内置代理池，也允许自行覆盖代理池配置。"}

{"title":"自更新支持两种下载校验来源","detail":"下载完成后先校验 GitHub Release API 的 digest；若 API 未返回 digest，则使用同一 Release 的 SHA256SUMS。校验失败不会替换本机二进制。"}

{"title":"替换脚本支持 systemd 启动失败自动回滚","detail":"一键替换流程会先备份原 Go Agent，再替换并重启原服务；systemd 启动失败时自动回滚。这是替换脚本的保障，不是自更新流程的回滚承诺。"}

{"title":"测试覆盖多种部署环境","detail":"CI 包含 Ubuntu、macOS、Windows 原生单测、FreeBSD 虚拟机单测、发行版容器单测，以及 OpenWrt、Raspberry Pi OS、Synology DSM profile 和 Linux 多架构启动烟测；使用 kcov 强制执行 100% 行覆盖率门槛。"}

{"title":"项目对照测试显示较低的体积与常驻内存占用","detail":"在 Debian Linux 6.1 x86_64、相同 Komari 配置下，本项目 ReleaseSmall linux-amd64 二进制为 702,488 B、常驻 RSS 约 1,196 KB；对照的官方 Go Agent 1.2.13 分别为 8,585,378 B 和 17,828 KB。该结果限定于所述环境、构建和版本，不代表所有部署的资源占用。"}

远程控制

命令行

Windows

macOS

Linux

用于替换 Go 版的 Komari 监控探针

希望替换现有 Komari Go Agent 的运维人员：项目以兼容现有协议为目标；符合快捷替换条件的安装可保留面板地址、Token 和上报间隔。

需要在多种 CPU 架构设备上部署 Komari 探针的用户：Linux 发布资产覆盖 ARM、MIPS、RISC-V、loong64 等架构，可用于异构设备部署。

部署机器访问 GitHub 不稳定的维护者：自更新具备直连失败后回退到代理池的机制，并允许自行指定代理池。

为小内存 VPS 或设备选择 Komari 探针的用户：项目提供了低体积和低常驻内存占用的对照数据，可作为候选方案；实际资源占用仍需按目标设备和构建验证。

服务器运维

延续现有监控协议：项目声明已实现官方 Go Agent 1.2.60 的功能兼容，面向现有 Komari 部署替换。

覆盖多架构设备：提供 Linux 11 种架构及 Windows、macOS、FreeBSD 二进制。

更新前校验下载：安装、替换和自更新均校验下载内容，下载、校验或预检失败不覆盖原二进制。

面向轻量部署：项目的 Linux x86_64 对照测试显示较小的二进制和较低的常驻内存占用，可供小内存设备部署时参考。

Zig 0.16.0

komari-zig-agent 是使用 Zig 编写的 Komari 服务器监控 Agent，目标是替换官方 Go Agent，兼容其上报、任务执行、Ping 和 Web SSH 等功能。支持多系统与多种 Linux 架构，并提供保留原配置的替换脚本、下载校验和失败回滚机制。

基础信息与上报：实现 BasicInfo 和 Report WebSocket，兼容 Komari 现有上报字段。

任务与远程终端：支持任务执行、Ping 和 Web SSH，服务端任务设有并发上限。

显卡指标采集：支持 Windows NVIDIA 详细 GPU 指标采集。

网络连接配置：支持自动发现、代理、自定义 DNS/IP，以及可选 Cloudflare Access 凭据。

兼容原探针配置：项目声明已实现官方 Go Agent 1.2.60 的启动参数和配置来源兼容。

非 root 用户安装：支持通过 systemd user 服务安装。

自动版本更新：检查本仓库 Release 并下载匹配平台的资产，也可通过参数关闭。