Deploy 36a4274 to Docker Space

README.md

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

docs/deployment/huggingface-space-free.md

@@ -1,6 +1,6 @@
 # Hugging Face Space 部署
 
-本文档描述如何把本项目部署到 Hugging Face Docker Space，用作公网图片生成服务。Docker Space 的创建和更新权限取决于 Hugging Face 的当前账户政策；当前账户若在 `hf upload` 阶段收到 Docker Space 创建接口的 `402`，部署脚本只会对已存在且可认证写入的固定 Space 回退到 Git 推送，不能绕过新建 Docker Space 的账户限制。
+本文档描述如何把本项目部署到 Hugging Face Docker Space，用作公网图片生成服务。Docker Space 的创建和更新权限取决于 Hugging Face 的当前账户政策；固定目标已存在且元数据标识为 Docker，部署脚本会直接使用认证 Git 推送，避免 `hf upload` 触发创建接口的已知 `402`。这不绕过新建 Docker Space 的账户限制。
 
 ## 目标形态
 
@@ -81,7 +81,7 @@ npm run agent:doctor
 - `doctor`：统一诊断入口，默认包含 HF Space 只读远端检查。
 - `verify`：提交前基线，执行测试、lint、脚本语法、构建和 `git diff --check`；需要真实 PostgreSQL gate 时加 `--postgres`。
 - `deploy:local`：重建本地 Docker 服务并探测真实 HTTP 端点；加 `--memory` 会断言 memory/indexeddb overlay 生效。
-- `deploy:space`：上传当前干净 git HEAD 到固定 HF Space，并做只读公网验证；已存在 Docker Space 遇到已知创建政策 `402` 时，会使用认证 Git 推送回退。
+- `deploy:space`：上传当前干净 git HEAD 到固定 HF Space，并做只读公网验证；已存在 Docker Space 根据远端元数据直接使用认证 Git 推送，其他类型才优先尝试 `hf upload`。
 - `agent:doctor`：通过仓库 Skill 脚本执行只读 Agent API 契约检查，不触发真实生图。
 
 HF Space 交互使用官方 `hf` CLI。不要维护本机 access 文件，不要把 `APP_PASSWORD`、`AGENT_API_TOKEN`、OpenAI Key 或 Hugging Face token 写入仓库文件。
@@ -97,8 +97,8 @@ 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 元数据；当前固定 Docker Space 直接克隆、同步已跟踪源码并使用认证 Git 推送。
+- 非 Docker Space 才优先使用 `hf upload`；仅当它命中既有 Docker Space 创建政策 `402` 时才回退到认证 Git 推送，其他错误不会自动回退。
 - 等待新 Space commit 进入 `RUNNING`。
 - 检查 `/api/auth-status`、`/api/agent/capabilities` 和 `/api/runtime-capabilities`，不触发真实生图。
 

public/hf-space-deploy-marker.json

@@ -1,6 +1,6 @@
 {
   "schema_version": 1,
-  "local_sha": "444b7abc99f5bfa03760ceefb2beb0d790f0aba9",
-  "created_at": "2026-07-20T08:14:53.507Z",
-  "deploy_id": "a25ce1ac-a4d0-4982-bc6d-796a92ff195f"
+  "local_sha": "36a4274a16b48a50059a1a47e8711352c09c479a",
+  "created_at": "2026-07-20T08:55:43.290Z",
+  "deploy_id": "f19889c7-48c8-4069-8dd0-cae4ae827d8f"
 }

