docs/deploy-huggingface.md

# 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**，勿写入仓库。