feat: Hugging Face Spaces Docker deployment

Dockerfile

@@ -58,6 +58,8 @@ RUN cp conf.example.py conf.py
 RUN mkdir -p /app/videoFile
 RUN mkdir -p /app/cookiesFile
 
+# Hugging Face Spaces：README 中 app_port 须与此端口一致；也可在 Space 设置里改 app_port 并同步设置环境变量 PORT
+ENV PORT=5409
 EXPOSE 5409
 
 CMD ["python", "sau_backend.py"]

README.md

@@ -1,3 +1,12 @@
+---
+title: social-auto-upload
+emoji: 📤
+colorFrom: blue
+colorTo: green
+sdk: docker
+app_port: 5409
+---
+
 # social-auto-upload
 
 `social-auto-upload` 是一个强大的自动化工具，旨在帮助内容创作者和运营者高效地将视频内容一键发布到多个国内外主流社交媒体平台。
@@ -185,6 +194,10 @@
    ```
 启动容器后访问：[http://localhost:5409](http://localhost:5409)
 
+### Hugging Face Spaces
+
+仓库已配置 Docker Space 元数据（`README.md` 顶部 YAML）与端口环境变量。部署步骤与可见性说明见 [docs/deploy-huggingface.md](docs/deploy-huggingface.md)。
+
 ## 🐇项目背景
 
 该项目最初是我个人用于自动化管理社交媒体视频发布的工具。我的主要发布策略是提前一天设置定时发布，因此项目中很多定时发布相关的逻辑是基于“第二天”的时间进行计算的。

docs/deploy-huggingface.md

@@ -0,0 +1,21 @@
+# Hugging Face Spaces 部署说明
+
+本仓库已包含 Docker Space 所需的 `README.md` 元数据（文件首部的 YAML）与 `Dockerfile`。
+
+## 创建 Space
+
+1. 在 [新建 Space](https://huggingface.co/new-space) 选择 **Docker** SDK（与 README 中 `sdk: docker` 一致）。
+2. 将本仓库推送到该 Space 关联的 Git 仓库，或从 GitHub 同步。
+3. **端口**：README 中 `app_port: 5409` 与 `Dockerfile` 的 `EXPOSE` / `ENV PORT` 一致；若你在 Space 设置里改为其他端口，请同时设置环境变量 `PORT` 与 `app_port` 相同。
+
+## 可见性
+
+- **Private**：仅你（及协作者）可访问应用与源码，他人访问 URL 会 404（见 [Spaces 文档](https://huggingface.co/docs/hub/spaces-overview#space-visibility)）。
+- **Public**：源码与运行中的应用对公众可见。
+- **Protected**（PRO / Team 等）：源码私有，应用仍可通过 URL 公开访问。
+
+## 注意事项
+
+- 镜像构建包含 Playwright Chromium，**构建时间较长**，免费硬件可能较慢；若构建失败可查看 Space 构建日志。
+- 持久化数据需自行购买 Spaces 持久存储或使用外部存储；默认容器内除挂载卷外重启会丢失。
+- 敏感配置请使用 Space **Settings → Secrets / Variables**，勿写入仓库。

sau_backend.py

@@ -714,4 +714,6 @@ def sse_stream(status_queue):
             time.sleep(0.1)
 
 if __name__ == '__main__':
-    app.run(host='0.0.0.0' ,port=5409)
+    # 本地默认 5409；Docker / Hugging Face Spaces 可通过环境变量 PORT 覆盖（与 README 中 app_port 一致）
+    port = int(os.environ.get("PORT", "5409"))
+    app.run(host="0.0.0.0", port=port)