butubb/auto_control
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source 
按 git 红线撤回：该功能未经 dev 验收就被合并进 main（是我提交时没切分支、
又把自己的自测当成了用户验收）—— main 必须保持"已验收可部署"的状态。

功能本身没问题，代码仍在 **dev**（dad1af8）与 feature 分支上，等设备端 Agent
写出来、端到端验收通过后，再从 dev 合并回 main。

main 内容已回到 66632bb（git diff 66632bb HEAD 为空）。
This commit is contained in:
butubb
2026-09-13 14:44:00 +08:00
parent dad1af8b0b
commit bf5071b14d
11 changed files with 3 additions and 668 deletions
Download Patch File Download Diff File Expand all files Collapse all files
doc/API.md
+1 -55
View File
@@ -219,26 +219,6 @@
| 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. 认证与页面
@@ -676,41 +656,7 @@ multipart 上传 `.zip` 或 `.db`（字段 `file`）→ 校验并暂存：
---
## 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 响应汇总
## 14. 非 JSON 响应汇总
| 方法 | 路径 | 响应类型 | 说明 |
|------|------|---------|------|