Reapply "feat: 设备端应用商店（平台侧）"

This reverts commit bf5071b14d.

doc/API.md

@@ -219,6 +219,26 @@
 | POST | `/api/system/backup/preview` | 上传备份校验预览（multipart，字段 `file`） |
 | POST | `/api/system/backup/apply` | 应用恢复（重启生效） |
 
+### 2.11 device_agent（`web/device_agent_api.py`）
+
+**设备端专用**（无登录会话，靠 `X-Device-Token` 鉴权；平台未启用时统一 404）：
+
+| 方法 | 路径 | 功能 |
+|------|------|------|
+| GET | `/api/device/agent/bootstrap` | 设备拉自己的身份 + 可安装应用清单 |
+| GET | `/api/device/agent/apk/<apk_id>` | 下载 APK 文件 |
+| POST | `/api/device/agent/report` | 上报下载/安装结果 |
+
+**管理端**（登录 + 应用管理权限）：
+
+| 方法 | 路径 | 功能 |
+|------|------|------|
+| GET | `/api/agent-store/config` | 读配置（含设备令牌） |
+| POST | `/api/agent-store/config` | 启用/停用、重置令牌 |
+| GET | `/api/agent-store/logs` | 设备端安装记录 |
+
+> 完整协议、鉴权与版本约定见 [DEVICE_AGENT.md](DEVICE_AGENT.md)。
+
 ---
 
 ## 3. 认证与页面
@@ -656,7 +676,41 @@ multipart 上传 `.zip` 或 `.db`（字段 `file`）→ 校验并暂存：
 
 ---
 
-## 14. 非 JSON 响应汇总
+## 14. 设备端应用商店
+
+**设备侧**三个接口（`bootstrap` / `apk` / `report`）的完整协议、鉴权、错误码与版本约定
+见 [DEVICE_AGENT.md](DEVICE_AGENT.md)——那份文档同时是设备端 APK 仓库的对接契约。
+
+**管理侧**（登录 + 应用管理权限）：
+
+### GET /api/agent-store/config
+
+```json
+{"ok": true, "enabled": false, "token": "…", "token_created_at": "2026-09-13 14:38:11",
+ "api_version": 1, "base_url_hint": "http://192.168.20.220:18050"}
+```
+
+`base_url_hint` 由请求的 Host 回填，直接可作为设备端要填的平台地址。
+
+### POST /api/agent-store/config
+
+`{"enabled": true}` 启用（并自动生成令牌）；`{"regenerate_token": true}` 重置令牌
+（旧令牌立即失效）。返回 `{"ok": true, "enabled": …, "token": …}`。
+
+### GET /api/agent-store/logs?limit=50
+
+```json
+{"ok": true, "logs": [{"id": 1, "device_name": "A08", "serial": "192.168.20.100:5555",
+  "fingerprint": "…", "apk_id": "56b114aa", "package_name": "com.example.clipinject",
+  "version_name": "1.0", "action": "install_fail", "message": "MIUI 拦截未确认",
+  "created_at": "2026-09-13 14:40:00"}]}
+```
+
+`action` ∈ `download` / `install_ok` / `install_fail`；记录表最多保留 500 条（自动裁旧）。
+
+---
+
+## 15. 非 JSON 响应汇总
 
 | 方法 | 路径 | 响应类型 | 说明 |
 |------|------|---------|------|