free-short-video 5.3.1 → 5.5.0

package/README.md

@@ -23,6 +23,10 @@ free-short-video
 [![Docker Hub](https://img.shields.io/docker/pulls/lcy362/free-short-video?label=docker%20pulls)](https://hub.docker.com/r/lcy362/free-short-video)
 [![npm](https://img.shields.io/npm/v/free-short-video?label=npm)](https://www.npmjs.com/package/free-short-video)
 
+> **🌏 Mirror Notice / 镜像说明**
+> This project is also mirrored on [Gitee](https://gitee.com/sandgrid/agnes-video-generator) for faster access in mainland China. The **GitHub repository is the primary home** of this project — issues, PRs, and stars are managed there.
+> 本项目在国内 Gitee 设有镜像仓库，便于国内访问加速；**GitHub 为项目主仓库**，Issue / PR / Star 均在 GitHub 提交。
+
 > **Completely free AI video generator** — Built on Agnes AI's free models, no subscription, no high-end GPU, no usage limits. Type in a text idea and automatically generate multi-scene AI videos with narration and subtitles. Supports text-to-video, image-to-video, keyframes animation, digital anchor, and more. All AI compute runs in the cloud — a regular laptop is all you need. **[Try it online →](https://video.lichuanyang.top)**
 
 > "The solution is not to suppress AI, but to make it a more equitable capability, so that everyone knows how to create more with AI. This is a very important vision for our company — to make world-class AI belong to everyone. What we can do may be insignificant, but this vision is very long-term and enduring."

package/bin/cli.js

@@ -204,9 +204,13 @@ process.on('SIGINT', () => shutdown('SIGINT'));
 process.on('SIGTERM', () => shutdown('SIGTERM'));
 
 // ── auto-open browser ─────────────────────────────────────────────────────
+// 轮询等待服务就绪（HTTP 200）后再打开浏览器，避免启动初期闪现"无法访问"
 if (openBrowser) {
+  const http = require('http');
   const url = `http://${host === '0.0.0.0' ? '127.0.0.1' : host}:${port}`;
-  setTimeout(() => {
+  let attempts = 0;
+
+  const openBrowserNow = () => {
     try {
       if (process.platform === 'darwin') execSync(`open "${url}"`);
       else if (process.platform === 'win32') execSync(`start "" "${url}"`);
@@ -214,5 +218,25 @@ if (openBrowser) {
     } catch (_) {
       /* browser open is best-effort */
     }
-  }, 1500);
+  };
+
+  const scheduleNext = () => {
+    if (++attempts > 120) return; // 约 60s 上限，超时不再尝试
+    setTimeout(pollReady, 500);
+  };
+
+  const pollReady = () => {
+    const req = http.get(url, (res) => {
+      res.resume();
+      if (res.statusCode >= 200 && res.statusCode < 500) openBrowserNow();
+      else scheduleNext();
+    });
+    req.setTimeout(2000, () => {
+      req.destroy();
+      scheduleNext();
+    });
+    req.on('error', scheduleNext);
+  };
+
+  pollReady();
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "free-short-video",
-  "version": "5.3.1",
+  "version": "5.5.0",
   "description": "Free AI short-video generator — run the full free-short-video service locally with one command. Text-to-video, image generation, Edge-TTS narration, subtitles, and compositing, all free. Official site: https://video.lichuanyang.top",
   "bin": {
     "free-short-video": "bin/cli.js",

package/server.py

@@ -21,7 +21,8 @@ import logging
 import os
 from contextlib import asynccontextmanager
 
-from fastapi import FastAPI
+from fastapi import FastAPI, HTTPException
+from fastapi.responses import FileResponse
 from fastapi.staticfiles import StaticFiles
 
 from core.audio.voices import load_voice_catalog
@@ -51,10 +52,24 @@ async def lifespan(app: FastAPI):
     # 初始化工作目录 / uploads / 错误收集根路径，并重置上次异常退出的遗留任务
     init_runtime_state()
 
-    # v4.0: 预加载音色目录（edge_tts.list_voices），失败不阻断启动
+    # v4.0: 预加载音色目录（edge_tts.list_voices）。
+    # edge_tts.list_voices() 是网络调用，若网络慢/不可达会阻塞 lifespan 的 yield，
+    # 导致服务启动后数秒内不可用。这里限时等待 3 秒：
+    # - 正常网络（1~2s）：目录在对外服务前就绪，/api/voices 无回退闪烁
+    # - 慢网络：超过 3s 立即对外服务，剩余加载转入后台，完成后自动切换完整目录
+    async def _load_voice_catalog_bg():
+        try:
+            await load_voice_catalog()
+            logger.info("[Startup] Voice catalog loaded")
+        except Exception as e:
+            logger.warning(f"[Startup] Voice catalog load failed ({e}); will use fallback")
+
     try:
-        await load_voice_catalog()
+        await asyncio.wait_for(load_voice_catalog(), timeout=3.0)
         logger.info("[Startup] Voice catalog loaded")
+    except asyncio.TimeoutError:
+        logger.warning("[Startup] Voice catalog load timed out (>3s); continuing in background")
+        asyncio.create_task(_load_voice_catalog_bg())
     except Exception as e:
         logger.warning(f"[Startup] Voice catalog load failed ({e}); will use fallback")
 
@@ -77,7 +92,7 @@ app = FastAPI(
     description=(
         "完全免费的 AI 视频生成服务。官网：https://video.lichuanyang.top ｜ "
         "API 文档：https://video.lichuanyang.top/api-docs ｜ "
-        "调用指南：https://video.lichuanyang.top/guides/api-call"
+        "调用指南：https://video.lichuanyang.top/api-docs"
     ),
     lifespan=lifespan,
 )
@@ -92,6 +107,27 @@ if os.path.exists(static_dir):
     app.mount("/static", StaticFiles(directory=static_dir), name="static")
 
 
+def _serve_static_file(filename: str, media_type: str):
+    """返回 static 目录中的文件；不存在时 404（与挂载目录行为一致）。"""
+    path = os.path.join(static_dir, filename)
+    if os.path.exists(path):
+        return FileResponse(path, media_type=media_type)
+    raise HTTPException(status_code=404, detail=f"{filename} not found")
+
+
+# 根路径图标：HTML 虽声明 /static/favicon.ico，但 Safari 等客户端
+# 仍会额外探测根路径 /favicon.ico（及 /icon.png），无路由时每次打开页面
+# 产生一次短暂 404，这里显式补上。
+@app.get("/favicon.ico", include_in_schema=False)
+async def favicon():
+    return _serve_static_file("favicon.ico", "image/x-icon")
+
+
+@app.get("/icon.png", include_in_schema=False)
+async def icon():
+    return _serve_static_file("icon.png", "image/png")
+
+
 # ═══════════════════════════════════════════════════
 # 路由汇总（Batch 1 拆分）
 # ═══════════════════════════════════════════════════