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

docs/architecture-overview.md

@@ -817,7 +817,7 @@ flowchart LR
 | 指标 | 当前值 |
 |---|---:|
 | Python 模块 | 1139 |
-| 内部导入边 | 9,813 |
+| 内部导入边 | 9,824 |
 | 非平凡 SCC | 1（29 个模块的 TMDB vendor 精确 containment） |
 | Application / Chain 具体 Adapter 直连 | 0 / 0 |
 | Direct egress | 51（精确 policy 准入，Application / Chain 均为 0） |

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`。