@ian2018cs/agenthub 0.1.11 → 0.1.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ian2018cs/agenthub",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "description": "A web-based UI for AI Agents",
   "type": "module",
   "main": "server/index.js",

package/server/builtin-skills/html-deploy/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: html-deploy
+description: 将 HTML 内容部署为可访问的网页。使用场景：(1) 用户要求将生成的 HTML/网页部署上线或发布，(2) 用户要求更新已部署的页面内容，(3) 用户要求删除已部署的页面，(4) 用户提到"部署"、"发布"、"上线"HTML 页面，(5) 用户要求预览生成的网页效果。
+---
+
+# HTML Deploy
+
+将 HTML 内容部署到远程服务，生成可访问的 URL。
+
+## 使用流程
+
+1. 根据用户需求生成完整的 HTML 页面，写入文件
+2. 调用脚本部署、更新或删除，传入相应参数
+3. 将结果告知用户
+
+### 部署新页面
+
+```bash
+python3 skills/html-deploy/scripts/deploy.py <html_file>
+```
+
+### 更新已有页面
+
+从之前的部署 URL 中提取 page_id（UUID 部分）：
+
+```bash
+python3 skills/html-deploy/scripts/update.py <page_id> <html_file>
+```
+
+page_id 不存在时会报 404 错误。
+
+### 删除已有页面
+
+从之前的部署 URL 中提取 page_id（UUID 部分）：
+
+```bash
+python3 skills/html-deploy/scripts/delete.py <page_id>
+```
+
+page_id 不存在时会报 404 错误。

package/server/builtin-skills/html-deploy/scripts/delete.py

@@ -0,0 +1,31 @@
+#!/usr/bin/env python3
+"""删除已部署的页面。
+
+用法: delete.py <page_id>
+输出: 删除结果
+"""
+import sys
+import json
+import urllib.request
+
+API_BASE = "http://10.0.0.252:11004"
+
+
+def main():
+    if len(sys.argv) != 2:
+        print(f"用法: {sys.argv[0]} <page_id>", file=sys.stderr)
+        sys.exit(1)
+
+    page_id = sys.argv[1]
+    req = urllib.request.Request(
+        f"{API_BASE}/deploy/{page_id}",
+        method="DELETE",
+    )
+
+    with urllib.request.urlopen(req) as resp:
+        result = json.loads(resp.read())
+        print(result["detail"])
+
+
+if __name__ == "__main__":
+    main()

package/server/builtin-skills/html-deploy/scripts/deploy.py

@@ -0,0 +1,36 @@
+#!/usr/bin/env python3
+"""部署 HTML 文件为网页。
+
+用法: deploy.py <html_file>
+输出: 部署成功后的访问 URL
+"""
+import sys
+import json
+import urllib.request
+
+API_BASE = "http://10.0.0.252:11004"
+
+
+def main():
+    if len(sys.argv) != 2:
+        print(f"用法: {sys.argv[0]} <html_file>", file=sys.stderr)
+        sys.exit(1)
+
+    with open(sys.argv[1], "r", encoding="utf-8") as f:
+        html = f.read()
+
+    data = json.dumps({"html": html}).encode("utf-8")
+    req = urllib.request.Request(
+        f"{API_BASE}/deploy",
+        data=data,
+        headers={"Content-Type": "application/json"},
+        method="POST",
+    )
+
+    with urllib.request.urlopen(req) as resp:
+        result = json.loads(resp.read())
+        print(result["url"])
+
+
+if __name__ == "__main__":
+    main()

package/server/builtin-skills/html-deploy/scripts/update.py

