docs/deploy-huggingface.md

Hugging Face Spaces 部署说明

本仓库已包含 Docker Space 所需的 README.md 元数据（文件首部的 YAML）与 Dockerfile。

创建 Space

1. 在 新建 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 文档）。
• Public：源码与运行中的应用对公众可见。
• Protected（PRO / Team 等）：源码私有，应用仍可通过 URL 公开访问。

注意事项

• 镜像构建包含 Playwright Chromium，构建时间较长，免费硬件可能较慢；若构建失败可查看 Space 构建日志。
• 持久化数据需自行购买 Spaces 持久存储或使用外部存储；默认容器内除挂载卷外重启会丢失。
• 敏感配置请使用 Space Settings → Secrets / Variables，勿写入仓库。