Deploy 444b7ab to Docker Space

README.md

@@ -12,7 +12,7 @@ app_port: 4783
 本地 AI 图片创作工作台，面向中文内容运营、设计草图和自动化生图流程。支持 `gpt-image-2`、OpenAI 兼容图片接口、文生图、图生图、遮罩编辑、批量任务、历史复用、费用追踪和 Agent API。
 
 <p align="center">
-  <img src="./readme-images/interface.jpg?v=20260608-07b596b" alt="GPT Image Playground 界面" width="900"/>
+  <img src="https://raw.githubusercontent.com/MisonL/gpt-image-playground-customer/444b7abc99f5bfa03760ceefb2beb0d790f0aba9/readme-images/interface.jpg?v=20260608-07b596b" alt="GPT Image Playground 界面" width="900"/>
 </p>
 
 ## 快速开始
@@ -78,13 +78,13 @@ start-windows.bat
 遮罩编辑示例：
 
 <p align="center">
-  <img src="./readme-images/mask-creation.jpg?v=20260608-07b596b" alt="遮罩创建" width="900"/>
+  <img src="https://raw.githubusercontent.com/MisonL/gpt-image-playground-customer/444b7abc99f5bfa03760ceefb2beb0d790f0aba9/readme-images/mask-creation.jpg?v=20260608-07b596b" alt="遮罩创建" width="900"/>
 </p>
 
 历史与费用示例：
 
 <p align="center">
-  <img src="./readme-images/history.jpg?v=20260608-07b596b" alt="历史面板" width="900"/>
+  <img src="https://raw.githubusercontent.com/MisonL/gpt-image-playground-customer/444b7abc99f5bfa03760ceefb2beb0d790f0aba9/readme-images/history.jpg?v=20260608-07b596b" alt="历史面板" width="900"/>
 </p>
 
 ## 配置

docs/deployment/huggingface-space-free.md

@@ -96,6 +96,7 @@ npm run deploy:space
 
 - 使用 `git status --porcelain` 拒绝脏工作区。
 - 使用 `git archive HEAD` 生成临时源码目录，只上传已跟踪源码。
+- Space 发布包会排除根目录 `readme-images/` 中的 README 文档截图，以兼容 Hugging Face Git 的二进制文件门禁；Space README 会改用对应 GitHub 提交的不可变图片地址。
 - 优先使用 `hf upload` 上传到 `misonL/gpt-image-playground-customer`。
 - 仅当 `hf upload` 因既有 Docker Space 的创建政策 `402` 失败时，克隆该固定 Space、同步已跟踪源码并使用认证 Git 推送；其他错误不会自动回退。
 - 等待新 Space commit 进入 `RUNNING`。

package.json

@@ -3,6 +3,13 @@
     "version": "2.1.0",
     "license": "MIT",
     "private": true,
