feat(widget): 显示下载上传速度和剩余磁盘空间 (#7177)

docs/widgets.md

@@ -47,6 +47,14 @@ Cookie、主登录 JWT、资源令牌或 `API_TOKEN`。小组件凭据也不能
 分类；设置中的 `admin` 标记不能授予管理员权限。订阅按数据库 owner/type 分页并返回真实总数，
 不把展示的六项摘要当作全部数量。
 
+下载状态对管理员额外返回 `downloadSpeed`（下载速度）、`uploadSpeed`（上传速度）和
+`freeSpace`（剩余空间），之后保留 `count`（任务数量）。速率直接汇总原下载器的字节采样，
+包含做种上传；不解析任务列表中的格式化速度。空间沿用仪表盘的本地下载目录与
+`BTRFS_FSID_DEDUP` 去重口径。无下载任务但统计有效时仍可显示真实的零下载和上传速度。
+磁盘未配置、目录缺失或容量读取失败时，空间显示 `—`；有效的零剩余空间显示 `0 B`。
+速率来源缺失或非法时，该节为 `unavailable`。普通用户继续只返回本人任务及数量，
+不读取或暴露实例全局速度和磁盘信息。App 小尺寸优先显示两种速度，中大尺寸增加剩余空间。
+
 ## 快照协议 v1
 
 根字段为 `version`、`owner`、`generatedAt`、`expiresAt`、`availableContents`、`sections`。