修复错误

This commit is contained in:
CN-JS-HuiBai
2026-04-07 17:41:45 +08:00
parent e3a4480e8c
commit 6467f17b30
5 changed files with 716 additions and 27 deletions

View File

@@ -1,26 +1,25 @@
# User Online Devices Plugin
This plugin adds a user-facing online device dashboard for Xboard.
This plugin provides online IP monitoring for Xboard users and administrators.
## Features
- Shows the current online device count based on Xboard's built-in `DeviceStateService`
- Shows the current online IP list for the logged-in user
- Optionally shows Sanctum login sessions
- Provides an authenticated API endpoint for the frontend to fetch the dashboard URL
- Provides a temporary signed dashboard page that auto-refreshes
- Provides an administrator page to inspect all users' online IP counts
- Provides an administrator API endpoint with paginated user online IP data
- Provides a temporary signed dashboard page for a single user snapshot
## Routes
- `GET /api/v1/user-online-devices/summary`
- `GET /api/v1/user-online-devices/panel-url`
- `GET /userstatus`
- `GET /user-online-devices/userstatus`
- `GET /api/v2/{secure_path}/user-online-devices/users`
- `GET /{secure_path}/user-online-devices`
- `GET /user-online-devices/panel/{user}` (temporary signed URL)
## Notes
- This plugin reuses Xboard's existing real-time device state data from Redis.
- In current Xboard releases, plugin development is primarily backend-oriented, so this plugin ships a standalone user-side page instead of patching the compiled SPA bundle directly.
- In current Xboard releases, plugin development is primarily backend-oriented, so this plugin ships standalone pages instead of patching the compiled SPA bundle directly.
- The "online device" count is effectively the number of unique online IPs reported by nodes.
- The easiest user entry is now `/userstatus`, which reads the current Xboard login token and shows the current user's own status.
- The administrator entry is `/{secure_path}/user-online-devices`, which reads the current admin login token and shows paginated user online IP data.