+    "allowScripts": {
+        "better-sqlite3@12.9.0": true,
+        "esbuild@0.28.1": true,
+        "fsevents@2.3.3": true,
+        "sharp@0.34.5": true,
+        "unrs-resolver@1.6.4": true
+    },
     "scripts": {
         "dev": "next dev --turbopack -p 4783",
         "prebuild": "node scripts/clean-standalone.mjs",

public/hf-space-deploy-marker.json

@@ -1,6 +1,6 @@
 {
   "schema_version": 1,
-  "local_sha": "17eadccc647ef019723113dc6cc21af600da3dcd",
-  "created_at": "2026-07-20T07:05:18.467Z",
-  "deploy_id": "8d1b7635-85e0-4e04-af0c-e1a37b53c0a4"
+  "local_sha": "444b7abc99f5bfa03760ceefb2beb0d790f0aba9",
+  "created_at": "2026-07-20T08:14:53.507Z",
+  "deploy_id": "a25ce1ac-a4d0-4982-bc6d-796a92ff195f"
 }

scripts/deploy-hf-space.mjs

@@ -2,7 +2,7 @@
 
 import { spawnSync } from 'node:child_process';
 import { randomUUID } from 'node:crypto';
-import { cpSync, mkdirSync, mkdtempSync, readdirSync, rmSync, writeFileSync } from 'node:fs';
+import { cpSync, mkdirSync, mkdtempSync, readdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 import { setTimeout as delay } from 'node:timers/promises';
@@ -21,6 +21,7 @@ const HF_SPACE_GIT_REMOTE_URL = `https://huggingface.co/spaces/${HF_SPACE_ID}`;
 const GIT_DEPLOY_AUTHOR_NAME = 'gpt-image-playground deploy';
 const GIT_DEPLOY_AUTHOR_EMAIL = 'deploy@localhost';
 export const GIT_ARCHIVE_MAX_BUFFER_BYTES = 256 * 1024 * 1024;
+const SPACE_DEPLOY_EXCLUDED_PATH_PREFIXES = ['readme-images/'];
 
 function parseArgs(argv) {
     assertKnownOptions(argv, ['--help', '-h']);
@@ -88,10 +89,30 @@ function assertCleanGitWorktree() {
     }
 }
 
-function prepareSourceTree() {
+export function isSpaceDeployPath(filePath) {
+    const normalized = String(filePath || '')
+        .replaceAll('\\', '/')
+        .replace(/^\.\//, '');
+    return normalized.length > 0 && !SPACE_DEPLOY_EXCLUDED_PATH_PREFIXES.some((prefix) => normalized.startsWith(prefix));
+}
+
+export function rewriteSpaceReadmeImageSources(readme, repoSlug, localSha) {
+    if (!repoSlug?.trim()) throw new Error('repoSlug is required when rewriting Space README image sources.');
+    if (!/^[0-9a-f]{40}$/.test(String(localSha || ''))) {
+        throw new Error('localSha must be a full git commit SHA when rewriting Space README image sources.');
+    }
+    return String(readme).replace(/(['"])(?:\.\/)?(readme-images\/[^'"]+)\1/g, (_, quote, imagePath) => {
+        return `${quote}https://raw.githubusercontent.com/${repoSlug}/${localSha}/${imagePath}${quote}`;
+    });
+}
+
+function prepareSourceTree(repoSlug, localSha) {
     const sourceDir = mkdtempSync(join(tmpdir(), 'gpt-image-hf-space-'));
     const archive = runBinary('git', ['archive', '--format=tar', 'HEAD']);
     runText('tar', ['-x', '-C', sourceDir], { input: archive });
+    rmSync(join(sourceDir, 'readme-images'), { force: true, recursive: true });
+    const readmePath = join(sourceDir, 'README.md');
+    writeFileSync(readmePath, rewriteSpaceReadmeImageSources(readFileSync(readmePath, 'utf8'), repoSlug, localSha), 'utf8');
     return sourceDir;
 }
 
@@ -142,7 +163,7 @@ export function buildUploadArgs({ sourceDir, localSha, repoSlug, deletePaths = [
 
 function readLocalGitFiles() {
     const output = runText('git', ['-c', 'core.quotePath=false', 'ls-tree', '-r', '-z', '--name-only', 'HEAD']);
-    return new Set(output.split('\0').filter(Boolean));
+    return new Set(output.split('\0').filter(isSpaceDeployPath));
 }
 
 function readRemoteFilePaths() {
@@ -216,13 +237,13 @@ function readLocalGitFilesWithDeployMarker() {
     return files;
 }
 
-function uploadSourceTree(sourceDir, deployMarker) {
+function uploadSourceTree(sourceDir, deployMarker, repoSlug) {
     writeDeployMarker(sourceDir, deployMarker);
     const deletePaths = findRemoteDeletePaths(readLocalGitFilesWithDeployMarker(), readRemoteFilePaths());
     try {
         const output = runText(
             'hf',
-            buildUploadArgs({ sourceDir, localSha: deployMarker.local_sha, repoSlug: readRepositorySlug(), deletePaths })
+            buildUploadArgs({ sourceDir, localSha: deployMarker.local_sha, repoSlug, deletePaths })
         );
         return { spaceCommitSha: extractUploadCommitSha(output), transport: 'hf_upload' };
     } catch (error) {
@@ -351,10 +372,11 @@ async function deploy() {
     assertCleanGitWorktree();
     runText('hf', ['auth', 'whoami']);
     const localSha = runText('git', ['rev-parse', 'HEAD']);
+    const repoSlug = readRepositorySlug();
     const deployMarker = buildDeployMarker(localSha);
-    const sourceDir = prepareSourceTree();
+    const sourceDir = prepareSourceTree(repoSlug, localSha);
     try {
-        const { spaceCommitSha, transport } = uploadSourceTree(sourceDir, deployMarker);
+        const { spaceCommitSha, transport } = uploadSourceTree(sourceDir, deployMarker, repoSlug);
         const runtime = await waitForRunning(spaceCommitSha, deployMarker);
         const verification = await verifyPublicEndpoints();
         console.log(

scripts/deploy-hf-space.test.mjs

@@ -6,11 +6,13 @@ import {
     assertDeployMarkerMatches,
     buildDeployMarker,
     buildDeployMarkerRouteSource,
+    isSpaceDeployPath,
     isHfUploadExistingSpacePolicyError,
     buildUploadArgs,
     extractUploadCommitSha,
     findRemoteDeletePaths,
     parseRepositorySlug,
+    rewriteSpaceReadmeImageSources,
     waitForRunning
 } from './deploy-hf-space.mjs';
 
@@ -112,6 +114,23 @@ describe('HF Space deploy script', () => {
         assert.ok(GIT_ARCHIVE_MAX_BUFFER_BYTES >= 128 * 1024 * 1024);
     });
 
+    it('excludes README documentation binaries from the Space source tree', () => {
+        assert.equal(isSpaceDeployPath('README.md'), true);
+        assert.equal(isSpaceDeployPath('src/app/page.tsx'), true);
+        assert.equal(isSpaceDeployPath('readme-images/interface.jpg'), false);
+        assert.equal(isSpaceDeployPath('readme-images/nested/example.jpg'), false);
+    });
+
+    it('rewrites local README image sources to immutable GitHub sources for the Space', () => {
+        const localSha = '1111111111111111111111111111111111111111';
+        const readme = '<img src="./readme-images/interface.jpg?v=123" alt="Interface" />';
+
+        assert.equal(
+            rewriteSpaceReadmeImageSources(readme, 'owner/repo', localSha),
+            `<img src="https://raw.githubusercontent.com/owner/repo/${localSha}/readme-images/interface.jpg?v=123" alt="Interface" />`
+        );
+    });
+
     it('adds delete args for remote files that are no longer in git HEAD', () => {
         const args = buildUploadArgs({
             sourceDir: '/tmp/source',

src/app/api/deploy-marker/route.ts

@@ -1,6 +1,6 @@
 import { NextResponse } from 'next/server';
 
-const deployMarker = {"schema_version":1,"local_sha":"17eadccc647ef019723113dc6cc21af600da3dcd","created_at":"2026-07-20T07:05:18.467Z","deploy_id":"8d1b7635-85e0-4e04-af0c-e1a37b53c0a4"} as const;
+const deployMarker = {"schema_version":1,"local_sha":"444b7abc99f5bfa03760ceefb2beb0d790f0aba9","created_at":"2026-07-20T08:14:53.507Z","deploy_id":"a25ce1ac-a4d0-4982-bc6d-796a92ff195f"} as const;
 
 export const dynamic = 'force-dynamic';