File size: 4,963 Bytes
bc4af9e
 
 
 
 
 
 
 
 
 
4446216
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
---
title: Cloud Camera
emoji: 📷
colorFrom: blue
colorTo: gray
sdk: gradio
app_file: app.py
pinned: false
---

# 📷 云端相机 Cloud Camera

手机浏览器打开的 H5 云端相机:拍照/选图 → 保存到本地或上传云端 → 随时随地打开网页查看自己的云端相册。

**架构(方案 B)**
- **后端**:Hugging Face Space(Gradio API),照片存 Space 挂载的持久存储桶(重启不丢)
- **前端**:单页 `index.html`,部署在你自己的 GitHub Pages(域名自理)

## 功能一览

| 模块 | 功能 |
|---|---|
| 🔐 登录 | 用户名 + PIN 码,首次输入自动创建专属相册;浏览器记住登录状态 |
| 📷 拍照 | 实时取景拍照、前后镜头切换;不支持实时预览时自动回退到系统相机 |
| 🖼 选图 | 从手机相册选照片上传 |
| 💾 保存 | 拍照后可选「存本地」或「传云端」(带进度条),设置里可开启「上传后自动再存一份本地」 |
| 🗂 云端相册 | 缩略图三列网格、滚动加载、大图查看、下载、删除、下拉刷新 |
| ⚙️ 设置 | 切换账号、退出登录、自动保存开关 |

## 目录结构

```
cloud-camera/
├── app.py            # HF Space 后端(Gradio API:登录/上传/列表/单图/删除)
├── storage.py        # 存储层:用户、PIN 加盐哈希、索引、图片访问签名
├── index.html        # 前端单页(部署到 GitHub Pages 的唯一文件)
├── main.py           # 旧 FastAPI 版后端(仅本地参考,Space 不再使用)
├── requirements.txt  # 后端依赖
└── README.md
```

## 后端(Hugging Face)— 已完成部署

当前线上后端:**https://wacatw-cloud-camera.hf.space**(用户名 `WACATW`,Space `cloud-camera`)

- SDK:Gradio(ZeroGPU 免费额度,仅占用位函数,业务不消耗 GPU 配额)
- 持久存储:挂载存储桶 `WACATW/cloud-camera-storage` 到 `/data`,Space 重启后照片不丢(已验证)
- 业务接口:以 Gradio API 形式暴露(见下节)

### 后端 API 参考(Gradio Queue API)

调用流程:`POST /gradio_api/call/{api}` 提交参数 → 返回 `event_id` → `GET /gradio_api/call/{api}/{event_id}` 轮询 SSE 取结果。

| 接口 | 参数 `data` | 返回 |
|---|---|---|
| `api_login` | `["用户名","PIN"]` | `{"ok":true,"is_new":true/false}` |
| `api_upload` | `["用户名","PIN","临时路径"]` | `{"ok":true,"photo":{...}}` |
| `api_photos` | `["用户名","PIN"]` | `{"ok":true,"photos":[{...缩略图 base64...}]}` |
| `api_photo` | `["用户名","PIN","照片id"]` | `{"ok":true,"b64":"data:image/jpeg;base64,..."}` |
| `api_delete` | `["用户名","PIN","照片id"]` | `{"ok":true}` |

上传通道:`POST /gradio_api/upload`(multipart `files=`)→ 返回 `["/tmp/gradio/<hash>/<文件名>"]`,再把该临时路径传给 `api_upload`。

> 图片以 **base64 data URL** 传输(缩略图随列表返回、原图点开时单独拉取),绕开 Gradio `file=` 白名单限制,无需额外鉴权 header。

## 前端(GitHub Pages)— 你来部署

前端就是**一个文件**:`index.html`(CSS/JS 全内联)。后端地址已在文件开头配好:

```js
var API_BASE = "https://wacatw-cloud-camera.hf.space";   // HF 后端(Gradio API)
```

### 部署步骤(约 3 分钟)

1. 打开 [github.com/new](https://github.com/new),新建一个公开仓库,比如 `cloud-camera`
2. 上传 `index.html` 到仓库根目录(仓库页面 → **Add file → Upload files**)
3. 仓库 **Settings → Pages**:Source 选 `Deploy from a branch`,分支选 `main`,目录 `/ (root)`,**Save**
4. 等 1-2 分钟,GitHub 会给你一个 `https://<用户名>.github.io/cloud-camera/` 地址,手机浏览器打开即用
5. (可选)之后自己绑定域名:Settings → Pages → Custom domain

### 换绑到别的后端

如果后端地址变了,只需改 `index.html` 里的 `API_BASE` 一个常量;若整站同域部署,改成空字符串 `""` 即可。

## 安全设计

- **PIN 码**:加盐哈希存储 `sha256(salt:pin)`,明文不落盘;错误 PIN 拒绝访问相册
- **用户隔离**:每个用户独立相册目录(`/data/<用户名>/`),接口强制校验用户名+PIN
- **文件名**:照片以随机 id 命名,中文/特殊字符用户名按规则清洗
- **图片传输**:相册列表仅返回缩略图,原图按需拉取,删除即从磁盘移除

## 本地调试

```bash
# 依赖
pip install gradio pillow

# 本地起服务(stub 掉 spaces.GPU)
DATA_DIR=/tmp/cc-data python3 -c "import sys,types;sp=types.ModuleType('spaces');sp.GPU=lambda fn:fn;sys.modules['spaces']=sp;import runpy;runpy.run_path('app.py',run_name='__main__')"
# 打开 http://127.0.0.1:7860 (Gradio API 端点)
```

> 本地 `index.html` 的 `API_BASE` 指向线上后端,纯前端测试可直接打开 `index.html` 文件(浏览器需联网)。