Add shell-based HF Space setup

Dockerfile

@@ -0,0 +1,16 @@
+FROM python:3.11-slim
+
+WORKDIR /app
+
+COPY requirements.txt /app/
+COPY entrypoint.sh /app/
+
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends curl ca-certificates unzip \
+    && rm -rf /var/lib/apt/lists/* \
+    && pip install --no-cache-dir -r requirements.txt \
+    && chmod +x /app/entrypoint.sh
+
+EXPOSE 7860
+
+CMD ["/app/entrypoint.sh"]

README.md

@@ -1 +1,28 @@
+# HF Hidden Code Space Shell
 
+这个仓库是一个 Hugging Face Space 的“壳”项目，用于在运行时拉取真实业务源码并启动服务。构建阶段不会包含任何业务代码，保持仓库公开而代码私有。
+
+## 运行流程
+1. 使用 `python:3.11-slim` 构建最小镜像，只安装基础依赖。
+2. 镜像启动时运行 `entrypoint.sh`，检查 `APP_ARCHIVE_URL` 环境变量。
+3. 通过运行时提供的 URL 下载真实业务代码压缩包（支持 zip 与 tar.gz），自动解压到 `/opt/app`。
+4. 进入解压后的目录，执行 `uvicorn app:app --host 0.0.0.0 --port 7860` 启动 FastAPI 应用。
+
+## 配置方法
+在 Hugging Face Space → **Settings** → **Variables** 中新增：
+
+```
+APP_ARCHIVE_URL = https://example.com/your-real-app.zip
+```
+
+> 注意：不要在 Dockerfile 或构建阶段尝试读取该变量，HF secrets 仅在运行时可用。
+
+## 部署步骤示例
+1. 将本仓库推送到 Hugging Face，创建为 **Public** Space（Docker 模式）。
+2. 在 Space 设置里添加环境变量 `APP_ARCHIVE_URL`，指向你的私有业务代码归档包（zip 或 tar.gz）。
+3. 点击 **Restart this Space**，容器启动时会自动下载、解压并运行你的应用。
+
+## 重要提示
+- 这是一个空壳仓库，不包含真实业务源码，Fork 后直接运行会失败，因为缺少 `APP_ARCHIVE_URL`。
+- `entrypoint.sh` 不会打印下载 URL，避免泄露敏感信息。
+- 仅包含基础依赖，如需额外依赖，请在真实业务代码的环境中自行处理。

entrypoint.sh

@@ -0,0 +1,40 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ -z "${APP_ARCHIVE_URL:-}" ]]; then
+  echo "错误：未设置 APP_ARCHIVE_URL 环境变量。" >&2
+  exit 1
+fi
+
+APP_DIR="/opt/app"
+mkdir -p "$APP_DIR"
+cd "$APP_DIR"
+
+ARCHIVE_FILE="app_archive"
+
+# 下载归档文件，不输出 URL 防止泄露
+if ! curl -fsSL "$APP_ARCHIVE_URL" -o "$ARCHIVE_FILE"; then
+  echo "错误：无法下载应用归档文件。" >&2
+  exit 1
+fi
+
+# 根据文件类型解压 zip 或 tar.gz
+if file "$ARCHIVE_FILE" | grep -qi "zip"; then
+  unzip -q "$ARCHIVE_FILE" -d "$APP_DIR"
+elif file "$ARCHIVE_FILE" | grep -Eqi "gzip compressed data|tar archive"; then
+  tar -xzf "$ARCHIVE_FILE" -C "$APP_DIR"
+else
+  echo "错误：不支持的归档格式。" >&2
+  exit 1
+fi
+
+# 选择解压后的第一个目录作为应用目录
+APP_SUBDIR=$(find "$APP_DIR" -mindepth 1 -maxdepth 1 -type d | head -n 1)
+if [[ -z "$APP_SUBDIR" ]]; then
+  echo "错误：未找到解压后的应用目录。" >&2
+  exit 1
+fi
+
+cd "$APP_SUBDIR"
+
+exec uvicorn app:app --host 0.0.0.0 --port 7860

requirements.txt

@@ -0,0 +1,3 @@
+fastapi
+uvicorn
+requests