@@ -0,0 +1,38 @@
+#!/usr/bin/env python3
+"""更新已部署的页面内容。
+
+用法: update.py <page_id> <html_file>
+输出: 更新成功后的访问 URL
+"""
+import sys
+import json
+import urllib.request
+
+API_BASE = "http://10.0.0.252:11004"
+
+
+def main():
+    if len(sys.argv) != 3:
+        print(f"用法: {sys.argv[0]} <page_id> <html_file>", file=sys.stderr)
+        sys.exit(1)
+
+    page_id = sys.argv[1]
+
+    with open(sys.argv[2], "r", encoding="utf-8") as f:
+        html = f.read()
+
+    data = json.dumps({"html": html}).encode("utf-8")
+    req = urllib.request.Request(
+        f"{API_BASE}/deploy/{page_id}",
+        data=data,
+        headers={"Content-Type": "application/json"},
+        method="PUT",
+    )
+
+    with urllib.request.urlopen(req) as resp:
+        result = json.loads(resp.read())
+        print(result["url"])
+
+
+if __name__ == "__main__":
+    main()

package/server/routes/auth.js

@@ -4,6 +4,7 @@ import { v4 as uuidv4 } from 'uuid';
 import { userDb, verificationDb, domainWhitelistDb, usageDb } from '../database/db.js';
 import { generateToken, authenticateToken } from '../middleware/auth.js';
 import { initUserDirectories } from '../services/user-directories.js';
+import { initBuiltinSkills } from '../services/builtin-skills.js';
 import { sendVerificationCode, isSmtpConfigured } from '../services/email.js';
 
 const router = express.Router();