scripts/deploy-hf-space.mjs

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
-
+import { fetchJsonWithTimeout, parseJsonPayload, runCommandStrict } from './command-center-utils.mjs';
+import { assertKnownOptions, HF_SPACE_ID, HF_SPACE_URL, isMainModule } from './hf-space-doctor-utils.mjs';
 import { spawnSync } from 'node:child_process';
 import { randomUUID } from 'node:crypto';
 import { cpSync, mkdirSync, mkdtempSync, readdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
@@ -7,9 +8,6 @@ import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 import { setTimeout as delay } from 'node:timers/promises';
 
-import { fetchJsonWithTimeout, parseJsonPayload, runCommandStrict } from './command-center-utils.mjs';
-import { assertKnownOptions, HF_SPACE_ID, HF_SPACE_URL, isMainModule } from './hf-space-doctor-utils.mjs';
-
 const STATUS_POLL_ATTEMPTS = 40;
 const STATUS_POLL_INTERVAL_MS = 10_000;
 const PUBLIC_ENDPOINT_TIMEOUT_MS = 10_000;
@@ -34,10 +32,11 @@ function printHelp() {
     console.log(`Usage:
   npm run deploy:hf-space
 
-Deploys the current clean git HEAD to ${HF_SPACE_ID} with the official hf CLI.
+Deploys the current clean git HEAD to ${HF_SPACE_ID}.
 
-The script uploads a temporary git archive, waits for the Space to run the new
-Space commit, and performs read-only public endpoint checks.`);
+Existing Docker Spaces use an authenticated Git push. Other Space types try the
+official hf CLI first. The script waits for the Space to run the new commit and
+performs read-only public endpoint checks.`);
 }
 
 function runText(command, args, options = {}) {
@@ -93,7 +92,9 @@ export function isSpaceDeployPath(filePath) {
     const normalized = String(filePath || '')
         .replaceAll('\\', '/')
         .replace(/^\.\//, '');
-    return normalized.length > 0 && !SPACE_DEPLOY_EXCLUDED_PATH_PREFIXES.some((prefix) => normalized.startsWith(prefix));
+    return (
+        normalized.length > 0 && !SPACE_DEPLOY_EXCLUDED_PATH_PREFIXES.some((prefix) => normalized.startsWith(prefix))
+    );
 }
 
 export function rewriteSpaceReadmeImageSources(readme, repoSlug, localSha) {
@@ -112,7 +113,11 @@ function prepareSourceTree(repoSlug, localSha) {
     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');
+    writeFileSync(
+        readmePath,
+        rewriteSpaceReadmeImageSources(readFileSync(readmePath, 'utf8'), repoSlug, localSha),
+        'utf8'
+    );
     return sourceDir;
 }
 
@@ -137,6 +142,10 @@ export function isHfUploadExistingSpacePolicyError(error) {
     );
 }
 
+export function shouldUseGitPushForSpace(spaceInfo) {
+    return spaceInfo?.sdk === 'docker';
+}
+
 export function buildUploadArgs({ sourceDir, localSha, repoSlug, deletePaths = [] }) {
     if (!repoSlug?.trim()) throw new Error('REPO_SLUG is required for deploy metadata.');
     const args = [
@@ -166,9 +175,10 @@ function readLocalGitFiles() {
     return new Set(output.split('\0').filter(isSpaceDeployPath));
 }
 
-function readRemoteFilePaths() {
-    const info = readSpaceInfo();
-    return (info.siblings || []).map((sibling) => sibling.rfilename).filter((filename) => typeof filename === 'string' && filename.length > 0);
+function readRemoteFilePaths(info) {
+    return (info.siblings || [])
+        .map((sibling) => sibling.rfilename)
+        .filter((filename) => typeof filename === 'string' && filename.length > 0);
 }
 
 export function findRemoteDeletePaths(localFiles, remoteFiles) {
@@ -190,15 +200,22 @@ export function buildDeployMarker(localSha, createdAt = new Date(), deployId = r
 
 export function assertDeployMarkerMatches(marker, expectedMarker) {
     if (!marker || typeof marker !== 'object') throw new Error('deploy marker response was not an object.');
-    if (marker?.schema_version !== expectedMarker.schema_version) throw new Error('deploy marker schema_version mismatch.');
+    if (marker?.schema_version !== expectedMarker.schema_version)
+        throw new Error('deploy marker schema_version mismatch.');
     if (marker.local_sha !== expectedMarker.local_sha) {
-        throw new Error(`deploy marker local_sha mismatch: expected ${expectedMarker.local_sha}, received ${marker.local_sha || 'missing'}.`);
+        throw new Error(
+            `deploy marker local_sha mismatch: expected ${expectedMarker.local_sha}, received ${marker.local_sha || 'missing'}.`
+        );
     }
     if (marker.created_at !== expectedMarker.created_at) {
-        throw new Error(`deploy marker created_at mismatch: expected ${expectedMarker.created_at}, received ${marker.created_at || 'missing'}.`);
+        throw new Error(
+            `deploy marker created_at mismatch: expected ${expectedMarker.created_at}, received ${marker.created_at || 'missing'}.`
+        );
     }
     if (marker.deploy_id !== expectedMarker.deploy_id) {
-        throw new Error(`deploy marker deploy_id mismatch: expected ${expectedMarker.deploy_id}, received ${marker.deploy_id || 'missing'}.`);
+        throw new Error(
+            `deploy marker deploy_id mismatch: expected ${expectedMarker.deploy_id}, received ${marker.deploy_id || 'missing'}.`
+        );
     }
     return marker;
 }
@@ -239,7 +256,15 @@ function readLocalGitFilesWithDeployMarker() {
 
 function uploadSourceTree(sourceDir, deployMarker, repoSlug) {
     writeDeployMarker(sourceDir, deployMarker);
-    const deletePaths = findRemoteDeletePaths(readLocalGitFilesWithDeployMarker(), readRemoteFilePaths());
+    const remoteSpace = readSpaceInfo();
+    const deletePaths = findRemoteDeletePaths(readLocalGitFilesWithDeployMarker(), readRemoteFilePaths(remoteSpace));
+    if (shouldUseGitPushForSpace(remoteSpace)) {
+        console.log('Deploying the existing Docker Space via an authenticated Git push.');
+        return {
+            spaceCommitSha: uploadSourceTreeWithGit(sourceDir, deployMarker),
+            transport: 'git_push_existing_docker_space'
+        };
+    }
     try {
         const output = runText(
             'hf',
@@ -411,7 +436,9 @@ async function main() {
 
 if (isMainModule(import.meta.url, process.argv[1])) {
     main().catch((error) => {
-        console.error(JSON.stringify({ ok: false, error: error instanceof Error ? error.message : String(error) }, null, 2));
+        console.error(
+            JSON.stringify({ ok: false, error: error instanceof Error ? error.message : String(error) }, null, 2)
+        );
         process.exit(1);
     });
 }

scripts/deploy-hf-space.test.mjs

@@ -1,6 +1,3 @@
-import assert from 'node:assert/strict';
-import { describe, it } from 'node:test';
-
 import {
     GIT_ARCHIVE_MAX_BUFFER_BYTES,
     assertDeployMarkerMatches,
@@ -8,6 +5,7 @@ import {
     buildDeployMarkerRouteSource,
     isSpaceDeployPath,
     isHfUploadExistingSpacePolicyError,
+    shouldUseGitPushForSpace,
     buildUploadArgs,
     extractUploadCommitSha,
     findRemoteDeletePaths,
@@ -15,6 +13,8 @@ import {
     rewriteSpaceReadmeImageSources,
     waitForRunning
 } from './deploy-hf-space.mjs';
+import assert from 'node:assert/strict';
+import { describe, it } from 'node:test';
 
 describe('HF Space deploy script', () => {
     it('recognizes the existing Docker Space create-policy error for the Git deployment fallback', () => {
@@ -25,8 +25,24 @@ describe('HF Space deploy script', () => {
         ].join('\n');
 
         assert.equal(isHfUploadExistingSpacePolicyError(policyError), true);
-        assert.equal(isHfUploadExistingSpacePolicyError("Client error '402 Payment Required' for url 'https://huggingface.co/api/models/create'"), false);
-        assert.equal(isHfUploadExistingSpacePolicyError("Client error '401 Unauthorized' for url 'https://huggingface.co/api/repos/create'"), false);
+        assert.equal(
+            isHfUploadExistingSpacePolicyError(
+                "Client error '402 Payment Required' for url 'https://huggingface.co/api/models/create'"
+            ),
+            false
+        );
+        assert.equal(
+            isHfUploadExistingSpacePolicyError(
+                "Client error '401 Unauthorized' for url 'https://huggingface.co/api/repos/create'"
+            ),
+            false
+        );
+    });
+
+    it('uses Git directly for an existing Docker Space', () => {
+        assert.equal(shouldUseGitPushForSpace({ sdk: 'docker' }), true);
+        assert.equal(shouldUseGitPushForSpace({ sdk: 'gradio' }), false);
+        assert.equal(shouldUseGitPushForSpace({}), false);
     });
 
     it('extracts the Space commit SHA from hf upload JSON output', () => {
@@ -41,7 +57,10 @@ describe('HF Space deploy script', () => {
     });
 
     it('rejects upload output without a Space commit URL', () => {
-        assert.throws(() => extractUploadCommitSha('{"url":"https://huggingface.co/spaces/misonL/demo"}'), /commit SHA or commit URL/);
+        assert.throws(
+            () => extractUploadCommitSha('{"url":"https://huggingface.co/spaces/misonL/demo"}'),
+            /commit SHA or commit URL/
+        );
     });
 
     it('extracts the Space commit SHA from direct hf upload JSON fields', () => {
@@ -80,7 +99,10 @@ describe('HF Space deploy script', () => {
             args[args.indexOf('--commit-description') + 1],
             'Source: MisonL/gpt-image-playground-customer@bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb'
         );
-        assert.equal(args.some((arg) => arg.includes('\n')), false);
+        assert.equal(
+            args.some((arg) => arg.includes('\n')),
+            false
+        );
     });
 
     it('uses a provided repository slug in upload commit metadata', () => {
@@ -90,12 +112,21 @@ describe('HF Space deploy script', () => {
             repoSlug: 'owner/repo'
         });
 
-        assert.equal(args[args.indexOf('--commit-description') + 1], 'Source: owner/repo@eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee');
+        assert.equal(
+            args[args.indexOf('--commit-description') + 1],
+            'Source: owner/repo@eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee'
+        );
     });
 
     it('parses GitHub repository slugs from common origin URL formats', () => {
-        assert.equal(parseRepositorySlug('https://github.com/MisonL/gpt-image-playground-customer.git'), 'MisonL/gpt-image-playground-customer');
-        assert.equal(parseRepositorySlug('git@github.com:MisonL/gpt-image-playground-customer.git'), 'MisonL/gpt-image-playground-customer');
+        assert.equal(
+            parseRepositorySlug('https://github.com/MisonL/gpt-image-playground-customer.git'),
+            'MisonL/gpt-image-playground-customer'
+        );
+        assert.equal(
+            parseRepositorySlug('git@github.com:MisonL/gpt-image-playground-customer.git'),
+            'MisonL/gpt-image-playground-customer'
+        );
         assert.throws(() => parseRepositorySlug('not-a-github-url'), /Set REPO_SLUG=owner\/repo/);
     });
 
@@ -179,8 +210,14 @@ describe('HF Space deploy script', () => {
     });
 
     it('builds a unique deploy marker id when none is provided', () => {
-        const first = buildDeployMarker('3333333333333333333333333333333333333333', new Date('2026-06-20T10:00:00.000Z'));
-        const second = buildDeployMarker('3333333333333333333333333333333333333333', new Date('2026-06-20T10:00:00.000Z'));
+        const first = buildDeployMarker(
+            '3333333333333333333333333333333333333333',
+            new Date('2026-06-20T10:00:00.000Z')
+        );
+        const second = buildDeployMarker(
+            '3333333333333333333333333333333333333333',
+            new Date('2026-06-20T10:00:00.000Z')
+        );
 
         assert.match(first.deploy_id, /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/);
         assert.notEqual(first.deploy_id, second.deploy_id);
@@ -283,12 +320,10 @@ describe('HF Space deploy script', () => {
 
     it('keeps the generated deploy markers from being deleted on upload', () => {
         assert.deepEqual(
-            findRemoteDeletePaths(new Set(['README.md', 'public/hf-space-deploy-marker.json', 'src/app/api/deploy-marker/route.ts']), [
-                'README.md',
-                'public/hf-space-deploy-marker.json',
-                'src/app/api/deploy-marker/route.ts',
-                'old.md'
-            ]),
+            findRemoteDeletePaths(
+                new Set(['README.md', 'public/hf-space-deploy-marker.json', 'src/app/api/deploy-marker/route.ts']),
+                ['README.md', 'public/hf-space-deploy-marker.json', 'src/app/api/deploy-marker/route.ts', 'old.md']
+            ),
             ['old.md']
         );
     });

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

@@ -1,6 +1,6 @@
 import { NextResponse } from 'next/server';
 
-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;
+const deployMarker = {"schema_version":1,"local_sha":"36a4274a16b48a50059a1a47e8711352c09c479a","created_at":"2026-07-20T08:55:43.290Z","deploy_id":"f19889c7-48c8-4069-8dd0-cae4ae827d8f"} as const;
 
 export const dynamic = 'force-dynamic';