feat(db): add patch for aiosqlite to ensure proper connection handling

Bumps [aioboto3](https://github.com/terricain/aioboto3) from 15.2.0 to 15.5.0.
- [Changelog](https://github.com/terricain/aioboto3/blob/main/CHANGELOG.rst)
- [Commits](https://github.com/terricain/aioboto3/compare/v15.2.0...v15.5.0)

---
updated-dependencies:
- dependency-name: aioboto3
  dependency-version: 15.5.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

.github/dependabot.yml

@@ -0,0 +1,16 @@
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+
+  - package-ecosystem: "bun"
+    directory: "/web"
+    schedule:
+      interval: "weekly"
+
+  - package-ecosystem: "uv"
+    directory: "/"
+    schedule:
+      interval: "weekly"

.github/workflows/docker.yml

@@ -17,7 +17,7 @@ jobs:
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
 
       - name: Set up Docker Buildx
         uses: docker/setup-buildx-action@v3
@@ -45,7 +45,7 @@ jobs:
           password: ${{ secrets.GITHUB_TOKEN }}
 
       - name: Build and push Docker image (multi arch)
-        uses: docker/build-push-action@v5
+        uses: docker/build-push-action@v6
         with:
           context: .
           platforms: linux/amd64,linux/arm64

.github/workflows/release-drafter.yml

@@ -10,7 +10,7 @@ jobs:
       contents: write
       pull-requests: write
     steps:
-      - uses: release-drafter/release-drafter@v5
+      - uses: release-drafter/release-drafter@v6
         with:
           config-name: release-drafter.yml
         env:

Dockerfile

@@ -33,6 +33,8 @@ COPY . .
 
 RUN mkdir -p data/db data/mount && \
     chmod 777 data/db data/mount && \
+    chmod +x setup/foxel_cli.py && \
+    ln -sf /app/setup/foxel_cli.py /usr/local/bin/foxel && \
     rm -rf /var/log/apt /var/cache/apt/archives
     
 EXPOSE 80

db/session.py

@@ -13,7 +13,21 @@ TORTOISE_ORM = {
 }
 
 
+def patch_aiosqlite_for_tortoise() -> None:
+    import aiosqlite
+
+    if hasattr(aiosqlite.Connection, "start"):
+        return
+
+    def start(self) -> None:  # type: ignore[no-redef]
+        if not self._thread.is_alive():
+            self._thread.start()
+
+    aiosqlite.Connection.start = start  # type: ignore[attr-defined]
+
+
 async def init_db():
+    patch_aiosqlite_for_tortoise()
     await Tortoise.init(config=TORTOISE_ORM)
     await Tortoise.generate_schemas()
     await runtime_registry.refresh()

domain/adapters/providers/alist.py

@@ -0,0 +1,487 @@
+import asyncio
+import mimetypes
+import re
+import tempfile
+from datetime import datetime, timezone
+from pathlib import Path
+from typing import Any, AsyncIterator, Dict, List, Tuple
+from urllib.parse import quote, urljoin
+
+import httpx
+from fastapi import HTTPException
+from fastapi.responses import Response, StreamingResponse
+
+from models import StorageAdapter
+
+
+def _normalize_fs_path(path: str) -> str:
+    path = (path or "").replace("\\", "/").strip()
+    if not path or path == "/":
+        return "/"
+    if not path.startswith("/"):
+        path = "/" + path
+    path = re.sub(r"/{2,}", "/", path)
+    if path != "/" and path.endswith("/"):
+        path = path.rstrip("/")
+    return path or "/"
+
+
+def _join_fs_path(base: str, rel: str) -> str:
+    base = _normalize_fs_path(base)
+    rel = (rel or "").replace("\\", "/").lstrip("/")
+    if not rel:
+        return base
+    if base == "/":
+        return "/" + rel
+    return f"{base}/{rel}"
+
+
+def _split_parent_and_name(path: str) -> Tuple[str, str]:
+    path = _normalize_fs_path(path)
+    if path == "/":
+        return "/", ""
+    parent, _, name = path.rpartition("/")
+    if not parent:
+        parent = "/"
+    return parent, name
+
+
+def _parse_iso_to_epoch(value: str | None) -> int:
+    if not value:
+        return 0
+    text = str(value).strip()
+    if not text:
+        return 0
+    try:
+        if text.endswith("Z"):
+            text = text[:-1] + "+00:00"
+        m = re.match(r"^(.*?)(\.\d+)([+-]\d\d:\d\d)?$", text)
+        if m:
+            head, frac, tz = m.group(1), m.group(2), m.group(3) or ""
+            digits = frac[1:]
+            if len(digits) > 6:
+                frac = "." + digits[:6]
+            text = head + frac + tz
+        dt = datetime.fromisoformat(text)
+        if dt.tzinfo is None:
+            dt = dt.replace(tzinfo=timezone.utc)
+        return int(dt.timestamp())
+    except Exception:
+        return 0
+
+
+class AListApiAdapterBase:
+    def __init__(self, record: StorageAdapter, *, product_name: str):
+        self.record = record
+        self.product_name = product_name
+
+        cfg = record.config or {}
+        self.base_url: str = str(cfg.get("base_url", "")).rstrip("/")
+        if not self.base_url.startswith("http"):
+            raise ValueError(f"{product_name} requires base_url http/https")
+        self.username: str = str(cfg.get("username") or "")
+        self.password: str = str(cfg.get("password") or "")
+        if not self.username or not self.password:
+            raise ValueError(f"{product_name} requires username and password")
+
+        self.timeout: float = float(cfg.get("timeout", 30))
+        self.root_path: str = _normalize_fs_path(str(cfg.get("root") or "/"))
+        self.enable_redirect_307: bool = bool(cfg.get("enable_direct_download_307"))
+
+        self._token: str | None = None
+        self._login_lock = asyncio.Lock()
+
+    def get_effective_root(self, sub_path: str | None) -> str:
+        base = _normalize_fs_path(self.root_path)
+        if sub_path:
+            return _join_fs_path(base, sub_path)
+        return base
+
+    async def _ensure_token(self) -> str:
+        if self._token:
+            return self._token
+        async with self._login_lock:
+            if self._token:
+                return self._token
+            self._token = await self._login()
+            return self._token
+
+    async def _login(self) -> str:
+        url = self.base_url + "/api/auth/login"
+        body = {"username": self.username, "password": self.password}
+        async with httpx.AsyncClient(timeout=self.timeout, follow_redirects=True) as client:
+            resp = await client.post(url, json=body)
+            resp.raise_for_status()
+            payload = resp.json()
+        if not isinstance(payload, dict):
+            raise HTTPException(502, detail=f"{self.product_name} login: invalid response")
+        code = payload.get("code")
+        if code not in (0, 200):
+            raise HTTPException(502, detail=f"{self.product_name} login failed: {payload.get('message')}")
+        data = payload.get("data") or {}
+        token = (data.get("token") if isinstance(data, dict) else None) or ""
+        token = str(token).strip()
+        if not token:
+            raise HTTPException(502, detail=f"{self.product_name} login: missing token")
+        return token
+
+    async def _api_json(
+        self,
+        method: str,
+        endpoint: str,
+        *,
+        json: Dict[str, Any] | None = None,
+        headers: Dict[str, str] | None = None,
+        retry: bool = True,
+        files: Any = None,
+    ) -> Any:
+        token = await self._ensure_token()
+        url = self.base_url + endpoint
+        req_headers: Dict[str, str] = {"Authorization": token}
+        if headers:
+            req_headers.update(headers)
+        async with httpx.AsyncClient(timeout=self.timeout, follow_redirects=True) as client:
+            resp = await client.request(method, url, json=json, headers=req_headers, files=files)
+        if resp.status_code == 401 and retry:
+            self._token = None
+            return await self._api_json(method, endpoint, json=json, headers=headers, retry=False, files=files)
+        resp.raise_for_status()
+        payload = resp.json()
+        if not isinstance(payload, dict):
+            raise HTTPException(502, detail=f"{self.product_name} api: invalid response")
+
+        code = payload.get("code")
+        if code in (0, 200):
+            return payload.get("data")
+        if code in (401, 403) and retry:
+            self._token = None
+            return await self._api_json(method, endpoint, json=json, headers=headers, retry=False, files=files)
+        if code == 404:
+            raise FileNotFoundError(json.get("path") if json else "")
+        msg = payload.get("message") or payload.get("msg") or ""
+        raise HTTPException(502, detail=f"{self.product_name} api error code={code} msg={msg}")
+
+    def _abs_url(self, url: str) -> str:
+        u = (url or "").strip()
+        if not u:
+            return ""
+        if u.startswith("http://") or u.startswith("https://"):
+            return u
+        return urljoin(self.base_url.rstrip("/") + "/", u.lstrip("/"))
+
+    async def _fs_list(self, path: str) -> Dict[str, Any]:
+        body = {"path": path, "password": "", "page": 1, "per_page": 0, "refresh": False}
+        data = await self._api_json("POST", "/api/fs/list", json=body)
+        return data or {}
+
+    async def _fs_get(self, path: str) -> Dict[str, Any]:
+        body = {"path": path, "password": "", "page": 1, "per_page": 0, "refresh": False}
+        data = await self._api_json("POST", "/api/fs/get", json=body)
+        return data or {}
+
+    async def list_dir(
+        self,
+        root: str,
+        rel: str,
+        page_num: int = 1,
+        page_size: int = 50,
+        sort_by: str = "name",
+        sort_order: str = "asc",
+    ) -> Tuple[List[Dict], int]:
+        path = _join_fs_path(root, rel)
+        data = await self._fs_list(path)
+        content = data.get("content") or []
+        if not isinstance(content, list):
+            raise HTTPException(502, detail=f"{self.product_name} list_dir: invalid content")
+
+        entries: List[Dict] = []
+        for it in content:
+            if not isinstance(it, dict):
+                continue
+            name = str(it.get("name") or "")
+            if not name:
+                continue
+            is_dir = bool(it.get("is_dir"))
+            size = int(it.get("size") or 0) if not is_dir else 0
+            mtime = _parse_iso_to_epoch(it.get("modified"))
+            entries.append(
+                {
+                    "name": name,
+                    "is_dir": is_dir,
+                    "size": size,
+                    "mtime": mtime,
+                    "type": "dir" if is_dir else "file",
+                }
+            )
+
+        reverse = sort_order.lower() == "desc"
+
+        def get_sort_key(item: Dict) -> Tuple:
+            key = (not item.get("is_dir"),)
+            f = sort_by.lower()
+            if f == "name":
+                key += (str(item.get("name", "")).lower(),)
+            elif f == "size":
+                key += (int(item.get("size", 0)),)
+            elif f == "mtime":
+                key += (int(item.get("mtime", 0)),)
+            else:
+                key += (str(item.get("name", "")).lower(),)
+            return key
+
+        entries.sort(key=get_sort_key, reverse=reverse)
+        total = len(entries)
+        start = (page_num - 1) * page_size
+        end = start + page_size
+        return entries[start:end], total
+
+    async def stat_file(self, root: str, rel: str):
+        path = _join_fs_path(root, rel)
+        data = await self._fs_get(path)
+        if not data:
+            raise FileNotFoundError(rel)
+        is_dir = bool(data.get("is_dir"))
+        name = str(data.get("name") or (rel.rstrip("/").split("/")[-1] if rel else ""))
+        size = int(data.get("size") or 0) if not is_dir else 0
+        mtime = _parse_iso_to_epoch(data.get("modified"))
+        info = {
+            "name": name,
+            "is_dir": is_dir,
+            "size": size,
+            "mtime": mtime,
+            "type": "dir" if is_dir else "file",
+            "path": path,
+        }
+        return info
+
+    async def stat_path(self, root: str, rel: str):
+        try:
+            info = await self.stat_file(root, rel)
+            return {"exists": True, "is_dir": bool(info.get("is_dir")), "path": info.get("path")}
+        except FileNotFoundError:
+            return {"exists": False, "is_dir": None, "path": _join_fs_path(root, rel)}
+
+    async def exists(self, root: str, rel: str) -> bool:
+        try:
+            await self.stat_file(root, rel)
+            return True
+        except FileNotFoundError:
+            return False
+        except Exception:
+            return False
+
+    async def get_direct_download_response(self, root: str, rel: str):
+        if not self.enable_redirect_307:
+            return None
+        data = await self._fs_get(_join_fs_path(root, rel))
+        if not data:
+            raise FileNotFoundError(rel)
+        if bool(data.get("is_dir")):
+            raise IsADirectoryError(rel)
+        raw_url = self._abs_url(str(data.get("raw_url") or ""))
+        if not raw_url:
+            return None
+        return Response(status_code=307, headers={"Location": raw_url})
+
+    async def _get_raw_url_and_meta(self, root: str, rel: str) -> Tuple[str, int, str]:
+        data = await self._fs_get(_join_fs_path(root, rel))
+        if not data:
+            raise FileNotFoundError(rel)
+        if bool(data.get("is_dir")):
+            raise IsADirectoryError(rel)
+        raw_url = self._abs_url(str(data.get("raw_url") or ""))
+        if not raw_url:
+            raise HTTPException(502, detail=f"{self.product_name} missing raw_url")
+        size = int(data.get("size") or 0)
+        name = str(data.get("name") or "")
+        return raw_url, size, name
+
+    async def read_file(self, root: str, rel: str) -> bytes:
+        raw_url, _, _ = await self._get_raw_url_and_meta(root, rel)
+        async with httpx.AsyncClient(timeout=self.timeout, follow_redirects=True) as client:
+            resp = await client.get(raw_url)
+            resp.raise_for_status()
+            return resp.content
+
+    async def stream_file(self, root: str, rel: str, range_header: str | None):
+        raw_url, file_size, name = await self._get_raw_url_and_meta(root, rel)
+        mime, _ = mimetypes.guess_type(name or rel)
+        content_type = mime or "application/octet-stream"
+
+        start = 0
+        end = max(file_size - 1, 0)
+        status = 200
+        headers = {
+            "Accept-Ranges": "bytes",
+            "Content-Type": content_type,
+        }
+        if file_size >= 0:
+            headers["Content-Length"] = str(file_size)
+
+        if range_header and range_header.startswith("bytes="):
+            try:
+                part = range_header.removeprefix("bytes=")
+                s, e = part.split("-", 1)
+                if s.strip():
+                    start = int(s)
+                if e.strip():
+                    end = int(e)
+                if file_size and start >= file_size:
+                    raise HTTPException(416, detail="Requested Range Not Satisfiable")
+                if file_size and end >= file_size:
+                    end = file_size - 1
+                status = 206
+            except ValueError:
+                raise HTTPException(400, detail="Invalid Range header")
+            headers["Content-Range"] = f"bytes {start}-{end}/{file_size}"
+            headers["Content-Length"] = str(end - start + 1)
+
+        async def agen():
+            async with httpx.AsyncClient(timeout=self.timeout, follow_redirects=True) as client:
+                req_headers = {"Range": f"bytes={start}-{end}"} if status == 206 else {}
+                async with client.stream("GET", raw_url, headers=req_headers) as resp:
+                    resp.raise_for_status()
+                    async for chunk in resp.aiter_bytes():
+                        if chunk:
+                            yield chunk
+
+        return StreamingResponse(agen(), status_code=status, headers=headers, media_type=content_type)
+
+    async def _upload_file(self, full_path: str, file_path: Path) -> Any:
+        token = await self._ensure_token()
+        headers = {
+            "Authorization": token,
+            "File-Path": quote(full_path, safe="/"),
+        }
+        with file_path.open("rb") as f:
+            files = {"file": (file_path.name, f, "application/octet-stream")}
+            async with httpx.AsyncClient(timeout=self.timeout, follow_redirects=True) as client:
+                resp = await client.put(self.base_url + "/api/fs/form", headers=headers, files=files)
+                resp.raise_for_status()
+                payload = resp.json()
+        if not isinstance(payload, dict):
+            raise HTTPException(502, detail=f"{self.product_name} upload: invalid response")
+        code = payload.get("code")
+        if code not in (0, 200):
+            msg = payload.get("message") or payload.get("msg") or ""
+            raise HTTPException(502, detail=f"{self.product_name} upload failed: {msg}")
+        return payload.get("data")
+
+    async def write_file(self, root: str, rel: str, data: bytes):
+        full_path = _join_fs_path(root, rel)
+        suffix = Path(rel).suffix
+        with tempfile.NamedTemporaryFile(delete=False, suffix=suffix) as tf:
+            tf.write(data)
+            tmp_path = Path(tf.name)
+        try:
+            await self._upload_file(full_path, tmp_path)
+        finally:
+            try:
+                tmp_path.unlink(missing_ok=True)
+            except Exception:
+                pass
+
+    async def write_file_stream(self, root: str, rel: str, data_iter: AsyncIterator[bytes]):
+        full_path = _join_fs_path(root, rel)
+        suffix = Path(rel).suffix
+        with tempfile.NamedTemporaryFile(delete=False, suffix=suffix) as tf:
+            tmp_path = Path(tf.name)
+        size = 0
+        try:
+            with tmp_path.open("wb") as f:
+                async for chunk in data_iter:
+                    if not chunk:
+                        continue
+                    f.write(chunk)
+                    size += len(chunk)
+            await self._upload_file(full_path, tmp_path)
+            return size
+        finally:
+            try:
+                tmp_path.unlink(missing_ok=True)
+            except Exception:
+                pass
+
+    async def mkdir(self, root: str, rel: str):
+        path = _join_fs_path(root, rel)
+        await self._api_json("POST", "/api/fs/mkdir", json={"path": path})
+
+    async def delete(self, root: str, rel: str):
+        path = _join_fs_path(root, rel)
+        parent, name = _split_parent_and_name(path)
+        if not name:
+            return
+        await self._api_json("POST", "/api/fs/remove", json={"dir": parent, "names": [name]})
+
+    async def move(self, root: str, src_rel: str, dst_rel: str):
+        src_path = _join_fs_path(root, src_rel)
+        dst_path = _join_fs_path(root, dst_rel)
+        src_dir, src_name = _split_parent_and_name(src_path)
+        dst_dir, dst_name = _split_parent_and_name(dst_path)
+        if not src_name or not dst_name:
+            raise HTTPException(400, detail="Invalid move path")
+
+        if src_dir == dst_dir:
+            if src_name == dst_name:
+                return
+            await self._api_json("POST", "/api/fs/rename", json={"path": src_path, "name": dst_name})
+            return
+
+        await self._api_json("POST", "/api/fs/move", json={"src_dir": src_dir, "dst_dir": dst_dir, "names": [src_name]})
+        if src_name != dst_name:
+            await self._api_json("POST", "/api/fs/rename", json={"path": _join_fs_path(dst_dir, src_name), "name": dst_name})
+
+    async def rename(self, root: str, src_rel: str, dst_rel: str):
+        await self.move(root, src_rel, dst_rel)
+
+    async def copy(self, root: str, src_rel: str, dst_rel: str, overwrite: bool = False):
+        src_path = _join_fs_path(root, src_rel)
+        dst_path = _join_fs_path(root, dst_rel)
+        src_dir, src_name = _split_parent_and_name(src_path)
+        dst_dir, dst_name = _split_parent_and_name(dst_path)
+        if not src_name or not dst_name:
+            raise HTTPException(400, detail="Invalid copy path")
+
+        src_info = await self._fs_get(src_path)
+        if not src_info:
+            raise FileNotFoundError(src_rel)
+
+        if src_name != dst_name and not bool(src_info.get("is_dir")):
+            raw_url, _, _ = await self._get_raw_url_and_meta(root, src_rel)
+            async with httpx.AsyncClient(timeout=self.timeout, follow_redirects=True) as client:
+                async with client.stream("GET", raw_url) as resp:
+                    resp.raise_for_status()
+
+                    async def gen():
+                        async for chunk in resp.aiter_bytes():
+                            if chunk:
+                                yield chunk
+
+                    await self.write_file_stream(root, dst_rel, gen())
+            return
+
+        await self._api_json("POST", "/api/fs/copy", json={"src_dir": src_dir, "dst_dir": dst_dir, "names": [src_name]})
+        if src_name != dst_name:
+            await self._api_json("POST", "/api/fs/rename", json={"path": _join_fs_path(dst_dir, src_name), "name": dst_name})
+
+
+class AListAdapter(AListApiAdapterBase):
+    def __init__(self, record: StorageAdapter):
+        super().__init__(record, product_name="AList")
+
+
+class OpenListAdapter(AListApiAdapterBase):
+    def __init__(self, record: StorageAdapter):
+        super().__init__(record, product_name="OpenList")
+
+
+ADAPTER_TYPES = {"alist": AListAdapter, "openlist": OpenListAdapter}
+
+CONFIG_SCHEMA = [
+    {"key": "base_url", "label": "基础地址", "type": "string", "required": True, "placeholder": "http://127.0.0.1:5244"},
+    {"key": "username", "label": "用户名", "type": "string", "required": True},
+    {"key": "password", "label": "密码", "type": "password", "required": True},
+    {"key": "root", "label": "根目录", "type": "string", "required": False, "default": "/"},
+    {"key": "timeout", "label": "超时(秒)", "type": "number", "required": False, "default": 30},
+    {"key": "enable_direct_download_307", "label": "启用 307 直链下载", "type": "boolean", "default": False},
+]

domain/adapters/providers/base.py

@@ -1,4 +1,3 @@
-from __future__ import annotations
 from typing import List, Dict, Protocol, runtime_checkable, Tuple, AsyncIterator
 from models import StorageAdapter
 

domain/adapters/providers/dropbox.py

@@ -0,0 +1,471 @@
+import asyncio
+import base64
+import json
+import mimetypes
+import re
+from datetime import datetime, timezone, timedelta
+from typing import AsyncIterator, Dict, List, Tuple
+
+import httpx
+from fastapi import HTTPException
+from fastapi.responses import Response, StreamingResponse
+
+from models import StorageAdapter
+
+DROPBOX_OAUTH_URL = "https://api.dropboxapi.com/oauth2/token"
+DROPBOX_API_URL = "https://api.dropboxapi.com/2"
+DROPBOX_CONTENT_URL = "https://content.dropboxapi.com/2"
+
+
+def _normalize_dbx_path(path: str | None) -> str:
+    path = (path or "").replace("\\", "/").strip()
+    if not path or path == "/":
+        return ""
+    if not path.startswith("/"):
+        path = "/" + path
+    path = re.sub(r"/{2,}", "/", path)
+    if path.endswith("/"):
+        path = path.rstrip("/")
+    return path
+
+
+def _join_dbx_path(base: str, rel: str) -> str:
+    base = _normalize_dbx_path(base)
+    rel = (rel or "").replace("\\", "/").strip("/")
+    if not rel:
+        return base
+    if not base:
+        return "/" + rel
+    return f"{base}/{rel}"
+
+
+def _parse_iso_to_epoch(value: str | None) -> int:
+    if not value:
+        return 0
+    text = str(value).strip()
+    if not text:
+        return 0
+    try:
+        if text.endswith("Z"):
+            text = text[:-1] + "+00:00"
+        dt = datetime.fromisoformat(text)
+        if dt.tzinfo is None:
+            dt = dt.replace(tzinfo=timezone.utc)
+        return int(dt.timestamp())
+    except Exception:
+        return 0
+
+
+class DropboxAdapter:
+    def __init__(self, record: StorageAdapter):
+        self.record = record
+        cfg = record.config or {}
+
+        self.app_key: str = str(cfg.get("app_key") or "").strip()
+        self.app_secret: str = str(cfg.get("app_secret") or "").strip()
+        self.refresh_token: str = str(cfg.get("refresh_token") or "").strip()
+        self.root_path: str = _normalize_dbx_path(str(cfg.get("root") or "/"))
+        self.enable_redirect_307: bool = bool(cfg.get("enable_direct_download_307"))
+        self.timeout: float = float(cfg.get("timeout", 60))
+
+        if not (self.app_key and self.app_secret and self.refresh_token):
+            raise ValueError("Dropbox 适配器需要 app_key, app_secret, refresh_token")
+
+        self._access_token: str | None = None
+        self._token_expiry: datetime | None = None
+        self._token_lock = asyncio.Lock()
+
+    def get_effective_root(self, sub_path: str | None) -> str:
+        base = _normalize_dbx_path(self.root_path)
+        if sub_path:
+            return _join_dbx_path(base, sub_path)
+        return base
+
+    async def _get_access_token(self) -> str:
+        if self._access_token and self._token_expiry and datetime.now(timezone.utc) < self._token_expiry:
+            return self._access_token
+
+        async with self._token_lock:
+            if self._access_token and self._token_expiry and datetime.now(timezone.utc) < self._token_expiry:
+                return self._access_token
+
+            basic = base64.b64encode(f"{self.app_key}:{self.app_secret}".encode("utf-8")).decode("ascii")
+            headers = {"Authorization": f"Basic {basic}"}
+            data = {"grant_type": "refresh_token", "refresh_token": self.refresh_token}
+            async with httpx.AsyncClient(timeout=self.timeout) as client:
+                resp = await client.post(DROPBOX_OAUTH_URL, data=data, headers=headers)
+            resp.raise_for_status()
+
+            payload = resp.json()
+            token = str(payload.get("access_token") or "").strip()
+            if not token:
+                raise HTTPException(502, detail="Dropbox oauth: missing access_token")
+            expires_in = int(payload.get("expires_in") or 3600)
+            self._access_token = token
+            self._token_expiry = datetime.now(timezone.utc) + timedelta(seconds=max(60, expires_in - 300))
+            return token
+
+    async def _api_json(self, endpoint: str, body: Dict) -> httpx.Response:
+        token = await self._get_access_token()
+        headers = {"Authorization": f"Bearer {token}"}
+        async with httpx.AsyncClient(timeout=self.timeout) as client:
+            return await client.post(f"{DROPBOX_API_URL}{endpoint}", json=body, headers=headers)
+
+    async def _content_request(
+        self,
+        endpoint: str,
+        api_arg: Dict,
+        *,
+        content: bytes | None = None,
+        data_iter: AsyncIterator[bytes] | None = None,
+        extra_headers: Dict[str, str] | None = None,
+    ) -> httpx.Response:
+        token = await self._get_access_token()
+        headers = {
+            "Authorization": f"Bearer {token}",
+            "Dropbox-API-Arg": json.dumps(api_arg, separators=(",", ":"), ensure_ascii=False),
+        }
+        if extra_headers:
+            headers.update(extra_headers)
+
+        if data_iter is None:
+            async with httpx.AsyncClient(timeout=self.timeout) as client:
+                return await client.post(f"{DROPBOX_CONTENT_URL}{endpoint}", headers=headers, content=content or b"")
+
+        async with httpx.AsyncClient(timeout=self.timeout) as client:
+            return await client.post(f"{DROPBOX_CONTENT_URL}{endpoint}", headers=headers, content=data_iter)
+
+    @staticmethod
+    def _raise_dbx_error(resp: httpx.Response, *, rel: str):
+        try:
+            payload = resp.json()
+        except Exception:
+            payload = None
+        summary = ""
+        if isinstance(payload, dict):
+            summary = str(payload.get("error_summary") or "")
+        if "not_found" in summary:
+            raise FileNotFoundError(rel)
+        if "conflict" in summary or "already_exists" in summary:
+            raise FileExistsError(rel)
+        if "is_folder" in summary:
+            raise IsADirectoryError(rel)
+        if "not_folder" in summary:
+            raise NotADirectoryError(rel)
+        raise HTTPException(502, detail=f"Dropbox API error: {summary or resp.text}")
+
+    def _format_entry(self, entry: Dict) -> Dict:
+        tag = entry.get(".tag")
+        is_dir = tag == "folder"
+        mtime = _parse_iso_to_epoch(entry.get("server_modified") if not is_dir else None)
+        return {
+            "name": entry.get("name") or "",
+            "is_dir": is_dir,
+            "size": 0 if is_dir else int(entry.get("size") or 0),
+            "mtime": mtime,
+            "type": "dir" if is_dir else "file",
+        }
+
+    async def list_dir(
+        self,
+        root: str,
+        rel: str,
+        page_num: int = 1,
+        page_size: int = 50,
+        sort_by: str = "name",
+        sort_order: str = "asc",
+    ) -> Tuple[List[Dict], int]:
+        path = _join_dbx_path(root, rel)
+        body = {"path": path, "recursive": False, "include_deleted": False, "limit": 2000}
+        resp = await self._api_json("/files/list_folder", body)
+        if resp.status_code == 409:
+            try:
+                payload = resp.json()
+            except Exception:
+                payload = None
+            summary = str((payload or {}).get("error_summary") or "")
+            if "not_found" in summary:
+                return [], 0
+            self._raise_dbx_error(resp, rel=rel)
+        resp.raise_for_status()
+        payload = resp.json()
+
+        all_entries: List[Dict] = []
+        all_entries.extend(payload.get("entries") or [])
+        cursor = payload.get("cursor")
+        has_more = bool(payload.get("has_more"))
+        while has_more and cursor:
+            resp2 = await self._api_json("/files/list_folder/continue", {"cursor": cursor})
+            resp2.raise_for_status()
+            p2 = resp2.json()
+            all_entries.extend(p2.get("entries") or [])
+            cursor = p2.get("cursor")
+            has_more = bool(p2.get("has_more"))
+
+        items = [self._format_entry(e) for e in all_entries if isinstance(e, dict)]
+
+        reverse = sort_order.lower() == "desc"
+
+        def get_sort_key(item):
+            key = (not item["is_dir"],)
+            f = sort_by.lower()
+            if f == "name":
+                key += (item["name"].lower(),)
+            elif f == "size":
+                key += (item["size"],)
+            elif f == "mtime":
+                key += (item["mtime"],)
+            else:
+                key += (item["name"].lower(),)
+            return key
+
+        items.sort(key=get_sort_key, reverse=reverse)
+
+        total = len(items)
+        start = (page_num - 1) * page_size
+        end = start + page_size
+        return items[start:end], total
+
+    async def stat_file(self, root: str, rel: str):
+        path = _join_dbx_path(root, rel)
+        resp = await self._api_json("/files/get_metadata", {"path": path, "include_deleted": False})
+        if resp.status_code == 409:
+            self._raise_dbx_error(resp, rel=rel)
+        resp.raise_for_status()
+        meta = resp.json()
+        if not isinstance(meta, dict):
+            raise HTTPException(502, detail="Dropbox metadata: invalid response")
+        return self._format_entry(meta)
+
+    async def exists(self, root: str, rel: str) -> bool:
+        try:
+            await self.stat_file(root, rel)
+            return True
+        except FileNotFoundError:
+            return False
+        except Exception:
+            return False
+
+    async def read_file(self, root: str, rel: str) -> bytes:
+        path = _join_dbx_path(root, rel)
+        resp = await self._content_request("/files/download", {"path": path})
+        if resp.status_code == 409:
+            self._raise_dbx_error(resp, rel=rel)
+        resp.raise_for_status()
+        return resp.content
+
+    async def write_file(self, root: str, rel: str, data: bytes):
+        path = _join_dbx_path(root, rel)
+        arg = {
+            "path": path,
+            "mode": "overwrite",
+            "autorename": False,
+            "mute": False,
+            "strict_conflict": False,
+        }
+        resp = await self._content_request(
+            "/files/upload",
+            arg,
+            content=data,
+            extra_headers={"Content-Type": "application/octet-stream"},
+        )
+        if resp.status_code == 409:
+            self._raise_dbx_error(resp, rel=rel)
+        resp.raise_for_status()
+        return True
+
+    async def write_file_stream(self, root: str, rel: str, data_iter: AsyncIterator[bytes]):
+        path = _join_dbx_path(root, rel)
+
+        size = 0
+        session_id: str | None = None
+        offset = 0
+
+        async for chunk in data_iter:
+            if not chunk:
+                continue
+            if session_id is None:
+                resp = await self._content_request(
+                    "/files/upload_session_start",
+                    {"close": False},
+                    content=chunk,
+                    extra_headers={"Content-Type": "application/octet-stream"},
+                )
+                resp.raise_for_status()
+                payload = resp.json()
+                session_id = str(payload.get("session_id") or "")
+                if not session_id:
+                    raise HTTPException(502, detail="Dropbox upload_session_start: missing session_id")
+                offset += len(chunk)
+                size += len(chunk)
+                continue
+
+            arg = {"cursor": {"session_id": session_id, "offset": offset}, "close": False}
+            resp = await self._content_request(
+                "/files/upload_session_append_v2",
+                arg,
+                content=chunk,
+                extra_headers={"Content-Type": "application/octet-stream"},
+            )
+            resp.raise_for_status()
+            offset += len(chunk)
+            size += len(chunk)
+
+        if session_id is None:
+            await self.write_file(root, rel, b"")
+            return 0
+
+        finish_arg = {
+            "cursor": {"session_id": session_id, "offset": offset},
+            "commit": {
+                "path": path,
+                "mode": "overwrite",
+                "autorename": False,
+                "mute": False,
+                "strict_conflict": False,
+            },
+        }
+        resp = await self._content_request(
+            "/files/upload_session_finish",
+            finish_arg,
+            content=b"",
+            extra_headers={"Content-Type": "application/octet-stream"},
+        )
+        if resp.status_code == 409:
+            self._raise_dbx_error(resp, rel=rel)
+        resp.raise_for_status()
+        return size
+
+    async def mkdir(self, root: str, rel: str):
+        path = _join_dbx_path(root, rel)
+        resp = await self._api_json("/files/create_folder_v2", {"path": path, "autorename": False})
+        if resp.status_code == 409:
+            self._raise_dbx_error(resp, rel=rel)
+        resp.raise_for_status()
+        return True
+
+    async def delete(self, root: str, rel: str):
+        path = _join_dbx_path(root, rel)
+        resp = await self._api_json("/files/delete_v2", {"path": path})
+        if resp.status_code == 409:
+            try:
+                payload = resp.json()
+            except Exception:
+                payload = None
+            summary = str((payload or {}).get("error_summary") or "")
+            if "not_found" in summary:
+                return
+            self._raise_dbx_error(resp, rel=rel)
+        resp.raise_for_status()
+        return True
+
+    async def move(self, root: str, src_rel: str, dst_rel: str):
+        src = _join_dbx_path(root, src_rel)
+        dst = _join_dbx_path(root, dst_rel)
+        resp = await self._api_json(
+            "/files/move_v2",
+            {"from_path": src, "to_path": dst, "autorename": False, "allow_shared_folder": True},
+        )
+        if resp.status_code == 409:
+            self._raise_dbx_error(resp, rel=src_rel)
+        resp.raise_for_status()
+        return True
+
+    async def rename(self, root: str, src_rel: str, dst_rel: str):
+        return await self.move(root, src_rel, dst_rel)
+
+    async def copy(self, root: str, src_rel: str, dst_rel: str, overwrite: bool = False):
+        src = _join_dbx_path(root, src_rel)
+        dst = _join_dbx_path(root, dst_rel)
+        resp = await self._api_json(
+            "/files/copy_v2",
+            {"from_path": src, "to_path": dst, "autorename": False, "allow_shared_folder": True},
+        )
+        if resp.status_code == 409:
+            self._raise_dbx_error(resp, rel=dst_rel if overwrite else dst_rel)
+        resp.raise_for_status()
+        return True
+
+    async def get_direct_download_response(self, root: str, rel: str):
+        if not self.enable_redirect_307:
+            return None
+
+        path = _join_dbx_path(root, rel)
+        resp = await self._api_json("/files/get_temporary_link", {"path": path})
+        if resp.status_code == 409:
+            self._raise_dbx_error(resp, rel=rel)
+        resp.raise_for_status()
+        payload = resp.json()
+        link = (payload.get("link") if isinstance(payload, dict) else None) or ""
+        link = str(link).strip()
+        if not link:
+            return None
+        return Response(status_code=307, headers={"Location": link})
+
+    async def stream_file(self, root: str, rel: str, range_header: str | None):
+        path = _join_dbx_path(root, rel)
+        token = await self._get_access_token()
+        headers = {
+            "Authorization": f"Bearer {token}",
+            "Dropbox-API-Arg": json.dumps({"path": path}, separators=(",", ":"), ensure_ascii=False),
+        }
+        if range_header:
+            headers["Range"] = range_header
+
+        client = httpx.AsyncClient(timeout=None)
+        stream_cm = client.stream("POST", f"{DROPBOX_CONTENT_URL}/files/download", headers=headers)
+        try:
+            resp = await stream_cm.__aenter__()
+        except Exception:
+            await client.aclose()
+            raise
+
+        if resp.status_code == 409:
+            try:
+                content = await resp.aread()
+                _ = content
+            finally:
+                await stream_cm.__aexit__(None, None, None)
+                await client.aclose()
+            self._raise_dbx_error(resp, rel=rel)
+
+        if resp.status_code >= 400:
+            try:
+                await resp.aread()
+            finally:
+                await stream_cm.__aexit__(None, None, None)
+                await client.aclose()
+            resp.raise_for_status()
+
+        content_type = resp.headers.get("Content-Type") or (mimetypes.guess_type(rel)[0] or "application/octet-stream")
+        out_headers = {}
+        for key in ("Accept-Ranges", "Content-Range", "Content-Length"):
+            value = resp.headers.get(key)
+            if value:
+                out_headers[key] = value
+
+        async def iterator():
+            try:
+                async for chunk in resp.aiter_bytes():
+                    if chunk:
+                        yield chunk
+            finally:
+                await stream_cm.__aexit__(None, None, None)
+                await client.aclose()
+
+        return StreamingResponse(iterator(), status_code=resp.status_code, headers=out_headers, media_type=content_type)
+
+
+ADAPTER_TYPE = "dropbox"
+CONFIG_SCHEMA = [
+    {"key": "app_key", "label": "App Key", "type": "string", "required": True},
+    {"key": "app_secret", "label": "App Secret", "type": "password", "required": True},
+    {"key": "refresh_token", "label": "Refresh Token", "type": "password", "required": True},
+    {"key": "root", "label": "Root Path", "type": "string", "required": False, "default": "/", "placeholder": "/ or /Apps/Foxel"},
+    {"key": "timeout", "label": "超时(秒)", "type": "number", "required": False, "default": 60},
+    {"key": "enable_direct_download_307", "label": "Enable 307 redirect download", "type": "boolean", "default": False},
+]
+
+
+def ADAPTER_FACTORY(rec): return DropboxAdapter(rec)
+

domain/adapters/providers/ftp.py

@@ -1,5 +1,3 @@
-from __future__ import annotations
-
 import asyncio
 from dataclasses import dataclass
 from typing import List, Dict, Tuple, AsyncIterator, Optional

domain/adapters/providers/googledrive.py

@@ -1,4 +1,3 @@
-from __future__ import annotations
 from datetime import datetime, timezone, timedelta
 from typing import List, Dict, Tuple, AsyncIterator
 import httpx

domain/adapters/providers/local.py

@@ -1,4 +1,3 @@
-from __future__ import annotations
 import os
 import shutil
 import stat

domain/adapters/providers/onedrive.py

@@ -1,4 +1,3 @@
-from __future__ import annotations
 from datetime import datetime, timezone, timedelta
 from typing import List, Dict, Tuple, AsyncIterator
 import httpx

domain/adapters/providers/quark.py

@@ -1,4 +1,3 @@
-from __future__ import annotations
 import asyncio
 import base64
 import hashlib
@@ -291,6 +290,11 @@ class QuarkAdapter:
             return None
         return None
 
+    async def get_video_transcoding_url(self, fid: str) -> Optional[str]:
+        if not self.use_transcoding_address:
+            return None
+        return await self._get_transcoding_url(fid)
+
     def _is_video_name(self, name: str) -> bool:
         mime, _ = mimetypes.guess_type(name)
         return bool(mime and mime.startswith("video/"))
@@ -317,6 +321,29 @@ class QuarkAdapter:
             resp.raise_for_status()
             return resp.content
 
+    async def read_file_range(self, root: str, rel: str, start: int, end: Optional[int] = None) -> bytes:
+        if not rel or rel.endswith("/"):
+            raise IsADirectoryError("Path is a directory")
+        parent = rel.rsplit("/", 1)[0] if "/" in rel else ""
+        name = rel.rsplit("/", 1)[-1]
+        base_fid = root or self.root_fid
+        parent_fid = await self._resolve_dir_fid_from(base_fid, parent)
+        it = await self._find_child(parent_fid, name)
+        if not it or it["is_dir"]:
+            raise FileNotFoundError(rel)
+
+        url = await self._get_download_url(it["fid"])
+        headers = dict(self._download_headers())
+        headers["Range"] = f"bytes={start}-" if end is None else f"bytes={start}-{end}"
+        async with httpx.AsyncClient(timeout=self._timeout, follow_redirects=True) as client:
+            resp = await client.get(url, headers=headers)
+            if resp.status_code == 404:
+                raise FileNotFoundError(rel)
+            if resp.status_code == 416:
+                raise HTTPException(416, detail="Requested Range Not Satisfiable")
+            resp.raise_for_status()
+            return resp.content
+
     async def stream_file(self, root: str, rel: str, range_header: str | None):
         if not rel or rel.endswith("/"):
             raise IsADirectoryError("Path is a directory")

domain/adapters/providers/s3.py

@@ -1,4 +1,3 @@
-from __future__ import annotations
 import asyncio
 import mimetypes
 from datetime import datetime

domain/adapters/providers/sftp.py

@@ -1,5 +1,3 @@
-from __future__ import annotations
-
 import asyncio
 import mimetypes
 import stat as statmod

domain/adapters/providers/telegram.py

@@ -1,4 +1,3 @@
-from __future__ import annotations
 from typing import List, Dict, Tuple, AsyncIterator
 import io
 import os

domain/adapters/providers/webdav.py

@@ -1,4 +1,3 @@
-from __future__ import annotations
 from typing import List, Dict, Optional, Tuple, AsyncIterator
 import httpx
 from urllib.parse import urljoin, quote

domain/adapters/registry.py

@@ -33,6 +33,27 @@ def discover_adapters():
             module = import_module(full_name)
         except Exception:
             continue
+
+        adapter_types = getattr(module, "ADAPTER_TYPES", None)
+        if isinstance(adapter_types, dict):
+            default_schema = getattr(module, "CONFIG_SCHEMA", None)
+            schema_map = getattr(module, "CONFIG_SCHEMA_MAP", None)
+            if not isinstance(schema_map, dict):
+                schema_map = None
+
+            for adapter_type, factory in adapter_types.items():
+                normalized_type = normalize_adapter_type(adapter_type)
+                if not normalized_type:
+                    continue
+                if not callable(factory):
+                    continue
+                TYPE_MAP[normalized_type] = factory
+
+                schema = schema_map.get(normalized_type) if schema_map else default_schema
+                if isinstance(schema, list):
+                    CONFIG_SCHEMAS[normalized_type] = schema
+            continue
+
         adapter_type = normalize_adapter_type(getattr(module, "ADAPTER_TYPE", None))
         schema = getattr(module, "CONFIG_SCHEMA", None)
         factory = getattr(module, "ADAPTER_FACTORY", None)

domain/ai/inference.py

@@ -1,5 +1,3 @@
-from __future__ import annotations
-
 import httpx
 from typing import List, Sequence, Tuple
 

domain/ai/service.py

@@ -1,5 +1,3 @@
-from __future__ import annotations
-
 import asyncio
 import json
 from collections.abc import Iterable
@@ -400,7 +398,7 @@ class AIProviderService:
 
 
 class VectorDBService:
-    _instance: "VectorDBService" | None = None
+    _instance: Optional["VectorDBService"] = None
 
     def __new__(cls, *args, **kwargs):
         if cls._instance is None:

domain/ai/vector_providers/__init__.py

@@ -1,5 +1,3 @@
-from __future__ import annotations
-
 from typing import Dict, List, Type
 
 from .base import BaseVectorProvider

domain/ai/vector_providers/base.py

@@ -1,5 +1,3 @@
-from __future__ import annotations
-
 from typing import Any, Dict, List
 
 

domain/ai/vector_providers/milvus_lite.py

@@ -1,5 +1,3 @@
-from __future__ import annotations
-
 from pathlib import Path
 from typing import Any, Dict, List, Optional
 

domain/ai/vector_providers/milvus_server.py

@@ -1,5 +1,3 @@
-from __future__ import annotations
-
 from typing import Any, Dict, List, Optional
 
 from pymilvus import CollectionSchema, DataType, FieldSchema, MilvusClient

domain/ai/vector_providers/qdrant.py

@@ -1,5 +1,3 @@
-from __future__ import annotations
-
 from typing import Any, Dict, List, Optional, Sequence
 from uuid import NAMESPACE_URL, uuid5
 

domain/audit/decorator.py

@@ -95,6 +95,23 @@ def _build_request_params(request: Request | None) -> Dict[str, Any] | None:
     return params or None
 
 
+def _get_client_ip(request: Request | None) -> str | None:
+    if not request:
+        return None
+    x_real_ip = request.headers.get("x-real-ip") or request.headers.get("X-Real-IP")
+    if x_real_ip:
+        ip = x_real_ip.strip()
+        if ip:
+            return ip
+    x_forwarded_for = request.headers.get("x-forwarded-for") or request.headers.get("X-Forwarded-For")
+    if x_forwarded_for:
+        for part in x_forwarded_for.split(","):
+            ip = part.strip()
+            if ip and ip.lower() != "unknown":
+                return ip
+    return request.client.host if request.client else None
+
+
 def _status_code_from_response(response: Any) -> int:
     if hasattr(response, "status_code"):
         try:
@@ -142,7 +159,7 @@ def audit(
                         description=description,
                         user_id=user_id,
                         username=username,
-                        client_ip=request.client.host if request and request.client else None,
+                        client_ip=_get_client_ip(request),
                         method=request.method if request else "",
                         path=request.url.path if request else func.__name__,
                         status_code=status_code,
@@ -163,7 +180,7 @@ def audit(
                     description=description,
                     user_id=user_id,
                     username=username,
-                    client_ip=request.client.host if request and request.client else None,
+                    client_ip=_get_client_ip(request),
                     method=request.method if request else "",
                     path=request.url.path if request else func.__name__,
                     status_code=status_code,

domain/config/service.py

@@ -10,7 +10,7 @@ from models.database import Configuration, UserAccount
 
 load_dotenv(dotenv_path=".env")
 
-VERSION = "v1.4.0"
+VERSION = "v1.5.0"
 
 
 class ConfigService:

domain/plugins/api.py

@@ -1,12 +1,15 @@
 from typing import List
 
 from fastapi import APIRouter, Body, Request
+from fastapi.responses import FileResponse
 
 from domain.audit import AuditAction, audit
 from domain.plugins.service import PluginService
+from domain.plugins.routes import video_player as video_player_routes
 from domain.plugins.types import PluginCreate, PluginManifestUpdate, PluginOut
 
 router = APIRouter(prefix="/api/plugins", tags=["plugins"])
+router.include_router(video_player_routes.router)
 
 
 @router.post("", response_model=PluginOut)
@@ -50,6 +53,7 @@ async def update_plugin(request: Request, plugin_id: int, payload: PluginCreate)
         "key",
         "name",
         "version",
+        "open_app",
         "supported_exts",
         "default_bounds",
         "default_maximized",
@@ -64,3 +68,9 @@ async def update_manifest(
     request: Request, plugin_id: int, manifest: PluginManifestUpdate = Body(...)
 ):
     return await PluginService.update_manifest(plugin_id, manifest)
+
+
+@router.get("/{plugin_id}/bundle.js")
+async def get_bundle(request: Request, plugin_id: int):
+    path = await PluginService.get_bundle_path(plugin_id)
+    return FileResponse(path, media_type="application/javascript", headers={"Cache-Control": "no-store"})

domain/plugins/routes/__init__.py

@@ -0,0 +1,2 @@
+"""插件专属服务端路由集合。"""
+

domain/plugins/routes/video_player.py

@@ -0,0 +1,142 @@
+import json
+from datetime import UTC, datetime
+from pathlib import Path
+from typing import Any, Dict, List, Optional
+
+from fastapi import APIRouter, Depends, HTTPException, Query
+
+from api.response import success
+from domain.auth.service import get_current_active_user
+
+
+router = APIRouter(
+    prefix="/video-player",
+    tags=["plugins"],
+    dependencies=[Depends(get_current_active_user)],
+)
+
+DATA_ROOT = Path("data/.video")
+
+
+def _read_json(path: Path) -> Dict[str, Any]:
+    return json.loads(path.read_text(encoding="utf-8"))
+
+
+def _file_mtime_iso(path: Path) -> str:
+    try:
+        ts = path.stat().st_mtime
+    except FileNotFoundError:
+        return ""
+    return datetime.fromtimestamp(ts, tz=UTC).isoformat()
+
+
+def _extract_title(payload: Dict[str, Any]) -> str:
+    detail = (payload.get("tmdb") or {}).get("detail") or {}
+    if payload.get("type") == "tv":
+        return str(detail.get("name") or detail.get("original_name") or "")
+    return str(detail.get("title") or detail.get("original_title") or "")
+
+
+def _extract_year(payload: Dict[str, Any]) -> Optional[str]:
+    detail = (payload.get("tmdb") or {}).get("detail") or {}
+    value = detail.get("first_air_date") if payload.get("type") == "tv" else detail.get("release_date")
+    if not value or not isinstance(value, str):
+        return None
+    return value[:4] if len(value) >= 4 else value
+
+
+def _extract_genres(payload: Dict[str, Any]) -> List[str]:
+    detail = (payload.get("tmdb") or {}).get("detail") or {}
+    genres = detail.get("genres") or []
+    out: List[str] = []
+    if isinstance(genres, list):
+        for g in genres:
+            if isinstance(g, dict) and g.get("name"):
+                out.append(str(g["name"]))
+    return out
+
+
+def _summarize(item_id: str, payload: Dict[str, Any], mtime_iso: str) -> Dict[str, Any]:
+    detail = (payload.get("tmdb") or {}).get("detail") or {}
+    media_type = payload.get("type") or "unknown"
+    episodes = payload.get("episodes") or []
+    seasons = {e.get("season") for e in episodes if isinstance(e, dict) and e.get("season") is not None}
+
+    return {
+        "id": item_id,
+        "type": media_type,
+        "title": _extract_title(payload),
+        "year": _extract_year(payload),
+        "overview": detail.get("overview"),
+        "poster_path": detail.get("poster_path"),
+        "backdrop_path": detail.get("backdrop_path"),
+        "genres": _extract_genres(payload),
+        "tmdb_id": (payload.get("tmdb") or {}).get("id"),
+        "source_path": payload.get("source_path"),
+        "scraped_at": payload.get("scraped_at"),
+        "updated_at": mtime_iso,
+        "episodes_count": len(episodes) if isinstance(episodes, list) else 0,
+        "seasons_count": len(seasons),
+        "vote_average": detail.get("vote_average"),
+        "vote_count": detail.get("vote_count"),
+    }
+
+
+def _iter_library_files() -> List[tuple[str, Path]]:
+    files: List[tuple[str, Path]] = []
+    for sub in ("tv", "movie"):
+        folder = DATA_ROOT / sub
+        if not folder.exists():
+            continue
+        for p in folder.glob("*.json"):
+            if not p.is_file():
+                continue
+            files.append((sub, p))
+    return files
+
+
+@router.get("/library")
+async def list_library(
+    q: str | None = Query(None, description="搜索关键字（标题/简介）"),
+    media_type: str | None = Query(None, alias="type", description="tv 或 movie"),
+):
+    items: List[Dict[str, Any]] = []
+    keyword = (q or "").strip().lower()
+    type_filter = (media_type or "").strip().lower()
+    if type_filter and type_filter not in {"tv", "movie"}:
+        raise HTTPException(status_code=400, detail="type must be tv or movie")
+
+    for _sub, path in _iter_library_files():
+        item_id = path.stem
+        try:
+            payload = _read_json(path)
+        except Exception:
+            continue
+        if type_filter and str(payload.get("type") or "").lower() != type_filter:
+            continue
+        summary = _summarize(item_id, payload, _file_mtime_iso(path))
+        if keyword:
+            haystack = f"{summary.get('title') or ''} {summary.get('overview') or ''}".lower()
+            if keyword not in haystack:
+                continue
+        items.append(summary)
+
+    items.sort(key=lambda x: x.get("updated_at") or "", reverse=True)
+    return success(items)
+
+
+@router.get("/library/{item_id}")
+async def get_library_item(item_id: str):
+    candidates = [
+        DATA_ROOT / "tv" / f"{item_id}.json",
+        DATA_ROOT / "movie" / f"{item_id}.json",
+    ]
+    path = next((p for p in candidates if p.exists()), None)
+    if not path:
+        raise HTTPException(status_code=404, detail="Item not found")
+
+    payload = _read_json(path)
+    payload["id"] = item_id
+    payload["updated_at"] = _file_mtime_iso(path)
+    return success(payload)
+

domain/plugins/service.py

@@ -1,3 +1,10 @@
+import contextlib
+import re
+import shutil
+from pathlib import Path
+
+import aiofiles
+import httpx
 from fastapi import HTTPException
 
 from domain.plugins.types import PluginCreate, PluginManifestUpdate, PluginOut
@@ -5,9 +12,71 @@ from models.database import Plugin
 
 
 class PluginService:
+    _plugins_root = Path("data/plugins")
+
+    @classmethod
+    def _folder_name(cls, rec: Plugin) -> str:
+        if rec.key:
+            safe = re.sub(r"[^A-Za-z0-9_.-]", "_", rec.key)
+            return safe or str(rec.id)
+        return str(rec.id)
+
+    @classmethod
+    def _bundle_dir_from_rec(cls, rec: Plugin) -> Path:
+        return cls._plugins_root / cls._folder_name(rec) / "current"
+
+    @classmethod
+    def _bundle_path_from_rec(cls, rec: Plugin) -> Path:
+        return cls._bundle_dir_from_rec(rec) / "index.js"
+
+    @classmethod
+    async def _download_bundle(cls, rec: Plugin, url: str) -> None:
+        dest_dir = cls._bundle_dir_from_rec(rec)
+        dest_dir.mkdir(parents=True, exist_ok=True)
+        dest_path = cls._bundle_path_from_rec(rec)
+        tmp_path = dest_path.with_suffix(".tmp")
+        try:
+            async with httpx.AsyncClient(timeout=30.0, follow_redirects=True) as client:
+                async with client.stream("GET", url) as resp:
+                    resp.raise_for_status()
+                    async with aiofiles.open(tmp_path, "wb") as f:
+                        async for chunk in resp.aiter_bytes(chunk_size=65536):
+                            if not chunk:
+                                continue
+                            await f.write(chunk)
+            tmp_path.replace(dest_path)
+        except Exception:
+            with contextlib.suppress(Exception):
+                if tmp_path.exists():
+                    tmp_path.unlink()
+            raise
+
+    @classmethod
+    async def _ensure_bundle(cls, plugin_id: int) -> Path:
+        rec = await cls._get_or_404(plugin_id)
+        bundle_path = cls._bundle_path_from_rec(rec)
+        if bundle_path.exists():
+            return bundle_path
+
+        legacy = cls._plugins_root / str(rec.id) / "current" / "index.js"
+        if legacy.exists():
+            return legacy
+
+        raise HTTPException(status_code=404, detail="Plugin bundle not found")
+
+    @classmethod
+    async def get_bundle_path(cls, plugin_id: int) -> Path:
+        return await cls._ensure_bundle(plugin_id)
+
     @classmethod
     async def create(cls, payload: PluginCreate) -> PluginOut:
         rec = await Plugin.create(**payload.model_dump())
+        try:
+            await cls._download_bundle(rec, rec.url)
+        except Exception as exc:
+            with contextlib.suppress(Exception):
+                await rec.delete()
+            raise HTTPException(status_code=400, detail=f"Failed to fetch plugin: {exc}")
         return PluginOut.model_validate(rec)
 
     @classmethod
@@ -26,10 +95,21 @@ class PluginService:
     async def delete(cls, plugin_id: int) -> None:
         rec = await cls._get_or_404(plugin_id)
         await rec.delete()
+        with contextlib.suppress(Exception):
+            dirs = {cls._bundle_dir_from_rec(rec).parent, cls._plugins_root / str(rec.id)}
+            for plugin_dir in dirs:
+                if plugin_dir.exists():
+                    shutil.rmtree(plugin_dir)
 
     @classmethod
     async def update(cls, plugin_id: int, payload: PluginCreate) -> PluginOut:
         rec = await cls._get_or_404(plugin_id)
+        url_changed = rec.url != payload.url
+        if url_changed:
+            try:
+                await cls._download_bundle(rec, payload.url)
+            except Exception as exc:
+                raise HTTPException(status_code=400, detail=f"Failed to fetch plugin: {exc}")
         rec.url = payload.url
         rec.enabled = payload.enabled
         await rec.save()
@@ -40,9 +120,19 @@ class PluginService:
         cls, plugin_id: int, manifest: PluginManifestUpdate
     ) -> PluginOut:
         rec = await cls._get_or_404(plugin_id)
+        old_dir = cls._bundle_dir_from_rec(rec).parent
         updates = manifest.model_dump(exclude_none=True)
         if updates:
             for key, value in updates.items():
                 setattr(rec, key, value)
             await rec.save()
+            new_dir = cls._bundle_dir_from_rec(rec).parent
+            if rec.key and new_dir != old_dir:
+                candidate_dir = old_dir if old_dir.exists() else (cls._plugins_root / str(rec.id))
+                if candidate_dir.exists():
+                    new_dir.parent.mkdir(parents=True, exist_ok=True)
+                    with contextlib.suppress(Exception):
+                        if new_dir.exists():
+                            shutil.rmtree(new_dir)
+                        shutil.move(str(candidate_dir), str(new_dir))
         return PluginOut.model_validate(rec)

domain/plugins/types.py

@@ -14,6 +14,10 @@ class PluginManifestUpdate(BaseModel):
     key: Optional[str] = None
     name: Optional[str] = None
     version: Optional[str] = None
+    open_app: Optional[bool] = Field(
+        default=None,
+        validation_alias=AliasChoices("open_app", "openApp"),
+    )
     supported_exts: Optional[List[str]] = Field(
         default=None,
         validation_alias=AliasChoices("supported_exts", "supportedExts"),
@@ -37,6 +41,7 @@ class PluginOut(BaseModel):
     id: int
     url: str
     enabled: bool
+    open_app: bool = False
     key: Optional[str] = None
     name: Optional[str] = None
     version: Optional[str] = None

domain/processors/base.py

@@ -6,9 +6,11 @@ class BaseProcessor(Protocol):
     supported_exts: list
     config_schema: list
     produces_file: bool
+    supports_directory: bool
+    requires_input_bytes: bool
 
-    async def process(self, input_bytes: bytes, path: str, config: Dict[str, Any]) -> bytes:
-        """处理文件内容并返回处理后的内容"""
+    async def process(self, input_bytes: bytes, path: str, config: Dict[str, Any]) -> Any:
+        """处理文件内容/路径并返回结果。produces_file=True 时应返回 bytes/Response。"""
         ...
 
 # 约定：每个处理器需定义

domain/processors/builtin/video_library.py

@@ -0,0 +1,396 @@
+import hashlib
+import json
+import os
+import re
+from datetime import UTC, datetime
+from pathlib import Path
+from typing import Any, Dict, List, Optional, Tuple
+
+import httpx
+
+from domain.virtual_fs.service import VirtualFSService
+from domain.virtual_fs.thumbnail import VIDEO_EXT, is_video_filename
+
+
+DATA_ROOT = Path("data/.video")
+TMDB_BASE_URL = "https://api.themoviedb.org/3"
+
+
+def _sha1(text: str) -> str:
+    return hashlib.sha1(text.encode("utf-8")).hexdigest()
+
+
+def _store_path(media_type: str, source_path: str) -> Path:
+    subdir = "tv" if media_type == "tv" else "movie"
+    return DATA_ROOT / subdir / f"{_sha1(source_path)}.json"
+
+
+def _write_json(path: Path, payload: dict) -> None:
+    path.parent.mkdir(parents=True, exist_ok=True)
+    path.write_text(json.dumps(payload, ensure_ascii=False, indent=2), encoding="utf-8")
+
+
+_CLEAN_TAGS_RE = re.compile(
+    r"\b("
+    r"2160p|1080p|720p|480p|4k|hdr|dv|dolby|atmos|"
+    r"x264|x265|h264|h265|hevc|av1|aac|dts|flac|"
+    r"bluray|bdrip|web[- ]?dl|webrip|dvdrip|remux|proper|repack"
+    r")\b",
+    re.IGNORECASE,
+)
+
+
+def _clean_query_name(raw: str) -> str:
+    name = raw
+    name = name.replace(".", " ").replace("_", " ")
+    name = re.sub(r"\[[^\]]*\]", " ", name)
+    name = re.sub(r"\([^\)]*\)", " ", name)
+    name = _CLEAN_TAGS_RE.sub(" ", name)
+    name = re.sub(r"\s+", " ", name).strip()
+    return name
+
+
+def _guess_name_from_path(path: str, is_dir: bool) -> str:
+    norm = path.rstrip("/") if is_dir else path
+    p = Path(norm)
+    raw = p.name if is_dir else p.stem
+    return _clean_query_name(raw)
+
+
+def _as_bool(value: Any, default: bool) -> bool:
+    if value is None:
+        return default
+    if isinstance(value, bool):
+        return value
+    if isinstance(value, int):
+        return value != 0
+    if isinstance(value, str):
+        v = value.strip().lower()
+        if v in {"1", "true", "yes", "y", "on"}:
+            return True
+        if v in {"0", "false", "no", "n", "off"}:
+            return False
+    return default
+
+
+_SXXEYY_RE = re.compile(r"[Ss](\d{1,2})\s*[.\-_ ]*\s*[Ee](\d{1,3})")
+_X_RE = re.compile(r"(\d{1,2})x(\d{1,3})", re.IGNORECASE)
+_CN_EP_RE = re.compile(r"第\s*(\d{1,3})\s*[集话]")
+_CN_SEASON_RE = re.compile(r"第\s*(\d{1,2})\s*季")
+_SEASON_WORD_RE = re.compile(r"Season\s*(\d{1,2})", re.IGNORECASE)
+_S_RE = re.compile(r"[Ss](\d{1,2})")
+
+
+def _parse_season_episode(rel_path: str) -> Tuple[Optional[int], Optional[int]]:
+    stem = Path(rel_path).stem
+
+    m = _SXXEYY_RE.search(stem) or _SXXEYY_RE.search(rel_path)
+    if m:
+        return int(m.group(1)), int(m.group(2))
+
+    m = _X_RE.search(stem)
+    if m:
+        return int(m.group(1)), int(m.group(2))
+
+    m = _CN_EP_RE.search(stem)
+    if m:
+        episode = int(m.group(1))
+        season = None
+        for part in reversed(Path(rel_path).parts[:-1]):
+            sm = _CN_SEASON_RE.search(part) or _SEASON_WORD_RE.search(part) or _S_RE.search(part)
+            if sm:
+                season = int(sm.group(1))
+                break
+        return season or 1, episode
+
+    m = re.match(r"^(\d{1,3})(?!\d)", stem)
+    if m:
+        episode = int(m.group(1))
+        season = None
+        for part in reversed(Path(rel_path).parts[:-1]):
+            sm = _CN_SEASON_RE.search(part) or _SEASON_WORD_RE.search(part) or _S_RE.search(part)
+            if sm:
+                season = int(sm.group(1))
+                break
+        return season or 1, episode
+
+    return None, None
+
+
+class TMDBClient:
+    def __init__(self, access_token: str | None, api_key: str | None):
+        self._access_token = access_token
+        self._api_key = api_key
+
+    @classmethod
+    def from_env(cls) -> "TMDBClient":
+        access_token = os.getenv("TMDB_ACCESS_TOKEN")
+        api_key = os.getenv("TMDB_API_KEY")
+        if not access_token and not api_key:
+            raise RuntimeError("缺少 TMDB_ACCESS_TOKEN 或 TMDB_API_KEY")
+        return cls(access_token=access_token, api_key=api_key)
+
+    def _headers(self) -> dict:
+        headers = {"Accept": "application/json"}
+        if self._access_token:
+            headers["Authorization"] = f"Bearer {self._access_token}"
+        return headers
+
+    def _merge_params(self, params: dict) -> dict:
+        merged = dict(params or {})
+        if self._api_key:
+            merged.setdefault("api_key", self._api_key)
+        return merged
+
+    async def get(self, path: str, params: dict) -> dict:
+        url = f"{TMDB_BASE_URL}{path}"
+        async with httpx.AsyncClient(timeout=30.0) as client:
+            resp = await client.get(url, headers=self._headers(), params=self._merge_params(params))
+            resp.raise_for_status()
+            return resp.json()
+
+
+class VideoLibraryProcessor:
+    name = "影视入库"
+    supported_exts = sorted(VIDEO_EXT)
+    config_schema = [
+        {
+            "key": "name",
+            "label": "手动名称（可选）",
+            "type": "string",
+            "required": False,
+            "placeholder": "留空则从路径提取",
+        },
+        {
+            "key": "language",
+            "label": "语言",
+            "type": "string",
+            "required": False,
+            "default": "zh-CN",
+        },
+        {
+            "key": "include_episodes",
+            "label": "电视剧：保存每集",
+            "type": "select",
+            "required": False,
+            "default": 1,
+            "options": [
+                {"label": "是", "value": 1},
+                {"label": "否", "value": 0},
+            ],
+        },
+    ]
+    produces_file = False
+    supports_directory = True
+    requires_input_bytes = False
+
+    async def process(self, input_bytes: bytes, path: str, config: Dict[str, Any]) -> Dict[str, Any]:
+        tmdb = TMDBClient.from_env()
+        is_dir = await VirtualFSService.path_is_directory(path)
+        language = str(config.get("language") or "zh-CN")
+        manual_name = str(config.get("name") or "").strip()
+        query_name = manual_name or _guess_name_from_path(path, is_dir=is_dir)
+        scraped_at = datetime.now(UTC).isoformat()
+
+        if is_dir:
+            payload, saved_to = await self._process_tv_dir(tmdb, path, query_name, language, scraped_at, config)
+            return {
+                "ok": True,
+                "type": "tv",
+                "path": path,
+                "tmdb_id": payload.get("tmdb", {}).get("id"),
+                "saved_to": str(saved_to),
+            }
+
+        payload, saved_to = await self._process_movie_file(tmdb, path, query_name, language, scraped_at)
+        return {
+            "ok": True,
+            "type": "movie",
+            "path": path,
+            "tmdb_id": payload.get("tmdb", {}).get("id"),
+            "saved_to": str(saved_to),
+        }
+
+    async def _process_movie_file(
+        self,
+        tmdb: TMDBClient,
+        path: str,
+        query_name: str,
+        language: str,
+        scraped_at: str,
+    ) -> Tuple[dict, Path]:
+        search = await tmdb.get("/search/movie", {"query": query_name, "language": language})
+        results = search.get("results") or []
+        if not results:
+            raise RuntimeError(f"未找到电影条目：{query_name}")
+
+        chosen = results[0] or {}
+        movie_id = chosen.get("id")
+        if not movie_id:
+            raise RuntimeError("TMDB 搜索结果缺少 id")
+
+        detail = await tmdb.get(
+            f"/movie/{movie_id}",
+            {
+                "language": language,
+                "append_to_response": "credits,images,external_ids,videos",
+            },
+        )
+
+        payload = {
+            "type": "movie",
+            "source_path": path,
+            "query": {"name": query_name, "language": language},
+            "scraped_at": scraped_at,
+            "tmdb": {
+                "id": movie_id,
+                "search": {"page": search.get("page"), "total_results": search.get("total_results"), "results": results[:5]},
+                "detail": detail,
+            },
+        }
+        saved_to = _store_path("movie", path)
+        _write_json(saved_to, payload)
+        return payload, saved_to
+
+    async def _process_tv_dir(
+        self,
+        tmdb: TMDBClient,
+        path: str,
+        query_name: str,
+        language: str,
+        scraped_at: str,
+        config: Dict[str, Any],
+    ) -> Tuple[dict, Path]:
+        search = await tmdb.get("/search/tv", {"query": query_name, "language": language})
+        results = search.get("results") or []
+        if not results:
+            raise RuntimeError(f"未找到电视剧条目：{query_name}")
+
+        chosen = results[0] or {}
+        tv_id = chosen.get("id")
+        if not tv_id:
+            raise RuntimeError("TMDB 搜索结果缺少 id")
+
+        detail = await tmdb.get(
+            f"/tv/{tv_id}",
+            {
+                "language": language,
+                "append_to_response": "credits,images,external_ids,videos",
+            },
+        )
+
+        include_episodes = _as_bool(config.get("include_episodes"), True)
+        episodes: List[dict] = []
+        seasons_detail: Dict[str, Any] = {}
+        if include_episodes:
+            episodes = await self._collect_episode_files(path)
+            seasons = sorted({ep["season"] for ep in episodes if ep.get("season") is not None})
+            for season in seasons:
+                seasons_detail[str(season)] = await tmdb.get(
+                    f"/tv/{tv_id}/season/{int(season)}",
+                    {"language": language},
+                )
+            self._attach_tmdb_episode_detail(episodes, seasons_detail)
+
+        payload = {
+            "type": "tv",
+            "source_path": path,
+            "query": {"name": query_name, "language": language},
+            "scraped_at": scraped_at,
+            "tmdb": {
+                "id": tv_id,
+                "search": {"page": search.get("page"), "total_results": search.get("total_results"), "results": results[:5]},
+                "detail": detail,
+                "seasons": seasons_detail,
+            },
+            "episodes": episodes,
+        }
+
+        saved_to = _store_path("tv", path)
+        _write_json(saved_to, payload)
+        return payload, saved_to
+
+    async def _collect_episode_files(self, dir_path: str) -> List[dict]:
+        adapter_instance, adapter_model, root, rel = await VirtualFSService.resolve_adapter_and_rel(dir_path)
+        rel = rel.rstrip("/")
+        list_dir = await VirtualFSService._ensure_method(adapter_instance, "list_dir")
+
+        stack: List[str] = [rel]
+        page_size = 200
+        out: List[dict] = []
+
+        while stack:
+            current_rel = stack.pop()
+            page = 1
+            while True:
+                entries, total = await list_dir(root, current_rel, page, page_size, "name", "asc")
+                entries = entries or []
+                if not entries and (total or 0) == 0:
+                    break
+
+                for entry in entries:
+                    name = entry.get("name")
+                    if not name:
+                        continue
+                    child_rel = VirtualFSService._join_rel(current_rel, name)
+                    if entry.get("is_dir"):
+                        stack.append(child_rel.rstrip("/"))
+                        continue
+                    if not is_video_filename(name):
+                        continue
+
+                    absolute_path = VirtualFSService._build_absolute_path(adapter_model.path, child_rel)
+                    rel_in_show = child_rel
+                    if rel and child_rel.startswith(rel.rstrip("/") + "/"):
+                        rel_in_show = child_rel[len(rel.rstrip("/")) + 1 :]
+
+                    season, episode = _parse_season_episode(rel_in_show)
+                    out.append(
+                        {
+                            "path": absolute_path,
+                            "rel": rel_in_show,
+                            "name": name,
+                            "size": entry.get("size"),
+                            "mtime": entry.get("mtime"),
+                            "season": season,
+                            "episode": episode,
+                        }
+                    )
+
+                if total is None or page * page_size >= total:
+                    break
+                page += 1
+
+        return out
+
+    def _attach_tmdb_episode_detail(self, episodes: List[dict], seasons_detail: Dict[str, Any]) -> None:
+        episode_maps: Dict[str, Dict[int, Any]] = {}
+        for season_str, season_payload in (seasons_detail or {}).items():
+            items = (season_payload or {}).get("episodes") or []
+            m: Dict[int, Any] = {}
+            for item in items:
+                try:
+                    number = int(item.get("episode_number"))
+                except Exception:
+                    continue
+                m[number] = item
+            episode_maps[season_str] = m
+
+        for ep in episodes:
+            season = ep.get("season")
+            episode = ep.get("episode")
+            if season is None or episode is None:
+                continue
+            m = episode_maps.get(str(season))
+            if not m:
+                continue
+            detail = m.get(int(episode))
+            if detail:
+                ep["tmdb_episode"] = detail
+
+
+PROCESSOR_TYPE = "video_library"
+PROCESSOR_NAME = VideoLibraryProcessor.name
+SUPPORTED_EXTS = VideoLibraryProcessor.supported_exts
+CONFIG_SCHEMA = VideoLibraryProcessor.config_schema
+PROCESSOR_FACTORY = lambda: VideoLibraryProcessor()

domain/processors/registry.py

@@ -74,6 +74,10 @@ def discover_processors(force_reload: bool = False) -> list[str]:
         if produces_file is None and hasattr(sample, "produces_file"):
             produces_file = getattr(sample, "produces_file")
 
+        supports_directory = getattr(module, "supports_directory", None)
+        if supports_directory is None and hasattr(sample, "supports_directory"):
+            supports_directory = getattr(sample, "supports_directory")
+
         module_file = getattr(module, "__file__", None)
         module_path: Optional[str] = None
         if module_file:
@@ -101,6 +105,7 @@ def discover_processors(force_reload: bool = False) -> list[str]:
                 "supported_exts": normalized_exts,
                 "config_schema": schema,
                 "produces_file": produces_file if produces_file is not None else False,
+                "supports_directory": supports_directory if supports_directory is not None else False,
                 "module_path": module_path,
             }
 

domain/processors/service.py

@@ -35,14 +35,20 @@ class ProcessorService:
                 "supported_exts": meta.get("supported_exts", []),
                 "config_schema": meta["config_schema"],
                 "produces_file": meta.get("produces_file", False),
+                "supports_directory": meta.get("supports_directory", False),
                 "module_path": meta.get("module_path"),
             })
         return out
 
     @classmethod
     async def process_file(cls, req: ProcessRequest):
+        processor = cls.get_processor(req.processor_type)
+        if not processor:
+            raise HTTPException(404, detail="Processor not found")
+
         is_dir = await VirtualFSService.path_is_directory(req.path)
-        if is_dir and not req.overwrite:
+        supports_directory = bool(getattr(processor, "supports_directory", False))
+        if is_dir and not supports_directory and not req.overwrite:
             raise HTTPException(400, detail="Directory processing requires overwrite")
 
         save_to = None if is_dir else (req.path if req.overwrite else req.save_to)

domain/tasks/task_queue.py

@@ -105,7 +105,10 @@ class TaskQueueService:
                     if not processor:
                         raise ValueError(f"Processor {processor_type} not found for task {auto_task.id}")
 
-                file_content = await VirtualFSService.read_file(path)
+                requires_input_bytes = bool(getattr(processor, "requires_input_bytes", True))
+                file_content = b""
+                if requires_input_bytes:
+                    file_content = await VirtualFSService.read_file(path)
                 result = await processor.process(file_content, path, auto_task.processor_config)
                 
                 save_to = auto_task.processor_config.get("save_to")

domain/virtual_fs/common.py

@@ -1,5 +1,3 @@
-from __future__ import annotations
-
 from pathlib import Path
 from typing import Any
 

domain/virtual_fs/file_ops.py

@@ -1,5 +1,3 @@
-from __future__ import annotations
-
 import mimetypes
 from typing import Any, AsyncIterator, Union
 

domain/virtual_fs/listing.py

@@ -1,5 +1,3 @@
-from __future__ import annotations
-
 from typing import Any, Dict, List, Tuple
 
 from fastapi import HTTPException

domain/virtual_fs/mapping/s3_api.py

@@ -1,5 +1,3 @@
-from __future__ import annotations
-
 import base64
 import datetime as dt
 import hashlib
@@ -71,7 +69,7 @@ async def _ensure_enabled() -> Optional[Response]:
 
 async def _get_settings() -> Tuple[Optional[S3Settings], Optional[Response]]:
     bucket = (await ConfigService.get("S3_MAPPING_BUCKET", "foxel")) or "foxel"
-    region = (await ConfigService.get("S3_MAPPING_REGION", "us-east-1")) or "us-east-1"
+    region = ((await ConfigService.get("S3_MAPPING_REGION", "")) or "").strip()
     base_path = (await ConfigService.get("S3_MAPPING_BASE_PATH", "/")) or "/"
     access_key = (await ConfigService.get("S3_MAPPING_ACCESS_KEY")) or ""
     secret_key = (await ConfigService.get("S3_MAPPING_SECRET_KEY")) or ""
@@ -147,7 +145,7 @@ async def _authorize_sigv4(request: Request, settings: S3Settings) -> Optional[R
         return _s3_error("InvalidAccessKeyId", "The AWS Access Key Id you provided does not exist in our records.", status=403)
     if service != "s3":
         return _s3_error("InvalidRequest", "Only service 's3' is supported", status=400)
-    if region != settings["region"]:
+    if settings.get("region") and region != settings["region"]:
         return _s3_error("AuthorizationHeaderMalformed", f"Region '{region}' is invalid", status=400)
 
     amz_date = request.headers.get("x-amz-date")

domain/virtual_fs/mapping/webdav_api.py

@@ -1,4 +1,3 @@
-from __future__ import annotations
 import base64
 import hashlib
 import mimetypes

domain/virtual_fs/processing.py

@@ -1,5 +1,3 @@
-from __future__ import annotations
-
 from typing import Any
 
 from fastapi import HTTPException
@@ -25,6 +23,11 @@ class VirtualFSProcessingMixin(VirtualFSTransferMixin):
             raise HTTPException(400, detail=f"Processor {processor_type} not found")
 
         actual_is_dir = await cls.path_is_directory(path)
+        requires_input_bytes = bool(getattr(processor, "requires_input_bytes", True))
+        if actual_is_dir and bool(getattr(processor, "supports_directory", False)):
+            if save_to:
+                raise HTTPException(400, detail="Directory processing does not support custom save_to path")
+            return await processor.process(b"", path, config)
 
         supported_exts = getattr(processor, "supported_exts", None) or []
         allowed_exts = {str(ext).lower().lstrip(".") for ext in supported_exts if isinstance(ext, str)}
@@ -78,7 +81,9 @@ class VirtualFSProcessingMixin(VirtualFSTransferMixin):
                         if not matches_extension(child_rel):
                             continue
                         absolute_path = cls._build_absolute_path(adapter_model.path, child_rel)
-                        data = await cls.read_file(absolute_path)
+                        data = b""
+                        if requires_input_bytes:
+                            data = await cls.read_file(absolute_path)
                         result = await processor.process(data, absolute_path, config)
                         if getattr(processor, "produces_file", False):
                             result_bytes = coerce_result_bytes(result)
@@ -91,7 +96,9 @@ class VirtualFSProcessingMixin(VirtualFSTransferMixin):
 
             return {"processed_files": processed_count}
 
-        data = await cls.read_file(path)
+        data = b""
+        if requires_input_bytes:
+            data = await cls.read_file(path)
         result = await processor.process(data, path, config)
 
         target_path = save_to

domain/virtual_fs/resolver.py

@@ -1,5 +1,3 @@
-from __future__ import annotations
-
 from typing import Tuple
 
 from fastapi import HTTPException

domain/virtual_fs/routes.py

@@ -1,5 +1,3 @@
-from __future__ import annotations
-
 import mimetypes
 import re
 

domain/virtual_fs/service.py

@@ -1,5 +1,3 @@
-from __future__ import annotations
-
 from .common import VirtualFSCommonMixin
 from .resolver import VirtualFSResolverMixin
 from .listing import VirtualFSListingMixin

domain/virtual_fs/temp_link.py

@@ -1,5 +1,3 @@
-from __future__ import annotations
-
 import base64
 import hashlib
 import hmac

domain/virtual_fs/thumbnail.py

@@ -1,4 +1,3 @@
-from __future__ import annotations
 import asyncio
 import inspect
 import io
@@ -14,8 +13,12 @@ ALLOWED_EXT = {"jpg", "jpeg", "png", "webp", "gif", "bmp",
 RAW_EXT = {"arw", "cr2", "cr3", "nef", "rw2", "orf", "pef", "dng"}
 VIDEO_EXT = {"mp4", "mov", "m4v", "avi", "mkv", "wmv", "flv", "webm", "mpg", "mpeg", "3gp"}
 MAX_IMAGE_SOURCE_SIZE = 200 * 1024 * 1024
-VIDEO_RANGE_LIMIT = 16 * 1024 * 1024  # 16MB
-VIDEO_INITIAL_CHUNK = 4 * 1024 * 1024
+VIDEO_TAIL_LIMIT = 2 * 1024 * 1024  # 2MB
+VIDEO_TAIL_FALLBACK_LIMIT = 4 * 1024 * 1024  # 4MB
+VIDEO_HEAD_LIMIT = 2 * 1024 * 1024  # 2MB
+VIDEO_HEAD_FALLBACK_LIMIT = 4 * 1024 * 1024  # 4MB
+VIDEO_THUMB_SEEK_SECONDS = (15, 10, 5, 3, 1, 0)
+VIDEO_BLACK_FRAME_MEAN_THRESHOLD = 12.0
 CACHE_ROOT = Path('data/.thumb_cache')
 
 
@@ -177,42 +180,58 @@ async def _read_range_slice(adapter, root: str, rel: str, start: int, end: int)
     return b""
 
 
-async def _read_video_prefix(adapter, root: str, rel: str, size: int, limit: int = VIDEO_RANGE_LIMIT) -> bytes:
-    chunk_size = min(VIDEO_INITIAL_CHUNK, limit)
-    offset = 0
-    collected = bytearray()
-
-    while len(collected) < limit:
-        end = offset + chunk_size - 1
-        data = await _read_range_slice(adapter, root, rel, offset, end)
-        if not data:
-            break
-        collected.extend(data)
-        if len(data) < chunk_size:
-            break
-        offset += len(data)
-        remaining = limit - len(collected)
-        if remaining <= 0:
-            break
-        chunk_size = min(chunk_size * 2, remaining)
-
-    if not collected and size <= limit:
-        read_file = getattr(adapter, "read_file", None)
-        if callable(read_file):
-            blob = await read_file(root, rel)
-            if blob:
-                return bytes(blob[:limit])
-
-    return bytes(collected[:limit])
+async def _read_video_head(adapter, root: str, rel: str, size: int, limit: int = VIDEO_HEAD_LIMIT) -> bytes:
+    end = limit - 1
+    if size > 0:
+        end = min(end, size - 1)
+    if end < 0:
+        return b""
+    return await _read_range_slice(adapter, root, rel, 0, end)
 
 
-async def _run_ffmpeg_extract_frame(src_path: str, dst_path: str):
+async def _read_video_tail(adapter, root: str, rel: str, size: int, limit: int) -> Tuple[bytes, int]:
+    if size <= 0:
+        return b"", 0
+    start = max(0, size - limit)
+    end = size - 1
+    data = await _read_range_slice(adapter, root, rel, start, end)
+    return data, start
+
+
+def _write_video_sparse_file(rel: str, head_bytes: bytes, tail_bytes: bytes, tail_offset: int) -> str:
+    suffix = Path(rel).suffix or ".mp4"
+    src_tmp = tempfile.NamedTemporaryFile(suffix=suffix, delete=False)
+    src_path = src_tmp.name
+    try:
+        if head_bytes:
+            src_tmp.write(head_bytes)
+            src_tmp.flush()
+    finally:
+        src_tmp.close()
+
+    if tail_bytes:
+        with open(src_path, "r+b") as f:
+            f.seek(max(0, int(tail_offset)))
+            f.write(tail_bytes)
+            f.flush()
+    return src_path
+
+
+async def _run_ffmpeg_extract_frame(src_path: str, dst_path: str, *, seek_seconds: float | None = None):
     cmd = [
         "ffmpeg",
         "-y",
         "-hide_banner",
         "-loglevel", "error",
-        "-i", src_path,
+    ]
+    is_http_input = src_path.startswith(("http://", "https://"))
+    if is_http_input and seek_seconds is not None:
+        cmd += ["-ss", str(seek_seconds), "-i", src_path]
+    else:
+        cmd += ["-i", src_path]
+        if seek_seconds is not None:
+            cmd += ["-ss", str(seek_seconds)]
+    cmd += [
         "-frames:v", "1",
         dst_path,
     ]
@@ -231,32 +250,72 @@ async def _run_ffmpeg_extract_frame(src_path: str, dst_path: str):
         raise RuntimeError(message)
 
 
-async def _generate_video_thumb(video_bytes: bytes, rel: str, w: int, h: int, fit: str) -> Tuple[bytes, str]:
-    from PIL import Image
+def _frame_mean_luma(im) -> float:
+    from PIL import ImageStat
+    gray = im.convert("L").resize((64, 64))
+    return float(ImageStat.Stat(gray).mean[0])
 
-    suffix = Path(rel).suffix or ".mp4"
-    src_tmp = tempfile.NamedTemporaryFile(suffix=suffix, delete=False)
-    src_path = src_tmp.name
-    try:
-        src_tmp.write(video_bytes)
-        src_tmp.flush()
-    finally:
-        src_tmp.close()
+
+def _is_black_image_bytes(image_bytes: bytes) -> bool:
+    from PIL import Image
+    with Image.open(io.BytesIO(image_bytes)) as im:
+        im.load()
+        return _frame_mean_luma(im) < VIDEO_BLACK_FRAME_MEAN_THRESHOLD
+
+
+async def _generate_video_thumb_from_src_path(src_path: str, w: int, h: int, fit: str) -> Tuple[bytes, str]:
+    from PIL import Image
 
     dst_tmp = tempfile.NamedTemporaryFile(suffix=".png", delete=False)
     dst_path = dst_tmp.name
     dst_tmp.close()
 
+    best: tuple[float, bytes, str] | None = None
+    last_error: Exception | None = None
     try:
-        await _run_ffmpeg_extract_frame(src_path, dst_path)
-        with Image.open(dst_path) as im:
-            im.load()
-            return _image_to_webp(im, w, h, fit)
+        for seek_seconds in VIDEO_THUMB_SEEK_SECONDS:
+            try:
+                with suppress(FileNotFoundError):
+                    Path(dst_path).unlink()
+                await _run_ffmpeg_extract_frame(src_path, dst_path, seek_seconds=seek_seconds)
+                with Image.open(dst_path) as im:
+                    im.load()
+                    mean = _frame_mean_luma(im)
+                    webp_bytes, mime = _image_to_webp(im, w, h, fit)
+
+                if best is None or mean > best[0]:
+                    best = (mean, webp_bytes, mime)
+                if mean >= VIDEO_BLACK_FRAME_MEAN_THRESHOLD:
+                    return webp_bytes, mime
+            except Exception as e:
+                last_error = e
+                continue
+
+        if best is not None:
+            return best[1], best[2]
+        if last_error is not None:
+            raise last_error
+        raise RuntimeError("ffmpeg 截帧失败")
+    finally:
+        with suppress(FileNotFoundError):
+            Path(dst_path).unlink()
+
+
+async def _generate_video_thumb_from_segments(
+    head_bytes: bytes,
+    tail_bytes: bytes,
+    tail_offset: int,
+    rel: str,
+    w: int,
+    h: int,
+    fit: str,
+) -> Tuple[bytes, str]:
+    src_path = _write_video_sparse_file(rel, head_bytes, tail_bytes, tail_offset)
+    try:
+        return await _generate_video_thumb_from_src_path(src_path, w, h, fit)
     finally:
         with suppress(FileNotFoundError):
             Path(src_path).unlink()
-        with suppress(FileNotFoundError):
-            Path(dst_path).unlink()
 
 
 async def get_or_create_thumb(adapter, adapter_id: int, root: str, rel: str, w: int, h: int, fit: str = 'cover'):
@@ -295,23 +354,82 @@ async def get_or_create_thumb(adapter, adapter_id: int, root: str, rel: str, w:
 
     if not thumb_bytes:
         if is_video:
-            try:
-                video_bytes = await _read_video_prefix(adapter, root, rel, size)
-            except HTTPException:
-                raise
-            except Exception as e:
-                print(f"Video prefix read failed: {e}")
-                raise HTTPException(500, detail=f"Video read failed: {e}")
+            async def _maybe_transcoding_thumb() -> Tuple[bytes, str] | None:
+                fid = (stat or {}).get("fid") if isinstance(stat, dict) else None
+                get_url = getattr(adapter, "get_video_transcoding_url", None)
+                if not fid or not callable(get_url):
+                    return None
+                try:
+                    url = await get_url(str(fid))
+                except Exception as e:
+                    print(f"Video transcoding url fetch failed: {e}")
+                    return None
+                if not url:
+                    return None
+                try:
+                    return await _generate_video_thumb_from_src_path(url, w, h, fit)
+                except Exception as e:
+                    print(f"Video transcoding thumbnail generation failed: {e}")
+                    return None
 
-            if not video_bytes:
+            def _is_hevc_decoder_missing(exc: Exception) -> bool:
+                msg = str(exc).lower()
+                return ("no decoder found" in msg) and ("hevc" in msg or "h265" in msg)
+
+            async def _read_head(limit: int) -> bytes:
+                try:
+                    return await _read_video_head(adapter, root, rel, size, limit=limit)
+                except HTTPException:
+                    raise
+                except Exception as e:
+                    print(f"Video head read failed: {e}")
+                    raise HTTPException(500, detail=f"Video read failed: {e}")
+
+            async def _read_tail(limit: int) -> Tuple[bytes, int]:
+                try:
+                    return await _read_video_tail(adapter, root, rel, size, limit=limit)
+                except HTTPException:
+                    raise
+                except Exception as e:
+                    print(f"Video tail read failed: {e}")
+                    raise HTTPException(500, detail=f"Video read failed: {e}")
+
+            head_bytes = await _read_head(VIDEO_HEAD_LIMIT)
+            tail_bytes, tail_offset = await _read_tail(VIDEO_TAIL_LIMIT)
+            if not head_bytes and not tail_bytes:
                 raise HTTPException(500, detail="Unable to read video data for thumbnail")
 
             try:
-                thumb_bytes, mime = await _generate_video_thumb(video_bytes, rel, w, h, fit)
-            except Exception as e:
-                print(f"Video thumbnail generation failed: {e}")
-                raise HTTPException(
-                    500, detail=f"Video thumbnail generation failed: {e}")
+                thumb_bytes, mime = await _generate_video_thumb_from_segments(
+                    head_bytes, tail_bytes, tail_offset, rel, w, h, fit
+                )
+            except Exception as e1:
+                if _is_hevc_decoder_missing(e1):
+                    got = await _maybe_transcoding_thumb()
+                    if got is not None:
+                        thumb_bytes, mime = got
+                if not thumb_bytes:
+                    try:
+                        tail_bytes, tail_offset = await _read_tail(VIDEO_TAIL_FALLBACK_LIMIT)
+                        thumb_bytes, mime = await _generate_video_thumb_from_segments(
+                            head_bytes, tail_bytes, tail_offset, rel, w, h, fit
+                        )
+                    except HTTPException:
+                        raise
+                    except Exception as e2:
+                        print(f"Video thumbnail generation failed: {e2}")
+                        raise HTTPException(500, detail=f"Video thumbnail generation failed: {e2}")
+
+            if thumb_bytes and _is_black_image_bytes(thumb_bytes):
+                try:
+                    head_bytes = await _read_head(VIDEO_HEAD_FALLBACK_LIMIT)
+                    retry_thumb, retry_mime = await _generate_video_thumb_from_segments(
+                        head_bytes, tail_bytes, tail_offset, rel, w, h, fit
+                    )
+                    if retry_thumb and not _is_black_image_bytes(retry_thumb):
+                        thumb_bytes, mime = retry_thumb, retry_mime
+                except Exception:
+                    pass
         else:
             read_data = await adapter.read_file(root, rel)
             try:

domain/virtual_fs/transfer.py

@@ -1,5 +1,3 @@
-from __future__ import annotations
-
 import shutil
 from pathlib import Path
 from typing import Any, Dict, List, Tuple

models/database.py

@@ -171,6 +171,8 @@ class Plugin(Model):
     url = fields.CharField(max_length=2048)
     enabled = fields.BooleanField(default=True)
 
+    open_app = fields.BooleanField(default=False)
+
     key = fields.CharField(max_length=100, null=True)
     name = fields.CharField(max_length=255, null=True)
     version = fields.CharField(max_length=50, null=True)

pyproject.toml

@@ -18,7 +18,7 @@ dependencies = [
     "qdrant-client>=1.15.1",
     "rawpy>=0.25.1",
     "telethon>=1.41.2",
-    "tortoise-orm>=0.25.1",
+    "tortoise-orm>=0.25.2",
     "uvicorn>=0.37.0",
     "pymilvus[milvus-lite]>=2.6.2",
     "paramiko>=4.0.0",

setup/foxel.sh

@@ -1,31 +1,30 @@
 #!/bin/bash
 
-#================================================================================
-# Foxel 一键部署与更新脚本
 #
-# 作者: maxage
-# 版本: 1.7 (增加下载镜像, 解决网络问题)
-# 描述: 此脚本用于自动化安装、配置和管理 Foxel 项目 (使用 Docker Compose)。
-#       - 智能检测现有安装，提供安装向导和管理菜单两种模式。
-#       - 自动检测并安装依赖。
-#       - 为国内用户提供镜像源切换选项。
-#
-# 一键运行命令:
+# Foxel 一键安装与管理脚本（Docker Compose）
+# 一键运行：
 # bash <(curl -sL "https://raw.githubusercontent.com/DrizzleTime/Foxel/main/setup/foxel.sh?_=$(date +%s)")
-#================================================================================
+#
 
-# --- 消息打印函数 ---
-info() {
-    echo "[信息] $1"
-}
+# --- 输出（可关闭颜色：NO_COLOR=1） ---
+if [[ -t 1 && -z "${NO_COLOR:-}" ]]; then
+    C_RESET='\033[0m'
+    C_RED='\033[31m'
+    C_GREEN='\033[32m'
+    C_YELLOW='\033[33m'
+    C_BLUE='\033[34m'
+else
+    C_RESET=''
+    C_RED=''
+    C_GREEN=''
+    C_YELLOW=''
+    C_BLUE=''
+fi
 
-warn() {
-    echo "[警告] $1"
-}
-
-error() {
-    echo "[错误] $1"
-}
+info() { printf "%b[信息]%b %s\n" "$C_BLUE" "$C_RESET" "$*"; }
+success() { printf "%b[成功]%b %s\n" "$C_GREEN" "$C_RESET" "$*"; }
+warn() { printf "%b[警告]%b %s\n" "$C_YELLOW" "$C_RESET" "$*"; }
+error() { printf "%b[错误]%b %s\n" "$C_RED" "$C_RESET" "$*"; }
 
 # --- 基础函数 ---
 command_exists() {
@@ -34,16 +33,33 @@ command_exists() {
 
 confirm_action() {
     local prompt_message="$1"
-    printf "%s" "${prompt_message} (y/n): "
-    read confirmation
-    if [[ "$confirmation" =~ ^[Yy]$ ]]; then
-        return 0 # Yes
+    local default="${2:-N}"
+    local hint='[y/N]'
+    local confirmation
+
+    if [[ "$default" =~ ^[Yy]$ ]]; then
+        default="Y"
+        hint='[Y/n]'
     else
-        return 1 # No
+        default="N"
+        hint='[y/N]'
     fi
+
+    while true; do
+        read -r -p "${prompt_message} ${hint}: " confirmation
+        if [[ -z "$confirmation" ]]; then
+            [[ "$default" == "Y" ]] && return 0 || return 1
+        fi
+
+        case "$confirmation" in
+            [Yy]|[Yy][Ee][Ss]) return 0 ;;
+            [Nn]|[Nn][Oo]) return 1 ;;
+            *) warn "请输入 y 或 n。" ;;
+        esac
+    done
 }
 
-# --- IP地址检测函数 (只输出IP) ---
+# --- IP地址检测函数（只输出IP） ---
 get_public_ipv4() {
     curl -4 -s --max-time 2 https://api.ipify.org || \
     curl -4 -s --max-time 2 https://ifconfig.me/ip || \
@@ -65,7 +81,7 @@ get_private_ip() {
 
 # --- 依赖与环境检查 ---
 check_and_install_dependencies() {
-    info "正在检查所需依赖..."
+    info "检查依赖..."
     declare -A deps=( [curl]="curl" [openssl]="openssl" [ss]="iproute2" )
     local missing_deps=()
     for cmd in "${!deps[@]}"; do
@@ -75,8 +91,8 @@ check_and_install_dependencies() {
     done
 
     if [ ${#missing_deps[@]} -gt 0 ]; then
-        warn "检测到以下依赖项缺失: ${missing_deps[*]}"
-        if confirm_action "是否尝试自动安装它们？"; then
+        warn "缺少依赖: ${missing_deps[*]}"
+        if confirm_action "是否尝试自动安装？" "Y"; then
             local pm_cmd=""
             if command_exists apt-get; then pm_cmd="sudo apt-get update && sudo apt-get install -y";
             elif command_exists yum; then pm_cmd="sudo yum install -y";
@@ -87,12 +103,12 @@ check_and_install_dependencies() {
             for cmd in "${!deps[@]}"; do
                 if ! command_exists "$cmd"; then error "依赖 '${deps[$cmd]}' 自动安装失败。"; exit 1; fi
             done
-            info "依赖已成功安装。"
+            success "依赖安装完成。"
         else
             error "用户取消了安装。请先手动安装依赖: ${missing_deps[*]}"; exit 1
         fi
     else
-        info "所有基础依赖均已满足。"
+        success "依赖已满足。"
     fi
 }
 
@@ -101,64 +117,107 @@ initialize_environment() {
     if ! command_exists docker; then
         error "未找到 Docker。请参照官方文档安装: https://docs.docker.com/engine/install/"; exit 1;
     fi
-    if ! docker info &> /dev/null; then error "Docker deamon 未在运行。请先启动 Docker。"; exit 1; fi
-    info "Docker 环境检测通过。"
+    if ! docker info &> /dev/null; then error "Docker daemon 未在运行。请先启动 Docker。"; exit 1; fi
+    success "Docker 环境正常。"
 
     if command_exists docker-compose; then COMPOSE_CMD="docker-compose";
     elif docker compose version &> /dev/null; then COMPOSE_CMD="docker compose";
     else error "未找到 Docker Compose。请安装 Docker Compose v1 或 v2。"; exit 1; fi
-    info "检测到 Docker Compose 命令: $COMPOSE_CMD"
+    info "Docker Compose: $COMPOSE_CMD"
+}
+
+set_image_source_official() {
+    sed -i -E 's|^([[:space:]]*)#?image:[[:space:]]*ghcr\.io/drizzletime/foxel:latest|\1image: ghcr.io/drizzletime/foxel:latest|' compose.yaml
+    sed -i -E 's|^([[:space:]]*)#?image:[[:space:]]*ghcr\.nju\.edu\.cn/drizzletime/foxel:latest|\1#image: ghcr.nju.edu.cn/drizzletime/foxel:latest|' compose.yaml
+}
+
+set_image_source_mirror() {
+    sed -i -E 's|^([[:space:]]*)#?image:[[:space:]]*ghcr\.io/drizzletime/foxel:latest|\1#image: ghcr.io/drizzletime/foxel:latest|' compose.yaml
+    sed -i -E 's|^([[:space:]]*)#?image:[[:space:]]*ghcr\.nju\.edu\.cn/drizzletime/foxel:latest|\1image: ghcr.nju.edu.cn/drizzletime/foxel:latest|' compose.yaml
+}
+
+choose_image_source() {
+    echo
+    info "请选择镜像源："
+    echo "1) ghcr.io (默认)"
+    echo "2) ghcr.nju.edu.cn (国内)"
+    local image_choice
+    read -r -p "请选择 [1-2] (默认 1): " image_choice
+    image_choice="${image_choice:-1}"
+
+    case "$image_choice" in
+        1)
+            set_image_source_official
+            info "已选择: ghcr.io"
+            ;;
+        2)
+            set_image_source_mirror
+            info "已选择: ghcr.nju.edu.cn"
+            ;;
+        *)
+            warn "无效选择，使用默认 ghcr.io"
+            set_image_source_official
+            ;;
+    esac
 }
 
 # --- 新安装流程 ---
 install_new_foxel() {
-    info "--- 开始 Foxel 全新安装 ---"
-    local install_path
+    info "开始全新安装..."
+    local foxel_dir
+    local default_dir="/opt/foxel"
+
     while true; do
-        read -p "请输入您想在哪里创建 Foxel 的数据目录 (例如: /opt/docker): " install_path
-        if [[ -z "$install_path" ]]; then warn "输入不能为空，请重新输入。"; continue; fi
-        if [ ! -d "$install_path" ]; then
-            if confirm_action "目录 '$install_path' 不存在。您想现在创建它吗？"; then
-                mkdir -p "$install_path"
-                if [ $? -eq 0 ]; then info "目录 '$install_path' 创建成功。"; break;
-                else error "创建目录 '$install_path' 失败。"; fi
-            else info "操作已取消。"; fi
-        else info "将使用已存在的目录 '$install_path'。"; break; fi
+        read -r -p "请输入 Foxel 安装目录 (默认: ${default_dir}): " foxel_dir
+        foxel_dir="${foxel_dir:-$default_dir}"
+
+        if [[ -f "$foxel_dir/compose.yaml" ]]; then
+            warn "检测到已存在: $foxel_dir/compose.yaml"
+            if confirm_action "是否覆盖它？" "N"; then
+                mv "$foxel_dir/compose.yaml" "$foxel_dir/compose.yaml.bak.$(date +%s)"
+                info "已备份为: $foxel_dir/compose.yaml.bak.*"
+            else
+                continue
+            fi
+        fi
+
+        if [[ -d "$foxel_dir" ]]; then
+            break
+        fi
+
+        if confirm_action "目录不存在，是否创建？" "Y"; then
+            if mkdir -p "$foxel_dir"; then
+                break
+            fi
+            error "创建目录失败: $foxel_dir"
+        fi
     done
     echo
 
-    local foxel_dir="$install_path/Foxel"
-    info "将在 '$foxel_dir' 目录中创建所需文件..."
+    info "准备目录: $foxel_dir"
     mkdir -p "$foxel_dir/data/"{db,mount} && chmod 777 "$foxel_dir/data/"{db,mount}
     if [ $? -ne 0 ]; then error "创建或设置子目录权限失败。"; exit 1; fi
     cd "$foxel_dir" || exit
 
-    info "正在下载 'compose.yaml'..."
+    info "下载 compose.yaml..."
     local COMPOSE_MIRROR_URL="https://ghproxy.com/https://raw.githubusercontent.com/DrizzleTime/Foxel/main/compose.yaml"
     local COMPOSE_OFFICIAL_URL="https://raw.githubusercontent.com/DrizzleTime/Foxel/main/compose.yaml"
     
-    if ! curl -L -o compose.yaml "$COMPOSE_MIRROR_URL"; then
-        warn "镜像源下载失败，正在尝试从官方源下载..."
-        if ! curl -L -o compose.yaml "$COMPOSE_OFFICIAL_URL"; then
+    if ! curl -fsSL -o compose.yaml "$COMPOSE_MIRROR_URL"; then
+        warn "镜像下载失败，尝试官方源..."
+        if ! curl -fsSL -o compose.yaml "$COMPOSE_OFFICIAL_URL"; then
             error "下载 'compose.yaml' 失败。请检查您的网络连接。"; exit 1;
         fi
     fi
-    info "'compose.yaml' 下载成功。"
+    success "compose.yaml 下载成功。"
     echo
 
-    if confirm_action "您的服务器是否位于中国大陆（以便为您选择更快的镜像源）？"; then
-        info "正在切换到国内镜像源..."
-        sed -i 's|^\( *\)image: ghcr.io/drizzletime/foxel:latest|\1#image: ghcr.io/drizzletime/foxel:latest|' compose.yaml
-        sed -i 's|^\( *\)#image: ghcr.nju.edu.cn/drizzletime/foxel:latest|\1image: ghcr.nju.edu.cn/drizzletime/foxel:latest|' compose.yaml
-        info "已成功切换到 ghcr.nju.edu.cn 镜像源。"
-    else
-        info "将使用默认的 ghcr.io 官方镜像源。"
-    fi
+    choose_image_source
     echo
 
     local new_port
     while true; do
-        read -p "请输入新的对外端口 (或直接按回车使用默认的 8088): " new_port
+        read -r -p "请输入对外端口 (默认 8088): " new_port
         if [[ -z "$new_port" ]]; then
             new_port="8088"
             info "将使用默认端口 8088。"
@@ -173,30 +232,29 @@ install_new_foxel() {
         if ss -tuln | grep -q ":${new_port}\b"; then
             warn "端口 $new_port 已被占用，请换一个。"
         else
-            sed -i "s/\"8088:80\"/\"$new_port:80\"/" compose.yaml
+            sed -i -E "s|\"[0-9]{1,5}:80\"|\"$new_port:80\"|" compose.yaml
             info "端口已成功修改为 $new_port。"
             break
         fi
     done
     echo
 
-    if ! confirm_action "是否需要生成新的随机密钥 (推荐)？(选择 'n' 将使用默认值)"; then
+    if ! confirm_action "是否生成新的随机密钥（推荐）？" "Y"; then
         info "将使用 'compose.yaml' 文件中的默认密钥。"
     else
         info "正在生成新的随机密钥..."
         sed -i "s|SECRET_KEY=.*|SECRET_KEY=$(openssl rand -base64 32)|" compose.yaml
         sed -i "s|TEMP_LINK_SECRET_KEY=.*|TEMP_LINK_SECRET_KEY=$(openssl rand -base64 32)|" compose.yaml
-        info "新的密钥已成功生成并替换。"
+        success "新的密钥已写入 compose.yaml。"
     fi
     echo
 
-    if confirm_action "所有配置已准备就绪！您想现在启动 Foxel 项目吗？"; then
-        info "正在启动 Foxel 服务... 这可能需要一些时间来拉取镜像。"
+    if confirm_action "配置完成，是否现在启动 Foxel？" "Y"; then
+        info "启动中（首次会拉取镜像，可能需要几分钟）..."
         $COMPOSE_CMD pull && $COMPOSE_CMD up -d
         if [ $? -eq 0 ]; then
-            info "Foxel 部署成功！"
-            info "-------------------------------------------------"
-            info "正在检测服务器IP地址，请稍候..."
+            success "Foxel 已启动。"
+            info "正在检测访问地址..."
             
             # 先捕获所有IP地址
             local public_ipv4=$(get_public_ipv4 2>/dev/null)
@@ -206,7 +264,7 @@ install_new_foxel() {
             local ip_found=false
 
             echo
-            info "部署完成！您可以通过以下地址访问 Foxel:"
+            info "访问地址："
 
             if [[ -n "$private_ip" ]]; then
                 echo "  - 局域网地址: http://${private_ip}:${final_port}"
@@ -226,12 +284,16 @@ install_new_foxel() {
                 warn "未能自动检测到服务器IP地址。"
                 echo "  请手动使用 http://[您的服务器IP]:${final_port} 访问它。"
             fi
-            echo "-------------------------------------------------"
+            echo
+            info "常用命令："
+            echo "  - 启动/更新: cd $foxel_dir && $COMPOSE_CMD up -d"
+            echo "  - 停止:     cd $foxel_dir && $COMPOSE_CMD stop"
+            echo "  - 日志:     cd $foxel_dir && $COMPOSE_CMD logs -f"
         else 
             error "启动 Foxel 失败。请运行 'cd $foxel_dir && $COMPOSE_CMD logs' 查看日志。"
         fi
     else 
-        info "操作已取消。您可以稍后进入 '$foxel_dir' 并手动运行 '$COMPOSE_CMD up -d'。"
+        info "已跳过启动。稍后可运行：cd $foxel_dir && $COMPOSE_CMD up -d"
     fi
 }
 
@@ -291,7 +353,7 @@ manage_existing_installation() {
         case $choice in
             1) # 更新
                 warn "更新前，强烈建议您备份 '$foxel_dir/data' 目录！"
-                if confirm_action "您确定要继续更新吗？"; then
+                if confirm_action "确认继续更新？" "Y"; then
                     info "正在拉取最新镜像..."
                     $COMPOSE_CMD pull
                     info "正在使用新镜像重新部署..."
@@ -302,14 +364,14 @@ manage_existing_installation() {
             2) # 卸载
                 warn "这将停止并删除 Foxel 容器及相关网络！"
                 warn "强烈建议您先备份 '$foxel_dir/data' 目录！"
-                if confirm_action "您确定要继续卸载吗？"; then
+                if confirm_action "确认继续卸载？" "N"; then
                     info "正在停止并移除容器..."
                     $COMPOSE_CMD down
-                    if confirm_action "是否要删除所有数据卷（这将删除数据库等所有数据）？"; then
+                    if confirm_action "是否删除所有数据卷（会删除数据库等数据）？" "N"; then
                          $COMPOSE_CMD down -v
                          info "数据卷已删除。"
                     fi
-                    if confirm_action "是否要删除整个 Foxel 安装目录 '$foxel_dir'？"; then
+                    if confirm_action "是否删除 Foxel 安装目录 '$foxel_dir'？" "N"; then
                         rm -rf "$foxel_dir"
                         info "安装目录已删除。"
                     fi
@@ -320,7 +382,7 @@ manage_existing_installation() {
             3) # 重新安装
                 warn "重新安装将完全删除当前的 Foxel 实例（包括数据），然后进入全新安装流程。"
                 warn "在继续之前，请务必备份好您的重要数据！"
-                if confirm_action "您确定要重新安装吗？"; then
+                if confirm_action "确认继续重新安装？" "N"; then
                     info "正在执行卸载..."
                     $COMPOSE_CMD down -v && rm -rf "$foxel_dir"
                     info "旧实例已彻底移除。"
@@ -344,9 +406,8 @@ manage_existing_installation() {
 # --- 主函数 ---
 main() {
     clear
-    local SCRIPT_VERSION="1.7"
     echo "================================================="
-    info "欢迎使用 Foxel 一键安装与管理脚本 (版本: ${SCRIPT_VERSION})"
+    info "欢迎使用 Foxel 一键安装与管理脚本"
     echo "================================================="
     echo
 

setup/foxel_cli.py

@@ -0,0 +1,157 @@
+#!/usr/bin/env python3
+from __future__ import annotations
+
+import argparse
+import os
+import secrets
+import sqlite3
+import string
+import sys
+from pathlib import Path
+
+PROJECT_ROOT = Path(__file__).resolve().parents[1]
+if str(PROJECT_ROOT) not in sys.path:
+    sys.path.insert(0, str(PROJECT_ROOT))
+
+from domain.auth.service import get_password_hash
+from domain.config.service import VERSION
+
+
+def _project_root() -> Path:
+    return PROJECT_ROOT
+
+
+def _supports_color() -> bool:
+    return sys.stderr.isatty() and not os.getenv("NO_COLOR")
+
+
+def _print_banner() -> None:
+    if not sys.stderr.isatty():
+        return
+
+    banner = "\n".join(
+        [
+            "███████╗ ██████╗ ██╗  ██╗███████╗██╗",
+            "██╔════╝██╔═══██╗╚██╗██╔╝██╔════╝██║",
+            "█████╗  ██║   ██║ ╚███╔╝ █████╗  ██║",
+            "██╔══╝  ██║   ██║ ██╔██╗ ██╔══╝  ██║",
+            "██║     ╚██████╔╝██╔╝ ██╗███████╗███████╗",
+            "╚═╝      ╚═════╝ ╚═╝  ╚═╝╚══════╝╚══════╝",
+        ]
+    )
+    title = f"Foxel Admin CLI  {VERSION}"
+
+    if _supports_color():
+        c_reset = "\033[0m"
+        c_bold = "\033[1m"
+        c_orange = "\033[38;5;208m"
+        c_orange_light = "\033[38;5;214m"
+        c_orange_lighter = "\033[38;5;220m"
+
+        banner_lines = banner.splitlines()
+        shades = [
+            c_orange,
+            c_orange_light,
+            c_orange_lighter,
+            c_orange_lighter,
+            c_orange_light,
+            c_orange,
+        ]
+        for line, color in zip(banner_lines, shades, strict=False):
+            print(f"{c_bold}{color}{line}{c_reset}", file=sys.stderr)
+        print(f"{c_bold}{title}{c_reset}\n", file=sys.stderr)
+    else:
+        print(banner, file=sys.stderr)
+        print(f"{title}\n", file=sys.stderr)
+
+
+def _default_db_path() -> Path:
+    return _project_root() / "data/db/db.sqlite3"
+
+
+def _gen_password(length: int) -> str:
+    alphabet = string.ascii_letters + string.digits
+    return "".join(secrets.choice(alphabet) for _ in range(length))
+
+
+def _find_user(conn: sqlite3.Connection, username_or_email: str) -> tuple[int, str] | None:
+    cursor = conn.cursor()
+    cursor.execute("SELECT id, username FROM user WHERE username = ?", (username_or_email,))
+    row = cursor.fetchone()
+    if row:
+        return int(row[0]), str(row[1])
+
+    cursor.execute("SELECT id, username FROM user WHERE email = ?", (username_or_email,))
+    row = cursor.fetchone()
+    if row:
+        return int(row[0]), str(row[1])
+
+    normalized = username_or_email.strip().lower()
+    if normalized and normalized != username_or_email:
+        cursor.execute("SELECT id, username FROM user WHERE email = ?", (normalized,))
+        row = cursor.fetchone()
+        if row:
+            return int(row[0]), str(row[1])
+
+    return None
+
+
+def _cmd_reset_password(args: argparse.Namespace) -> int:
+    db_path = Path(args.db).expanduser() if args.db else _default_db_path()
+
+    if args.random:
+        password = _gen_password(args.length)
+    else:
+        password = args.password
+
+    hashed_password = get_password_hash(password)
+
+    conn = sqlite3.connect(str(db_path))
+    try:
+        user = _find_user(conn, args.username_or_email)
+        if not user:
+            print(f"用户不存在: {args.username_or_email}", file=sys.stderr)
+            return 1
+        user_id, username = user
+        conn.execute(
+            "UPDATE user SET hashed_password = ? WHERE id = ?",
+            (hashed_password, user_id),
+        )
+        conn.commit()
+    finally:
+        conn.close()
+
+    if args.random:
+        print(password)
+    print(f"已重置用户密码: {username} (id={user_id})", file=sys.stderr)
+    return 0
+
+
+def _build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(prog="foxel")
+    subparsers = parser.add_subparsers(dest="command", required=True)
+
+    reset_password = subparsers.add_parser("reset-password", help="重置用户密码")
+    reset_password.add_argument("username_or_email", help="用户名或邮箱")
+    reset_password.add_argument("password", nargs="?", help="新密码（或用 --random）")
+    reset_password.add_argument("--random", action="store_true", help="生成随机密码并输出到 stdout")
+    reset_password.add_argument("--length", type=int, default=16, help="随机密码长度（默认 16）")
+    reset_password.add_argument("--db", help="sqlite db 路径（默认 data/db/db.sqlite3）")
+    reset_password.set_defaults(func=_cmd_reset_password)
+
+    return parser
+
+
+def main(argv: list[str] | None = None) -> int:
+    _print_banner()
+    parser = _build_parser()
+    args = parser.parse_args(argv)
+
+    if args.command == "reset-password" and not args.random and not args.password:
+        parser.error("reset-password 需要提供 password 或使用 --random")
+
+    return int(args.func(args))
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

uv.lock

@@ -9,20 +9,20 @@ resolution-markers = [
 
 [[package]]
 name = "aioboto3"
-version = "15.2.0"
+version = "15.5.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "aiobotocore", extra = ["boto3"] },
     { name = "aiofiles" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/7a/e5/04894a706e557641c2fcc3696696f8b5da4912e8e524c092e946e9d683d1/aioboto3-15.2.0.tar.gz", hash = "sha256:6a151ee0aa0f4b9af6031e6446f28460991fcc50a4ac54a1650d145319d5e2e5", size = 253108, upload-time = "2025-10-04T16:51:00.978Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/a2/01/92e9ab00f36e2899315f49eefcd5b4685fbb19016c7f19a9edf06da80bb0/aioboto3-15.5.0.tar.gz", hash = "sha256:ea8d8787d315594842fbfcf2c4dce3bac2ad61be275bc8584b2ce9a3402a6979", size = 255069, upload-time = "2025-10-30T13:37:16.122Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/f2/80/eddc9d43d9f4f9427c216403452f961f15386f11cda040231ac30b9e5a7c/aioboto3-15.2.0-py3-none-any.whl", hash = "sha256:3582f033543ee7671ae27b1df538f2095bcc91be4a3a78e7498b5ce6c654f26b", size = 35914, upload-time = "2025-10-04T16:50:59.336Z" },
+    { url = "https://files.pythonhosted.org/packages/e5/3e/e8f5b665bca646d43b916763c901e00a07e40f7746c9128bdc912a089424/aioboto3-15.5.0-py3-none-any.whl", hash = "sha256:cc880c4d6a8481dd7e05da89f41c384dbd841454fc1998ae25ca9c39201437a6", size = 35913, upload-time = "2025-10-30T13:37:14.549Z" },
 ]
 
 [[package]]
 name = "aiobotocore"
-version = "2.24.2"
+version = "2.25.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "aiohttp" },
@@ -33,9 +33,9 @@ dependencies = [
     { name = "python-dateutil" },
     { name = "wrapt" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/05/93/9f5243c2fd2fc22cff92f8d8a7e98d3080171be60778d49aeabb555a463d/aiobotocore-2.24.2.tar.gz", hash = "sha256:dfb21bdb2610e8de4d22f401e91a24d50f1330a302d03c62c485757becd439a9", size = 119837, upload-time = "2025-09-05T12:13:46.963Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/62/94/2e4ec48cf1abb89971cb2612d86f979a6240520f0a659b53a43116d344dc/aiobotocore-2.25.1.tar.gz", hash = "sha256:ea9be739bfd7ece8864f072ec99bb9ed5c7e78ebb2b0b15f29781fbe02daedbc", size = 120560, upload-time = "2025-10-28T22:33:21.787Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/87/03/2330062ac4ea9fa6447e02b0625f24efd6f05b6c44d61d86610b3555ee66/aiobotocore-2.24.2-py3-none-any.whl", hash = "sha256:808c63b2bd344b91e2f2acb874831118a9f53342d248acd16a68455a226e283a", size = 85441, upload-time = "2025-09-05T12:13:45.378Z" },
+    { url = "https://files.pythonhosted.org/packages/95/2a/d275ec4ce5cd0096665043995a7d76f5d0524853c76a3d04656de49f8808/aiobotocore-2.25.1-py3-none-any.whl", hash = "sha256:eb6daebe3cbef5b39a0bb2a97cffbe9c7cb46b2fcc399ad141f369f3c2134b1f", size = 86039, upload-time = "2025-10-28T22:33:19.949Z" },
 ]
 
 [package.optional-dependencies]
@@ -216,30 +216,30 @@ wheels = [
 
 [[package]]
 name = "boto3"
-version = "1.40.18"
+version = "1.40.61"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "botocore" },
     { name = "jmespath" },
     { name = "s3transfer" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/36/35/a30dc21ca6582358e0ce963f38e85d42ea619f12e7be4101a834c21d749d/boto3-1.40.18.tar.gz", hash = "sha256:64301d39adecc154e3e595eaf0d4f28998ef0a5551f1d033aeac51a9e1a688e5", size = 111994, upload-time = "2025-08-26T19:21:38.61Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/ed/f9/6ef8feb52c3cce5ec3967a535a6114b57ac7949fd166b0f3090c2b06e4e5/boto3-1.40.61.tar.gz", hash = "sha256:d6c56277251adf6c2bdd25249feae625abe4966831676689ff23b4694dea5b12", size = 111535, upload-time = "2025-10-28T19:26:57.247Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/ad/b5/3fc1802eb24aef135c3ba69fff2a9bfcc6a7a8258fb396706b1a6a44de36/boto3-1.40.18-py3-none-any.whl", hash = "sha256:daa776ba1251a7458c9d6c7627873d0c2460c8e8272d35759065580e9193700a", size = 140076, upload-time = "2025-08-26T19:21:36.484Z" },
+    { url = "https://files.pythonhosted.org/packages/61/24/3bf865b07d15fea85b63504856e137029b6acbc73762496064219cdb265d/boto3-1.40.61-py3-none-any.whl", hash = "sha256:6b9c57b2a922b5d8c17766e29ed792586a818098efe84def27c8f582b33f898c", size = 139321, upload-time = "2025-10-28T19:26:55.007Z" },
 ]
 
 [[package]]
 name = "botocore"
-version = "1.40.18"
+version = "1.40.61"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "jmespath" },
     { name = "python-dateutil" },
     { name = "urllib3" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/6a/91/2e745382793fa7d30810a7d5ca3e05f6817b6db07601ca5aaab12720caf9/botocore-1.40.18.tar.gz", hash = "sha256:afd69bdadd8c55cc89d69de0799829e555193a352d87867f746e19020271cc0f", size = 14375007, upload-time = "2025-08-26T19:21:24.996Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/28/a3/81d3a47c2dbfd76f185d3b894f2ad01a75096c006a2dd91f237dca182188/botocore-1.40.61.tar.gz", hash = "sha256:a2487ad69b090f9cccd64cf07c7021cd80ee9c0655ad974f87045b02f3ef52cd", size = 14393956, upload-time = "2025-10-28T19:26:46.108Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/1a/f5/bd57bf21fdcc4e500cc406ed2c296e626ddd160f0fee2a4932256e5d62d8/botocore-1.40.18-py3-none-any.whl", hash = "sha256:57025c46ca00cf8cec25de07a759521bfbfb3036a0f69b272654a354615dc45f", size = 14039935, upload-time = "2025-08-26T19:21:19.085Z" },
+    { url = "https://files.pythonhosted.org/packages/38/c5/f6ce561004db45f0b847c2cd9b19c67c6bf348a82018a48cb718be6b58b0/botocore-1.40.61-py3-none-any.whl", hash = "sha256:17ebae412692fd4824f99cde0f08d50126dc97954008e5ba2b522eb049238aa7", size = 14055973, upload-time = "2025-10-28T19:26:42.15Z" },
 ]
 
 [[package]]
@@ -452,7 +452,7 @@ requires-dist = [
     { name = "qdrant-client", specifier = ">=1.15.1" },
     { name = "rawpy", specifier = ">=0.25.1" },
     { name = "telethon", specifier = ">=1.41.2" },
-    { name = "tortoise-orm", specifier = ">=0.25.1" },
+    { name = "tortoise-orm", specifier = ">=0.25.2" },
     { name = "uvicorn", specifier = ">=0.37.0" },
 ]
 
@@ -887,57 +887,60 @@ bcrypt = [
 
 [[package]]
 name = "pillow"
-version = "11.3.0"
+version = "12.0.0"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/f3/0d/d0d6dea55cd152ce3d6767bb38a8fc10e33796ba4ba210cbab9354b6d238/pillow-11.3.0.tar.gz", hash = "sha256:3828ee7586cd0b2091b6209e5ad53e20d0649bbe87164a459d0676e035e8f523", size = 47113069, upload-time = "2025-07-01T09:16:30.666Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/5a/b0/cace85a1b0c9775a9f8f5d5423c8261c858760e2466c79b2dd184638b056/pillow-12.0.0.tar.gz", hash = "sha256:87d4f8125c9988bfbed67af47dd7a953e2fc7b0cc1e7800ec6d2080d490bb353", size = 47008828, upload-time = "2025-10-15T18:24:14.008Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/1e/93/0952f2ed8db3a5a4c7a11f91965d6184ebc8cd7cbb7941a260d5f018cd2d/pillow-11.3.0-cp313-cp313-ios_13_0_arm64_iphoneos.whl", hash = "sha256:1c627742b539bba4309df89171356fcb3cc5a9178355b2727d1b74a6cf155fbd", size = 2128328, upload-time = "2025-07-01T09:14:35.276Z" },
-    { url = "https://files.pythonhosted.org/packages/4b/e8/100c3d114b1a0bf4042f27e0f87d2f25e857e838034e98ca98fe7b8c0a9c/pillow-11.3.0-cp313-cp313-ios_13_0_arm64_iphonesimulator.whl", hash = "sha256:30b7c02f3899d10f13d7a48163c8969e4e653f8b43416d23d13d1bbfdc93b9f8", size = 2170652, upload-time = "2025-07-01T09:14:37.203Z" },
-    { url = "https://files.pythonhosted.org/packages/aa/86/3f758a28a6e381758545f7cdb4942e1cb79abd271bea932998fc0db93cb6/pillow-11.3.0-cp313-cp313-ios_13_0_x86_64_iphonesimulator.whl", hash = "sha256:7859a4cc7c9295f5838015d8cc0a9c215b77e43d07a25e460f35cf516df8626f", size = 2227443, upload-time = "2025-07-01T09:14:39.344Z" },
-    { url = "https://files.pythonhosted.org/packages/01/f4/91d5b3ffa718df2f53b0dc109877993e511f4fd055d7e9508682e8aba092/pillow-11.3.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:ec1ee50470b0d050984394423d96325b744d55c701a439d2bd66089bff963d3c", size = 5278474, upload-time = "2025-07-01T09:14:41.843Z" },
-    { url = "https://files.pythonhosted.org/packages/f9/0e/37d7d3eca6c879fbd9dba21268427dffda1ab00d4eb05b32923d4fbe3b12/pillow-11.3.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:7db51d222548ccfd274e4572fdbf3e810a5e66b00608862f947b163e613b67dd", size = 4686038, upload-time = "2025-07-01T09:14:44.008Z" },
-    { url = "https://files.pythonhosted.org/packages/ff/b0/3426e5c7f6565e752d81221af9d3676fdbb4f352317ceafd42899aaf5d8a/pillow-11.3.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:2d6fcc902a24ac74495df63faad1884282239265c6839a0a6416d33faedfae7e", size = 5864407, upload-time = "2025-07-03T13:10:15.628Z" },
-    { url = "https://files.pythonhosted.org/packages/fc/c1/c6c423134229f2a221ee53f838d4be9d82bab86f7e2f8e75e47b6bf6cd77/pillow-11.3.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:f0f5d8f4a08090c6d6d578351a2b91acf519a54986c055af27e7a93feae6d3f1", size = 7639094, upload-time = "2025-07-03T13:10:21.857Z" },
-    { url = "https://files.pythonhosted.org/packages/ba/c9/09e6746630fe6372c67c648ff9deae52a2bc20897d51fa293571977ceb5d/pillow-11.3.0-cp313-cp313-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c37d8ba9411d6003bba9e518db0db0c58a680ab9fe5179f040b0463644bc9805", size = 5973503, upload-time = "2025-07-01T09:14:45.698Z" },
-    { url = "https://files.pythonhosted.org/packages/d5/1c/a2a29649c0b1983d3ef57ee87a66487fdeb45132df66ab30dd37f7dbe162/pillow-11.3.0-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:13f87d581e71d9189ab21fe0efb5a23e9f28552d5be6979e84001d3b8505abe8", size = 6642574, upload-time = "2025-07-01T09:14:47.415Z" },
-    { url = "https://files.pythonhosted.org/packages/36/de/d5cc31cc4b055b6c6fd990e3e7f0f8aaf36229a2698501bcb0cdf67c7146/pillow-11.3.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:023f6d2d11784a465f09fd09a34b150ea4672e85fb3d05931d89f373ab14abb2", size = 6084060, upload-time = "2025-07-01T09:14:49.636Z" },
-    { url = "https://files.pythonhosted.org/packages/d5/ea/502d938cbaeec836ac28a9b730193716f0114c41325db428e6b280513f09/pillow-11.3.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:45dfc51ac5975b938e9809451c51734124e73b04d0f0ac621649821a63852e7b", size = 6721407, upload-time = "2025-07-01T09:14:51.962Z" },
-    { url = "https://files.pythonhosted.org/packages/45/9c/9c5e2a73f125f6cbc59cc7087c8f2d649a7ae453f83bd0362ff7c9e2aee2/pillow-11.3.0-cp313-cp313-win32.whl", hash = "sha256:a4d336baed65d50d37b88ca5b60c0fa9d81e3a87d4a7930d3880d1624d5b31f3", size = 6273841, upload-time = "2025-07-01T09:14:54.142Z" },
-    { url = "https://files.pythonhosted.org/packages/23/85/397c73524e0cd212067e0c969aa245b01d50183439550d24d9f55781b776/pillow-11.3.0-cp313-cp313-win_amd64.whl", hash = "sha256:0bce5c4fd0921f99d2e858dc4d4d64193407e1b99478bc5cacecba2311abde51", size = 6978450, upload-time = "2025-07-01T09:14:56.436Z" },
-    { url = "https://files.pythonhosted.org/packages/17/d2/622f4547f69cd173955194b78e4d19ca4935a1b0f03a302d655c9f6aae65/pillow-11.3.0-cp313-cp313-win_arm64.whl", hash = "sha256:1904e1264881f682f02b7f8167935cce37bc97db457f8e7849dc3a6a52b99580", size = 2423055, upload-time = "2025-07-01T09:14:58.072Z" },
-    { url = "https://files.pythonhosted.org/packages/dd/80/a8a2ac21dda2e82480852978416cfacd439a4b490a501a288ecf4fe2532d/pillow-11.3.0-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:4c834a3921375c48ee6b9624061076bc0a32a60b5532b322cc0ea64e639dd50e", size = 5281110, upload-time = "2025-07-01T09:14:59.79Z" },
-    { url = "https://files.pythonhosted.org/packages/44/d6/b79754ca790f315918732e18f82a8146d33bcd7f4494380457ea89eb883d/pillow-11.3.0-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:5e05688ccef30ea69b9317a9ead994b93975104a677a36a8ed8106be9260aa6d", size = 4689547, upload-time = "2025-07-01T09:15:01.648Z" },
-    { url = "https://files.pythonhosted.org/packages/49/20/716b8717d331150cb00f7fdd78169c01e8e0c219732a78b0e59b6bdb2fd6/pillow-11.3.0-cp313-cp313t-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:1019b04af07fc0163e2810167918cb5add8d74674b6267616021ab558dc98ced", size = 5901554, upload-time = "2025-07-03T13:10:27.018Z" },
-    { url = "https://files.pythonhosted.org/packages/74/cf/a9f3a2514a65bb071075063a96f0a5cf949c2f2fce683c15ccc83b1c1cab/pillow-11.3.0-cp313-cp313t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:f944255db153ebb2b19c51fe85dd99ef0ce494123f21b9db4877ffdfc5590c7c", size = 7669132, upload-time = "2025-07-03T13:10:33.01Z" },
-    { url = "https://files.pythonhosted.org/packages/98/3c/da78805cbdbee9cb43efe8261dd7cc0b4b93f2ac79b676c03159e9db2187/pillow-11.3.0-cp313-cp313t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1f85acb69adf2aaee8b7da124efebbdb959a104db34d3a2cb0f3793dbae422a8", size = 6005001, upload-time = "2025-07-01T09:15:03.365Z" },
-    { url = "https://files.pythonhosted.org/packages/6c/fa/ce044b91faecf30e635321351bba32bab5a7e034c60187fe9698191aef4f/pillow-11.3.0-cp313-cp313t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:05f6ecbeff5005399bb48d198f098a9b4b6bdf27b8487c7f38ca16eeb070cd59", size = 6668814, upload-time = "2025-07-01T09:15:05.655Z" },
-    { url = "https://files.pythonhosted.org/packages/7b/51/90f9291406d09bf93686434f9183aba27b831c10c87746ff49f127ee80cb/pillow-11.3.0-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:a7bc6e6fd0395bc052f16b1a8670859964dbd7003bd0af2ff08342eb6e442cfe", size = 6113124, upload-time = "2025-07-01T09:15:07.358Z" },
-    { url = "https://files.pythonhosted.org/packages/cd/5a/6fec59b1dfb619234f7636d4157d11fb4e196caeee220232a8d2ec48488d/pillow-11.3.0-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:83e1b0161c9d148125083a35c1c5a89db5b7054834fd4387499e06552035236c", size = 6747186, upload-time = "2025-07-01T09:15:09.317Z" },
-    { url = "https://files.pythonhosted.org/packages/49/6b/00187a044f98255225f172de653941e61da37104a9ea60e4f6887717e2b5/pillow-11.3.0-cp313-cp313t-win32.whl", hash = "sha256:2a3117c06b8fb646639dce83694f2f9eac405472713fcb1ae887469c0d4f6788", size = 6277546, upload-time = "2025-07-01T09:15:11.311Z" },
-    { url = "https://files.pythonhosted.org/packages/e8/5c/6caaba7e261c0d75bab23be79f1d06b5ad2a2ae49f028ccec801b0e853d6/pillow-11.3.0-cp313-cp313t-win_amd64.whl", hash = "sha256:857844335c95bea93fb39e0fa2726b4d9d758850b34075a7e3ff4f4fa3aa3b31", size = 6985102, upload-time = "2025-07-01T09:15:13.164Z" },
-    { url = "https://files.pythonhosted.org/packages/f3/7e/b623008460c09a0cb38263c93b828c666493caee2eb34ff67f778b87e58c/pillow-11.3.0-cp313-cp313t-win_arm64.whl", hash = "sha256:8797edc41f3e8536ae4b10897ee2f637235c94f27404cac7297f7b607dd0716e", size = 2424803, upload-time = "2025-07-01T09:15:15.695Z" },
-    { url = "https://files.pythonhosted.org/packages/73/f4/04905af42837292ed86cb1b1dabe03dce1edc008ef14c473c5c7e1443c5d/pillow-11.3.0-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:d9da3df5f9ea2a89b81bb6087177fb1f4d1c7146d583a3fe5c672c0d94e55e12", size = 5278520, upload-time = "2025-07-01T09:15:17.429Z" },
-    { url = "https://files.pythonhosted.org/packages/41/b0/33d79e377a336247df6348a54e6d2a2b85d644ca202555e3faa0cf811ecc/pillow-11.3.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:0b275ff9b04df7b640c59ec5a3cb113eefd3795a8df80bac69646ef699c6981a", size = 4686116, upload-time = "2025-07-01T09:15:19.423Z" },
-    { url = "https://files.pythonhosted.org/packages/49/2d/ed8bc0ab219ae8768f529597d9509d184fe8a6c4741a6864fea334d25f3f/pillow-11.3.0-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:0743841cabd3dba6a83f38a92672cccbd69af56e3e91777b0ee7f4dba4385632", size = 5864597, upload-time = "2025-07-03T13:10:38.404Z" },
-    { url = "https://files.pythonhosted.org/packages/b5/3d/b932bb4225c80b58dfadaca9d42d08d0b7064d2d1791b6a237f87f661834/pillow-11.3.0-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:2465a69cf967b8b49ee1b96d76718cd98c4e925414ead59fdf75cf0fd07df673", size = 7638246, upload-time = "2025-07-03T13:10:44.987Z" },
-    { url = "https://files.pythonhosted.org/packages/09/b5/0487044b7c096f1b48f0d7ad416472c02e0e4bf6919541b111efd3cae690/pillow-11.3.0-cp314-cp314-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:41742638139424703b4d01665b807c6468e23e699e8e90cffefe291c5832b027", size = 5973336, upload-time = "2025-07-01T09:15:21.237Z" },
-    { url = "https://files.pythonhosted.org/packages/a8/2d/524f9318f6cbfcc79fbc004801ea6b607ec3f843977652fdee4857a7568b/pillow-11.3.0-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:93efb0b4de7e340d99057415c749175e24c8864302369e05914682ba642e5d77", size = 6642699, upload-time = "2025-07-01T09:15:23.186Z" },
-    { url = "https://files.pythonhosted.org/packages/6f/d2/a9a4f280c6aefedce1e8f615baaa5474e0701d86dd6f1dede66726462bbd/pillow-11.3.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:7966e38dcd0fa11ca390aed7c6f20454443581d758242023cf36fcb319b1a874", size = 6083789, upload-time = "2025-07-01T09:15:25.1Z" },
-    { url = "https://files.pythonhosted.org/packages/fe/54/86b0cd9dbb683a9d5e960b66c7379e821a19be4ac5810e2e5a715c09a0c0/pillow-11.3.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:98a9afa7b9007c67ed84c57c9e0ad86a6000da96eaa638e4f8abe5b65ff83f0a", size = 6720386, upload-time = "2025-07-01T09:15:27.378Z" },
-    { url = "https://files.pythonhosted.org/packages/e7/95/88efcaf384c3588e24259c4203b909cbe3e3c2d887af9e938c2022c9dd48/pillow-11.3.0-cp314-cp314-win32.whl", hash = "sha256:02a723e6bf909e7cea0dac1b0e0310be9d7650cd66222a5f1c571455c0a45214", size = 6370911, upload-time = "2025-07-01T09:15:29.294Z" },
-    { url = "https://files.pythonhosted.org/packages/2e/cc/934e5820850ec5eb107e7b1a72dd278140731c669f396110ebc326f2a503/pillow-11.3.0-cp314-cp314-win_amd64.whl", hash = "sha256:a418486160228f64dd9e9efcd132679b7a02a5f22c982c78b6fc7dab3fefb635", size = 7117383, upload-time = "2025-07-01T09:15:31.128Z" },
-    { url = "https://files.pythonhosted.org/packages/d6/e9/9c0a616a71da2a5d163aa37405e8aced9a906d574b4a214bede134e731bc/pillow-11.3.0-cp314-cp314-win_arm64.whl", hash = "sha256:155658efb5e044669c08896c0c44231c5e9abcaadbc5cd3648df2f7c0b96b9a6", size = 2511385, upload-time = "2025-07-01T09:15:33.328Z" },
-    { url = "https://files.pythonhosted.org/packages/1a/33/c88376898aff369658b225262cd4f2659b13e8178e7534df9e6e1fa289f6/pillow-11.3.0-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:59a03cdf019efbfeeed910bf79c7c93255c3d54bc45898ac2a4140071b02b4ae", size = 5281129, upload-time = "2025-07-01T09:15:35.194Z" },
-    { url = "https://files.pythonhosted.org/packages/1f/70/d376247fb36f1844b42910911c83a02d5544ebd2a8bad9efcc0f707ea774/pillow-11.3.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:f8a5827f84d973d8636e9dc5764af4f0cf2318d26744b3d902931701b0d46653", size = 4689580, upload-time = "2025-07-01T09:15:37.114Z" },
-    { url = "https://files.pythonhosted.org/packages/eb/1c/537e930496149fbac69efd2fc4329035bbe2e5475b4165439e3be9cb183b/pillow-11.3.0-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:ee92f2fd10f4adc4b43d07ec5e779932b4eb3dbfbc34790ada5a6669bc095aa6", size = 5902860, upload-time = "2025-07-03T13:10:50.248Z" },
-    { url = "https://files.pythonhosted.org/packages/bd/57/80f53264954dcefeebcf9dae6e3eb1daea1b488f0be8b8fef12f79a3eb10/pillow-11.3.0-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:c96d333dcf42d01f47b37e0979b6bd73ec91eae18614864622d9b87bbd5bbf36", size = 7670694, upload-time = "2025-07-03T13:10:56.432Z" },
-    { url = "https://files.pythonhosted.org/packages/70/ff/4727d3b71a8578b4587d9c276e90efad2d6fe0335fd76742a6da08132e8c/pillow-11.3.0-cp314-cp314t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:4c96f993ab8c98460cd0c001447bff6194403e8b1d7e149ade5f00594918128b", size = 6005888, upload-time = "2025-07-01T09:15:39.436Z" },
-    { url = "https://files.pythonhosted.org/packages/05/ae/716592277934f85d3be51d7256f3636672d7b1abfafdc42cf3f8cbd4b4c8/pillow-11.3.0-cp314-cp314t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:41342b64afeba938edb034d122b2dda5db2139b9a4af999729ba8818e0056477", size = 6670330, upload-time = "2025-07-01T09:15:41.269Z" },
-    { url = "https://files.pythonhosted.org/packages/e7/bb/7fe6cddcc8827b01b1a9766f5fdeb7418680744f9082035bdbabecf1d57f/pillow-11.3.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:068d9c39a2d1b358eb9f245ce7ab1b5c3246c7c8c7d9ba58cfa5b43146c06e50", size = 6114089, upload-time = "2025-07-01T09:15:43.13Z" },
-    { url = "https://files.pythonhosted.org/packages/8b/f5/06bfaa444c8e80f1a8e4bff98da9c83b37b5be3b1deaa43d27a0db37ef84/pillow-11.3.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:a1bc6ba083b145187f648b667e05a2534ecc4b9f2784c2cbe3089e44868f2b9b", size = 6748206, upload-time = "2025-07-01T09:15:44.937Z" },
-    { url = "https://files.pythonhosted.org/packages/f0/77/bc6f92a3e8e6e46c0ca78abfffec0037845800ea38c73483760362804c41/pillow-11.3.0-cp314-cp314t-win32.whl", hash = "sha256:118ca10c0d60b06d006be10a501fd6bbdfef559251ed31b794668ed569c87e12", size = 6377370, upload-time = "2025-07-01T09:15:46.673Z" },
-    { url = "https://files.pythonhosted.org/packages/4a/82/3a721f7d69dca802befb8af08b7c79ebcab461007ce1c18bd91a5d5896f9/pillow-11.3.0-cp314-cp314t-win_amd64.whl", hash = "sha256:8924748b688aa210d79883357d102cd64690e56b923a186f35a82cbc10f997db", size = 7121500, upload-time = "2025-07-01T09:15:48.512Z" },
-    { url = "https://files.pythonhosted.org/packages/89/c7/5572fa4a3f45740eaab6ae86fcdf7195b55beac1371ac8c619d880cfe948/pillow-11.3.0-cp314-cp314t-win_arm64.whl", hash = "sha256:79ea0d14d3ebad43ec77ad5272e6ff9bba5b679ef73375ea760261207fa8e0aa", size = 2512835, upload-time = "2025-07-01T09:15:50.399Z" },
+    { url = "https://files.pythonhosted.org/packages/62/f2/de993bb2d21b33a98d031ecf6a978e4b61da207bef02f7b43093774c480d/pillow-12.0.0-cp313-cp313-ios_13_0_arm64_iphoneos.whl", hash = "sha256:0869154a2d0546545cde61d1789a6524319fc1897d9ee31218eae7a60ccc5643", size = 4045493, upload-time = "2025-10-15T18:22:25.758Z" },
+    { url = "https://files.pythonhosted.org/packages/0e/b6/bc8d0c4c9f6f111a783d045310945deb769b806d7574764234ffd50bc5ea/pillow-12.0.0-cp313-cp313-ios_13_0_arm64_iphonesimulator.whl", hash = "sha256:a7921c5a6d31b3d756ec980f2f47c0cfdbce0fc48c22a39347a895f41f4a6ea4", size = 4120461, upload-time = "2025-10-15T18:22:27.286Z" },
+    { url = "https://files.pythonhosted.org/packages/5d/57/d60d343709366a353dc56adb4ee1e7d8a2cc34e3fbc22905f4167cfec119/pillow-12.0.0-cp313-cp313-ios_13_0_x86_64_iphonesimulator.whl", hash = "sha256:1ee80a59f6ce048ae13cda1abf7fbd2a34ab9ee7d401c46be3ca685d1999a399", size = 3576912, upload-time = "2025-10-15T18:22:28.751Z" },
+    { url = "https://files.pythonhosted.org/packages/a4/a4/a0a31467e3f83b94d37568294b01d22b43ae3c5d85f2811769b9c66389dd/pillow-12.0.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:c50f36a62a22d350c96e49ad02d0da41dbd17ddc2e29750dbdba4323f85eb4a5", size = 5249132, upload-time = "2025-10-15T18:22:30.641Z" },
+    { url = "https://files.pythonhosted.org/packages/83/06/48eab21dd561de2914242711434c0c0eb992ed08ff3f6107a5f44527f5e9/pillow-12.0.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:5193fde9a5f23c331ea26d0cf171fbf67e3f247585f50c08b3e205c7aeb4589b", size = 4650099, upload-time = "2025-10-15T18:22:32.73Z" },
+    { url = "https://files.pythonhosted.org/packages/fc/bd/69ed99fd46a8dba7c1887156d3572fe4484e3f031405fcc5a92e31c04035/pillow-12.0.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:bde737cff1a975b70652b62d626f7785e0480918dece11e8fef3c0cf057351c3", size = 6230808, upload-time = "2025-10-15T18:22:34.337Z" },
+    { url = "https://files.pythonhosted.org/packages/ea/94/8fad659bcdbf86ed70099cb60ae40be6acca434bbc8c4c0d4ef356d7e0de/pillow-12.0.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:a6597ff2b61d121172f5844b53f21467f7082f5fb385a9a29c01414463f93b07", size = 8037804, upload-time = "2025-10-15T18:22:36.402Z" },
+    { url = "https://files.pythonhosted.org/packages/20/39/c685d05c06deecfd4e2d1950e9a908aa2ca8bc4e6c3b12d93b9cafbd7837/pillow-12.0.0-cp313-cp313-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:0b817e7035ea7f6b942c13aa03bb554fc44fea70838ea21f8eb31c638326584e", size = 6345553, upload-time = "2025-10-15T18:22:38.066Z" },
+    { url = "https://files.pythonhosted.org/packages/38/57/755dbd06530a27a5ed74f8cb0a7a44a21722ebf318edbe67ddbd7fb28f88/pillow-12.0.0-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:f4f1231b7dec408e8670264ce63e9c71409d9583dd21d32c163e25213ee2a344", size = 7037729, upload-time = "2025-10-15T18:22:39.769Z" },
+    { url = "https://files.pythonhosted.org/packages/ca/b6/7e94f4c41d238615674d06ed677c14883103dce1c52e4af16f000338cfd7/pillow-12.0.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:6e51b71417049ad6ab14c49608b4a24d8fb3fe605e5dfabfe523b58064dc3d27", size = 6459789, upload-time = "2025-10-15T18:22:41.437Z" },
+    { url = "https://files.pythonhosted.org/packages/9c/14/4448bb0b5e0f22dd865290536d20ec8a23b64e2d04280b89139f09a36bb6/pillow-12.0.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:d120c38a42c234dc9a8c5de7ceaaf899cf33561956acb4941653f8bdc657aa79", size = 7130917, upload-time = "2025-10-15T18:22:43.152Z" },
+    { url = "https://files.pythonhosted.org/packages/dd/ca/16c6926cc1c015845745d5c16c9358e24282f1e588237a4c36d2b30f182f/pillow-12.0.0-cp313-cp313-win32.whl", hash = "sha256:4cc6b3b2efff105c6a1656cfe59da4fdde2cda9af1c5e0b58529b24525d0a098", size = 6302391, upload-time = "2025-10-15T18:22:44.753Z" },
+    { url = "https://files.pythonhosted.org/packages/6d/2a/dd43dcfd6dae9b6a49ee28a8eedb98c7d5ff2de94a5d834565164667b97b/pillow-12.0.0-cp313-cp313-win_amd64.whl", hash = "sha256:4cf7fed4b4580601c4345ceb5d4cbf5a980d030fd5ad07c4d2ec589f95f09905", size = 7007477, upload-time = "2025-10-15T18:22:46.838Z" },
+    { url = "https://files.pythonhosted.org/packages/77/f0/72ea067f4b5ae5ead653053212af05ce3705807906ba3f3e8f58ddf617e6/pillow-12.0.0-cp313-cp313-win_arm64.whl", hash = "sha256:9f0b04c6b8584c2c193babcccc908b38ed29524b29dd464bc8801bf10d746a3a", size = 2435918, upload-time = "2025-10-15T18:22:48.399Z" },
+    { url = "https://files.pythonhosted.org/packages/f5/5e/9046b423735c21f0487ea6cb5b10f89ea8f8dfbe32576fe052b5ba9d4e5b/pillow-12.0.0-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:7fa22993bac7b77b78cae22bad1e2a987ddf0d9015c63358032f84a53f23cdc3", size = 5251406, upload-time = "2025-10-15T18:22:49.905Z" },
+    { url = "https://files.pythonhosted.org/packages/12/66/982ceebcdb13c97270ef7a56c3969635b4ee7cd45227fa707c94719229c5/pillow-12.0.0-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:f135c702ac42262573fe9714dfe99c944b4ba307af5eb507abef1667e2cbbced", size = 4653218, upload-time = "2025-10-15T18:22:51.587Z" },
+    { url = "https://files.pythonhosted.org/packages/16/b3/81e625524688c31859450119bf12674619429cab3119eec0e30a7a1029cb/pillow-12.0.0-cp313-cp313t-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:c85de1136429c524e55cfa4e033b4a7940ac5c8ee4d9401cc2d1bf48154bbc7b", size = 6266564, upload-time = "2025-10-15T18:22:53.215Z" },
+    { url = "https://files.pythonhosted.org/packages/98/59/dfb38f2a41240d2408096e1a76c671d0a105a4a8471b1871c6902719450c/pillow-12.0.0-cp313-cp313t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:38df9b4bfd3db902c9c2bd369bcacaf9d935b2fff73709429d95cc41554f7b3d", size = 8069260, upload-time = "2025-10-15T18:22:54.933Z" },
+    { url = "https://files.pythonhosted.org/packages/dc/3d/378dbea5cd1874b94c312425ca77b0f47776c78e0df2df751b820c8c1d6c/pillow-12.0.0-cp313-cp313t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:7d87ef5795da03d742bf49439f9ca4d027cde49c82c5371ba52464aee266699a", size = 6379248, upload-time = "2025-10-15T18:22:56.605Z" },
+    { url = "https://files.pythonhosted.org/packages/84/b0/d525ef47d71590f1621510327acec75ae58c721dc071b17d8d652ca494d8/pillow-12.0.0-cp313-cp313t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:aff9e4d82d082ff9513bdd6acd4f5bd359f5b2c870907d2b0a9c5e10d40c88fe", size = 7066043, upload-time = "2025-10-15T18:22:58.53Z" },
+    { url = "https://files.pythonhosted.org/packages/61/2c/aced60e9cf9d0cde341d54bf7932c9ffc33ddb4a1595798b3a5150c7ec4e/pillow-12.0.0-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:8d8ca2b210ada074d57fcee40c30446c9562e542fc46aedc19baf758a93532ee", size = 6490915, upload-time = "2025-10-15T18:23:00.582Z" },
+    { url = "https://files.pythonhosted.org/packages/ef/26/69dcb9b91f4e59f8f34b2332a4a0a951b44f547c4ed39d3e4dcfcff48f89/pillow-12.0.0-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:99a7f72fb6249302aa62245680754862a44179b545ded638cf1fef59befb57ef", size = 7157998, upload-time = "2025-10-15T18:23:02.627Z" },
+    { url = "https://files.pythonhosted.org/packages/61/2b/726235842220ca95fa441ddf55dd2382b52ab5b8d9c0596fe6b3f23dafe8/pillow-12.0.0-cp313-cp313t-win32.whl", hash = "sha256:4078242472387600b2ce8d93ade8899c12bf33fa89e55ec89fe126e9d6d5d9e9", size = 6306201, upload-time = "2025-10-15T18:23:04.709Z" },
+    { url = "https://files.pythonhosted.org/packages/c0/3d/2afaf4e840b2df71344ababf2f8edd75a705ce500e5dc1e7227808312ae1/pillow-12.0.0-cp313-cp313t-win_amd64.whl", hash = "sha256:2c54c1a783d6d60595d3514f0efe9b37c8808746a66920315bfd34a938d7994b", size = 7013165, upload-time = "2025-10-15T18:23:06.46Z" },
+    { url = "https://files.pythonhosted.org/packages/6f/75/3fa09aa5cf6ed04bee3fa575798ddf1ce0bace8edb47249c798077a81f7f/pillow-12.0.0-cp313-cp313t-win_arm64.whl", hash = "sha256:26d9f7d2b604cd23aba3e9faf795787456ac25634d82cd060556998e39c6fa47", size = 2437834, upload-time = "2025-10-15T18:23:08.194Z" },
+    { url = "https://files.pythonhosted.org/packages/54/2a/9a8c6ba2c2c07b71bec92cf63e03370ca5e5f5c5b119b742bcc0cde3f9c5/pillow-12.0.0-cp314-cp314-ios_13_0_arm64_iphoneos.whl", hash = "sha256:beeae3f27f62308f1ddbcfb0690bf44b10732f2ef43758f169d5e9303165d3f9", size = 4045531, upload-time = "2025-10-15T18:23:10.121Z" },
+    { url = "https://files.pythonhosted.org/packages/84/54/836fdbf1bfb3d66a59f0189ff0b9f5f666cee09c6188309300df04ad71fa/pillow-12.0.0-cp314-cp314-ios_13_0_arm64_iphonesimulator.whl", hash = "sha256:d4827615da15cd59784ce39d3388275ec093ae3ee8d7f0c089b76fa87af756c2", size = 4120554, upload-time = "2025-10-15T18:23:12.14Z" },
+    { url = "https://files.pythonhosted.org/packages/0d/cd/16aec9f0da4793e98e6b54778a5fbce4f375c6646fe662e80600b8797379/pillow-12.0.0-cp314-cp314-ios_13_0_x86_64_iphonesimulator.whl", hash = "sha256:3e42edad50b6909089750e65c91aa09aaf1e0a71310d383f11321b27c224ed8a", size = 3576812, upload-time = "2025-10-15T18:23:13.962Z" },
+    { url = "https://files.pythonhosted.org/packages/f6/b7/13957fda356dc46339298b351cae0d327704986337c3c69bb54628c88155/pillow-12.0.0-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:e5d8efac84c9afcb40914ab49ba063d94f5dbdf5066db4482c66a992f47a3a3b", size = 5252689, upload-time = "2025-10-15T18:23:15.562Z" },
+    { url = "https://files.pythonhosted.org/packages/fc/f5/eae31a306341d8f331f43edb2e9122c7661b975433de5e447939ae61c5da/pillow-12.0.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:266cd5f2b63ff316d5a1bba46268e603c9caf5606d44f38c2873c380950576ad", size = 4650186, upload-time = "2025-10-15T18:23:17.379Z" },
+    { url = "https://files.pythonhosted.org/packages/86/62/2a88339aa40c4c77e79108facbd307d6091e2c0eb5b8d3cf4977cfca2fe6/pillow-12.0.0-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:58eea5ebe51504057dd95c5b77d21700b77615ab0243d8152793dc00eb4faf01", size = 6230308, upload-time = "2025-10-15T18:23:18.971Z" },
+    { url = "https://files.pythonhosted.org/packages/c7/33/5425a8992bcb32d1cb9fa3dd39a89e613d09a22f2c8083b7bf43c455f760/pillow-12.0.0-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:f13711b1a5ba512d647a0e4ba79280d3a9a045aaf7e0cc6fbe96b91d4cdf6b0c", size = 8039222, upload-time = "2025-10-15T18:23:20.909Z" },
+    { url = "https://files.pythonhosted.org/packages/d8/61/3f5d3b35c5728f37953d3eec5b5f3e77111949523bd2dd7f31a851e50690/pillow-12.0.0-cp314-cp314-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6846bd2d116ff42cba6b646edf5bf61d37e5cbd256425fa089fee4ff5c07a99e", size = 6346657, upload-time = "2025-10-15T18:23:23.077Z" },
+    { url = "https://files.pythonhosted.org/packages/3a/be/ee90a3d79271227e0f0a33c453531efd6ed14b2e708596ba5dd9be948da3/pillow-12.0.0-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c98fa880d695de164b4135a52fd2e9cd7b7c90a9d8ac5e9e443a24a95ef9248e", size = 7038482, upload-time = "2025-10-15T18:23:25.005Z" },
+    { url = "https://files.pythonhosted.org/packages/44/34/a16b6a4d1ad727de390e9bd9f19f5f669e079e5826ec0f329010ddea492f/pillow-12.0.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:fa3ed2a29a9e9d2d488b4da81dcb54720ac3104a20bf0bd273f1e4648aff5af9", size = 6461416, upload-time = "2025-10-15T18:23:27.009Z" },
+    { url = "https://files.pythonhosted.org/packages/b6/39/1aa5850d2ade7d7ba9f54e4e4c17077244ff7a2d9e25998c38a29749eb3f/pillow-12.0.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:d034140032870024e6b9892c692fe2968493790dd57208b2c37e3fb35f6df3ab", size = 7131584, upload-time = "2025-10-15T18:23:29.752Z" },
+    { url = "https://files.pythonhosted.org/packages/bf/db/4fae862f8fad0167073a7733973bfa955f47e2cac3dc3e3e6257d10fab4a/pillow-12.0.0-cp314-cp314-win32.whl", hash = "sha256:1b1b133e6e16105f524a8dec491e0586d072948ce15c9b914e41cdadd209052b", size = 6400621, upload-time = "2025-10-15T18:23:32.06Z" },
+    { url = "https://files.pythonhosted.org/packages/2b/24/b350c31543fb0107ab2599464d7e28e6f856027aadda995022e695313d94/pillow-12.0.0-cp314-cp314-win_amd64.whl", hash = "sha256:8dc232e39d409036af549c86f24aed8273a40ffa459981146829a324e0848b4b", size = 7142916, upload-time = "2025-10-15T18:23:34.71Z" },
+    { url = "https://files.pythonhosted.org/packages/0f/9b/0ba5a6fd9351793996ef7487c4fdbde8d3f5f75dbedc093bb598648fddf0/pillow-12.0.0-cp314-cp314-win_arm64.whl", hash = "sha256:d52610d51e265a51518692045e372a4c363056130d922a7351429ac9f27e70b0", size = 2523836, upload-time = "2025-10-15T18:23:36.967Z" },
+    { url = "https://files.pythonhosted.org/packages/f5/7a/ceee0840aebc579af529b523d530840338ecf63992395842e54edc805987/pillow-12.0.0-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:1979f4566bb96c1e50a62d9831e2ea2d1211761e5662afc545fa766f996632f6", size = 5255092, upload-time = "2025-10-15T18:23:38.573Z" },
+    { url = "https://files.pythonhosted.org/packages/44/76/20776057b4bfd1aef4eeca992ebde0f53a4dce874f3ae693d0ec90a4f79b/pillow-12.0.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:b2e4b27a6e15b04832fe9bf292b94b5ca156016bbc1ea9c2c20098a0320d6cf6", size = 4653158, upload-time = "2025-10-15T18:23:40.238Z" },
+    { url = "https://files.pythonhosted.org/packages/82/3f/d9ff92ace07be8836b4e7e87e6a4c7a8318d47c2f1463ffcf121fc57d9cb/pillow-12.0.0-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:fb3096c30df99fd01c7bf8e544f392103d0795b9f98ba71a8054bcbf56b255f1", size = 6267882, upload-time = "2025-10-15T18:23:42.434Z" },
+    { url = "https://files.pythonhosted.org/packages/9f/7a/4f7ff87f00d3ad33ba21af78bfcd2f032107710baf8280e3722ceec28cda/pillow-12.0.0-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:7438839e9e053ef79f7112c881cef684013855016f928b168b81ed5835f3e75e", size = 8071001, upload-time = "2025-10-15T18:23:44.29Z" },
+    { url = "https://files.pythonhosted.org/packages/75/87/fcea108944a52dad8cca0715ae6247e271eb80459364a98518f1e4f480c1/pillow-12.0.0-cp314-cp314t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:5d5c411a8eaa2299322b647cd932586b1427367fd3184ffbb8f7a219ea2041ca", size = 6380146, upload-time = "2025-10-15T18:23:46.065Z" },
+    { url = "https://files.pythonhosted.org/packages/91/52/0d31b5e571ef5fd111d2978b84603fce26aba1b6092f28e941cb46570745/pillow-12.0.0-cp314-cp314t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:d7e091d464ac59d2c7ad8e7e08105eaf9dafbc3883fd7265ffccc2baad6ac925", size = 7067344, upload-time = "2025-10-15T18:23:47.898Z" },
+    { url = "https://files.pythonhosted.org/packages/7b/f4/2dd3d721f875f928d48e83bb30a434dee75a2531bca839bb996bb0aa5a91/pillow-12.0.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:792a2c0be4dcc18af9d4a2dfd8a11a17d5e25274a1062b0ec1c2d79c76f3e7f8", size = 6491864, upload-time = "2025-10-15T18:23:49.607Z" },
+    { url = "https://files.pythonhosted.org/packages/30/4b/667dfcf3d61fc309ba5a15b141845cece5915e39b99c1ceab0f34bf1d124/pillow-12.0.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:afbefa430092f71a9593a99ab6a4e7538bc9eabbf7bf94f91510d3503943edc4", size = 7158911, upload-time = "2025-10-15T18:23:51.351Z" },
+    { url = "https://files.pythonhosted.org/packages/a2/2f/16cabcc6426c32218ace36bf0d55955e813f2958afddbf1d391849fee9d1/pillow-12.0.0-cp314-cp314t-win32.whl", hash = "sha256:3830c769decf88f1289680a59d4f4c46c72573446352e2befec9a8512104fa52", size = 6408045, upload-time = "2025-10-15T18:23:53.177Z" },
+    { url = "https://files.pythonhosted.org/packages/35/73/e29aa0c9c666cf787628d3f0dcf379f4791fba79f4936d02f8b37165bdf8/pillow-12.0.0-cp314-cp314t-win_amd64.whl", hash = "sha256:905b0365b210c73afb0ebe9101a32572152dfd1c144c7e28968a331b9217b94a", size = 7148282, upload-time = "2025-10-15T18:23:55.316Z" },
+    { url = "https://files.pythonhosted.org/packages/c1/70/6b41bdcddf541b437bbb9f47f94d2db5d9ddef6c37ccab8c9107743748a4/pillow-12.0.0-cp314-cp314t-win_arm64.whl", hash = "sha256:99353a06902c2e43b43e8ff74ee65a7d90307d82370604746738a1e0661ccca7", size = 2525630, upload-time = "2025-10-15T18:23:57.149Z" },
 ]
 
 [[package]]
@@ -1177,11 +1180,11 @@ wheels = [
 
 [[package]]
 name = "pypika-tortoise"
-version = "0.6.2"
+version = "0.6.3"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/1a/7b/0a31165e22e599ba149ba35d4323d343205a70d91a4f6e8c6565f5b4fa08/pypika_tortoise-0.6.2.tar.gz", hash = "sha256:f95ab59d9b6454db2e8daa0934728458350a1f3d56e81d9d1debc8eebeff26b3", size = 80522, upload-time = "2025-09-02T03:56:33.986Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/cc/28/86ec1bccb2609d20349def444ef9dfe84aeccc984caa62f4634d50fee164/pypika_tortoise-0.6.3.tar.gz", hash = "sha256:6e17f00e77e78468836cb5c63eb6dc01445f83b1167e4f29f1c678949179c079", size = 80689, upload-time = "2025-11-26T22:07:08.293Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/67/cf/2d47236c80d6deea85e76c86b959f0ec24369c16db691c6266f7a20ff4bd/pypika_tortoise-0.6.2-py3-none-any.whl", hash = "sha256:425462b02ede0a5ed7b812ec12427419927ed6b19282c55667d1cbc9a440d3cb", size = 46919, upload-time = "2025-09-02T03:56:32.771Z" },
+    { url = "https://files.pythonhosted.org/packages/a4/6a/da5ba6830dd16cea2804163a2cecc1b2a85b8e06c61f0abb0477069d013d/pypika_tortoise-0.6.3-py3-none-any.whl", hash = "sha256:762e508093f4d73d3654cdde5bce8f92f8f41d999993c44d972d4f1703a663df", size = 46918, upload-time = "2025-11-26T22:07:07.052Z" },
 ]
 
 [[package]]
@@ -1292,14 +1295,14 @@ wheels = [
 
 [[package]]
 name = "s3transfer"
-version = "0.13.1"
+version = "0.14.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "botocore" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/6d/05/d52bf1e65044b4e5e27d4e63e8d1579dbdec54fce685908ae09bc3720030/s3transfer-0.13.1.tar.gz", hash = "sha256:c3fdba22ba1bd367922f27ec8032d6a1cf5f10c934fb5d68cf60fd5a23d936cf", size = 150589, upload-time = "2025-07-18T19:22:42.31Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/62/74/8d69dcb7a9efe8baa2046891735e5dfe433ad558ae23d9e3c14c633d1d58/s3transfer-0.14.0.tar.gz", hash = "sha256:eff12264e7c8b4985074ccce27a3b38a485bb7f7422cc8046fee9be4983e4125", size = 151547, upload-time = "2025-09-09T19:23:31.089Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/6d/4f/d073e09df851cfa251ef7840007d04db3293a0482ce607d2b993926089be/s3transfer-0.13.1-py3-none-any.whl", hash = "sha256:a981aa7429be23fe6dfc13e80e4020057cbab622b08c0315288758d67cabc724", size = 85308, upload-time = "2025-07-18T19:22:40.947Z" },
+    { url = "https://files.pythonhosted.org/packages/48/f0/ae7ca09223a81a1d890b2557186ea015f6e0502e9b8cb8e1813f1d8cfa4e/s3transfer-0.14.0-py3-none-any.whl", hash = "sha256:ea3b790c7077558ed1f02a3072fb3cb992bbbd253392f4b6e9e8976941c7d456", size = 85712, upload-time = "2025-09-09T19:23:30.041Z" },
 ]
 
 [[package]]
@@ -1343,30 +1346,30 @@ wheels = [
 
 [[package]]
 name = "telethon"
-version = "1.41.2"
+version = "1.42.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "pyaes" },
     { name = "rsa" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/86/6a/3fc30b39eac0a8c770418c0f393d3ff040b9205938a1492d60f08934e97a/telethon-1.41.2.tar.gz", hash = "sha256:300a3441df62668378626b46cafda346573e9ac296367182510756334d2bdc5e", size = 669173, upload-time = "2025-09-04T19:08:02.026Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/8c/10/8c8c9476bfce767a856d8aaf9eae8ea1869df4e970da16f1c5b638fd1b0c/telethon-1.42.0.tar.gz", hash = "sha256:032e95511261d5ead719f75494c6c85ece2ce71816b54f3c65d6ccc371d6994d", size = 672734, upload-time = "2025-11-05T19:15:19.849Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/78/e0/2fb26c432ee4259a6d4ab427196b84a2b0c81db232337b02cf2a09df1896/telethon-1.41.2-py3-none-any.whl", hash = "sha256:28b6b1023a0753a32039e6d1fda4b63cac138ce894cd5cbcac1d5ddd2f8426d8", size = 744889, upload-time = "2025-09-04T19:08:00.181Z" },
+    { url = "https://files.pythonhosted.org/packages/e4/e4/8ce0ff55251381966a7c3f88bd5b34abda79b225a8e7fb51ddef3b849c94/telethon-1.42.0-py3-none-any.whl", hash = "sha256:cf361c94586bcacd6d0fc8959a2bce509d1bb37007fe6476a80c4fb4a2decc29", size = 748466, upload-time = "2025-11-05T19:15:18.241Z" },
 ]
 
 [[package]]
 name = "tortoise-orm"
-version = "0.25.1"
+version = "0.25.2"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "aiosqlite" },
     { name = "iso8601", marker = "python_full_version < '4'" },
-    { name = "pypika-tortoise", marker = "python_full_version < '4'" },
+    { name = "pypika-tortoise" },
     { name = "pytz" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/d7/9b/de966810021fa773fead258efd8deea2bb73bb12479e27f288bd8ceb8763/tortoise_orm-0.25.1.tar.gz", hash = "sha256:4d5bfd13d5750935ffe636a6b25597c5c8f51c47e5b72d7509d712eda1a239fe", size = 128341, upload-time = "2025-06-05T10:43:31.058Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/b3/76/e4c21ad5784c1e61d22072fd87e20adc770a996e354c8e1478d201c589d1/tortoise_orm-0.25.2.tar.gz", hash = "sha256:7e09547846eb27664b402a3b095e1d15ab6406ba56641fad260cf2877ca8d4c5", size = 250715, upload-time = "2025-12-16T08:21:13.939Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/70/55/2bda7f4445f4c07b734385b46d1647a388d05160cf5b8714a713e8709378/tortoise_orm-0.25.1-py3-none-any.whl", hash = "sha256:df0ef7e06eb0650a7e5074399a51ee6e532043308c612db2cac3882486a3fd9f", size = 167723, upload-time = "2025-06-05T10:43:29.309Z" },
+    { url = "https://files.pythonhosted.org/packages/af/64/43ebc940b9ca5a01da09852e54393442a3378367c447362280a9c271840d/tortoise_orm-0.25.2-py3-none-any.whl", hash = "sha256:cf0c9148cb83134a8b2299c30658bd0d9f757a7aef9699e0125a151d58e4f9c4", size = 206829, upload-time = "2025-12-16T08:21:12.76Z" },
 ]
 
 [[package]]
@@ -1463,15 +1466,15 @@ wheels = [
 
 [[package]]
 name = "uvicorn"
-version = "0.37.0"
+version = "0.38.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "click" },
     { name = "h11" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/71/57/1616c8274c3442d802621abf5deb230771c7a0fec9414cb6763900eb3868/uvicorn-0.37.0.tar.gz", hash = "sha256:4115c8add6d3fd536c8ee77f0e14a7fd2ebba939fed9b02583a97f80648f9e13", size = 80367, upload-time = "2025-09-23T13:33:47.486Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/cb/ce/f06b84e2697fef4688ca63bdb2fdf113ca0a3be33f94488f2cadb690b0cf/uvicorn-0.38.0.tar.gz", hash = "sha256:fd97093bdd120a2609fc0d3afe931d4d4ad688b6e75f0f929fde1bc36fe0e91d", size = 80605, upload-time = "2025-10-18T13:46:44.63Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/85/cd/584a2ceb5532af99dd09e50919e3615ba99aa127e9850eafe5f31ddfdb9a/uvicorn-0.37.0-py3-none-any.whl", hash = "sha256:913b2b88672343739927ce381ff9e2ad62541f9f8289664fa1d1d3803fa2ce6c", size = 67976, upload-time = "2025-09-23T13:33:45.842Z" },
+    { url = "https://files.pythonhosted.org/packages/ee/d9/d88e73ca598f4f6ff671fb5fde8a32925c2e08a637303a1d12883c7305fa/uvicorn-0.38.0-py3-none-any.whl", hash = "sha256:48c0afd214ceb59340075b4a052ea1ee91c16fbc2a9b1469cca0e54566977b02", size = 68109, upload-time = "2025-10-18T13:46:42.958Z" },
 ]
 
 [[package]]

web/bun.lock

@@ -1,15 +1,16 @@
 {
   "lockfileVersion": 1,
+  "configVersion": 0,
   "workspaces": {
     "": {
       "name": "web",
       "dependencies": {
-        "@ant-design/icons": "5.x",
+        "@ant-design/icons": "6.x",
         "@ant-design/v5-patch-for-react-19": "^1.0.3",
         "@monaco-editor/react": "^4.7.0",
         "@uiw/react-md-editor": "^4.0.8",
         "antd": "^5.27.0",
-        "artplayer": "^5.2.5",
+        "artplayer": "^5.3.0",
         "date-fns": "^4.1.0",
         "monaco-editor": "^0.53.0",
         "react": "^19.1.1",
@@ -21,10 +22,10 @@
         "@eslint/js": "^9.33.0",
         "@types/react": "^19.1.10",
         "@types/react-dom": "^19.1.7",
-        "@vitejs/plugin-react": "^5.0.0",
-        "eslint": "^9.33.0",
+        "@vitejs/plugin-react": "^5.1.2",
+        "eslint": "^9.39.2",
         "eslint-plugin-react-hooks": "^5.2.0",
-        "eslint-plugin-react-refresh": "^0.4.20",
+        "eslint-plugin-react-refresh": "^0.4.26",
         "globals": "^16.3.0",
         "typescript": "~5.8.3",
         "typescript-eslint": "^8.39.1",
@@ -33,9 +34,7 @@
     },
   },
   "packages": {
-    "@ampproject/remapping": ["@ampproject/remapping@2.3.0", "", { "dependencies": { "@jridgewell/gen-mapping": "^0.3.5", "@jridgewell/trace-mapping": "^0.3.24" } }, "sha512-30iZtAPgz+LTIYoeivqYo853f02jBYSd5uGnGpkFV0M3xOt9aN73erkgYAmZU43x4VfqcnLxW9Kpg3R5LC4YYw=="],
-
-    "@ant-design/colors": ["@ant-design/colors@7.2.1", "", { "dependencies": { "@ant-design/fast-color": "^2.0.6" } }, "sha512-lCHDcEzieu4GA3n8ELeZ5VQ8pKQAWcGGLRTQ50aQM2iqPpq2evTxER84jfdPvsPAtEcZ7m44NI45edFMo8oOYQ=="],
+    "@ant-design/colors": ["@ant-design/colors@8.0.0", "", { "dependencies": { "@ant-design/fast-color": "^3.0.0" } }, "sha512-6YzkKCw30EI/E9kHOIXsQDHmMvTllT8STzjMb4K2qzit33RW2pqCJP0sk+hidBntXxE+Vz4n1+RvCTfBw6OErw=="],
 
     "@ant-design/cssinjs": ["@ant-design/cssinjs@1.24.0", "", { "dependencies": { "@babel/runtime": "^7.11.1", "@emotion/hash": "^0.8.0", "@emotion/unitless": "^0.7.5", "classnames": "^2.3.1", "csstype": "^3.1.3", "rc-util": "^5.35.0", "stylis": "^4.3.4" }, "peerDependencies": { "react": ">=16.0.0", "react-dom": ">=16.0.0" } }, "sha512-K4cYrJBsgvL+IoozUXYjbT6LHHNt+19a9zkvpBPxLjFHas1UpPM2A5MlhROb0BT8N8WoavM5VsP9MeSeNK/3mg=="],
 
@@ -43,7 +42,7 @@
 
     "@ant-design/fast-color": ["@ant-design/fast-color@2.0.6", "", { "dependencies": { "@babel/runtime": "^7.24.7" } }, "sha512-y2217gk4NqL35giHl72o6Zzqji9O7vHh9YmhUVkPtAOpoTCH4uWxo/pr4VE8t0+ChEPs0qo4eJRC5Q1eXWo3vA=="],
 
-    "@ant-design/icons": ["@ant-design/icons@5.6.1", "", { "dependencies": { "@ant-design/colors": "^7.0.0", "@ant-design/icons-svg": "^4.4.0", "@babel/runtime": "^7.24.8", "classnames": "^2.2.6", "rc-util": "^5.31.1" }, "peerDependencies": { "react": ">=16.0.0", "react-dom": ">=16.0.0" } }, "sha512-0/xS39c91WjPAZOWsvi1//zjx6kAp4kxWwctR6kuU6p133w8RU0D2dSCvZC19uQyharg/sAvYxGYWl01BbZZfg=="],
+    "@ant-design/icons": ["@ant-design/icons@6.1.0", "", { "dependencies": { "@ant-design/colors": "^8.0.0", "@ant-design/icons-svg": "^4.4.0", "@rc-component/util": "^1.3.0", "clsx": "^2.1.1" }, "peerDependencies": { "react": ">=16.0.0", "react-dom": ">=16.0.0" } }, "sha512-KrWMu1fIg3w/1F2zfn+JlfNDU8dDqILfA5Tg85iqs1lf8ooyGlbkA+TkwfOKKgqpUmAiRY1PTFpuOU2DAIgSUg=="],
 
     "@ant-design/icons-svg": ["@ant-design/icons-svg@4.4.2", "", {}, "sha512-vHbT+zJEVzllwP+CM+ul7reTEfBR0vgxFe7+lREAsAA7YGsYpboiq2sQNeQeRvh09GfQgs/GyFEvZpJ9cLXpXA=="],
 
@@ -55,9 +54,9 @@
 
     "@babel/compat-data": ["@babel/compat-data@7.28.0", "", {}, "sha512-60X7qkglvrap8mn1lh2ebxXdZYtUcpd7gsmy9kLaBJ4i/WdY8PqTSdxyA8qraikqKQK5C1KRBKXqznrVapyNaw=="],
 
-    "@babel/core": ["@babel/core@7.28.3", "", { "dependencies": { "@ampproject/remapping": "^2.2.0", "@babel/code-frame": "^7.27.1", "@babel/generator": "^7.28.3", "@babel/helper-compilation-targets": "^7.27.2", "@babel/helper-module-transforms": "^7.28.3", "@babel/helpers": "^7.28.3", "@babel/parser": "^7.28.3", "@babel/template": "^7.27.2", "@babel/traverse": "^7.28.3", "@babel/types": "^7.28.2", "convert-source-map": "^2.0.0", "debug": "^4.1.0", "gensync": "^1.0.0-beta.2", "json5": "^2.2.3", "semver": "^6.3.1" } }, "sha512-yDBHV9kQNcr2/sUr9jghVyz9C3Y5G2zUM2H2lo+9mKv4sFgbA8s8Z9t8D1jiTkGoO/NoIfKMyKWr4s6CN23ZwQ=="],
+    "@babel/core": ["@babel/core@7.28.5", "", { "dependencies": { "@babel/code-frame": "^7.27.1", "@babel/generator": "^7.28.5", "@babel/helper-compilation-targets": "^7.27.2", "@babel/helper-module-transforms": "^7.28.3", "@babel/helpers": "^7.28.4", "@babel/parser": "^7.28.5", "@babel/template": "^7.27.2", "@babel/traverse": "^7.28.5", "@babel/types": "^7.28.5", "@jridgewell/remapping": "^2.3.5", "convert-source-map": "^2.0.0", "debug": "^4.1.0", "gensync": "^1.0.0-beta.2", "json5": "^2.2.3", "semver": "^6.3.1" } }, "sha512-e7jT4DxYvIDLk1ZHmU/m/mB19rex9sv0c2ftBtjSBv+kVM/902eh0fINUzD7UwLLNR+jU585GxUJ8/EBfAM5fw=="],
 
-    "@babel/generator": ["@babel/generator@7.28.3", "", { "dependencies": { "@babel/parser": "^7.28.3", "@babel/types": "^7.28.2", "@jridgewell/gen-mapping": "^0.3.12", "@jridgewell/trace-mapping": "^0.3.28", "jsesc": "^3.0.2" } }, "sha512-3lSpxGgvnmZznmBkCRnVREPUFJv2wrv9iAoFDvADJc0ypmdOxdUtcLeBgBJ6zE0PMeTKnxeQzyk0xTBq4Ep7zw=="],
+    "@babel/generator": ["@babel/generator@7.28.5", "", { "dependencies": { "@babel/parser": "^7.28.5", "@babel/types": "^7.28.5", "@jridgewell/gen-mapping": "^0.3.12", "@jridgewell/trace-mapping": "^0.3.28", "jsesc": "^3.0.2" } }, "sha512-3EwLFhZ38J4VyIP6WNtt2kUdW9dokXA9Cr4IVIFHuCpZ3H8/YFOl5JjZHisrn1fATPBmKKqXzDFvh9fUwHz6CQ=="],
 
     "@babel/helper-compilation-targets": ["@babel/helper-compilation-targets@7.27.2", "", { "dependencies": { "@babel/compat-data": "^7.27.2", "@babel/helper-validator-option": "^7.27.1", "browserslist": "^4.24.0", "lru-cache": "^5.1.1", "semver": "^6.3.1" } }, "sha512-2+1thGUUWWjLTYTHZWK1n8Yga0ijBz1XAhUXcKy81rd5g6yh7hGqMp45v7cadSbEHc9G3OTv45SyneRN3ps4DQ=="],
 
@@ -75,9 +74,9 @@
 
     "@babel/helper-validator-option": ["@babel/helper-validator-option@7.27.1", "", {}, "sha512-YvjJow9FxbhFFKDSuFnVCe2WxXk1zWc22fFePVNEaWJEu8IrZVlda6N0uHwzZrUM1il7NC9Mlp4MaJYbYd9JSg=="],
 
-    "@babel/helpers": ["@babel/helpers@7.28.3", "", { "dependencies": { "@babel/template": "^7.27.2", "@babel/types": "^7.28.2" } }, "sha512-PTNtvUQihsAsDHMOP5pfobP8C6CM4JWXmP8DrEIt46c3r2bf87Ua1zoqevsMo9g+tWDwgWrFP5EIxuBx5RudAw=="],
+    "@babel/helpers": ["@babel/helpers@7.28.4", "", { "dependencies": { "@babel/template": "^7.27.2", "@babel/types": "^7.28.4" } }, "sha512-HFN59MmQXGHVyYadKLVumYsA9dBFun/ldYxipEjzA4196jpLZd8UjEEBLkbEkvfYreDqJhZxYAWFPtrfhNpj4w=="],
 
-    "@babel/parser": ["@babel/parser@7.28.3", "", { "dependencies": { "@babel/types": "^7.28.2" }, "bin": "./bin/babel-parser.js" }, "sha512-7+Ey1mAgYqFAx2h0RuoxcQT5+MlG3GTV0TQrgr7/ZliKsm/MNDxVVutlWaziMq7wJNAz8MTqz55XLpWvva6StA=="],
+    "@babel/parser": ["@babel/parser@7.28.5", "", { "dependencies": { "@babel/types": "^7.28.5" }, "bin": "./bin/babel-parser.js" }, "sha512-KKBU1VGYR7ORr3At5HAtUQ+TV3SzRCXmA/8OdDZiLDBIZxVyzXuztPjfLd3BV1PRAQGCMWWSHYhL0F8d5uHBDQ=="],
 
     "@babel/plugin-transform-react-jsx-self": ["@babel/plugin-transform-react-jsx-self@7.27.1", "", { "dependencies": { "@babel/helper-plugin-utils": "^7.27.1" }, "peerDependencies": { "@babel/core": "^7.0.0-0" } }, "sha512-6UzkCs+ejGdZ5mFFC/OCUrv028ab2fp1znZmCZjAOBKiBK2jXD1O+BPSfX8X2qjJ75fZBMSnQn3Rq2mrBJK2mw=="],
 
@@ -87,9 +86,9 @@
 
     "@babel/template": ["@babel/template@7.27.2", "", { "dependencies": { "@babel/code-frame": "^7.27.1", "@babel/parser": "^7.27.2", "@babel/types": "^7.27.1" } }, "sha512-LPDZ85aEJyYSd18/DkjNh4/y1ntkE5KwUHWTiqgRxruuZL2F1yuHligVHLvcHY2vMHXttKFpJn6LwfI7cw7ODw=="],
 
-    "@babel/traverse": ["@babel/traverse@7.28.3", "", { "dependencies": { "@babel/code-frame": "^7.27.1", "@babel/generator": "^7.28.3", "@babel/helper-globals": "^7.28.0", "@babel/parser": "^7.28.3", "@babel/template": "^7.27.2", "@babel/types": "^7.28.2", "debug": "^4.3.1" } }, "sha512-7w4kZYHneL3A6NP2nxzHvT3HCZ7puDZZjFMqDpBPECub79sTtSO5CGXDkKrTQq8ksAwfD/XI2MRFX23njdDaIQ=="],
+    "@babel/traverse": ["@babel/traverse@7.28.5", "", { "dependencies": { "@babel/code-frame": "^7.27.1", "@babel/generator": "^7.28.5", "@babel/helper-globals": "^7.28.0", "@babel/parser": "^7.28.5", "@babel/template": "^7.27.2", "@babel/types": "^7.28.5", "debug": "^4.3.1" } }, "sha512-TCCj4t55U90khlYkVV/0TfkJkAkUg3jZFA3Neb7unZT8CPok7iiRfaX0F+WnqWqt7OxhOn0uBKXCw4lbL8W0aQ=="],
 
-    "@babel/types": ["@babel/types@7.28.2", "", { "dependencies": { "@babel/helper-string-parser": "^7.27.1", "@babel/helper-validator-identifier": "^7.27.1" } }, "sha512-ruv7Ae4J5dUYULmeXw1gmb7rYRz57OWCPM57pHojnLq/3Z1CK2lNSLTCVjxVk1F/TZHwOZZrOWi0ur95BbLxNQ=="],
+    "@babel/types": ["@babel/types@7.28.5", "", { "dependencies": { "@babel/helper-string-parser": "^7.27.1", "@babel/helper-validator-identifier": "^7.28.5" } }, "sha512-qQ5m48eI/MFLQ5PxQj4PFaprjyCTLI37ElWMmNs0K8Lk3dVeOdNpB3ks8jc7yM5CDmVC73eMVk/trk3fgmrUpA=="],
 
     "@emotion/hash": ["@emotion/hash@0.8.0", "", {}, "sha512-kBJtf7PH6aWwZ6fka3zQ0p6SBYzx4fl1LoZXE2RrnYST9Xljm7WfKJrU4g/Xr3Beg72MLrp1AWNUmuYJTL7Cow=="],
 
@@ -147,23 +146,23 @@
 
     "@esbuild/win32-x64": ["@esbuild/win32-x64@0.25.9", "", { "os": "win32", "cpu": "x64" }, "sha512-PPOl1mi6lpLNQxnGoyAfschAodRFYXJ+9fs6WHXz7CSWKbOqiMZsubC+BQsVKuul+3vKLuwTHsS2c2y9EoKwxQ=="],
 
-    "@eslint-community/eslint-utils": ["@eslint-community/eslint-utils@4.7.0", "", { "dependencies": { "eslint-visitor-keys": "^3.4.3" }, "peerDependencies": { "eslint": "^6.0.0 || ^7.0.0 || >=8.0.0" } }, "sha512-dyybb3AcajC7uha6CvhdVRJqaKyn7w2YKqKyAN37NKYgZT36w+iRb0Dymmc5qEJ549c/S31cMMSFd75bteCpCw=="],
+    "@eslint-community/eslint-utils": ["@eslint-community/eslint-utils@4.9.0", "", { "dependencies": { "eslint-visitor-keys": "^3.4.3" }, "peerDependencies": { "eslint": "^6.0.0 || ^7.0.0 || >=8.0.0" } }, "sha512-ayVFHdtZ+hsq1t2Dy24wCmGXGe4q9Gu3smhLYALJrr473ZH27MsnSL+LKUlimp4BWJqMDMLmPpx/Q9R3OAlL4g=="],
 
     "@eslint-community/regexpp": ["@eslint-community/regexpp@4.12.1", "", {}, "sha512-CCZCDJuduB9OUkFkY2IgppNZMi2lBQgD2qzwXkEia16cge2pijY/aXi96CJMquDMn3nJdlPV1A5KrJEXwfLNzQ=="],
 
-    "@eslint/config-array": ["@eslint/config-array@0.21.0", "", { "dependencies": { "@eslint/object-schema": "^2.1.6", "debug": "^4.3.1", "minimatch": "^3.1.2" } }, "sha512-ENIdc4iLu0d93HeYirvKmrzshzofPw6VkZRKQGe9Nv46ZnWUzcF1xV01dcvEg/1wXUR61OmmlSfyeyO7EvjLxQ=="],
+    "@eslint/config-array": ["@eslint/config-array@0.21.1", "", { "dependencies": { "@eslint/object-schema": "^2.1.7", "debug": "^4.3.1", "minimatch": "^3.1.2" } }, "sha512-aw1gNayWpdI/jSYVgzN5pL0cfzU02GT3NBpeT/DXbx1/1x7ZKxFPd9bwrzygx/qiwIQiJ1sw/zD8qY/kRvlGHA=="],
 
-    "@eslint/config-helpers": ["@eslint/config-helpers@0.3.1", "", {}, "sha512-xR93k9WhrDYpXHORXpxVL5oHj3Era7wo6k/Wd8/IsQNnZUTzkGS29lyn3nAT05v6ltUuTFVCCYDEGfy2Or/sPA=="],
+    "@eslint/config-helpers": ["@eslint/config-helpers@0.4.2", "", { "dependencies": { "@eslint/core": "^0.17.0" } }, "sha512-gBrxN88gOIf3R7ja5K9slwNayVcZgK6SOUORm2uBzTeIEfeVaIhOpCtTox3P6R7o2jLFwLFTLnC7kU/RGcYEgw=="],
 
-    "@eslint/core": ["@eslint/core@0.15.2", "", { "dependencies": { "@types/json-schema": "^7.0.15" } }, "sha512-78Md3/Rrxh83gCxoUc0EiciuOHsIITzLy53m3d9UyiW8y9Dj2D29FeETqyKA+BRK76tnTp6RXWb3pCay8Oyomg=="],
+    "@eslint/core": ["@eslint/core@0.17.0", "", { "dependencies": { "@types/json-schema": "^7.0.15" } }, "sha512-yL/sLrpmtDaFEiUj1osRP4TI2MDz1AddJL+jZ7KSqvBuliN4xqYY54IfdN8qD8Toa6g1iloph1fxQNkjOxrrpQ=="],
 
     "@eslint/eslintrc": ["@eslint/eslintrc@3.3.1", "", { "dependencies": { "ajv": "^6.12.4", "debug": "^4.3.2", "espree": "^10.0.1", "globals": "^14.0.0", "ignore": "^5.2.0", "import-fresh": "^3.2.1", "js-yaml": "^4.1.0", "minimatch": "^3.1.2", "strip-json-comments": "^3.1.1" } }, "sha512-gtF186CXhIl1p4pJNGZw8Yc6RlshoePRvE0X91oPGb3vZ8pM3qOS9W9NGPat9LziaBV7XrJWGylNQXkGcnM3IQ=="],
 
     "@eslint/js": ["@eslint/js@9.33.0", "", {}, "sha512-5K1/mKhWaMfreBGJTwval43JJmkip0RmM+3+IuqupeSKNC/Th2Kc7ucaq5ovTSra/OOKB9c58CGSz3QMVbWt0A=="],
 
-    "@eslint/object-schema": ["@eslint/object-schema@2.1.6", "", {}, "sha512-RBMg5FRL0I0gs51M/guSAj5/e14VQ4tpZnQNWwuDT66P14I43ItmPfIZRhO9fUVIPOAQXU47atlywZ/czoqFPA=="],
+    "@eslint/object-schema": ["@eslint/object-schema@2.1.7", "", {}, "sha512-VtAOaymWVfZcmZbp6E2mympDIHvyjXs/12LqWYjVw6qjrfF+VK+fyG33kChz3nnK+SU5/NeHOqrTEHS8sXO3OA=="],
 
-    "@eslint/plugin-kit": ["@eslint/plugin-kit@0.3.5", "", { "dependencies": { "@eslint/core": "^0.15.2", "levn": "^0.4.1" } }, "sha512-Z5kJ+wU3oA7MMIqVR9tyZRtjYPr4OC004Q4Rw7pgOKUOKkJfZ3O24nz3WYfGRpMDNmcOi3TwQOmgm7B7Tpii0w=="],
+    "@eslint/plugin-kit": ["@eslint/plugin-kit@0.4.1", "", { "dependencies": { "@eslint/core": "^0.17.0", "levn": "^0.4.1" } }, "sha512-43/qtrDUokr7LJqoF2c3+RInu/t4zfrpYdoSDfYyhg52rwLV6TnOvdG4fXm7IkSB3wErkcmJS9iEhjVtOSEjjA=="],
 
     "@humanfs/core": ["@humanfs/core@0.19.1", "", {}, "sha512-5DyQ4+1JEUzejeK1JGICcideyfUbGixgS9jNgex5nqkW+cY7WZhxBigmieN5Qnw9ZosSNVC9KQKyb+GUaGyKUA=="],
 
@@ -175,6 +174,8 @@
 
     "@jridgewell/gen-mapping": ["@jridgewell/gen-mapping@0.3.13", "", { "dependencies": { "@jridgewell/sourcemap-codec": "^1.5.0", "@jridgewell/trace-mapping": "^0.3.24" } }, "sha512-2kkt/7niJ6MgEPxF0bYdQ6etZaA+fQvDcLKckhy1yIQOzaoKjBBjSj63/aLVjYE3qhRt5dvM+uUyfCg6UKCBbA=="],
 
+    "@jridgewell/remapping": ["@jridgewell/remapping@2.3.5", "", { "dependencies": { "@jridgewell/gen-mapping": "^0.3.5", "@jridgewell/trace-mapping": "^0.3.24" } }, "sha512-LI9u/+laYG4Ds1TDKSJW2YPrIlcVYOwi2fUC6xB43lueCjgxV4lffOCZCtYFiH6TNOX+tQKXx97T4IKHbhyHEQ=="],
+
     "@jridgewell/resolve-uri": ["@jridgewell/resolve-uri@3.1.2", "", {}, "sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw=="],
 
     "@jridgewell/sourcemap-codec": ["@jridgewell/sourcemap-codec@1.5.5", "", {}, "sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og=="],
@@ -209,7 +210,9 @@
 
     "@rc-component/trigger": ["@rc-component/trigger@2.3.0", "", { "dependencies": { "@babel/runtime": "^7.23.2", "@rc-component/portal": "^1.1.0", "classnames": "^2.3.2", "rc-motion": "^2.0.0", "rc-resize-observer": "^1.3.1", "rc-util": "^5.44.0" }, "peerDependencies": { "react": ">=16.9.0", "react-dom": ">=16.9.0" } }, "sha512-iwaxZyzOuK0D7lS+0AQEtW52zUWxoGqTGkke3dRyb8pYiShmRpCjB/8TzPI4R6YySCH7Vm9BZj/31VPiiQTLBg=="],
 
-    "@rolldown/pluginutils": ["@rolldown/pluginutils@1.0.0-beta.30", "", {}, "sha512-whXaSoNUFiyDAjkUF8OBpOm77Szdbk5lGNqFe6CbVbJFrhCCPinCbRA3NjawwlNHla1No7xvXXh+CpSxnPfUEw=="],
+    "@rc-component/util": ["@rc-component/util@1.6.0", "", { "dependencies": { "is-mobile": "^5.0.0", "react-is": "^18.2.0" }, "peerDependencies": { "react": ">=18.0.0", "react-dom": ">=18.0.0" } }, "sha512-YbjuIVAm8InCnXVoA4n6G+uh31yESTxQ6fSY2frZ2/oMSvktoB+bumFUfNN7RKh7YeOkZgOvN2suGtEDhJSX0A=="],
+
+    "@rolldown/pluginutils": ["@rolldown/pluginutils@1.0.0-beta.53", "", {}, "sha512-vENRlFU4YbrwVqNDZ7fLvy+JR1CRkyr01jhSiDpE1u6py3OMzQfztQU2jxykW3ALNxO4kSlqIDeYyD0Y9RcQeQ=="],
 
     "@rollup/rollup-android-arm-eabi": ["@rollup/rollup-android-arm-eabi@4.46.2", "", { "os": "android", "cpu": "arm" }, "sha512-Zj3Hl6sN34xJtMv7Anwb5Gu01yujyE/cLBDB2gnHTAHaWS1Z38L7kuSG+oAh0giZMqG060f/YBStXtMH6FvPMA=="],
 
@@ -311,7 +314,7 @@
 
     "@ungap/structured-clone": ["@ungap/structured-clone@1.3.0", "", {}, "sha512-WmoN8qaIAo7WTYWbAZuG8PYEhn5fkz7dZrqTBZ7dtt//lL2Gwms1IcnQ5yHqjDfX8Ft5j4YzDM23f87zBfDe9g=="],
 
-    "@vitejs/plugin-react": ["@vitejs/plugin-react@5.0.0", "", { "dependencies": { "@babel/core": "^7.28.0", "@babel/plugin-transform-react-jsx-self": "^7.27.1", "@babel/plugin-transform-react-jsx-source": "^7.27.1", "@rolldown/pluginutils": "1.0.0-beta.30", "@types/babel__core": "^7.20.5", "react-refresh": "^0.17.0" }, "peerDependencies": { "vite": "^4.2.0 || ^5.0.0 || ^6.0.0 || ^7.0.0" } }, "sha512-Jx9JfsTa05bYkS9xo0hkofp2dCmp1blrKjw9JONs5BTHOvJCgLbaPSuZLGSVJW6u2qe0tc4eevY0+gSNNi0YCw=="],
+    "@vitejs/plugin-react": ["@vitejs/plugin-react@5.1.2", "", { "dependencies": { "@babel/core": "^7.28.5", "@babel/plugin-transform-react-jsx-self": "^7.27.1", "@babel/plugin-transform-react-jsx-source": "^7.27.1", "@rolldown/pluginutils": "1.0.0-beta.53", "@types/babel__core": "^7.20.5", "react-refresh": "^0.18.0" }, "peerDependencies": { "vite": "^4.2.0 || ^5.0.0 || ^6.0.0 || ^7.0.0" } }, "sha512-EcA07pHJouywpzsoTUqNh5NwGayl2PPVEJKUSinGGSxFGYn+shYbqMGBg6FXDqgXum9Ou/ecb+411ssw8HImJQ=="],
 
     "acorn": ["acorn@8.15.0", "", { "bin": { "acorn": "bin/acorn" } }, "sha512-NZyJarBfL7nWwIq+FDL6Zp/yHEhePMNnnJ0y3qfieCrmNvYct8uvtiV41UvlSe6apAfk0fY1FbWx+NwfmpvtTg=="],
 
@@ -325,7 +328,7 @@
 
     "argparse": ["argparse@2.0.1", "", {}, "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q=="],
 
-    "artplayer": ["artplayer@5.2.5", "", { "dependencies": { "option-validator": "^2.0.6" } }, "sha512-Ogym5rvkAJ4VLncM4Apl3TJ/a/ozM3csvY4IKuuMR++hUmEZgj/HaGsNonwx8r56nsqiZYE7O4vS1HFZl+NBSg=="],
+    "artplayer": ["artplayer@5.3.0", "", { "dependencies": { "option-validator": "^2.0.6" } }, "sha512-yExO39MpEg4P+bxgChxx1eJfiUPE4q1QQRLCmqGhlsj+ANuaoEkR8hF93LdI5ZyrAcIbJkuEndxEiUoKobifDw=="],
 
     "bail": ["bail@2.0.2", "", {}, "sha512-0xO6mYd7JB2YesxDKplafRpsiOzPt9V02ddPCLbY1xYGPOX24NTyN50qnUxgCPcSoYMhKpAuBTjQoRZCAkUDRw=="],
 
@@ -359,6 +362,8 @@
 
     "classnames": ["classnames@2.5.1", "", {}, "sha512-saHYOzhIQs6wy2sVxTM6bUDsQO4F50V9RQ22qBpEdCW+I+/Wmke2HOl6lS6dTpdxVhb88/I6+Hs+438c3lfUow=="],
 
+    "clsx": ["clsx@2.1.1", "", {}, "sha512-eYm0QWBtUrBWZWG0d386OGAw16Z995PiOVo2B7bjWSbHedGl5e0ZWaq65kOGgUSNesEIDkB9ISbTg/JK9dhCZA=="],
+
     "color-convert": ["color-convert@2.0.1", "", { "dependencies": { "color-name": "~1.1.4" } }, "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ=="],
 
     "color-name": ["color-name@1.1.4", "", {}, "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA=="],
@@ -407,11 +412,11 @@
 
     "escape-string-regexp": ["escape-string-regexp@4.0.0", "", {}, "sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA=="],
 
-    "eslint": ["eslint@9.33.0", "", { "dependencies": { "@eslint-community/eslint-utils": "^4.2.0", "@eslint-community/regexpp": "^4.12.1", "@eslint/config-array": "^0.21.0", "@eslint/config-helpers": "^0.3.1", "@eslint/core": "^0.15.2", "@eslint/eslintrc": "^3.3.1", "@eslint/js": "9.33.0", "@eslint/plugin-kit": "^0.3.5", "@humanfs/node": "^0.16.6", "@humanwhocodes/module-importer": "^1.0.1", "@humanwhocodes/retry": "^0.4.2", "@types/estree": "^1.0.6", "@types/json-schema": "^7.0.15", "ajv": "^6.12.4", "chalk": "^4.0.0", "cross-spawn": "^7.0.6", "debug": "^4.3.2", "escape-string-regexp": "^4.0.0", "eslint-scope": "^8.4.0", "eslint-visitor-keys": "^4.2.1", "espree": "^10.4.0", "esquery": "^1.5.0", "esutils": "^2.0.2", "fast-deep-equal": "^3.1.3", "file-entry-cache": "^8.0.0", "find-up": "^5.0.0", "glob-parent": "^6.0.2", "ignore": "^5.2.0", "imurmurhash": "^0.1.4", "is-glob": "^4.0.0", "json-stable-stringify-without-jsonify": "^1.0.1", "lodash.merge": "^4.6.2", "minimatch": "^3.1.2", "natural-compare": "^1.4.0", "optionator": "^0.9.3" }, "peerDependencies": { "jiti": "*" }, "optionalPeers": ["jiti"], "bin": { "eslint": "bin/eslint.js" } }, "sha512-TS9bTNIryDzStCpJN93aC5VRSW3uTx9sClUn4B87pwiCaJh220otoI0X8mJKr+VcPtniMdN8GKjlwgWGUv5ZKA=="],
+    "eslint": ["eslint@9.39.2", "", { "dependencies": { "@eslint-community/eslint-utils": "^4.8.0", "@eslint-community/regexpp": "^4.12.1", "@eslint/config-array": "^0.21.1", "@eslint/config-helpers": "^0.4.2", "@eslint/core": "^0.17.0", "@eslint/eslintrc": "^3.3.1", "@eslint/js": "9.39.2", "@eslint/plugin-kit": "^0.4.1", "@humanfs/node": "^0.16.6", "@humanwhocodes/module-importer": "^1.0.1", "@humanwhocodes/retry": "^0.4.2", "@types/estree": "^1.0.6", "ajv": "^6.12.4", "chalk": "^4.0.0", "cross-spawn": "^7.0.6", "debug": "^4.3.2", "escape-string-regexp": "^4.0.0", "eslint-scope": "^8.4.0", "eslint-visitor-keys": "^4.2.1", "espree": "^10.4.0", "esquery": "^1.5.0", "esutils": "^2.0.2", "fast-deep-equal": "^3.1.3", "file-entry-cache": "^8.0.0", "find-up": "^5.0.0", "glob-parent": "^6.0.2", "ignore": "^5.2.0", "imurmurhash": "^0.1.4", "is-glob": "^4.0.0", "json-stable-stringify-without-jsonify": "^1.0.1", "lodash.merge": "^4.6.2", "minimatch": "^3.1.2", "natural-compare": "^1.4.0", "optionator": "^0.9.3" }, "peerDependencies": { "jiti": "*" }, "optionalPeers": ["jiti"], "bin": { "eslint": "bin/eslint.js" } }, "sha512-LEyamqS7W5HB3ujJyvi0HQK/dtVINZvd5mAAp9eT5S/ujByGjiZLCzPcHVzuXbpJDJF/cxwHlfceVUDZ2lnSTw=="],
 
     "eslint-plugin-react-hooks": ["eslint-plugin-react-hooks@5.2.0", "", { "peerDependencies": { "eslint": "^3.0.0 || ^4.0.0 || ^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0-0 || ^9.0.0" } }, "sha512-+f15FfK64YQwZdJNELETdn5ibXEUQmW1DZL6KXhNnc2heoy/sg9VJJeT7n8TlMWouzWqSWavFkIhHyIbIAEapg=="],
 
-    "eslint-plugin-react-refresh": ["eslint-plugin-react-refresh@0.4.20", "", { "peerDependencies": { "eslint": ">=8.40" } }, "sha512-XpbHQ2q5gUF8BGOX4dHe+71qoirYMhApEPZ7sfhF/dNnOF1UXnCMGZf79SFTBO7Bz5YEIT4TMieSlJBWhP9WBA=="],
+    "eslint-plugin-react-refresh": ["eslint-plugin-react-refresh@0.4.26", "", { "peerDependencies": { "eslint": ">=8.40" } }, "sha512-1RETEylht2O6FM/MvgnyvT+8K21wLqDNg4qD51Zj3guhjt433XbnnkVttHMyaVyAFD03QSV4LPS5iE3VQmO7XQ=="],
 
     "eslint-scope": ["eslint-scope@8.4.0", "", { "dependencies": { "esrecurse": "^4.3.0", "estraverse": "^5.2.0" } }, "sha512-sNXOfKCn74rt8RICKMvJS7XKV/Xk9kA7DyJr8mJik3S7Cwgy3qlkkmyS2uQB3jiJg6VNdZd/pDBJu0nvG2NlTg=="],
 
@@ -519,6 +524,8 @@
 
     "is-hexadecimal": ["is-hexadecimal@2.0.1", "", {}, "sha512-DgZQp241c8oO6cA1SbTEWiXeoxV42vlcJxgH+B3hi1AiqqKruZR3ZGF8In3fj4+/y/7rHvlOZLZtgJ/4ttYGZg=="],
 
+    "is-mobile": ["is-mobile@5.0.0", "", {}, "sha512-Tz/yndySvLAEXh+Uk8liFCxOwVH6YutuR74utvOcu7I9Di+DwM0mtdPVZNaVvvBUM2OXxne/NhOs1zAO7riusQ=="],
+
     "is-number": ["is-number@7.0.0", "", {}, "sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng=="],
 
     "is-plain-obj": ["is-plain-obj@4.1.0", "", {}, "sha512-+Pgi+vMuUNkJyExiMBt5IlFoMyKnr5zhJ4Uspz58WOhBF5QoIZkFyNHIbBAtHwzVAgk5RtndVNsDRN61/mmDqg=="],
@@ -771,7 +778,7 @@
 
     "react-markdown": ["react-markdown@10.1.0", "", { "dependencies": { "@types/hast": "^3.0.0", "@types/mdast": "^4.0.0", "devlop": "^1.0.0", "hast-util-to-jsx-runtime": "^2.0.0", "html-url-attributes": "^3.0.0", "mdast-util-to-hast": "^13.0.0", "remark-parse": "^11.0.0", "remark-rehype": "^11.0.0", "unified": "^11.0.0", "unist-util-visit": "^5.0.0", "vfile": "^6.0.0" }, "peerDependencies": { "@types/react": ">=18", "react": ">=18" } }, "sha512-qKxVopLT/TyA6BX3Ue5NwabOsAzm0Q7kAPwq6L+wWDwisYs7R8vZ0nRXqq6rkueboxpkjvLGU9fWifiX/ZZFxQ=="],
 
-    "react-refresh": ["react-refresh@0.17.0", "", {}, "sha512-z6F7K9bV85EfseRCp2bzrpyQ0Gkw1uLoCel9XBVWPg/TjRj94SkJzUTGfOa4bs7iJvBWtQG0Wq7wnI0syw3EBQ=="],
+    "react-refresh": ["react-refresh@0.18.0", "", {}, "sha512-QgT5//D3jfjJb6Gsjxv0Slpj23ip+HtOpnNgnb2S5zU3CB26G/IDPGoy4RJB42wzFE46DRsstbW6tKHoKbhAxw=="],
 
     "react-router": ["react-router@7.8.0", "", { "dependencies": { "cookie": "^1.0.1", "set-cookie-parser": "^2.6.0" }, "peerDependencies": { "react": ">=18", "react-dom": ">=18" }, "optionalPeers": ["react-dom"] }, "sha512-r15M3+LHKgM4SOapNmsH3smAizWds1vJ0Z9C4mWaKnT9/wD7+d/0jYcj6LmOvonkrO4Rgdyp4KQ/29gWN2i1eg=="],
 
@@ -907,22 +914,56 @@
 
     "zwitch": ["zwitch@2.0.4", "", {}, "sha512-bXE4cR/kVZhKZX/RjPEflHaKVhUVl85noU3v6b8apfQEc1x4A+zBxjZ4lN8LqGd6WZ3dl98pY4o717VFmoPp+A=="],
 
+    "@ant-design/colors/@ant-design/fast-color": ["@ant-design/fast-color@3.0.0", "", {}, "sha512-eqvpP7xEDm2S7dUzl5srEQCBTXZMmY3ekf97zI+M2DHOYyKdJGH0qua0JACHTqbkRnD/KHFQP9J1uMJ/XWVzzA=="],
+
+    "@babel/helper-module-imports/@babel/traverse": ["@babel/traverse@7.28.3", "", { "dependencies": { "@babel/code-frame": "^7.27.1", "@babel/generator": "^7.28.3", "@babel/helper-globals": "^7.28.0", "@babel/parser": "^7.28.3", "@babel/template": "^7.27.2", "@babel/types": "^7.28.2", "debug": "^4.3.1" } }, "sha512-7w4kZYHneL3A6NP2nxzHvT3HCZ7puDZZjFMqDpBPECub79sTtSO5CGXDkKrTQq8ksAwfD/XI2MRFX23njdDaIQ=="],
+
+    "@babel/helper-module-imports/@babel/types": ["@babel/types@7.28.2", "", { "dependencies": { "@babel/helper-string-parser": "^7.27.1", "@babel/helper-validator-identifier": "^7.27.1" } }, "sha512-ruv7Ae4J5dUYULmeXw1gmb7rYRz57OWCPM57pHojnLq/3Z1CK2lNSLTCVjxVk1F/TZHwOZZrOWi0ur95BbLxNQ=="],
+
+    "@babel/helper-module-transforms/@babel/traverse": ["@babel/traverse@7.28.3", "", { "dependencies": { "@babel/code-frame": "^7.27.1", "@babel/generator": "^7.28.3", "@babel/helper-globals": "^7.28.0", "@babel/parser": "^7.28.3", "@babel/template": "^7.27.2", "@babel/types": "^7.28.2", "debug": "^4.3.1" } }, "sha512-7w4kZYHneL3A6NP2nxzHvT3HCZ7puDZZjFMqDpBPECub79sTtSO5CGXDkKrTQq8ksAwfD/XI2MRFX23njdDaIQ=="],
+
+    "@babel/template/@babel/parser": ["@babel/parser@7.28.3", "", { "dependencies": { "@babel/types": "^7.28.2" }, "bin": "./bin/babel-parser.js" }, "sha512-7+Ey1mAgYqFAx2h0RuoxcQT5+MlG3GTV0TQrgr7/ZliKsm/MNDxVVutlWaziMq7wJNAz8MTqz55XLpWvva6StA=="],
+
+    "@babel/template/@babel/types": ["@babel/types@7.28.2", "", { "dependencies": { "@babel/helper-string-parser": "^7.27.1", "@babel/helper-validator-identifier": "^7.27.1" } }, "sha512-ruv7Ae4J5dUYULmeXw1gmb7rYRz57OWCPM57pHojnLq/3Z1CK2lNSLTCVjxVk1F/TZHwOZZrOWi0ur95BbLxNQ=="],
+
+    "@babel/types/@babel/helper-validator-identifier": ["@babel/helper-validator-identifier@7.28.5", "", {}, "sha512-qSs4ifwzKJSV39ucNjsvc6WVHs6b7S03sOh2OcHF9UHfVPqWWALUsNUVzhSBiItjRZoLHx7nIarVjqKVusUZ1Q=="],
+
     "@eslint-community/eslint-utils/eslint-visitor-keys": ["eslint-visitor-keys@3.4.3", "", {}, "sha512-wpc+LXeiyiisxPlEkUzU6svyS1frIO3Mgxj1fdy7Pm8Ygzguax2N3Fa/D/ag1WqbOprdI+uY6wMUl8/a2G+iag=="],
 
     "@eslint/eslintrc/globals": ["globals@14.0.0", "", {}, "sha512-oahGvuMGQlPw/ivIYBjVSrWAfWLBeku5tpPE2fOPLi+WHffIWbuh2tCjhyQhTBPMf5E9jDEH4FOmTYgYwbKwtQ=="],
 
     "@humanfs/node/@humanwhocodes/retry": ["@humanwhocodes/retry@0.3.1", "", {}, "sha512-JBxkERygn7Bv/GbN5Rv8Ul6LVknS+5Bp6RgDC/O8gEBU/yeH5Ui5C/OlWrTb6qct7LjjfT6Re2NxB0ln0yYybA=="],
 
+    "@types/babel__core/@babel/parser": ["@babel/parser@7.28.3", "", { "dependencies": { "@babel/types": "^7.28.2" }, "bin": "./bin/babel-parser.js" }, "sha512-7+Ey1mAgYqFAx2h0RuoxcQT5+MlG3GTV0TQrgr7/ZliKsm/MNDxVVutlWaziMq7wJNAz8MTqz55XLpWvva6StA=="],
+
+    "@types/babel__core/@babel/types": ["@babel/types@7.28.2", "", { "dependencies": { "@babel/helper-string-parser": "^7.27.1", "@babel/helper-validator-identifier": "^7.27.1" } }, "sha512-ruv7Ae4J5dUYULmeXw1gmb7rYRz57OWCPM57pHojnLq/3Z1CK2lNSLTCVjxVk1F/TZHwOZZrOWi0ur95BbLxNQ=="],
+
+    "@types/babel__generator/@babel/types": ["@babel/types@7.28.2", "", { "dependencies": { "@babel/helper-string-parser": "^7.27.1", "@babel/helper-validator-identifier": "^7.27.1" } }, "sha512-ruv7Ae4J5dUYULmeXw1gmb7rYRz57OWCPM57pHojnLq/3Z1CK2lNSLTCVjxVk1F/TZHwOZZrOWi0ur95BbLxNQ=="],
+
+    "@types/babel__template/@babel/parser": ["@babel/parser@7.28.3", "", { "dependencies": { "@babel/types": "^7.28.2" }, "bin": "./bin/babel-parser.js" }, "sha512-7+Ey1mAgYqFAx2h0RuoxcQT5+MlG3GTV0TQrgr7/ZliKsm/MNDxVVutlWaziMq7wJNAz8MTqz55XLpWvva6StA=="],
+
+    "@types/babel__template/@babel/types": ["@babel/types@7.28.2", "", { "dependencies": { "@babel/helper-string-parser": "^7.27.1", "@babel/helper-validator-identifier": "^7.27.1" } }, "sha512-ruv7Ae4J5dUYULmeXw1gmb7rYRz57OWCPM57pHojnLq/3Z1CK2lNSLTCVjxVk1F/TZHwOZZrOWi0ur95BbLxNQ=="],
+
+    "@types/babel__traverse/@babel/types": ["@babel/types@7.28.2", "", { "dependencies": { "@babel/helper-string-parser": "^7.27.1", "@babel/helper-validator-identifier": "^7.27.1" } }, "sha512-ruv7Ae4J5dUYULmeXw1gmb7rYRz57OWCPM57pHojnLq/3Z1CK2lNSLTCVjxVk1F/TZHwOZZrOWi0ur95BbLxNQ=="],
+
     "@typescript-eslint/eslint-plugin/ignore": ["ignore@7.0.5", "", {}, "sha512-Hs59xBNfUIunMFgWAbGX5cq6893IbWg4KnrjbYwX3tx0ztorVgTDA6B2sxf8ejHJ4wz8BqGUMYlnzNBer5NvGg=="],
 
     "@typescript-eslint/typescript-estree/minimatch": ["minimatch@9.0.5", "", { "dependencies": { "brace-expansion": "^2.0.1" } }, "sha512-G6T0ZX48xgozx7587koeX9Ys2NYy6Gmv//P89sEte9V9whIapMNF4idKxnW2QtCcLiTWlb/wfCabAtAFWhhBow=="],
 
     "@typescript-eslint/typescript-estree/semver": ["semver@7.7.2", "", { "bin": { "semver": "bin/semver.js" } }, "sha512-RF0Fw+rO5AMf9MAyaRXI4AV0Ulj5lMHqVxxdSgiVbixSCXoEmmX/jk0CuJw4+3SqroYO9VoUh+HcuJivvtJemA=="],
 
+    "@typescript-eslint/utils/@eslint-community/eslint-utils": ["@eslint-community/eslint-utils@4.7.0", "", { "dependencies": { "eslint-visitor-keys": "^3.4.3" }, "peerDependencies": { "eslint": "^6.0.0 || ^7.0.0 || >=8.0.0" } }, "sha512-dyybb3AcajC7uha6CvhdVRJqaKyn7w2YKqKyAN37NKYgZT36w+iRb0Dymmc5qEJ549c/S31cMMSFd75bteCpCw=="],
+
     "@uiw/react-markdown-preview/react-markdown": ["react-markdown@9.0.3", "", { "dependencies": { "@types/hast": "^3.0.0", "devlop": "^1.0.0", "hast-util-to-jsx-runtime": "^2.0.0", "html-url-attributes": "^3.0.0", "mdast-util-to-hast": "^13.0.0", "remark-parse": "^11.0.0", "remark-rehype": "^11.0.0", "unified": "^11.0.0", "unist-util-visit": "^5.0.0", "vfile": "^6.0.0" }, "peerDependencies": { "@types/react": ">=18", "react": ">=18" } }, "sha512-Yk7Z94dbgYTOrdk41Z74GoKA7rThnsbbqBTRYuxoe08qvfQ9tJVhmAKw6BJS/ZORG7kTy/s1QvYzSuaoBA1qfw=="],
 
     "@uiw/react-markdown-preview/rehype-prism-plus": ["rehype-prism-plus@2.0.0", "", { "dependencies": { "hast-util-to-string": "^3.0.0", "parse-numeric-range": "^1.3.0", "refractor": "^4.8.0", "rehype-parse": "^9.0.0", "unist-util-filter": "^5.0.0", "unist-util-visit": "^5.0.0" } }, "sha512-FeM/9V2N7EvDZVdR2dqhAzlw5YI49m9Tgn7ZrYJeYHIahM6gcXpH0K1y2gNnKanZCydOMluJvX2cB9z3lhY8XQ=="],
 
+    "antd/@ant-design/colors": ["@ant-design/colors@7.2.1", "", { "dependencies": { "@ant-design/fast-color": "^2.0.6" } }, "sha512-lCHDcEzieu4GA3n8ELeZ5VQ8pKQAWcGGLRTQ50aQM2iqPpq2evTxER84jfdPvsPAtEcZ7m44NI45edFMo8oOYQ=="],
+
+    "antd/@ant-design/icons": ["@ant-design/icons@5.6.1", "", { "dependencies": { "@ant-design/colors": "^7.0.0", "@ant-design/icons-svg": "^4.4.0", "@babel/runtime": "^7.24.8", "classnames": "^2.2.6", "rc-util": "^5.31.1" }, "peerDependencies": { "react": ">=16.0.0", "react-dom": ">=16.0.0" } }, "sha512-0/xS39c91WjPAZOWsvi1//zjx6kAp4kxWwctR6kuU6p133w8RU0D2dSCvZC19uQyharg/sAvYxGYWl01BbZZfg=="],
+
+    "eslint/@eslint/js": ["@eslint/js@9.39.2", "", {}, "sha512-q1mjIoW1VX4IvSocvM/vbTiveKC4k9eLrajNEuSsmjymSDEbpGddtpfOoN7YGAqBK3NG+uqo8ia4PDTt8buCYA=="],
+
     "fast-glob/glob-parent": ["glob-parent@5.1.2", "", { "dependencies": { "is-glob": "^4.0.1" } }, "sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow=="],
 
     "hast-util-from-parse5/hastscript": ["hastscript@9.0.1", "", { "dependencies": { "@types/hast": "^3.0.0", "comma-separated-tokens": "^2.0.0", "hast-util-parse-selector": "^4.0.0", "property-information": "^7.0.0", "space-separated-tokens": "^2.0.0" } }, "sha512-g7df9rMFX/SPi34tyGCyUBREQoKkapwdY/T04Qn9TDWfHhAYt4/I0gMVirzK5wEzeUqIjEB+LXC/ypb7Aqno5w=="],
@@ -943,8 +984,20 @@
 
     "refractor/@types/hast": ["@types/hast@2.3.10", "", { "dependencies": { "@types/unist": "^2" } }, "sha512-McWspRw8xx8J9HurkVBfYj0xKoE25tOFlHGdx4MJ5xORQrMGZNqJhVQWaIbm6Oyla5kYOXtDiopzKRJzEOkwJw=="],
 
+    "@babel/helper-module-imports/@babel/traverse/@babel/generator": ["@babel/generator@7.28.3", "", { "dependencies": { "@babel/parser": "^7.28.3", "@babel/types": "^7.28.2", "@jridgewell/gen-mapping": "^0.3.12", "@jridgewell/trace-mapping": "^0.3.28", "jsesc": "^3.0.2" } }, "sha512-3lSpxGgvnmZznmBkCRnVREPUFJv2wrv9iAoFDvADJc0ypmdOxdUtcLeBgBJ6zE0PMeTKnxeQzyk0xTBq4Ep7zw=="],
+
+    "@babel/helper-module-imports/@babel/traverse/@babel/parser": ["@babel/parser@7.28.3", "", { "dependencies": { "@babel/types": "^7.28.2" }, "bin": "./bin/babel-parser.js" }, "sha512-7+Ey1mAgYqFAx2h0RuoxcQT5+MlG3GTV0TQrgr7/ZliKsm/MNDxVVutlWaziMq7wJNAz8MTqz55XLpWvva6StA=="],
+
+    "@babel/helper-module-transforms/@babel/traverse/@babel/generator": ["@babel/generator@7.28.3", "", { "dependencies": { "@babel/parser": "^7.28.3", "@babel/types": "^7.28.2", "@jridgewell/gen-mapping": "^0.3.12", "@jridgewell/trace-mapping": "^0.3.28", "jsesc": "^3.0.2" } }, "sha512-3lSpxGgvnmZznmBkCRnVREPUFJv2wrv9iAoFDvADJc0ypmdOxdUtcLeBgBJ6zE0PMeTKnxeQzyk0xTBq4Ep7zw=="],
+
+    "@babel/helper-module-transforms/@babel/traverse/@babel/parser": ["@babel/parser@7.28.3", "", { "dependencies": { "@babel/types": "^7.28.2" }, "bin": "./bin/babel-parser.js" }, "sha512-7+Ey1mAgYqFAx2h0RuoxcQT5+MlG3GTV0TQrgr7/ZliKsm/MNDxVVutlWaziMq7wJNAz8MTqz55XLpWvva6StA=="],
+
+    "@babel/helper-module-transforms/@babel/traverse/@babel/types": ["@babel/types@7.28.2", "", { "dependencies": { "@babel/helper-string-parser": "^7.27.1", "@babel/helper-validator-identifier": "^7.27.1" } }, "sha512-ruv7Ae4J5dUYULmeXw1gmb7rYRz57OWCPM57pHojnLq/3Z1CK2lNSLTCVjxVk1F/TZHwOZZrOWi0ur95BbLxNQ=="],
+
     "@typescript-eslint/typescript-estree/minimatch/brace-expansion": ["brace-expansion@2.0.2", "", { "dependencies": { "balanced-match": "^1.0.0" } }, "sha512-Jt0vHyM+jmUBqojB7E1NIYadt0vI0Qxjxd2TErW94wDz+E2LAm5vKMXXwg6ZZBTHPuUlDgQHKXvjGBdfcF1ZDQ=="],
 
+    "@typescript-eslint/utils/@eslint-community/eslint-utils/eslint-visitor-keys": ["eslint-visitor-keys@3.4.3", "", {}, "sha512-wpc+LXeiyiisxPlEkUzU6svyS1frIO3Mgxj1fdy7Pm8Ygzguax2N3Fa/D/ag1WqbOprdI+uY6wMUl8/a2G+iag=="],
+
     "hast-util-from-parse5/hastscript/hast-util-parse-selector": ["hast-util-parse-selector@4.0.0", "", { "dependencies": { "@types/hast": "^3.0.0" } }, "sha512-wkQCkSYoOGCRKERFWcxMVMOcYE2K1AaNLU8DXS9arxnLOUEWbOXKXiJUNzEpqZ3JOKpnha3jkFrumEjVliDe7A=="],
 
     "hast-util-parse-selector/@types/hast/@types/unist": ["@types/unist@2.0.11", "", {}, "sha512-CmBKiL6NNo/OqgmMn95Fk9Whlp2mtvIv+KNpQKN2F4SjvrEesubTRWGYSg+BnWZOnlCaSTU1sMpsBOzgbYhnsA=="],

web/eslint.config.js

@@ -15,6 +15,16 @@ export default tseslint.config([
       reactHooks.configs['recommended-latest'],
       reactRefresh.configs.vite,
     ],
+    rules: {
+      '@typescript-eslint/no-explicit-any': 'off',
+      'react-refresh/only-export-components': [
+        'error',
+        {
+          allowConstantExport: true,
+          allowExportNames: ['routes', 'useAuth', 'useTheme', 'useAppWindows', 'useI18n'],
+        },
+      ],
+    },
     languageOptions: {
       ecmaVersion: 2020,
       globals: globals.browser,

web/package.json

@@ -10,12 +10,12 @@
     "preview": "vite preview"
   },
   "dependencies": {
-    "@ant-design/icons": "5.x",
+    "@ant-design/icons": "6.x",
     "@ant-design/v5-patch-for-react-19": "^1.0.3",
     "@monaco-editor/react": "^4.7.0",
     "@uiw/react-md-editor": "^4.0.8",
     "antd": "^5.27.0",
-    "artplayer": "^5.2.5",
+    "artplayer": "^5.3.0",
     "date-fns": "^4.1.0",
     "monaco-editor": "^0.53.0",
     "react": "^19.1.1",
@@ -27,10 +27,10 @@
     "@eslint/js": "^9.33.0",
     "@types/react": "^19.1.10",
     "@types/react-dom": "^19.1.7",
-    "@vitejs/plugin-react": "^5.0.0",
-    "eslint": "^9.33.0",
+    "@vitejs/plugin-react": "^5.1.2",
+    "eslint": "^9.39.2",
     "eslint-plugin-react-hooks": "^5.2.0",
-    "eslint-plugin-react-refresh": "^0.4.20",
+    "eslint-plugin-react-refresh": "^0.4.26",
     "globals": "^16.3.0",
     "typescript": "~5.8.3",
     "typescript-eslint": "^8.39.1",

web/src/api/client.ts

@@ -49,7 +49,7 @@ async function request<T = any>(url: string, options: RequestOptions = {}): Prom
       } else {
         errMsg = (typeof data?.detail === 'string') ? data.detail : (data.detail ? JSON.stringify(data.detail) : JSON.stringify(data));
       }
-    } catch (_) { }
+    } catch { void 0; }
     throw new Error(errMsg || `Request failed: ${resp.status}`);
   }
 

web/src/api/plugins.ts

@@ -4,6 +4,7 @@ export interface PluginItem {
   id: number;
   url: string;
   enabled: boolean;
+  open_app?: boolean | null;
   key?: string | null;
   name?: string | null;
   version?: string | null;
@@ -26,6 +27,7 @@ export interface PluginManifestUpdate {
   key?: string;
   name?: string;
   version?: string;
+  open_app?: boolean;
   supported_exts?: string[];
   default_bounds?: Record<string, any>;
   default_maximized?: boolean;
@@ -43,4 +45,3 @@ export const pluginsApi = {
   update: (id: number, payload: PluginCreate) => request<PluginItem>(`/plugins/${id}`, { method: 'PUT', json: payload }),
   updateManifest: (id: number, payload: PluginManifestUpdate) => request<PluginItem>(`/plugins/${id}/metadata`, { method: 'POST', json: payload }),
 };
-

web/src/api/processors.ts

@@ -16,6 +16,7 @@ export interface ProcessorTypeMeta {
   supported_exts: string[];
   config_schema: ProcessorTypeField[];
   produces_file: boolean;
+  supports_directory?: boolean;
   module_path?: string | null;
 }
 

web/src/api/vfs.ts

@@ -107,7 +107,7 @@ export const vfsApi = {
               const json = JSON.parse(xhr.responseText);
               if (json.code === 0) return resolve(json.data);
               return reject(new Error(json.msg || json.message || 'Upload failed'));
-            } catch (e) {
+            } catch {
               return reject(new Error('Invalid response'));
             }
           } else {
@@ -115,7 +115,7 @@ export const vfsApi = {
             try {
               const json = JSON.parse(xhr.responseText);
               err = json.detail || json.msg || json.message || err;
-            } catch (_) {}
+            } catch { void 0; }
             reject(new Error(err));
           }
         }

web/src/api/videoLibrary.ts

@@ -0,0 +1,35 @@
+import request from './client';
+
+export type VideoLibraryMediaType = 'tv' | 'movie';
+
+export interface VideoLibraryItem {
+  id: string;
+  type: VideoLibraryMediaType;
+  title: string;
+  year?: string | null;
+  overview?: string | null;
+  poster_path?: string | null;
+  backdrop_path?: string | null;
+  genres?: string[];
+  tmdb_id?: number | null;
+  source_path?: string | null;
+  scraped_at?: string | null;
+  updated_at?: string | null;
+  episodes_count?: number;
+  seasons_count?: number;
+  vote_average?: number | null;
+  vote_count?: number | null;
+}
+
+export const videoLibraryApi = {
+  list: (params?: { q?: string; type?: VideoLibraryMediaType }) => {
+    const search = new URLSearchParams();
+    if (params?.q) search.set('q', params.q);
+    if (params?.type) search.set('type', params.type);
+    const suffix = search.toString();
+    return request<VideoLibraryItem[]>(`/plugins/video-player/library${suffix ? `?${suffix}` : ''}`, { method: 'GET' });
+  },
+  get: (id: string) =>
+    request<any>(`/plugins/video-player/library/${encodeURIComponent(id)}`, { method: 'GET' }),
+};
+

web/src/apps/AppWindowsLayer.tsx

@@ -1,14 +1,15 @@
 import React, { useRef, useEffect, useCallback } from 'react';
 import { Space, Button } from 'antd';
 import { FullscreenExitOutlined, FullscreenOutlined, CloseOutlined, MinusOutlined } from '@ant-design/icons';
-import type { AppDescriptor, AppComponentProps } from './types';
+import type { AppDescriptor, AppComponentProps, AppOpenComponentProps } from './types';
 import type { VfsEntry } from '../api/client';
 
 export interface AppWindowItem {
   id: string;
   app: AppDescriptor;
-  entry: VfsEntry;
-  filePath: string;
+  kind: 'file' | 'app';
+  entry?: VfsEntry;
+  filePath?: string;
   maximized: boolean;
   minimized: boolean;
   x: number;
@@ -17,12 +18,14 @@ export interface AppWindowItem {
   height: number;
 }
 
+type AppWindowPatch = Partial<Pick<AppWindowItem, 'maximized' | 'minimized' | 'x' | 'y' | 'width' | 'height'>>;
+
 interface AppWindowsLayerProps {
   windows: AppWindowItem[];
   onClose: (id: string) => void;
   onToggleMax: (id: string) => void;
   onBringToFront: (id: string) => void;
-  onUpdateWindow: (id: string, patch: Partial<AppWindowItem>) => void;
+  onUpdateWindow: (id: string, patch: AppWindowPatch) => void;
 }
 
 export const AppWindowsLayer: React.FC<AppWindowsLayerProps> = ({ windows, onClose, onToggleMax, onBringToFront, onUpdateWindow }) => {
@@ -54,8 +57,8 @@ export const AppWindowsLayer: React.FC<AppWindowsLayerProps> = ({ windows, onClo
       const { id, startX, startY, originX, originY } = dragRef.current;
       const dx = e.clientX - startX;
       const dy = e.clientY - startY;
-      let newX = Math.max(0, originX + dx);
-      let newY = Math.max(48, originY + dy);
+      const newX = Math.max(0, originX + dx);
+      const newY = Math.max(0, originY + dy);
       dragRef.current.newX = newX;
       dragRef.current.newY = newY;
       const el = windowEls.current[id];
@@ -193,8 +196,17 @@ export const AppWindowsLayer: React.FC<AppWindowsLayerProps> = ({ windows, onClo
   return (
     <>
       {visibleWindows.map((w, idx) => {
-        const AppComp = w.app.component as React.FC<AppComponentProps>;
+        const isFileWindow = w.kind !== 'app';
+        const FileComp = w.app.component as React.FC<AppComponentProps>;
+        const OpenComp = w.app.openAppComponent as React.FC<AppOpenComponentProps> | undefined;
+        const ContentComp = (isFileWindow ? FileComp : OpenComp) as React.FC<any> | undefined;
         const useSystemWindow = w.app.useSystemWindow !== false; // 默认为 true
+        const titleText = isFileWindow ? `${w.app.name} - ${w.entry?.name || ''}` : w.app.name;
+
+        if (!ContentComp) {
+          return null;
+        }
+
         if (!useSystemWindow) {
           return (
             <div
@@ -223,16 +235,20 @@ export const AppWindowsLayer: React.FC<AppWindowsLayerProps> = ({ windows, onClo
                   overflow: 'hidden',
                   background: 'transparent'
                 }}
-              >
-                <AppComp
-                  filePath={w.filePath}
-                  entry={w.entry}
-                  onRequestClose={() => onClose(w.id)}
-                />
-              </div>
-            </div>
-          );
-        }
+	              >
+	                {isFileWindow ? (
+	                  <ContentComp
+	                    filePath={w.filePath || ''}
+	                    entry={w.entry as VfsEntry}
+	                    onRequestClose={() => onClose(w.id)}
+	                  />
+	                ) : (
+	                  <ContentComp onRequestClose={() => onClose(w.id)} />
+	                )}
+	              </div>
+	            </div>
+	          );
+	        }
         // 否则继续使用系统窗口渲染（不改动原有逻辑）
         const interacting = isInteracting(w.id);
         return (
@@ -290,9 +306,9 @@ export const AppWindowsLayer: React.FC<AppWindowsLayerProps> = ({ windows, onClo
                   paddingRight: 8,
                   flex: 1
                 }}
-              >
-                {w.app.name} - {w.entry.name}
-              </span>
+	              >
+	                {titleText}
+	              </span>
               <Space size={4}>
                 <Button
                   type="text"
@@ -351,11 +367,15 @@ export const AppWindowsLayer: React.FC<AppWindowsLayerProps> = ({ windows, onClo
               }}
             >
               {!w.maximized && resizeHandles(w)}
-              <AppComp
-                filePath={w.filePath}
-                entry={w.entry}
-                onRequestClose={() => onClose(w.id)}
-              />
+              {isFileWindow ? (
+                <ContentComp
+                  filePath={w.filePath || ''}
+                  entry={w.entry as VfsEntry}
+                  onRequestClose={() => onClose(w.id)}
+                />
+              ) : (
+                <ContentComp onRequestClose={() => onClose(w.id)} />
+              )}
             </div>
           </div>
         );

web/src/apps/ImageViewer/index.ts

@@ -1,14 +1,19 @@
 import type { AppDescriptor } from '../types';
 import { ImageViewerApp } from './ImageViewer.tsx';
 
+const supportedExts = ['png', 'jpg', 'jpeg', 'gif', 'webp', 'svg', 'bmp', 'ico', 'avif', 'arw', 'cr2', 'cr3', 'nef', 'rw2', 'orf', 'pef', 'dng'];
+
 export const descriptor: AppDescriptor = {
   key: 'image-viewer',
   name: '图片查看器',
   iconUrl: 'https://api.iconify.design/mdi:image.svg',
+  description: '内置图片查看器，支持常见图片与部分 RAW 格式预览。',
+  author: 'Foxel',
+  supportedExts,
   supported: (entry) => {
     if (entry.is_dir) return false;
     const ext = entry.name.split('.').pop()?.toLowerCase() || '';
-    return ['png', 'jpg', 'jpeg', 'gif', 'webp', 'svg', 'bmp', 'ico', 'avif', 'arw', 'cr2', 'cr3', 'nef', 'rw2', 'orf', 'pef', 'dng'].includes(ext);
+    return supportedExts.includes(ext);
   },
   component: ImageViewerApp,
   default: true,

web/src/apps/OfficeViewer/OfficeViewer.tsx

@@ -6,6 +6,7 @@ import { useSystemStatus } from '../../contexts/SystemContext';
 
 export const OfficeViewerApp: React.FC<AppComponentProps> = ({ filePath, onRequestClose }) => {
   const systemStatus = useSystemStatus();
+  const fileDomain = systemStatus?.file_domain;
   const [url, setUrl] = useState<string>();
   const [loading, setLoading] = useState(true);
   const [err, setErr] = useState<string>();
@@ -19,7 +20,7 @@ export const OfficeViewerApp: React.FC<AppComponentProps> = ({ filePath, onReque
     vfsApi.getTempLinkToken(filePath.replace(/^\/+/, ''))
       .then(res => {
         if (cancelled) return;
-        const baseUrl = systemStatus?.file_domain || window.location.origin;
+        const baseUrl = fileDomain || window.location.origin;
         const fullUrl = new URL(res.url, baseUrl).href;
         const officeUrl = `https://view.officeapps.live.com/op/embed.aspx?src=${encodeURIComponent(fullUrl)}`;
         setUrl(officeUrl);
@@ -38,7 +39,7 @@ export const OfficeViewerApp: React.FC<AppComponentProps> = ({ filePath, onReque
     return () => {
       cancelled = true;
     };
-  }, [filePath]);
+  }, [filePath, fileDomain]);
 
   if (loading) {
     return (

web/src/apps/OfficeViewer/index.ts

@@ -1,14 +1,19 @@
 import type { AppDescriptor } from '../types';
 import { OfficeViewerApp } from './OfficeViewer.tsx';
 
+const supportedExts = ['docx', 'xlsx', 'pptx', 'doc', 'xls', 'ppt'];
+
 export const descriptor: AppDescriptor = {
   key: 'office-viewer',
   name: 'Office 文档查看器',
   iconUrl: 'https://api.iconify.design/mdi:file-word-box.svg',
+  description: '内置 Office 文档查看器，支持 Word/Excel/PowerPoint 文件预览。',
+  author: 'Foxel',
+  supportedExts,
   supported: (entry) => {
     if (entry.is_dir) return false;
     const ext = entry.name.split('.').pop()?.toLowerCase() || '';
-    return ['docx', 'xlsx', 'pptx', 'doc', 'xls', 'ppt'].includes(ext);
+    return supportedExts.includes(ext);
   },
   component: OfficeViewerApp,
   default: true,

web/src/apps/PdfViewer/index.ts

@@ -1,14 +1,19 @@
 import type { AppDescriptor } from '../types';
 import { PdfViewerApp } from './PdfViewer';
 
+const supportedExts = ['pdf'];
+
 export const descriptor: AppDescriptor = {
   key: 'pdf-viewer',
   name: 'PDF 查看器',
   iconUrl: 'https://api.iconify.design/mdi:file-pdf-box.svg',
+  description: '内置 PDF 查看器。',
+  author: 'Foxel',
+  supportedExts,
   supported: (entry) => {
     if (entry.is_dir) return false;
     const ext = entry.name.split('.').pop()?.toLowerCase() || '';
-    return ext === 'pdf';
+    return supportedExts.includes(ext);
   },
   component: PdfViewerApp,
   default: true,

web/src/apps/PluginHost/index.tsx

@@ -1,7 +1,7 @@
 import React, { useRef, useState } from 'react';
-import type { AppComponentProps } from '../types';
+import type { AppComponentProps, AppOpenComponentProps } from '../types';
 import { vfsApi } from '../../api/vfs';
-import { loadPluginFromUrl, ensureManifest, type RegisteredPlugin } from '../../plugins/runtime';
+import { loadPlugin, ensureManifest, type RegisteredPlugin } from '../../plugins/runtime';
 import type { PluginItem } from '../../api/plugins';
 import { useAsyncSafeEffect } from '../../hooks/useAsyncSafeEffect';
 import { useI18n } from '../../i18n';
@@ -22,7 +22,7 @@ export const PluginAppHost: React.FC<PluginAppHostProps> = ({ plugin, filePath,
   useAsyncSafeEffect(
     async ({ isDisposed }) => {
       try {
-        const p = await loadPluginFromUrl(plugin.url);
+        const p = await loadPlugin(plugin);
         if (isDisposed()) return;
         pluginRef.current = p;
         await ensureManifest(plugin.id, p);
@@ -47,7 +47,56 @@ export const PluginAppHost: React.FC<PluginAppHostProps> = ({ plugin, filePath,
         if (pluginRef.current?.unmount && containerRef.current) {
           pluginRef.current.unmount(containerRef.current);
         }
-      } catch {}
+      } catch { void 0; }
+    },
+  );
+
+  if (error) {
+    return <div style={{ padding: 12, color: 'red' }}>{t('Plugin Error')}: {error}</div>;
+  }
+
+  return <div ref={containerRef} style={{ width: '100%', height: '100%', overflow: 'auto' }} />;
+};
+
+export interface PluginAppOpenHostProps extends AppOpenComponentProps {
+  plugin: PluginItem;
+}
+
+export const PluginAppOpenHost: React.FC<PluginAppOpenHostProps> = ({ plugin, onRequestClose }) => {
+  const containerRef = useRef<HTMLDivElement>(null);
+  const [error, setError] = useState<string | null>(null);
+  const onCloseRef = useRef(onRequestClose);
+  onCloseRef.current = onRequestClose;
+  const { t } = useI18n();
+
+  const pluginRef = useRef<RegisteredPlugin | null>(null);
+
+  useAsyncSafeEffect(
+    async ({ isDisposed }) => {
+      try {
+        const p = await loadPlugin(plugin);
+        if (isDisposed()) return;
+        pluginRef.current = p;
+        await ensureManifest(plugin.id, p);
+        if (isDisposed() || !containerRef.current) return;
+        if (typeof p.mountApp !== 'function') {
+          throw new Error('该插件不支持独立打开');
+        }
+        await p.mountApp(containerRef.current, {
+          host: { close: () => onCloseRef.current() },
+        });
+      } catch (e: any) {
+        if (!isDisposed()) setError(e?.message || t('Plugin run failed'));
+      }
+    },
+    [plugin.id, plugin.url],
+    () => {
+      try {
+        if (!containerRef.current) return;
+        const p = pluginRef.current;
+        if (p?.unmountApp) return p.unmountApp(containerRef.current);
+        if (p?.unmount) return p.unmount(containerRef.current);
+      } catch { void 0; }
     },
   );
 

web/src/apps/TextEditor/TextEditor.tsx

@@ -9,13 +9,14 @@ const MarkdownEditor = React.lazy(() => import('@uiw/react-md-editor'));
 
 const { Header, Content } = Layout;
 
+const MAX_PREVIEW_BYTES = 1024 * 1024; // 1MB
+
 export const TextEditorApp: React.FC<AppComponentProps> = ({ filePath, entry, onRequestClose }) => {
   const [loading, setLoading] = useState(true);
   const [saving, setSaving] = useState(false);
   const [content, setContent] = useState('');
   const [initialContent, setInitialContent] = useState('');
   const [truncated, setTruncated] = useState(false);
-  const MAX_PREVIEW_BYTES = 1024 * 1024; // 1MB
   const isDirty = content !== initialContent;
   const onRequestCloseRef = useRef(onRequestClose);
   onRequestCloseRef.current = onRequestClose;

web/src/apps/TextEditor/index.ts

@@ -1,34 +1,39 @@
 import type { AppDescriptor } from '../types';
 import { TextEditorApp } from './TextEditor.tsx';
 
+const supportedExts = [
+  // Text formats
+  'txt', 'md', 'markdown', 'log',
+  // Data formats
+  'json', 'yaml', 'yml', 'xml', 'toml', 'ini', 'cfg', 'conf',
+  // Web technologies
+  'html', 'htm', 'css', 'scss', 'sass', 'less', 'js', 'jsx', 'ts', 'tsx', 'vue',
+  // Programming languages
+  'py', 'java', 'c', 'cpp', 'cc', 'cxx', 'h', 'hpp', 'hxx',
+  'php', 'rb', 'go', 'rs', 'swift', 'kt', 'scala', 'clj', 'cljs',
+  'cs', 'vb', 'fs', 'pl', 'pm', 'r', 'lua', 'dart', 'elm',
+  // Database
+  'sql',
+  // Shell and scripts
+  'sh', 'bash', 'zsh', 'fish', 'ps1', 'bat', 'cmd',
+  // Build and config files
+  'dockerfile', 'makefile', 'gradle', 'cmake',
+  // Other common text files
+  'gitignore', 'gitattributes', 'editorconfig', 'prettierrc'
+];
+
 export const descriptor: AppDescriptor = {
   key: 'text-editor',
   name: '文本编辑器',
   iconUrl: 'https://api.iconify.design/mdi:file-document-outline.svg',
+  description: '内置文本/代码编辑器，支持常见文本与代码格式。',
+  author: 'Foxel',
+  supportedExts,
   supported: (entry) => {
     if (entry.is_dir) return false;
     const ext = entry.name.split('.').pop()?.toLowerCase() || '';
     // Supports common text and code formats
-    return [
-      // Text formats
-      'txt', 'md', 'markdown', 'log',
-      // Data formats
-      'json', 'yaml', 'yml', 'xml', 'toml', 'ini', 'cfg', 'conf',
-      // Web technologies
-      'html', 'htm', 'css', 'scss', 'sass', 'less', 'js', 'jsx', 'ts', 'tsx', 'vue',
-      // Programming languages
-      'py', 'java', 'c', 'cpp', 'cc', 'cxx', 'h', 'hpp', 'hxx',
-      'php', 'rb', 'go', 'rs', 'swift', 'kt', 'scala', 'clj', 'cljs',
-      'cs', 'vb', 'fs', 'pl', 'pm', 'r', 'lua', 'dart', 'elm',
-      // Database
-      'sql',
-      // Shell and scripts
-      'sh', 'bash', 'zsh', 'fish', 'ps1', 'bat', 'cmd',
-      // Build and config files
-      'dockerfile', 'makefile', 'gradle', 'cmake',
-      // Other common text files
-      'gitignore', 'gitattributes', 'editorconfig', 'prettierrc'
-    ].includes(ext);
+    return supportedExts.includes(ext);
   },
   component: TextEditorApp,
   default: true,

web/src/apps/VideoPlayer/VideoLibrary.tsx

@@ -0,0 +1,708 @@
+import React, { useCallback, useEffect, useMemo, useState } from 'react';
+import {
+  Avatar,
+  Button,
+  Card,
+  Collapse,
+  Descriptions,
+  Divider,
+  Drawer,
+  Empty,
+  Flex,
+  Image,
+  Input,
+  List,
+  Segmented,
+  Skeleton,
+  Space,
+  Tabs,
+  Tag,
+  Typography,
+  message,
+  theme,
+} from 'antd';
+import { PlayCircleOutlined, ReloadOutlined, SearchOutlined, VideoCameraOutlined } from '@ant-design/icons';
+import type { AppOpenComponentProps } from '../types';
+import { videoLibraryApi, type VideoLibraryItem } from '../../api/videoLibrary';
+import { useI18n } from '../../i18n';
+import { ensureAppsLoaded, getAppByKey } from '../registry';
+import { useAppWindows } from '../../contexts/AppWindowsContext';
+import type { VfsEntry } from '../../api/client';
+
+type LibraryFilter = 'all' | 'tv' | 'movie';
+
+const TMDB_IMAGE_BASE = 'https://image.tmdb.org/t/p/';
+
+function tmdbImage(path: string | null | undefined, size: string) {
+  if (!path) return undefined;
+  return `${TMDB_IMAGE_BASE}${size}${path}`;
+}
+
+function splitAbsolutePath(fullPath: string): { dir: string; name: string } | null {
+  const normalized = fullPath.replace(/\/+$/, '');
+  const idx = normalized.lastIndexOf('/');
+  if (idx < 0) return null;
+  const dir = idx === 0 ? '/' : normalized.slice(0, idx);
+  const name = normalized.slice(idx + 1);
+  if (!name) return null;
+  return { dir, name };
+}
+
+export const VideoLibraryApp: React.FC<AppOpenComponentProps> = () => {
+  const { token } = theme.useToken();
+  const { t } = useI18n();
+  const { openWithApp } = useAppWindows();
+  const [q, setQ] = useState('');
+  const [filter, setFilter] = useState<LibraryFilter>('all');
+  const [items, setItems] = useState<VideoLibraryItem[]>([]);
+  const [loading, setLoading] = useState(false);
+  const [detailOpen, setDetailOpen] = useState(false);
+  const [selected, setSelected] = useState<VideoLibraryItem | null>(null);
+  const [detailLoading, setDetailLoading] = useState(false);
+  const [detail, setDetail] = useState<any | null>(null);
+
+  const loadLibrary = useCallback(async () => {
+    setLoading(true);
+    try {
+      const list = await videoLibraryApi.list();
+      setItems(list);
+    } catch (err: any) {
+      setItems([]);
+      const msg = err instanceof Error ? err.message : t('Load failed');
+      message.error(msg);
+    } finally {
+      setLoading(false);
+    }
+  }, [t]);
+
+  useEffect(() => {
+    loadLibrary();
+  }, [loadLibrary]);
+
+  const stats = useMemo(() => {
+    let tv = 0;
+    let movie = 0;
+    items.forEach((it) => {
+      if (it.type === 'tv') tv += 1;
+      if (it.type === 'movie') movie += 1;
+    });
+    return { total: items.length, tv, movie };
+  }, [items]);
+
+  const filtered = useMemo(() => {
+    const s = q.trim().toLowerCase();
+    return items.filter((v) => {
+      if (filter !== 'all' && v.type !== filter) return false;
+      if (!s) return true;
+      const haystack = `${v.title || ''} ${v.overview || ''} ${(v.genres || []).join(' ')}`.toLowerCase();
+      return haystack.includes(s);
+    });
+  }, [filter, items, q]);
+
+  const playByPath = useCallback(async (fullPath: string) => {
+    const splitted = splitAbsolutePath(fullPath);
+    if (!splitted) return;
+    await ensureAppsLoaded();
+    const app = getAppByKey('video-player');
+    if (!app) {
+      message.error(t('App "{key}" not found.', { key: 'video-player' }));
+      return;
+    }
+    const entry: VfsEntry = { name: splitted.name, is_dir: false, size: 0, mtime: 0 };
+    openWithApp(entry, app, splitted.dir);
+  }, [openWithApp, t]);
+
+  const fetchDetail = useCallback(async (item: VideoLibraryItem) => {
+    setDetailLoading(true);
+    setDetail(null);
+    try {
+      const payload = await videoLibraryApi.get(item.id);
+      setDetail(payload);
+    } catch (err: any) {
+      setDetail(null);
+      const msg = err instanceof Error ? err.message : t('Load failed');
+      message.error(msg);
+    } finally {
+      setDetailLoading(false);
+    }
+  }, [t]);
+
+  const openDetail = (item: VideoLibraryItem) => {
+    setSelected(item);
+    setDetailOpen(true);
+    fetchDetail(item);
+  };
+
+  const closeDetail = () => {
+    setDetailOpen(false);
+    setSelected(null);
+    setDetail(null);
+  };
+
+  const renderCover = (item: VideoLibraryItem) => {
+    const label = item.type === 'tv' ? 'TV' : 'Movie';
+    const coverUrl = tmdbImage(item.poster_path, 'w342') || tmdbImage(item.backdrop_path, 'w780');
+    return (
+      <div
+        style={{
+          position: 'relative',
+          width: '100%',
+          aspectRatio: '2 / 3',
+          background: 'linear-gradient(135deg, #0b1020 0%, #22314a 55%, #2b3b5c 100%)',
+          overflow: 'hidden',
+        }}
+      >
+        {coverUrl ? (
+          <Image
+            src={coverUrl}
+            alt={item.title || label}
+            preview={false}
+            wrapperStyle={{ width: '100%', height: '100%', display: 'block' }}
+            style={{ width: '100%', height: '100%', objectFit: 'cover', display: 'block' }}
+            fallback="/logo.svg"
+          />
+        ) : (
+          <div
+            style={{
+              position: 'absolute',
+              inset: 0,
+              display: 'flex',
+              alignItems: 'center',
+              justifyContent: 'center',
+              color: 'rgba(255,255,255,0.7)',
+            }}
+          >
+            <VideoCameraOutlined style={{ fontSize: 28 }} />
+          </div>
+        )}
+
+        <div
+          style={{
+            position: 'absolute',
+            inset: 0,
+            background: 'linear-gradient(180deg, rgba(0,0,0,0.48) 0%, rgba(0,0,0,0.12) 40%, rgba(0,0,0,0.45) 100%)',
+            pointerEvents: 'none',
+          }}
+        />
+
+        <div
+          style={{
+            position: 'absolute',
+            top: 10,
+            left: 10,
+            right: 10,
+            display: 'flex',
+            justifyContent: 'space-between',
+            alignItems: 'center',
+            gap: 8,
+            pointerEvents: 'none',
+          }}
+        >
+          <Tag color={item.type === 'tv' ? 'geekblue' : 'gold'} style={{ marginInlineEnd: 0 }}>
+            {label}
+          </Tag>
+          <VideoCameraOutlined style={{ fontSize: 18, opacity: 0.9, color: 'rgba(255,255,255,0.9)' }} />
+        </div>
+
+        <div
+          style={{
+            position: 'absolute',
+            left: 10,
+            bottom: 10,
+            width: 36,
+            height: 36,
+            borderRadius: 999,
+            background: 'rgba(2,6,23,0.55)',
+            border: '1px solid rgba(255,255,255,0.22)',
+            display: 'flex',
+            alignItems: 'center',
+            justifyContent: 'center',
+            color: 'rgba(255,255,255,0.92)',
+            boxShadow: token.boxShadowTertiary,
+            pointerEvents: 'none',
+          }}
+        >
+          <PlayCircleOutlined style={{ fontSize: 20 }} />
+        </div>
+      </div>
+    );
+  };
+
+  const detailTitle = useMemo(() => {
+    const d = detail?.tmdb?.detail;
+    if (!d) return selected?.title || '';
+    if (detail?.type === 'tv') return d.name || d.original_name || selected?.title || '';
+    return d.title || d.original_title || selected?.title || '';
+  }, [detail, selected?.title]);
+
+  const detailPosterUrl = useMemo(() => tmdbImage(detail?.tmdb?.detail?.poster_path, 'w342'), [detail]);
+  const detailBackdropUrl = useMemo(() => tmdbImage(detail?.tmdb?.detail?.backdrop_path, 'w1280'), [detail]);
+
+  const detailGenres = useMemo(() => {
+    const genres = detail?.tmdb?.detail?.genres;
+    if (!Array.isArray(genres)) return [];
+    return genres.map((g: any) => g?.name).filter(Boolean);
+  }, [detail]);
+
+  const detailOverview = useMemo(() => {
+    const overview = detail?.tmdb?.detail?.overview;
+    if (!overview) return '';
+    return String(overview);
+  }, [detail]);
+
+  const castTop = useMemo(() => {
+    const cast = detail?.tmdb?.detail?.credits?.cast;
+    if (!Array.isArray(cast)) return [];
+    return cast.slice(0, 12);
+  }, [detail]);
+
+  const episodesBySeason = useMemo(() => {
+    if (detail?.type !== 'tv') return [];
+    const episodes = Array.isArray(detail?.episodes) ? detail.episodes : [];
+    const map = new Map<number, any[]>();
+    episodes.forEach((ep: any) => {
+      const season = typeof ep?.season === 'number' ? ep.season : 1;
+      if (!map.has(season)) map.set(season, []);
+      map.get(season)!.push(ep);
+    });
+    const seasons = Array.from(map.keys()).sort((a, b) => a - b);
+    return seasons.map((season) => {
+      const list = (map.get(season) || []).slice().sort((a, b) => {
+        const ae = typeof a?.episode === 'number' ? a.episode : 10_000;
+        const be = typeof b?.episode === 'number' ? b.episode : 10_000;
+        return ae - be;
+      });
+      return { season, episodes: list };
+    });
+  }, [detail]);
+
+  const renderHero = () => {
+    const year = detail?.type === 'tv'
+      ? (detail?.tmdb?.detail?.first_air_date || '').slice(0, 4)
+      : (detail?.tmdb?.detail?.release_date || '').slice(0, 4);
+    const vote = detail?.tmdb?.detail?.vote_average;
+    const voteText = typeof vote === 'number' ? vote.toFixed(1) : '--';
+
+    return (
+      <div
+        style={{
+          position: 'relative',
+          padding: 16,
+          minHeight: 220,
+          background: detailBackdropUrl
+            ? `url(${detailBackdropUrl}) center / cover no-repeat`
+            : 'linear-gradient(135deg, #0b1020 0%, #22314a 55%, #2b3b5c 100%)',
+          overflow: 'hidden',
+        }}
+      >
+        <div
+          style={{
+            position: 'absolute',
+            inset: 0,
+            background: 'linear-gradient(90deg, rgba(2,6,23,0.92) 0%, rgba(2,6,23,0.55) 55%, rgba(2,6,23,0.15) 100%)',
+          }}
+        />
+        <div style={{ position: 'relative', display: 'flex', gap: 16, alignItems: 'flex-end' }}>
+          <div style={{ width: 132, flex: 'none' }}>
+            <div style={{ borderRadius: 12, overflow: 'hidden', boxShadow: token.boxShadowTertiary, border: '1px solid rgba(255,255,255,0.18)' }}>
+              {detailPosterUrl ? (
+                <Image
+                  src={detailPosterUrl}
+                  alt={detailTitle}
+                  preview={false}
+                  width={132}
+                  height={198}
+                  style={{ objectFit: 'cover', display: 'block' }}
+                  fallback="/logo.svg"
+                />
+              ) : (
+                <div
+                  style={{
+                    width: 132,
+                    height: 198,
+                    background: 'rgba(255,255,255,0.08)',
+                    display: 'flex',
+                    alignItems: 'center',
+                    justifyContent: 'center',
+                    color: 'rgba(255,255,255,0.75)',
+                  }}
+                >
+                  <VideoCameraOutlined style={{ fontSize: 28 }} />
+                </div>
+              )}
+            </div>
+          </div>
+
+          <div style={{ minWidth: 0, flex: 1, color: 'rgba(255,255,255,0.92)' }}>
+            <Typography.Title level={3} style={{ margin: 0, color: 'rgba(255,255,255,0.92)' }} ellipsis>
+              {detailTitle}
+            </Typography.Title>
+            <div style={{ marginTop: 6, display: 'flex', flexWrap: 'wrap', gap: 10, alignItems: 'center', color: 'rgba(255,255,255,0.72)' }}>
+              {year && <span>{year}</span>}
+              <span>·</span>
+              <span>TMDB {voteText}</span>
+              {detail?.type === 'tv' && (
+                <>
+                  <span>·</span>
+                  <span>{episodesBySeason.reduce((acc, s) => acc + s.episodes.length, 0)} {t('Episodes')}</span>
+                </>
+              )}
+            </div>
+            <div style={{ marginTop: 10, display: 'flex', flexWrap: 'wrap', gap: 6 }}>
+              {(detailGenres || []).slice(0, 6).map((g: string) => (
+                <Tag key={g} color="geekblue" style={{ marginInlineEnd: 0 }}>
+                  {g}
+                </Tag>
+              ))}
+            </div>
+            {detail?.type === 'movie' && (
+              <div style={{ marginTop: 14 }}>
+                <Button
+                  type="primary"
+                  icon={<PlayCircleOutlined />}
+                  onClick={() => playByPath(String(detail?.source_path || ''))}
+                  disabled={!detail?.source_path}
+                >
+                  {t('Play')}
+                </Button>
+              </div>
+            )}
+          </div>
+        </div>
+      </div>
+    );
+  };
+
+  const renderMeta = () => {
+    if (!detail?.tmdb?.detail) return null;
+    const d = detail.tmdb.detail;
+    const isTv = detail?.type === 'tv';
+    const release = isTv ? d.first_air_date : d.release_date;
+    const runtime = isTv ? (Array.isArray(d.episode_run_time) ? d.episode_run_time[0] : undefined) : d.runtime;
+    const status = d.status;
+    const language = d.original_language;
+    const origin = isTv ? d.original_name : d.original_title;
+    const seasons = isTv ? d.number_of_seasons : undefined;
+    const eps = isTv ? d.number_of_episodes : undefined;
+
+    return (
+      <Descriptions
+        size="small"
+        column={2}
+        styles={{ label: { width: 110, color: token.colorTextSecondary } }}
+        style={{ marginTop: 10 }}
+      >
+        <Descriptions.Item label={t('Type')}>{isTv ? t('TV') : t('Movies')}</Descriptions.Item>
+        <Descriptions.Item label="TMDB ID">{String(detail?.tmdb?.id || '')}</Descriptions.Item>
+        {origin && <Descriptions.Item label={t('Original Title')}>{String(origin)}</Descriptions.Item>}
+        {release && <Descriptions.Item label={t('Release Date')}>{String(release)}</Descriptions.Item>}
+        {status && <Descriptions.Item label={t('Status')}>{String(status)}</Descriptions.Item>}
+        {runtime && <Descriptions.Item label={t('Runtime')}>{String(runtime)} min</Descriptions.Item>}
+        {language && <Descriptions.Item label={t('Language')}>{String(language).toUpperCase()}</Descriptions.Item>}
+        {isTv && seasons !== undefined && <Descriptions.Item label={t('Seasons')}>{String(seasons)}</Descriptions.Item>}
+        {isTv && eps !== undefined && <Descriptions.Item label={t('Episodes')}>{String(eps)}</Descriptions.Item>}
+        {detail?.source_path && <Descriptions.Item label={t('Source Path')} span={2}>{String(detail.source_path)}</Descriptions.Item>}
+      </Descriptions>
+    );
+  };
+
+  const renderCast = () => {
+    if (!castTop.length) return null;
+    return (
+      <div style={{ marginTop: 14 }}>
+        <Typography.Title level={5} style={{ margin: 0 }}>
+          {t('Cast')}
+        </Typography.Title>
+        <div style={{ marginTop: 10, display: 'flex', flexWrap: 'wrap', gap: 10 }}>
+          {castTop.map((c: any) => {
+            const avatar = tmdbImage(c?.profile_path, 'w185');
+            return (
+              <div
+                key={String(c?.id || `${c?.name}-${c?.character}`)}
+                style={{
+                  display: 'flex',
+                  alignItems: 'center',
+                  gap: 10,
+                  padding: '8px 10px',
+                  borderRadius: 12,
+                  background: token.colorFillQuaternary,
+                  border: `1px solid ${token.colorBorderSecondary}`,
+                  minWidth: 200,
+                }}
+              >
+                <Avatar size={36} src={avatar} style={{ flex: 'none' }}>
+                  {(c?.name || '?').slice(0, 1)}
+                </Avatar>
+                <div style={{ minWidth: 0 }}>
+                  <Typography.Text strong ellipsis style={{ display: 'block', maxWidth: 140 }}>
+                    {c?.name || '--'}
+                  </Typography.Text>
+                  <Typography.Text type="secondary" style={{ fontSize: 12 }} ellipsis>
+                    {c?.character || ''}
+                  </Typography.Text>
+                </div>
+              </div>
+            );
+          })}
+        </div>
+      </div>
+    );
+  };
+
+  const renderEpisodes = () => {
+    if (detail?.type !== 'tv') return null;
+    if (!episodesBySeason.length) {
+      return (
+        <Empty description={t('No data')} style={{ marginTop: 24 }} />
+      );
+    }
+
+    return (
+      <Collapse
+        accordion={false}
+        items={episodesBySeason.map(({ season, episodes }) => ({
+          key: String(season),
+          label: `${t('Season')} ${season} · ${episodes.length} ${t('Episodes')}`,
+          children: (
+            <List
+              itemLayout="horizontal"
+              dataSource={episodes}
+              renderItem={(ep: any) => {
+                const seasonNo = typeof ep?.season === 'number' ? ep.season : season;
+                const epNo = typeof ep?.episode === 'number' ? ep.episode : undefined;
+                const tmdbEp = ep?.tmdb_episode || {};
+                const still = tmdbImage(tmdbEp?.still_path, 'w300');
+                const title = tmdbEp?.name || ep?.name || ep?.rel || '--';
+                const air = tmdbEp?.air_date ? String(tmdbEp.air_date) : '';
+                const runtime = tmdbEp?.runtime ? `${tmdbEp.runtime} min` : '';
+                const sub = [air, runtime].filter(Boolean).join(' · ');
+                const prefix = epNo !== undefined ? `S${String(seasonNo).padStart(2, '0')}E${String(epNo).padStart(2, '0')}` : `S${String(seasonNo).padStart(2, '0')}`;
+
+                return (
+                  <List.Item
+                    style={{ paddingInline: 0 }}
+                    actions={[
+                      <Button
+                        key="play"
+                        type="primary"
+                        icon={<PlayCircleOutlined />}
+                        onClick={() => playByPath(String(ep?.path || ''))}
+                        disabled={!ep?.path}
+                      >
+                        {t('Play')}
+                      </Button>,
+                    ]}
+                  >
+                    <List.Item.Meta
+                      avatar={still ? (
+                        <Image
+                          src={still}
+                          preview={false}
+                          width={120}
+                          height={68}
+                          style={{ objectFit: 'cover', borderRadius: 10, overflow: 'hidden' }}
+                          fallback="/logo.svg"
+                        />
+                      ) : (
+                        <div
+                          style={{
+                            width: 120,
+                            height: 68,
+                            borderRadius: 10,
+                            background: token.colorFillQuaternary,
+                            display: 'flex',
+                            alignItems: 'center',
+                            justifyContent: 'center',
+                            color: token.colorTextTertiary,
+                          }}
+                        >
+                          <VideoCameraOutlined />
+                        </div>
+                      )}
+                      title={(
+                        <div style={{ display: 'flex', alignItems: 'center', gap: 10 }}>
+                          <Tag style={{ marginInlineEnd: 0 }}>{prefix}</Tag>
+                          <Typography.Text strong ellipsis style={{ display: 'block', maxWidth: 360 }}>
+                            {title}
+                          </Typography.Text>
+                        </div>
+                      )}
+                      description={sub ? <Typography.Text type="secondary">{sub}</Typography.Text> : null}
+                    />
+                  </List.Item>
+                );
+              }}
+            />
+          ),
+        }))}
+      />
+    );
+  };
+
+  return (
+    <div style={{ height: '100%', display: 'flex', flexDirection: 'column', background: token.colorBgLayout }}>
+      <div
+        style={{
+          padding: 14,
+          borderRadius: 12,
+          background: token.colorBgContainer,
+          border: `1px solid ${token.colorBorderSecondary}`,
+        }}
+      >
+        <Flex align="center" justify="space-between" gap={12} wrap>
+          <div style={{ minWidth: 240 }}>
+            <Typography.Title level={4} style={{ margin: 0 }}>
+              {t('Video Library')}
+            </Typography.Title>
+            <Typography.Text type="secondary">
+              {t('Total')}: {stats.total} · {t('Movies')}: {stats.movie} · {t('TV')}: {stats.tv}
+            </Typography.Text>
+          </div>
+          <Space size={10} wrap>
+            <Segmented
+              value={filter}
+              onChange={(v) => setFilter(v as LibraryFilter)}
+              options={[
+                { value: 'all', label: t('All') },
+                { value: 'movie', label: t('Movies') },
+                { value: 'tv', label: t('TV') },
+              ]}
+            />
+            <Input
+              allowClear
+              value={q}
+              onChange={(e) => setQ(e.target.value)}
+              prefix={<SearchOutlined />}
+              placeholder={t('Search')}
+              style={{ width: 260 }}
+            />
+            <Button icon={<ReloadOutlined />} onClick={loadLibrary} loading={loading}>
+              {t('Refresh')}
+            </Button>
+          </Space>
+        </Flex>
+      </div>
+
+      <div style={{ flex: 1, minHeight: 0, overflow: 'auto', padding: '12px 2px' }}>
+        {loading ? (
+          <div style={{ display: 'grid', gridTemplateColumns: 'repeat(auto-fill, minmax(210px, 1fr))', gap: 12 }}>
+            {Array.from({ length: 10 }).map((_, idx) => (
+	              <Card
+	                key={idx}
+	                size="small"
+	                style={{ borderRadius: 12, overflow: 'hidden' }}
+	                cover={(
+	                  <div style={{ width: '100%', aspectRatio: '2 / 3' }}>
+	                    <Skeleton.Image active style={{ width: '100%', height: '100%' }} />
+	                  </div>
+	                )}
+	              >
+	                <Skeleton active paragraph={{ rows: 2 }} />
+	              </Card>
+            ))}
+          </div>
+        ) : filtered.length === 0 ? (
+          <Empty description={t('No data')} style={{ marginTop: 48 }} />
+        ) : (
+          <div style={{ display: 'grid', gridTemplateColumns: 'repeat(auto-fill, minmax(210px, 1fr))', gap: 12 }}>
+            {filtered.map((v) => (
+              <Card
+                key={v.id}
+                hoverable
+                size="small"
+                styles={{ body: { padding: 10 } } as any}
+                style={{
+                  borderRadius: 12,
+                  overflow: 'hidden',
+                  boxShadow: token.boxShadowTertiary,
+                  border: `1px solid ${token.colorBorderSecondary}`,
+                }}
+                cover={renderCover(v)}
+                onClick={() => openDetail(v)}
+              >
+                <Typography.Text strong ellipsis style={{ display: 'block' }}>
+                  {v.title || '--'}
+                </Typography.Text>
+                <div style={{ marginTop: 6, display: 'flex', gap: 8, color: token.colorTextTertiary, fontSize: 12 }}>
+                  <span>{v.year || '--'}</span>
+                  {v.type === 'tv' ? (
+                    <>
+                      <span>·</span>
+                      <span>{v.episodes_count || 0} {t('Episodes')}</span>
+                    </>
+                  ) : null}
+                </div>
+                <div style={{ marginTop: 8, display: 'flex', flexWrap: 'wrap', gap: 6 }}>
+                  {(v.genres || []).slice(0, 3).map((tag) => (
+                    <Tag key={tag} style={{ marginInlineEnd: 0 }}>
+                      {tag}
+                    </Tag>
+                  ))}
+                  {(v.genres || []).length > 3 && (
+                    <Tag style={{ marginInlineEnd: 0 }}>+{(v.genres || []).length - 3}</Tag>
+                  )}
+                </div>
+              </Card>
+            ))}
+          </div>
+        )}
+      </div>
+
+      <Drawer
+        title={detailTitle || selected?.title || t('Details')}
+        open={detailOpen}
+        onClose={closeDetail}
+        width="100%"
+        destroyOnHidden
+        getContainer={false}
+        styles={{ body: { padding: 0 } }}
+      >
+        {detailLoading ? (
+          <div style={{ padding: 16 }}>
+            <Skeleton active paragraph={{ rows: 10 }} />
+          </div>
+        ) : !detail ? (
+          <Empty description={t('No data')} style={{ marginTop: 48 }} />
+        ) : (
+          <div style={{ display: 'flex', flexDirection: 'column' }}>
+            {renderHero()}
+            <div style={{ padding: 16 }}>
+              <Tabs
+                items={[
+                  ...(detail?.type === 'tv'
+                    ? [{
+                      key: 'episodes',
+                      label: t('Episodes'),
+                      children: renderEpisodes(),
+                    }]
+                    : []),
+                  {
+                    key: 'detail',
+                    label: t('Details'),
+                    children: (
+                      <>
+                        {renderMeta()}
+                        {detailOverview && (
+                          <>
+                            <Divider style={{ margin: '14px 0' }} />
+                            <Typography.Title level={5} style={{ margin: 0 }}>
+                              {t('Overview')}
+                            </Typography.Title>
+                            <Typography.Paragraph style={{ marginTop: 8, whiteSpace: 'pre-wrap' }}>
+                              {detailOverview}
+                            </Typography.Paragraph>
+                          </>
+                        )}
+                        {renderCast()}
+                      </>
+                    ),
+                  },
+                ]}
+              />
+            </div>
+          </div>
+        )}
+      </Drawer>
+    </div>
+  );
+};

web/src/apps/VideoPlayer/index.ts

@@ -1,14 +1,21 @@
 import type { AppDescriptor } from '../types';
 import { VideoPlayerApp } from './VideoPlayer.tsx';
+import { VideoLibraryApp } from './VideoLibrary.tsx';
+
+const supportedExts = ['mp4','webm','ogg','m4v','mov','mkv','avi','wmv','flv','3gp'];
 
 export const descriptor: AppDescriptor = {
   key: 'video-player',
   name: '视频播放器',
   iconUrl: 'https://api.iconify.design/mdi:video.svg',
+  description: '内置视频播放器，支持常见视频格式播放。',
+  author: 'Foxel',
+  openAppComponent: VideoLibraryApp,
+  supportedExts,
   supported: (entry) => {
     if (entry.is_dir) return false;
     const ext = entry.name.split('.').pop()?.toLowerCase() || '';
-    return ['mp4','webm','ogg','m4v','mov','mkv','avi','wmv','flv','3gp'].includes(ext);
+    return supportedExts.includes(ext);
   },
   component: VideoPlayerApp,
   default: true,

web/src/apps/registry.ts

@@ -2,7 +2,7 @@ import type { VfsEntry } from '../api/client';
 import type { AppDescriptor } from './types';
 import React from 'react';
 import { pluginsApi, type PluginItem } from '../api/plugins';
-import { PluginAppHost } from './PluginHost';
+import { PluginAppHost, PluginAppOpenHost } from './PluginHost';
 const apps: AppDescriptor[] = [];
 
 // 使用 import.meta.glob 动态导入所有应用
@@ -21,8 +21,7 @@ async function loadApps() {
   try {
     const items = await pluginsApi.list();
     items.filter(p => p.enabled !== false).forEach((p) => registerPluginAsApp(p));
-  } catch (e) {
-  }
+  } catch { void 0; }
 }
 
 function registerPluginAsApp(p: PluginItem) {
@@ -39,6 +38,7 @@ function registerPluginAsApp(p: PluginItem) {
     name: p.name || `插件 ${p.id}`,
     supported,
     component: (props: any) => React.createElement(PluginAppHost, { plugin: p, ...props }),
+    openAppComponent: p.open_app ? ((props: any) => React.createElement(PluginAppOpenHost, { plugin: p, ...props })) : undefined,
     iconUrl: p.icon || undefined,
     default: false,
     defaultBounds: p.default_bounds || undefined,
@@ -46,7 +46,15 @@ function registerPluginAsApp(p: PluginItem) {
   });
 }
 
-loadApps();
+const appsLoadedPromise = loadApps();
+
+export async function ensureAppsLoaded() {
+  await appsLoadedPromise;
+}
+
+export function listSystemApps(): AppDescriptor[] {
+  return apps.filter(a => !a.key.startsWith('plugin:'));
+}
 
 export function getAppsForEntry(entry: VfsEntry): AppDescriptor[] {
   return apps.filter(a => a.supported(entry));
@@ -90,7 +98,10 @@ export async function reloadPluginApps() {
         existing.defaultBounds = p.default_bounds || undefined;
         existing.defaultMaximized = p.default_maximized || undefined;
         existing.iconUrl = p.icon || existing.iconUrl;
+        existing.openAppComponent = p.open_app
+          ? ((props: any) => React.createElement(PluginAppOpenHost, { plugin: p, ...props }))
+          : undefined;
       }
     });
-  } catch { }
+  } catch { void 0; }
 }

web/src/apps/types.ts

@@ -6,14 +6,28 @@ export interface AppComponentProps {
   onRequestClose: () => void;
 }
 
+export interface AppOpenComponentProps {
+  onRequestClose: () => void;
+}
+
 export interface AppDescriptor {
   key: string;
   name: string;
   supported: (entry: VfsEntry) => boolean;
   component: React.ComponentType<AppComponentProps>;
+  /**
+   * 独立打开应用（不依赖文件）
+   * 缺省表示该应用仅支持“通过文件打开”。
+   */
+  openAppComponent?: React.ComponentType<AppOpenComponentProps>;
   iconUrl?: string;
   default?: boolean;
   defaultMaximized?: boolean;
+  description?: string;
+  author?: string;
+  supportedExts?: string[];
+  website?: string;
+  github?: string;
   /**
    * 应用窗口的默认位置与尺寸（非最大化时生效）
    * 任意字段缺省则按系统默认/级联偏移。

web/src/contexts/AppWindowsContext.tsx

@@ -5,28 +5,39 @@ import type { AppDescriptor } from '../apps/registry';
 import { getAppsForEntry, getDefaultAppForEntry, getAppByKey } from '../apps/registry';
 import { useI18n } from '../i18n';
 
-export interface AppWindowItem {
+type WindowBase = {
   id: string;
   app: AppDescriptor;
-  entry: VfsEntry;
-  filePath: string;
   maximized: boolean;
   minimized: boolean;
   x: number;
   y: number;
   width: number;
   height: number;
-}
+};
+
+export type AppWindowItem =
+  | (WindowBase & {
+    kind: 'file';
+    entry: VfsEntry;
+    filePath: string;
+  })
+  | (WindowBase & {
+    kind: 'app';
+  });
+
+type AppWindowPatch = Partial<Pick<AppWindowItem, 'maximized' | 'minimized' | 'x' | 'y' | 'width' | 'height'>>;
 
 interface AppWindowsContextValue {
   windows: AppWindowItem[];
   openWithApp: (entry: VfsEntry, app: AppDescriptor, currentPath: string) => void;
   openFileWithDefaultApp: (entry: VfsEntry, currentPath: string) => void;
   confirmOpenWithApp: (entry: VfsEntry, appKey: string, currentPath: string) => void;
+  openApp: (app: AppDescriptor) => void;
   closeWindow: (id: string) => void;
   toggleMax: (id: string) => void;
   bringToFront: (id: string) => void;
-  updateWindow: (id: string, patch: Partial<Omit<AppWindowItem, 'id' | 'app' | 'entry' | 'filePath'>>) => void;
+  updateWindow: (id: string, patch: AppWindowPatch) => void;
   minimizeWindow: (id: string) => void;
   restoreWindow: (id: string) => void;
   toggleMinimize: (id: string) => void;
@@ -52,11 +63,12 @@ export const AppWindowsProvider: React.FC<{ children: React.ReactNode }> = ({ ch
       const finalW = Math.min(baseW, vw - 40);
       const finalH = Math.min(baseH, vh - 60);
       const finalX = Math.min(Math.max(0, baseX), vw - finalW - 8);
-      const finalY = Math.min(Math.max(48, baseY), vh - finalH - 8);
+      const finalY = Math.min(Math.max(0, baseY), vh - finalH - 8);
       return [
         ...ws,
         {
           id: Date.now().toString(36) + Math.random().toString(36).slice(2),
+          kind: 'file',
           app,
           entry,
           filePath: fullPath,
@@ -71,6 +83,40 @@ export const AppWindowsProvider: React.FC<{ children: React.ReactNode }> = ({ ch
     });
   }, []);
 
+  const openApp = useCallback((app: AppDescriptor) => {
+    if (!app.openAppComponent) {
+      return;
+    }
+    setWindows(ws => {
+      const idx = ws.length;
+      const bounds = app.defaultBounds || {};
+      const baseX = bounds.x ?? (160 + idx * 32);
+      const baseY = bounds.y ?? (100 + idx * 28);
+      const baseW = bounds.width ?? 640;
+      const baseH = bounds.height ?? 480;
+      const vw = window.innerWidth;
+      const vh = window.innerHeight;
+      const finalW = Math.min(baseW, vw - 40);
+      const finalH = Math.min(baseH, vh - 60);
+      const finalX = Math.min(Math.max(0, baseX), vw - finalW - 8);
+      const finalY = Math.min(Math.max(0, baseY), vh - finalH - 8);
+      return [
+        ...ws,
+        {
+          id: Date.now().toString(36) + Math.random().toString(36).slice(2),
+          kind: 'app',
+          app,
+          maximized: !!app.defaultMaximized,
+          minimized: false,
+          x: finalX,
+          y: finalY,
+          width: finalW,
+          height: finalH,
+        },
+      ];
+    });
+  }, []);
+
   const openFileWithDefaultApp = useCallback((entry: VfsEntry, currentPath: string) => {
     const apps = getAppsForEntry(entry);
     if (!apps.length) {
@@ -115,10 +161,8 @@ export const AppWindowsProvider: React.FC<{ children: React.ReactNode }> = ({ ch
     if (!target) return ws;
     return [...ws.filter(w => w.id !== id), target];
   });
-  const updateWindow = (
-    id: string,
-    patch: Partial<Omit<AppWindowItem, 'id' | 'app' | 'entry' | 'filePath'>>,
-  ) => setWindows(ws => ws.map(w => (w.id === id ? { ...w, ...patch } : w)));
+  const updateWindow = (id: string, patch: AppWindowPatch) =>
+    setWindows(ws => ws.map(w => (w.id === id ? { ...w, ...patch } : w)));
 
   const minimizeWindow = (id: string) => setWindows(ws => ws.map(w => (w.id === id ? { ...w, minimized: true } : w)));
   const restoreWindow = (id: string) => setWindows(ws => {
@@ -134,6 +178,7 @@ export const AppWindowsProvider: React.FC<{ children: React.ReactNode }> = ({ ch
     openWithApp,
     openFileWithDefaultApp,
     confirmOpenWithApp,
+    openApp,
     closeWindow,
     toggleMax,
     bringToFront,
@@ -141,7 +186,7 @@ export const AppWindowsProvider: React.FC<{ children: React.ReactNode }> = ({ ch
     minimizeWindow,
     restoreWindow,
     toggleMinimize,
-  }), [windows, openWithApp, openFileWithDefaultApp, confirmOpenWithApp]);
+  }), [windows, openWithApp, openFileWithDefaultApp, confirmOpenWithApp, openApp]);
 
   return <AppWindowsContext.Provider value={value}>{children}</AppWindowsContext.Provider>;
 };
@@ -151,4 +196,3 @@ export function useAppWindows() {
   if (!ctx) throw new Error('useAppWindows must be used within AppWindowsProvider');
   return ctx;
 }
-

web/src/contexts/AuthContext.tsx

@@ -27,7 +27,7 @@ export function AuthProvider({ children }: { children: React.ReactNode }) {
         const res = await authApi.login({ username, password });
         if (res) {
             setToken(res.access_token);
-            try { await refreshUser(); } catch (_) {}
+            try { await refreshUser(); } catch { void 0; }
         }
     };
 
@@ -52,7 +52,6 @@ export function AuthProvider({ children }: { children: React.ReactNode }) {
         } else {
             setUser(null);
         }
-        // eslint-disable-next-line react-hooks/exhaustive-deps
     }, [token]);
 
     return (

web/src/contexts/ThemeContext.tsx

@@ -1,4 +1,4 @@
-import React, { createContext, useContext, useEffect, useMemo, useRef, useState } from 'react';
+import React, { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState } from 'react';
 import { ConfigProvider, theme as antdTheme } from 'antd';
 import zhCN from 'antd/locale/zh_CN';
 import enUS from 'antd/locale/en_US';
@@ -85,15 +85,22 @@ function buildThemeConfig(state: ThemeState, systemDark: boolean): ThemeConfig {
   const baseComponents = { ...(baseTheme.components as any) };
   if (resolvedMode === 'dark' && baseComponents) {
     if (baseComponents.Menu) {
-      const { itemHoverColor, itemHoverBg, itemSelectedBg, itemSelectedColor, ...rest } = baseComponents.Menu;
+      const rest = { ...baseComponents.Menu };
+      delete rest.itemHoverColor;
+      delete rest.itemHoverBg;
+      delete rest.itemSelectedBg;
+      delete rest.itemSelectedColor;
       baseComponents.Menu = rest;
     }
     if (baseComponents.Dropdown) {
-      const { controlItemBgHover, ...rest } = baseComponents.Dropdown;
+      const rest = { ...baseComponents.Dropdown };
+      delete rest.controlItemBgHover;
       baseComponents.Dropdown = rest;
     }
     if (baseComponents.Table) {
-      const { headerBg, rowHoverBg, ...rest } = baseComponents.Table;
+      const rest = { ...baseComponents.Table };
+      delete rest.headerBg;
+      delete rest.rowHoverBg;
       baseComponents.Table = rest;
     }
   }
@@ -106,9 +113,14 @@ export function ThemeProvider({ children }: { children: React.ReactNode }) {
   const { lang } = useI18n();
   const systemDark = useSystemDarkPreferred();
   const [state, setState] = useState<ThemeState>({ mode: 'light' });
+  const stateRef = useRef(state);
   const styleTagRef = useRef<HTMLStyleElement | null>(null);
 
-  const ensureStyleTag = () => {
+  useEffect(() => {
+    stateRef.current = state;
+  }, [state]);
+
+  const ensureStyleTag = useCallback(() => {
     if (styleTagRef.current) return styleTagRef.current;
     let styleEl = document.getElementById('foxel-custom-css') as HTMLStyleElement | null;
     if (!styleEl) {
@@ -118,22 +130,22 @@ export function ThemeProvider({ children }: { children: React.ReactNode }) {
     }
     styleTagRef.current = styleEl;
     return styleEl;
-  };
+  }, []);
 
-  const applyCustomCSS = (cssText: string | null | undefined) => {
+  const applyCustomCSS = useCallback((cssText: string | null | undefined) => {
     const el = ensureStyleTag();
     el.textContent = cssText || '';
-  };
+  }, [ensureStyleTag]);
 
-  const applyHtmlDataTheme = (mode: ThemeMode) => {
+  const applyHtmlDataTheme = useCallback((mode: ThemeMode) => {
     const finalMode = mode === 'system' ? (systemDark ? 'dark' : 'light') : mode;
     document.documentElement.setAttribute('data-theme', finalMode);
-  };
+  }, [systemDark]);
 
-  const refreshTheme = async () => {
+  const refreshTheme = useCallback(async () => {
     if (!isAuthenticated) {
-      applyHtmlDataTheme(state.mode || 'light');
-      applyCustomCSS(state.customCSS || '');
+      applyHtmlDataTheme(stateRef.current.mode || 'light');
+      applyCustomCSS(stateRef.current.customCSS || '');
       return;
     }
     try {
@@ -147,22 +159,23 @@ export function ThemeProvider({ children }: { children: React.ReactNode }) {
       setState({ mode, primaryColor: primary, borderRadius: radius, customTokens, customCSS });
       applyHtmlDataTheme(mode);
       applyCustomCSS(customCSS);
-    } catch (e) {
+    } catch {
       applyHtmlDataTheme('light');
       applyCustomCSS('');
     }
-  };
+  }, [applyCustomCSS, applyHtmlDataTheme, isAuthenticated]);
 
-  const previewTheme = (patch: Partial<ThemeState>) => {
-    const next: ThemeState = { ...state, ...patch };
+  const previewTheme = useCallback((patch: Partial<ThemeState>) => {
+    const next: ThemeState = { ...stateRef.current, ...patch };
+    stateRef.current = next;
     setState(next);
     applyHtmlDataTheme(next.mode || 'light');
     applyCustomCSS(next.customCSS || '');
-  };
+  }, [applyCustomCSS, applyHtmlDataTheme]);
 
   useEffect(() => {
-    refreshTheme();
-  }, [isAuthenticated, systemDark]);
+    void refreshTheme();
+  }, [refreshTheme]);
 
   const themeConfig = useMemo(() => buildThemeConfig(state, systemDark), [state, systemDark]);
   const resolvedMode: ThemeMode = useMemo(() => (state.mode === 'system' ? (systemDark ? 'dark' : 'light') : state.mode), [state.mode, systemDark]);
@@ -173,7 +186,7 @@ export function ThemeProvider({ children }: { children: React.ReactNode }) {
     previewTheme,
     mode: state.mode,
     resolvedMode,
-  }), [state.mode, resolvedMode]);
+  }), [previewTheme, refreshTheme, resolvedMode, state.mode]);
 
   return (
     <Ctx.Provider value={ctxValue}>

web/src/global.css

@@ -66,3 +66,28 @@ body { font-family: system-ui,-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto
 .processors-tabs .ant-tabs-tabpane-active {
   display: flex;
 }
+
+.plugins-tabs {
+  flex: 1;
+  display: flex;
+  flex-direction: column;
+  min-height: 0;
+}
+.plugins-tabs .ant-tabs-content-holder,
+.plugins-tabs .ant-tabs-content {
+  flex: 1;
+  height: 100%;
+  min-height: 0;
+  display: flex;
+  flex-direction: column;
+}
+.plugins-tabs .ant-tabs-tabpane {
+  flex: 1;
+  height: 100%;
+  min-height: 0;
+  display: none;
+  flex-direction: column;
+}
+.plugins-tabs .ant-tabs-tabpane-active {
+  display: flex;
+}

web/src/hooks/useAsyncSafeEffect.ts

@@ -30,6 +30,5 @@ export function useAsyncSafeEffect(
         ac.abort();
       }
     };
-  }, deps);
+  }, deps); // eslint-disable-line react-hooks/exhaustive-deps
 }
-

web/src/i18n/index.tsx

@@ -1,4 +1,4 @@
-import { createContext, useContext, useMemo, useState, useEffect } from 'react';
+import { createContext, useCallback, useContext, useMemo, useState, useEffect } from 'react';
 import type { PropsWithChildren } from 'react';
 import en from './locales/en.json';
 import zhOverrides from './locales/zh.json';
@@ -27,22 +27,22 @@ function interpolate(template: string, params?: Record<string, string | number>)
 export function I18nProvider({ children }: PropsWithChildren) {
   const [lang, setLangState] = useState<Lang>(() => (localStorage.getItem('lang') as Lang) || 'zh');
 
-  const setLang = (l: Lang) => {
+  const setLang = useCallback((l: Lang) => {
     setLangState(l);
     localStorage.setItem('lang', l);
-  };
+  }, []);
 
   useEffect(() => {
     document.documentElement.lang = lang;
   }, [lang]);
 
-  const t = (key: string, params?: Record<string, string | number>) => {
+  const t = useCallback((key: string, params?: Record<string, string | number>) => {
     const dict = dicts[lang] || {};
     const raw = dict[key] ?? key; // fallback to key (English)
     return interpolate(raw, params);
-  };
+  }, [lang]);
 
-  const value = useMemo<I18nContextValue>(() => ({ lang, setLang, t }), [lang]);
+  const value = useMemo<I18nContextValue>(() => ({ lang, setLang, t }), [lang, setLang, t]);
 
   return (
     <I18nContext.Provider value={value}>

web/src/i18n/locales/en.json

@@ -319,6 +319,7 @@
   "File Domain": "File Domain",
   "Configure Access Key and Secret to enable S3 mapping.": "Configure Access Key and Secret to enable S3 mapping.",
   "Mount point inside the virtual file system (e.g. / or /workspace).": "Mount point inside the virtual file system (e.g. / or /workspace).",
+  "Leave blank to accept any region.": "Leave blank to accept any region.",
   "Please input bucket name": "Please input bucket name",
   "Please input region": "Please input region",
   "Please input access key": "Please input access key",
@@ -498,6 +499,7 @@
   "/ or /drive": "/ or /drive",
   "Adapter Config": "Adapter Config",
   "adapter.type.local": "Local Filesystem",
+  "adapter.type.dropbox": "Dropbox",
   "adapter.type.webdav": "WebDAV",
   "adapter.type.googledrive": "Google Drive",
   "adapter.type.onedrive": "OneDrive",
@@ -506,6 +508,8 @@
   "adapter.type.sftp": "SFTP",
   "adapter.type.telegram": "Telegram",
   "adapter.type.quark": "Quark Drive",
+  "adapter.type.alist": "AList",
+  "adapter.type.openlist": "OpenList",
   "Automation Tasks": "Automation Tasks",
   "Create Task": "Create Task",
   "Edit Task": "Edit Task",
@@ -601,9 +605,12 @@
   "Please select a file": "Please select a file",
   "Installed successfully": "Installed successfully",
   "Plugin": "Plugin",
+  "System App": "System App",
   "Open Link": "Open Link",
   "Link copied": "Link copied",
   "Copy Link": "Copy Link",
+  "Open App": "Open App",
+  "Update App": "Update App",
   "Confirm delete this plugin?": "Confirm delete this plugin?",
   "Author": "Author",
   "Website": "Website",
@@ -659,4 +666,4 @@
   "Open with {app}": "Open with {app}",
   "Set as default for .{ext}": "Set as default for .{ext}",
   "Advanced tokens must be valid JSON": "Advanced tokens must be valid JSON"
-}
+}

web/src/i18n/locales/zh.json

@@ -338,6 +338,7 @@
   "File Domain": "文件域名",
   "Configure Access Key and Secret to enable S3 mapping.": "配置 Access Key 与 Secret 后才能启用 S3 映射。",
   "Mount point inside the virtual file system (e.g. / or /workspace).": "虚拟文件系统中的挂载路径，例如 / 或 /workspace。",
+  "Leave blank to accept any region.": "留空表示接受任意 Region。",
   "Please input bucket name": "请输入 Bucket 名",
   "Please input region": "请输入 Region",
   "Please input access key": "请输入 Access Key",
@@ -486,7 +487,10 @@
   "/ or /drive": "/或/drive",
   "Adapter Config": "适配器配置",
   "adapter.type.local": "本地文件系统",
+  "adapter.type.dropbox": "Dropbox",
   "adapter.type.quark": "夸克网盘",
+  "adapter.type.alist": "AList",
+  "adapter.type.openlist": "OpenList",
   "Automation Tasks": "自动化任务",
   "Running Tasks": "运行中的任务",
   "Create Task": "新建任务",
@@ -594,9 +598,12 @@
   "Please select a file": "请选择一个文件",
   "Installed successfully": "安装成功",
   "Plugin": "插件",
+  "System App": "系统应用",
   "Open Link": "打开链接",
   "Link copied": "已复制链接",
   "Copy Link": "复制链接",
+  "Open App": "打开应用",
+  "Update App": "更新应用",
   "Confirm delete this plugin?": "确认删除该插件？",
   "Author": "作者",
   "Website": "官网",
@@ -652,4 +659,4 @@
   "Open with {app}": "使用 {app} 打开",
   "Set as default for .{ext}": "设为该类型(.{ext})默认应用",
   "Advanced tokens must be valid JSON": "高级 Token 需为合法 JSON"
-}
+}

web/src/layout/SearchDialog.tsx

@@ -302,7 +302,7 @@ const SearchDialog: React.FC<SearchDialogProps> = ({ open, onClose }) => {
       } else {
         setHasMore(false);
       }
-    } catch (e) {
+    } catch {
       if (requestId !== requestIdRef.current) {
         return;
       }

web/src/layout/SideNav.tsx

@@ -166,7 +166,7 @@ const SideNav = memo(function SideNav({ collapsed, activeKey, onChange, onToggle
           }}
         >
           {/* 最小化应用 Dock */}
-          {minimized.length > 0 && (
+          {!collapsed && minimized.length > 0 && (
             <div
               style={{
                 width: '100%',
@@ -180,14 +180,15 @@ const SideNav = memo(function SideNav({ collapsed, activeKey, onChange, onToggle
                 overflowY: collapsed ? 'auto' : 'visible',
               }}
             >
-              {minimized.map(w => {
-                const src = w.app.iconUrl || DEFAULT_APP_ICON;
-                return (
-                  <Tooltip key={w.id} title={`${w.app.name} - ${w.entry.name}`} placement={collapsed ? 'right' : 'top'}>
-                    <Button
-                      shape="circle"
-                      onClick={() => restoreWindow(w.id)}
-                      icon={<img src={src} alt={w.app.name} style={{ width: 16, height: 16 }} />}
+	              {minimized.map(w => {
+	                const src = w.app.iconUrl || DEFAULT_APP_ICON;
+	                const title = w.kind === 'file' ? `${w.app.name} - ${w.entry.name}` : w.app.name;
+	                return (
+	                  <Tooltip key={w.id} title={title} placement={collapsed ? 'right' : 'top'}>
+	                    <Button
+	                      shape="circle"
+	                      onClick={() => restoreWindow(w.id)}
+	                      icon={<img src={src} alt={w.app.name} style={{ width: 16, height: 16 }} />}
                     />
                   </Tooltip>
                 );
@@ -224,7 +225,7 @@ const SideNav = memo(function SideNav({ collapsed, activeKey, onChange, onToggle
                     <Tag icon={<CheckCircleOutlined />} color="success" style={{ marginInlineEnd: 0 }} />
                   ) : (
                     <Tag icon={<CheckCircleOutlined />} color="success">
-                      {t('Up to date')}
+                      {status?.version}
                     </Tag>
                   )}
                 </Tooltip>
@@ -233,31 +234,33 @@ const SideNav = memo(function SideNav({ collapsed, activeKey, onChange, onToggle
               )
             )}
           </div>
-          <div style={{ display: 'flex', flexDirection: collapsed ? 'column' : 'row', gap: 8 }}>
-            <Button
-              shape="circle"
-              icon={<GithubOutlined />}
-              href="https://github.com/DrizzleTime/Foxel"
-              target="_blank"
-            />
-            <Button
-              shape="circle"
-              icon={<WechatOutlined />}
-              onClick={() => setIsModalOpen(true)}
-            />
-            <Button
-              shape="circle"
-              icon={<SendOutlined />}
-              href="https://t.me/+thDsBfyqJxZkNTU1"
-              target="_blank"
-            />
-            <Button
-              shape="circle"
-              icon={<FileTextOutlined />}
-              href="https://foxel.cc"
-              target="_blank"
-            />
-          </div>
+          {!collapsed && (
+            <div style={{ display: 'flex', flexDirection: 'row', gap: 8 }}>
+              <Button
+                shape="circle"
+                icon={<GithubOutlined />}
+                href="https://github.com/DrizzleTime/Foxel"
+                target="_blank"
+              />
+              <Button
+                shape="circle"
+                icon={<WechatOutlined />}
+                onClick={() => setIsModalOpen(true)}
+              />
+              <Button
+                shape="circle"
+                icon={<SendOutlined />}
+                href="https://t.me/+thDsBfyqJxZkNTU1"
+                target="_blank"
+              />
+              <Button
+                shape="circle"
+                icon={<FileTextOutlined />}
+                href="https://foxel.cc"
+                target="_blank"
+              />
+            </div>
+          )}
 
         </div>
       </Sider>

web/src/pages/AdaptersPage.tsx

@@ -27,7 +27,7 @@ const AdaptersPage = memo(function AdaptersPage() {
     } finally {
       setLoading(false);
     }
-  }, []);
+  }, [t]);
 
   useEffect(() => { fetchList(); }, [fetchList]);
 

web/src/pages/AuditLogsPage.tsx

@@ -47,28 +47,24 @@ const AuditLogsPage = memo(function AuditLogsPage() {
   const [selectedLog, setSelectedLog] = useState<AuditLogItem | null>(null);
   const { t } = useI18n();
 
-  const buildParams = () => {
-    const params: any = { ...filters };
-    if (!params.action) delete params.action;
-    if (params.success === '') delete params.success;
-    if (!params.username) delete params.username;
-    if (!params.path) delete params.path;
-    if (!params.start_time) delete params.start_time;
-    if (!params.end_time) delete params.end_time;
-    return params;
-  };
-
   const fetchList = useCallback(async () => {
     setLoading(true);
     try {
-      const res = await auditApi.list(buildParams());
+      const params: any = { ...filters };
+      if (!params.action) delete params.action;
+      if (params.success === '') delete params.success;
+      if (!params.username) delete params.username;
+      if (!params.path) delete params.path;
+      if (!params.start_time) delete params.start_time;
+      if (!params.end_time) delete params.end_time;
+      const res = await auditApi.list(params);
       setData(res);
     } catch (e: any) {
       message.error(e.message || t('Load failed'));
     } finally {
       setLoading(false);
     }
-  }, [filters]);
+  }, [filters, t]);
 
   useEffect(() => {
     fetchList();

web/src/pages/FileExplorerPage/components/ContextMenu.tsx

@@ -81,25 +81,35 @@ export const ContextMenu: React.FC<ContextMenuProps> = (props) => {
     const targetEntries = entries.filter(e => targetNames.includes(e.name));
 
     let processorSubMenu: ActionMenuItem[] = [];
-    if (!entry.is_dir && processorTypes.length > 0) {
-      const ext = entry.name.split('.').pop()?.toLowerCase() || '';
-      processorSubMenu = processorTypes
-        .filter(pt => {
-          const exts = pt.supported_exts;
-          if (!Array.isArray(exts) || exts.length === 0) return true;
-          return exts.includes(ext);
-        })
-        .map(pt => ({
-          key: 'processor-' + pt.type,
-          label: pt.name,
-          onClick: () => actions.onProcess(entry, pt.type),
-        }));
+    if (processorTypes.length > 0) {
+      if (entry.is_dir) {
+        processorSubMenu = processorTypes
+          .filter(pt => !!pt.supports_directory)
+          .map(pt => ({
+            key: 'processor-' + pt.type,
+            label: pt.name,
+            onClick: () => actions.onProcess(entry, pt.type),
+          }));
+      } else {
+        const ext = entry.name.split('.').pop()?.toLowerCase() || '';
+        processorSubMenu = processorTypes
+          .filter(pt => {
+            const exts = pt.supported_exts;
+            if (!Array.isArray(exts) || exts.length === 0) return true;
+            return exts.includes(ext);
+          })
+          .map(pt => ({
+            key: 'processor-' + pt.type,
+            label: pt.name,
+            onClick: () => actions.onProcess(entry, pt.type),
+          }));
+      }
     }
 
     const menuItems: (ActionMenuItem | null)[] = [
       (entry.is_dir || apps.length > 0) ? {
         key: 'open',
-        label: defaultApp ? `${t('Open')} (${defaultApp.name})` : t('Open'),
+        label: t('Open'),
         icon: <FolderFilled />,
         onClick: () => actions.onOpen(entry),
       } : null,
@@ -113,7 +123,7 @@ export const ContextMenu: React.FC<ContextMenuProps> = (props) => {
           onClick: () => actions.onOpenWith(entry, a.key),
         })),
       } : null,
-      !entry.is_dir && processorSubMenu.length > 0 ? {
+      processorSubMenu.length > 0 ? {
         key: 'process',
         label: t('Processor'),
         icon: <AppstoreAddOutlined />,

web/src/pages/FileExplorerPage/components/GridView.tsx

@@ -66,6 +66,24 @@ export const GridView: React.FC<Props> = ({ entries, thumbs, selectedEntries, pa
   const [rect, setRect] = useState<{ left: number, top: number, width: number, height: number } | null>(null);
   const [selecting, setSelecting] = useState(false);
 
+  useEffect(() => {
+    const grid = containerRef.current;
+    const scrollContainer = grid?.parentElement;
+    if (!scrollContainer) return;
+
+    const onBlankMouseDown = (e: MouseEvent) => {
+      if (e.button !== 0) return;
+      if (e.target !== scrollContainer) return;
+      startRef.current = { x: e.clientX, y: e.clientY };
+      setSelecting(true);
+      setRect({ left: e.clientX, top: e.clientY, width: 0, height: 0 });
+      e.preventDefault();
+    };
+
+    scrollContainer.addEventListener('mousedown', onBlankMouseDown);
+    return () => scrollContainer.removeEventListener('mousedown', onBlankMouseDown);
+  }, []);
+
   useEffect(() => {
     const onMove = (ev: MouseEvent) => {
       if (!startRef.current) return;

web/src/pages/FileExplorerPage/components/Header.tsx

@@ -41,6 +41,7 @@ export const Header: React.FC<HeaderProps> = ({
   const { t } = useI18n();
   const [editingPath, setEditingPath] = useState(false);
   const [pathInputValue, setPathInputValue] = useState('');
+  const pathEditorHeight = token.fontSizeSM * token.lineHeight + token.paddingXXS * 2;
 
   const handlePathEdit = () => {
     setEditingPath(true);
@@ -71,7 +72,7 @@ export const Header: React.FC<HeaderProps> = ({
           onBlur={handlePathCancel}
           onKeyDown={(e) => e.key === 'Escape' && handlePathCancel()}
           autoFocus
-          style={{ flex: 1 }}
+          style={{ flex: 1, height: pathEditorHeight, boxSizing: 'border-box' }}
         />
       );
     }
@@ -89,12 +90,23 @@ export const Header: React.FC<HeaderProps> = ({
 
     return (
       <div
-        style={{ cursor: 'pointer', padding: '4px 8px', borderRadius: token.borderRadius, transition: 'background-color 0.2s', flex: 1, overflow: 'hidden' }}
+        style={{
+          cursor: 'pointer',
+          padding: `${token.paddingXXS}px ${token.paddingXS}px`,
+          borderRadius: token.borderRadius,
+          transition: 'background-color 0.2s',
+          flex: 1,
+          overflow: 'hidden',
+          height: pathEditorHeight,
+          boxSizing: 'border-box',
+          display: 'flex',
+          alignItems: 'center'
+        }}
         onMouseEnter={(e) => { e.currentTarget.style.backgroundColor = token.colorFillTertiary; }}
         onMouseLeave={(e) => { e.currentTarget.style.backgroundColor = 'transparent'; }}
         onClick={handlePathEdit}
       >
-        <Breadcrumb items={breadcrumbItems} separator="/" style={{ fontSize: 12 }} />
+        <Breadcrumb items={breadcrumbItems} separator="/" style={{ fontSize: token.fontSizeSM }} />
       </div>
     );
   };

web/src/pages/FileExplorerPage/components/Modals/DirectLinkModal.tsx

@@ -1,4 +1,4 @@
-import { memo, useState, useEffect } from 'react';
+import { memo, useState, useEffect, useCallback } from 'react';
 import { Modal, Radio, message, Button, Typography, Input, Space } from 'antd';
 import { CopyOutlined, FileMarkdownOutlined } from '@ant-design/icons';
 import type { VfsEntry } from '../../../../api/client';
@@ -33,14 +33,7 @@ export const DirectLinkModal = memo(function DirectLinkModal({ entry, path, open
   const [link, setLink] = useState('');
   const { t } = useI18n();
 
-  useEffect(() => {
-    if (open && entry) {
-      setLink('');
-      generateLink();
-    }
-  }, [open, entry, expiresIn]);
-
-  const generateLink = async () => {
+  const generateLink = useCallback(async () => {
     if (!entry) return;
     setLoading(true);
     try {
@@ -57,7 +50,14 @@ export const DirectLinkModal = memo(function DirectLinkModal({ entry, path, open
     } finally {
       setLoading(false);
     }
-  };
+  }, [entry, expiresIn, path, t]);
+
+  useEffect(() => {
+    if (open && entry) {
+      setLink('');
+      void generateLink();
+    }
+  }, [open, entry, generateLink]);
 
   const handleCopy = (text: string) => {
     navigator.clipboard.writeText(text);

web/src/pages/FileExplorerPage/components/Modals/MoveCopyModal.tsx

@@ -41,9 +41,7 @@ export function MoveCopyModal({ mode, entries, open, defaultPath, onOk, onCancel
     try {
       await onOk(trimmed);
       onCancel();
-    } catch (e) {
-      // 上层已处理提示，这里只需保持对话框
-    } finally {
+    } catch { void 0; } finally {
       setLoading(false);
     }
   };

web/src/pages/FileExplorerPage/components/Modals/ProcessorModal.tsx

@@ -31,6 +31,19 @@ export const ProcessorModal: React.FC<ProcessorModalProps> = (props) => {
   const [form] = Form.useForm();
   const { t } = useI18n();
 
+  const availableProcessors = React.useMemo(() => {
+    if (!entry) return processorTypes;
+    if (entry.is_dir) {
+      return processorTypes.filter(pt => !!pt.supports_directory);
+    }
+    const ext = entry.name.split('.').pop()?.toLowerCase() || '';
+    return processorTypes.filter(pt => {
+      const exts = pt.supported_exts;
+      if (!Array.isArray(exts) || exts.length === 0) return true;
+      return exts.includes(ext);
+    });
+  }, [entry, processorTypes]);
+
   const selectedProcessorMeta = processorTypes.find(pt => pt.type === selectedProcessor);
 
   // Sync form when modal opens or selected processor changes
@@ -64,7 +77,7 @@ export const ProcessorModal: React.FC<ProcessorModalProps> = (props) => {
         <Form.Item name="processor_type" label={t('Processor')} required>
           <Select
             onChange={onSelectedProcessorChange}
-            options={processorTypes.map(pt => ({ value: pt.type, label: pt.name }))}
+            options={availableProcessors.map(pt => ({ value: pt.type, label: pt.name }))}
             placeholder={t('Select a processor')}
           />
         </Form.Item>

web/src/pages/FileExplorerPage/hooks/useAppWindows.tsx

@@ -24,7 +24,7 @@ export function useAppWindows(path: string) {
       const finalW = Math.min(baseW, vw - 40);
       const finalH = Math.min(baseH, vh - 60);
       const finalX = Math.min(Math.max(0, baseX), vw - finalW - 8);
-      const finalY = Math.min(Math.max(48, baseY), vh - finalH - 8);
+      const finalY = Math.min(Math.max(0, baseY), vh - finalH - 8);
       return [...ws, {
         id: Date.now().toString(36) + Math.random().toString(36).slice(2),
         app,
@@ -47,7 +47,7 @@ export function useAppWindows(path: string) {
     }
     const defaultApp = getDefaultAppForEntry(entry) || apps[0];
     openWithApp(entry, defaultApp);
-  }, [openWithApp]);
+  }, [openWithApp, t]);
 
   const confirmOpenWithApp = useCallback((entry: VfsEntry, appKey: string) => {
     const app = getAppByKey(appKey);
@@ -72,7 +72,7 @@ export function useAppWindows(path: string) {
         openWithApp(entry, app);
       }
     });
-  }, [openWithApp]);
+  }, [openWithApp, t]);
 
   const closeWindow = (id: string) => setAppWindows(ws => ws.filter(w => w.id !== id));
   const toggleMax = (id: string) => setAppWindows(ws => ws.map(w => w.id === id ? { ...w, maximized: !w.maximized } : w));

web/src/pages/FileExplorerPage/hooks/useFileActions.tsx

@@ -35,7 +35,7 @@ export function useFileActions({ path, refresh, clearSelection, onShare, onGetDi
     } catch (e: any) {
       message.error(e.message);
     }
-  }, [path, refresh]);
+  }, [path, refresh, t]);
 
   const doDelete = useCallback(async (entries: VfsEntry[]) => {
     Modal.confirm({
@@ -51,7 +51,7 @@ export function useFileActions({ path, refresh, clearSelection, onShare, onGetDi
         }
       }
     });
-  }, [path, refresh, clearSelection]);
+  }, [path, refresh, clearSelection, t]);
 
   const doRename = useCallback(async (entry: VfsEntry, newName: string) => {
     if (!newName.trim() || newName.trim() === entry.name) {
@@ -173,7 +173,7 @@ export function useFileActions({ path, refresh, clearSelection, onShare, onGetDi
     } catch (e: any) {
       message.error(e.message || t('Download failed'));
     }
-  }, [path]);
+  }, [path, t]);
 
   const doShare = useCallback((entries: VfsEntry[]) => {
     if (entries.length === 0) {
@@ -181,7 +181,7 @@ export function useFileActions({ path, refresh, clearSelection, onShare, onGetDi
       return;
     }
     onShare(entries);
-  }, [onShare]);
+  }, [onShare, t]);
 
   const doGetDirectLink = useCallback((entry: VfsEntry) => {
     if (entry.is_dir) {
@@ -189,7 +189,7 @@ export function useFileActions({ path, refresh, clearSelection, onShare, onGetDi
       return;
     }
     onGetDirectLink(entry);
-  }, [onGetDirectLink]);
+  }, [onGetDirectLink, t]);
 
   return {
     doCreateDir,

web/src/pages/FileExplorerPage/hooks/useProcessor.ts

@@ -58,7 +58,7 @@ export function useProcessor({ path, processorTypes, refresh }: ProcessorParams)
     } finally {
       setLoading(false);
     }
-  }, [modal.entry, selectedProcessor, processorTypes, config, path, overwrite, savingPath, refresh]);
+  }, [modal.entry, selectedProcessor, processorTypes, config, path, overwrite, savingPath, refresh, t]);
 
   const handleCancel = useCallback(() => {
     setModal({ entry: null, visible: false });

web/src/pages/PluginsPage.tsx

@@ -1,14 +1,16 @@
-import { memo, useEffect, useMemo, useState } from 'react';
+import { memo, useCallback, useEffect, useMemo, useState } from 'react';
 import { Button, Modal, Form, Input, Tag, message, Card, Typography, Popconfirm, Empty, Skeleton, theme, Divider, Tabs, Select, Pagination } from 'antd';
 import { GithubOutlined, LinkOutlined } from '@ant-design/icons';
 import { pluginsApi, type PluginItem } from '../api/plugins';
-import { loadPluginFromUrl, ensureManifest } from '../plugins/runtime';
-import { reloadPluginApps } from '../apps/registry';
+import { loadPlugin, ensureManifest } from '../plugins/runtime';
+import { getAppByKey, reloadPluginApps, ensureAppsLoaded, listSystemApps, type AppDescriptor } from '../apps/registry';
 import { useI18n } from '../i18n';
 import { fetchRepoList, type RepoItem, buildCenterUrl } from '../api/pluginCenter';
+import { useAppWindows } from '../contexts/AppWindowsContext';
 
 const PluginsPage = memo(function PluginsPage() {
   const [data, setData] = useState<PluginItem[]>([]);
+  const [systemApps, setSystemApps] = useState<AppDescriptor[]>([]);
   const [adding, setAdding] = useState(false);
   const [loading, setLoading] = useState(false);
   const [q, setQ] = useState('');
@@ -24,12 +26,21 @@ const PluginsPage = memo(function PluginsPage() {
   const [form] = Form.useForm<{ url: string }>();
   const { token } = theme.useToken();
   const { t } = useI18n();
+  const { openApp } = useAppWindows();
 
   const reload = async () => {
     try { setLoading(true); setData(await pluginsApi.list()); } finally { setLoading(false); }
   };
 
   useEffect(() => { reload(); }, []);
+  useEffect(() => {
+    (async () => {
+      try {
+        await ensureAppsLoaded();
+        setSystemApps(listSystemApps());
+      } catch { void 0; }
+    })();
+  }, []);
 
   const installedKeySet = useMemo(() => {
     const set = new Set<string>();
@@ -37,38 +48,38 @@ const PluginsPage = memo(function PluginsPage() {
     return set;
   }, [data]);
 
-  const reloadRepo = async () => {
+  const reloadRepo = useCallback(async () => {
     try {
       setRepoLoading(true);
       const res = await fetchRepoList({ query: repoQ || undefined, sort: repoSort, page: repoPage, pageSize: repoPageSize });
       setRepoItems(res.items || []);
       setRepoTotal(res.total || 0);
-    } catch (e) {
+    } catch {
       setRepoItems([]);
       setRepoTotal(0);
     } finally {
       setRepoLoading(false);
     }
-  };
+  }, [repoPage, repoPageSize, repoQ, repoSort]);
 
   useEffect(() => {
     if (tab === 'discover') reloadRepo();
-  }, [tab, repoQ, repoSort, repoPage, repoPageSize]);
+  }, [reloadRepo, tab]);
 
   const handleAdd = async () => {
     try {
       const { url } = await form.validateFields();
       const created = await pluginsApi.create({ url });
       try {
-        const p = await loadPluginFromUrl(created.url);
+        const p = await loadPlugin(created);
         await ensureManifest(created.id, p);
-      } catch {}
+      } catch { void 0; }
       setAdding(false);
       form.resetFields();
       await reload();
       await reloadPluginApps();
       message.success(t('Installed successfully'));
-    } catch {}
+    } catch { void 0; }
   };
 
   const filtered = useMemo(() => {
@@ -83,11 +94,27 @@ const PluginsPage = memo(function PluginsPage() {
     ));
   }, [data, q]);
 
+  const filteredSystemApps = useMemo(() => {
+    const s = q.trim().toLowerCase();
+    if (!s) return systemApps;
+    return systemApps.filter(a => (
+      (a.name || '').toLowerCase().includes(s)
+      || (a.author || '').toLowerCase().includes(s)
+      || (a.website || '').toLowerCase().includes(s)
+      || (a.github || '').toLowerCase().includes(s)
+      || (a.description || '').toLowerCase().includes(s)
+      || (a.supportedExts || []).some(e => e.toLowerCase().includes(s))
+      || (a.key || '').toLowerCase().includes(s)
+    ));
+  }, [systemApps, q]);
+
   const renderCard = (p: PluginItem) => {
     const icon = p.icon || '/plugins/demo-text-viewer.svg';
     const name = p.name || `${t('Plugin')} ${p.id}`;
     const exts = (p.supported_exts || []).slice(0, 6);
     const more = (p.supported_exts || []).length - exts.length;
+    const app = getAppByKey('plugin:' + p.id);
+    const canOpenApp = !!p.open_app;
     const title = (
       <div style={{ display: 'flex', alignItems: 'center', gap: 8 }}>
         <img src={icon} alt={name} style={{ width: 24, height: 24, objectFit: 'contain' }} onError={(e) => { (e.currentTarget as HTMLImageElement).src = '/plugins/demo-text-viewer.svg'; }} />
@@ -104,8 +131,23 @@ const PluginsPage = memo(function PluginsPage() {
         styles={{ body: { padding: 12 } } as any}
         style={{ borderRadius: 10, boxShadow: token.boxShadowTertiary }}
         actions={[
-          <a key="open" href={p.url} target="_blank" rel="noreferrer">{t('Open Link')}</a>,
-          <Button key="copy" type="link" size="small" onClick={async () => { try { await navigator.clipboard.writeText(p.url); message.success(t('Link copied')); } catch {} }}>{t('Copy Link')}</Button>,
+          <Button
+            key="open-app"
+            type="link"
+            size="small"
+            disabled={!canOpenApp}
+            onClick={async () => {
+              let target = app || getAppByKey('plugin:' + p.id);
+              if (!target) {
+                await reloadPluginApps();
+                target = getAppByKey('plugin:' + p.id);
+              }
+              if (target?.openAppComponent) openApp(target);
+            }}
+          >
+            {t('Open App')}
+          </Button>,
+          <Button key="update-app" type="link" size="small" onClick={() => message.info(t('Coming soon'))}>{t('Update App')}</Button>,
           <Popconfirm key="del" title={t('Confirm delete this plugin?')} onConfirm={async () => { await pluginsApi.remove(p.id); await reload(); await reloadPluginApps(); }}>
             <Button type="link" danger size="small">{t('Delete')}</Button>
           </Popconfirm>
@@ -149,6 +191,61 @@ const PluginsPage = memo(function PluginsPage() {
     );
   };
 
+  const renderSystemCard = (a: AppDescriptor) => {
+    const icon = a.iconUrl || '/plugins/demo-text-viewer.svg';
+    const name = a.name || a.key;
+    const exts = (a.supportedExts || []).slice(0, 6);
+    const more = (a.supportedExts || []).length - exts.length;
+    const title = (
+      <div style={{ display: 'flex', alignItems: 'center', gap: 8 }}>
+        <img src={icon} alt={name} style={{ width: 24, height: 24, objectFit: 'contain' }} onError={(e) => { (e.currentTarget as HTMLImageElement).src = '/plugins/demo-text-viewer.svg'; }} />
+        <span>{name}</span>
+        <Tag style={{ marginLeft: 'auto' }}>{t('System App')}</Tag>
+      </div>
+    );
+    return (
+      <Card
+        key={`system:${a.key}`}
+        title={title}
+        hoverable
+        size="small"
+        styles={{ body: { padding: 12 } } as any}
+        style={{ borderRadius: 10, boxShadow: token.boxShadowTertiary }}
+        actions={[
+          <Button
+            key="open-app"
+            type="link"
+            size="small"
+            disabled={!a.openAppComponent}
+            onClick={() => openApp(a)}
+          >
+            {t('Open App')}
+          </Button>,
+          <Button key="update-app" type="link" size="small" disabled onClick={() => message.info(t('Coming soon'))}>{t('Update App')}</Button>,
+          <Button key="del" type="link" danger size="small" disabled>{t('Delete')}</Button>
+        ]}
+      >
+        <Typography.Paragraph
+          style={{ marginBottom: 8, minHeight: 44, lineHeight: '22px' }}
+          ellipsis={{ rows: 2 }}
+        >
+          {a.description || '（暂无描述）'}
+        </Typography.Paragraph>
+        <div style={{ display: 'flex', alignItems: 'center', gap: 8 }}>
+          <div style={{ display: 'flex', alignItems: 'center', gap: 8, flexWrap: 'nowrap', overflow: 'hidden', whiteSpace: 'nowrap', minWidth: 0, flex: 1 }}>
+            {(exts.length > 0 ? exts : ['任意']).map(e => <Tag key={e} style={{ flex: 'none' }}>{e}</Tag>)}
+          </div>
+          {more > 0 && <Tag style={{ flex: 'none' }}>+{more}</Tag>}
+        </div>
+        <Divider style={{ margin: '8px 0' }} />
+        <div style={{ display: 'flex', alignItems: 'center', gap: 8, color: token.colorTextTertiary, fontSize: 12 }}>
+          <span>{t('Author')}: {a.author || 'Foxel'}</span>
+          <span style={{ marginLeft: 'auto', color: token.colorTextTertiary }}>{t('System App')}</span>
+        </div>
+      </Card>
+    );
+  };
+
   const renderRepoCard = (item: RepoItem) => {
     const icon = item.icon || '/plugins/demo-text-viewer.svg';
     const name = item.name || item.key;
@@ -191,9 +288,9 @@ const PluginsPage = memo(function PluginsPage() {
                 const url = buildCenterUrl(item.directUrl);
                 const created = await pluginsApi.create({ url });
                 try {
-                  const p = await loadPluginFromUrl(created.url);
+                  const p = await loadPlugin(created);
                   await ensureManifest(created.id, p);
-                } catch {}
+                } catch { void 0; }
                 await reload();
                 await reloadPluginApps();
                 message.success(t('Installed successfully'));
@@ -243,7 +340,7 @@ const PluginsPage = memo(function PluginsPage() {
   };
 
   return (
-    <>
+    <div style={{ height: 'calc(100vh - 88px)', display: 'flex', flexDirection: 'column', minHeight: 0, overflow: 'hidden' }}>
       <div style={{ display: 'flex', alignItems: 'center', gap: 8, marginBottom: 12, flexWrap: 'wrap' }}>
         <Button type="primary" onClick={() => setAdding(true)}>{t('Install App')}</Button>
         {tab === 'installed' && <Button onClick={reload} loading={loading}>{t('Refresh')}</Button>}
@@ -253,12 +350,13 @@ const PluginsPage = memo(function PluginsPage() {
       <Tabs
         activeKey={tab}
         onChange={(k) => setTab(k as any)}
+        className="plugins-tabs"
         items={[
           {
             key: 'installed',
             label: t('Installed'),
             children: (
-              <>
+              <div style={{ flex: 1, minHeight: 0, display: 'flex', flexDirection: 'column' }}>
                 <div style={{ display: 'flex', alignItems: 'center', gap: 8, marginBottom: 12 }}>
                   <Input
                     placeholder={t('Search name/author/url/extension')}
@@ -269,29 +367,32 @@ const PluginsPage = memo(function PluginsPage() {
                     onPressEnter={() => reload()}
                   />
                 </div>
-                {loading ? (
-                  <div style={{ display: 'grid', gridTemplateColumns: 'repeat(auto-fill, minmax(280px, 1fr))', gap: 12 }}>
-                    {Array.from({ length: 6 }).map((_, i) => (
-                      <Card key={i} style={{ borderRadius: 10 }}>
-                        <Skeleton active avatar paragraph={{ rows: 3 }} />
-                      </Card>
-                    ))}
-                  </div>
-                ) : filtered.length === 0 ? (
-                  <Empty description={t('No plugins')} />
-                ) : (
-                  <div style={{ display: 'grid', gridTemplateColumns: 'repeat(auto-fill, minmax(320px, 1fr))', gap: 12 }}>
-                    {filtered.map(renderCard)}
-                  </div>
-                )}
-              </>
+                <div style={{ flex: 1, minHeight: 0, overflow: 'auto', padding: 4 }}>
+                  {loading ? (
+                    <div style={{ display: 'grid', gridTemplateColumns: 'repeat(auto-fill, minmax(280px, 1fr))', gap: 12 }}>
+                      {Array.from({ length: 6 }).map((_, i) => (
+                        <Card key={i} style={{ borderRadius: 10 }}>
+                          <Skeleton active avatar paragraph={{ rows: 3 }} />
+                        </Card>
+                      ))}
+                    </div>
+                  ) : (filteredSystemApps.length + filtered.length) === 0 ? (
+                    <Empty description={t('No plugins')} />
+                  ) : (
+                    <div style={{ display: 'grid', gridTemplateColumns: 'repeat(auto-fill, minmax(320px, 1fr))', gap: 12 }}>
+                      {filteredSystemApps.map(renderSystemCard)}
+                      {filtered.map(renderCard)}
+                    </div>
+                  )}
+                </div>
+              </div>
             )
           },
           {
             key: 'discover',
             label: t('Discover'),
             children: (
-              <>
+              <div style={{ flex: 1, minHeight: 0, display: 'flex', flexDirection: 'column' }}>
                 <div style={{ display: 'flex', alignItems: 'center', gap: 8, marginBottom: 12, flexWrap: 'wrap' }}>
                   <Input
                     placeholder={t('Search apps')}
@@ -319,34 +420,36 @@ const PluginsPage = memo(function PluginsPage() {
                     Foxel Center
                   </Button>
                 </div>
-                {repoLoading ? (
-                  <div style={{ display: 'grid', gridTemplateColumns: 'repeat(auto-fill, minmax(280px, 1fr))', gap: 12 }}>
-                    {Array.from({ length: 6 }).map((_, i) => (
-                      <Card key={i} style={{ borderRadius: 10 }}>
-                        <Skeleton active avatar paragraph={{ rows: 3 }} />
-                      </Card>
-                    ))}
-                  </div>
-                ) : repoItems.length === 0 ? (
-                  <Empty description={t('No results')} />
-                ) : (
-                  <>
-                    <div style={{ display: 'grid', gridTemplateColumns: 'repeat(auto-fill, minmax(320px, 1fr))', gap: 12 }}>
-                      {repoItems.map(renderRepoCard)}
+                <div style={{ flex: 1, minHeight: 0, overflow: 'auto', padding: 4 }}>
+                  {repoLoading ? (
+                    <div style={{ display: 'grid', gridTemplateColumns: 'repeat(auto-fill, minmax(280px, 1fr))', gap: 12 }}>
+                      {Array.from({ length: 6 }).map((_, i) => (
+                        <Card key={i} style={{ borderRadius: 10 }}>
+                          <Skeleton active avatar paragraph={{ rows: 3 }} />
+                        </Card>
+                      ))}
                     </div>
-                    <div style={{ display: 'flex', justifyContent: 'center', marginTop: 12 }}>
-                      <Pagination
-                        current={repoPage}
-                        pageSize={repoPageSize}
-                        total={repoTotal}
-                        showSizeChanger
-                        pageSizeOptions={[12, 24, 48].map(String)}
-                        onChange={(p, ps) => { setRepoPage(p); setRepoPageSize(ps); }}
-                      />
-                    </div>
-                  </>
-                )}
-              </>
+                  ) : repoItems.length === 0 ? (
+                    <Empty description={t('No results')} />
+                  ) : (
+                    <>
+                      <div style={{ display: 'grid', gridTemplateColumns: 'repeat(auto-fill, minmax(320px, 1fr))', gap: 12 }}>
+                        {repoItems.map(renderRepoCard)}
+                      </div>
+                      <div style={{ display: 'flex', justifyContent: 'center', marginTop: 12 }}>
+                        <Pagination
+                          current={repoPage}
+                          pageSize={repoPageSize}
+                          total={repoTotal}
+                          showSizeChanger
+                          pageSizeOptions={[12, 24, 48].map(String)}
+                          onChange={(p, ps) => { setRepoPage(p); setRepoPageSize(ps); }}
+                        />
+                      </div>
+                    </>
+                  )}
+                </div>
+              </div>
             )
           }
         ]}
@@ -365,7 +468,7 @@ const PluginsPage = memo(function PluginsPage() {
           </Form.Item>
         </Form>
       </Modal>
-    </>
+    </div>
   );
 });
 

web/src/pages/ProcessorsPage.tsx

@@ -145,6 +145,7 @@ const ProcessorsPage = memo(function ProcessorsPage() {
   }, [selectedProcessorMeta, form]);
 
   const producesFile = selectedProcessorMeta?.produces_file ?? false;
+  const supportsDirectory = selectedProcessorMeta?.supports_directory ?? false;
   const overwriteWatch = Form.useWatch('overwrite', form);
   const overwriteValue = producesFile ? !!overwriteWatch : false;
   const directoryScope = Form.useWatch('directory_scope', form) ?? 'current';
@@ -250,23 +251,33 @@ const ProcessorsPage = memo(function ProcessorsPage() {
       setRunning(true);
       const overwriteFlag = producesFile ? !!values.overwrite : false;
       if (isDirectory) {
-        const scope: 'current' | 'recursive' = values.directory_scope || 'current';
-        let maxDepth: number | null = scope === 'current' ? 0 : null;
-        if (scope === 'recursive' && typeof values.max_depth === 'number') {
-          maxDepth = values.max_depth;
+        if (supportsDirectory) {
+          const resp = await processorsApi.process({
+            path: values.path,
+            processor_type: selectedType,
+            config: finalConfig,
+            overwrite: overwriteFlag,
+          });
+          messageApi.success(`${t('Task submitted')}: ${resp.task_id}`);
+        } else {
+          const scope: 'current' | 'recursive' = values.directory_scope || 'current';
+          let maxDepth: number | null = scope === 'current' ? 0 : null;
+          if (scope === 'recursive' && typeof values.max_depth === 'number') {
+            maxDepth = values.max_depth;
+          }
+          const suffixValue = producesFile && !overwriteFlag && typeof values.suffix === 'string'
+            ? values.suffix.trim() || null
+            : null;
+          const resp = await processorsApi.processDirectory({
+            path: values.path,
+            processor_type: selectedType,
+            config: finalConfig,
+            overwrite: overwriteFlag,
+            max_depth: maxDepth,
+            suffix: suffixValue,
+          });
+          messageApi.success(`${t('Task submitted')}: ${resp.scheduled}`);
         }
-        const suffixValue = producesFile && !overwriteFlag && typeof values.suffix === 'string'
-          ? values.suffix.trim() || null
-          : null;
-        const resp = await processorsApi.processDirectory({
-          path: values.path,
-          processor_type: selectedType,
-          config: finalConfig,
-          overwrite: overwriteFlag,
-          max_depth: maxDepth,
-          suffix: suffixValue,
-        });
-        messageApi.success(`${t('Task submitted')}: ${resp.scheduled}`);
       } else {
         const payload: any = {
           path: values.path,
@@ -288,7 +299,7 @@ const ProcessorsPage = memo(function ProcessorsPage() {
     } finally {
       setRunning(false);
     }
-  }, [form, isDirectory, messageApi, producesFile, selectedProcessorMeta, selectedType, t]);
+  }, [form, isDirectory, messageApi, producesFile, selectedType, supportsDirectory, selectedProcessorMeta, t]);
 
   const selectedConfigPath = pathModalField === 'path'
     ? (selectedType ? form.getFieldValue('path') : undefined) || '/'
@@ -434,7 +445,16 @@ const ProcessorsPage = memo(function ProcessorsPage() {
                   <Button onClick={() => openPathSelector('path', 'directory')}>{t('Select Directory')}</Button>
                 </Flex>
               </Form.Item>
-              {isDirectory && (
+              {isDirectory && supportsDirectory && (
+                <Space direction="vertical" size={12} style={{ width: '100%', marginBottom: 12 }}>
+                  <Alert
+                    type="info"
+                    showIcon
+                    message={t('Directory execution will enqueue one task for the directory itself')}
+                  />
+                </Space>
+              )}
+              {isDirectory && !supportsDirectory && (
                 <Space direction="vertical" size={12} style={{ width: '100%', marginBottom: 12 }}>
                   <Alert
                     type="info"
@@ -477,7 +497,7 @@ const ProcessorsPage = memo(function ProcessorsPage() {
                 </Form.Item>
               )}
 
-              {isDirectory && producesFile && !overwriteValue && (
+              {isDirectory && !supportsDirectory && producesFile && !overwriteValue && (
                 <Form.Item
                   name="suffix"
                   label={t('Output suffix')}

web/src/pages/PublicSharePage/DirectoryViewer.tsx

@@ -22,19 +22,19 @@ export const DirectoryViewer = memo(function DirectoryViewer({ token, shareInfo,
     const [error, setError] = useState('');
     const { t } = useI18n();
 
-    const loadData = useCallback(async (p: string) => {
-        setLoading(true);
-        setError('');
-        try {
-            const listing = await shareApi.listDir(token, p, password);
-            setEntries(listing.entries || []);
-            setCurrentPath(p);
-        } catch (e: any) {
-            setError(e.message || t('Share load failed'));
-        } finally {
-            setLoading(false);
-        }
-    }, [token, password]);
+	    const loadData = useCallback(async (p: string) => {
+	        setLoading(true);
+	        setError('');
+	        try {
+	            const listing = await shareApi.listDir(token, p, password);
+	            setEntries(listing.entries || []);
+	            setCurrentPath(p);
+	        } catch (e: any) {
+	            setError(e.message || t('Share load failed'));
+	        } finally {
+	            setLoading(false);
+	        }
+	    }, [password, t, token]);
 
     useEffect(() => {
         loadData(currentPath);

web/src/pages/PublicSharePage/index.tsx

@@ -17,10 +17,10 @@ const PublicSharePage = memo(function PublicSharePage() {
   const [verified, setVerified] = useState(false);
   const { t } = useI18n();
 
-  const loadData = useCallback(async (pwd?: string) => {
-    if (!token) return;
-    setLoading(true);
-    setError('');
+	  const loadData = useCallback(async (pwd?: string) => {
+	    if (!token) return;
+	    setLoading(true);
+	    setError('');
     try {
       let info = shareInfo;
       if (!info) {
@@ -50,10 +50,10 @@ const PublicSharePage = memo(function PublicSharePage() {
       if (e.message === '需要密码') {
         setVerified(false);
       }
-    } finally {
-      setLoading(false);
-    }
-  }, [token, shareInfo, password, verified]);
+	    } finally {
+	      setLoading(false);
+	    }
+	  }, [password, shareInfo, t, token, verified]);
 
   useEffect(() => {
     loadData();

web/src/pages/SharePage.tsx

@@ -23,7 +23,7 @@ const SharePage = memo(function SharePage() {
     } finally {
       setLoading(false);
     }
-  }, []);
+  }, [t]);
 
   useEffect(() => { fetchList(); }, [fetchList]);