@@ -115,6 +116,9 @@ router.post('/verify-code', async (req, res) => {
 
       // Initialize user directories
       await initUserDirectories(uuid);
+    } else {
+      // Sync built-in skills for existing user (clean up dangling + add new)
+      await initBuiltinSkills(user.uuid);
     }
 
     // Check if user is disabled

package/server/services/builtin-skills.js

@@ -95,12 +95,47 @@ export async function saveBuiltinSkillsState(userUuid, state) {
 /**
  * Initialize built-in skills for a user
  * Creates symlinks for all built-in skills not in user's removed list
+ * Also cleans up dangling symlinks from deleted built-in skills
  */
 export async function initBuiltinSkills(userUuid) {
   const userPaths = getUserPaths(userUuid);
   const builtinSkills = await getBuiltinSkills();
   const state = await loadBuiltinSkillsState(userUuid);
+  // Clean up dangling symlinks pointing to removed built-in skills
+  try {
+    const entries = await fs.readdir(userPaths.skillsDir, { withFileTypes: true });
+    for (const entry of entries) {
+      const entryPath = path.join(userPaths.skillsDir, entry.name);
+      try {
+        const stat = await fs.lstat(entryPath);
+        if (!stat.isSymbolicLink()) continue;
+
+        const target = await fs.readlink(entryPath);
+        const realBuiltinDir = await fs.realpath(BUILTIN_SKILLS_DIR);
+        const resolvedTarget = path.resolve(path.dirname(entryPath), target);
+
+        // Only clean up symlinks that point into builtin-skills directory
+        if (!resolvedTarget.startsWith(realBuiltinDir)) continue;
+
+        // Check if the symlink target still exists
+        try {
+          await fs.access(resolvedTarget);
+        } catch {
+          // Target no longer exists, remove the dangling symlink
+          await fs.unlink(entryPath);
+          console.log(`Removed dangling builtin skill symlink: ${entry.name}`);
+        }
+      } catch (err) {
+        // Ignore errors on individual entries
+      }
+    }
+  } catch (err) {
+    if (err.code !== 'ENOENT') {
+      console.error('Error cleaning up builtin skill symlinks:', err);
+    }
+  }
 
+  // Create symlinks for new built-in skills
   for (const skill of builtinSkills) {
     // Skip if user has explicitly removed this skill
     if (state.removedSkills.includes(skill.name)) {

package/server/builtin-skills/deploy-frontend/SKILL.md

@@ -1,298 +0,0 @@
----
-name: deploy-frontend
-description: 将生成的 HTML 或前端页面部署到 Docker nginx 容器。用于快速部署和预览前端项目，自动配置端口隔离，返回可访问的内网 URL。使用场景：(1) 部署刚生成的 HTML/React/Vue 等前端项目 (2) 需要让用户通过浏览器查看前端页面 (3) 需要为不同项目分配独立的访问端口 (4) 清理或列出已部署的项目
----
-
-# Deploy Frontend
-
-将前端项目部署到共享的 nginx Docker 容器，通过不同端口和配置文件实现项目隔离。
-
-## 快速开始
-
-```bash
-# 1. 确保你有一个包含 index.html 的目录
-mkdir my-project
-echo "<h1>Hello World</h1>" > my-project/index.html
-
-# 2. 使用 python3 部署（注意：是目录，不是文件）
-python3 /path/to/deploy-frontend/scripts/deploy.py my-project
-
-# 3. 访问输出的 URL，例如 http://10.0.1.133:8080
-```
-
-## 常见错误
-
-| 错误 | 原因 | 解决方案 |
-|------|------|----------|
-| `python: command not found` | 使用了 `python` 而不是 `python3` | 使用 `python3` 命令 |
-| `NotADirectoryError` | 传入了单个文件而不是目录 | 传入包含 index.html 的目录路径 |
-| `404 Not Found` | 主文件不叫 index.html | 将主 HTML 文件重命名为 index.html |
-| 本地能访问，其他设备不能 | IP 地址或网络问题 | 使用内网 IP，检查防火墙 |
-
-## 配置
-
-默认 nginx 目录已配置为：`/home/xubuntu001/AI/nginx`
-
-如需修改，编辑脚本文件中的 `DEFAULT_NGINX_BASE_DIR` 变量：
-- `scripts/deploy.py` 第 14 行
-- `scripts/cleanup.py` 第 10 行
-
-## 工作原理
-
-- **单容器架构**：所有项目共享一个 nginx 容器（节省资源）
-- **配置隔离**：每个项目在 `config/conf.d/` 下有独立的 `.conf` 文件
-- **端口隔离**：自动分配不同端口（从 8080 开始递增）
-- **目录隔离**：每个项目的文件存放在 `html/project-{timestamp}/`
-
-## 部署前端项目
-
-使用 `scripts/deploy.py` 部署项目：
-
-```bash
-python3 scripts/deploy.py <前端项目目录>
-```
-
-**重要说明：**
-- 必须使用 `python3` 命令（不是 `python`）
-- `<前端项目目录>`：必须是一个**目录**（不能是单个文件）
-- 目录中必须包含 `index.html` 作为入口文件（nginx 默认查找 index.html）
-- 如果你的 HTML 文件不叫 `index.html`，需要先重命名
-
-**参数说明：**
-- `<前端项目目录>`：包含 index.html 等前端文件的目录（必需）
-
-默认使用 `/home/xubuntu001/AI/nginx` 作为 nginx 基础目录，无需额外指定。
-
-**脚本执行流程：**
-1. 生成唯一的项目 ID（project-{timestamp}）
-2. 查找可用端口（从 8080 开始）
-3. 复制前端文件到 `html/{project_id}/`
-4. 在 `config/conf.d/` 创建 nginx 配置文件
-5. 重新加载 nginx（如果容器未运行则启动）
-6. 返回访问 URL（内网IP:端口）
-7. 保存部署信息到 `deployments/{project_id}.json`
-
-**示例：**
-```bash
-# 部署前端项目（使用默认 nginx 目录）
-python3 .claude/skills/deploy-frontend/scripts/deploy.py ./my-frontend-app
-
-# 错误示例 - 不要这样做：
-# python3 deploy.py ./my-app/index.html  ❌ 不能传单个文件
-# python deploy.py ./my-app              ❌ 必须使用 python3
-
-# 正确示例：
-# python3 deploy.py ./my-app             ✅ 传目录，使用 python3
-```
-
-**输出示例：**
-```
-✅ 部署成功!
-项目 ID: project-1738151234
-端口: 8080
-访问地址: http://192.168.1.100:8080
-HTML 目录: /path/to/nginx/html/project-1738151234
-配置文件: /path/to/nginx/config/conf.d/project-1738151234.conf
-```
-
-## 管理部署
-
-使用 `scripts/cleanup.py` 管理已部署的项目。
-
-### 列出所有部署
-
-```bash
-python3 scripts/cleanup.py list
-```
-
-### 清理指定项目
-
-```bash
-python3 scripts/cleanup.py <project_id>
-```
-
-会删除：
-- HTML 目录
-- nginx 配置文件
-- 部署信息文件
-
-并重新加载 nginx 配置。
-
-### 清理所有项目
-
-```bash
-python3 scripts/cleanup.py all
-```
-
-## 目录结构
-
-部署后的 nginx 基础目录结构：
-
-```
-nginx-base/
-├── docker-compose.yml          # nginx 容器配置
-├── html/                       # 前端文件
-│   ├── project-1738151234/    # 项目1
-│   │   ├── index.html
-│   │   └── ...
-│   └── project-1738151456/    # 项目2
-│       ├── index.html
-│       └── ...
-├── config/
-│   └── conf.d/                # nginx 配置
-│       ├── project-1738151234.conf
-│       └── project-1738151456.conf
-├── logs/                      # nginx 日志
-└── deployments/               # 部署信息
-    ├── project-1738151234.json
-    └── project-1738151456.json
-```
-
-## 使用流程
-
-### 典型工作流
-
-1. **生成前端代码**：创建 HTML/React/Vue 项目
-2. **调用部署脚本**：
-   ```python
-   from pathlib import Path
-   import subprocess
-
-   result = subprocess.run([
-       "python3",  # 必须使用 python3
-       str(Path.home() / ".claude/skills/deploy-frontend/scripts/deploy.py"),
-       "./frontend-output"  # 必须是目录，不能是单个文件
-   ], capture_output=True, text=True)
-
-   print(result.stdout)
-   ```
-3. **提取访问 URL**：从输出中获取 URL 返回给用户
-4. **提醒用户访问**：告知用户可以通过浏览器访问该 URL
-
-### 在对话中使用
-
-当用户要求生成前端页面时：
-
-1. 生成前端代码（HTML/CSS/JS 等）
-2. 将文件写入目录（确保主文件命名为 index.html）
-3. 调用 deploy.py 部署
-4. 将访问 URL 返回给用户
-
-示例代码模式：
-```python
-# 1. 创建输出目录
-output_dir = Path("/tmp/frontend-{timestamp}")
-output_dir.mkdir(parents=True, exist_ok=True)
-
-# 2. 写入前端文件（重要：主文件必须命名为 index.html）
-(output_dir / "index.html").write_text(html_content)  # ✅ 使用 index.html
-(output_dir / "style.css").write_text(css_content)
-
-# 3. 部署（使用 python3，传目录而不是文件）
-deploy_script = Path.home() / ".claude/skills/deploy-frontend/scripts/deploy.py"
-result = subprocess.run(
-    ["python3", str(deploy_script), str(output_dir)],  # ✅ python3 + 目录路径
-    capture_output=True,
-    text=True
-)
-
-# 4. 提取 URL（从输出中解析）
-for line in result.stdout.split('\n'):
-    if line.startswith('访问地址:'):
-        url = line.split(':', 1)[1].strip()
-        print(f"您的前端页面已部署: {url}")
-```
-
-## 前置要求
-
-- Docker 和 docker-compose 已安装
-- nginx 基础目录位于 `/home/xubuntu001/AI/nginx`
-- docker-compose.yml 使用 `network_mode: host`
-- Python 3.6+
-
-## Docker 权限处理
-
-脚本已内置自动权限处理机制：
-
-1. **自动检测权限**：脚本会首先尝试直接运行 docker 命令
-2. **自动降级处理**：如果遇到权限错误，会自动使用 `sg docker -c` 运行
-3. **无需手动干预**：用户无需关心是否在 docker 组中
-
-**注意**：如果您刚刚被添加到 docker 组，可能需要重新登录或使用以下命令激活组权限：
-```bash
-newgrp docker
-```
-
-## 更新日志
-
-### v1.2 (2026-01-30)
-- ✅ 更新文档：明确必须使用 `python3` 而不是 `python`
-- ✅ 更新文档：强调必须传入目录而不是单个文件
-- ✅ 更新文档：说明主文件必须命名为 `index.html`
-- ✅ 添加常见错误示例和最佳实践
-- ✅ 新增部署后文件重命名的故障排查说明
-
-### v1.1 (2026-01-30)
-- ✅ 修复正则表达式转义警告
-- ✅ 添加自动 Docker 权限处理（`run_docker_command` 函数）
-- ✅ 使用 `docker compose` 替代旧版 `docker-compose` 命令
-- ✅ deploy.py 和 cleanup.py 都支持自动权限处理
-
-### v1.0
-- 初始版本：支持多项目部署和端口隔离
-
-## 故障排查
-
-**容器未启动**：脚本会自动执行 `docker compose up -d`
-
-**端口冲突**：脚本会自动查找可用端口（8080-8179 范围）
-
-**权限问题**：脚本会自动使用 `sg docker -c` 处理权限问题
-
-**找不到 python 命令**：
-```bash
-# 错误：python: command not found
-# 解决：使用 python3
-python3 scripts/deploy.py ./my-app
-```
-
-**传入单个文件报错**：
-```bash
-# 错误：NotADirectoryError
-# 原因：传入的是文件而不是目录
-# 解决：传入包含 index.html 的目录
-python3 scripts/deploy.py ./my-app/  # 正确
-# 而不是
-python3 scripts/deploy.py ./my-app/index.html  # 错误
-```
-
-**页面无法访问（404 Not Found）**：
-```bash
-# 检查是否存在 index.html
-ls /home/xubuntu001/AI/nginx/html/project-*/
-
-# 如果文件名不是 index.html，重命名它：
-cd /home/xubuntu001/AI/nginx/html/project-xxxxxxxxxx/
-mv yourfile.html index.html
-
-# 重新加载 nginx
-sg docker -c "docker exec nginx-web nginx -s reload"
-```
-
-**配置未生效**：手动重新加载 nginx：
-```bash
-docker exec nginx-web nginx -s reload
-# 或如果有权限问题：
-sg docker -c "docker exec nginx-web nginx -s reload"
-```
-
-**查看 nginx 日志**：
-```bash
-docker logs nginx-web
-```
-
-**本地能访问，其他设备访问不了**：
-- 检查防火墙设置
-- 确认设备在同一网络
-- 使用正确的内网 IP（不要用 localhost）
-- 确认路由器没有阻止端口

package/server/builtin-skills/deploy-frontend/scripts/cleanup.py

@@ -1,158 +0,0 @@
-#!/usr/bin/env python3
-"""
-清理部署的前端项目
-"""
-import subprocess
-import sys
-from pathlib import Path
-import shutil
-import json
-
-# 默认 nginx 基础目录（与 deploy.py 保持一致）
-DEFAULT_NGINX_BASE_DIR = "/home/xubuntu001/AI/nginx"
-
-def run_docker_command(cmd, **kwargs):
-    """
-    运行 docker 命令，自动处理权限问题
-
-    Args:
-        cmd: 命令列表
-        **kwargs: 传递给 subprocess.run 的其他参数
-
-    Returns:
-        subprocess.CompletedProcess 对象
-    """
-    try:
-        # 首先尝试直接运行
-        return subprocess.run(cmd, **kwargs)
-    except (subprocess.CalledProcessError, PermissionError) as e:
-        # 如果失败，尝试使用 sg docker -c 运行
-        if 'check' in kwargs:
-            del kwargs['check']  # sg 会处理 check
-
-        # 将命令转换为 sg docker -c 格式
-        cmd_str = ' '.join(str(arg) for arg in cmd)
-        sg_cmd = ['sg', 'docker', '-c', cmd_str]
-
-        return subprocess.run(sg_cmd, **kwargs)
-
-def cleanup_deployment(project_id, nginx_base_dir=None):
-    """
-    清理指定部署
-
-    Args:
-        project_id: 项目 ID
-        nginx_base_dir: nginx 基础目录，默认为 DEFAULT_NGINX_BASE_DIR
-    """
-    if nginx_base_dir is None:
-        nginx_base_dir = Path(DEFAULT_NGINX_BASE_DIR)
-    else:
-        nginx_base_dir = Path(nginx_base_dir)
-
-    deployments_dir = nginx_base_dir / "deployments"
-    info_file = deployments_dir / f"{project_id}.json"
-
-    if not info_file.exists():
-        print(f"❌ 项目不存在: {project_id}")
-        return False
-
-    try:
-        with open(info_file) as f:
-            info = json.load(f)
-
-        # 删除 HTML 目录
-        html_dir = Path(info['html_dir'])
-        if html_dir.exists():
-            print(f"删除 HTML 目录: {html_dir}")
-            shutil.rmtree(html_dir)
-
-        # 删除 nginx 配置文件
-        conf_file = Path(info['conf_file'])
-        if conf_file.exists():
-            print(f"删除配置文件: {conf_file}")
-            conf_file.unlink()
-
-        # 重新加载 nginx
-        print("重新加载 nginx 配置...")
-        run_docker_command(
-            ["docker", "exec", "nginx-web", "nginx", "-s", "reload"],
-            check=True
-        )
-
-        # 删除部署信息文件
-        info_file.unlink()
-
-        print(f"✅ 清理完成: {project_id}")
-        return True
-
-    except Exception as e:
-        print(f"❌ 清理失败: {e}")
-        import traceback
-        traceback.print_exc()
-        return False
-
-def list_deployments(nginx_base_dir=None):
-    """列出所有部署"""
-    if nginx_base_dir is None:
-        nginx_base_dir = Path(DEFAULT_NGINX_BASE_DIR)
-    else:
-        nginx_base_dir = Path(nginx_base_dir)
-
-    deployments_dir = nginx_base_dir / "deployments"
-
-    if not deployments_dir.exists() or not list(deployments_dir.glob("*.json")):
-        print("没有找到部署")
-        return
-
-    print("\n当前部署:")
-    print("-" * 80)
-
-    for info_file in sorted(deployments_dir.glob("*.json")):
-        with open(info_file) as f:
-            info = json.load(f)
-
-        print(f"项目 ID: {info['project_id']}")
-        print(f"  部署时间: {info.get('deployed_at', 'N/A')}")
-        print(f"  访问地址: {info['url']}")
-        print(f"  HTML 目录: {info['html_dir']}")
-        print()
-
-def cleanup_all(nginx_base_dir=None):
-    """清理所有部署"""
-    if nginx_base_dir is None:
-        nginx_base_dir = Path(DEFAULT_NGINX_BASE_DIR)
-    else:
-        nginx_base_dir = Path(nginx_base_dir)
-
-    deployments_dir = nginx_base_dir / "deployments"
-
-    if not deployments_dir.exists():
-        print("没有找到部署")
-        return
-
-    for info_file in deployments_dir.glob("*.json"):
-        project_id = info_file.stem
-        print(f"\n清理项目: {project_id}")
-        cleanup_deployment(project_id, nginx_base_dir)
-
-def main():
-    if len(sys.argv) < 2:
-        print("用法:")
-        print(f"  默认 nginx 目录: {DEFAULT_NGINX_BASE_DIR}")
-        print("  列出所有部署: python cleanup.py list [nginx基础目录]")
-        print("  清理指定项目: python cleanup.py <project_id> [nginx基础目录]")
-        print("  清理所有项目: python cleanup.py all [nginx基础目录]")
-        sys.exit(1)
-
-    command = sys.argv[1]
-    nginx_base_dir = sys.argv[2] if len(sys.argv) > 2 else None
-
-    if command == "list":
-        list_deployments(nginx_base_dir)
-    elif command == "all":
-        cleanup_all(nginx_base_dir)
-    else:
-        cleanup_deployment(command, nginx_base_dir)
-
-if __name__ == "__main__":
-    main()

package/server/builtin-skills/deploy-frontend/scripts/deploy.py

@@ -1,216 +0,0 @@
-#!/usr/bin/env python3
-"""
-部署前端项目到共享的 nginx 容器（通过 conf.d 配置隔离）
-"""
-import os
-import sys
-import subprocess
-import socket
-from pathlib import Path
-import shutil
-import json
-import time
-
-# 默认 nginx 基础目录（可在这里修改）
-DEFAULT_NGINX_BASE_DIR = "/home/xubuntu001/AI/nginx"
-
-def run_docker_command(cmd, **kwargs):
-    """
-    运行 docker 命令，自动处理权限问题
-
-    Args:
-        cmd: 命令列表
-        **kwargs: 传递给 subprocess.run 的其他参数
-
-    Returns:
-        subprocess.CompletedProcess 对象
-    """
-    try:
-        # 首先尝试直接运行
-        return subprocess.run(cmd, **kwargs)
-    except (subprocess.CalledProcessError, PermissionError) as e:
-        # 如果失败，尝试使用 sg docker -c 运行
-        if 'check' in kwargs:
-            del kwargs['check']  # sg 会处理 check
-
-        # 将命令转换为 sg docker -c 格式
-        cmd_str = ' '.join(str(arg) for arg in cmd)
-        sg_cmd = ['sg', 'docker', '-c', cmd_str]
-
-        return subprocess.run(sg_cmd, **kwargs)
-
-def find_available_port(start_port=8080, max_attempts=100):
-    """查找可用端口"""
-    for port in range(start_port, start_port + max_attempts):
-        try:
-            with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
-                s.bind(('', port))
-                return port
-        except OSError:
-            continue
-    raise RuntimeError(f"无法在 {start_port}-{start_port + max_attempts} 范围内找到可用端口")
-
-def get_local_ip():
-    """获取本机内网 IP"""
-    try:
-        s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
-        s.connect(("8.8.8.8", 80))
-        ip = s.getsockname()[0]
-        s.close()
-        return ip
-    except Exception:
-        return "localhost"
-
-def generate_project_id():
-    """生成项目 ID"""
-    return f"project-{int(time.time())}"
-
-def create_nginx_conf(project_id, port, nginx_base_dir):
-    """创建项目的 nginx 配置文件"""
-    config_content = f"""server {{
-    listen {port};
-    server_name localhost;
-
-    root /usr/share/nginx/html/{project_id};
-    index index.html index.htm;
-
-    location / {{
-        try_files $uri $uri/ /index.html;
-    }}
-
-    # 启用 gzip 压缩
-    gzip on;
-    gzip_types text/plain text/css application/json application/javascript text/xml application/xml text/javascript;
-
-    # 缓存静态资源
-    location ~* \\.(jpg|jpeg|png|gif|ico|css|js|svg|woff|woff2|ttf|eot)$ {{
-        expires 1y;
-        add_header Cache-Control "public, immutable";
-    }}
-}}
-"""
-    conf_dir = nginx_base_dir / "config" / "conf.d"
-    conf_dir.mkdir(parents=True, exist_ok=True)
-
-    conf_file = conf_dir / f"{project_id}.conf"
-    conf_file.write_text(config_content)
-    return conf_file
-
-def reload_nginx(nginx_base_dir):
-    """重新加载 nginx 配置"""
-    compose_file = nginx_base_dir / "docker-compose.yml"
-    if not compose_file.exists():
-        raise RuntimeError(f"docker-compose.yml 不存在: {compose_file}")
-
-    # 检查容器是否运行
-    result = run_docker_command(
-        ["docker", "ps", "--filter", "name=nginx-web", "--format", "{{.Names}}"],
-        capture_output=True,
-        text=True,
-        cwd=nginx_base_dir
-    )
-
-    if "nginx-web" not in result.stdout:
-        # 容器未运行，启动它
-        print("启动 nginx 容器...")
-        run_docker_command(
-            ["docker", "compose", "up", "-d"],
-            cwd=nginx_base_dir,
-            check=True
-        )
-    else:
-        # 重新加载配置
-        print("重新加载 nginx 配置...")
-        run_docker_command(
-            ["docker", "exec", "nginx-web", "nginx", "-s", "reload"],
-            check=True
-        )
-
-def deploy_frontend(source_dir, nginx_base_dir=None):
-    """
-    部署前端项目
-
-    Args:
-        source_dir: 源代码目录路径
-        nginx_base_dir: nginx docker-compose 所在目录，默认为 DEFAULT_NGINX_BASE_DIR
-
-    Returns:
-        dict: 包含部署信息的字典
-    """
-    source_path = Path(source_dir).resolve()
-    if not source_path.exists():
-        raise ValueError(f"源目录不存在: {source_dir}")
-
-    # 设置 nginx 基础目录
-    if nginx_base_dir is None:
-        nginx_base_dir = Path(DEFAULT_NGINX_BASE_DIR)
-    else:
-        nginx_base_dir = Path(nginx_base_dir).resolve()
-
-    # 生成项目信息
-    project_id = generate_project_id()
-
-    # 查找可用端口
-    port = find_available_port()
-
-    # 复制前端文件到 html/project-id/
-    html_dir = nginx_base_dir / "html" / project_id
-    if html_dir.exists():
-        shutil.rmtree(html_dir)
-    shutil.copytree(source_path, html_dir)
-
-    # 创建 nginx 配置
-    conf_file = create_nginx_conf(project_id, port, nginx_base_dir)
-
-    # 重新加载 nginx
-    reload_nginx(nginx_base_dir)
-
-    # 获取访问 URL
-    local_ip = get_local_ip()
-    url = f"http://{local_ip}:{port}"
-
-    # 保存部署信息到部署目录
-    deployments_dir = nginx_base_dir / "deployments"
-    deployments_dir.mkdir(exist_ok=True)
-
-    deploy_info = {
-        "project_id": project_id,
-        "port": port,
-        "url": url,
-        "html_dir": str(html_dir),
-        "conf_file": str(conf_file),
-        "source_dir": str(source_path),
-        "deployed_at": time.strftime("%Y-%m-%d %H:%M:%S")
-    }
-
-    info_file = deployments_dir / f"{project_id}.json"
-    info_file.write_text(json.dumps(deploy_info, indent=2, ensure_ascii=False))
-
-    return deploy_info
-
-def main():
-    if len(sys.argv) < 2:
-        print("用法: python deploy.py <前端项目目录> [nginx基础目录]")
-        print(f"默认 nginx 目录: {DEFAULT_NGINX_BASE_DIR}")
-        print("示例: python deploy.py ./my-app")
-        sys.exit(1)
-
-    source_dir = sys.argv[1]
-    nginx_base_dir = sys.argv[2] if len(sys.argv) > 2 else None
-
-    try:
-        info = deploy_frontend(source_dir, nginx_base_dir)
-        print(f"\n✅ 部署成功!")
-        print(f"项目 ID: {info['project_id']}")
-        print(f"端口: {info['port']}")
-        print(f"访问地址: {info['url']}")
-        print(f"HTML 目录: {info['html_dir']}")
-        print(f"配置文件: {info['conf_file']}")
-    except Exception as e:
-        print(f"\n❌ 部署失败: {e}")
-        import traceback
-        traceback.print_exc()
-        sys.exit(1)
-
-if __name__ == "__main__":
-    main()