From d1989a7f24268af9abcd7e3a196c3358b1d11fba Mon Sep 17 00:00:00 2001 From: kory Date: Mon, 28 Sep 2026 09:05:45 +0800 Subject: [PATCH] docs: update README with node resource profiling and device revocation features --- README.md | 13 +++++++++++-- 1 file changed, 11 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index ac2370b..213a8fc 100644 --- a/README.md +++ b/README.md @@ -27,9 +27,17 @@ - **零参数泄露**：全面封禁 CLI 敏感传参，凭据由 `0600` 环境变量接管，避免 `/proc/*/cmdline` 泄密。 - **完整审计追溯**：内置本地 SQLite 存储，全量记录调用者 IP、下发节点、指令内容、退出码及精确执行耗时。 - **执行隔离与超时回收**：内置上下文超时控制，强制清理孤儿进程，彻底杜绝僵尸进程。 +- 📊 **实时节点资源画像 (Node Profiling & Role)**： + - **原生零依赖深度采集**：直接读取 Linux 内核指标，实时监控物理 CPU 核心数与瞬时负载、真实可用内存（`MemAvailable`）与 Swap、根分区磁盘占用、IO 压力指数（内核原生 PSI / Loadavg）及 Docker 守护进程运行状态。 + - **动态角色标签**：支持节点角色分工（如 `CONTROL` 控制中枢、`APPLICATION` 应用节点、`DATABASE` 等），为 AI Agent 自动化调度部署决策提供全维度实时依据。 +- 🛡️ **设备生命周期管理与防重连黑名单**： + - 支持管理员在 Web 控制台一键注销并强制断开指定受控节点。 + - 持久化吊销拦截（Revocation List），彻底杜绝被下线 Agent 因 Systemd 自动重启而死灰复燃。 + - 本地主控节点（Local）强制安全锁，防误操作防护。 - 🖥️ **内嵌极简 Web 管理面板**： - 静态单页面（SPA）采用 Go `embed` 完整打包进二进制文件，单文件独立运行，无需安装 Node.js、Nginx 或外部静态资源 CDN。 - - 包含设备状态感知、Actions 向导、在线调试控制台及操作审计日志。 + - **工程级双态主题**：纯手绘 SVG 极简几何微图标（太阳/弦月），支持深曜蓝黑与柔和浅灰白一键切换，完美适配系统偏好且零 FOUC 白屏闪烁。 + - **全端响应式**：彻底适配手机移动端（≤680px），宽表独立触控滑动，长节点名自动断行不穿透。 --- @@ -153,7 +161,8 @@ Agent 启动后会通过 WSS 自动连入 Hub，在 Hub 管理面板与 `/api/v1 | 接口路径 | 方法 | 功能描述 | | :--- | :--- | :--- | -| `/api/v1/devices` | `GET` | 列出集群中所有受控设备及其实时状态（在线/离线、架构、系统等） | +| `/api/v1/devices` | `GET` | 列出集群中所有受控设备状态与**实时资源画像 (CPU/Mem/Disk/IO PSI/Docker/Role)** | +| `/panel/api/devices` | `DELETE` | 【管理员】注销并踢出指定受控节点，持久化写入防重连黑名单 | | `/api/v1/exec` | `POST` | 在指定受控节点执行任意 Shell 指令（支持超时截断） | | `/api/v1/file/read` | `POST` | 安全分页读取目标机器上的文件内容（防内存溢出） | | `/api/v1/file/write` | `POST` | 向目标机器指定路径覆写或创建文件 |