chore: update version to v1.2.1

.github/workflows/docker.yml

@@ -42,10 +42,10 @@ jobs:
           username: ${{ github.actor }}
           password: ${{ secrets.GITHUB_TOKEN }}
 
-      - name: Build and push Docker image
+      - name: Build and push Docker image (multi arch)
         uses: docker/build-push-action@v5
         with:
           context: .
-          platforms: linux/amd64
+          platforms: linux/amd64,linux/arm64
           push: true
           tags: ${{ env.DOCKER_TAGS }}

.gitignore

@@ -6,4 +6,5 @@ __pycache__/
 .vscode/
 data/
 migrate/
-.env
+.env
+AGENTS.md

.python-version

@@ -0,0 +1 @@
+3.13

CONTRIBUTING.md

@@ -70,8 +70,10 @@
 
 2. **创建并激活 Python 虚拟环境**
 
+    我们推荐使用 `uv` 来管理虚拟环境，以获得最佳性能。
+
     ```bash
-    python3 -m venv .venv
+    uv venv
     source .venv/bin/activate
     # On Windows: .venv\Scripts\activate
     ```
@@ -79,7 +81,7 @@
 3. **安装依赖**
 
     ```bash
-    pip install -r requirements.txt
+    uv sync
     ```
 
 4. **初始化环境**

Dockerfile

@@ -15,8 +15,9 @@ WORKDIR /app
 
 RUN apt-get update && apt-get install -y nginx git && rm -rf /var/lib/apt/lists/*
 
-COPY requirements.txt .
-RUN pip install --no-cache-dir -r requirements.txt && pip install gunicorn
+RUN pip install uv
+COPY pyproject.toml uv.lock ./
+RUN uv pip install --system . gunicorn
 
 RUN git clone https://github.com/DrizzleTime/FoxelUpgrade /app/migrate
 

api/routers.py

@@ -1,6 +1,7 @@
 from fastapi import FastAPI
 
-from .routes import adapters, virtual_fs, auth, config, processors, tasks, logs, share, backup, search
+from .routes import adapters, virtual_fs, auth, config, processors, tasks, logs, share, backup, search, vector_db
+from .routes import plugins
 
 
 def include_routers(app: FastAPI):
@@ -14,4 +15,6 @@ def include_routers(app: FastAPI):
     app.include_router(logs.router)
     app.include_router(share.router)
     app.include_router(share.public_router)
-    app.include_router(backup.router)
+    app.include_router(backup.router)
+    app.include_router(vector_db.router)
+    app.include_router(plugins.router)

api/routes/adapters.py

@@ -54,7 +54,7 @@ async def create_adapter(
     }
 
     rec = await StorageAdapter.create(**adapter_fields)
-    await runtime_registry.refresh()
+    await runtime_registry.upsert(rec)
     await LogService.action(
         "route:adapters",
         f"Created adapter {rec.name}",
@@ -121,7 +121,7 @@ async def update_adapter(
     rec.sub_path = data.sub_path
     await rec.save()
 
-    await runtime_registry.refresh()
+    await runtime_registry.upsert(rec)
     await LogService.action(
         "route:adapters",
         f"Updated adapter {rec.name}",
@@ -139,7 +139,7 @@ async def delete_adapter(
     deleted = await StorageAdapter.filter(id=adapter_id).delete()
     if not deleted:
         raise HTTPException(404, detail="Not found")
-    await runtime_registry.refresh()
+    runtime_registry.remove(adapter_id)
     await LogService.action(
         "route:adapters",
         f"Deleted adapter {adapter_id}",

api/routes/plugins.py

@@ -0,0 +1,73 @@
+from typing import List, Any, Dict
+from fastapi import APIRouter, HTTPException, Body
+from models import database
+from schemas import PluginCreate, PluginOut
+
+router = APIRouter(prefix="/api/plugins", tags=["plugins"])
+
+
+@router.post("", response_model=PluginOut)
+async def create_plugin(payload: PluginCreate):
+    rec = await database.Plugin.create(
+        url=payload.url,
+        enabled=payload.enabled,
+    )
+    return PluginOut.model_validate(rec)
+
+
+@router.get("", response_model=List[PluginOut])
+async def list_plugins():
+    rows = await database.Plugin.all().order_by("-id")
+    return [PluginOut.model_validate(r) for r in rows]
+
+
+@router.delete("/{plugin_id}")
+async def delete_plugin(plugin_id: int):
+    rec = await database.Plugin.get_or_none(id=plugin_id)
+    if not rec:
+        raise HTTPException(status_code=404, detail="Plugin not found")
+    await rec.delete()
+    return {"code": 0, "msg": "ok"}
+
+
+@router.put("/{plugin_id}", response_model=PluginOut)
+async def update_plugin(plugin_id: int, payload: PluginCreate):
+    rec = await database.Plugin.get_or_none(id=plugin_id)
+    if not rec:
+        raise HTTPException(status_code=404, detail="Plugin not found")
+    rec.url = payload.url
+    rec.enabled = payload.enabled
+    await rec.save()
+    return PluginOut.model_validate(rec)
+
+
+@router.post("/{plugin_id}/metadata", response_model=PluginOut)
+async def update_manifest(plugin_id: int, manifest: Dict[str, Any] = Body(...)):
+    rec = await database.Plugin.get_or_none(id=plugin_id)
+    if not rec:
+        raise HTTPException(status_code=404, detail="Plugin not found")
+    key_map = {
+        'key': 'key',
+        'name': 'name',
+        'version': 'version',
+        'supported_exts': 'supported_exts',
+        'supportedExts': 'supported_exts',
+        'default_bounds': 'default_bounds',
+        'defaultBounds': 'default_bounds',
+        'default_maximized': 'default_maximized',
+        'defaultMaximized': 'default_maximized',
+        'icon': 'icon',
+        'description': 'description',
+        'author': 'author',
+        'website': 'website',
+        'github': 'github',
+    }
+    for k, v in list(manifest.items()):
+        if v is None:
+            continue
+        attr = key_map.get(k)
+        if not attr:
+            continue
+        setattr(rec, attr, v)
+    await rec.save()
+    return PluginOut.model_validate(rec)

api/routes/vector_db.py

@@ -0,0 +1,19 @@
+from fastapi import APIRouter, Depends, HTTPException
+from services.auth import get_current_active_user
+from models.database import UserAccount
+from services.vector_db import VectorDBService
+from api.response import success
+
+router = APIRouter(prefix="/api/vector-db", tags=["vector-db"])
+
+
+@router.post("/clear-all", summary="清空向量数据库")
+async def clear_vector_db(user: UserAccount = Depends(get_current_active_user)):
+    if user.username != 'admin':
+        raise HTTPException(status_code=403, detail="仅管理员可操作")
+    try:
+        service = VectorDBService()
+        service.clear_all_data()
+        return success(msg="向量数据库已清空")
+    except Exception as e:
+        raise HTTPException(status_code=500, detail=str(e))

api/routes/virtual_fs.py

@@ -306,10 +306,12 @@ async def browse_fs(
     current_user: Annotated[User, Depends(get_current_active_user)],
     full_path: str,
     page_num: int = Query(1, alias="page", ge=1, description="页码"),
-    page_size: int = Query(50, ge=1, le=500, description="每页条数")
+    page_size: int = Query(50, ge=1, le=500, description="每页条数"),
+    sort_by: str = Query("name", description="按字段排序: name, size, mtime"),
+    sort_order: str = Query("asc", description="排序顺序: asc, desc")
 ):
     full_path = '/' + full_path if not full_path.startswith('/') else full_path
-    result = await list_virtual_dir(full_path, page_num, page_size)
+    result = await list_virtual_dir(full_path, page_num, page_size, sort_by, sort_order)
     return success({
         "path": full_path,
         "entries": result["items"],
@@ -336,6 +338,18 @@ async def api_delete(
 async def root_listing(
     current_user: Annotated[User, Depends(get_current_active_user)],
     page_num: int = Query(1, alias="page", ge=1, description="页码"),
-    page_size: int = Query(50, ge=1, le=500, description="每页条数")
+    page_size: int = Query(50, ge=1, le=500, description="每页条数"),
+    sort_by: str = Query("name", description="按字段排序: name, size, mtime"),
+    sort_order: str = Query("asc", description="排序顺序: asc, desc")
 ):
-    return await browse_fs("", page_num, page_size)
+    result = await list_virtual_dir("/", page_num, page_size, sort_by, sort_order)
+    return success({
+        "path": "/",
+        "entries": result["items"],
+        "pagination": {
+            "total": result["total"],
+            "page": result["page"],
+            "page_size": result["page_size"],
+            "pages": result["pages"]
+        }
+    })

compose.yaml

@@ -1,7 +1,7 @@
 services:
   foxel:
     image: ghcr.io/drizzletime/foxel:latest
-    #image: ghcr.nju.edu.cn/drizzletime/foxel:latest #国内用户可以用此镜像命令
+    #image: ghcr.nju.edu.cn/drizzletime/foxel:latest  # 国内用户可以用此镜像命令
     container_name: foxel
     restart: unless-stopped
     ports:

models/database.py

@@ -81,3 +81,29 @@ class ShareLink(Model):
 
     class Meta:
         table = "share_links"
+
+
+class Plugin(Model):
+    id = fields.IntField(pk=True)
+    url = fields.CharField(max_length=2048)
+    enabled = fields.BooleanField(default=True)
+
+    key = fields.CharField(max_length=100, null=True)
+    name = fields.CharField(max_length=255, null=True)
+    version = fields.CharField(max_length=50, null=True)
+    supported_exts = fields.JSONField(null=True)
+
+    default_bounds = fields.JSONField(null=True)
+    default_maximized = fields.BooleanField(null=True)
+
+    icon = fields.CharField(max_length=2048, null=True)
+    description = fields.TextField(null=True)
+    author = fields.CharField(max_length=255, null=True)
+    website = fields.CharField(max_length=2048, null=True)
+    github = fields.CharField(max_length=2048, null=True)
+
+    created_at = fields.DatetimeField(auto_now_add=True)
+    updated_at = fields.DatetimeField(auto_now=True)
+
+    class Meta:
+        table = "plugins"

pyproject.toml

@@ -0,0 +1,94 @@
+[project]
+name = "foxel"
+version = "0.1.0"
+description = "Add your description here"
+readme = "README.md"
+requires-python = ">=3.13"
+dependencies = [
+    "aioboto3==15.1.0",
+    "aiobotocore==2.24.0",
+    "aiofiles==24.1.0",
+    "aiohappyeyeballs==2.6.1",
+    "aiohttp==3.12.15",
+    "aioitertools==0.12.0",
+    "aiosignal==1.4.0",
+    "aiosqlite==0.21.0",
+    "annotated-types==0.7.0",
+    "anyio==4.10.0",
+    "asyncclick==8.2.2.2",
+    "attrs==25.3.0",
+    "bcrypt==4.3.0",
+    "boto3==1.39.11",
+    "botocore==1.39.11",
+    "certifi==2025.8.3",
+    "click==8.2.1",
+    "dictdiffer==0.9.0",
+    "dnspython==2.7.0",
+    "email-validator==2.2.0",
+    "fastapi==0.116.1",
+    "fastapi-cli==0.0.8",
+    "fastapi-cloud-cli==0.1.5",
+    "frozenlist==1.7.0",
+    "grpcio==1.74.0",
+    "h11==0.16.0",
+    "httpcore==1.0.9",
+    "httptools==0.6.4",
+    "httpx==0.28.1",
+    "idna==3.10",
+    "imageio==2.37.0",
+    "iso8601==2.1.0",
+    "jinja2==3.1.6",
+    "jmespath==1.0.1",
+    "markdown-it-py==4.0.0",
+    "markupsafe==3.0.2",
+    "mdurl==0.1.2",
+    "milvus-lite==2.5.1",
+    "multidict==6.6.4",
+    "numpy==2.3.2",
+    "pandas==2.3.1",
+    "passlib==1.7.4",
+    "pillow==11.3.0",
+    "propcache==0.3.2",
+    "protobuf==6.32.0",
+    "pyaes==1.6.1",
+    "pyasn1==0.6.1",
+    "pydantic==2.11.7",
+    "pydantic-core==2.33.2",
+    "pygments==2.19.2",
+    "pyjwt==2.10.1",
+    "pymilvus==2.6.0",
+    "pypika-tortoise==0.6.1",
+    "pysocks==1.7.1",
+    "python-dateutil==2.9.0.post0",
+    "python-dotenv==1.1.1",
+    "python-multipart==0.0.20",
+    "pytz==2025.2",
+    "pyyaml==6.0.2",
+    "rawpy==0.25.1",
+    "rich==14.1.0",
+    "rich-toolkit==0.15.0",
+    "rignore==0.6.4",
+    "rsa==4.9.1",
+    "s3transfer==0.13.1",
+    "sentry-sdk==2.35.0",
+    "setuptools==80.9.0",
+    "shellingham==1.5.4",
+    "six==1.17.0",
+    "sniffio==1.3.1",
+    "starlette==0.47.2",
+    "telethon==1.40.0",
+    "tortoise-orm==0.25.1",
+    "tqdm==4.67.1",
+    "typer==0.16.0",
+    "typing-extensions==4.14.1",
+    "typing-inspection==0.4.1",
+    "tzdata==2025.2",
+    "ujson==5.10.0",
+    "urllib3==2.5.0",
+    "uvicorn==0.35.0",
+    "uvloop==0.21.0",
+    "watchfiles==1.1.0",
+    "websockets==15.0.1",
+    "wrapt==1.17.3",
+    "yarl==1.20.1",
+]

requirements.txt

@@ -1,86 +0,0 @@
-aioboto3==15.1.0
-aiobotocore==2.24.0
-aiofiles==24.1.0
-aiohappyeyeballs==2.6.1
-aiohttp==3.12.15
-aioitertools==0.12.0
-aiosignal==1.4.0
-aiosqlite==0.21.0
-annotated-types==0.7.0
-anyio==4.10.0
-asyncclick==8.2.2.2
-attrs==25.3.0
-bcrypt==4.3.0
-boto3==1.39.11
-botocore==1.39.11
-certifi==2025.8.3
-click==8.2.1
-dictdiffer==0.9.0
-dnspython==2.7.0
-email_validator==2.2.0
-fastapi==0.116.1
-fastapi-cli==0.0.8
-fastapi-cloud-cli==0.1.5
-frozenlist==1.7.0
-grpcio==1.74.0
-h11==0.16.0
-httpcore==1.0.9
-httptools==0.6.4
-httpx==0.28.1
-idna==3.10
-imageio==2.37.0
-iso8601==2.1.0
-Jinja2==3.1.6
-jmespath==1.0.1
-markdown-it-py==4.0.0
-MarkupSafe==3.0.2
-mdurl==0.1.2
-milvus-lite==2.5.1
-multidict==6.6.4
-numpy==2.3.2
-pandas==2.3.1
-passlib==1.7.4
-pillow==11.3.0
-propcache==0.3.2
-protobuf==6.32.0
-pyaes==1.6.1
-pyasn1==0.6.1
-pydantic==2.11.7
-pydantic_core==2.33.2
-Pygments==2.19.2
-PyJWT==2.10.1
-pymilvus==2.6.0
-pypika-tortoise==0.6.1
-PySocks==1.7.1
-python-dateutil==2.9.0.post0
-python-dotenv==1.1.1
-python-multipart==0.0.20
-pytz==2025.2
-PyYAML==6.0.2
-rawpy==0.25.1
-rich==14.1.0
-rich-toolkit==0.15.0
-rignore==0.6.4
-rsa==4.9.1
-s3transfer==0.13.1
-sentry-sdk==2.35.0
-setuptools==80.9.0
-shellingham==1.5.4
-six==1.17.0
-sniffio==1.3.1
-starlette==0.47.2
-Telethon==1.40.0
-tortoise-orm==0.25.1
-tqdm==4.67.1
-typer==0.16.0
-typing-inspection==0.4.1
-typing_extensions==4.14.1
-tzdata==2025.2
-ujson==5.10.0
-urllib3==2.5.0
-uvicorn==0.35.0
-uvloop==0.21.0
-watchfiles==1.1.0
-websockets==15.0.1
-wrapt==1.17.3
-yarl==1.20.1

schemas/__init__.py

@@ -1,7 +1,10 @@
+from schemas.plugins import PluginCreate,PluginOut
 from .adapters import AdapterCreate, AdapterOut
 from .fs import MkdirRequest, MoveRequest
 
 __all__ = [
+    "PluginOut"
+    "PluginCreate"
     "AdapterCreate",
     "AdapterOut",
     "MkdirRequest",

schemas/plugins.py

@@ -0,0 +1,27 @@
+from typing import List, Optional, Dict, Any
+from pydantic import BaseModel, Field
+
+
+class PluginCreate(BaseModel):
+    url: str = Field(min_length=1)
+    enabled: bool = True
+
+
+class PluginOut(BaseModel):
+    id: int
+    url: str
+    enabled: bool
+    key: Optional[str]
+    name: Optional[str]
+    version: Optional[str]
+    supported_exts: Optional[List[str]]
+    default_bounds: Optional[Dict[str, Any]]
+    default_maximized: Optional[bool]
+    icon: Optional[str]
+    description: Optional[str]
+    author: Optional[str]
+    website: Optional[str]
+    github: Optional[str]
+
+    class Config:
+        from_attributes = True

services/adapters/base.py

@@ -10,7 +10,7 @@ from models import StorageAdapter
 @runtime_checkable
 class BaseAdapter(Protocol):
     record: StorageAdapter
-    async def list_dir(self, root: str, rel: str, page_num: int = 1, page_size: int = 50) -> Tuple[List[Dict], int]: ...
+    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]: ...
     async def read_file(self, root: str, rel: str) -> bytes: ...
     async def write_file(self, root: str, rel: str, data: bytes): ...
     async def write_file_stream(self, root: str, rel: str, data_iter: AsyncIterator[bytes]): ... 

services/adapters/local.py

@@ -46,25 +46,18 @@ class LocalAdapter:
             return str(Path(root) / sub_path)
         return root
 
-    async def list_dir(self, root: str, rel: str, page_num: int = 1, page_size: int = 50) -> Tuple[List[Dict], int]:
+    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]:
         rel = rel.strip('/')
         base = _safe_join(root, rel) if rel else Path(root)
         if not base.exists():
             return [], 0
         if not base.is_dir():
             raise NotADirectoryError(rel)
-        
-        # 获取所有文件名并排序
-        all_names = await asyncio.to_thread(lambda: sorted(os.listdir(base), key=str.lower))
-        total_count = len(all_names)
-        
-        # 计算分页范围
-        start_idx = (page_num - 1) * page_size
-        end_idx = start_idx + page_size
-        page_names = all_names[start_idx:end_idx]
+
+        all_names = await asyncio.to_thread(os.listdir, base)
         
         entries = []
-        for name in page_names:
+        for name in all_names:
             fp = base / name
             try:
                 st = await asyncio.to_thread(fp.stat)
@@ -79,10 +72,35 @@ class LocalAdapter:
                 "mode": stat.S_IMODE(st.st_mode),
                 "type": "dir" if is_dir else "file",
             })
+
+        # 排序
+        reverse = sort_order.lower() == "desc"
         
-        # 按目录优先排序
-        entries.sort(key=lambda x: (not x["is_dir"], x["name"].lower()))
-        return entries, total_count
+        def get_sort_key(item):
+            # 基础排序键，目录优先
+            key = (not item["is_dir"],)
+            sort_field = sort_by.lower()
+            
+            if sort_field == "name":
+                key += (item["name"].lower(),)
+            elif sort_field == "size":
+                key += (item["size"],)
+            elif sort_field == "mtime":
+                key += (item["mtime"],)
+            else: # 默认按名称
+                key += (item["name"].lower(),)
+            return key
+
+        entries.sort(key=get_sort_key, reverse=reverse)
+        
+        total_count = len(entries)
+        
+        # 分页
+        start_idx = (page_num - 1) * page_size
+        end_idx = start_idx + page_size
+        page_entries = entries[start_idx:end_idx]
+        
+        return page_entries, total_count
 
     async def read_file(self, root: str, rel: str) -> bytes:
         fp = _safe_join(root, rel)

services/adapters/onedrive.py

@@ -63,7 +63,7 @@ class OneDriveAdapter:
             "refresh_token": self.refresh_token,
             "grant_type": "refresh_token",
         }
-        async with httpx.AsyncClient() as client:
+        async with httpx.AsyncClient(timeout=20.0) as client:
             resp = await client.post(MS_OAUTH_URL, data=data)
             resp.raise_for_status()
             token_data = resp.json()
@@ -90,11 +90,10 @@ class OneDriveAdapter:
             headers.update(kwargs.pop("headers"))
 
         url = full_url if full_url else f"{MS_GRAPH_URL}/me/drive/root{api_path_segment}"
-        async with httpx.AsyncClient() as client:
+        async with httpx.AsyncClient(timeout=60.0) as client:
             resp = await client.request(method, url, headers=headers, **kwargs)
-            # 如果 token 过期 (401)，刷新并重试一次
             if resp.status_code == 401:
-                self._access_token = None  # 强制刷新
+                self._access_token = None
                 token = await self._get_access_token()
                 headers["Authorization"] = f"Bearer {token}"
                 resp = await client.request(method, url, headers=headers, **kwargs)
@@ -115,25 +114,23 @@ class OneDriveAdapter:
             "type": "dir" if is_dir else "file",
         }
 
-    async def list_dir(self, root: str, rel: str, page_num: int = 1, page_size: int = 50) -> Tuple[List[Dict], int]:
+    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]:
         """
         列出目录内容。
+        由于 Graph API 不支持基于偏移($skip)的分页，此方法将获取所有项目，
         :param root: 根路径 (在此适配器中未使用，通过配置的 root 确定)。
         :param rel: 相对路径。
         :param page_num: 页码。
         :param page_size: 每页大小。
+        :param sort_by: 排序字段
+        :param sort_order: 排序顺序
         :return: 文件/目录列表和总数。
         """
         api_path = self._get_api_path(rel)
         children_path = f"{api_path}:/children" if api_path else "/children"
-
-        # Graph API 的分页是基于 @odata.nextLink token 的。
-        # 为了支持自定义排序（文件夹在前），我们必须获取所有项目，
-        # 然后在内存中进行排序和分页。此版本通过处理分页链接来稳健地获取所有项目。
         all_items = []
-
-        # 初始请求
-        resp = await self._request("GET", api_path_segment=children_path, params={"$top": 200})
+        params = {"$top": 999}
+        resp = await self._request("GET", api_path_segment=children_path, params=params)
 
         while True:
             if resp.status_code == 404 and not all_items:
@@ -151,13 +148,25 @@ class OneDriveAdapter:
             if not next_link:
                 break
 
-            # 后续分页请求
             resp = await self._request("GET", full_url=next_link)
 
         formatted_items = [self._format_item(item) for item in all_items]
-        # 排序：文件夹在前，然后按名称排序
-        formatted_items.sort(key=lambda x: (
-            not x["is_dir"], x["name"].lower()))
+        
+        # 排序
+        reverse = sort_order.lower() == "desc"
+        def get_sort_key(item):
+            key = (not item["is_dir"],)
+            sort_field = sort_by.lower()
+            if sort_field == "name":
+                key += (item["name"].lower(),)
+            elif sort_field == "size":
+                key += (item["size"],)
+            elif sort_field == "mtime":
+                key += (item["mtime"],)
+            else:
+                key += (item["name"].lower(),)
+            return key
+        formatted_items.sort(key=get_sort_key, reverse=reverse)
 
         total_count = len(formatted_items)
         start_idx = (page_num - 1) * page_size
@@ -362,7 +371,7 @@ class OneDriveAdapter:
 
         async def file_iterator():
             nonlocal start, end
-            async with httpx.AsyncClient() as client:
+            async with httpx.AsyncClient(timeout=60.0) as client:
                 req_headers = {'Range': f'bytes={start}-{end}'}
                 async with client.stream("GET", download_url, headers=req_headers) as stream_resp:
                     stream_resp.raise_for_status()
@@ -389,7 +398,7 @@ class OneDriveAdapter:
             resp = await self._request("GET", api_path_segment=thumb_path)
             if resp.status_code == 200:
                 thumb_data = resp.json()
-                async with httpx.AsyncClient() as client:
+                async with httpx.AsyncClient(timeout=30.0) as client:
                     thumb_resp = await client.get(thumb_data['url'])
                     thumb_resp.raise_for_status()
                     return thumb_resp.content

services/adapters/quark.py

@@ -0,0 +1,724 @@
+from __future__ import annotations
+import asyncio
+import base64
+import hashlib
+import mimetypes
+import os
+import time
+from typing import Dict, List, Tuple, Optional, AsyncIterator, Any
+
+import httpx
+from fastapi import HTTPException
+from fastapi.responses import StreamingResponse
+
+from models import StorageAdapter
+from .base import BaseAdapter
+
+
+# Quark 普通(UC)接口
+API_BASE = "https://drive.quark.cn/1/clouddrive"
+REFERER = "https://pan.quark.cn"
+PR = "ucpro"
+
+
+class QuarkAdapter:
+    """夸克网盘（Cookie 模式）
+
+    - 使用浏览器导出的 Cookie 进行鉴权
+    - 通过 Quark/UC 的 clouddrive 接口实现：列目录、读写、分片上传、基础操作
+    - 根 FID 固定为 "0"；路径解析通过名称遍历
+    """
+
+    def __init__(self, record: StorageAdapter):
+        self.record = record
+        cfg = record.config or {}
+        self.cookie: str = cfg.get("cookie") or cfg.get("Cookie")
+        self.root_fid: str = cfg.get("root_fid", "0")
+        self.use_transcoding_address: bool = bool(cfg.get("use_transcoding_address", False))
+        self.only_list_video_file: bool = bool(cfg.get("only_list_video_file", False))
+
+        if not self.cookie:
+            raise ValueError("Quark 适配器需要 cookie 配置")
+
+        # 运行期缓存
+        self._dir_fid_cache: Dict[str, str] = {f"{self.root_fid}:": self.root_fid}
+        self._children_cache: Dict[str, List[Dict[str, Any]]] = {}
+
+        # UA 与超时
+        self._ua = (
+            "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 "
+            "(KHTML, like Gecko) quark-cloud-drive/2.5.20 Chrome/100.0.4896.160 "
+            "Electron/18.3.5.4-b478491100 Safari/537.36 Channel/pckk_other_ch"
+        )
+        self._timeout = 30.0
+
+    # -----------------
+    # 工具与通用请求
+    # -----------------
+    def get_effective_root(self, sub_path: str | None) -> str:
+        return self.root_fid
+
+    async def _request(
+        self,
+        method: str,
+        pathname: str,
+        *,
+        json: Any | None = None,
+        params: Dict[str, str] | None = None,
+    ) -> Any:
+        headers = {
+            "Cookie": self._safe_cookie(self.cookie),
+            "Accept": "application/json, text/plain, */*",
+            "Referer": REFERER,
+            "User-Agent": self._ua,
+        }
+        query = {"pr": PR, "fr": "pc"}
+        if params:
+            query.update(params)
+        url = f"{API_BASE}{pathname}"
+
+        async with httpx.AsyncClient(timeout=self._timeout) as client:
+            resp = await client.request(method, url, headers=headers, params=query, json=json)
+            # 更新运行期 cookie（若返回 __puus/__pus）
+            try:
+                for key in ("__puus", "__pus"):
+                    v = resp.cookies.get(key)
+                    if v:
+                        # 简单替换/追加到 self.cookie
+                        self._set_cookie_kv(key, v)
+            except Exception:
+                pass
+
+            # 解析业务状态
+            data = None
+            try:
+                data = resp.json()
+            except Exception:
+                resp.raise_for_status()
+                return resp
+            status = data.get("status")
+            code = data.get("code")
+            msg = data.get("message") or ""
+            if (status is not None and status >= 400) or (code is not None and code != 0):
+                raise HTTPException(502, detail=f"Quark error status={status} code={code} msg={msg}")
+            return data
+
+    def _set_cookie_kv(self, key: str, value: str):
+        # 将指定键值写入 self.cookie（粗略字符串处理）
+        parts = [p.strip() for p in (self.cookie or "").replace("\r", "").replace("\n", "").split(";") if p.strip()]
+        found = False
+        for i, p in enumerate(parts):
+            if p.startswith(key + "="):
+                parts[i] = f"{key}={value}"
+                found = True
+                break
+        if not found:
+            parts.append(f"{key}={value}")
+        self.cookie = "; ".join(parts)
+
+    def _sanitize_cookie(self, cookie: str) -> str:
+        if not cookie:
+            return ""
+        # 去除换行与前后空白
+        cookie = cookie.replace("\r", "").replace("\n", "").strip()
+        # 统一分号分隔并去除多余空格/空段
+        parts = [p.strip() for p in cookie.split(";") if p.strip()]
+        return "; ".join(parts)
+
+    def _safe_cookie(self, cookie: str) -> str:
+        s = self._sanitize_cookie(cookie)
+        # 仅保留可见 ASCII (0x20-0x7E)
+        s = "".join(ch for ch in s if 32 <= ord(ch) <= 126)
+        return s
+
+    # -----------------
+    # 列表与路径解析
+    # -----------------
+    def _map_file_item(self, it: Dict[str, Any]) -> Dict[str, Any]:
+        # Quark/UC 列表项：file=true 表示文件；false 表示目录
+        is_dir = not bool(it.get("file", False))
+        updated_at_ms = int(it.get("updated_at", 0) or 0)
+        name = it.get("file_name") or it.get("filename") or it.get("name")
+        return {
+            "fid": it.get("fid"),
+            "name": name,
+            "is_dir": is_dir,
+            "size": 0 if is_dir else int(it.get("size", 0) or 0),
+            "mtime": updated_at_ms // 1000 if updated_at_ms else 0,
+            "type": "dir" if is_dir else "file",
+        }
+
+    async def _list_children(self, parent_fid: str) -> List[Dict[str, Any]]:
+        if parent_fid in self._children_cache:
+            return self._children_cache[parent_fid]
+
+        files: List[Dict[str, Any]] = []
+        page = 1
+        size = 100
+        total = None
+        while True:
+            qp = {"pdir_fid": parent_fid, "_size": str(size), "_page": str(page), "_fetch_total": "1"}
+            data = await self._request("GET", "/file/sort", params=qp)
+            d = (data or {}).get("data", {})
+            meta = (data or {}).get("metadata", {})
+            page_files = d.get("list", [])
+            files.extend(page_files)
+            if total is None:
+                total = meta.get("_total") or meta.get("total") or 0
+            if page * size >= int(total):
+                break
+            page += 1
+
+        mapped = [self._map_file_item(x) for x in files if (not self.only_list_video_file) or (not x.get("file")) or (x.get("category") == 1)]
+        self._children_cache[parent_fid] = mapped
+        return mapped
+
+    def _dir_cache_key(self, base_fid: str, rel: str) -> str:
+        return f"{base_fid}:{rel.strip('/')}"
+
+    async def _resolve_dir_fid_from(self, base_fid: str, rel: str) -> str:
+        key = rel.strip("/")
+        cache_key = self._dir_cache_key(base_fid, key)
+        if cache_key in self._dir_fid_cache:
+            return self._dir_fid_cache[cache_key]
+        if key == "":
+            self._dir_fid_cache[cache_key] = base_fid
+            return base_fid
+
+        parent_fid = base_fid
+        path_so_far = []
+        for seg in key.split("/"):
+            if seg == "":
+                continue
+            path_so_far.append(seg)
+            cache_key = self._dir_cache_key(base_fid, "/".join(path_so_far))
+            cached = self._dir_fid_cache.get(cache_key)
+            if cached:
+                parent_fid = cached
+                continue
+            children = await self._list_children(parent_fid)
+            found = next((c for c in children if c["is_dir"] and c["name"] == seg), None)
+            if not found:
+                raise FileNotFoundError(f"Directory not found: {seg}")
+            parent_fid = found["fid"]
+            self._dir_fid_cache[cache_key] = parent_fid
+
+        return parent_fid
+
+    async def _find_child(self, parent_fid: str, name: str) -> Optional[Dict[str, Any]]:
+        children = await self._list_children(parent_fid)
+        for it in children:
+            if it["name"] == name:
+                return it
+        return None
+
+    def _invalidate_children_cache(self, parent_fid: str):
+        if parent_fid in self._children_cache:
+            try:
+                del self._children_cache[parent_fid]
+            except Exception:
+                pass
+
+    # -----------------
+    # 目录与文件列表
+    # -----------------
+    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]:
+        base_fid = root or self.root_fid
+        fid = await self._resolve_dir_fid_from(base_fid, rel)
+        items = await self._list_children(fid)
+
+        # 排序，目录优先
+        reverse = sort_order.lower() == "desc"
+
+        def get_sort_key(item):
+            key = (not item["is_dir"],)
+            sf = sort_by.lower()
+            if sf == "name":
+                key += (item["name"].lower(),)
+            elif sf == "size":
+                key += (item["size"],)
+            elif sf == "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 _get_download_url(self, fid: str) -> str:
+        data = await self._request("POST", "/file/download", json={"fids": [fid]})
+        arr = (data or {}).get("data", [])
+        if not arr:
+            raise HTTPException(502, detail="No download data returned by Quark")
+        url = arr[0].get("download_url") or arr[0].get("DownloadUrl")
+        if not url:
+            raise HTTPException(502, detail="No download_url returned by Quark")
+        return url
+
+    async def _get_transcoding_url(self, fid: str) -> Optional[str]:
+        try:
+            payload = {"fid": fid, "resolutions": "low,normal,high,super,2k,4k", "supports": "fmp4_av,m3u8,dolby_vision"}
+            data = await self._request("POST", "/file/v2/play/project", json=payload)
+            lst = (data or {}).get("data", {}).get("video_list", [])
+            for item in lst:
+                vi = item.get("video_info") or {}
+                url = vi.get("url")
+                if url:
+                    return url
+        except Exception:
+            return None
+        return None
+
+    def _is_video_name(self, name: str) -> bool:
+        mime, _ = mimetypes.guess_type(name)
+        return bool(mime and mime.startswith("video/"))
+
+    def _download_headers(self) -> Dict[str, str]:
+        return {"Cookie": self._safe_cookie(self.cookie), "User-Agent": self._ua, "Referer": REFERER}
+
+    async def read_file(self, root: str, rel: str) -> 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 = self._download_headers()
+        async with httpx.AsyncClient(timeout=None, follow_redirects=True) as client:
+            resp = await client.get(url, headers=headers)
+            if resp.status_code == 404:
+                raise FileNotFoundError(rel)
+            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")
+        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"])
+        if self.use_transcoding_address and self._is_video_name(name):
+            tr = await self._get_transcoding_url(it["fid"]) 
+            if tr:
+                url = tr
+        dl_headers = self._download_headers()
+
+        # 预获取大小/是否支持范围
+        total_size: Optional[int] = None
+        async with httpx.AsyncClient(timeout=self._timeout, follow_redirects=True) as client:
+            try:
+                head_resp = await client.head(url, headers=dl_headers)
+                if head_resp.status_code == 200:
+                    cl = head_resp.headers.get("Content-Length")
+                    if cl and cl.isdigit():
+                        total_size = int(cl)
+            except Exception:
+                pass
+
+        mime, _ = mimetypes.guess_type(rel)
+        content_type = mime or "application/octet-stream"
+
+        # 解析 Range
+        start = 0
+        end: Optional[int] = None
+        status_code = 200
+        if range_header and range_header.startswith("bytes="):
+            status_code = 206
+            part = range_header.split("=", 1)[1]
+            s, e = part.split("-", 1)
+            if s.strip():
+                start = int(s)
+            if e.strip():
+                end = int(e)
+
+        if total_size is not None and end is None and status_code == 206:
+            end = total_size - 1
+        if end is not None and total_size is not None and end >= total_size:
+            end = total_size - 1
+        if total_size is not None and start >= total_size:
+            raise HTTPException(416, detail="Requested Range Not Satisfiable")
+
+        resp_headers: Dict[str, str] = {"Accept-Ranges": "bytes", "Content-Type": content_type}
+        if status_code == 206 and total_size is not None and end is not None:
+            resp_headers["Content-Range"] = f"bytes {start}-{end}/{total_size}"
+            resp_headers["Content-Length"] = str(end - start + 1)
+        elif total_size is not None:
+            resp_headers["Content-Length"] = str(total_size)
+
+        async def iterator():
+            headers = dict(dl_headers)
+            if status_code == 206 and end is not None:
+                headers["Range"] = f"bytes={start}-{end}"
+            async with httpx.AsyncClient(timeout=None, follow_redirects=True) as client:
+                async with client.stream("GET", url, headers=headers) as resp:
+                    if resp.status_code in (404, 416):
+                        await resp.aclose()
+                        raise HTTPException(resp.status_code, detail="Upstream not available")
+                    async for chunk in resp.aiter_bytes():
+                        if chunk:
+                            yield chunk
+
+        return StreamingResponse(iterator(), status_code=status_code, headers=resp_headers, media_type=content_type)
+
+    # -----------------
+    # 上传（大文件分片）
+    # -----------------
+    @staticmethod
+    def _md5_hex(b: bytes) -> str:
+        return hashlib.md5(b).hexdigest()
+
+    @staticmethod
+    def _sha1_hex(b: bytes) -> str:
+        return hashlib.sha1(b).hexdigest()
+
+    def _guess_mime(self, name: str) -> str:
+        mime, _ = mimetypes.guess_type(name)
+        return mime or "application/octet-stream"
+
+    async def _upload_pre(self, filename: str, size: int, parent_fid: str) -> Dict[str, Any]:
+        now_ms = int(time.time() * 1000)
+        body = {
+            "ccp_hash_update": True,
+            "dir_name": "",
+            "file_name": filename,
+            "format_type": self._guess_mime(filename),
+            "l_created_at": now_ms,
+            "l_updated_at": now_ms,
+            "pdir_fid": parent_fid,
+            "size": size,
+        }
+        data = await self._request("POST", "/file/upload/pre", json=body)
+        return data
+
+    async def write_file(self, root: str, rel: str, data: bytes):
+        async def gen():
+            yield data
+        return await self.write_file_stream(root, rel, gen())
+
+    async def write_file_stream(self, root: str, rel: str, data_iter: AsyncIterator[bytes]):
+        if not rel or rel.endswith("/"):
+            raise HTTPException(400, detail="Invalid file path")
+
+        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)
+
+        # 将数据落盘到临时文件，同时计算 MD5/SHA1
+        import tempfile
+
+        md5 = hashlib.md5()
+        sha1 = hashlib.sha1()
+        total = 0
+        with tempfile.NamedTemporaryFile(delete=False) as tf:
+            tmp_path = tf.name
+            try:
+                async for chunk in data_iter:
+                    if not chunk:
+                        continue
+                    total += len(chunk)
+                    md5.update(chunk)
+                    sha1.update(chunk)
+                    tf.write(chunk)
+            finally:
+                tf.flush()
+
+        md5_hex = md5.hexdigest()
+        sha1_hex = sha1.hexdigest()
+
+        # 预上传，拿到上传信息
+        pre_resp = await self._upload_pre(name, total, parent_fid)
+        pre_data = pre_resp.get("data", {})
+
+        # hash 秒传
+        hash_body = {"md5": md5_hex, "sha1": sha1_hex, "task_id": pre_data.get("task_id")}
+        hash_resp = await self._request("POST", "/file/update/hash", json=hash_body)
+        if (hash_resp.get("data") or {}).get("finish") is True:
+            try:
+                os.unlink(tmp_path)
+            except Exception:
+                pass
+            # 刷新父目录缓存
+            self._invalidate_children_cache(parent_fid)
+            return total
+
+        # 分片上传
+        part_size = int((pre_resp.get("metadata") or {}).get("part_size") or 0)
+        if part_size <= 0:
+            raise HTTPException(502, detail="Invalid part_size from Quark")
+
+        bucket = pre_data.get("bucket")
+        obj_key = pre_data.get("obj_key")
+        upload_id = pre_data.get("upload_id")
+        upload_url = pre_data.get("upload_url")
+        if not (bucket and obj_key and upload_id and upload_url):
+            raise HTTPException(502, detail="Upload pre missing fields")
+
+        # 计算 host 与基础 URL
+        try:
+            upload_host = upload_url.split("://", 1)[1]
+        except Exception:
+            upload_host = upload_url
+        base_url = f"https://{bucket}.{upload_host}/{obj_key}"
+
+        # 分片循环
+        etags: List[str] = []
+        oss_ua = "aliyun-sdk-js/6.6.1 Chrome 98.0.4758.80 on Windows 10 64-bit"
+        async with httpx.AsyncClient(timeout=None, follow_redirects=True) as client:
+            with open(tmp_path, "rb") as rf:
+                part_number = 1
+                left = total
+                while left > 0:
+                    sz = min(part_size, left)
+                    data_bytes = rf.read(sz)
+                    if len(data_bytes) != sz:
+                        raise IOError("Failed to read part bytes")
+                    now_str = time.strftime("%a, %d %b %Y %H:%M:%S GMT", time.gmtime())
+                    # 申请签名
+                    auth_meta = (
+                        "PUT\n\n"
+                        f"{self._guess_mime(name)}\n"
+                        f"{now_str}\n"
+                        f"x-oss-date:{now_str}\n"
+                        f"x-oss-user-agent:{oss_ua}\n"
+                        f"/{bucket}/{obj_key}?partNumber={part_number}&uploadId={upload_id}"
+                    )
+                    auth_req_body = {"auth_info": pre_data.get("auth_info"), "auth_meta": auth_meta, "task_id": pre_data.get("task_id")}
+                    auth_resp = await self._request("POST", "/file/upload/auth", json=auth_req_body)
+                    auth_key = (auth_resp.get("data") or {}).get("auth_key")
+                    if not auth_key:
+                        raise HTTPException(502, detail="upload/auth missing auth_key")
+
+                    put_headers = {
+                        "Authorization": auth_key,
+                        "Content-Type": self._guess_mime(name),
+                        "Referer": REFERER + "/",
+                        "x-oss-date": now_str,
+                        "x-oss-user-agent": oss_ua,
+                    }
+                    put_url = f"{base_url}?partNumber={part_number}&uploadId={upload_id}"
+                    put_resp = await client.put(put_url, headers=put_headers, content=data_bytes)
+                    if put_resp.status_code != 200:
+                        raise HTTPException(502, detail=f"Upload part failed status={put_resp.status_code} text={put_resp.text}")
+                    etag = put_resp.headers.get("Etag", "")
+                    etags.append(etag)
+                    left -= sz
+                    part_number += 1
+
+        # 组合 commit xml
+        parts_xml = [f"<Part>\n<PartNumber>{i+1}</PartNumber>\n<ETag>{etags[i]}</ETag>\n</Part>\n" for i in range(len(etags))]
+        body_xml = "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<CompleteMultipartUpload>\n" + "".join(parts_xml) + "</CompleteMultipartUpload>"
+        content_md5 = base64.b64encode(hashlib.md5(body_xml.encode("utf-8")).digest()).decode("ascii")
+        callback = pre_data.get("callback") or {}
+        try:
+            import json as _json
+            callback_b64 = base64.b64encode(_json.dumps(callback).encode("utf-8")).decode("ascii")
+        except Exception:
+            callback_b64 = ""
+
+        now_str = time.strftime("%a, %d %b %Y %H:%M:%S GMT", time.gmtime())
+        auth_meta_commit = (
+            "POST\n"
+            f"{content_md5}\n"
+            "application/xml\n"
+            f"{now_str}\n"
+            f"x-oss-callback:{callback_b64}\n"
+            f"x-oss-date:{now_str}\n"
+            f"x-oss-user-agent:{oss_ua}\n"
+            f"/{bucket}/{obj_key}?uploadId={upload_id}"
+        )
+        auth_commit_resp = await self._request("POST", "/file/upload/auth", json={"auth_info": pre_data.get("auth_info"), "auth_meta": auth_meta_commit, "task_id": pre_data.get("task_id")})
+        auth_key_commit = (auth_commit_resp.get("data") or {}).get("auth_key")
+        if not auth_key_commit:
+            raise HTTPException(502, detail="upload/auth(commit) missing auth_key")
+
+        async with httpx.AsyncClient(timeout=None, follow_redirects=True) as client:
+            commit_headers = {
+                "Authorization": auth_key_commit,
+                "Content-MD5": content_md5,
+                "Content-Type": "application/xml",
+                "Referer": REFERER + "/",
+                "x-oss-callback": callback_b64,
+                "x-oss-date": now_str,
+                "x-oss-user-agent": oss_ua,
+            }
+            commit_url = f"{base_url}?uploadId={upload_id}"
+            r = await client.post(commit_url, headers=commit_headers, content=body_xml.encode("utf-8"))
+            if r.status_code != 200:
+                raise HTTPException(502, detail=f"Upload commit failed status={r.status_code} text={r.text}")
+
+        # finish
+        await self._request("POST", "/file/upload/finish", json={"obj_key": obj_key, "task_id": pre_data.get("task_id")})
+        # 端合并存在轻微延迟，等待再刷新缓存
+        try:
+            await asyncio.sleep(1.0)
+        except Exception:
+            pass
+
+        try:
+            os.unlink(tmp_path)
+        except Exception:
+            pass
+        # 失效父目录缓存，确保后续列表可见
+        self._invalidate_children_cache(parent_fid)
+        return total
+
+    # -----------------
+    # 基本文件操作
+    # -----------------
+    async def mkdir(self, root: str, rel: str):
+        if not rel or rel == "/":
+            raise HTTPException(400, detail="Cannot create root")
+        parent = rel.rstrip("/")
+        parent_rel, name = (parent.rsplit("/", 1) if "/" in parent else ("", parent))
+        if not name:
+            raise HTTPException(400, detail="Invalid directory name")
+        pdir = await self._resolve_dir_fid_from(root or self.root_fid, parent_rel)
+        await self._request("POST", "/file", json={"dir_init_lock": False, "dir_path": "", "file_name": name, "pdir_fid": pdir})
+        self._invalidate_children_cache(pdir)
+
+    async def delete(self, root: str, rel: str):
+        # 解析对象 fid + 父目录，用于失效缓存
+        base_fid = root or self.root_fid
+        if rel == "" or rel.endswith("/"):
+            parent_rel = rel.rstrip("/")
+            target_fid = await self._resolve_dir_fid_from(base_fid, parent_rel)
+            parent_of_target = await self._resolve_dir_fid_from(base_fid, (parent_rel.rsplit("/", 1)[0] if "/" in parent_rel else ""))
+        else:
+            parent_rel, name = (rel.rsplit("/", 1) if "/" in rel else ("", rel))
+            parent_of_target = await self._resolve_dir_fid_from(base_fid, parent_rel)
+            it = await self._find_child(parent_of_target, name)
+            if not it:
+                return
+            target_fid = it["fid"]
+        await self._request("POST", "/file/delete", json={"action_type": 1, "exclude_fids": [], "filelist": [target_fid]})
+        self._invalidate_children_cache(parent_of_target)
+
+    async def move(self, root: str, src_rel: str, dst_rel: str):
+        # 支持跨目录与重命名：先移动到父目录，后重命名（若需要）
+        src_parent_rel, src_name = (src_rel.rsplit("/", 1) if "/" in src_rel else ("", src_rel))
+        dst_parent_rel, dst_name = (dst_rel.rsplit("/", 1) if "/" in dst_rel else ("", dst_rel))
+
+        base_fid = root or self.root_fid
+        src_parent_fid = await self._resolve_dir_fid_from(base_fid, src_parent_rel)
+        obj = await self._find_child(src_parent_fid, src_name)
+        if not obj:
+            raise FileNotFoundError(src_rel)
+        dst_parent_fid = await self._resolve_dir_fid_from(base_fid, dst_parent_rel)
+
+        if src_parent_fid != dst_parent_fid:
+            await self._request("POST", "/file/move", json={"action_type": 1, "exclude_fids": [], "filelist": [obj["fid"]], "to_pdir_fid": dst_parent_fid})
+            self._invalidate_children_cache(src_parent_fid)
+            self._invalidate_children_cache(dst_parent_fid)
+
+        if obj["name"] != dst_name:
+            await self._request("POST", "/file/rename", json={"fid": obj["fid"], "file_name": dst_name})
+            self._invalidate_children_cache(dst_parent_fid)
+
+    async def rename(self, root: str, src_rel: str, dst_rel: str):
+        src_parent_rel, src_name = (src_rel.rsplit("/", 1) if "/" in src_rel else ("", src_rel))
+        base_fid = root or self.root_fid
+        src_parent_fid = await self._resolve_dir_fid_from(base_fid, src_parent_rel)
+        obj = await self._find_child(src_parent_fid, src_name)
+        if not obj:
+            raise FileNotFoundError(src_rel)
+        dst_name = dst_rel.rsplit("/", 1)[-1]
+        await self._request("POST", "/file/rename", json={"fid": obj["fid"], "file_name": dst_name})
+        self._invalidate_children_cache(src_parent_fid)
+
+    async def copy(self, root: str, src_rel: str, dst_rel: str, overwrite: bool = False):
+        raise NotImplementedError("QuarkOpen does not support copy via open API")
+
+    # -----------------
+    # STAT / EXISTS / 辅助
+    # -----------------
+    async def stat_file(self, root: str, rel: str):
+        # 通过父目录列表获取元数据
+        base_fid = root or self.root_fid
+        if rel == "" or rel.endswith("/"):
+            # 目录
+            fid = await self._resolve_dir_fid_from(base_fid, rel.rstrip("/"))
+            return {"name": rel.rstrip("/").split("/")[-1] if rel else "", "is_dir": True, "size": 0, "mtime": 0, "type": "dir", "fid": fid}
+        parent_rel, name = (rel.rsplit("/", 1) if "/" in rel else ("", rel))
+        parent_fid = await self._resolve_dir_fid_from(base_fid, parent_rel)
+        it = await self._find_child(parent_fid, name)
+        if not it:
+            raise FileNotFoundError(rel)
+        return it
+
+    async def exists(self, root: str, rel: str) -> bool:
+        try:
+            base_fid = root or self.root_fid
+            if rel == "" or rel.endswith("/"):
+                await self._resolve_dir_fid_from(base_fid, rel.rstrip("/"))
+                return True
+            parent_rel, name = (rel.rsplit("/", 1) if "/" in rel else ("", rel))
+            parent_fid = await self._resolve_dir_fid_from(base_fid, parent_rel)
+            it = await self._find_child(parent_fid, name)
+            return it is not None
+        except FileNotFoundError:
+            return False
+
+    async def stat_path(self, root: str, rel: str):
+        # 用于 move/copy 前的预检查调试
+        try:
+            base_fid = root or self.root_fid
+            if rel == "" or rel.endswith("/"):
+                fid = await self._resolve_dir_fid_from(base_fid, rel.rstrip("/"))
+                return {"exists": True, "is_dir": True, "path": rel, "fid": fid}
+            parent_rel, name = (rel.rsplit("/", 1) if "/" in rel else ("", rel))
+            parent_fid = await self._resolve_dir_fid_from(base_fid, parent_rel)
+            it = await self._find_child(parent_fid, name)
+            if it:
+                return {"exists": True, "is_dir": it["is_dir"], "path": rel, "fid": it["fid"]}
+            return {"exists": False, "is_dir": None, "path": rel}
+        except FileNotFoundError:
+            return {"exists": False, "is_dir": None, "path": rel}
+
+    async def _resolve_target_fid(self, rel: str, *, base_fid: Optional[str] = None) -> str:
+        base = base_fid or self.root_fid
+        if rel == "" or rel.endswith("/"):
+            return await self._resolve_dir_fid_from(base, rel.rstrip("/"))
+        parent_rel, name = (rel.rsplit("/", 1) if "/" in rel else ("", rel))
+        parent_fid = await self._resolve_dir_fid_from(base, parent_rel)
+        it = await self._find_child(parent_fid, name)
+        if not it:
+            raise FileNotFoundError(rel)
+        return it["fid"]
+
+
+ADAPTER_TYPE = "Quark"
+
+CONFIG_SCHEMA = [
+    {"key": "cookie", "label": "Cookie", "type": "password", "required": True, "placeholder": "从 pan.quark.cn 复制"},
+    {"key": "root_fid", "label": "根 FID", "type": "string", "required": False, "default": "0"},
+    {"key": "use_transcoding_address", "label": "视频转码直链", "type": "checkbox", "required": False, "default": False},
+    {"key": "only_list_video_file", "label": "仅列出视频文件", "type": "checkbox", "required": False, "default": False},
+]
+
+def ADAPTER_FACTORY(rec: StorageAdapter) -> BaseAdapter:
+    return QuarkAdapter(rec)

services/adapters/registry.py

@@ -78,6 +78,31 @@ class RuntimeRegistry:
     def snapshot(self) -> Dict[int, BaseAdapter]:
         return dict(self._instances)
 
+    def remove(self, adapter_id: int):
+        """从缓存中移除一个适配器实例"""
+        if adapter_id in self._instances:
+            del self._instances[adapter_id]
+
+    async def upsert(self, rec: StorageAdapter):
+        """新增或更新一个适配器实例"""
+        if not rec.enabled:
+            self.remove(rec.id)
+            return
+        
+        factory = TYPE_MAP.get(rec.type)
+        if not factory:
+            discover_adapters()
+            factory = TYPE_MAP.get(rec.type)
+            if not factory:
+                return
+
+        try:
+            instance = factory(rec)
+            self._instances[rec.id] = instance
+        except Exception:
+            self.remove(rec.id)
+            pass
+
 
 runtime_registry = RuntimeRegistry()
 discover_adapters()

services/adapters/s3.py

@@ -52,7 +52,7 @@ class S3Adapter:
     def _get_client(self):
         return self.session.client("s3", endpoint_url=self.endpoint_url)
 
-    async def list_dir(self, root: str, rel: str, page_num: int = 1, page_size: int = 50) -> Tuple[List[Dict], int]:
+    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]:
         prefix = self._get_s3_key(rel)
         if prefix and not prefix.endswith("/"):
             prefix += "/"
@@ -91,7 +91,21 @@ class S3Adapter:
                         })
 
         # 在内存中排序和分页
-        all_items.sort(key=lambda x: (not x["is_dir"], x["name"].lower()))
+        reverse = sort_order.lower() == "desc"
+        def get_sort_key(item):
+            key = (not item["is_dir"],)
+            sort_field = sort_by.lower()
+            if sort_field == "name":
+                key += (item["name"].lower(),)
+            elif sort_field == "size":
+                key += (item["size"],)
+            elif sort_field == "mtime":
+                key += (item["mtime"],)
+            else:
+                key += (item["name"].lower(),)
+            return key
+        all_items.sort(key=get_sort_key, reverse=reverse)
+        
         total_count = len(all_items)
         start_idx = (page_num - 1) * page_size
         end_idx = start_idx + page_size

services/adapters/telegram.py

@@ -62,7 +62,7 @@ class TelegramAdapter:
     def get_effective_root(self, sub_path: str | None) -> str:
         return ""
 
-    async def list_dir(self, root: str, rel: str, page_num: int = 1, page_size: int = 50) -> Tuple[List[Dict], int]:
+    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]:
         if rel:
             return [], 0
 
@@ -70,7 +70,7 @@ class TelegramAdapter:
         entries = []
         try:
             await client.connect()
-            messages = await client.get_messages(self.chat_id, limit=50)
+            messages = await client.get_messages(self.chat_id, limit=200)
             for message in messages:
                 if not message:
                     continue
@@ -113,7 +113,30 @@ class TelegramAdapter:
             if client.is_connected():
                 await client.disconnect()
 
-        return entries, len(entries)
+        # 排序
+        reverse = sort_order.lower() == "desc"
+        def get_sort_key(item):
+            key = (not item["is_dir"],)
+            sort_field = sort_by.lower()
+            if sort_field == "name":
+                key += (item["name"].lower(),)
+            elif sort_field == "size":
+                key += (item["size"],)
+            elif sort_field == "mtime":
+                key += (item["mtime"],)
+            else:
+                key += (item["name"].lower(),)
+            return key
+        entries.sort(key=get_sort_key, reverse=reverse)
+        
+        total_count = len(entries)
+        
+        # 分页
+        start_idx = (page_num - 1) * page_size
+        end_idx = start_idx + page_size
+        page_entries = entries[start_idx:end_idx]
+        
+        return page_entries, total_count
 
     async def read_file(self, root: str, rel: str) -> bytes:
         try:

services/adapters/webdav.py

@@ -39,7 +39,7 @@ class WebDAVAdapter:
         rel = rel.strip('/')
         return self.base_url if not rel else urljoin(self.base_url, quote(rel) + ('/' if rel.endswith('/') else ''))
 
-    async def list_dir(self, root: str, rel: str, page_num: int = 1, page_size: int = 50) -> Tuple[List[Dict], int]:
+    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]:
         raw_url = self._build_url(rel)
         url = raw_url if raw_url.endswith('/') else raw_url + '/'
         depth = "1"
@@ -92,16 +92,39 @@ class WebDAVAdapter:
                 "d:collection", NS) is not None if rt_el is not None else href_path.endswith('/')
             size = int(
                 size_el.text) if size_el is not None and size_el.text and size_el.text.isdigit() else 0
+            
+            from email.utils import parsedate_to_datetime
+            mtime = 0
+            if lm_el is not None and lm_el.text:
+                try:
+                    mtime = int(parsedate_to_datetime(lm_el.text).timestamp())
+                except Exception:
+                    mtime = 0
+
             all_entries.append({
                 "name": name,
                 "is_dir": is_dir,
                 "size": 0 if is_dir else size,
-                "mtime": 0,
+                "mtime": mtime,
                 "type": "dir" if is_dir else "file",
             })
 
         # 排序所有条目
-        all_entries.sort(key=lambda x: (not x["is_dir"], x["name"].lower()))
+        reverse = sort_order.lower() == "desc"
+        def get_sort_key(item):
+            key = (not item["is_dir"],)
+            sort_field = sort_by.lower()
+            if sort_field == "name":
+                key += (item["name"].lower(),)
+            elif sort_field == "size":
+                key += (item["size"],)
+            elif sort_field == "mtime":
+                key += (item["mtime"],)
+            else:
+                key += (item["name"].lower(),)
+            return key
+        all_entries.sort(key=get_sort_key, reverse=reverse)
+        
         total_count = len(all_entries)
 
         # 应用分页

services/config.py

@@ -4,7 +4,7 @@ from typing import Any, Optional, Dict
 from dotenv import load_dotenv
 from models.database import Configuration
 load_dotenv(dotenv_path=".env")
-VERSION = "v1.1.4"
+VERSION = "v1.2.1"
 
 class ConfigCenter:
     _cache: Dict[str, Any] = {}

services/vector_db.py

@@ -75,3 +75,9 @@ class VectorDBService:
             output_fields=["path"]
         )
         return [[{'id': r['path'], 'distance': 1.0, 'entity': {'path': r['path']}} for r in results]]
+
+    def clear_all_data(self):
+        """清空所有集合的内容"""
+        collections = self.client.list_collections()
+        for collection_name in collections:
+            self.client.drop_collection(collection_name)

services/virtual_fs.py

@@ -59,7 +59,7 @@ async def _ensure_method(adapter: Any, method: str):
     return func
 
 
-async def list_virtual_dir(path: str, page_num: int = 1, page_size: int = 50) -> Dict:
+async def list_virtual_dir(path: str, page_num: int = 1, page_size: int = 50, sort_by: str = "name", sort_order: str = "asc") -> Dict:
     norm = (path if path.startswith('/') else '/' + path).rstrip('/') or '/'
     adapters = await StorageAdapter.filter(enabled=True)
 
@@ -100,7 +100,7 @@ async def list_virtual_dir(path: str, page_num: int = 1, page_size: int = 50) ->
     if adapter_model and adapter_instance:
         list_dir = await _ensure_method(adapter_instance, "list_dir")
         try:
-            adapter_entries, adapter_total = await list_dir(effective_root, rel, page_num, page_size)
+            adapter_entries, adapter_total = await list_dir(effective_root, rel, page_num, page_size, sort_by, sort_order)
         except NotADirectoryError:
             raise HTTPException(400, detail="Not a directory")
 
@@ -118,17 +118,32 @@ async def list_virtual_dir(path: str, page_num: int = 1, page_size: int = 50) ->
             ent['is_image'] = is_image_filename(ent['name'])
         else:
             ent['is_image'] = False
+
     all_entries = adapter_entries + mount_entries
-    all_entries.sort(key=lambda x: (not x.get("is_dir"), x["name"].lower()))
-    total_entries = adapter_total + len(mount_entries)
+    
     if mount_entries:
+        reverse = sort_order.lower() == "desc"
+        def get_sort_key(item):
+            key = (not item.get("is_dir"),)
+            sort_field = sort_by.lower()
+            if sort_field == "name":
+                key += (item["name"].lower(),)
+            elif sort_field == "size":
+                key += (item.get("size", 0),)
+            elif sort_field == "mtime":
+                key += (item.get("mtime", 0),)
+            else:
+                key += (item["name"].lower(),)
+            return key
+        all_entries.sort(key=get_sort_key, reverse=reverse)
+        
+        total_entries = adapter_total + len(mount_entries)
         start_idx = (page_num - 1) * page_size
         end_idx = start_idx + page_size
         page_entries = all_entries[start_idx:end_idx]
-
         return page(page_entries, total_entries, page_num, page_size)
-    else:
-        return page(adapter_entries, adapter_total, page_num, page_size)
+    
+    return page(adapter_entries, adapter_total, page_num, page_size)
 
 
 async def read_file(path: str) -> Union[bytes, Any]:

web/index.html

@@ -1,13 +1,20 @@
 <!doctype html>
-<html lang="en">
+<html lang="zh-CN">
 
 <head>
   <meta charset="UTF-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
   <title>Foxel</title>
+  <link rel='stylesheet'
+    href='https://chinese-fonts-cdn.deno.dev/packages/maple-mono-cn/dist/MapleMono-CN-Regular/result.css' />
 </head>
 
 <body>
+  <style>
+    * {
+      font-family: 'Maple Mono CN';
+    }
+  </style>
   <div id="root"></div>
   <script type="module" src="/src/main.tsx"></script>
 </body>

web/src/App.tsx

@@ -4,11 +4,15 @@ import { AuthProvider } from './contexts/AuthContext.tsx';
 import { status as getStatus } from './api/config.ts';
 import type { SystemStatus } from './api/config.ts';
 import { SystemContext } from './contexts/SystemContext.tsx';
-import { Spin } from 'antd';
+import { ThemeProvider } from './contexts/ThemeContext.tsx';
+import { Spin, ConfigProvider } from 'antd';
 import { Routes, Route, Navigate } from 'react-router';
 import SetupPage from './pages/SetupPage.tsx';
+import { I18nProvider, useI18n } from './i18n';
+import zhCN from 'antd/locale/zh_CN';
+import enUS from 'antd/locale/en_US';
 
-function App() {
+function AppInner() {
   const [status, setStatus] = useState<SystemStatus | null>(null);
   useEffect(() => {
     async function checkInitialization() {
@@ -35,20 +39,33 @@ function App() {
     );
   }
 
+  const { lang } = useI18n();
+  const locale = lang === 'zh' ? zhCN : enUS;
+
   return (
-    <SystemContext.Provider value={status}>
-      <AuthProvider>
-        {!status.is_initialized ? (
-          <Routes>
-            <Route path="/setup" element={<SetupPage />} />
-            <Route path="*" element={<Navigate to="/setup" replace />} />
-          </Routes>
-        ) : (
-          <AppRouter />
-        )}
-      </AuthProvider>
-    </SystemContext.Provider>
+    <ConfigProvider locale={locale}>
+      <SystemContext.Provider value={status}>
+        <AuthProvider>
+          <ThemeProvider>
+            {!status.is_initialized ? (
+              <Routes>
+                <Route path="/setup" element={<SetupPage />} />
+                <Route path="*" element={<Navigate to="/setup" replace />} />
+              </Routes>
+            ) : (
+              <AppRouter />
+            )}
+          </ThemeProvider>
+        </AuthProvider>
+      </SystemContext.Provider>
+    </ConfigProvider>
   );
 }
 
-export default App;
+export default function App() {
+  return (
+    <I18nProvider>
+      <AppInner />
+    </I18nProvider>
+  );
+}

web/src/api/plugins.ts

@@ -0,0 +1,46 @@
+import request from './client';
+
+export interface PluginItem {
+  id: number;
+  url: string;
+  enabled: boolean;
+  key?: string | null;
+  name?: string | null;
+  version?: string | null;
+  supported_exts?: string[] | null;
+  default_bounds?: Record<string, any> | null;
+  default_maximized?: boolean | null;
+  icon?: string | null;
+  description?: string | null;
+  author?: string | null;
+  website?: string | null;
+  github?: string | null;
+}
+
+export interface PluginCreate {
+  url: string;
+  enabled?: boolean;
+}
+
+export interface PluginManifestUpdate {
+  key?: string;
+  name?: string;
+  version?: string;
+  supported_exts?: string[];
+  default_bounds?: Record<string, any>;
+  default_maximized?: boolean;
+  icon?: string;
+  description?: string;
+  author?: string;
+  website?: string;
+  github?: string;
+}
+
+export const pluginsApi = {
+  list: () => request<PluginItem[]>(`/plugins`),
+  create: (payload: PluginCreate) => request<PluginItem>(`/plugins`, { method: 'POST', json: payload }),
+  remove: (id: number) => request(`/plugins/${id}`, { method: 'DELETE' }),
+  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/tasks.ts

@@ -14,9 +14,19 @@ export interface AutomationTask {
 export type AutomationTaskCreate = Omit<AutomationTask, 'id'>;
 export type AutomationTaskUpdate = Partial<AutomationTaskCreate>;
 
+export interface QueuedTask {
+  id: string;
+  name: string;
+  status: 'pending' | 'running' | 'success' | 'failed';
+  result?: any;
+  error?: string;
+  task_info: Record<string, any>;
+}
+
 export const tasksApi = {
   list: () => request<AutomationTask[]>('/tasks/'),
   create: (payload: AutomationTaskCreate) => request<AutomationTask>('/tasks/', { method: 'POST', json: payload }),
   update: (id: number, payload: AutomationTaskUpdate) => request<AutomationTask>(`/tasks/${id}`, { method: 'PUT', json: payload }),
   remove: (id: number) => request<void>(`/tasks/${id}`, { method: 'DELETE' }),
+  getQueue: () => request<QueuedTask[]>('/tasks/queue'),
 };

web/src/api/vectorDB.ts

@@ -0,0 +1,5 @@
+import client from './client';
+
+export const vectorDBApi = {
+  clearAll: () => client('/vector-db/clear-all', { method: 'POST' }),
+};

web/src/api/vfs.ts

@@ -27,12 +27,14 @@ export interface SearchResultItem {
 }
 
 export const vfsApi = {
-  list: (path: string, page: number = 1, pageSize: number = 50) => {
+  list: (path: string, page: number = 1, pageSize: number = 50, sortBy: string = 'name', sortOrder: string = 'asc') => {
     const cleaned = path.replace(/\\/g, '/');
     const trimmed = cleaned === '/' ? '' : cleaned.replace(/^\/+/, '');
     const params = new URLSearchParams({
       page: page.toString(),
-      page_size: pageSize.toString()
+      page_size: pageSize.toString(),
+      sort_by: sortBy,
+      sort_order: sortOrder
     });
     return request<DirListing>(`/fs/${encodeURI(trimmed)}?${params}`);
   },

web/src/apps/AppWindowsLayer.tsx

@@ -243,8 +243,8 @@ export const AppWindowsLayer: React.FC<AppWindowsLayerProps> = ({ windows, onClo
               left: w.maximized ? 0 : w.x,    
               width: w.maximized ? '100vw' : w.width,
               height: w.maximized ? '100vh' : w.height,
-              background: 'rgba(240, 242, 245, 0.7)', // Semi-transparent background
-              border: '1px solid rgba(255, 255, 255, 0.18)',
+              background: 'var(--ant-color-bg-elevated, var(--ant-color-bg-container))',
+              border: '1px solid var(--ant-color-border-secondary, rgba(255,255,255,0.18))',
               borderRadius: w.maximized ? 0 : 12,
               boxShadow: w.maximized
                 ? 'none'
@@ -254,7 +254,7 @@ export const AppWindowsLayer: React.FC<AppWindowsLayerProps> = ({ windows, onClo
               display: 'flex',
               flexDirection: 'column',
               overflow: 'hidden',
-              backdropFilter: 'blur(20px) saturate(180%)', // Enhanced blur effect
+              backdropFilter: 'blur(12px) saturate(150%)',
               zIndex: 3000 + idx,
               willChange: 'left,top,width,height',
               transition: interacting ? 'none' : 'top .15s,left .15s,width .15s,height .15s,box-shadow .25s'
@@ -269,9 +269,9 @@ export const AppWindowsLayer: React.FC<AppWindowsLayerProps> = ({ windows, onClo
                 alignItems: 'center',
                 justifyContent: 'space-between',
                 padding: '0 12px',
-                background: 'rgba(0, 0, 0, 0.25)', // Lighter, transparent title bar
-                borderBottom: '1px solid rgba(255, 255, 255, 0.1)',
-                color: '#333', // Darker text for readability
+                background: 'var(--ant-color-fill-secondary, rgba(0,0,0,0.25))',
+                borderBottom: '1px solid var(--ant-color-border-secondary, rgba(255,255,255,0.1))',
+                color: 'var(--ant-color-text, #333)',
                 fontSize: 13,
                 fontWeight: 600,
                 letterSpacing: .2,
@@ -298,7 +298,7 @@ export const AppWindowsLayer: React.FC<AppWindowsLayerProps> = ({ windows, onClo
                   icon={w.maximized ? <FullscreenExitOutlined /> : <FullscreenOutlined />}
                   onClick={() => onToggleMax(w.id)}
                   style={{
-                    color: '#555',
+                    color: 'var(--ant-color-text-secondary, #555)',
                     width: 30,
                     height: 30,
                     display: 'flex',
@@ -314,7 +314,7 @@ export const AppWindowsLayer: React.FC<AppWindowsLayerProps> = ({ windows, onClo
                   icon={<CloseOutlined />}
                   onClick={() => onClose(w.id)}
                   style={{
-                    color: '#ff4d4f',
+                    color: 'var(--ant-color-error, #ff4d4f)',
                     width: 30,
                     height: 30,
                     display: 'flex',

web/src/apps/ImageViewer/ImageViewer.tsx

@@ -177,7 +177,7 @@ export const ImageViewerApp: React.FC<AppComponentProps> = ({ filePath, entry, o
   if (err) {
     return (
       <div style={{
-        color: '#f5222d',
+        color: 'var(--ant-color-error, #f5222d)',
         padding: 16,
         background: 'rgba(20,20,20,0.8)',
         backdropFilter: 'blur(24px)'

web/src/apps/OfficeViewer/OfficeViewer.tsx

@@ -60,7 +60,7 @@ export const OfficeViewerApp: React.FC<AppComponentProps> = ({ filePath, onReque
   }
 
   return (
-    <div style={{ width: '100%', height: '100%', background: '#fff' }}>
+    <div style={{ width: '100%', height: '100%', background: 'var(--ant-color-bg-container, #fff)' }}>
       {url ? (
         <iframe
           src={url}
@@ -79,4 +79,4 @@ export const OfficeViewerApp: React.FC<AppComponentProps> = ({ filePath, onReque
       )}
     </div>
   );
-};
+};

web/src/apps/PluginHost/index.tsx

@@ -0,0 +1,59 @@
+import React, { useRef, useState } from 'react';
+import type { AppComponentProps } from '../types';
+import { vfsApi } from '../../api/vfs';
+import { loadPluginFromUrl, ensureManifest, type RegisteredPlugin } from '../../plugins/runtime';
+import type { PluginItem } from '../../api/plugins';
+import { useAsyncSafeEffect } from '../../hooks/useAsyncSafeEffect';
+import { useI18n } from '../../i18n';
+
+export interface PluginAppHostProps extends AppComponentProps {
+  plugin: PluginItem;
+}
+
+export const PluginAppHost: React.FC<PluginAppHostProps> = ({ plugin, filePath, entry, 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 loadPluginFromUrl(plugin.url);
+        if (isDisposed()) return;
+        pluginRef.current = p;
+        await ensureManifest(plugin.id, p);
+        if (isDisposed()) return;
+        const token = await vfsApi.getTempLinkToken(filePath);
+        if (isDisposed()) return;
+        const downloadUrl = vfsApi.getTempPublicUrl(token.token);
+        if (isDisposed() || !containerRef.current) return;
+        await p.mount(containerRef.current, {
+          filePath,
+          entry,
+          urls: { downloadUrl },
+          host: { close: () => onCloseRef.current() },
+        });
+      } catch (e: any) {
+        if (!isDisposed()) setError(e?.message || t('Plugin run failed'));
+      }
+    },
+    [plugin.id, plugin.url, filePath],
+    () => {
+      try {
+        if (pluginRef.current?.unmount && containerRef.current) {
+          pluginRef.current.unmount(containerRef.current);
+        }
+      } catch {}
+    },
+  );
+
+  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' }} />;
+};

web/src/apps/TextEditor/TextEditor.tsx

@@ -64,19 +64,19 @@ export const TextEditorApp: React.FC<AppComponentProps> = ({ filePath, entry, on
   }, [handleSave]);
 
   return (
-    <Layout style={{ height: '100%', background: '#ffffff' }}>
+    <Layout style={{ height: '100%', background: 'var(--ant-color-bg-container, #ffffff)' }}>
       <Header
         style={{
-          background: '#f0f2f5',
+          background: 'var(--ant-color-bg-layout, #f0f2f5)',
           padding: '0 16px',
           height: 40,
           display: 'flex',
           alignItems: 'center',
           justifyContent: 'space-between',
-          borderBottom: '1px solid #d9d9d9'
+          borderBottom: '1px solid var(--ant-color-border-secondary, #d9d9d9)'
         }}
       >
-        <span style={{ color: 'rgba(0, 0, 0, 0.88)' }}>
+        <span style={{ color: 'var(--ant-color-text, rgba(0,0,0,0.88))' }}>
           {entry.name} {isDirty && '*'}
         </span>
         <Space>
@@ -101,4 +101,4 @@ export const TextEditorApp: React.FC<AppComponentProps> = ({ filePath, entry, on
       </Content>
     </Layout>
   );
-};
+};

web/src/apps/VideoPlayer/index.ts

@@ -7,7 +7,7 @@ export const descriptor: AppDescriptor = {
   supported: (entry) => {
     if (entry.is_dir) return false;
     const ext = entry.name.split('.').pop()?.toLowerCase() || '';
-    return ['mp4','webm','ogg','m4v','mov'].includes(ext);
+    return ['mp4','webm','ogg','m4v','mov','mkv','avi','wmv','flv','3gp'].includes(ext);
   },
   component: VideoPlayerApp,
   default: true,

web/src/apps/registry.ts

@@ -1,9 +1,11 @@
 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';
 const apps: AppDescriptor[] = [];
 
 // 使用 import.meta.glob 动态导入所有应用
-// vite-glob-ignore
 const appModules = import.meta.glob('./*/index.ts');
 
 async function loadApps() {
@@ -16,11 +18,34 @@ async function loadApps() {
       }
     }
   }
+  try {
+    const items = await pluginsApi.list();
+    items.filter(p => p.enabled !== false).forEach((p) => registerPluginAsApp(p));
+  } catch (e) {
+  }
 }
 
-// 立即加载并注册所有应用
-loadApps();
+function registerPluginAsApp(p: PluginItem) {
+  const key = 'plugin:' + p.id;
+  if (apps.find(a => a.key === key)) return;
+  const supported = (entry: VfsEntry) => {
+    if (entry.is_dir) return false;
+    const ext = entry.name.split('.').pop()?.toLowerCase() || '';
+    if (!p.supported_exts || p.supported_exts.length === 0) return true;
+    return p.supported_exts.includes(ext);
+  };
+  apps.push({
+    key,
+    name: p.name || `插件 ${p.id}`,
+    supported,
+    component: (props: any) => React.createElement(PluginAppHost, { plugin: p, ...props }),
+    default: false,
+    defaultBounds: p.default_bounds || undefined,
+    defaultMaximized: p.default_maximized || undefined,
+  });
+}
 
+loadApps();
 
 export function getAppsForEntry(entry: VfsEntry): AppDescriptor[] {
   return apps.filter(a => a.supported(entry));
@@ -43,3 +68,27 @@ export function getDefaultAppForEntry(entry: VfsEntry): AppDescriptor | undefine
 
 export type { AppDescriptor };
 export type { AppComponentProps } from './types';
+
+export async function reloadPluginApps() {
+  try {
+    const items = await pluginsApi.list();
+    const keepKeys = new Set(items.filter(p => p.enabled !== false).map(p => 'plugin:' + p.id));
+    for (let i = apps.length - 1; i >= 0; i--) {
+      const a = apps[i];
+      if (a.key.startsWith('plugin:') && !keepKeys.has(a.key)) {
+        apps.splice(i, 1);
+      }
+    }
+    items.filter(p => p.enabled !== false).forEach(p => {
+      const key = 'plugin:' + p.id;
+      const existing = apps.find(a => a.key === key);
+      if (!existing) {
+        registerPluginAsApp(p);
+      } else {
+        existing.name = p.name || `插件 ${p.id}`;
+        existing.defaultBounds = p.default_bounds || undefined;
+        existing.defaultMaximized = p.default_maximized || undefined;
+      }
+    });
+  } catch { }
+}

web/src/components/LanguageSwitcher.tsx

@@ -0,0 +1,20 @@
+import { Dropdown, Button } from 'antd';
+import { GlobalOutlined, CheckOutlined } from '@ant-design/icons';
+import { memo } from 'react';
+import { useI18n } from '../i18n';
+
+const LanguageSwitcher = memo(function LanguageSwitcher() {
+  const { lang, setLang, t } = useI18n();
+  const items = [
+    { key: 'zh', label: t('Chinese'), icon: lang === 'zh' ? <CheckOutlined /> : undefined, onClick: () => setLang('zh') },
+    { key: 'en', label: t('English'), icon: lang === 'en' ? <CheckOutlined /> : undefined, onClick: () => setLang('en') },
+  ];
+  return (
+    <Dropdown menu={{ items }} trigger={['click']}>
+      <Button icon={<GlobalOutlined />}>{t('Language')}</Button>
+    </Dropdown>
+  );
+});
+
+export default LanguageSwitcher;
+

web/src/components/ProcessorConfigForm.tsx

@@ -1,6 +1,7 @@
 import React from 'react';
 import { Form, Input, Select, Typography } from 'antd';
 import type { ProcessorTypeMeta } from '../api/processors';
+import { useI18n } from '../i18n';
 
 interface ProcessorConfigFormProps {
   processorMeta: ProcessorTypeMeta | undefined;
@@ -9,17 +10,18 @@ interface ProcessorConfigFormProps {
 }
 
 export const ProcessorConfigForm: React.FC<ProcessorConfigFormProps> = ({ processorMeta, configPath }) => {
+  const { t } = useI18n();
   if (!processorMeta) {
-    return <Typography.Text type="secondary">请先选择处理器</Typography.Text>;
+    return <Typography.Text type="secondary">{t('Please select a processor')}</Typography.Text>;
   }
   if (!processorMeta.config_schema?.length) {
-    return <Typography.Text type="secondary">该处理器无配置项</Typography.Text>;
+    return <Typography.Text type="secondary">{t('No config fields')}</Typography.Text>;
   }
 
   return (
     <>
       {processorMeta.config_schema.map(field => {
-        const rules = field.required ? [{ required: true, message: `请输入${field.label}` }] : [];
+        const rules = field.required ? [{ required: true, message: t('Please input {label}', { label: field.label }) }] : [];
         let inputNode: React.ReactNode;
 
         switch (field.type) {
@@ -31,7 +33,7 @@ export const ProcessorConfigForm: React.FC<ProcessorConfigFormProps> = ({ proces
             break;
           case 'select':
             inputNode = (
-              <Select placeholder={field.placeholder || '请选择'}>
+              <Select placeholder={field.placeholder || t('Please select')}>
                 {field.options?.map((opt: any) => (
                   <Select.Option key={String(opt.value)} value={opt.value}>
                     {opt.label}
@@ -48,7 +50,7 @@ export const ProcessorConfigForm: React.FC<ProcessorConfigFormProps> = ({ proces
           <Form.Item
             key={field.key}
             name={[...configPath, field.key]}
-            label={field.label}
+            label={t(field.label)}
             rules={rules}
             initialValue={field.default}
           >
@@ -58,4 +60,4 @@ export const ProcessorConfigForm: React.FC<ProcessorConfigFormProps> = ({ proces
       })}
     </>
   );
-};
+};

web/src/contexts/ThemeContext.tsx

@@ -0,0 +1,185 @@
+import React, { createContext, useContext, useEffect, useMemo, useRef, useState } from 'react';
+import { ConfigProvider, theme as antdTheme } from 'antd';
+import zhCN from 'antd/locale/zh_CN';
+import type { ThemeConfig } from 'antd/es/config-provider/context';
+import { getAllConfig } from '../api/config';
+import { useAuth } from './AuthContext';
+import baseTheme from '../theme';
+
+type ThemeMode = 'light' | 'dark' | 'system';
+
+interface ThemeState {
+  mode: ThemeMode;
+  primaryColor?: string | null;
+  borderRadius?: number | null;
+  customTokens?: Record<string, any> | null;
+  customCSS?: string | null;
+}
+
+interface ThemeContextType {
+  refreshTheme: () => Promise<void>;
+  previewTheme: (patch: Partial<ThemeState>) => void;
+  mode: ThemeMode;
+  resolvedMode: ThemeMode;
+}
+
+const Ctx = createContext<ThemeContextType>({} as any);
+
+const CONFIG_KEYS = {
+  MODE: 'THEME_MODE',
+  PRIMARY: 'THEME_PRIMARY_COLOR',
+  RADIUS: 'THEME_BORDER_RADIUS',
+  TOKENS: 'THEME_CUSTOM_TOKENS',
+  CSS: 'THEME_CUSTOM_CSS',
+};
+
+function parseJSON<T = any>(text: string | null | undefined): T | null {
+  if (!text) return null;
+  try {
+    return JSON.parse(text) as T;
+  } catch {
+    return null;
+  }
+}
+
+function useSystemDarkPreferred() {
+  const [isDark, setIsDark] = useState<boolean>(
+    typeof window !== 'undefined' && window.matchMedia
+      ? window.matchMedia('(prefers-color-scheme: dark)').matches
+      : false
+  );
+  useEffect(() => {
+    if (!window.matchMedia) return;
+    const mql = window.matchMedia('(prefers-color-scheme: dark)');
+    const handler = (e: MediaQueryListEvent) => setIsDark(e.matches);
+    mql.addEventListener?.('change', handler);
+    return () => mql.removeEventListener?.('change', handler);
+  }, []);
+  return isDark;
+}
+
+function buildThemeConfig(state: ThemeState, systemDark: boolean): ThemeConfig {
+  const resolvedMode: ThemeMode = state.mode === 'system' ? (systemDark ? 'dark' : 'light') : state.mode;
+  const algorithm = resolvedMode === 'dark'
+    ? [antdTheme.darkAlgorithm, antdTheme.compactAlgorithm]
+    : [antdTheme.defaultAlgorithm, antdTheme.compactAlgorithm];
+
+  const safeBaseTokens: Record<string, any> = resolvedMode === 'dark'
+    ? {
+        borderRadius: baseTheme.token?.borderRadius,
+        fontSize: baseTheme.token?.fontSize,
+        controlHeight: baseTheme.token?.controlHeight,
+        boxShadow: baseTheme.token?.boxShadow,
+      }
+    : { ...(baseTheme.token as any) };
+
+  const token = {
+    ...safeBaseTokens,
+    ...(state.primaryColor ? { colorPrimary: state.primaryColor } : {}),
+    ...(state.borderRadius != null ? { borderRadius: state.borderRadius } : {}),
+    ...(state.customTokens || {}),
+  } as any;
+
+  const baseComponents = { ...(baseTheme.components as any) };
+  if (resolvedMode === 'dark' && baseComponents) {
+    if (baseComponents.Menu) {
+      const { itemHoverColor, itemHoverBg, itemSelectedBg, itemSelectedColor, ...rest } = baseComponents.Menu;
+      baseComponents.Menu = rest;
+    }
+    if (baseComponents.Dropdown) {
+      const { controlItemBgHover, ...rest } = baseComponents.Dropdown;
+      baseComponents.Dropdown = rest;
+    }
+    if (baseComponents.Table) {
+      const { headerBg, rowHoverBg, ...rest } = baseComponents.Table;
+      baseComponents.Table = rest;
+    }
+  }
+
+  return { algorithm, token, components: baseComponents } satisfies ThemeConfig;
+}
+
+export function ThemeProvider({ children }: { children: React.ReactNode }) {
+  const { isAuthenticated } = useAuth();
+  const systemDark = useSystemDarkPreferred();
+  const [state, setState] = useState<ThemeState>({ mode: 'light' });
+  const styleTagRef = useRef<HTMLStyleElement | null>(null);
+
+  const ensureStyleTag = () => {
+    if (styleTagRef.current) return styleTagRef.current;
+    let styleEl = document.getElementById('foxel-custom-css') as HTMLStyleElement | null;
+    if (!styleEl) {
+      styleEl = document.createElement('style');
+      styleEl.id = 'foxel-custom-css';
+      document.head.appendChild(styleEl);
+    }
+    styleTagRef.current = styleEl;
+    return styleEl;
+  };
+
+  const applyCustomCSS = (cssText: string | null | undefined) => {
+    const el = ensureStyleTag();
+    el.textContent = cssText || '';
+  };
+
+  const applyHtmlDataTheme = (mode: ThemeMode) => {
+    const finalMode = mode === 'system' ? (systemDark ? 'dark' : 'light') : mode;
+    document.documentElement.setAttribute('data-theme', finalMode);
+  };
+
+  const refreshTheme = async () => {
+    if (!isAuthenticated) {
+      applyHtmlDataTheme(state.mode || 'light');
+      applyCustomCSS(state.customCSS || '');
+      return;
+    }
+    try {
+      const cfg = await getAllConfig();
+      const mode = (cfg[CONFIG_KEYS.MODE] as ThemeMode) || 'light';
+      const primary = (cfg[CONFIG_KEYS.PRIMARY] as string) || null;
+      const radiusStr = cfg[CONFIG_KEYS.RADIUS];
+      const radius = radiusStr != null ? Number(radiusStr) : null;
+      const customTokens = parseJSON<Record<string, any>>(cfg[CONFIG_KEYS.TOKENS]);
+      const customCSS = (cfg[CONFIG_KEYS.CSS] as string) || '';
+      setState({ mode, primaryColor: primary, borderRadius: radius, customTokens, customCSS });
+      applyHtmlDataTheme(mode);
+      applyCustomCSS(customCSS);
+    } catch (e) {
+      applyHtmlDataTheme('light');
+      applyCustomCSS('');
+    }
+  };
+
+  const previewTheme = (patch: Partial<ThemeState>) => {
+    const next: ThemeState = { ...state, ...patch };
+    setState(next);
+    applyHtmlDataTheme(next.mode || 'light');
+    applyCustomCSS(next.customCSS || '');
+  };
+
+  useEffect(() => {
+    refreshTheme();
+  }, [isAuthenticated, systemDark]);
+
+  const themeConfig = useMemo(() => buildThemeConfig(state, systemDark), [state, systemDark]);
+  const resolvedMode: ThemeMode = useMemo(() => (state.mode === 'system' ? (systemDark ? 'dark' : 'light') : state.mode), [state.mode, systemDark]);
+
+  const ctxValue = useMemo<ThemeContextType>(() => ({
+    refreshTheme,
+    previewTheme,
+    mode: state.mode,
+    resolvedMode,
+  }), [state.mode, resolvedMode]);
+
+  return (
+    <Ctx.Provider value={ctxValue}>
+      <ConfigProvider theme={{ ...themeConfig, cssVar: true }} locale={zhCN}>
+        {children}
+      </ConfigProvider>
+    </Ctx.Provider>
+  );
+}
+
+export function useTheme() {
+  return useContext(Ctx);
+}

web/src/global.css

@@ -1,41 +1,42 @@
 html,body,#root { height: 100%; }
-body { font-family: system-ui,-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,'Helvetica Neue',Arial,'Noto Sans',sans-serif; background:#f9f9f9; }
+body { font-family: system-ui,-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,'Helvetica Neue',Arial,'Noto Sans',sans-serif; background: var(--ant-color-bg-layout, #f9f9f9); }
 
 ::-webkit-scrollbar { width: 8px; height: 8px; }
 ::-webkit-scrollbar-track { background: transparent; }
-::-webkit-scrollbar-thumb { background: #d9d9d9; border-radius: 4px; }
-::-webkit-scrollbar-thumb:hover { background: #bfbfbf; }
+::-webkit-scrollbar-thumb { background: var(--ant-color-fill-tertiary, #d9d9d9); border-radius: 4px; }
+::-webkit-scrollbar-thumb:hover { background: var(--ant-color-fill-secondary, #bfbfbf); }
 
-.fx-surface { background:#fff; border:1px solid #eaeaea; border-radius:12px; }
-.fx-card { background:linear-gradient(#fff,#fafafa); border:1px solid #eaeaea; border-radius:14px; box-shadow:0 1px 2px rgba(0,0,0,.04),0 4px 10px -2px rgba(0,0,0,.03); }
-.fx-fade-text { color:#555; }
+.fx-surface { background: var(--ant-color-bg-container, #fff); border:1px solid var(--ant-color-border, #eaeaea); border-radius:12px; }
+.fx-card { background: var(--ant-color-bg-container, #fff); border:1px solid var(--ant-color-border, #eaeaea); border-radius:14px; box-shadow:0 1px 2px rgba(0,0,0,.04),0 4px 10px -2px rgba(0,0,0,.03); }
+.fx-fade-text { color: var(--ant-color-text-secondary, #555); }
 
-.fx-quiet-btn.ant-btn-text:not(:hover) { color:#666; }
+.fx-quiet-btn.ant-btn-text:not(:hover) { color: var(--ant-color-text-tertiary, #666); }
 
-.ant-layout { background:#f9f9f9; }
+/* 使用 antd 默认布局背景 */
+.ant-layout { background: transparent; }
 
 /* Menu compact spacing adjustments */
 .ant-menu-inline .ant-menu-item { margin-block:2px; }
 
 /* Sidebar high-contrast selection */
 .sider-menu .ant-menu-item-selected {
-	background:#111 !important;
+	background: var(--ant-color-primary, #111) !important;
 	color:#fff !important;
 }
 .sider-menu .ant-menu-item-selected .ant-menu-item-icon, 
 .sider-menu .ant-menu-item-selected .anticon { color:#fff !important; }
-.sider-menu .ant-menu-item:not(.ant-menu-item-selected):hover { background:#f2f2f2; }
+.sider-menu .ant-menu-item:not(.ant-menu-item-selected):hover { background: var(--ant-color-fill-tertiary, #f2f2f2); }
 
 .row-selected td { background: rgba(24,144,255,0.12) !important; }
 .row-selected:hover td { background: rgba(24,144,255,0.2) !important; }
 
 .fx-grid { display:flex; flex-wrap:wrap; gap:20px; }
-.fx-grid-item { width:160px; cursor:pointer; border-radius:14px; padding:12px 12px 10px; background:#f5f5f5; position:relative; display:flex; flex-direction:column; align-items:stretch; gap:6px; transition:.18s box-shadow,.18s background; }
-.fx-grid-item.dir { background:#f3f3f3; }
-.fx-grid-item.selected { box-shadow:0 0 0 2px var(--ant-color-primary); background:#acc0c0; }
-.fx-grid-item:hover { background:#d2d1d1a7; box-shadow:0 1px 4px rgba(0,0,0,.06); }
-.fx-grid-item .thumb { height:120px; border-radius:10px; background:#fff; display:flex; align-items:center; justify-content:center; overflow:hidden; position:relative; box-shadow: inset 0 0 0 1px #eee; }
+.fx-grid-item { width:160px; cursor:pointer; border-radius:14px; padding:12px 12px 10px; background: var(--ant-color-fill-tertiary, #f5f5f5); position:relative; display:flex; flex-direction:column; align-items:stretch; gap:6px; transition:.18s box-shadow,.18s background; }
+.fx-grid-item.dir { background: var(--ant-color-fill-secondary, #f3f3f3); }
+.fx-grid-item.selected { box-shadow:0 0 0 2px var(--ant-color-primary); background: var(--ant-color-primary-bg, #e6f4ff); }
+.fx-grid-item:hover { background: var(--ant-color-fill, #ededed); box-shadow:0 1px 4px rgba(0,0,0,.06); }
+.fx-grid-item .thumb { height:120px; border-radius:10px; background: var(--ant-color-bg-container, #fff); display:flex; align-items:center; justify-content:center; overflow:hidden; position:relative; box-shadow: inset 0 0 0 1px var(--ant-color-border-secondary, #eee); }
 .fx-grid-item .thumb img { width:100%; height:100%; object-fit:cover; }
-.fx-grid-item .thumb .badge { position:absolute; top:6px; left:6px; background:#111; color:#fff; font-size:10px; padding:2px 4px; border-radius:6px; line-height:1; letter-spacing:.5px; }
+.fx-grid-item .thumb .badge { position:absolute; top:6px; left:6px; background: var(--ant-color-primary, #111); color:#fff; font-size:10px; padding:2px 4px; border-radius:6px; line-height:1; letter-spacing:.5px; }
 .fx-grid-item .name { font-weight:600; font-size:13px; }
 .ellipsis { overflow:hidden; white-space:nowrap; text-overflow:ellipsis; }

web/src/hooks/useAsyncSafeEffect.ts

@@ -0,0 +1,35 @@
+import React, { useEffect } from 'react';
+
+export interface AsyncEffectCtx {
+  isDisposed: () => boolean;
+  signal: AbortSignal;
+}
+
+export function useAsyncSafeEffect(
+  effect: (ctx: AsyncEffectCtx) => void | Promise<void>,
+  deps: React.DependencyList,
+  cleanup?: (ctx: AsyncEffectCtx) => void,
+) {
+  useEffect(() => {
+    let disposed = false;
+    const ac = new AbortController();
+    const ctx: AsyncEffectCtx = {
+      isDisposed: () => disposed,
+      signal: ac.signal,
+    };
+
+    Promise.resolve(effect(ctx)).catch(() => {
+      // 故意忽略 effect 内部抛出的异常，交由调用方处理
+    });
+
+    return () => {
+      disposed = true;
+      try {
+        cleanup?.(ctx);
+      } finally {
+        ac.abort();
+      }
+    };
+  }, deps);
+}
+

web/src/i18n/index.tsx

@@ -0,0 +1,58 @@
+import { createContext, useContext, useMemo, useState, useEffect } from 'react';
+import type { PropsWithChildren } from 'react';
+import { zh } from './locales/zh';
+import { en } from './locales/en';
+
+type Lang = 'zh' | 'en';
+type Dict = Record<string, string>;
+
+const dicts: Record<Lang, Dict> = {
+  zh,
+  en,
+};
+
+export interface I18nContextValue {
+  lang: Lang;
+  setLang: (lang: Lang) => void;
+  t: (key: string, params?: Record<string, string | number>) => string;
+}
+
+const I18nContext = createContext<I18nContextValue | null>(null);
+
+function interpolate(template: string, params?: Record<string, string | number>): string {
+  if (!params) return template;
+  return template.replace(/\{(\w+)\}/g, (_, k) => String(params[k] ?? `{${k}}`));
+}
+
+export function I18nProvider({ children }: PropsWithChildren) {
+  const [lang, setLangState] = useState<Lang>(() => (localStorage.getItem('lang') as Lang) || 'zh');
+
+  const setLang = (l: Lang) => {
+    setLangState(l);
+    localStorage.setItem('lang', l);
+  };
+
+  useEffect(() => {
+    document.documentElement.lang = lang;
+  }, [lang]);
+
+  const t = (key: string, params?: Record<string, string | number>) => {
+    const dict = dicts[lang] || {};
+    const raw = dict[key] ?? key; // fallback to key (English)
+    return interpolate(raw, params);
+  };
+
+  const value = useMemo<I18nContextValue>(() => ({ lang, setLang, t }), [lang]);
+
+  return (
+    <I18nContext.Provider value={value}>
+      {children}
+    </I18nContext.Provider>
+  );
+}
+
+export function useI18n() {
+  const ctx = useContext(I18nContext);
+  if (!ctx) throw new Error('useI18n must be used within I18nProvider');
+  return ctx;
+}

web/src/i18n/locales/en.ts

@@ -0,0 +1,365 @@
+export const en = {
+  // General
+  'All Files': 'All Files',
+  'Manage': 'Manage',
+  // 'System' defined above for navigation
+  'Follow System': 'System',
+  'Automation': 'Automation',
+  'My Shares': 'My Shares',
+  'Offline Downloads': 'Offline Downloads',
+  'Adapters': 'Adapters',
+  'Plugins': 'App Center',
+  'System Settings': 'System Settings',
+  'Backup & Restore': 'Backup & Restore',
+  'System Logs': 'System Logs',
+
+  // Top header
+  'Search files / tags / types': 'Search files / tags / types',
+  'Log Out': 'Log Out',
+  'Admin': 'Admin',
+  'Language': 'Language',
+  'Chinese': '中文',
+  'English': 'English',
+
+  // Auth / Login
+  'Welcome Back': 'Welcome Back',
+  'Sign in to your Foxel account': 'Sign in to your Foxel account',
+  'Username / Email': 'Username / Email',
+  'Password': 'Password',
+  'Sign In': 'Sign In',
+  'Please enter username and password': 'Please enter username and password',
+  'Login failed': 'Login failed',
+  'Your next-generation file manager': 'Your next-generation file manager',
+  'Cross-platform sync, access anywhere': 'Cross-platform sync, access anywhere',
+  'AI-powered search for quick find': 'AI-powered search for quick find',
+  'Flexible sharing and collaboration': 'Flexible sharing and collaboration',
+  'Powerful automation to simplify tasks': 'Powerful automation to simplify tasks',
+  'Join our community:': 'Join our community:',
+
+  // Share page
+  'Refresh': 'Refresh',
+  'Copy': 'Copy',
+  // 'Cancel' already defined above
+  'Copied link': 'Link copied',
+  'Share canceled': 'Share canceled',
+  'Cancel failed': 'Cancel failed',
+  'Load failed': 'Load failed',
+  'Are you sure to cancel share?': 'Are you sure to cancel share?',
+
+  'Share Name': 'Share Name',
+  'Share Content': 'Share Content',
+  'Created At': 'Created At',
+  'Expires At': 'Expires At',
+  'Forever': 'Forever',
+  'Access': 'Access',
+  'Public': 'Public',
+  'By Password': 'By Password',
+
+  // Public share page
+  'Password Required': 'Password Required',
+  'Please enter password': 'Please enter password',
+  'Confirm': 'Confirm',
+  'Unable to load share info': 'Unable to load share info',
+  'Share load failed': 'Failed to load share',
+  'Wrong password': 'Wrong password',
+  'Root': 'All Files',
+  'Created on {date}': 'Created on {date}',
+  'Expires on {date}': 'Expires on {date}',
+  'Download File': 'Download File',
+  'Preview not supported for this file type': 'Preview not supported for this file type',
+  'Back': 'Back',
+  'Download': 'Download',
+
+  // Offline download
+  'No offline download tasks': 'No offline download tasks',
+  // Header/File Explorer
+  'Home': 'Home',
+  'File Manager': 'File Manager',
+  'New Folder': 'New Folder',
+  'Upload': 'Upload',
+  'Name': 'Name',
+  'Size': 'Size',
+  'Modified Time': 'Modified Time',
+  'Grid': 'Grid',
+  'List': 'List',
+  'Mount Point': 'Mount Point',
+
+  // Context menu
+  'Upload File': 'Upload File',
+  'Open': 'Open',
+  'Open With': 'Open With',
+  'Default': 'Default',
+  'Rename': 'Rename',
+  'Delete': 'Delete',
+  'Details': 'Details',
+  'Get Direct Link': 'Get Direct Link',
+
+  // Side nav modals
+  'Join Community': 'Join Community',
+  'Scan to join WeChat group': 'Scan to join WeChat group',
+  'If QR expires, add drizzle2001 to join': 'If QR expires, add drizzle2001 to join',
+  'Version Info': 'Version Info',
+  'Current Version': 'Current Version',
+  'Latest Version': 'Latest Version',
+  'New version found: {version}': 'New version found: {version}',
+  'Please update to the latest for features and fixes': 'Please update to the latest for features and fixes',
+  'Open Releases': 'Open Releases',
+  'Changelog': 'Changelog',
+  'Fetching latest version...': 'Fetching latest version...',
+  'Update available': 'Update available',
+  'You are on the latest: {version}': 'You are on the latest: {version}',
+  'Up to date': 'Up to date',
+
+  // Share modal
+  'Share {count} items': 'Share {count} items',
+  'Share link created': 'Share link created',
+  'Create failed': 'Create failed',
+  'Copied to clipboard': 'Copied to clipboard',
+  'Expiration (days)': 'Expiration (days)',
+  'Set 0 or negative for forever': 'Set 0 or negative for forever',
+  'Share link created successfully!': 'Share link created successfully!',
+  'Share Link': 'Share Link',
+  'Share created': 'Share created',
+  'Create Share': 'Create Share',
+  'Done': 'Done',
+  'Create': 'Create',
+
+  // Direct link modal
+  'Failed to generate link': 'Failed to generate link',
+  'Markdown copied to clipboard': 'Markdown copied to clipboard',
+  'Generate a direct link for {name}': 'Generate a direct link for {name}',
+  '1 hour': '1 hour',
+  '1 day': '1 day',
+  '7 days': '7 days',
+  'Generating link...': 'Generating link...',
+  'Link will appear here': 'Link will appear here',
+  'Copy Markdown': 'Copy Markdown',
+  'Close': 'Close',
+
+  // File detail
+  'Camera Make': 'Camera Make',
+  'Camera Model': 'Camera Model',
+  'Capture Time': 'Capture Time',
+  'X Resolution': 'X Resolution',
+  'Y Resolution': 'Y Resolution',
+  'Exposure Time': 'Exposure Time',
+  'Aperture': 'Aperture',
+  'Focal Length': 'Focal Length',
+  'Width': 'Width',
+  'Height': 'Height',
+  'No common EXIF info': 'No common EXIF info',
+  'Bytes': 'Bytes',
+  'File Properties': 'File Properties',
+  'Loading file info...': 'Loading file info...',
+  'Basic Info': 'Basic Info',
+  'Type': 'Type',
+  'Folder': 'Folder',
+  'File': 'File',
+  'Path': 'Path',
+  'Path copied to clipboard': 'Path copied to clipboard',
+  'Copy failed': 'Copy failed',
+  'Permissions': 'Permissions',
+  'EXIF Info': 'EXIF Info',
+
+  // Search dialog
+  'Smart Search': 'Smart Search',
+  'Name Search': 'Name Search',
+  'Search Results': 'Search Results',
+  'No files found': 'No files found',
+  'Relevance': 'Relevance',
+
+  // System settings
+  'Saved successfully': 'Saved successfully',
+  'Save failed': 'Save failed',
+  'Loading...': 'Loading...',
+  'Appearance Settings': 'Appearance Settings',
+  'Theme': 'Theme',
+  'Theme Mode': 'Theme Mode',
+  'Light': 'Light',
+  'Dark': 'Dark',
+  // 'Follow System' used for theme mode
+  'Primary Color': 'Primary Color',
+  'Border Radius': 'Border Radius',
+  'Advanced': 'Advanced',
+  'Override AntD Tokens (JSON)': 'Override AntD Tokens (JSON)',
+  'e.g. {"colorText": "#222"}': 'e.g. {"colorText": "#222"}',
+  'Custom CSS': 'Custom CSS',
+  'Save': 'Save',
+  'App Settings': 'App Settings',
+  'AI Settings': 'AI Settings',
+  'Vision Model': 'Vision Model',
+  'Embedding Model': 'Embedding Model',
+  'Vector Database': 'Vector Database',
+  'Vector Database Settings': 'Vector Database Settings',
+  'Database Type': 'Database Type',
+  'Confirm clear vector database?': 'Confirm clear vector database?',
+  'This will delete all collections irreversibly.': 'This will delete all collections irreversibly.',
+  'Confirm Clear': 'Confirm Clear',
+  // 'Cancel' defined above
+  'Vector database cleared': 'Vector database cleared',
+  'Clear failed': 'Clear failed',
+  'Clear Vector DB': 'Clear Vector DB',
+  'App Name': 'App Name',
+  'Logo URL': 'Logo URL',
+  'App Domain': 'App Domain',
+  'File Domain': 'File Domain',
+  'Vision API URL': 'Vision API URL',
+  'Vision API Key': 'Vision API Key',
+  'Embedding API URL': 'Embedding API URL',
+  'Embedding API Key': 'Embedding API Key',
+
+  // Adapters
+  'Missing required config:': 'Missing required config:',
+  'Updated successfully': 'Updated successfully',
+  'Created successfully': 'Created successfully',
+  'Operation failed': 'Operation failed',
+  'Deleted': 'Deleted',
+  'Delete failed': 'Delete failed',
+  'Status updated': 'Status updated',
+  'Update failed': 'Update failed',
+  'Mount Path': 'Mount Path',
+  'Sub Path': 'Sub Path',
+  'Sub Path (optional)': 'Sub Path (optional)',
+  'Sub directory inside adapter': 'Sub directory inside adapter',
+  'Enabled': 'Enabled',
+  'Actions': 'Actions',
+  'Edit': 'Edit',
+  'Confirm delete?': 'Confirm delete?',
+  'No config fields': 'No config fields',
+  'Please input {label}': 'Please input {label}',
+  'Storage Adapters': 'Storage Adapters',
+  'Create Adapter': 'Create Adapter',
+  'Unique name': 'Unique name',
+  'Select adapter type': 'Select adapter type',
+  '/ or /drive': '/ or /drive',
+  'Adapter Config': 'Adapter Config',
+
+  // Tasks
+  'Automation Tasks': 'Automation Tasks',
+  'Running Tasks': 'Running Tasks',
+  'Create Task': 'Create Task',
+  'Edit Task': 'Edit Task',
+  'Create Automation Task': 'Create Automation Task',
+  'Task Name': 'Task Name',
+  'Trigger Event': 'Trigger Event',
+  'File Written': 'File Written',
+  'File Deleted': 'File Deleted',
+  'Matching Rules': 'Matching Rules',
+  'Path Prefix (optional)': 'Path Prefix (optional)',
+  'Filename Regex (optional)': 'Filename Regex (optional)',
+  'Action': 'Action',
+  'Current Task Queue': 'Current Task Queue',
+  'Params': 'Params',
+  'Status': 'Status',
+
+  // Logs
+  'Confirm clear logs?': 'Confirm clear logs?',
+  'This will delete logs in selected range irreversibly.': 'This will delete logs in selected range irreversibly.',
+  'Cleared {count} logs': 'Cleared {count} logs',
+  'Time': 'Time',
+  'Level': 'Level',
+  'Source': 'Source',
+  'Message': 'Message',
+  'Search source': 'Search source',
+  'Clear': 'Clear',
+  'Log Details': 'Log Details',
+
+  // Backup
+  'Export started, check your downloads.': 'Export started, check your downloads.',
+  'Export failed': 'Export failed',
+  'Confirm import backup?': 'Confirm import backup?',
+  'Are you sure to import from this file?': 'Are you sure to import from this file?',
+  'Warning: This will overwrite all data including users (with passwords), settings, storages and tasks. Irreversible!': 'Warning: This will overwrite all data including users (with passwords), settings, storages and tasks. Irreversible!',
+  'Confirm Import': 'Confirm Import',
+  'Import succeeded! The page will refresh.': 'Import succeeded! The page will refresh.',
+  'Import failed': 'Import failed',
+  'Export': 'Export',
+  'Import': 'Import',
+  'Export all data (adapters, users, tasks, shares) into a JSON file.': 'Export all data (adapters, users, tasks, shares) into a JSON file.',
+  'Keep your backup file safe.': 'Keep your backup file safe.',
+  'Export Backup': 'Export Backup',
+  'Restore data from a previously exported JSON file.': 'Restore data from a previously exported JSON file.',
+  'Warning: This will clear and overwrite existing data.': 'Warning: This will clear and overwrite existing data.',
+  'Choose File and Restore': 'Choose File and Restore',
+
+  // Empty state
+  'No files yet here': 'No files yet here',
+  'This folder is empty': 'This folder is empty',
+  'Start uploading files or create folders to organize your content': 'Start uploading files or create folders to organize your content',
+  'You can create folders or upload files here': 'You can create folders or upload files here',
+
+  // File actions
+  'Please input name': 'Please input name',
+  'Confirm delete {name}?': 'Confirm delete {name}?',
+  'items': 'items',
+  'Downloading folders is not supported': 'Downloading folders is not supported',
+  'Download failed': 'Download failed',
+  'Please select files or folders to share': 'Please select files or folders to share',
+  'Direct links for folders are not supported': 'Direct links for folders are not supported',
+
+  // Processor flow
+  'Processing finished': 'Processing finished',
+  'Processing failed': 'Processing failed',
+
+  // Plugins page
+  'Installed successfully': 'Installed successfully',
+  'Plugin': 'Plugin',
+  'Open Link': 'Open Link',
+  'Link copied': 'Link copied',
+  'Copy Link': 'Copy Link',
+  'Confirm delete this plugin?': 'Confirm delete this plugin?',
+  'Author': 'Author',
+  'Website': 'Website',
+  'Install App': 'Install App',
+  'Search name/author/url/extension': 'Search name/author/url/extension',
+  'No plugins': 'No plugins',
+  'Install': 'Install',
+  'App URL': 'App URL',
+  'Please input a valid URL': 'Please input a valid URL',
+
+  // Setup page
+  'Initialization succeeded! Logging you in...': 'Initialization succeeded! Logging you in...',
+  'Initialization failed, please try later': 'Initialization failed, please try later',
+  'Database Setup': 'Database Setup',
+  'Choose database driver': 'Choose database driver',
+  'Select database and vector database for system data': 'Select database and vector database for system data',
+  'Database Driver': 'Database Driver',
+  'Vector DB Driver': 'Vector DB Driver',
+  'Initialize Mount': 'Initialize Mount',
+  'Configure initial storage': 'Configure initial storage',
+  'Create the first storage mount for your files': 'Create the first storage mount for your files',
+  'Mount Name': 'Mount Name',
+  'Local Storage': 'Local Storage',
+  'Please input mount name!': 'Please input mount name!',
+  'Storage Type': 'Storage Type',
+  'Please input mount path!': 'Please input mount path!',
+  'Root Directory': 'Root Directory',
+  'Please input root directory!': 'Please input root directory!',
+  'e.g., data/ or /var/foxel/data': 'e.g., data/ or /var/foxel/data',
+  'Create Admin': 'Create Admin',
+  'Create admin account': 'Create admin account',
+  'This is the first account with full permissions': 'This is the first account with full permissions',
+  'Username': 'Username',
+  'Full Name': 'Full Name',
+  'Email': 'Email',
+  'Please input a valid email!': 'Please input a valid email!',
+  'Confirm Password': 'Confirm Password',
+  'Please confirm your password!': 'Please confirm your password!',
+  'Passwords do not match!': 'Passwords do not match!',
+  'System Initialization': 'System Initialization',
+  'Previous': 'Previous',
+  'Next': 'Next',
+  'Finish Initialization': 'Finish Initialization',
+
+  // Plugin host
+  'Plugin run failed': 'Plugin run failed',
+  'Plugin Error': 'Plugin Error',
+  'Cannot open file: no available app': 'Cannot open file: no available app',
+  'Error': 'Error',
+  'App "{key}" not found.': 'App "{key}" not found.',
+  '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',
+} as const;
+
+export type EnKeys = keyof typeof en;

web/src/i18n/locales/zh.ts

@@ -0,0 +1,367 @@
+import { en } from './en';
+
+// Start from English defaults, then override with Chinese translations we have.
+export const zh = {
+  ...en,
+
+  // General
+  'All Files': '全部文件',
+  'Manage': '管理',
+  'System': '系统',
+  'Automation': '自动化',
+  'My Shares': '我的分享',
+  'Offline Downloads': '离线下载',
+  'Adapters': '存储挂载',
+  'Plugins': '应用中心',
+  'System Settings': '系统设置',
+  'Backup & Restore': '备份恢复',
+  'System Logs': '系统日志',
+
+  // Top header
+  'Search files / tags / types': '搜索文件 / 标签 / 类型',
+  'Log Out': '退出登录',
+  'Admin': '管理员',
+  'Language': '语言',
+  'Chinese': '中文',
+  'English': '英文',
+
+  // Auth / Login
+  'Welcome Back': '欢迎回来',
+  'Sign in to your Foxel account': '登录到您的 Foxel 账户',
+  'Username / Email': '用户名/邮箱',
+  'Password': '密码',
+  'Sign In': '登录',
+  'Please enter username and password': '请输入用户名与密码',
+  'Login failed': '登录失败',
+  'Your next-generation file manager': '您的下一代文件管理系统',
+  'Cross-platform sync, access anywhere': '跨平台同步，随时随地访问',
+  'AI-powered search for quick find': 'AI 驱动的智能搜索，快速定位文件',
+  'Flexible sharing and collaboration': '灵活的分享与协作，提升团队效率',
+  'Powerful automation to simplify tasks': '强大的自动化工作流，简化繁琐任务',
+  'Join our community:': '加入我们的社区：',
+
+  // Share page
+  'Refresh': '刷新',
+  'Copy': '复制',
+  'Cancel': '取消',
+  'Copied link': '链接已复制',
+  'Share canceled': '分享已取消',
+  'Cancel failed': '取消失败',
+  'Load failed': '加载失败',
+  'Are you sure to cancel share?': '确认取消分享?',
+  'Share Name': '分享名称',
+  'Share Content': '分享内容',
+  'Created At': '创建时间',
+  'Expires At': '过期时间',
+  'Forever': '永久有效',
+  'Access': '访问',
+  'Public': '公开',
+  'By Password': '密码',
+
+  // Public share page
+  'Password Required': '需要密码',
+  'Please enter password': '请输入密码',
+  'Confirm': '确认',
+  'Unable to load share info': '无法加载分享信息',
+  'Share load failed': '加载分享失败',
+  'Wrong password': '密码错误',
+  'Root': '全部文件',
+  'Created on {date}': '创建于 {date}',
+  'Expires on {date}': '将于 {date} 过期',
+  'Download File': '下载文件',
+  'Preview not supported for this file type': '暂不支持在线预览此类型文件',
+  'Back': '返回',
+  'Download': '下载',
+
+  // Header/File Explorer
+  'Home': '主页',
+  'File Manager': '文件管理',
+  'New Folder': '新建目录',
+  'Upload': '上传',
+  'Name': '名称',
+  'Size': '大小',
+  'Modified Time': '修改时间',
+  'Grid': '网格',
+  'List': '列表',
+  'Mount Point': '挂载点',
+
+  // Context menu
+  'Upload File': '上传文件',
+  'Open': '打开',
+  'Open With': '打开方式',
+  'Default': '默认',
+  'Rename': '重命名',
+  'Delete': '删除',
+  'Details': '详情',
+  'Get Direct Link': '获取直链',
+
+  // Side nav modals
+  'Join Community': '加入社区',
+  'Scan to join WeChat group': '微信扫码加入交流群',
+  'If QR expires, add drizzle2001 to join': '如二维码失效，请添加 drizzle2001 拉群',
+  'Version Info': '版本信息',
+  'Current Version': '当前版本',
+  'Latest Version': '最新版本',
+  'New version found: {version}': '发现新版本: {version}',
+  'Please update to the latest for features and fixes': '建议尽快更新到最新版本，以获得新功能和安全修复。',
+  'Open Releases': '前往发布页面',
+  'Changelog': '更新日志',
+  'Fetching latest version...': '正在获取最新版本信息...',
+  'Update available': '有更新',
+  'You are on the latest: {version}': '当前为最新版: {version}',
+  'Up to date': '已是最新版',
+
+  // Share modal
+  'Share {count} items': '分享 {count} 个项目',
+  'Share link created': '分享链接已创建',
+  'Create failed': '创建失败',
+  'Copied to clipboard': '已复制到剪贴板',
+  'Expiration (days)': '有效期 (天)',
+  'Set 0 or negative for forever': '设置为 0 或负数表示永久有效',
+  'Share link created successfully!': '分享链接已成功创建！',
+  'Share Link': '分享链接',
+  'Share created': '分享创建成功',
+  'Create Share': '创建分享',
+  'Done': '完成',
+  'Create': '创建',
+
+  // Direct link modal
+  'Failed to generate link': '生成链接失败',
+  'Markdown copied to clipboard': 'Markdown 格式已复制到剪贴板',
+  'Generate a direct link for {name}': '为 {name} 生成一个直接访问链接。',
+  '1 hour': '1 小时',
+  '1 day': '1 天',
+  '7 days': '7 天',
+  'Generating link...': '正在生成链接...',
+  'Link will appear here': '链接将显示在这里',
+  'Copy Markdown': '复制 Markdown',
+  'Close': '关闭',
+
+  // File detail
+  'Camera Make': '设备品牌',
+  'Camera Model': '设备型号',
+  'Capture Time': '拍摄时间',
+  'X Resolution': '水平分辨率',
+  'Y Resolution': '垂直分辨率',
+  'Exposure Time': '曝光时间',
+  'Aperture': '光圈值',
+  'Focal Length': '焦距',
+  'Width': '宽度',
+  'Height': '高度',
+  'No common EXIF info': '无常见EXIF信息',
+  'Bytes': '字节',
+  'File Properties': '文件属性',
+  'Loading file info...': '加载文件信息...',
+  'Basic Info': '基本信息',
+  'Type': '类型',
+  'Folder': '文件夹',
+  'File': '文件',
+  'Path': '路径',
+  'Path copied to clipboard': '路径已复制到剪贴板',
+  'Copy failed': '复制失败',
+  'Permissions': '权限',
+  'EXIF Info': 'EXIF信息',
+
+  // Search dialog
+  'Smart Search': '智能搜索',
+  'Name Search': '名称搜索',
+  'Search Results': '搜索结果',
+  'No files found': '未找到相关文件',
+  'Relevance': '相关度',
+
+  // System settings
+  'Saved successfully': '保存成功',
+  'Save failed': '保存失败',
+  'Loading...': '加载中...',
+  'Appearance Settings': '外观设置',
+  'Theme': '主题',
+  'Theme Mode': '主题模式',
+  'Light': '亮色',
+  'Dark': '暗色',
+  // 'Follow System' used for theme mode
+  'Follow System': '跟随系统',
+  'Primary Color': '主色',
+  'Border Radius': '圆角',
+  'Advanced': '高级',
+  'Override AntD Tokens (JSON)': '覆盖 AntD Token（JSON）',
+  'e.g. {"colorText": "#222"}': '例如：{"colorText": "#222"}',
+  'Custom CSS': '自定义 CSS',
+  'Save': '保存',
+  'App Settings': '应用设置',
+  'AI Settings': 'AI设置',
+  'Vision Model': '视觉模型',
+  'Embedding Model': '嵌入模型',
+  'Vector Database': '向量数据库',
+  'Vector Database Settings': '向量数据库设置',
+  'Database Type': '数据库类型',
+  'Confirm clear vector database?': '确认清空向量数据库？',
+  'This will delete all collections irreversibly.': '此操作将删除所有集合中的所有数据，且不可逆。',
+  'Confirm Clear': '确认清空',
+  // 'Cancel' defined above
+  'Vector database cleared': '向量数据库已清空',
+  'Clear failed': '清空失败',
+  'Clear Vector DB': '清空向量库',
+  'App Name': '应用名称',
+  'Logo URL': 'LOGO地址',
+  'App Domain': '应用域名',
+  'File Domain': '文件域名',
+  'Vision API URL': '视觉模型 API 地址',
+  'Vision API Key': '视觉模型 API Key',
+  'Embedding API URL': '嵌入模型 API 地址',
+  'Embedding API Key': '嵌入模型 API Key',
+
+  // Adapters
+  'Missing required config:': '缺少必填配置:',
+  'Updated successfully': '更新成功',
+  'Created successfully': '创建成功',
+  'Operation failed': '操作失败',
+  'Deleted': '已删除',
+  'Delete failed': '删除失败',
+  'Status updated': '状态已更新',
+  'Update failed': '更新失败',
+  'Mount Path': '挂载路径',
+  'Sub Path': '子路径',
+  'Sub Path (optional)': '子路径(可选)',
+  'Sub directory inside adapter': '适配器内部子目录',
+  'Enabled': '启用',
+  'Actions': '操作',
+  'Edit': '编辑',
+  'Confirm delete?': '确认删除?',
+  'No config fields': '无配置项',
+  'Please input {label}': '请输入{label}',
+  'Storage Adapters': '存储适配器',
+  'Create Adapter': '新建适配器',
+  'Unique name': '唯一名称',
+  'Select adapter type': '选择适配器类型',
+  '/ or /drive': '/或/drive',
+  'Adapter Config': '适配器配置',
+
+  // Tasks
+  'Automation Tasks': '自动化任务',
+  'Running Tasks': '运行中的任务',
+  'Create Task': '新建任务',
+  'Edit Task': '编辑任务',
+  'Create Automation Task': '新建自动化任务',
+  'Task Name': '任务名称',
+  'Trigger Event': '触发事件',
+  'File Written': '文件写入',
+  'File Deleted': '文件删除',
+  'Matching Rules': '匹配规则',
+  'Path Prefix (optional)': '路径前缀 (可选)',
+  'Filename Regex (optional)': '文件名正则 (可选)',
+  'Action': '执行动作',
+  'Current Task Queue': '当前任务队列',
+  'Params': '参数',
+  'Status': '状态',
+
+  // Logs
+  'Confirm clear logs?': '确认清理日志?',
+  'This will delete logs in selected range irreversibly.': '该操作将删除选定时间范围内的所有日志，且不可恢复。',
+  'Cleared {count} logs': '成功清理 {count} 条日志',
+  'Time': '时间',
+  'Level': '级别',
+  'Source': '来源',
+  'Message': '消息',
+  'Search source': '搜索来源',
+  'Clear': '清理',
+  'Log Details': '日志详情',
+
+  // Backup
+  'Export started, check your downloads.': '导出已开始，请检查您的下载。',
+  'Export failed': '导出失败',
+  'Confirm import backup?': '确认导入备份?',
+  'Are you sure to import from this file?': '您确定要从此文件导入数据吗?',
+  'Warning: This will overwrite all data including users (with passwords), settings, storages and tasks. Irreversible!': '警告：此操作将覆盖当前数据库中的所有现有数据，包括用户（含密码）、设置、存储和任务。此操作不可逆！',
+  'Confirm Import': '确认导入',
+  'Import succeeded! The page will refresh.': '导入成功！页面将刷新。',
+  'Import failed': '导入失败',
+  'Export': '导出',
+  'Import': '恢复',
+  'Export all data (adapters, users, tasks, shares) into a JSON file.': '点击按钮将所有数据（包括存储、用户、自动化任务和分享）导出为一个 JSON 文件。',
+  'Keep your backup file safe.': '请妥善保管您的备份文件。',
+  'Export Backup': '导出备份',
+  'Restore data from a previously exported JSON file.': '从之前导出的JSON文件恢复数据。',
+  'Warning: This will clear and overwrite existing data.': '警告：此操作将清除并覆盖现有数据。',
+  'Choose File and Restore': '选择文件并恢复',
+
+  // Empty state
+  'No files yet here': '这里还没有任何文件',
+  'This folder is empty': '此目录为空',
+  'Start uploading files or create folders to organize your content': '开始上传文件或创建新目录来组织您的内容',
+  'You can create folders or upload files here': '您可以在此目录中创建新的文件夹或上传文件',
+
+  // File actions
+  'Please input name': '请输入名称',
+  'Confirm delete {name}?': '确认删除 {name} ?',
+  'items': '项',
+  'Downloading folders is not supported': '暂不支持下载目录',
+  'Download failed': '下载失败',
+  'Please select files or folders to share': '请选择要分享的文件或目录',
+  'Direct links for folders are not supported': '不支持获取目录的直链',
+
+  // Processor flow
+  'Processing finished': '处理完成',
+  'Processing failed': '处理失败',
+
+  // Plugins page
+  'Installed successfully': '安装成功',
+  'Plugin': '插件',
+  'Open Link': '打开链接',
+  'Link copied': '已复制链接',
+  'Copy Link': '复制链接',
+  'Confirm delete this plugin?': '确认删除该插件？',
+  'Author': '作者',
+  'Website': '官网',
+  'Install App': '安装应用',
+  'Search name/author/url/extension': '搜索 名称/作者/链接/扩展名',
+  'No plugins': '暂无插件',
+  'Install': '安装',
+  'App URL': '应用链接',
+  'Please input a valid URL': '请输入合法的 URL',
+
+  // Setup page
+  'Initialization succeeded! Logging you in...': '初始化成功！正在为您登录，请不要刷新。',
+  'Initialization failed, please try later': '初始化失败，请稍后重试',
+  'Database Setup': '数据库设置',
+  'Choose database driver': '选择数据库驱动',
+  'Select database and vector database for system data': '选择用于存储系统数据的数据库和向量数据库。',
+  'Database Driver': '数据库驱动',
+  'Vector DB Driver': '向量数据库驱动',
+  'Initialize Mount': '初始化挂载',
+  'Configure initial storage': '配置初始存储',
+  'Create the first storage mount for your files': '为您的文件创建第一个存储挂载点。',
+  'Mount Name': '挂载名称',
+  'Local Storage': '本地存储',
+  'Please input mount name!': '请输入挂载名称！',
+  'Storage Type': '存储类型',
+  'Please input mount path!': '请输入挂载路径！',
+  'Root Directory': '根目录',
+  'Please input root directory!': '请输入根目录！',
+  'e.g., data/ or /var/foxel/data': '例如: data/ 或 /var/foxel/data',
+  'Create Admin': '创建管理员',
+  'Create admin account': '创建管理员账户',
+  'This is the first account with full permissions': '这是系统的第一个账户，将拥有最高权限。',
+  'Username': '用户名',
+  'Full Name': '昵称',
+  'Email': '邮箱',
+  'Please input a valid email!': '请输入有效的邮箱地址！',
+  'Confirm Password': '确认密码',
+  'Please confirm your password!': '请确认您的密码！',
+  'Passwords do not match!': '两次输入的密码不一致！',
+  'System Initialization': '系统初始化',
+  'Previous': '上一步',
+  'Next': '下一步',
+  'Finish Initialization': '完成初始化',
+
+  // Plugin host
+  'Plugin run failed': '插件运行失败',
+  'Plugin Error': '插件错误',
+  'Cannot open file: no available app': '无法打开该文件：没有可用的应用',
+  'Error': '错误',
+  'App "{key}" not found.': '应用 "{key}" 不存在。',
+  'Open with {app}': '使用 {app} 打开',
+  'Set as default for .{ext}': '设为该类型(.{ext})默认应用',
+  'Advanced tokens must be valid JSON': '高级 Token 需为合法 JSON',
+} as const;
+
+export type ZhKeys = keyof typeof zh;

web/src/layout/SearchDialog.tsx

@@ -2,6 +2,7 @@ import { Modal, Input, List, Divider, Spin, Select, Space } from 'antd';
 import { SearchOutlined, FileTextOutlined } from '@ant-design/icons';
 import React, { useState } from 'react';
 import { vfsApi, type SearchResultItem } from '../api/vfs';
+import { useI18n } from '../i18n';
 import { useNavigate } from 'react-router';
 
 
@@ -10,9 +11,9 @@ interface SearchDialogProps {
   onClose: () => void;
 }
 
-const SEARCH_MODES = [
-  { label: '智能搜索', value: 'vector' },
-  { label: '名称搜索', value: 'filename' },
+const SEARCH_MODES = (t: (k: string)=>string) => [
+  { label: t('Smart Search'), value: 'vector' },
+  { label: t('Name Search'), value: 'filename' },
 ];
 
 const SearchDialog: React.FC<SearchDialogProps> = ({ open, onClose }) => {
@@ -21,6 +22,7 @@ const SearchDialog: React.FC<SearchDialogProps> = ({ open, onClose }) => {
   const [results, setResults] = useState<SearchResultItem[]>([]);
   const [searched, setSearched] = useState(false);
   const [searchMode, setSearchMode] = useState<'vector' | 'filename'>('vector');
+  const { t } = useI18n();
   const navigate = useNavigate();
 
   const handleSearch = async () => {
@@ -48,7 +50,7 @@ const SearchDialog: React.FC<SearchDialogProps> = ({ open, onClose }) => {
     >
       <Space.Compact style={{ marginBottom: 0, width: '100%' }}>
         <Select
-          options={SEARCH_MODES}
+          options={SEARCH_MODES(t)}
           value={searchMode}
           onChange={v => setSearchMode(v as 'vector' | 'filename')}
           style={{
@@ -67,7 +69,7 @@ const SearchDialog: React.FC<SearchDialogProps> = ({ open, onClose }) => {
         <Input
           allowClear
           prefix={<SearchOutlined />}
-          placeholder="搜索文件 / 标签 / 类型"
+          placeholder={t('Search files / tags / types')}
           value={search}
           onChange={e => setSearch(e.target.value)}
           style={{
@@ -84,14 +86,14 @@ const SearchDialog: React.FC<SearchDialogProps> = ({ open, onClose }) => {
       </Space.Compact>
       {searched && (
         <>
-          <Divider style={{ margin: '12px 0' }}>搜索结果</Divider>
+          <Divider style={{ margin: '12px 0' }}>{t('Search Results')}</Divider>
           {loading ? (
             <Spin />
           ) : (
             <List
               itemLayout="horizontal"
               dataSource={results}
-              locale={{ emptyText: '未找到相关文件' }}
+              locale={{ emptyText: t('No files found') }}
               renderItem={item => {
                 const fullPath = item.path || '';
                 const trimmed = fullPath.replace(/\/+$/, '');
@@ -112,7 +114,7 @@ const SearchDialog: React.FC<SearchDialogProps> = ({ open, onClose }) => {
                           {fullPath}
                         </a>
                       }
-                      description={`相关度: ${item.score.toFixed(2)}`}
+                      description={`${t('Relevance')}: ${item.score.toFixed(2)}`}
                     />
                   </List.Item>
                 );

web/src/layout/SideNav.tsx

@@ -15,6 +15,8 @@ import {
 import '../styles/sider-menu.css';
 import { getLatestVersion } from '../api/config.ts';
 import ReactMarkdown from 'react-markdown';
+import { useTheme } from '../contexts/ThemeContext';
+import { useI18n } from '../i18n';
 const { Sider } = Layout;
 
 export interface SideNavProps {
@@ -27,6 +29,8 @@ export interface SideNavProps {
 const SideNav = memo(function SideNav({ collapsed, activeKey, onChange, onToggle }: SideNavProps) {
   const status = useSystemStatus();
   const { token } = theme.useToken();
+  const { resolvedMode } = useTheme();
+  const { t } = useI18n();
   const [isModalOpen, setIsModalOpen] = useState(false);
   const [isVersionModalOpen, setIsVersionModalOpen] = useState(false);
   const [latestVersion, setLatestVersion] = useState<{
@@ -85,10 +89,16 @@ const SideNav = memo(function SideNav({ collapsed, activeKey, onChange, onToggle
                 height: 24,
                 objectFit: 'contain',
                 marginRight: collapsed ? 0 : 8,
-                ...(status?.logo?.endsWith('.svg') && { filter: 'brightness(0) saturate(100%)' })
+                ...(resolvedMode === 'dark'
+                  ? { filter: 'brightness(0) invert(1)' }
+                  : (status?.logo?.endsWith('.svg') ? { filter: 'brightness(0) saturate(100%)' } : {}))
               }}
             />
-            {!collapsed && <span style={{ fontWeight: 700 }}>{status?.title}</span>}
+            {!collapsed && (
+              <span style={{ fontWeight: 700, color: resolvedMode === 'dark' ? '#fff' : token.colorText }}>
+                {status?.title}
+              </span>
+            )}
           </div>
           {/* 展开时显示收缩按钮 */}
           {!collapsed && (
@@ -114,7 +124,7 @@ const SideNav = memo(function SideNav({ collapsed, activeKey, onChange, onToggle
                     color: token.colorTextTertiary,
                     textTransform: 'uppercase'
                   }}
-                >{group.title}</div>
+                >{t(group.title)}</div>
               )}
               <Menu
                 mode="inline"
@@ -122,7 +132,7 @@ const SideNav = memo(function SideNav({ collapsed, activeKey, onChange, onToggle
                 inlineIndent={12}
                 selectedKeys={[activeKey]}
                 onClick={(e) => onChange(e.key)}
-                items={group.children.map((i: NavItem) => ({ key: i.key, icon: i.icon, label: i.label }))}
+                items={group.children.map((i: NavItem) => ({ key: i.key, icon: i.icon, label: t(i.label) }))}
                 style={{ borderInline: 'none', background: 'transparent' }}
                 className="sider-menu-group foxel-sider-menu"
               />
@@ -154,26 +164,26 @@ const SideNav = memo(function SideNav({ collapsed, activeKey, onChange, onToggle
             cursor: 'pointer'
           }} onClick={showVersionModal}>
             {hasUpdate ? (
-              <Tooltip title={`发现新版本: ${latestVersion?.version}`} placement={collapsed ? 'right' : 'top'}>
+              <Tooltip title={t('New version found: {version}', { version: latestVersion?.version || '' })} placement={collapsed ? 'right' : 'top'}>
                 <a rel="noopener noreferrer"
                   style={{ textDecoration: 'none' }}>
                   {collapsed ? (
                     <Tag icon={<WarningOutlined />} color="warning" style={{ marginInlineEnd: 0 }} />
                   ) : (
                     <Tag icon={<WarningOutlined />} color="warning">
-                      {status?.version} - 有更新 [{latestVersion?.version}]
+                      {status?.version} - {t('Update available')} [{latestVersion?.version}]
                     </Tag>
                   )}
                 </a>
               </Tooltip>
             ) : (
               latestVersion ? (
-                <Tooltip title={`当前为最新版: ${status?.version}`} placement={collapsed ? 'right' : 'top'}>
+                <Tooltip title={t('You are on the latest: {version}', { version: status?.version || '' })} placement={collapsed ? 'right' : 'top'}>
                   {collapsed ? (
                     <Tag icon={<CheckCircleOutlined />} color="success" style={{ marginInlineEnd: 0 }} />
                   ) : (
                     <Tag icon={<CheckCircleOutlined />} color="success">
-                      已是最新版
+                      {t('Up to date')}
                     </Tag>
                   )}
                 </Tooltip>
@@ -213,24 +223,24 @@ const SideNav = memo(function SideNav({ collapsed, activeKey, onChange, onToggle
       <Modal
         open={isModalOpen}
         onCancel={() => setIsModalOpen(false)}
-        title="加入社区"
+        title={t('Join Community')}
         footer={null}
         width={320}
       >
         <div style={{ textAlign: 'center', padding: '12px 0' }}>
           <img src="https://foxel.cc/image/wechat.png" width={200} alt="wechat" />
           <div style={{ marginTop: 12, color: token.colorTextSecondary }}>
-            微信扫码加入交流群
+            {t('Scan to join WeChat group')}
           </div>
           <div style={{ marginTop: 8, fontSize: 12, color: token.colorTextTertiary }}>
-            如二维码失效，请添加 drizzle2001 拉群
+            {t('If QR expires, add drizzle2001 to join')}
           </div>
         </div>
       </Modal>
       <Modal
         open={isVersionModalOpen}
         onCancel={() => setIsVersionModalOpen(false)}
-        title="版本信息"
+        title={t('Version Info')}
         footer={null}
         width={600}
       >
@@ -238,18 +248,18 @@ const SideNav = memo(function SideNav({ collapsed, activeKey, onChange, onToggle
           {latestVersion ? (
             <>
               <Descriptions bordered column={1} size="small">
-                <Descriptions.Item label="当前版本">
+                <Descriptions.Item label={t('Current Version')}>
                   <Tag>{status?.version}</Tag>
                 </Descriptions.Item>
-                <Descriptions.Item label="最新版本">
+                <Descriptions.Item label={t('Latest Version')}>
                   <Tag color={hasUpdate ? 'orange' : 'green'}>{latestVersion.version}</Tag>
                 </Descriptions.Item>
               </Descriptions>
 
               {hasUpdate && (
                 <Alert
-                  message={<span style={{ color: token.colorText }}>{`发现新版本: ${latestVersion.version}`}</span>}
-                  description={<span style={{ color: token.colorTextSecondary }}>建议尽快更新到最新版本，以获得新功能和安全修复。</span>}
+                  message={<span style={{ color: token.colorText }}>{t('New version found: {version}', { version: latestVersion.version })}</span>}
+                  description={<span style={{ color: token.colorTextSecondary }}>{t('Please update to the latest for features and fixes')}</span>}
                   type="info"
                   showIcon
                   style={{ marginTop: 24, marginBottom: 24, background: token.colorInfoBg, borderColor: token.colorInfoBorder }}
@@ -261,13 +271,13 @@ const SideNav = memo(function SideNav({ collapsed, activeKey, onChange, onToggle
                       target="_blank"
                       icon={<GithubOutlined />}
                     >
-                      前往发布页面
+                      {t('Open Releases')}
                     </Button>
                   }
                 />
               )}
 
-              <Divider orientation="left" plain>更新日志</Divider>
+              <Divider orientation="left" plain>{t('Changelog')}</Divider>
               <div style={{
                 maxHeight: '40vh',
                 overflowY: 'auto',
@@ -297,7 +307,7 @@ const SideNav = memo(function SideNav({ collapsed, activeKey, onChange, onToggle
           ) : (
             <div style={{ textAlign: 'center', padding: '40px 0', color: token.colorTextSecondary }}>
               <Spin size="large" />
-              <p style={{ marginTop: 16 }}>正在获取最新版本信息...</p>
+              <p style={{ marginTop: 16 }}>{t('Fetching latest version...')}</p>
             </div>
           )}
         </div>

web/src/layout/TopHeader.tsx

@@ -4,6 +4,8 @@ import { memo, useState } from 'react';
 import SearchDialog from './SearchDialog.tsx';
 import { authApi } from '../api/auth.ts';
 import { useNavigate } from 'react-router';
+import { useI18n } from '../i18n';
+import LanguageSwitcher from '../components/LanguageSwitcher';
 
 const { Header } = Layout;
 
@@ -16,6 +18,7 @@ const TopHeader = memo(function TopHeader({ collapsed, onToggle }: TopHeaderProp
   const { token } = theme.useToken();
   const [searchOpen, setSearchOpen] = useState(false);
   const navigate = useNavigate();
+  const { t } = useI18n();
 
   const handleLogout = () => {
     authApi.logout();
@@ -37,18 +40,19 @@ const TopHeader = memo(function TopHeader({ collapsed, onToggle }: TopHeaderProp
         style={{ maxWidth: 420 }}
         onClick={() => setSearchOpen(true)}
       >
-        搜索文件 / 标签 / 类型
+        {t('Search files / tags / types')}
       </Button>
       <SearchDialog open={searchOpen} onClose={() => setSearchOpen(false)} />
       <Flex style={{ marginLeft: 'auto' }} align="center" gap={12}>
+        <LanguageSwitcher />
         <Dropdown
           menu={{
             items: [
-              { key: 'logout', label: '退出登录', icon: <LogoutOutlined />, onClick: handleLogout }
+              { key: 'logout', label: t('Log Out'), icon: <LogoutOutlined />, onClick: handleLogout }
             ]
           }}
         >
-          <Button icon={<UserOutlined />}>管理员</Button>
+          <Button icon={<UserOutlined />}>{t('Admin')}</Button>
         </Dropdown>
       </Flex>
     </Header>

web/src/layout/nav.ts

@@ -8,6 +8,7 @@ import {
   RobotOutlined,
   BugOutlined,
   DatabaseOutlined,
+  AppstoreOutlined,
 } from '@ant-design/icons';
 import type { ReactNode } from 'react';
 
@@ -19,26 +20,27 @@ export const navGroups: NavGroup[] = [
     key: 'library',
     title: '',
     children: [
-      { key: 'files', icon: React.createElement(FolderOpenOutlined), label: '全部文件' },
+      { key: 'files', icon: React.createElement(FolderOpenOutlined), label: 'All Files' },
     ]
   },
   {
     key: 'manage',
-    title: '管理',
+    title: 'Manage',
     children: [
-      { key: 'tasks', icon: React.createElement(RobotOutlined), label: '自动化' },
-      { key: 'share', icon: React.createElement(ShareAltOutlined), label: '我的分享' },
-      { key: 'offline', icon: React.createElement(CloudDownloadOutlined), label: '离线下载' },
-      { key: 'adapters', icon: React.createElement(ApiOutlined), label: '存储挂载' },
+      { key: 'tasks', icon: React.createElement(RobotOutlined), label: 'Automation' },
+      { key: 'share', icon: React.createElement(ShareAltOutlined), label: 'My Shares' },
+      { key: 'offline', icon: React.createElement(CloudDownloadOutlined), label: 'Offline Downloads' },
+      { key: 'adapters', icon: React.createElement(ApiOutlined), label: 'Adapters' },
+      { key: 'plugins', icon: React.createElement(AppstoreOutlined), label: 'Plugins' },
     ]
   },
   {
     key: 'system',
-    title: '系统',
+    title: 'System',
     children: [
-      { key: 'settings', icon: React.createElement(SettingOutlined), label: '系统设置' },
-      { key: 'backup', icon: React.createElement(DatabaseOutlined), label: '备份恢复' },
-      { key: 'logs', icon: React.createElement(BugOutlined), label: '系统日志' }
+      { key: 'settings', icon: React.createElement(SettingOutlined), label: 'System Settings' },
+      { key: 'backup', icon: React.createElement(DatabaseOutlined), label: 'Backup & Restore' },
+      { key: 'logs', icon: React.createElement(BugOutlined), label: 'System Logs' }
     ]
   }
 ];

web/src/main.tsx

@@ -1,17 +1,12 @@
 import { createRoot } from 'react-dom/client';
 import App from './App.tsx';
 import '@ant-design/v5-patch-for-react-19';
-import { ConfigProvider } from 'antd';
-import zhCN from 'antd/locale/zh_CN';
 import 'antd/dist/reset.css';
-import foxelTheme from './theme';
 import './global.css';
 import { BrowserRouter } from 'react-router';
 
 createRoot(document.getElementById('root')!).render(
-  <ConfigProvider locale={zhCN} theme={foxelTheme}>
-    <BrowserRouter>
-      <App />
-    </BrowserRouter>
-  </ConfigProvider>
+  <BrowserRouter>
+    <App />
+  </BrowserRouter>
 );

web/src/pages/AdaptersPage.tsx

@@ -2,6 +2,7 @@ import { memo, useState, useEffect, useCallback } from 'react';
 import { Table, Button, Space, Drawer, Form, Input, Switch, message, Typography, Popconfirm, Select } from 'antd';
 import PageCard from '../components/PageCard';
 import { adaptersApi, type AdapterItem } from '../api/client';
+import { useI18n } from '../i18n';
 
 
 interface AdapterTypeField {
@@ -25,6 +26,7 @@ const AdaptersPage = memo(function AdaptersPage() {
   const [editing, setEditing] = useState<AdapterItem | null>(null);
   const [form] = Form.useForm();
   const [availableTypes, setAvailableTypes] = useState<AdapterTypeMeta[]>([]);
+  const { t } = useI18n();
 
   const fetchList = useCallback(async () => {
     setLoading(true);
@@ -36,7 +38,7 @@ const AdaptersPage = memo(function AdaptersPage() {
       setData(list);
       setAvailableTypes(types);
     } catch (e: any) {
-      message.error(e.message || '加载失败');
+      message.error(e.message || t('Load failed'));
     } finally {
       setLoading(false);
     }
@@ -90,7 +92,7 @@ const AdaptersPage = memo(function AdaptersPage() {
         }
       });
       if (miss.length) {
-        message.error('缺少必填配置: ' + miss.join(', '));
+        message.error(t('Missing required config:') + ' ' + miss.join(', '));
         return;
       }
       const body = {
@@ -104,17 +106,17 @@ const AdaptersPage = memo(function AdaptersPage() {
       setLoading(true);
       if (editing) {
         await adaptersApi.update(editing.id, body as any);
-        message.success('更新成功');
+        message.success(t('Updated successfully'));
       } else {
         await adaptersApi.create(body as any);
-        message.success('创建成功');
+        message.success(t('Created successfully'));
       }
       setOpen(false);
       setEditing(null);
       fetchList();
     } catch (e: any) {
       if (e?.errorFields) return; // 表单校验
-      message.error(e.message || '操作失败');
+      message.error(e.message || t('Operation failed'));
     } finally {
       setLoading(false);
     }
@@ -123,10 +125,10 @@ const AdaptersPage = memo(function AdaptersPage() {
   const doDelete = async (rec: AdapterItem) => {
     try {
       await adaptersApi.remove(rec.id);
-      message.success('已删除');
+      message.success(t('Deleted'));
       fetchList();
     } catch (e: any) {
-      message.error(e.message || '删除失败');
+      message.error(e.message || t('Delete failed'));
     }
   };
 
@@ -134,22 +136,22 @@ const AdaptersPage = memo(function AdaptersPage() {
     try {
       setLoading(true);
       await adaptersApi.update(rec.id, { ...rec, enabled: checked });
-      message.success('状态已更新');
+      message.success(t('Status updated'));
       fetchList();
     } catch (e: any) {
-      message.error(e.message || '更新失败');
+      message.error(e.message || t('Update failed'));
     } finally {
       setLoading(false);
     }
   };
 
   const columns = [
-    { title: '名称', dataIndex: 'name' },
-    { title: '类型', dataIndex: 'type', width: 100 },
-    { title: '挂载路径', dataIndex: 'path', width: 140, render: (v: string) => v || '-' },
-    { title: '子路径', dataIndex: 'sub_path', width: 140, render: (v: string) => v || '-' },
+    { title: t('Name'), dataIndex: 'name' },
+    { title: t('Type'), dataIndex: 'type', width: 100 },
+    { title: t('Mount Path'), dataIndex: 'path', width: 140, render: (v: string) => v || '-' },
+    { title: t('Sub Path'), dataIndex: 'sub_path', width: 140, render: (v: string) => v || '-' },
     {
-      title: '启用',
+      title: t('Enabled'),
       dataIndex: 'enabled',
       width: 80,
       render: (v: boolean, rec: AdapterItem) => (
@@ -162,13 +164,13 @@ const AdaptersPage = memo(function AdaptersPage() {
       )
     },
     {
-      title: '操作',
+      title: t('Actions'),
       width: 160,
       render: (_: any, rec: AdapterItem) => (
         <Space size="small">
-          <Button size="small" onClick={() => openEdit(rec)}>编辑</Button>
-          <Popconfirm title="确认删除?" onConfirm={() => doDelete(rec)}>
-            <Button size="small" danger>删除</Button>
+          <Button size="small" onClick={() => openEdit(rec)}>{t('Edit')}</Button>
+          <Popconfirm title={t('Confirm delete?')} onConfirm={() => doDelete(rec)}>
+            <Button size="small" danger>{t('Delete')}</Button>
           </Popconfirm>
         </Space>
       )
@@ -179,9 +181,9 @@ const AdaptersPage = memo(function AdaptersPage() {
   const currentTypeMeta = availableTypes.find(t => t.type === selectedType);
 
   function renderConfigFields() {
-    if (!currentTypeMeta) return <Typography.Text type="secondary">无配置项</Typography.Text>;
+    if (!currentTypeMeta) return <Typography.Text type="secondary">{t('No config fields')}</Typography.Text>;
     return currentTypeMeta.config_schema.map(field => {
-      const rules = field.required ? [{ required: true, message: `请输入${field.label}` }] : [];
+      const rules = field.required ? [{ required: true, message: t('Please input {label}', { label: field.label }) }] : [];
       let inputNode: any = <Input placeholder={field.placeholder} />;
       if (field.type === 'password') inputNode = <Input.Password placeholder={field.placeholder} />;
       if (field.type === 'number') inputNode = <Input type="number" placeholder={field.placeholder} />;
@@ -189,7 +191,7 @@ const AdaptersPage = memo(function AdaptersPage() {
         <Form.Item
           key={field.key}
           name={['config', field.key]}
-          label={field.label}
+          label={t(field.label)}
           rules={rules}
         >
           {inputNode}
@@ -200,11 +202,11 @@ const AdaptersPage = memo(function AdaptersPage() {
 
   return (
     <PageCard
-      title="存储适配器"
+      title={t('Storage Adapters')}
       extra={
         <Space>
-          <Button onClick={fetchList} loading={loading}>刷新</Button>
-          <Button type="primary" onClick={openCreate}>新建适配器</Button>
+          <Button onClick={fetchList} loading={loading}>{t('Refresh')}</Button>
+          <Button type="primary" onClick={openCreate}>{t('Create Adapter')}</Button>
         </Space>
       }
     >
@@ -217,15 +219,15 @@ const AdaptersPage = memo(function AdaptersPage() {
         style={{ marginBottom: 0 }}
       />
       <Drawer
-        title={editing ? `编辑: ${editing.name}` : '新建适配器'}
+        title={editing ? `${t('Edit')}: ${editing.name}` : t('Create Adapter')}
         width={480}
         open={open}
         onClose={() => { setOpen(false); setEditing(null); }}
         destroyOnClose
         extra={
           <Space>
-            <Button onClick={() => { setOpen(false); setEditing(null); }}>取消</Button>
-            <Button type="primary" onClick={submit} loading={loading}>提交</Button>
+            <Button onClick={() => { setOpen(false); setEditing(null); }}>{t('Cancel')}</Button>
+            <Button type="primary" onClick={submit} loading={loading}>{t('Submit')}</Button>
           </Space>
         }
       >
@@ -234,12 +236,12 @@ const AdaptersPage = memo(function AdaptersPage() {
           layout="vertical"
           initialValues={{ enabled: true }}
         >
-          <Form.Item name="name" label="名称" rules={[{ required: true, message: '请输入名称' }]}>
-            <Input placeholder="唯一名称" />
+          <Form.Item name="name" label={t('Name')} rules={[{ required: true, message: t('Please input {label}', { label: t('Name') }) }]}>
+            <Input placeholder={t('Unique name')} />
           </Form.Item>
-          <Form.Item name="type" label="类型" rules={[{ required: true }]}>
+          <Form.Item name="type" label={t('Type')} rules={[{ required: true }]}>
             <Select
-              placeholder="选择适配器类型"
+              placeholder={t('Select adapter type')}
               options={availableTypes.map(t => ({ value: t.type, label: `${t.name} (${t.type})` }))}
               onChange={() => {
                 const t = availableTypes.find(v => v.type === form.getFieldValue('type'));
@@ -251,16 +253,16 @@ const AdaptersPage = memo(function AdaptersPage() {
               }}
             />
           </Form.Item>
-          <Form.Item name="path" label="挂载路径" rules={[{ required: true, message: '请输入挂载路径' }]}>
-            <Input placeholder="/或/drive" />
+          <Form.Item name="path" label={t('Mount Path')} rules={[{ required: true, message: t('Please input {label}', { label: t('Mount Path') }) }]}>
+            <Input placeholder={t('/ or /drive')} />
           </Form.Item>
-          <Form.Item name="sub_path" label="子路径(可选)">
-            <Input placeholder="适配器内部子目录" />
+          <Form.Item name="sub_path" label={t('Sub Path (optional)')}>
+            <Input placeholder={t('Sub directory inside adapter')} />
           </Form.Item>
-          <Form.Item name="enabled" label="启用" valuePropName="checked">
+          <Form.Item name="enabled" label={t('Enabled')} valuePropName="checked">
             <Switch />
           </Form.Item>
-          <Typography.Title level={5} style={{ marginTop: 8, fontSize: 14 }}>适配器配置</Typography.Title>
+          <Typography.Title level={5} style={{ marginTop: 8, fontSize: 14 }}>{t('Adapter Config')}</Typography.Title>
           {renderConfigFields()}
         </Form>
       </Drawer>

web/src/pages/FileExplorerPage/FileExplorerPage.tsx

@@ -34,7 +34,7 @@ const FileExplorerPage = memo(function FileExplorerPage() {
   const dragCounter = useRef(0);
 
   // --- Hooks ---
-  const { path, entries, loading, pagination, processorTypes, load, navigateTo, goUp, handlePaginationChange, refresh } = useFileExplorer(navKey);
+  const { path, entries, loading, pagination, processorTypes, sortBy, sortOrder, load, navigateTo, goUp, handlePaginationChange, refresh, handleSortChange } = useFileExplorer(navKey);
   const { selectedEntries, handleSelect, handleSelectRange, clearSelection, setSelectedEntries } = useFileSelection();
   const { doCreateDir, doDelete, doRename, doDownload, doShare, doGetDirectLink } = useFileActions({ path, refresh, clearSelection, onShare: (entries) => setSharingEntries(entries), onGetDirectLink: (entry) => setDirectLinkEntry(entry) });
   const { appWindows, openFileWithDefaultApp, confirmOpenWithApp, closeWindow, toggleMax, bringToFront, updateWindow } = useAppWindows(path);
@@ -56,8 +56,8 @@ const FileExplorerPage = memo(function FileExplorerPage() {
   // --- Effects ---
   useEffect(() => {
     const routeP = '/' + (restPath || '').replace(/^\/+/, '');
-    load(routeP, 1, pagination.pageSize);
-  }, [restPath, navKey, load, pagination.pageSize]);
+    load(routeP, 1, pagination.pageSize, sortBy, sortOrder);
+  }, [restPath, navKey, load, pagination.pageSize, sortBy, sortOrder]);
 
   // --- Handlers ---
   const handleOpenEntry = (entry: VfsEntry) => {
@@ -136,12 +136,15 @@ const FileExplorerPage = memo(function FileExplorerPage() {
         path={path}
         loading={loading}
         viewMode={viewMode}
+        sortBy={sortBy}
+        sortOrder={sortOrder}
         onGoUp={goUp}
         onNavigate={navigateTo}
         onRefresh={refresh}
         onCreateDir={() => setCreatingDir(true)}
         onUpload={uploader.openModal}
         onSetViewMode={setViewMode}
+        onSortChange={handleSortChange}
       />
 
       <input ref={uploader.fileInputRef} type="file" style={{ display: 'none' }} multiple onChange={uploader.handleFileChange} />

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

@@ -2,6 +2,7 @@ import React from 'react';
 import { Menu, theme } from 'antd';
 import type { VfsEntry } from '../../../api/client';
 import { getAppsForEntry, getDefaultAppForEntry } from '../../../apps/registry';
+import { useI18n } from '../../../i18n';
 import {
   FolderFilled, AppstoreOutlined, AppstoreAddOutlined, DownloadOutlined,
   EditOutlined, DeleteOutlined, InfoCircleOutlined, UploadOutlined, PlusOutlined, ShareAltOutlined, LinkOutlined
@@ -30,13 +31,14 @@ interface ContextMenuProps {
 
 export const ContextMenu: React.FC<ContextMenuProps> = (props) => {
   const { token } = theme.useToken();
+  const { t } = useI18n();
   const { x, y, entry, entries, selectedEntries, processorTypes, onClose, ...actions } = props;
 
   const getContextMenuItems = () => {
     if (!entry) { // Blank context menu
       return [
-        { key: 'upload', label: '上传文件', icon: <UploadOutlined />, onClick: actions.onUpload },
-        { key: 'mkdir', label: '新建目录', icon: <PlusOutlined />, onClick: actions.onCreateDir },
+        { key: 'upload', label: t('Upload File'), icon: <UploadOutlined />, onClick: actions.onUpload },
+        { key: 'mkdir', label: t('New Folder'), icon: <PlusOutlined />, onClick: actions.onCreateDir },
       ];
     }
 
@@ -61,56 +63,56 @@ export const ContextMenu: React.FC<ContextMenuProps> = (props) => {
     return [
       (entry.is_dir || apps.length > 0) ? {
         key: 'open',
-        label: defaultApp ? `打开 (${defaultApp.name})` : '打开',
+        label: defaultApp ? `${t('Open')} (${defaultApp.name})` : t('Open'),
         icon: <FolderFilled />,
         onClick: () => actions.onOpen(entry),
       } : null,
       !entry.is_dir && apps.length > 0 ? {
         key: 'openWith',
-        label: '打开方式',
+        label: t('Open With'),
         icon: <AppstoreOutlined />,
         children: apps.map(a => ({
           key: 'openWith-' + a.key,
-          label: a.name + (a.key === defaultApp?.key ? ' (默认)' : ''),
+          label: a.name + (a.key === defaultApp?.key ? ` (${t('Default')})` : ''),
           onClick: () => actions.onOpenWith(entry, a.key),
         })),
       } : null,
       !entry.is_dir && processorSubMenu.length > 0 ? {
         key: 'process',
-        label: '处理器',
+        label: t('Processor'),
         icon: <AppstoreAddOutlined />,
         children: processorSubMenu,
       } : null,
       {
         key: 'share',
-        label: '分享',
+        label: t('Share'),
         icon: <ShareAltOutlined />,
         onClick: () => actions.onShare(targetEntries),
       },
       {
         key: 'directLink',
-        label: '获取直链',
+        label: t('Get Direct Link'),
         icon: <LinkOutlined />,
         disabled: targetEntries.length !== 1 || targetEntries[0].is_dir,
         onClick: () => actions.onGetDirectLink(targetEntries[0]),
       },
       {
         key: 'download',
-        label: '下载',
+        label: t('Download'),
         icon: <DownloadOutlined />,
         disabled: targetEntries.some(t => t.is_dir) || targetEntries.length > 1,
         onClick: () => actions.onDownload(targetEntries[0]),
       },
       {
         key: 'rename',
-        label: '重命名',
+        label: t('Rename'),
         icon: <EditOutlined />,
         disabled: targetEntries.length !== 1 || targetEntries[0].type === 'mount',
         onClick: () => actions.onRename(targetEntries[0]),
       },
       {
         key: 'delete',
-        label: '删除',
+        label: t('Delete'),
         icon: <DeleteOutlined />,
         danger: true,
         disabled: targetEntries.some(t => t.type === 'mount'),
@@ -118,7 +120,7 @@ export const ContextMenu: React.FC<ContextMenuProps> = (props) => {
       },
       {
         key: 'detail',
-        label: '详情',
+        label: t('Details'),
         icon: <InfoCircleOutlined />,
         onClick: () => actions.onDetail(entry),
       },
@@ -148,4 +150,4 @@ export const ContextMenu: React.FC<ContextMenuProps> = (props) => {
       />
     </div>
   );
-};
+};

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

@@ -1,6 +1,7 @@
 import React from 'react';
 import { Typography, theme } from 'antd';
 import { FolderOpenOutlined } from '@ant-design/icons';
+import { useI18n } from '../../../i18n';
 
 interface Props {
   isRoot: boolean;
@@ -8,14 +9,15 @@ interface Props {
 
 export const EmptyState: React.FC<Props> = ({ isRoot }) => {
   const { token } = theme.useToken();
+  const { t } = useI18n();
   return (
     <div style={{ display:'flex', flexDirection:'column', alignItems:'center', justifyContent:'center', padding:isRoot? '80px 40px':'60px 40px', minHeight: isRoot? '400px':'300px', color: token.colorTextSecondary }}>
       <FolderOpenOutlined style={{ fontSize:64, color: token.colorTextQuaternary, marginBottom:16 }} />
       <Typography.Title level={4} style={{ color: token.colorTextSecondary, marginBottom:8, fontWeight:400 }}>
-        {isRoot ? '这里还没有任何文件' : '此目录为空'}
+        {isRoot ? t('No files yet here') : t('This folder is empty')}
       </Typography.Title>
       <Typography.Text style={{ color: token.colorTextTertiary, marginBottom:24, textAlign:'center', maxWidth:300, lineHeight:1.5 }}>
-        {isRoot ? '开始上传文件或创建新目录来组织您的内容' : '您可以在此目录中创建新的文件夹或上传文件'}
+        {isRoot ? t('Start uploading files or create folders to organize your content') : t('You can create folders or upload files here')}
       </Typography.Text>
     </div>
   );

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

@@ -1,6 +1,7 @@
 import React from 'react';
 import { Modal, Typography, Spin, theme, Card, Descriptions, Divider, Badge, Space, message } from 'antd';
 import { FileOutlined, FolderOutlined, CameraOutlined, InfoCircleOutlined } from '@ant-design/icons';
+import { useI18n } from '../../../i18n';
 import type { VfsEntry } from '../../../api/client';
 
 interface Props {
@@ -10,21 +11,24 @@ interface Props {
   onClose: () => void;
 }
 
-const exifFieldMap: Record<string, { label: string; format?: (v: any) => string }> = {
-  '271': { label: '设备品牌' },
-  '272': { label: '设备型号' },
-  '306': { label: '拍摄时间' },
-  '282': { label: '水平分辨率', format: v => `${v} dpi` },
-  '283': { label: '垂直分辨率', format: v => `${v} dpi` },
-  '33434': { label: '曝光时间', format: v => `${v} 秒` },
-  '33437': { label: '光圈值', format: v => `f/${v}` },
-  '34855': { label: 'ISO' },
-  '37377': { label: '焦距', format: v => `${v} mm` },
-  '40962': { label: '宽度', format: v => `${v} px` },
-  '40963': { label: '高度', format: v => `${v} px` },
-};
+function getExifFieldMap(t: (k: string)=>string): Record<string, { label: string; format?: (v: any) => string }> {
+  return {
+    '271': { label: t('Camera Make') },
+    '272': { label: t('Camera Model') },
+    '306': { label: t('Capture Time') },
+    '282': { label: t('X Resolution'), format: v => `${v} dpi` },
+    '283': { label: t('Y Resolution'), format: v => `${v} dpi` },
+    '33434': { label: t('Exposure Time'), format: v => `${v} s` },
+    '33437': { label: t('Aperture'), format: v => `f/${v}` },
+    '34855': { label: 'ISO' },
+    '37377': { label: t('Focal Length'), format: v => `${v} mm` },
+    '40962': { label: t('Width'), format: v => `${v} px` },
+    '40963': { label: t('Height'), format: v => `${v} px` },
+  };
+}
 
-function renderExif(exif: Record<string, any>) {
+function renderExif(exif: Record<string, any>, t: (k: string)=>string) {
+  const exifFieldMap = getExifFieldMap(t);
   const items = Object.entries(exifFieldMap)
     .filter(([key]) => exif[key] !== undefined)
     .map(([key, { label, format }]) => ({
@@ -35,9 +39,9 @@ function renderExif(exif: Record<string, any>) {
 
   if (items.length === 0) {
     return (
-      <div style={{ textAlign: 'center', padding: 24, color: '#999' }}>
+      <div style={{ textAlign: 'center', padding: 24, color: 'var(--ant-color-text-tertiary, #999)' }}>
         <InfoCircleOutlined style={{ fontSize: 20, marginBottom: 8 }} />
-        <div>无常见EXIF信息</div>
+        <div>{t('No common EXIF info')}</div>
       </div>
     );
   }
@@ -49,19 +53,19 @@ function renderExif(exif: Record<string, any>) {
       bordered
       items={items.map(item => ({
         key: item.key,
-        label: <span style={{ fontWeight: 500, color: '#595959' }}>{item.label}</span>,
-        children: <span style={{ color: '#262626' }}>{item.value}</span>
+        label: <span style={{ fontWeight: 500, color: 'var(--ant-color-text-secondary, #595959)' }}>{item.label}</span>,
+        children: <span style={{ color: 'var(--ant-color-text, #262626)' }}>{item.value}</span>
       }))}
       contentStyle={{ padding: '8px 12px' }}
-      labelStyle={{ padding: '8px 12px', backgroundColor: '#fafafa', width: '30%' }}
+      labelStyle={{ padding: '8px 12px', backgroundColor: 'var(--ant-color-fill-tertiary, #fafafa)', width: '30%' }}
     />
   );
 }
 
-function formatFileSize(size: number | string): string {
+function formatFileSize(size: number | string, t: (k: string)=>string): string {
   if (typeof size !== 'number') return String(size);
   
-  const units = ['字节', 'KB', 'MB', 'GB'];
+  const units = [t('Bytes'), 'KB', 'MB', 'GB'];
   let index = 0;
   let fileSize = size;
   
@@ -75,13 +79,14 @@ function formatFileSize(size: number | string): string {
 
 export const FileDetailModal: React.FC<Props> = ({ entry, loading, data, onClose }) => {
   const { token } = theme.useToken();
+  const { t } = useI18n();
   
   return (
     <Modal
       title={
         <Space>
           <InfoCircleOutlined style={{ color: token.colorPrimary }} />
-          <span>文件属性</span>
+          <span>{t('File Properties')}</span>
           {entry && (
             <Typography.Text type="secondary" style={{ fontSize: 14 }}>
               - {entry.name}
@@ -100,7 +105,7 @@ export const FileDetailModal: React.FC<Props> = ({ entry, loading, data, onClose
       {loading ? (
         <div style={{ textAlign: 'center', padding: 48 }}>
           <Spin size="large" />
-          <div style={{ marginTop: 16, color: token.colorTextSecondary }}>加载文件信息...</div>
+          <div style={{ marginTop: 16, color: token.colorTextSecondary }}>{t('Loading file info...')}</div>
         </div>
       ) : data ? (
         data.error ? (
@@ -118,7 +123,7 @@ export const FileDetailModal: React.FC<Props> = ({ entry, loading, data, onClose
                 title={
                   <Space>
                     {data.is_dir ? <FolderOutlined /> : <FileOutlined />}
-                    基本信息
+                    {t('Basic Info')}
                   </Space>
                 }
                 style={{ borderRadius: 8, height: 'fit-content' }}
@@ -129,36 +134,36 @@ export const FileDetailModal: React.FC<Props> = ({ entry, loading, data, onClose
                   items={[
                     {
                       key: 'name',
-                      label: '名称',
+                      label: t('Name'),
                       children: <Typography.Text strong>{data.name}</Typography.Text>
                     },
                     {
                       key: 'type',
-                      label: '类型',
+                      label: t('Type'),
                       children: (
                         <Badge 
                           status={data.is_dir ? 'processing' : 'default'} 
-                          text={data.type || (data.is_dir ? '文件夹' : '文件')}
+                          text={data.type || (data.is_dir ? t('Folder') : t('File'))}
                         />
                       )
                     },
                     {
                       key: 'size',
-                      label: '大小',
-                      children: formatFileSize(data.size)
+                      label: t('Size'),
+                      children: formatFileSize(data.size, t)
                     },
                     {
                       key: 'mtime',
-                      label: '修改时间',
+                      label: t('Modified Time'),
                       children: data.mtime ? (
                         typeof data.mtime === 'number' 
-                          ? new Date(data.mtime * 1000).toLocaleString('zh-CN')
+                          ? new Date(data.mtime * 1000).toLocaleString()
                           : data.mtime
                       ) : '-'
                     },
                     {
                       key: 'path',
-                      label: '路径',
+                      label: t('Path'),
                       children: (
                         <Typography.Text style={{ display: 'block', marginTop: 4 }}>
                           <a
@@ -168,9 +173,9 @@ export const FileDetailModal: React.FC<Props> = ({ entry, loading, data, onClose
                               try {
                                 if (navigator.clipboard) {
                                   navigator.clipboard.writeText(data.path).then(() => {
-                                    message.success('路径已复制到剪贴板');
+                                    message.success(t('Path copied to clipboard'));
                                   }).catch(() => {
-                                    message.error('复制失败');
+                                    message.error(t('Copy failed'));
                                   });
                                 } else {
                                   const textarea = document.createElement('textarea');
@@ -179,10 +184,10 @@ export const FileDetailModal: React.FC<Props> = ({ entry, loading, data, onClose
                                   textarea.select();
                                   const ok = document.execCommand('copy');
                                   document.body.removeChild(textarea);
-                                  message[ok ? 'success' : 'error'](ok ? '路径已复制到剪贴板' : '复制失败');
+                                  message[ok ? 'success' : 'error'](ok ? t('Path copied to clipboard') : t('Copy failed'));
                                 }
                               } catch {
-                                message.error('复制失败');
+                                message.error(t('Copy failed'));
                               }
                             }}
                             style={{
@@ -214,7 +219,7 @@ export const FileDetailModal: React.FC<Props> = ({ entry, loading, data, onClose
                   <>
                     <Divider style={{ margin: '12px 0' }} />
                     <div>
-                      <span style={{ fontWeight: 500, color: token.colorTextSecondary }}>权限：</span>
+                      <span style={{ fontWeight: 500, color: token.colorTextSecondary }}>{t('Permissions')}：</span>
                       <Typography.Text code>{data.mode.toString(8)}</Typography.Text>
                     </div>
                   </>
@@ -230,12 +235,12 @@ export const FileDetailModal: React.FC<Props> = ({ entry, loading, data, onClose
                   title={
                     <Space>
                       <CameraOutlined />
-                      EXIF信息
+                      {t('EXIF Info')}
                     </Space>
                   }
                   style={{ borderRadius: 8, height: 'fit-content' }}
                 >
-                  {renderExif(data.exif)}
+                  {renderExif(data.exif, t)}
                 </Card>
               </div>
             )}

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

@@ -17,11 +17,25 @@ import {
   FontSizeOutlined,
 } from '@ant-design/icons';
 
-export const getFileIcon = (fileName: string, size: number = 16) => {
+const lightenColor = (hex: string, amount: number) => {
+  const s = hex.replace('#', '');
+  const n = s.length === 3 ? s.split('').map(c => c + c).join('') : s;
+  const num = parseInt(n, 16);
+  if (Number.isNaN(num) || n.length !== 6) return hex;
+  const r = (num >> 16) & 255;
+  const g = (num >> 8) & 255;
+  const b = num & 255;
+  const mix = (c: number) => Math.round(c + (255 - c) * amount);
+  const toHex = (v: number) => v.toString(16).padStart(2, '0');
+  return `#${toHex(mix(r))}${toHex(mix(g))}${toHex(mix(b))}`;
+};
+
+export const getFileIcon = (fileName: string, size: number = 16, resolvedMode: 'light' | 'dark' | 'system' = 'light') => {
   const ext = fileName.split('.').pop()?.toLowerCase() || '';
   const iconStyle: React.CSSProperties = { fontSize: size, marginRight: size === 16 ? 6 : 0 };
 
-  const make = (node: React.ReactNode, color: string) => React.cloneElement(node as any, { style: { ...iconStyle, color } });
+  const adj = (color: string) => (resolvedMode === 'dark' ? lightenColor(color, 0.3) : color);
+  const make = (node: React.ReactNode, color: string) => React.cloneElement(node as any, { style: { ...iconStyle, color: adj(color) } });
 
   if (['png', 'jpg', 'jpeg', 'gif', 'webp', 'svg', 'bmp', 'ico', 'tiff'].includes(ext)) return make(<FileImageOutlined />, '#52c41a');
   if (['mp4', 'avi', 'mov', 'wmv', 'flv', 'mkv', 'webm', 'm4v', '3gp'].includes(ext)) return make(<VideoCameraOutlined />, '#fa541c');

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

@@ -4,6 +4,8 @@ import { FolderFilled, MoreOutlined, EditOutlined, DeleteOutlined, AppstoreOutli
 import type { VfsEntry } from '../../../api/client';
 import { getFileIcon } from './FileIcons';
 import { getAppsForEntry, getDefaultAppForEntry } from '../../../apps/registry';
+import { useTheme } from '../../../contexts/ThemeContext';
+import { useI18n } from '../../../i18n';
 
 interface FileListViewProps {
   entries: VfsEntry[];
@@ -31,28 +33,42 @@ export const FileListView: React.FC<FileListViewProps> = ({
   onContextMenu,
 }) => {
   const { token } = theme.useToken();
+  const { resolvedMode } = useTheme();
+  const { t } = useI18n();
+  const lightenColor = (hex: string, amount: number) => {
+    const s = hex.replace('#', '');
+    const n = s.length === 3 ? s.split('').map(c => c + c).join('') : s;
+    const num = parseInt(n, 16);
+    if (Number.isNaN(num) || n.length !== 6) return hex;
+    const r = (num >> 16) & 255;
+    const g = (num >> 8) & 255;
+    const b = num & 255;
+    const mix = (c: number) => Math.round(c + (255 - c) * amount);
+    const toHex = (v: number) => v.toString(16).padStart(2, '0');
+    return `#${toHex(mix(r))}${toHex(mix(g))}${toHex(mix(b))}`;
+  };
 
   const columns = [
     {
-      title: '名称',
+      title: t('Name'),
       dataIndex: 'name',
       key: 'name',
       render: (_: any, r: VfsEntry) => (
         <span style={{ cursor: 'pointer', userSelect: 'none' }} onDoubleClick={() => onOpen(r)}>
           {r.is_dir ? (
-            <FolderFilled style={{ color: token.colorPrimary, marginRight: 6 }} />
+            <FolderFilled style={{ color: resolvedMode === 'dark' ? lightenColor(String(token.colorPrimary || '#111111'), 0.72) : token.colorPrimary, marginRight: 6 }} />
           ) : (
-            getFileIcon(r.name, 16)
+            getFileIcon(r.name, 16, resolvedMode)
           )}
           {r.name}
-          {r.type === 'mount' && <Tooltip title="挂载点"><span style={{ marginLeft: 6, fontSize: 10, padding: '0 4px', border: `1px solid ${token.colorBorderSecondary}`, borderRadius: 4 }}>MOUNT</span></Tooltip>}
+          {r.type === 'mount' && <Tooltip title={t('Mount Point')}><span style={{ marginLeft: 6, fontSize: 10, padding: '0 4px', border: `1px solid ${token.colorBorderSecondary}`, borderRadius: 4 }}>MOUNT</span></Tooltip>}
         </span>
       )
     },
-    { title: '大小', dataIndex: 'size', width: 100, render: (v: number, r: VfsEntry) => r.is_dir ? '-' : v },
-    { title: '修改时间', dataIndex: 'mtime', width: 160, render: (v: number) => v ? new Date(v * 1000).toLocaleString() : '-' },
+    { title: t('Size'), dataIndex: 'size', width: 100, render: (v: number, r: VfsEntry) => r.is_dir ? '-' : v },
+    { title: t('Modified Time'), dataIndex: 'mtime', width: 160, render: (v: number) => v ? new Date(v * 1000).toLocaleString() : '-' },
     {
-      title: '操作',
+      title: t('Actions'),
       key: 'actions',
       width: 110,
       render: (_: any, r: VfsEntry) => {
@@ -62,19 +78,19 @@ export const FileListView: React.FC<FileListViewProps> = ({
           <Dropdown
             menu={{
               items: [
-                (r.is_dir || apps.length > 0) ? { key: 'open', label: defaultApp ? `打开(${defaultApp.name})` : '打开', icon: <FolderOpenOutlined />, onClick: () => onOpen(r) } : null,
+                (r.is_dir || apps.length > 0) ? { key: 'open', label: defaultApp ? `${t('Open')}(${defaultApp.name})` : t('Open'), icon: <FolderOpenOutlined />, onClick: () => onOpen(r) } : null,
                 !r.is_dir && apps.length > 0 ? {
                   key: 'openWith',
-                  label: '打开方式',
+                  label: t('Open With'),
                   icon: <AppstoreOutlined />,
                   children: apps.map(a => ({
                     key: 'openWith-' + a.key,
-                    label: a.name + (a.key === defaultApp?.key ? ' (默认)' : ''),
+                    label: a.name + (a.key === defaultApp?.key ? ` (${t('Default')})` : ''),
                     onClick: () => onOpenWith(r, a.key)
                   }))
                 } : null,
-                { key: 'rename', label: '重命名', icon: <EditOutlined />, disabled: r.type === 'mount', onClick: () => onRename(r) },
-                { key: 'delete', label: '删除', icon: <DeleteOutlined />, danger: true, disabled: r.type === 'mount', onClick: () => onDelete(r) }
+                { key: 'rename', label: t('Rename'), icon: <EditOutlined />, disabled: r.type === 'mount', onClick: () => onRename(r) },
+                { key: 'delete', label: t('Delete'), icon: <DeleteOutlined />, danger: true, disabled: r.type === 'mount', onClick: () => onDelete(r) }
               ].filter(Boolean) as any[]
             }}
           >
@@ -105,4 +121,4 @@ export const FileListView: React.FC<FileListViewProps> = ({
       }}
     />
   );
-};
+};

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

@@ -4,6 +4,7 @@ import { FolderFilled, PictureOutlined } from '@ant-design/icons';
 import type { VfsEntry } from '../../../api/client';
 import { getFileIcon } from './FileIcons';
 import { EmptyState } from './EmptyState';
+import { useTheme } from '../../../contexts/ThemeContext';
 
 interface Props {
   entries: VfsEntry[];
@@ -26,6 +27,28 @@ const formatSize = (size: number) => {
 
 export const GridView: React.FC<Props> = ({ entries, thumbs, selectedEntries, loading, path, onSelect, onSelectRange, onOpen, onContextMenu }) => {
   const { token } = theme.useToken();
+  const { resolvedMode } = useTheme();
+  const lightenColor = (hex: string, amount: number) => {
+    const parseHex = (h: string) => {
+      const s = h.replace('#', '');
+      const n = s.length === 3 ? s.split('').map(c => c + c).join('') : s;
+      const num = parseInt(n, 16);
+      if (Number.isNaN(num) || n.length !== 6) return null;
+      return {
+        r: (num >> 16) & 255,
+        g: (num >> 8) & 255,
+        b: num & 255,
+      };
+    };
+    const rgb = parseHex(hex);
+    if (!rgb) return hex;
+    const mix = (c: number) => Math.round(c + (255 - c) * amount);
+    const r = mix(rgb.r);
+    const g = mix(rgb.g);
+    const b = mix(rgb.b);
+    const toHex = (v: number) => v.toString(16).padStart(2, '0');
+    return `#${toHex(r)}${toHex(g)}${toHex(b)}`;
+  };
   const containerRef = useRef<HTMLDivElement | null>(null);
   const itemRefs = useRef<Record<string, HTMLDivElement | null>>({});
   const startRef = useRef<{ x: number, y: number } | null>(null);
@@ -111,9 +134,24 @@ export const GridView: React.FC<Props> = ({ entries, thumbs, selectedEntries, lo
             onContextMenu={(e) => onContextMenu(e, ent)}
             style={{ userSelect: 'none' }}
           >
-            <div className="thumb" style={{ background: ent.is_dir ? 'linear-gradient(#fafafa,#f2f2f2)' : '#fff' }}>
-              {ent.is_dir && <FolderFilled style={{ fontSize: 32, color: token.colorPrimary }} />}
-              {!ent.is_dir && (isImg ? <img src={isImg} alt={ent.name} style={{ maxWidth: '100%', maxHeight: '100%' }} /> : isPictureType ? <PictureOutlined style={{ fontSize: 32, color: '#8c8c8c' }} /> : getFileIcon(ent.name, 32))}
+            <div className="thumb" style={{ background: 'var(--ant-color-bg-container, #fff)' }}>
+              {ent.is_dir && (
+                <FolderFilled
+                  style={{
+                    fontSize: 32,
+                    color: resolvedMode === 'dark' ? lightenColor(String(token.colorPrimary || '#111111'), 0.72) : token.colorPrimary,
+                  }}
+                />
+              )}
+              {!ent.is_dir && (
+                isImg ? (
+                  <img src={isImg} alt={ent.name} style={{ maxWidth: '100%', maxHeight: '100%' }} />
+                ) : isPictureType ? (
+                  <PictureOutlined style={{ fontSize: 32, color: resolvedMode === 'dark' ? lightenColor(String(token.colorPrimary || '#111111'), 0.72) : 'var(--ant-color-text-tertiary, #8c8c8c)' }} />
+                ) : (
+                  getFileIcon(ent.name, 32, resolvedMode)
+                )
+              )}
               {ent.type === 'mount' && <span className="badge">M</span>}
             </div>
             <Tooltip title={ent.name}><div className="name ellipsis" style={{ userSelect: 'none' }}>{ent.name}</div></Tooltip>
@@ -129,8 +167,8 @@ export const GridView: React.FC<Props> = ({ entries, thumbs, selectedEntries, lo
             top: rect.top,
             width: rect.width,
             height: rect.height,
-            border: '1px dashed rgba(0,0,0,0.4)',
-            background: 'rgba(0, 120, 212, 0.08)',
+            border: '1px dashed var(--ant-color-border, rgba(0,0,0,0.4))',
+            background: 'var(--ant-color-primary-bg, rgba(0, 120, 212, 0.08))',
             zIndex: 999
           }}
         />

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

@@ -1,6 +1,8 @@
 import React, { useState } from 'react';
 import { Flex, Typography, Divider, Button, Space, Tooltip, Segmented, Breadcrumb, Input, theme } from 'antd';
-import { ArrowUpOutlined, ReloadOutlined, PlusOutlined, UploadOutlined, AppstoreOutlined, UnorderedListOutlined } from '@ant-design/icons';
+import { ArrowUpOutlined, ArrowDownOutlined, ReloadOutlined, PlusOutlined, UploadOutlined, AppstoreOutlined, UnorderedListOutlined } from '@ant-design/icons';
+import { Select } from 'antd';
+import { useI18n } from '../../../i18n';
 import type { ViewMode } from '../types';
 
 interface HeaderProps {
@@ -8,26 +10,33 @@ interface HeaderProps {
   path: string;
   loading: boolean;
   viewMode: ViewMode;
+  sortBy: string;
+  sortOrder: string;
   onGoUp: () => void;
   onNavigate: (path: string) => void;
   onRefresh: () => void;
   onCreateDir: () => void;
   onUpload: () => void;
   onSetViewMode: (mode: ViewMode) => void;
+  onSortChange: (sortBy: string, sortOrder: string) => void;
 }
 
 export const Header: React.FC<HeaderProps> = ({
   path,
   loading,
   viewMode,
+  sortBy,
+  sortOrder,
   onGoUp,
   onNavigate,
   onRefresh,
   onCreateDir,
   onUpload,
   onSetViewMode,
+  onSortChange,
 }) => {
   const { token } = theme.useToken();
+  const { t } = useI18n();
   const [editingPath, setEditingPath] = useState(false);
   const [pathInputValue, setPathInputValue] = useState('');
 
@@ -66,7 +75,7 @@ export const Header: React.FC<HeaderProps> = ({
     }
 
     const breadcrumbItems = [
-      { key: 'root', title: <span style={{ cursor: 'pointer' }} onClick={() => onNavigate('/')}>Home</span> },
+      { key: 'root', title: <span style={{ cursor: 'pointer' }} onClick={() => onNavigate('/')}>{t('Home')}</span> },
       ...path.split('/').filter(Boolean).map((segment, index, arr) => {
         const segmentPath = '/' + arr.slice(0, index + 1).join('/');
         return {
@@ -92,24 +101,40 @@ export const Header: React.FC<HeaderProps> = ({
     <Flex align="center" justify="space-between" style={{ padding: '10px 16px', borderBottom: `1px solid ${token.colorBorderSecondary}`, gap: 12 }}>
       <Flex align="center" gap={8} style={{ flexWrap: 'wrap', flex: 1, overflow: 'hidden' }}>
         <Button size="small" icon={<ArrowUpOutlined />} onClick={onGoUp} disabled={path === '/'} />
-        <Typography.Text strong>文件管理</Typography.Text>
+        <Typography.Text strong>{t('File Manager')}</Typography.Text>
         <Divider type="vertical" />
         {renderBreadcrumb()}
       </Flex>
       <Space size={8} wrap>
-        <Button size="small" icon={<ReloadOutlined />} onClick={onRefresh} loading={loading}>刷新</Button>
-        <Button size="small" icon={<PlusOutlined />} onClick={onCreateDir}>新建目录</Button>
-        <Button size="small" icon={<UploadOutlined />} onClick={onUpload}>上传</Button>
+        <Button size="small" icon={<ReloadOutlined />} onClick={onRefresh} loading={loading}>{t('Refresh')}</Button>
+        <Button size="small" icon={<PlusOutlined />} onClick={onCreateDir}>{t('New Folder')}</Button>
+        <Button size="small" icon={<UploadOutlined />} onClick={onUpload}>{t('Upload')}</Button>
+        <Select
+          size="small"
+          value={sortBy}
+          onChange={(val) => onSortChange(val, sortOrder)}
+          style={{ width: 80 }}
+          options={[
+            { value: 'name', label: t('Name') },
+            { value: 'size', label: t('Size') },
+            { value: 'mtime', label: t('Modified Time') },
+          ]}
+        />
+        <Button
+          size="small"
+          icon={sortOrder === 'asc' ? <ArrowUpOutlined /> : <ArrowDownOutlined />}
+          onClick={() => onSortChange(sortBy, sortOrder === 'asc' ? 'desc' : 'asc')}
+        />
         <Segmented
           size="small"
           value={viewMode}
           onChange={v => onSetViewMode(v as any)}
           options={[
-            { label: <Tooltip title="网格"><AppstoreOutlined /></Tooltip>, value: 'grid' },
-            { label: <Tooltip title="列表"><UnorderedListOutlined /></Tooltip>, value: 'list' }
+            { label: <Tooltip title={t('Grid')}><AppstoreOutlined /></Tooltip>, value: 'grid' },
+            { label: <Tooltip title={t('List')}><UnorderedListOutlined /></Tooltip>, value: 'list' }
           ]}
         />
       </Space>
     </Flex>
   );
-};
+};

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

@@ -1,5 +1,6 @@
 import React, { useState, useEffect } from 'react';
 import { Modal, Input } from 'antd';
+import { useI18n } from '../../../../i18n';
 
 interface CreateDirModalProps {
   open: boolean;
@@ -9,6 +10,7 @@ interface CreateDirModalProps {
 
 export const CreateDirModal: React.FC<CreateDirModalProps> = ({ open, onOk, onCancel }) => {
   const [name, setName] = useState('');
+  const { t } = useI18n();
 
   useEffect(() => {
     if (open) {
@@ -22,7 +24,7 @@ export const CreateDirModal: React.FC<CreateDirModalProps> = ({ open, onOk, onCa
 
   return (
     <Modal
-      title="新建目录"
+      title={t('New Folder')}
       open={open}
       onOk={handleOk}
       onCancel={onCancel}
@@ -30,7 +32,7 @@ export const CreateDirModal: React.FC<CreateDirModalProps> = ({ open, onOk, onCa
       destroyOnClose
     >
       <Input
-        placeholder="目录名称"
+        placeholder={t('Folder Name')}
         value={name}
         onChange={e => setName(e.target.value)}
         onPressEnter={handleOk}
@@ -38,4 +40,4 @@ export const CreateDirModal: React.FC<CreateDirModalProps> = ({ open, onOk, onCa
       />
     </Modal>
   );
-};
+};

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

@@ -3,6 +3,7 @@ import { Modal, Radio, message, Button, Typography, Input, Space } from 'antd';
 import { CopyOutlined, FileMarkdownOutlined } from '@ant-design/icons';
 import type { VfsEntry } from '../../../../api/client';
 import { vfsApi } from '../../../../api/client';
+import { useI18n } from '../../../../i18n';
 
 interface DirectLinkModalProps {
   entry: VfsEntry | null;
@@ -30,6 +31,7 @@ export const DirectLinkModal = memo(function DirectLinkModal({ entry, path, open
   const [loading, setLoading] = useState(false);
   const [expiresIn, setExpiresIn] = useState(3600);
   const [link, setLink] = useState('');
+  const { t } = useI18n();
 
   useEffect(() => {
     if (open && entry) {
@@ -44,9 +46,14 @@ export const DirectLinkModal = memo(function DirectLinkModal({ entry, path, open
     try {
       const fullPath = (path === '/' ? '' : path) + '/' + entry.name;
       const res = await vfsApi.getTempLinkToken(fullPath, expiresIn);
-      setLink(res.url);
+      let url = res.url;
+      if (url && !url.startsWith('http://') && !url.startsWith('https://')) {
+        const origin = window.location.origin;
+        url = url.startsWith('/') ? origin + url : origin + '/' + url;
+      }
+      setLink(url);
     } catch (e: any) {
-      message.error(e.message || '生成链接失败');
+      message.error(e.message || t('Failed to generate link'));
     } finally {
       setLoading(false);
     }
@@ -54,52 +61,52 @@ export const DirectLinkModal = memo(function DirectLinkModal({ entry, path, open
 
   const handleCopy = (text: string) => {
     navigator.clipboard.writeText(text);
-    message.success('已复制到剪贴板');
+    message.success(t('Copied to clipboard'));
   };
 
   const handleCopyMarkdown = () => {
     if (!entry || !link) return;
     const markdownText = generateMarkdownLink(entry.name, link);
     navigator.clipboard.writeText(markdownText);
-    message.success('Markdown 格式已复制到剪贴板');
+    message.success(t('Markdown copied to clipboard'));
   };
-  
+
   const handleExpiresChange = (e: any) => {
     setExpiresIn(e.target.value);
   };
 
   return (
     <Modal
-      title="获取直链"
+      title={t('Get Direct Link')}
       open={open}
       onCancel={onCancel}
       footer={[
         <Button key="back" onClick={onCancel}>
-          关闭
+          {t('Close')}
         </Button>,
       ]}
     >
       <Typography.Paragraph>
-        为 <strong>{entry?.name}</strong> 生成一个直接访问链接。
+        {t('Generate a direct link for {name}', { name: entry?.name || '' })}
       </Typography.Paragraph>
       <Radio.Group value={expiresIn} onChange={handleExpiresChange} style={{ marginBottom: 16 }}>
-        <Radio.Button value={3600}>1 小时</Radio.Button>
-        <Radio.Button value={86400}>1 天</Radio.Button>
-        <Radio.Button value={604800}>7 天</Radio.Button>
-        <Radio.Button value={0}>永久</Radio.Button>
+        <Radio.Button value={3600}>{t('1 hour')}</Radio.Button>
+        <Radio.Button value={86400}>{t('1 day')}</Radio.Button>
+        <Radio.Button value={604800}>{t('7 days')}</Radio.Button>
+        <Radio.Button value={0}>{t('Forever')}</Radio.Button>
       </Radio.Group>
-      
+
       <div style={{ display: 'flex', gap: 8 }}>
-        <Input readOnly value={link} disabled={loading} placeholder={loading ? "正在生成链接..." : "链接将显示在这里"} />
+        <Input readOnly value={link} disabled={loading} placeholder={loading ? t('Generating link...') : t('Link will appear here')} />
         <Space.Compact>
           <Button icon={<CopyOutlined />} onClick={() => handleCopy(link)} disabled={!link || loading}>
-            复制
+            {t('Copy')}
           </Button>
           <Button icon={<FileMarkdownOutlined />} onClick={handleCopyMarkdown} disabled={!link || loading}>
-            复制 Markdown
+            {t('Copy Markdown')}
           </Button>
         </Space.Compact>
       </div>
     </Modal>
   );
-});
+});

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

@@ -1,5 +1,6 @@
 import React from 'react';
 import { Modal, Form, Select, Input, Checkbox } from 'antd';
+import { useI18n } from '../../../../i18n';
 import type { VfsEntry } from '../../../../api/client';
 import type { ProcessorTypeMeta } from '../../../../api/processors';
 import { ProcessorConfigForm } from '../../../../components/ProcessorConfigForm';
@@ -28,6 +29,7 @@ export const ProcessorModal: React.FC<ProcessorModalProps> = (props) => {
     onConfigChange, onSavingPathChange, onOverwriteChange
   } = props;
   const [form] = Form.useForm();
+  const { t } = useI18n();
 
   const selectedProcessorMeta = processorTypes.find(pt => pt.type === selectedProcessor);
 
@@ -51,7 +53,7 @@ export const ProcessorModal: React.FC<ProcessorModalProps> = (props) => {
 
   return (
     <Modal
-      title={`使用处理器处理文件${entry ? `: ${entry.name}` : ''}`}
+      title={t('Process file with processor') + (entry ? `: ${entry.name}` : '')}
       open={visible}
       onCancel={onCancel}
       onOk={onOk}
@@ -59,11 +61,11 @@ export const ProcessorModal: React.FC<ProcessorModalProps> = (props) => {
       destroyOnClose
     >
       <Form form={form} layout="vertical" onValuesChange={handleFormValuesChange}>
-        <Form.Item name="processor_type" label="处理器" required>
+        <Form.Item name="processor_type" label={t('Processor')} required>
           <Select
             onChange={onSelectedProcessorChange}
             options={processorTypes.map(pt => ({ value: pt.type, label: pt.name }))}
-            placeholder="请选择处理器"
+            placeholder={t('Select a processor')}
           />
         </Form.Item>
         <ProcessorConfigForm
@@ -75,15 +77,15 @@ export const ProcessorModal: React.FC<ProcessorModalProps> = (props) => {
           <>
             <Form.Item>
               <Checkbox checked={overwrite} onChange={e => onOverwriteChange(e.target.checked)}>
-                覆盖原文件
+                {t('Overwrite original file')}
               </Checkbox>
             </Form.Item>
             {!overwrite && (
-              <Form.Item label="保存为新文件">
+              <Form.Item label={t('Save as new file')}>
                 <Input
                   value={savingPath}
                   onChange={e => onSavingPathChange(e.target.value)}
-                  placeholder="如 /newfile.jpg，不填则仅返回处理结果"
+                  placeholder={t('e.g. /newfile.jpg, leave blank to only return result')}
                 />
               </Form.Item>
             )}
@@ -92,4 +94,4 @@ export const ProcessorModal: React.FC<ProcessorModalProps> = (props) => {
       </Form>
     </Modal>
   );
-};
+};

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

@@ -1,5 +1,6 @@
 import React, { useState, useEffect } from 'react';
 import { Modal, Input } from 'antd';
+import { useI18n } from '../../../../i18n';
 import type { VfsEntry } from '../../../../api/client';
 
 interface RenameModalProps {
@@ -10,6 +11,7 @@ interface RenameModalProps {
 
 export const RenameModal: React.FC<RenameModalProps> = ({ entry, onOk, onCancel }) => {
   const [name, setName] = useState('');
+  const { t } = useI18n();
 
   useEffect(() => {
     if (entry) {
@@ -25,7 +27,7 @@ export const RenameModal: React.FC<RenameModalProps> = ({ entry, onOk, onCancel
 
   return (
     <Modal
-      title="重命名"
+      title={t('Rename')}
       open={!!entry}
       onOk={handleOk}
       onCancel={onCancel}
@@ -33,7 +35,7 @@ export const RenameModal: React.FC<RenameModalProps> = ({ entry, onOk, onCancel
       destroyOnClose
     >
       <Input
-        placeholder="新的名称"
+        placeholder={t('New Name')}
         value={name}
         onChange={e => setName(e.target.value)}
         onPressEnter={handleOk}
@@ -41,4 +43,4 @@ export const RenameModal: React.FC<RenameModalProps> = ({ entry, onOk, onCancel
       />
     </Modal>
   );
-};
+};

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

@@ -4,6 +4,7 @@ import { CopyOutlined } from '@ant-design/icons';
 import type { VfsEntry, ShareInfoWithPassword } from '../../../../api/client';
 import { shareApi } from '../../../../api/share';
 import { useSystemStatus } from '../../../../contexts/SystemContext';
+import { useI18n } from '../../../../i18n';
 
 interface ShareModalProps {
   entries: VfsEntry[];
@@ -15,13 +16,14 @@ interface ShareModalProps {
 
 export const ShareModal = memo(function ShareModal({ entries, path, open, onOk, onCancel }: ShareModalProps) {
   const systemStatus = useSystemStatus();
+  const { t } = useI18n();
   const [form] = Form.useForm();
   const [loading, setLoading] = useState(false);
   const [accessType, setAccessType] = useState('public');
   const [createdShare, setCreatedShare] = useState<ShareInfoWithPassword | null>(null);
 
   const defaultName = entries.length > 1
-    ? `分享 ${entries.length} 个项目`
+    ? t('Share {count} items', { count: entries.length.toString() })
     : (entries.length === 1 ? entries[0].name : '');
 
   useEffect(() => {
@@ -54,10 +56,10 @@ export const ShareModal = memo(function ShareModal({ entries, path, open, onOk,
         password: values.password,
         expires_in_days: values.expiresInDays,
       });
-      message.success('分享链接已创建');
+      message.success(t('Share link created'));
       setCreatedShare(result);
     } catch (e: any) {
-      message.error(e.message || '创建失败');
+      message.error(e.message || t('Create failed'));
     } finally {
       setLoading(false);
     }
@@ -65,7 +67,7 @@ export const ShareModal = memo(function ShareModal({ entries, path, open, onOk,
   
   const handleCopy = (text: string) => {
     navigator.clipboard.writeText(text);
-    message.success('已复制到剪贴板');
+    message.success(t('Copied to clipboard'));
   };
 
   const baseUrl = systemStatus?.app_domain || window.location.origin;
@@ -73,21 +75,21 @@ export const ShareModal = memo(function ShareModal({ entries, path, open, onOk,
 
   const renderForm = () => (
     <Form form={form} layout="vertical" initialValues={{ name: defaultName, accessType: 'public', expiresInDays: 7 }}>
-      <Form.Item name="name" label="分享名称" rules={[{ required: true }]} >
+      <Form.Item name="name" label={t('Share Name')} rules={[{ required: true }]} >
         <Input />
       </Form.Item>
-      <Form.Item name="accessType" label="访问权限">
+      <Form.Item name="accessType" label={t('Access')}>
         <Radio.Group onChange={(e) => setAccessType(e.target.value)}>
-          <Radio value="public">公开</Radio>
-          <Radio value="password">密码访问</Radio>
+          <Radio value="public">{t('Public')}</Radio>
+          <Radio value="password">{t('By Password')}</Radio>
         </Radio.Group>
       </Form.Item>
       {accessType === 'password' && (
-        <Form.Item name="password" label="访问密码" rules={[{ required: true, message: '请输入密码' }]} >
+        <Form.Item name="password" label={t('Please enter password')} rules={[{ required: true, message: t('Please enter password') }]} >
           <Input.Password />
         </Form.Item>
       )}
-      <Form.Item name="expiresInDays" label="有效期 (天)" help="设置为 0 或负数表示永久有效">
+      <Form.Item name="expiresInDays" label={t('Expiration (days)')} help={t('Set 0 or negative for forever')}>
         <InputNumber min={-1} style={{ width: '100%' }} />
       </Form.Item>
     </Form>
@@ -95,44 +97,44 @@ export const ShareModal = memo(function ShareModal({ entries, path, open, onOk,
 
   const renderSuccess = () => (
     <div>
-      <Typography.Paragraph>分享链接已成功创建！</Typography.Paragraph>
+      <Typography.Paragraph>{t('Share link created successfully!')}</Typography.Paragraph>
       <Form layout="vertical">
-        <Form.Item label="分享链接">
+        <Form.Item label={t('Share Link')}>
           <div style={{ display: 'flex', gap: 8 }}>
         <Input readOnly value={shareUrl} style={{ flex: 1 }} />
         <Button icon={<CopyOutlined />} onClick={() => handleCopy(shareUrl)}>
-          复制
+          {t('Copy')}
         </Button>
           </div>
         </Form.Item>
         {createdShare?.password && (
-          <Form.Item label="访问密码">
+          <Form.Item label={t('Password')}>
         <div style={{ display: 'flex', gap: 8 }}>
           <Input readOnly value={createdShare.password} style={{ flex: 1 }} />
           <Button icon={<CopyOutlined />} onClick={() => handleCopy(createdShare.password!)}>
-            复制
+            {t('Copy')}
           </Button>
         </div>
           </Form.Item>
         )}
       </Form>
       <Typography.Text type="secondary">
-        有效期至: {createdShare?.expires_at ? new Date(createdShare.expires_at).toLocaleString() : '永久有效'}
+        {t('Expires At')}: {createdShare?.expires_at ? new Date(createdShare.expires_at).toLocaleString() : t('Forever')}
       </Typography.Text>
     </div>
   );
 
   return (
     <Modal
-      title={createdShare ? "分享创建成功" : "创建分享"}
+      title={createdShare ? t('Share created') : t('Create Share')}
       open={open}
       onOk={createdShare ? onOk : handleOk}
       onCancel={onCancel}
       confirmLoading={loading}
       destroyOnHidden
-      okText={createdShare ? "完成" : "创建"}
+      okText={createdShare ? t('Done') : t('Create')}
     >
       {createdShare ? renderSuccess() : renderForm()}
     </Modal>
   );
-});
+});

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

@@ -2,6 +2,7 @@ import React, { useEffect } from 'react';
 import { Modal, Button, List, Progress, Typography, message, Flex } from 'antd';
 import { CopyOutlined, CheckCircleFilled, CloseCircleFilled } from '@ant-design/icons';
 import type { UploadFile } from '../../hooks/useUploader';
+import { useI18n } from '../../../../i18n';
 
 interface UploadModalProps {
   visible: boolean;
@@ -11,6 +12,7 @@ interface UploadModalProps {
 }
 
 const UploadModal: React.FC<UploadModalProps> = ({ visible, files, onClose, onStartUpload }) => {
+  const { t } = useI18n();
 
   const allSuccess = files.every(f => f.status === 'success');
   
@@ -22,7 +24,7 @@ const UploadModal: React.FC<UploadModalProps> = ({ visible, files, onClose, onSt
 
   const handleCopy = (text: string) => {
     navigator.clipboard.writeText(text);
-    message.success('链接已复制到剪贴板');
+    message.success(t('Copied to clipboard'));
   };
 
   const renderStatus = (file: UploadFile) => {
@@ -32,32 +34,32 @@ const UploadModal: React.FC<UploadModalProps> = ({ visible, files, onClose, onSt
       case 'success':
         return (
           <Flex align="center" gap={8}>
-            <CheckCircleFilled style={{ color: '#52c41a' }} />
-            <Typography.Text type="secondary" style={{ verticalAlign: 'middle' }}>上传成功</Typography.Text>
+            <CheckCircleFilled style={{ color: 'var(--ant-color-success, #52c41a)' }} />
+            <Typography.Text type="secondary" style={{ verticalAlign: 'middle' }}>{t('Upload succeeded')}</Typography.Text>
             <Button icon={<CopyOutlined />} size="small" onClick={() => handleCopy(file.permanentLink!)} type="text" />
           </Flex>
         );
       case 'error':
         return (
             <Flex align="center" gap={8}>
-                <CloseCircleFilled style={{ color: '#ff4d4f' }} />
-                <Typography.Text type="danger" title={file.error}>上传失败</Typography.Text>
+                <CloseCircleFilled style={{ color: 'var(--ant-color-error, #ff4d4f)' }} />
+                <Typography.Text type="danger" title={file.error}>{t('Upload failed')}</Typography.Text>
             </Flex>
         );
       default:
-        return <Typography.Text type="secondary">等待上传</Typography.Text>;
+        return <Typography.Text type="secondary">{t('Waiting to upload')}</Typography.Text>;
     }
   };
 
   return (
     <Modal
       open={visible}
-      title="上传文件"
+      title={t('Upload File')}
       width={600}
       onCancel={onClose}
       footer={[
         <Button key="close" onClick={onClose} disabled={!allSuccess && files.some(f => f.status === 'uploading')}>
-          {allSuccess ? '关闭' : '完成'}
+          {allSuccess ? t('Close') : t('Done')}
         </Button>,
       ]}
     >
@@ -71,7 +73,7 @@ const UploadModal: React.FC<UploadModalProps> = ({ visible, files, onClose, onSt
               borderRadius: 8,
               transition: 'background-color 0.2s',
             }}
-            onMouseEnter={(e) => { e.currentTarget.style.backgroundColor = '#f0f0f0'; }}
+            onMouseEnter={(e) => { e.currentTarget.style.backgroundColor = 'var(--ant-color-fill-tertiary, #f0f0f0)'; }}
             onMouseLeave={(e) => { e.currentTarget.style.backgroundColor = 'transparent'; }}
           >
             <Flex justify="space-between" align="center" style={{ width: '100%' }}>
@@ -89,4 +91,4 @@ const UploadModal: React.FC<UploadModalProps> = ({ visible, files, onClose, onSt
   );
 };
 
-export default UploadModal;
+export default UploadModal;

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

@@ -1,11 +1,13 @@
 import { useState, useCallback } from 'react';
 import { Modal, Checkbox } from 'antd';
+import { useI18n } from '../../../i18n';
 import type { VfsEntry } from '../../../api/client';
 import type { AppDescriptor } from '../../../apps/registry';
 import type { AppWindow } from '../types';
 import { getAppsForEntry, getDefaultAppForEntry, getAppByKey } from '../../../apps/registry';
 
 export function useAppWindows(path: string) {
+  const { t } = useI18n();
   const [appWindows, setAppWindows] = useState<AppWindow[]>([]);
 
   const openWithApp = useCallback((entry: VfsEntry, app: AppDescriptor) => {
@@ -40,7 +42,7 @@ export function useAppWindows(path: string) {
   const openFileWithDefaultApp = useCallback((entry: VfsEntry) => {
     const apps = getAppsForEntry(entry);
     if (!apps.length) {
-      Modal.error({ title: '无法打开该文件：没有可用的应用' });
+      Modal.error({ title: t('Cannot open file: no available app') });
       return;
     }
     const defaultApp = getDefaultAppForEntry(entry) || apps[0];
@@ -50,17 +52,17 @@ export function useAppWindows(path: string) {
   const confirmOpenWithApp = useCallback((entry: VfsEntry, appKey: string) => {
     const app = getAppByKey(appKey);
     if (!app) {
-      Modal.error({ title: '错误', content: `应用 "${appKey}" 不存在。` });
+      Modal.error({ title: t('Error'), content: t('App "{key}" not found.', { key: appKey }) });
       return;
     }
     const ext = entry.name.split('.').pop()?.toLowerCase() || '';
     let setDefault = false;
     Modal.confirm({
-      title: `使用 ${app.name} 打开`,
+      title: t('Open with {app}', { app: app.name }),
       content: (
         <div>
-          <div style={{ marginBottom: 8 }}>文件: {entry.name}</div>
-          <Checkbox onChange={e => setDefault = e.target.checked}>设为该类型(.{ext})默认应用</Checkbox>
+          <div style={{ marginBottom: 8 }}>{t('File')}: {entry.name}</div>
+          <Checkbox onChange={e => setDefault = e.target.checked}>{t('Set as default for .{ext}', { ext })}</Checkbox>
         </div>
       ),
       onOk: () => {
@@ -92,4 +94,4 @@ export function useAppWindows(path: string) {
     bringToFront,
     updateWindow,
   };
-}
+}

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

@@ -1,5 +1,6 @@
 import { useCallback } from 'react';
 import { message, Modal } from 'antd';
+import { useI18n } from '../../../i18n';
 import { vfsApi, type VfsEntry } from '../../../api/client';
 
 interface FileActionsParams {
@@ -11,9 +12,10 @@ interface FileActionsParams {
 }
 
 export function useFileActions({ path, refresh, clearSelection, onShare, onGetDirectLink }: FileActionsParams) {
+  const { t } = useI18n();
   const doCreateDir = useCallback(async (name: string) => {
     if (!name.trim()) {
-      message.warning('请输入名称');
+      message.warning(t('Please input name'));
       return;
     }
     try {
@@ -26,8 +28,8 @@ export function useFileActions({ path, refresh, clearSelection, onShare, onGetDi
 
   const doDelete = useCallback(async (entries: VfsEntry[]) => {
     Modal.confirm({
-      title: `确认删除 ${entries.length > 1 ? `${entries.length} 项` : entries[0].name} ?`,
-      content: entries.length > 1 ? <div style={{ maxHeight: 180, overflow: 'auto' }}>{entries.map(it => <div key={it.name}>{it.name}{it.type === 'mount' && ' (挂载点)'}</div>)}</div> : null,
+      title: t('Confirm delete {name}?', { name: entries.length > 1 ? `${entries.length} ${t('items')}` : entries[0].name }),
+      content: entries.length > 1 ? <div style={{ maxHeight: 180, overflow: 'auto' }}>{entries.map(it => <div key={it.name}>{it.name}{it.type === 'mount' && ` (${t('Mount Point')})`}</div>)}</div> : null,
       onOk: async () => {
         try {
           await Promise.all(entries.map(it => vfsApi.deletePath((path === '/' ? '' : path) + '/' + it.name)));
@@ -57,7 +59,7 @@ export function useFileActions({ path, refresh, clearSelection, onShare, onGetDi
 
   const doDownload = useCallback(async (entry: VfsEntry) => {
     if (entry.is_dir) {
-      message.warning('暂不支持下载目录');
+      message.warning(t('Downloading folders is not supported'));
       return;
     }
     try {
@@ -72,13 +74,13 @@ export function useFileActions({ path, refresh, clearSelection, onShare, onGetDi
       document.body.removeChild(a);
       URL.revokeObjectURL(url);
     } catch (e: any) {
-      message.error(e.message || '下载失败');
+      message.error(e.message || t('Download failed'));
     }
   }, [path]);
 
   const doShare = useCallback((entries: VfsEntry[]) => {
     if (entries.length === 0) {
-      message.warning('请选择要分享的文件或目录');
+      message.warning(t('Please select files or folders to share'));
       return;
     }
     onShare(entries);
@@ -86,7 +88,7 @@ export function useFileActions({ path, refresh, clearSelection, onShare, onGetDi
 
   const doGetDirectLink = useCallback((entry: VfsEntry) => {
     if (entry.is_dir) {
-      message.warning('不支持获取目录的直链');
+      message.warning(t('Direct links for folders are not supported'));
       return;
     }
     onGetDirectLink(entry);
@@ -100,4 +102,4 @@ export function useFileActions({ path, refresh, clearSelection, onShare, onGetDi
     doShare,
     doGetDirectLink,
   };
-}
+}

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

@@ -18,17 +18,19 @@ export function useFileExplorer(navKey: string) {
     total: 0,
     showSizeChanger: true,
     showQuickJumper: true,
-    showTotal: (total: number, range: [number, number]) => `共 ${total} 项，第 ${range[0]}-${range[1]} 项`,
+    showTotal: (total: number, range: [number, number]) => `${total} ${'items'} ${range[0]}-${range[1]}`,
     pageSizeOptions: ['20', '50', '100', '200']
   });
+  const [sortBy, setSortBy] = useState('name');
+  const [sortOrder, setSortOrder] = useState('asc');
 
-  const load = useCallback(async (p: string, page: number = 1, pageSize: number = 50) => {
+  const load = useCallback(async (p: string, page: number = 1, pageSize: number = 50, sb = sortBy, so = sortOrder) => {
     const canonical = p === '' ? '/' : (p.startsWith('/') ? p : '/' + p);
     setLoading(true);
     try {
       // Load entries and processor types concurrently
       const [res, processors] = await Promise.all([
-        vfsApi.list(canonical === '/' ? '' : canonical, page, pageSize),
+        vfsApi.list(canonical === '/' ? '' : canonical, page, pageSize, sb, so),
         processorsApi.list()
       ]);
       setEntries(res.entries);
@@ -41,11 +43,11 @@ export function useFileExplorer(navKey: string) {
       }));
       setProcessorTypes(processors);
     } catch (e: any) {
-      message.error(e.message || '加载失败');
+      message.error(e.message || 'Load failed');
     } finally {
       setLoading(false);
     }
-  }, []);
+  }, [sortBy, sortOrder]);
 
   const navigateTo = useCallback((p: string) => {
     const canonical = p === '' || p === '/' ? '/' : (p.startsWith('/') ? p : '/' + p);
@@ -60,23 +62,32 @@ export function useFileExplorer(navKey: string) {
   }, [path, navigateTo]);
 
   const handlePaginationChange = (page: number, pageSize: number) => {
-    load(path, page, pageSize);
+    load(path, page, pageSize, sortBy, sortOrder);
   };
 
   const refresh = () => {
-    load(path, pagination.current, pagination.pageSize);
+    load(path, pagination.current, pagination.pageSize, sortBy, sortOrder);
   }
 
+  const handleSortChange = (sb: string, so: string) => {
+    setSortBy(sb);
+    setSortOrder(so);
+    load(path, 1, pagination.pageSize, sb, so);
+  };
+
   return {
     path,
     entries,
     loading,
     pagination,
     processorTypes,
+    sortBy,
+    sortOrder,
     load,
     navigateTo,
     goUp,
     handlePaginationChange,
     refresh,
+    handleSortChange
   };
-}
+}

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

@@ -1,5 +1,6 @@
 import { useState, useCallback } from 'react';
 import { message } from 'antd';
+import { useI18n } from '../../../i18n';
 import { processorsApi, type ProcessorTypeMeta } from '../../../api/processors';
 import type { VfsEntry } from '../../../api/client';
 
@@ -10,6 +11,7 @@ interface ProcessorParams {
 }
 
 export function useProcessor({ path, processorTypes, refresh }: ProcessorParams) {
+  const { t } = useI18n();
   const [modal, setModal] = useState<{ entry: VfsEntry | null; visible: boolean }>({ entry: null, visible: false });
   const [selectedProcessor, setSelectedProcessor] = useState<string>('');
   const [config, setConfig] = useState<any>({});
@@ -48,11 +50,11 @@ export function useProcessor({ path, processorTypes, refresh }: ProcessorParams)
       };
 
       await processorsApi.process(params);
-      message.success('处理完成');
+      message.success(t('Processing finished'));
       setModal({ entry: null, visible: false });
       if (overwrite || savingPath) refresh();
     } catch (e: any) {
-      message.error(e.message || '处理失败');
+      message.error(e.message || t('Processing failed'));
     } finally {
       setLoading(false);
     }
@@ -100,4 +102,4 @@ export function useProcessor({ path, processorTypes, refresh }: ProcessorParams)
     setProcessorSavingPath: setSavingPath,
     setProcessorOverwrite: setOverwrite,
   };
-}
+}

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

@@ -84,7 +84,7 @@ export function useUploader(path: string, onUploadComplete: () => void) {
         setFiles(prev => prev.map(f => f.id === uploadFile.id ? { ...f, status: 'success', progress: 100, permanentLink } : f));
       } catch (e: any) {
         setFiles(prev => prev.map(f => f.id === uploadFile.id ? { ...f, status: 'error', error: e.message } : f));
-        message.error(`上传失败: ${uploadFile.file.name} - ${e.message}`);
+        message.error(`Upload failed: ${uploadFile.file.name} - ${e.message}`);
       }
     }
     
@@ -101,4 +101,4 @@ export function useUploader(path: string, onUploadComplete: () => void) {
     handleFileDrop,
     startUpload,
   };
-}
+}

web/src/pages/LoginPage.tsx

@@ -4,6 +4,8 @@ import { UserOutlined, LockOutlined, GithubOutlined, SendOutlined, WechatOutline
 import { useAuth } from '../contexts/AuthContext';
 import { useSystemStatus } from '../contexts/SystemContext';
 import { useNavigate } from 'react-router';
+import { useI18n } from '../i18n';
+import LanguageSwitcher from '../components/LanguageSwitcher';
 
 const { Title, Text } = Typography;
 
@@ -15,12 +17,13 @@ export default function LoginPage() {
   const [err, setErr] = useState('');
   const [loading, setLoading] = useState(false);
   const navigate = useNavigate();
+  const { t } = useI18n();
 
   const handleSubmit = async () => {
     const u = username.trim();
     const p = password;
     if (!u || !p) {
-      setErr('请输入用户名与密码');
+      setErr(t('Please enter username and password'));
       return;
     }
     console.debug('[LoginPage] submit ->', { username: u, passwordLength: p.length });
@@ -31,7 +34,7 @@ export default function LoginPage() {
       navigate('/');
     } catch (e: any) {
       console.error('[LoginPage] login failed:', e);
-      setErr(e.message || '登录失败');
+      setErr(e.message || t('Login failed'));
     } finally {
       setLoading(false);
     }
@@ -44,19 +47,22 @@ export default function LoginPage() {
       height: '100vh',
       alignItems: 'center',
       justifyContent: 'center',
-      background: 'linear-gradient(to right, #f0f2f5, #d7d7d7)'
+      background: 'linear-gradient(to right, var(--ant-color-bg-layout, #f0f2f5), var(--ant-color-fill-secondary, #d7d7d7))'
     }}>
+      <div style={{ position: 'fixed', top: 12, right: 12, zIndex: 1000 }}>
+        <LanguageSwitcher />
+      </div>
       <div style={{
         display: 'flex',
         width: '80%',
         maxWidth: '1200px',
         height: '70%',
         maxHeight: '700px',
-        backgroundColor: 'rgba(255, 255, 255, 0.8)',
+        backgroundColor: 'var(--ant-color-bg-container, #fff)',
         borderRadius: '20px',
         boxShadow: '0 4px 30px rgba(0, 0, 0, 0.1)',
         backdropFilter: 'blur(5px)',
-        border: '1px solid rgba(255, 255, 255, 0.3)',
+        border: '1px solid var(--ant-color-border-secondary, #e5e5e5)',
         overflow: 'hidden'
       }}>
         <div style={{
@@ -71,9 +77,9 @@ export default function LoginPage() {
               <div style={{ marginBottom: '24px' }}>
                 <div style={{ display: 'flex', justifyContent: 'center', alignItems: 'center', marginBottom: 8 }}>
                   <img src={status?.logo} alt="Foxel Logo" style={{ width: 32, marginRight: 16 }} />
-                  <Title level={2} style={{ margin: 0, color: '#111' }}>欢迎回来</Title>
+                  <Title level={2} style={{ margin: 0, color: 'var(--ant-color-text, #111)' }}>{t('Welcome Back')}</Title>
                 </div>
-                <Text type="secondary" style={{ display: 'block', textAlign: 'center' }}>登录到您的 Foxel 账户</Text>
+                <Text type="secondary" style={{ display: 'block', textAlign: 'center' }}>{t('Sign in to your Foxel account')}</Text>
               </div>
 
               {err && <Alert message={err} type="error" showIcon style={{ marginBottom: 24 }} />}
@@ -82,7 +88,7 @@ export default function LoginPage() {
                 <Form.Item>
                   <Input
                     prefix={<UserOutlined />}
-                    placeholder="用户名/邮箱"
+                    placeholder={t('Username / Email')}
                     value={username}
                     onChange={e => setUsername(e.target.value)}
                     required
@@ -92,7 +98,7 @@ export default function LoginPage() {
                 <Form.Item>
                   <Input.Password
                     prefix={<LockOutlined />}
-                    placeholder="密码"
+                    placeholder={t('Password')}
                     value={password}
                     onChange={e => setPassword(e.target.value)}
                     required
@@ -106,7 +112,7 @@ export default function LoginPage() {
                     loading={loading}
                     style={{ width: '100%' }}
                   >
-                    登录
+                    {t('Sign In')}
                   </Button>
                 </Form.Item>
               </Form>
@@ -115,8 +121,8 @@ export default function LoginPage() {
         </div>
         <div style={{
           width: '50%',
-          backgroundColor: '#f0f2f5',
-          backgroundImage: `radial-gradient(#d7d7d7 1px, transparent 1px)`,
+          backgroundColor: 'var(--ant-color-fill-tertiary, #f0f2f5)',
+          backgroundImage: `radial-gradient(var(--ant-color-fill-secondary, #d7d7d7) 1px, transparent 1px)`,
           backgroundSize: '16px 16px',
           display: 'flex',
           flexDirection: 'column',
@@ -125,40 +131,40 @@ export default function LoginPage() {
           padding: '48px'
         }}>
           <div style={{ maxWidth: '500px' }}>
-            <Title level={3}>您的下一代文件管理系统</Title>
+            <Title level={3}>{t('Your next-generation file manager')}</Title>
             <Text type="secondary" style={{ fontSize: '16px', lineHeight: '1.8' }}>
               Foxel 旨在提供一个安全、高效且智能的文件管理解决方案，帮助您轻松组织、访问和共享您的数字资产。
             </Text>
             <div style={{ marginTop: '32px' }}>
               <Space direction="vertical" size="middle" style={{ width: '100%' }}>
-                <Card size="small" variant="borderless" style={{ backgroundColor: 'rgba(255,255,255,0.6)' }}>
+                <Card size="small" variant="borderless" style={{ backgroundColor: 'var(--ant-color-bg-container)' }}>
                   <Space>
-                    <CloudSyncOutlined style={{ fontSize: '20px', color: '#1677ff' }} />
-                    <Text>跨平台同步，随时随地访问</Text>
+                    <CloudSyncOutlined style={{ fontSize: '20px', color: 'var(--ant-color-primary, #1677ff)' }} />
+                    <Text>{t('Cross-platform sync, access anywhere')}</Text>
                   </Space>
                 </Card>
-                <Card size="small" variant="borderless" style={{ backgroundColor: 'rgba(255,255,255,0.6)' }}>
+                <Card size="small" variant="borderless" style={{ backgroundColor: 'var(--ant-color-bg-container)' }}>
                   <Space>
-                    <SearchOutlined style={{ fontSize: '20px', color: '#1677ff' }} />
-                    <Text>AI 驱动的智能搜索，快速定位文件</Text>
+                    <SearchOutlined style={{ fontSize: '20px', color: 'var(--ant-color-primary, #1677ff)' }} />
+                    <Text>{t('AI-powered search for quick find')}</Text>
                   </Space>
                 </Card>
-                <Card size="small" variant="borderless" style={{ backgroundColor: 'rgba(255,255,255,0.6)' }}>
+                <Card size="small" variant="borderless" style={{ backgroundColor: 'var(--ant-color-bg-container)' }}>
                   <Space>
-                    <ShareAltOutlined style={{ fontSize: '20px', color: '#1677ff' }} />
-                    <Text>灵活的分享与协作，提升团队效率</Text>
+                    <ShareAltOutlined style={{ fontSize: '20px', color: 'var(--ant-color-primary, #1677ff)' }} />
+                    <Text>{t('Flexible sharing and collaboration')}</Text>
                   </Space>
                 </Card>
-                <Card size="small" variant="borderless" style={{ backgroundColor: 'rgba(255,255,255,0.6)' }}>
+                <Card size="small" variant="borderless" style={{ backgroundColor: 'var(--ant-color-bg-container)' }}>
                   <Space>
-                    <ApartmentOutlined style={{ fontSize: '20px', color: '#1677ff' }} />
-                    <Text>强大的自动化工作流，简化繁琐任务</Text>
+                    <ApartmentOutlined style={{ fontSize: '20px', color: 'var(--ant-color-primary, #1677ff)' }} />
+                    <Text>{t('Powerful automation to simplify tasks')}</Text>
                   </Space>
                 </Card>
               </Space>
             </div>
             <div style={{ marginTop: '48px', textAlign: 'center' }}>
-              <Text type="secondary">加入我们的社区：</Text>
+              <Text type="secondary">{t('Join our community:')}</Text>
               <Button type="text" icon={<GithubOutlined />} href="https://github.com/DrizzleTime/Foxel" target="_blank">GitHub</Button>
               <Button type="text" icon={<SendOutlined />} href="https://t.me/+thDsBfyqJxZkNTU1" target="_blank">Telegram</Button>
               <Button type="text" icon={<WechatOutlined />}>微信</Button>

web/src/pages/LogsPage.tsx

@@ -2,6 +2,7 @@ import { memo, useState, useEffect, useCallback } from 'react';
 import { Table, message, Tag, Input, Select, Button, Space, Modal, DatePicker } from 'antd';
 import PageCard from '../components/PageCard';
 import { logsApi, type LogItem, type PaginatedLogs } from '../api/logs';
+import { useI18n } from '../i18n';
 import { format, formatISO } from 'date-fns';
 
 const { RangePicker } = DatePicker;
@@ -20,6 +21,7 @@ const LogsPage = memo(function LogsPage() {
     end_time: '',
   });
   const [selectedLog, setSelectedLog] = useState<LogItem | null>(null);
+  const { t } = useI18n();
 
   const fetchList = useCallback(async () => {
     setLoading(true);
@@ -31,7 +33,7 @@ const LogsPage = memo(function LogsPage() {
       const res = await logsApi.list(params);
       setData(res);
     } catch (e: any) {
-      message.error(e.message || '加载失败');
+      message.error(e.message || t('Load failed'));
     } finally {
       setLoading(false);
     }
@@ -43,18 +45,18 @@ const LogsPage = memo(function LogsPage() {
 
   const handleClearLogs = () => {
     Modal.confirm({
-      title: '确认清理日志?',
-      content: '该操作将删除选定时间范围内的所有日志，且不可恢复。',
+      title: t('Confirm clear logs?'),
+      content: t('This will delete logs in selected range irreversibly.'),
       onOk: async () => {
         try {
           const params = { start_time: filters.start_time, end_time: filters.end_time };
           if (!params.start_time) delete (params as any).start_time;
           if (!params.end_time) delete (params as any).end_time;
           const res = await logsApi.clear(params);
-          message.success(`成功清理 ${res.deleted_count} 条日志`);
+          message.success(t('Cleared {count} logs', { count: String(res.deleted_count) }));
           fetchList();
         } catch (e: any) {
-          message.error(e.message || '清理失败');
+          message.error(e.message || t('Clear failed'));
         }
       },
     });
@@ -62,13 +64,13 @@ const LogsPage = memo(function LogsPage() {
 
   const columns = [
     {
-      title: '时间',
+      title: t('Time'),
       dataIndex: 'timestamp',
       width: 180,
       render: (ts: string) => format(new Date(ts), 'yyyy-MM-dd HH:mm:ss'),
     },
     {
-      title: '级别',
+      title: t('Level'),
       dataIndex: 'level',
       width: 100,
       render: (level: string) => {
@@ -76,20 +78,20 @@ const LogsPage = memo(function LogsPage() {
         return <Tag color={color}>{level}</Tag>;
       },
     },
-    { title: '来源', dataIndex: 'source', width: 180 },
-    { title: '消息', dataIndex: 'message', ellipsis: true },
+    { title: t('Source'), dataIndex: 'source', width: 180 },
+    { title: t('Message'), dataIndex: 'message', ellipsis: true },
     {
-      title: '操作',
+      title: t('Actions'),
       width: 100,
       render: (_: any, rec: LogItem) => (
-        <Button size="small" onClick={() => setSelectedLog(rec)}>详情</Button>
+        <Button size="small" onClick={() => setSelectedLog(rec)}>{t('Details')}</Button>
       ),
     },
   ];
 
   return (
     <PageCard
-      title="系统日志"
+      title={t('System Logs')}
       extra={
         <Space>
           <RangePicker
@@ -105,7 +107,7 @@ const LogsPage = memo(function LogsPage() {
           />
           <Select
             style={{ width: 120 }}
-            placeholder="级别"
+            placeholder={t('Level')}
             allowClear
             value={filters.level || undefined}
             onChange={level => setFilters(f => ({ ...f, level: level || '', page: 1 }))}
@@ -113,12 +115,12 @@ const LogsPage = memo(function LogsPage() {
           />
           <Input.Search
             style={{ width: 240 }}
-            placeholder="搜索来源"
+            placeholder={t('Search source')}
             onSearch={source => setFilters(f => ({ ...f, source, page: 1 }))}
             allowClear
           />
-          <Button onClick={fetchList} loading={loading}>刷新</Button>
-          <Button danger onClick={handleClearLogs}>清理</Button>
+          <Button onClick={fetchList} loading={loading}>{t('Refresh')}</Button>
+          <Button danger onClick={handleClearLogs}>{t('Clear')}</Button>
         </Space>
       }
     >
@@ -136,14 +138,14 @@ const LogsPage = memo(function LogsPage() {
         }}
       />
       <Modal
-        title="日志详情"
+        title={t('Log Details')}
         open={!!selectedLog}
         onCancel={() => setSelectedLog(null)}
         footer={null}
         width={800}
       >
         {selectedLog && (
-          <pre style={{ maxHeight: '60vh', overflow: 'auto', background: '#f5f5f5', padding: 12 }}>
+          <pre style={{ maxHeight: '60vh', overflow: 'auto', background: 'var(--ant-color-fill-tertiary, #f5f5f5)', padding: 12 }}>
             {JSON.stringify(selectedLog.details, null, 2)}
           </pre>
         )}
@@ -152,4 +154,4 @@ const LogsPage = memo(function LogsPage() {
   );
 });
 
-export default LogsPage;
+export default LogsPage;

web/src/pages/OfflineDownloadPage.tsx

@@ -1,5 +1,8 @@
 import { Empty } from 'antd';
 
+import { useI18n } from '../i18n';
+
 export default function OfflineDownloadPage() {
-  return <Empty description="暂无离线下载任务" />;
+  const { t } = useI18n();
+  return <Empty description={t('No offline download tasks')} />;
 }

web/src/pages/PluginsPage.tsx

@@ -0,0 +1,159 @@
+import { memo, useEffect, useMemo, useState } from 'react';
+import { Button, Modal, Form, Input, Tag, message, Card, Typography, Popconfirm, Empty, Skeleton, theme, Divider } 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 { useI18n } from '../i18n';
+
+const PluginsPage = memo(function PluginsPage() {
+  const [data, setData] = useState<PluginItem[]>([]);
+  const [adding, setAdding] = useState(false);
+  const [loading, setLoading] = useState(false);
+  const [q, setQ] = useState('');
+  const [form] = Form.useForm<{ url: string }>();
+  const { token } = theme.useToken();
+  const { t } = useI18n();
+
+  const reload = async () => {
+    try { setLoading(true); setData(await pluginsApi.list()); } finally { setLoading(false); }
+  };
+
+  useEffect(() => { reload(); }, []);
+
+  const handleAdd = async () => {
+    try {
+      const { url } = await form.validateFields();
+      const created = await pluginsApi.create({ url });
+      try {
+        const p = await loadPluginFromUrl(created.url);
+        await ensureManifest(created.id, p);
+      } catch {}
+      setAdding(false);
+      form.resetFields();
+      await reload();
+      await reloadPluginApps();
+      message.success(t('Installed successfully'));
+    } catch {}
+  };
+
+  const filtered = useMemo(() => {
+    const s = q.trim().toLowerCase();
+    if (!s) return data;
+    return data.filter(p => (
+      (p.name || '').toLowerCase().includes(s)
+      || (p.author || '').toLowerCase().includes(s)
+      || (p.url || '').toLowerCase().includes(s)
+      || (p.description || '').toLowerCase().includes(s)
+      || (p.supported_exts || []).some(e => e.toLowerCase().includes(s))
+    ));
+  }, [data, 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 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>
+        {p.version && <Tag color="blue" style={{ marginLeft: 'auto' }}>{p.version}</Tag>}
+      </div>
+    );
+    return (
+      <Card
+        key={p.id}
+        title={title}
+        hoverable
+        size="small"
+        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>,
+          <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>
+        ]}
+      >
+        <div style={{ display: 'flex', gap: 12 }}>
+          <div style={{ flex: 1, minWidth: 0 }}>
+            <Typography.Paragraph style={{ marginBottom: 8 }} ellipsis={{ rows: 2 }}>
+              {p.description || '（暂无描述）'}
+            </Typography.Paragraph>
+            <div style={{ display: 'flex', alignItems: 'center', gap: 8, flexWrap: 'wrap' }}>
+              {(exts.length > 0 ? exts : ['任意']).map(e => <Tag key={e}>{e}</Tag>)}
+              {more > 0 && <Tag>+{more}</Tag>}
+            </div>
+            <Divider style={{ margin: '8px 0' }} />
+            {(p.author || p.github || p.website) && (
+              <div style={{ display: 'flex', alignItems: 'center', gap: 8, color: token.colorTextTertiary, fontSize: 12 }}>
+                {p.author && <span>{t('Author')}: {p.author}</span>}
+                <span style={{ marginLeft: 'auto', display: 'inline-flex', alignItems: 'center', gap: 8 }}>
+                  {p.github && (
+                    <a href={p.github || undefined} target="_blank" rel="noreferrer" title="GitHub">
+                      <GithubOutlined style={{ fontSize: 16, color: token.colorTextTertiary }} />
+                    </a>
+                  )}
+                  {p.website && (
+                    <a href={p.website || undefined} target="_blank" rel="noreferrer" title={t('Website')}>
+                      <LinkOutlined style={{ fontSize: 16, color: token.colorTextTertiary }} />
+                    </a>
+                  )}
+                </span>
+              </div>
+            )}
+          </div>
+        </div>
+      </Card>
+    );
+  };
+
+  return (
+    <>
+      <div style={{ display: 'flex', alignItems: 'center', gap: 8, marginBottom: 12, flexWrap: 'wrap' }}>
+        <Button type="primary" onClick={() => setAdding(true)}>{t('Install App')}</Button>
+        <Button onClick={reload} loading={loading}>{t('Refresh')}</Button>
+        <Input
+          placeholder={t('Search name/author/url/extension')}
+          value={q}
+          onChange={e => setQ(e.target.value)}
+          allowClear
+          style={{ maxWidth: 320, marginLeft: 'auto' }}
+          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>
+      )}
+      <Modal
+        title={t('Install App')}
+        open={adding}
+        onCancel={() => setAdding(false)}
+        onOk={handleAdd}
+        okText={t('Install')}
+      >
+        <Form form={form} layout="vertical">
+          <Form.Item name="url" label={t('App URL')} rules={[{ required: true }, { type: 'url', message: t('Please input a valid URL') }]}>
+            <Input placeholder="https://example.com/plugin.js" />
+          </Form.Item>
+        </Form>
+      </Modal>
+    </>
+  );
+});
+
+export default PluginsPage;

web/src/pages/PublicSharePage/DirectoryViewer.tsx

@@ -1,9 +1,10 @@
 import { memo, useState, useEffect, useCallback } from 'react';
-import { Card, message, List, Typography, Button, Empty, Breadcrumb } from 'antd';
+import { Card, List, Typography, Button, Empty, Breadcrumb } from 'antd';
 import { FileOutlined, FolderOutlined, DownloadOutlined } from '@ant-design/icons';
 import { shareApi, type ShareInfo } from '../../api/share';
 import { type VfsEntry } from '../../api/vfs';
 import { format, parseISO } from 'date-fns';
+import { useI18n } from '../../i18n';
 
 const { Title, Text } = Typography;
 
@@ -11,13 +12,15 @@ interface DirectoryViewerProps {
     token: string;
     shareInfo: ShareInfo;
     password?: string;
+    onFileClick: (entry: VfsEntry, path: string) => void;
 }
 
-export const DirectoryViewer = memo(function DirectoryViewer({ token, shareInfo, password }: DirectoryViewerProps) {
+export const DirectoryViewer = memo(function DirectoryViewer({ token, shareInfo, password, onFileClick }: DirectoryViewerProps) {
     const [loading, setLoading] = useState(true);
     const [entries, setEntries] = useState<VfsEntry[]>([]);
     const [currentPath, setCurrentPath] = useState('/');
     const [error, setError] = useState('');
+    const { t } = useI18n();
 
     const loadData = useCallback(async (p: string) => {
         setLoading(true);
@@ -27,7 +30,7 @@ export const DirectoryViewer = memo(function DirectoryViewer({ token, shareInfo,
             setEntries(listing.entries || []);
             setCurrentPath(p);
         } catch (e: any) {
-            setError(e.message || '加载分享失败');
+            setError(e.message || t('Share load failed'));
         } finally {
             setLoading(false);
         }
@@ -38,11 +41,11 @@ export const DirectoryViewer = memo(function DirectoryViewer({ token, shareInfo,
     }, [loadData, currentPath]);
 
     const handleEntryClick = (entry: VfsEntry) => {
+        const newPath = (currentPath === '/' ? '' : currentPath) + '/' + entry.name;
         if (entry.is_dir) {
-            const newPath = (currentPath === '/' ? '' : currentPath) + '/' + entry.name;
             loadData(newPath);
         } else {
-            message.info('暂不支持预览');
+            onFileClick(entry, newPath);
         }
     };
 
@@ -52,7 +55,7 @@ export const DirectoryViewer = memo(function DirectoryViewer({ token, shareInfo,
 
     const renderBreadcrumb = () => {
         const parts = currentPath.split('/').filter(Boolean);
-        const items = [{ title: '全部文件', path: '/' }];
+        const items = [{ title: t('Root'), path: '/' }];
         parts.forEach((part, i) => {
             const path = '/' + parts.slice(0, i + 1).join('/');
             items.push({ title: part, path });
@@ -81,8 +84,13 @@ export const DirectoryViewer = memo(function DirectoryViewer({ token, shareInfo,
             <Card>
                 <Title level={4}>{shareInfo?.name}</Title>
                 <Text type="secondary">
-                    创建于 {shareInfo && format(parseISO(shareInfo.created_at), 'yyyy-MM-dd')}
-                    {shareInfo?.expires_at && `，将于 ${format(parseISO(shareInfo.expires_at), 'yyyy-MM-dd')} 过期`}
+                    {t('Created on {date}', { date: format(parseISO(shareInfo.created_at), 'yyyy-MM-dd') })}
+                    {shareInfo?.expires_at ? (
+                      <>
+                        {' '}
+                        {t('Expires on {date}', { date: format(parseISO(shareInfo.expires_at), 'yyyy-MM-dd') })}
+                      </>
+                    ) : null}
                 </Text>
                 <div style={{ margin: '16px 0' }}>
                     {renderBreadcrumb()}
@@ -107,4 +115,4 @@ export const DirectoryViewer = memo(function DirectoryViewer({ token, shareInfo,
             </Card>
         </div>
     );
-});
+});

web/src/pages/PublicSharePage/FileViewer.tsx

@@ -1,39 +1,47 @@
 import { memo, useState, useEffect } from 'react';
 import { Card, Spin, Button, Typography, Empty } from 'antd';
-import { DownloadOutlined } from '@ant-design/icons';
+import { DownloadOutlined, ArrowLeftOutlined } from '@ant-design/icons';
 import { shareApi, type ShareInfo } from '../../api/share';
 import { type VfsEntry } from '../../api/vfs';
 import { format, parseISO } from 'date-fns';
 import ReactMarkdown from 'react-markdown';
+import { VideoViewer } from './VideoViewer';
+import { useI18n } from '../../i18n';
 
 const { Title, Text } = Typography;
 
+const isImageViewer = (name: string) => /\.(jpg|jpeg|png|gif|bmp|webp|svg)$/i.test(name);
+const isVideoViewable = (name: string) => /\.(mp4|webm|ogg|m4v|mov)$/i.test(name);
+
 interface FileViewerProps {
   token: string;
   shareInfo: ShareInfo;
   entry: VfsEntry;
   password?: string;
+  onBack: () => void;
+  path: string;
 }
 
-export const FileViewer = memo(function FileViewer({ token, shareInfo, entry, password }: FileViewerProps) {
+export const FileViewer = memo(function FileViewer({ token, shareInfo, entry, password, onBack, path }: FileViewerProps) {
   const [loading, setLoading] = useState(true);
   const [content, setContent] = useState<string>('');
   const [error, setError] = useState('');
+  const { t } = useI18n();
 
   useEffect(() => {
     const loadFileContent = async () => {
       setLoading(true);
       setError('');
       try {
-        const url = shareApi.downloadUrl(token, entry.name, password);
+        const url = shareApi.downloadUrl(token, path, password);
         const response = await fetch(url);
         if (!response.ok) {
-          throw new Error('无法加载文件');
+          throw new Error('Unable to load file');
         }
         const text = await response.text();
         setContent(text);
       } catch (e: any) {
-        setError(e.message || '加载文件失败');
+        setError(e.message || 'Failed to load file');
       } finally {
         setLoading(false);
       }
@@ -44,7 +52,7 @@ export const FileViewer = memo(function FileViewer({ token, shareInfo, entry, pa
     } else {
       setLoading(false);
     }
-  }, [token, entry.name, password]);
+  }, [token, entry.name, password, path]);
 
   const renderContent = () => {
     if (loading) {
@@ -53,21 +61,33 @@ export const FileViewer = memo(function FileViewer({ token, shareInfo, entry, pa
     if (error) {
       return <Empty description={error} />;
     }
+
+    const downloadUrl = shareApi.downloadUrl(token, path, password);
+
+    if (isImageViewer(entry.name)) {
+      return <img src={downloadUrl} alt={entry.name} style={{ maxWidth: '100%' }} />;
+    }
+
+    if (isVideoViewable(entry.name)) {
+      return <VideoViewer token={token} entry={entry} password={password} path={path} />;
+    }
+
     if (entry.name.endsWith('.md')) {
       return <ReactMarkdown>{content}</ReactMarkdown>;
     }
-    return (
+
+      return (
       <Empty
         description={
           <div>
-            <p>暂不支持在线预览此类型文件</p>
+            <p>{t('Preview not supported for this file type')}</p>
             <Button
               type="primary"
               icon={<DownloadOutlined />}
-              href={shareApi.downloadUrl(token, entry.name, password)}
+              href={downloadUrl}
               download
             >
-              下载文件
+              {t('Download File')}
             </Button>
           </div>
         }
@@ -80,17 +100,29 @@ export const FileViewer = memo(function FileViewer({ token, shareInfo, entry, pa
       <Card>
         <Title level={4}>{entry.name}</Title>
         <Text type="secondary">
-          创建于 {shareInfo && format(parseISO(shareInfo.created_at), 'yyyy-MM-dd')}
-          {shareInfo?.expires_at && `，将于 ${format(parseISO(shareInfo.expires_at), 'yyyy-MM-dd')} 过期`}
+          {t('Created on {date}', { date: format(parseISO(shareInfo.created_at), 'yyyy-MM-dd') })}
+          {shareInfo?.expires_at ? (
+            <>
+              {' '}
+              {t('Expires on {date}', { date: format(parseISO(shareInfo.expires_at), 'yyyy-MM-dd') })}
+            </>
+          ) : null}
         </Text>
         <div style={{ marginTop: 16 }}>
+          <Button
+            style={{ marginBottom: 16, marginRight: 8 }}
+            icon={<ArrowLeftOutlined />}
+            onClick={onBack}
+          >
+            {t('Back')}
+          </Button>
           <Button
             style={{ marginBottom: 16 }}
             icon={<DownloadOutlined />}
-            href={shareApi.downloadUrl(token, entry.name, password)}
+            href={shareApi.downloadUrl(token, path, password)}
             download
           >
-            下载
+            {t('Download')}
           </Button>
         </div>
         <Card>
@@ -99,4 +131,4 @@ export const FileViewer = memo(function FileViewer({ token, shareInfo, entry, pa
       </Card>
     </div>
   );
-});
+});

web/src/pages/PublicSharePage/VideoViewer.tsx

@@ -0,0 +1,50 @@
+import React, { useEffect, useRef } from 'react';
+import Artplayer from 'artplayer';
+import { shareApi } from '../../api/share';
+import type { VfsEntry } from '../../api/vfs';
+
+interface VideoViewerProps {
+  token: string;
+  entry: VfsEntry;
+  password?: string;
+  path: string;
+}
+
+export const VideoViewer: React.FC<VideoViewerProps> = ({ token, entry, password, path }) => {
+  const artRef = useRef<HTMLDivElement | null>(null);
+  const artInstance = useRef<Artplayer | null>(null);
+
+  useEffect(() => {
+    const videoUrl = shareApi.downloadUrl(token, path, password);
+
+    if (artRef.current) {
+      artInstance.current = new Artplayer({
+        container: artRef.current,
+        url: videoUrl,
+        autoplay: true,
+        fullscreen: true,
+        fullscreenWeb: true,
+        pip: true,
+        setting: true,
+        playbackRate: true,
+      });
+    }
+
+    return () => {
+      if (artInstance.current) {
+        artInstance.current.destroy();
+      }
+    };
+  }, [token, entry.name, password, path]);
+
+  return (
+    <div
+      ref={artRef}
+      style={{
+        width: '100%',
+        height: '450px',
+        backgroundColor: '#000'
+      }}
+    />
+  );
+};

web/src/pages/PublicSharePage/index.tsx

@@ -5,15 +5,17 @@ import { shareApi, type ShareInfo } from '../../api/share';
 import { type VfsEntry } from '../../api/vfs';
 import { DirectoryViewer } from './DirectoryViewer';
 import { FileViewer } from './FileViewer';
+import { useI18n } from '../../i18n';
 
 const PublicSharePage = memo(function PublicSharePage() {
   const { token } = useParams<{ token: string }>();
   const [loading, setLoading] = useState(true);
   const [shareInfo, setShareInfo] = useState<ShareInfo | null>(null);
-  const [entry, setEntry] = useState<VfsEntry | null>(null);
+  const [previewFile, setPreviewFile] = useState<{ entry: VfsEntry, path: string } | null>(null);
   const [error, setError] = useState('');
   const [password, setPassword] = useState('');
   const [verified, setVerified] = useState(false);
+  const { t } = useI18n();
 
   const loadData = useCallback(async (pwd?: string) => {
     if (!token) return;
@@ -37,12 +39,14 @@ const PublicSharePage = memo(function PublicSharePage() {
         const listing = await shareApi.listDir(token, '/', currentPassword);
         if (listing.entries.length === 1) {
           const singleEntry = listing.entries[0];
-          setEntry(singleEntry);
+          if (!singleEntry.is_dir) {
+            setPreviewFile({ entry: singleEntry, path: '/' + singleEntry.name });
+          }
         }
       }
 
     } catch (e: any) {
-      setError(e.message || '加载分享失败');
+      setError(e.message || t('Share load failed'));
       if (e.message === '需要密码') {
         setVerified(false);
       }
@@ -64,7 +68,7 @@ const PublicSharePage = memo(function PublicSharePage() {
       setError('');
       loadData(values.password_input);
     } catch (e: any) {
-      message.error(e.message || '密码错误');
+      message.error(e.message || t('Wrong password'));
     }
   };
 
@@ -79,14 +83,14 @@ const PublicSharePage = memo(function PublicSharePage() {
   if (shareInfo?.access_type === 'password' && !verified) {
     return (
       <div style={{ padding: '24px', maxWidth: 400, margin: '100px auto' }}>
-        <Card title="需要密码">
+        <Card title={t('Password Required')}>
           <Form onFinish={handlePasswordSubmit}>
-            <Form.Item name="password_input" rules={[{ required: true, message: '请输入密码' }]}>
-              <Input.Password placeholder="请输入密码" />
+            <Form.Item name="password_input" rules={[{ required: true, message: t('Please enter password') }]}>
+              <Input.Password placeholder={t('Please enter password')} />
             </Form.Item>
             <Form.Item>
               <Button type="primary" htmlType="submit" block>
-                确认
+                {t('Confirm')}
               </Button>
             </Form.Item>
           </Form>
@@ -96,14 +100,30 @@ const PublicSharePage = memo(function PublicSharePage() {
   }
 
   if (!shareInfo) {
-    return <div style={{ textAlign: 'center', padding: 50 }}><Empty description="无法加载分享信息" /></div>;
+    return <div style={{ textAlign: 'center', padding: 50 }}><Empty description={t('Unable to load share info')} /></div>;
   }
 
-  if (entry && !entry.is_dir) {
-    return <FileViewer token={token!} shareInfo={shareInfo} entry={entry} password={password} />;
-  } else {
-    return <DirectoryViewer token={token!} shareInfo={shareInfo} password={password} />;
+  const handleFileClick = (entry: VfsEntry, path: string) => {
+    setPreviewFile({ entry, path });
+  };
+
+  const handleBack = () => {
+    setPreviewFile(null);
+  };
+
+  if (previewFile) {
+    return (
+      <FileViewer
+        token={token!}
+        shareInfo={shareInfo}
+        entry={previewFile.entry}
+        password={password}
+        onBack={handleBack}
+        path={previewFile.path}
+      />
+    );
   }
+  return <DirectoryViewer token={token!} shareInfo={shareInfo} password={password} onFileClick={handleFileClick} />;
 });
 
-export default PublicSharePage;
+export default PublicSharePage;

web/src/pages/SetupPage.tsx

@@ -3,6 +3,8 @@ import { Form, Input, Button, Card, message, Steps, Select, Space, Typography }
 import { UserOutlined, LockOutlined, HddOutlined } from '@ant-design/icons';
 import { adaptersApi } from '../api/adapters';
 import { useAuth } from '../contexts/AuthContext';
+import { useI18n } from '../i18n';
+import LanguageSwitcher from '../components/LanguageSwitcher';
 
 const { Title, Text } = Typography;
 const { Step } = Steps;
@@ -12,12 +14,13 @@ const SetupPage = () => {
   const [currentStep, setCurrentStep] = useState(0);
   const [form] = Form.useForm();
   const { login, register } = useAuth();
+  const { t } = useI18n();
   const onFinish = async (values: any) => {
     setLoading(true);
     try {
       await register(values.username, values.password, values.email, values.full_name);
       await login(values.username, values.password);
-        message.success('初始化成功！正在为您登录，请不要刷新。');
+        message.success(t('Initialization succeeded! Logging you in...'));
       setTimeout(async () => {
         await adaptersApi.create({
           name: values.adapter_name,
@@ -33,7 +36,7 @@ const SetupPage = () => {
       }, 2000);
     } catch (error: any) {
       console.log(error)
-      message.error(error.response?.data?.msg || '初始化失败，请稍后重试');
+      message.error(error.response?.data?.msg || t('Initialization failed, please try later'));
     } finally {
       setLoading(false);
     }
@@ -57,13 +60,13 @@ const SetupPage = () => {
 
   const steps = [
     {
-      title: '数据库设置',
+      title: t('Database Setup'),
       content: (
         <>
-          <Title level={4}>选择数据库驱动</Title>
-          <Text type="secondary" style={{ marginBottom: 24, display: 'block' }}>选择用于存储系统数据的数据库和向量数据库。</Text>
+          <Title level={4}>{t('Choose database driver')}</Title>
+          <Text type="secondary" style={{ marginBottom: 24, display: 'block' }}>{t('Select database and vector database for system data')}</Text>
           <Form.Item
-            label="数据库驱动"
+            label={t('Database Driver')}
             name="db_driver"
             initialValue="sqlite"
             rules={[{ required: true }]}
@@ -71,7 +74,7 @@ const SetupPage = () => {
             <Select size="large" prefix={<HddOutlined />} disabled options={[{ label: 'SQLite', value: 'sqlite' }]} />
           </Form.Item>
           <Form.Item
-            label="向量数据库驱动"
+            label={t('Vector DB Driver')}
             name="vector_db_driver"
             initialValue="milvus"
             rules={[{ required: true }]}
@@ -82,96 +85,96 @@ const SetupPage = () => {
       )
     },
     {
-      title: '初始化挂载',
+      title: t('Initialize Mount'),
       content: (
         <>
-          <Title level={4}>配置初始存储</Title>
-          <Text type="secondary" style={{ marginBottom: 24, display: 'block' }}>为您的文件创建第一个存储挂载点。</Text>
+          <Title level={4}>{t('Configure initial storage')}</Title>
+          <Text type="secondary" style={{ marginBottom: 24, display: 'block' }}>{t('Create the first storage mount for your files')}</Text>
           <Form.Item
-            label="挂载名称"
+            label={t('Mount Name')}
             name="adapter_name"
-            initialValue="本地存储"
-            rules={[{ required: true, message: '请输入挂载名称！' }]}
+            initialValue={t('Local Storage')}
+            rules={[{ required: true, message: t('Please input mount name!') }]}
           >
             <Input size="large" prefix={<HddOutlined />} />
           </Form.Item>
           <Form.Item
-            label="存储类型"
+            label={t('Storage Type')}
             name="adapter_type"
             initialValue="local"
             rules={[{ required: true }]}
           >
-            <Select size="large" disabled options={[{ label: '本地存储', value: 'local' }]} />
+            <Select size="large" disabled options={[{ label: t('Local Storage'), value: 'local' }]} />
           </Form.Item>
           <Form.Item
-            label="挂载路径"
+            label={t('Mount Path')}
             name="path"
             initialValue="/local"
-            rules={[{ required: true, message: '请输入挂载路径！' }]}
+            rules={[{ required: true, message: t('Please input mount path!') }]}
           >
             <Input size="large" prefix={<HddOutlined />} />
           </Form.Item>
           <Form.Item
-            label="根目录"
+            label={t('Root Directory')}
             name="root_dir"
             initialValue="data/mount"
-            rules={[{ required: true, message: '请输入根目录！' }]}
+            rules={[{ required: true, message: t('Please input root directory!') }]}
           >
-            <Input size="large" placeholder="例如: data/ 或 /var/foxel/data" />
+            <Input size="large" placeholder={t('e.g., data/ or /var/foxel/data')} />
           </Form.Item>
         </>
       )
     },
     {
-      title: '创建管理员',
+      title: t('Create Admin'),
       content: (
         <>
-          <Title level={4}>创建管理员账户</Title>
-          <Text type="secondary" style={{ marginBottom: 24, display: 'block' }}>这是系统的第一个账户，将拥有最高权限。</Text>
+          <Title level={4}>{t('Create admin account')}</Title>
+          <Text type="secondary" style={{ marginBottom: 24, display: 'block' }}>{t('This is the first account with full permissions')}</Text>
           <Form.Item
-            label="用户名"
+            label={t('Username')}
             name="username"
-            rules={[{ required: true, message: '请输入用户名！' }]}
+            rules={[{ required: true, message: t('Please input username!') }]}
           >
             <Input size="large" prefix={<UserOutlined />} />
           </Form.Item>
 
           <Form.Item
-            label="昵称"
+            label={t('Full Name')}
             name="full_name"
           >
             <Input size="large" prefix={<UserOutlined />} />
           </Form.Item>
 
           <Form.Item
-            label="邮箱"
+            label={t('Email')}
             name="email"
-            rules={[{ type: 'email', message: '请输入有效的邮箱地址！' }]}
+            rules={[{ type: 'email', message: t('Please input a valid email!') }]}
           >
             <Input size="large" prefix={<UserOutlined />} />
           </Form.Item>
 
           <Form.Item
-            label="密码"
+            label={t('Password')}
             name="password"
-            rules={[{ required: true, message: '请输入密码！' }]}
+            rules={[{ required: true, message: t('Please enter password') }]}
           >
             <Input.Password size="large" prefix={<LockOutlined />} />
           </Form.Item>
 
           <Form.Item
-            label="确认密码"
+            label={t('Confirm Password')}
             name="confirm"
             dependencies={['password']}
             hasFeedback
             rules={[
-              { required: true, message: '请确认您的密码！' },
+              { required: true, message: t('Please confirm your password!') },
               ({ getFieldValue }) => ({
                 validator(_, value) {
                   if (!value || getFieldValue('password') === value) {
                     return Promise.resolve();
                   }
-                  return Promise.reject(new Error('两次输入的密码不一致！'));
+                  return Promise.reject(new Error(t('Passwords do not match!')));
                 },
               }),
             ]}
@@ -190,12 +193,15 @@ const SetupPage = () => {
       height: '100vh',
       alignItems: 'center',
       justifyContent: 'center',
-      background: 'linear-gradient(to right, #f0f2f5, #d7d7d7)'
+      background: 'linear-gradient(to right, var(--ant-color-bg-layout, #f0f2f5), var(--ant-color-fill-secondary, #d7d7d7))'
     }}>
+      <div style={{ position: 'fixed', top: 12, right: 12, zIndex: 1000 }}>
+        <LanguageSwitcher />
+      </div>
       <Card style={{ width: 'clamp(400px, 40vw, 600px)', padding: '24px 16px' }}>
         <div style={{ textAlign: 'center', marginBottom: 32 }}>
           <img src="/logo.svg" alt="Foxel Logo" style={{ width: 48, marginBottom: 16 }} />
-          <Title level={2}>系统初始化</Title>
+          <Title level={2}>{t('System Initialization')}</Title>
         </div>
         <Steps current={currentStep} style={{ marginBottom: 32 }}>
           {steps.map(item => (
@@ -215,17 +221,17 @@ const SetupPage = () => {
           <Space>
             {currentStep > 0 && (
               <Button style={{ margin: '0 8px' }} onClick={() => prev()}>
-                上一步
+                {t('Previous')}
               </Button>
             )}
             {currentStep < steps.length - 1 && (
               <Button type="primary" onClick={() => next()}>
-                下一步
+                {t('Next')}
               </Button>
             )}
             {currentStep === steps.length - 1 && (
               <Button type="primary" htmlType="submit" loading={loading} onClick={() => form.submit()}>
-                完成初始化
+                {t('Finish Initialization')}
               </Button>
             )}
           </Space>
@@ -235,4 +241,4 @@ const SetupPage = () => {
   );
 };
 
-export default SetupPage;
+export default SetupPage;

web/src/pages/SharePage.tsx

@@ -5,9 +5,11 @@ import { shareApi, type ShareInfo } from '../api/share';
 import { format, parseISO } from 'date-fns';
 import { LinkOutlined, CopyOutlined, DeleteOutlined } from '@ant-design/icons';
 import { useSystemStatus } from '../contexts/SystemContext';
+import { useI18n } from '../i18n';
 
 const SharePage = memo(function SharePage() {
   const systemStatus = useSystemStatus();
+  const { t } = useI18n();
   const [loading, setLoading] = useState(false);
   const [data, setData] = useState<ShareInfo[]>([]);
 
@@ -17,7 +19,7 @@ const SharePage = memo(function SharePage() {
       const list = await shareApi.list();
       setData(list);
     } catch (e: any) {
-      message.error(e.message || '加载失败');
+      message.error(e.message || t('Load failed'));
     } finally {
       setLoading(false);
     }
@@ -29,22 +31,22 @@ const SharePage = memo(function SharePage() {
     const baseUrl = systemStatus?.app_domain || window.location.origin;
     const shareUrl = new URL(`/share/${rec.token}`, baseUrl).href;
     navigator.clipboard.writeText(shareUrl);
-    message.success('链接已复制');
+    message.success(t('Copied link'));
   };
 
   const doDelete = async (rec: ShareInfo) => {
     try {
       await shareApi.remove(rec.id);
-      message.success('分享已取消');
+      message.success(t('Share canceled'));
       fetchList();
     } catch (e: any) {
-      message.error(e.message || '取消失败');
+      message.error(e.message || t('Cancel failed'));
     }
   };
 
   const columns = [
     { 
-      title: '分享名称', 
+      title: t('Share Name'), 
       dataIndex: 'name',
       render: (name: string, rec: ShareInfo) => (
         <a href={`/share/${rec.token}`} target="_blank" rel="noopener noreferrer">
@@ -54,7 +56,7 @@ const SharePage = memo(function SharePage() {
       )
     },
     { 
-      title: '分享内容', 
+      title: t('Share Content'), 
       dataIndex: 'paths',
       ellipsis: true,
       render: (paths: string[]) => (
@@ -64,31 +66,31 @@ const SharePage = memo(function SharePage() {
       )
     },
     { 
-      title: '创建时间', 
+      title: t('Created At'), 
       dataIndex: 'created_at', 
       width: 180,
       render: (v: string) => format(parseISO(v), 'yyyy-MM-dd HH:mm')
     },
     {
-      title: '过期时间',
+      title: t('Expires At'),
       dataIndex: 'expires_at',
       width: 180,
-      render: (v?: string) => v ? <Tag color="orange">{format(parseISO(v), 'yyyy-MM-dd HH:mm')}</Tag> : <Tag>永久有效</Tag>
+      render: (v?: string) => v ? <Tag color="orange">{format(parseISO(v), 'yyyy-MM-dd HH:mm')}</Tag> : <Tag>{t('Forever')}</Tag>
     },
     {
-      title: '访问',
+      title: t('Access'),
       dataIndex: 'access_type',
       width: 100,
-      render: (v: 'public' | 'password') => v === 'password' ? <Tag color="red">密码</Tag> : <Tag color="green">公开</Tag>
+      render: (v: 'public' | 'password') => v === 'password' ? <Tag color="red">{t('By Password')}</Tag> : <Tag color="green">{t('Public')}</Tag>
     },
     {
-      title: '操作',
+      title: '',
       width: 160,
       render: (_: any, rec: ShareInfo) => (
         <Space size="small">
-          <Button size="small" icon={<CopyOutlined />} onClick={() => doCopy(rec)}>复制</Button>
-          <Popconfirm title="确认取消分享?" onConfirm={() => doDelete(rec)}>
-            <Button size="small" danger icon={<DeleteOutlined />}>取消</Button>
+          <Button size="small" icon={<CopyOutlined />} onClick={() => doCopy(rec)}>{t('Copy')}</Button>
+          <Popconfirm title={t('Are you sure to cancel share?')} onConfirm={() => doDelete(rec)}>
+            <Button size="small" danger icon={<DeleteOutlined />}>{t('Cancel')}</Button>
           </Popconfirm>
         </Space>
       )
@@ -97,8 +99,8 @@ const SharePage = memo(function SharePage() {
 
   return (
     <PageCard
-      title="我的分享"
-      extra={<Button onClick={fetchList} loading={loading}>刷新</Button>}
+      title={t('My Shares')}
+      extra={<Button onClick={fetchList} loading={loading}>{t('Refresh')}</Button>}
     >
       <Table
         rowKey="id"

web/src/pages/SystemSettingsPage/BackupPage.tsx

@@ -3,19 +3,21 @@ import { Button, Typography, Upload, message, Modal } from 'antd';
 import PageCard from '../../components/PageCard';
 import { UploadOutlined, DownloadOutlined } from '@ant-design/icons';
 import { backupApi } from '../../api/backup';
+import { useI18n } from '../../i18n';
 
 const { Paragraph, Text } = Typography;
 
 const BackupPage = memo(function BackupPage() {
   const [loading, setLoading] = useState(false);
+  const { t } = useI18n();
 
   const handleExport = async () => {
     setLoading(true);
     try {
       await backupApi.export();
-      message.success('导出已开始，请检查您的下载。');
+      message.success(t('Export started, check your downloads.'));
     } catch (e: any) {
-      message.error(e.message || '导出失败');
+      message.error(e.message || t('Export failed'));
     } finally {
       setLoading(false);
     }
@@ -23,24 +25,24 @@ const BackupPage = memo(function BackupPage() {
 
   const handleImport = (file: File) => {
     Modal.confirm({
-      title: '确认导入备份?',
+      title: t('Confirm import backup?'),
       content: (
         <Typography>
-          <Paragraph>您确定要从此文件导入数据吗?</Paragraph>
-          <Paragraph strong>警告：此操作将覆盖当前数据库中的所有现有数据，包括用户（含密码）、设置、存储和任务。此操作不可逆！</Paragraph>
+          <Paragraph>{t('Are you sure to import from this file?')}</Paragraph>
+          <Paragraph strong>{t('Warning: This will overwrite all data including users (with passwords), settings, storages and tasks. Irreversible!')}</Paragraph>
         </Typography>
       ),
-      okText: '确认导入',
+      okText: t('Confirm Import'),
       okType: 'danger',
-      cancelText: '取消',
+      cancelText: t('Cancel'),
       onOk: async () => {
         setLoading(true);
         try {
           const response = await backupApi.import(file);
-          message.success(response.message || '导入成功！页面将刷新。');
+          message.success(response.message || t('Import succeeded! The page will refresh.'));
           setTimeout(() => window.location.reload(), 2000);
         } catch (e: any) {
-          message.error(e.message || '导入失败');
+          message.error(e.message || t('Import failed'));
         } finally {
           setLoading(false);
         }
@@ -50,33 +52,33 @@ const BackupPage = memo(function BackupPage() {
   };
 
   return (
-    <PageCard title="备份和恢复">
+    <PageCard title={t('Backup & Restore')}>
 
       <div style={{ display: 'flex', gap: '16px' }}>
-        <PageCard title="导出" style={{ flex: 1 }}>
+        <PageCard title={t('Export')} style={{ flex: 1 }}>
           <Paragraph>
-            点击下面的按钮将所有数据（包括存储、用户、自动化任务和分享）导出为一个 JSON 文件。
-            <Text strong>请妥善保管您的备份文件。</Text>
+            {t('Export all data (adapters, users, tasks, shares) into a JSON file.')}
+            <Text strong>{t('Keep your backup file safe.')}</Text>
           </Paragraph>
           <Button
             icon={<DownloadOutlined />}
             onClick={handleExport}
             loading={loading}
           >
-            导出备份
+            {t('Export Backup')}
           </Button>
         </PageCard>
-        <PageCard title="恢复" style={{ flex: 1 }}>
+        <PageCard title={t('Import')} style={{ flex: 1 }}>
           <Paragraph>
-            从之前导出的JSON文件恢复数据。
-            <Text strong type="danger">警告：此操作将清除并覆盖现有数据。</Text>
+            {t('Restore data from a previously exported JSON file.')}
+            <Text strong type="danger">{t('Warning: This will clear and overwrite existing data.')}</Text>
           </Paragraph>
           <Upload
             beforeUpload={handleImport}
             showUploadList={false}
           >
             <Button icon={<UploadOutlined />} loading={loading}>
-              选择文件并恢复
+              {t('Choose File and Restore')}
             </Button>
           </Upload>
         </PageCard>
@@ -85,4 +87,4 @@ const BackupPage = memo(function BackupPage() {
   );
 });
 
-export default BackupPage;
+export default BackupPage;

web/src/pages/SystemSettingsPage/SystemSettingsPage.tsx

@@ -1,34 +1,49 @@
-import { Form, Input, Button, message, Tabs, Space, Card } from 'antd';
+import { Form, Input, Button, message, Tabs, Space, Card, Select, Modal, Radio, InputNumber } from 'antd';
 import { useEffect, useState } from 'react';
 import PageCard from '../../components/PageCard';
 import { getAllConfig, setConfig } from '../../api/config';
-import { AppstoreOutlined, RobotOutlined } from '@ant-design/icons';
+import { vectorDBApi } from '../../api/vectorDB';
+import { AppstoreOutlined, RobotOutlined, DatabaseOutlined, SkinOutlined } from '@ant-design/icons';
+import { useTheme } from '../../contexts/ThemeContext';
+import '../../styles/settings-tabs.css';
+import { useI18n } from '../../i18n';
 
 const APP_CONFIG_KEYS: {key: string, label: string, default?: string}[] = [
-  { key: 'APP_NAME', label: '应用名称' },
-  { key: 'APP_LOGO', label: 'LOGO地址' },
-  { key: 'APP_DOMAIN', label: '应用域名' },
-  { key: 'FILE_DOMAIN', label: '文件域名' },
+  { key: 'APP_NAME', label: 'App Name' },
+  { key: 'APP_LOGO', label: 'Logo URL' },
+  { key: 'APP_DOMAIN', label: 'App Domain' },
+  { key: 'FILE_DOMAIN', label: 'File Domain' },
 ];
 
 const VISION_CONFIG_KEYS = [
-  { key: 'AI_VISION_API_URL', label: '视觉模型 API 地址' },
-  { key: 'AI_VISION_MODEL', label: '视觉模型', default: 'Qwen/Qwen2.5-VL-32B-Instruct' },
-  { key: 'AI_VISION_API_KEY', label: '视觉模型 API Key' },
+  { key: 'AI_VISION_API_URL', label: 'Vision API URL' },
+  { key: 'AI_VISION_MODEL', label: 'Vision Model', default: 'Qwen/Qwen2.5-VL-32B-Instruct' },
+  { key: 'AI_VISION_API_KEY', label: 'Vision API Key' },
 ];
 
 const EMBED_CONFIG_KEYS = [
-  { key: 'AI_EMBED_API_URL', label: '嵌入模型 API 地址' },
-  { key: 'AI_EMBED_MODEL', label: '嵌入模型', default: 'Qwen/Qwen3-Embedding-8B' },
-  { key: 'AI_EMBED_API_KEY', label: '嵌入模型 API Key' },
+  { key: 'AI_EMBED_API_URL', label: 'Embedding API URL' },
+  { key: 'AI_EMBED_MODEL', label: 'Embedding Model', default: 'Qwen/Qwen3-Embedding-8B' },
+  { key: 'AI_EMBED_API_KEY', label: 'Embedding API Key' },
 ];
 
 const ALL_AI_KEYS = [...VISION_CONFIG_KEYS, ...EMBED_CONFIG_KEYS];
 
+// Theme related config keys
+const THEME_KEYS = {
+  MODE: 'THEME_MODE',
+  PRIMARY: 'THEME_PRIMARY_COLOR',
+  RADIUS: 'THEME_BORDER_RADIUS',
+  TOKENS: 'THEME_CUSTOM_TOKENS',
+  CSS: 'THEME_CUSTOM_CSS',
+};
+
 export default function SystemSettingsPage() {
   const [loading, setLoading] = useState(false);
   const [config, setConfigState] = useState<Record<string, string> | null>(null);
-  const [activeTab, setActiveTab] = useState('app');
+  const [activeTab, setActiveTab] = useState('appearance');
+  const { refreshTheme, previewTheme } = useTheme();
+  const { t } = useI18n();
 
   useEffect(() => {
     getAllConfig().then((data) => setConfigState(data as Record<string, string>));
@@ -40,35 +55,127 @@ export default function SystemSettingsPage() {
       for (const [key, value] of Object.entries(values)) {
         await setConfig(key, String(value ?? ''));
       }
-      message.success('保存成功');
+      message.success(t('Saved successfully'));
       setConfigState({ ...config, ...values });
+      // trigger theme refresh if related keys changed
+      if (Object.keys(values).some(k => Object.values(THEME_KEYS).includes(k))) {
+        await refreshTheme();
+      }
     } catch (e: any) {
-      message.error(e.message || '保存失败');
+      message.error(e.message || t('Save failed'));
     }
     setLoading(false);
   };
 
+  // 离开“外观设置”时，恢复后端持久化配置（取消未保存的预览）
+  useEffect(() => {
+    if (activeTab !== 'appearance') {
+      refreshTheme();
+    }
+  }, [activeTab]);
+
   if (!config) {
-    return <PageCard title='系统设置'><div>加载中...</div></PageCard>;
+    return <PageCard title={t('System Settings')}><div>{t('Loading...')}</div></PageCard>;
   }
 
   return (
     <PageCard
-      title='系统设置'
+      title={t('System Settings')}
     >
       <Space direction="vertical" style={{ width: '100%' }} size={32}>
         <Tabs
+          className="fx-settings-tabs"
           activeKey={activeTab}
           onChange={setActiveTab}
           centered
           tabPosition="left"
           items={[
+            {
+              key: 'appearance',
+              label: (
+                <span>
+                  <SkinOutlined style={{ marginRight: 8 }} />
+                  {t('Appearance Settings')}
+                </span>
+              ),
+              children: (
+                <Form
+                  layout="vertical"
+                  initialValues={{
+                    [THEME_KEYS.MODE]: config[THEME_KEYS.MODE] ?? 'light',
+                    [THEME_KEYS.PRIMARY]: config[THEME_KEYS.PRIMARY] ?? '#111111',
+                    [THEME_KEYS.RADIUS]: Number(config[THEME_KEYS.RADIUS] ?? '10'),
+                    [THEME_KEYS.TOKENS]: config[THEME_KEYS.TOKENS] ?? '',
+                    [THEME_KEYS.CSS]: config[THEME_KEYS.CSS] ?? '',
+                  }}
+                  onValuesChange={(_, all) => {
+                    try {
+                      const tokens = all[THEME_KEYS.TOKENS] ? JSON.parse(all[THEME_KEYS.TOKENS]) : undefined;
+                      previewTheme({
+                        mode: all[THEME_KEYS.MODE],
+                        primaryColor: all[THEME_KEYS.PRIMARY],
+                        borderRadius: typeof all[THEME_KEYS.RADIUS] === 'number' ? all[THEME_KEYS.RADIUS] : undefined,
+                        customTokens: tokens,
+                        customCSS: all[THEME_KEYS.CSS],
+                      });
+                    } catch {
+                      // JSON 不合法时忽略 tokens 预览，其他项仍然生效
+                      previewTheme({
+                        mode: all[THEME_KEYS.MODE],
+                        primaryColor: all[THEME_KEYS.PRIMARY],
+                        borderRadius: typeof all[THEME_KEYS.RADIUS] === 'number' ? all[THEME_KEYS.RADIUS] : undefined,
+                        customCSS: all[THEME_KEYS.CSS],
+                      });
+                    }
+                  }}
+                  onFinish={async (vals) => {
+                    // Validate JSON if provided
+                    if (vals[THEME_KEYS.TOKENS]) {
+                      try { JSON.parse(vals[THEME_KEYS.TOKENS]); }
+                      catch { return message.error(t('Advanced tokens must be valid JSON')); }
+                    }
+                    await handleSave(vals);
+                  }}
+                  style={{ marginTop: 24 }}
+                  key={'appearance-' + JSON.stringify(config)}
+                >
+                  <Card title={t('Theme')}>
+                    <Form.Item name={THEME_KEYS.MODE} label={t('Theme Mode')}>
+                      <Radio.Group buttonStyle="solid">
+                        <Radio.Button value="light">{t('Light')}</Radio.Button>
+                        <Radio.Button value="dark">{t('Dark')}</Radio.Button>
+                        <Radio.Button value="system">{t('Follow System')}</Radio.Button>
+                      </Radio.Group>
+                    </Form.Item>
+                    <Form.Item name={THEME_KEYS.PRIMARY} label={t('Primary Color')}>
+                      <Input type="color" size="large" />
+                    </Form.Item>
+                    <Form.Item name={THEME_KEYS.RADIUS} label={t('Border Radius')}>
+                      <InputNumber min={0} max={24} style={{ width: '100%' }} />
+                    </Form.Item>
+                  </Card>
+                  <Card title={t('Advanced')} style={{ marginTop: 24 }}>
+                    <Form.Item name={THEME_KEYS.TOKENS} label={t('Override AntD Tokens (JSON)')} tooltip={t('e.g. {"colorText": "#222"}') }>
+                      <Input.TextArea autoSize={{ minRows: 4 }} placeholder='{ "colorText": "#222" }' />
+                    </Form.Item>
+                    <Form.Item name={THEME_KEYS.CSS} label={t('Custom CSS')}>
+                      <Input.TextArea autoSize={{ minRows: 6 }} placeholder={":root{ }\n/* CSS */"} />
+                    </Form.Item>
+                  </Card>
+                  <Form.Item style={{ marginTop: 24 }}>
+                    <Button type="primary" htmlType="submit" loading={loading} block>
+                      {t('Save')}
+                    </Button>
+                  </Form.Item>
+                </Form>
+              )
+            },
             {
               key: 'app',
               label: (
                 <span>
                   <AppstoreOutlined style={{ marginRight: 8 }} />
-                  应用设置
+                  {t('App Settings')}
                 </span>
               ),
               children: (
@@ -82,13 +189,13 @@ export default function SystemSettingsPage() {
                   key={JSON.stringify(config)}
                 >
                   {APP_CONFIG_KEYS.map(({ key, label }) => (
-                    <Form.Item key={key} name={key} label={label}>
+                    <Form.Item key={key} name={key} label={t(label)}>
                       <Input size="large" />
                     </Form.Item>
                   ))}
                   <Form.Item>
                     <Button type="primary" htmlType="submit" loading={loading} block>
-                      保存
+                      {t('Save')}
                     </Button>
                   </Form.Item>
                 </Form>
@@ -99,7 +206,7 @@ export default function SystemSettingsPage() {
               label: (
                 <span>
                   <RobotOutlined style={{ marginRight: 8 }} />
-                  AI设置
+                  {t('AI Settings')}
                 </span>
               ),
               children: (
@@ -112,28 +219,76 @@ export default function SystemSettingsPage() {
                   style={{ marginTop: 24 }}
                   key={JSON.stringify(config)}
                 >
-                  <Card title="视觉模型" style={{ marginBottom: 24 }}>
+                  <Card title={t('Vision Model')} style={{ marginBottom: 24 }}>
                     {VISION_CONFIG_KEYS.map(({ key, label }) => (
-                      <Form.Item key={key} name={key} label={label}>
+                      <Form.Item key={key} name={key} label={t(label)}>
                         <Input size="large" />
                       </Form.Item>
                     ))}
                   </Card>
-                  <Card title="嵌入模型">
+                  <Card title={t('Embedding Model')}>
                     {EMBED_CONFIG_KEYS.map(({ key, label }) => (
-                      <Form.Item key={key} name={key} label={label}>
+                      <Form.Item key={key} name={key} label={t(label)}>
                         <Input size="large" />
                       </Form.Item>
                     ))}
                   </Card>
                   <Form.Item style={{ marginTop: 24 }}>
                     <Button type="primary" htmlType="submit" loading={loading} block>
-                      保存
+                      {t('Save')}
                     </Button>
                   </Form.Item>
                 </Form>
               ),
             },
+            {
+              key: 'vector-db',
+              label: (
+                <span>
+                  <DatabaseOutlined style={{ marginRight: 8 }} />
+                  {t('Vector Database')}
+                </span>
+              ),
+              children: (
+                <Card title={t('Vector Database Settings')} style={{ marginTop: 24 }}>
+                  <Form layout="vertical">
+                    <Form.Item label={t('Database Type')}>
+                      <Select
+                        size="large"
+                        value={'Milvus Lite'}
+                        disabled
+                        options={[{ value: 'Milvus Lite', label: 'Milvus Lite' }]}
+                      />
+                    </Form.Item>
+                    <Form.Item>
+                      <Button
+                        danger
+                        block
+                        onClick={() => {
+                          Modal.confirm({
+                            title: t('Confirm clear vector database?'),
+                            content: t('This will delete all collections irreversibly.'),
+                            okText: t('Confirm Clear'),
+                            okType: 'danger',
+                            cancelText: t('Cancel'),
+                            onOk: async () => {
+                              try {
+                                await vectorDBApi.clearAll();
+                                message.success(t('Vector database cleared'));
+                              } catch (e: any) {
+                                message.error(e.message || t('Clear failed'));
+                              }
+                            },
+                          });
+                        }}
+                      >
+                        {t('Clear Vector DB')}
+                      </Button>
+                    </Form.Item>
+                  </Form>
+                </Card>
+              ),
+            },
           ]}
         />
       </Space>

web/src/pages/TasksPage.tsx

@@ -1,9 +1,10 @@
 import { memo, useState, useEffect, useCallback } from 'react';
-import { Table, Button, Space, Drawer, Form, Input, Switch, message, Typography, Popconfirm, Select } from 'antd';
+import { Table, Button, Space, Drawer, Form, Input, Switch, message, Typography, Popconfirm, Select, Modal, Tag } from 'antd';
 import PageCard from '../components/PageCard';
-import { tasksApi, type AutomationTask } from '../api/tasks';
+import { tasksApi, type AutomationTask, type QueuedTask } from '../api/tasks';
 import { processorsApi, type ProcessorTypeMeta } from '../api/processors';
 import { ProcessorConfigForm } from '../components/ProcessorConfigForm';
+import { useI18n } from '../i18n';
 
 const TasksPage = memo(function TasksPage() {
   const [loading, setLoading] = useState(false);
@@ -12,6 +13,10 @@ const TasksPage = memo(function TasksPage() {
   const [editing, setEditing] = useState<AutomationTask | null>(null);
   const [form] = Form.useForm();
   const [availableProcessors, setAvailableProcessors] = useState<ProcessorTypeMeta[]>([]);
+  const [queueModalOpen, setQueueModalOpen] = useState(false);
+  const [queuedTasks, setQueuedTasks] = useState<QueuedTask[]>([]);
+  const [queueLoading, setQueueLoading] = useState(false);
+  const { t } = useI18n();
 
   const fetchList = useCallback(async () => {
     setLoading(true);
@@ -86,19 +91,58 @@ const TasksPage = memo(function TasksPage() {
     }
   };
 
+  const fetchQueue = async () => {
+    setQueueLoading(true);
+    try {
+      const tasks = await tasksApi.getQueue();
+      setQueuedTasks(tasks);
+    } catch (e: any) {
+      message.error(e.message || '加载队列失败');
+    } finally {
+      setQueueLoading(false);
+    }
+  };
+
+  const openQueueModal = () => {
+    setQueueModalOpen(true);
+    fetchQueue();
+  };
+
+  const toggleEnabled = async (rec: AutomationTask, enabled: boolean) => {
+    setEditing(rec);
+    setLoading(true);
+    try {
+      await tasksApi.update(rec.id, { enabled });
+      message.success('状态已更新');
+      fetchList();
+    } catch (e: any) {
+      message.error(e.message || '更新失败');
+    } finally {
+      setEditing(null);
+      setLoading(false);
+    }
+  };
+
   const columns = [
-    { title: '名称', dataIndex: 'name' },
-    { title: '触发事件', dataIndex: 'event', width: 120 },
-    { title: '处理器', dataIndex: 'processor_type', width: 180 },
-    { title: '启用', dataIndex: 'enabled', width: 80, render: (v: boolean) => <Switch checked={v} size="small" disabled /> },
+    { title: t('Name'), dataIndex: 'name' },
+    { title: t('Trigger Event'), dataIndex: 'event', width: 120 },
+    { title: t('Processor'), dataIndex: 'processor_type', width: 180 },
     {
-      title: '操作',
+      title: t('Enabled'), dataIndex: 'enabled', width: 80, render: (v: boolean, rec: AutomationTask) => <Switch
+        checked={v}
+        size="small"
+        loading={loading && editing?.id === rec.id}
+        onChange={(checked) => toggleEnabled(rec, checked)}
+      />
+    },
+    {
+      title: t('Actions'),
       width: 160,
       render: (_: any, rec: AutomationTask) => (
         <Space size="small">
-          <Button size="small" onClick={() => openEdit(rec)}>编辑</Button>
-          <Popconfirm title="确认删除?" onConfirm={() => doDelete(rec)}>
-            <Button size="small" danger>删除</Button>
+          <Button size="small" onClick={() => openEdit(rec)}>{t('Edit')}</Button>
+          <Popconfirm title={t('Confirm delete?')} onConfirm={() => doDelete(rec)}>
+            <Button size="small" danger>{t('Delete')}</Button>
           </Popconfirm>
         </Space>
       )
@@ -111,11 +155,12 @@ const TasksPage = memo(function TasksPage() {
 
   return (
     <PageCard
-      title="自动化任务"
+      title={t('Automation Tasks')}
       extra={
         <Space>
-          <Button onClick={fetchList} loading={loading}>刷新</Button>
-          <Button type="primary" onClick={openCreate}>新建任务</Button>
+          <Button onClick={fetchList} loading={loading}>{t('Refresh')}</Button>
+          <Button onClick={openQueueModal}>{t('Running Tasks')}</Button>
+          <Button type="primary" onClick={openCreate}>{t('Create Task')}</Button>
         </Space>
       }
     >
@@ -128,42 +173,42 @@ const TasksPage = memo(function TasksPage() {
         style={{ marginBottom: 0 }}
       />
       <Drawer
-        title={editing ? `编辑任务: ${editing.name}` : '新建自动化任务'}
+        title={editing ? `${t('Edit Task')}: ${editing.name}` : t('Create Automation Task')}
         width={480}
         open={open}
         onClose={() => { setOpen(false); setEditing(null); }}
         destroyOnClose
         extra={
           <Space>
-            <Button onClick={() => { setOpen(false); setEditing(null); }}>取消</Button>
-            <Button type="primary" onClick={submit} loading={loading}>提交</Button>
+            <Button onClick={() => { setOpen(false); setEditing(null); }}>{t('Cancel')}</Button>
+            <Button type="primary" onClick={submit} loading={loading}>{t('Submit')}</Button>
           </Space>
         }
       >
         <Form form={form} layout="vertical">
-          <Form.Item name="name" label="任务名称" rules={[{ required: true }]}>
+          <Form.Item name="name" label={t('Task Name')} rules={[{ required: true }]}> 
             <Input />
           </Form.Item>
-          <Form.Item name="event" label="触发事件" rules={[{ required: true }]}>
-            <Select options={[
-              { value: 'file_written', label: '文件写入' },
-              { value: 'file_deleted', label: '文件删除' },
+          <Form.Item name="event" label={t('Trigger Event')} rules={[{ required: true }]}> 
+            <Select options={[ 
+              { value: 'file_written', label: t('File Written') }, 
+              { value: 'file_deleted', label: t('File Deleted') }, 
             ]} />
           </Form.Item>
-          <Typography.Title level={5} style={{ marginTop: 8, fontSize: 14 }}>匹配规则</Typography.Title>
-          <Form.Item name="path_pattern" label="路径前缀 (可选)">
+          <Typography.Title level={5} style={{ marginTop: 8, fontSize: 14 }}>{t('Matching Rules')}</Typography.Title>
+          <Form.Item name="path_pattern" label={t('Path Prefix (optional)')}>
             <Input placeholder="/images/screenshots" />
           </Form.Item>
-          <Form.Item name="filename_regex" label="文件名正则 (可选)">
+          <Form.Item name="filename_regex" label={t('Filename Regex (optional)')}>
             <Input placeholder=".*\.png$" />
           </Form.Item>
-          <Form.Item name="enabled" label="启用" valuePropName="checked">
+          <Form.Item name="enabled" label={t('Enabled')} valuePropName="checked">
             <Switch />
           </Form.Item>
-          <Typography.Title level={5} style={{ marginTop: 8, fontSize: 14 }}>执行动作</Typography.Title>
-          <Form.Item name="processor_type" label="处理器" rules={[{ required: true }]}>
+          <Typography.Title level={5} style={{ marginTop: 8, fontSize: 14 }}>{t('Action')}</Typography.Title>
+          <Form.Item name="processor_type" label={t('Processor')} rules={[{ required: true }]}>
             <Select
-              placeholder="选择一个处理器"
+              placeholder={t('Select a processor')}
               options={availableProcessors.map(p => ({ value: p.type, label: `${p.name} (${p.type})` }))}
             />
           </Form.Item>
@@ -174,6 +219,40 @@ const TasksPage = memo(function TasksPage() {
           />
         </Form>
       </Drawer>
+      <Modal
+        title={t('Current Task Queue')}
+        open={queueModalOpen}
+        onCancel={() => setQueueModalOpen(false)}
+        width={800}
+        footer={[
+          <Button key="refresh" onClick={fetchQueue} loading={queueLoading}>{t('Refresh')}</Button>,
+          <Button key="close" onClick={() => setQueueModalOpen(false)}>{t('Close')}</Button>
+        ]}
+      >
+        <Table
+          size="small"
+          rowKey="id"
+          dataSource={queuedTasks}
+          loading={queueLoading}
+          pagination={false}
+          columns={[
+            { title: 'ID', dataIndex: 'id', width: 120, render: (id) => <Typography.Text style={{ fontSize: 12 }} copyable={{ text: id }}>{id.slice(0, 8)}</Typography.Text> },
+            { title: t('Task Name'), dataIndex: 'name' },
+            { title: t('Params'), dataIndex: 'task_info', render: (info) => <Typography.Text type="secondary" style={{ fontSize: 12 }}>{JSON.stringify(info)}</Typography.Text> },
+            {
+              title: t('Status'), dataIndex: 'status', width: 100, render: (status: QueuedTask['status']) => {
+                const colorMap = {
+                  pending: 'default',
+                  running: 'processing',
+                  success: 'success',
+                  failed: 'error'
+                };
+                return <Tag color={colorMap[status]}>{status}</Tag>;
+              }
+            },
+          ]}
+        />
+      </Modal>
     </PageCard>
   );
 });

web/src/plugins/runtime.ts

@@ -0,0 +1,120 @@
+import { pluginsApi, type PluginManifestUpdate } from '../api/plugins';
+
+export interface RegisteredPlugin {
+  mount: (container: HTMLElement, ctx: {
+    filePath: string;
+    entry: any;
+    urls: { downloadUrl: string };
+    host: HostApi;
+  }) => void | Promise<void>;
+  unmount?: (container: HTMLElement) => void | Promise<void>;
+
+  key?: string;
+  name?: string;
+  version?: string;
+  supportedExts?: string[];
+  defaultBounds?: { x?: number; y?: number; width?: number; height?: number };
+  defaultMaximized?: boolean;
+  icon?: string;
+  description?: string;
+  author?: string;
+  website?: string;
+  github?: string;
+}
+
+export interface HostApi {
+  close: () => void;
+}
+
+const loadedPlugins = new Map<string, RegisteredPlugin>();
+const waiters = new Map<string, ((p: RegisteredPlugin) => void)[]>();
+const injected = new Set<string>();
+
+declare global {
+  interface Window { FoxelRegister?: (plugin: RegisteredPlugin) => void; }
+}
+
+window.FoxelRegister = (plugin: RegisteredPlugin) => {
+  const pendingUrl = sessionStorage.getItem('foxel:pendingPluginUrl') || '';
+  if (pendingUrl) {
+    loadedPlugins.set(pendingUrl, plugin);
+    const resolvers = waiters.get(pendingUrl) || [];
+    resolvers.forEach(fn => fn(plugin));
+    waiters.delete(pendingUrl);
+    sessionStorage.removeItem('foxel:pendingPluginUrl');
+  } else {
+    const anyUrl = Array.from(waiters.keys())[0];
+    if (anyUrl) {
+      loadedPlugins.set(anyUrl, plugin);
+      const resolvers = waiters.get(anyUrl) || [];
+      resolvers.forEach(fn => fn(plugin));
+      waiters.delete(anyUrl);
+    }
+  }
+};
+
+export async function loadPluginFromUrl(url: string): Promise<RegisteredPlugin> {
+  const existing = loadedPlugins.get(url);
+  if (existing) return existing;
+  return new Promise<RegisteredPlugin>((resolve, reject) => {
+    const arr = waiters.get(url) || [];
+    arr.push(resolve);
+    waiters.set(url, arr);
+
+    const ready = loadedPlugins.get(url);
+    if (ready) {
+      const resolvers = waiters.get(url) || [];
+      resolvers.forEach(fn => fn(ready));
+      waiters.delete(url);
+      return;
+    }
+
+    sessionStorage.setItem('foxel:pendingPluginUrl', url);
+
+    if (!injected.has(url)) {
+      injected.add(url);
+      const script = document.createElement('script');
+      script.src = url;
+      script.async = true;
+      script.onerror = () => {
+        waiters.delete(url);
+        reject(new Error('Failed to load plugin script: ' + url));
+      };
+      document.head.appendChild(script);
+    }
+
+    const t = setTimeout(() => {
+      if (!loadedPlugins.get(url)) {
+        waiters.delete(url);
+        reject(new Error('Plugin did not call FoxelRegister: ' + url));
+      }
+    }, 15000);
+
+    const last = arr[arr.length - 1];
+    arr[arr.length - 1] = (p: RegisteredPlugin) => { clearTimeout(t); last(p); };
+  });
+}
+
+export async function ensureManifest(pluginId: number, plugin: RegisteredPlugin) {
+  const manifest: PluginManifestUpdate = {
+    key: plugin.key,
+    name: plugin.name,
+    version: plugin.version,
+    supported_exts: plugin.supportedExts,
+    default_bounds: plugin.defaultBounds,
+    default_maximized: plugin.defaultMaximized,
+    icon: plugin.icon,
+    description: plugin.description,
+    author: plugin.author,
+    website: plugin.website,
+    github: plugin.github,
+  };
+  try { console.debug('[foxel] report manifest', pluginId, manifest); } catch { }
+  const key = `foxel:manifestReported:${pluginId}`;
+  if (sessionStorage.getItem(key) === '1') return;
+  try {
+    await pluginsApi.updateManifest(pluginId, manifest);
+    sessionStorage.setItem(key, '1');
+  } catch {
+  }
+}

web/src/router/LayoutShell.tsx

@@ -11,33 +11,34 @@ import OfflineDownloadPage from '../pages/OfflineDownloadPage.tsx';
 import SystemSettingsPage from '../pages/SystemSettingsPage/SystemSettingsPage.tsx';
 import LogsPage from '../pages/LogsPage.tsx';
 import BackupPage from '../pages/SystemSettingsPage/BackupPage.tsx';
+import PluginsPage from '../pages/PluginsPage.tsx';
 
 const LayoutShell = memo(function LayoutShell() {
   const { navKey = 'files' } = useParams();
   const navigate = useNavigate();
   const [collapsed, setCollapsed] = useState(false);
   return (
-    <Layout style={{ minHeight: '100vh' }}>
+    <Layout style={{ minHeight: '100vh', background: 'var(--ant-color-bg-layout)' }}>
       <SideNav
         collapsed={collapsed}
         onToggle={() => setCollapsed(c => !c)}
         activeKey={navKey}
         onChange={(key) => navigate(`/${key}`)}
       />
-      <Layout>
+      <Layout style={{ background: 'var(--ant-color-bg-layout)' }}>
         <TopHeader collapsed={collapsed} onToggle={() => setCollapsed(c => !c)} />
-        <Layout.Content style={{ padding: 16 }}>
-          <div style={{ minHeight: 'calc(100vh - 56px - 32px)' }}>
+        <Layout.Content style={{ padding: 16, background: 'var(--ant-color-bg-layout)' }}>
+          <div style={{ minHeight: 'calc(100vh - 56px - 32px)', background: 'var(--ant-color-bg-layout)' }}>
             <Flex vertical gap={16}>
               {navKey === 'adapters' && <AdaptersPage />}
               {navKey === 'files' && <FileExplorerPage />}
               {navKey === 'share' && <SharePage />}
               {navKey === 'tasks' && <TasksPage />}
               {navKey === 'offline' && <OfflineDownloadPage />}
+              {navKey === 'plugins' && <PluginsPage />}
               {navKey === 'settings' && <SystemSettingsPage />}
               {navKey === 'logs' && <LogsPage />}
               {navKey === 'backup' && <BackupPage />}
-              {!['adapters','files','image','video','doc','fav','recent','recycle','share','tasks','offline','settings', 'logs', 'backup'].includes(navKey!) && <FileExplorerPage />}
             </Flex>
           </div>
         </Layout.Content>

web/src/styles/settings-tabs.css

@@ -0,0 +1,40 @@
+.fx-settings-tabs .ant-tabs-nav-list {
+  padding: 8px 4px;
+}
+
+.fx-settings-tabs .ant-tabs-tab {
+  margin: 4px 0 !important;
+  border-radius: 8px;
+  padding: 6px 10px !important;
+}
+
+.fx-settings-tabs .ant-tabs-tab .ant-tabs-tab-btn {
+  color: var(--ant-color-text-secondary) !important;
+}
+
+.fx-settings-tabs .ant-tabs-tab:hover {
+  background: var(--ant-color-fill-tertiary) !important;
+}
+
+/* 选中态：按主题细分 */
+html[data-theme='dark'] .fx-settings-tabs .ant-tabs-tab-active {
+  background: var(--ant-color-primary-bg) !important;
+}
+html[data-theme='dark'] .fx-settings-tabs .ant-tabs-tab-active .ant-tabs-tab-btn,
+html[data-theme='dark'] .fx-settings-tabs .ant-tabs-tab-active .ant-tabs-tab-btn .anticon {
+  color: var(--ant-color-text) !important;
+  font-weight: 600;
+}
+
+html[data-theme='light'] .fx-settings-tabs .ant-tabs-tab-active {
+  background: var(--ant-color-primary) !important;
+}
+html[data-theme='light'] .fx-settings-tabs .ant-tabs-tab-active .ant-tabs-tab-btn,
+html[data-theme='light'] .fx-settings-tabs .ant-tabs-tab-active .ant-tabs-tab-btn .anticon {
+  color: var(--ant-color-text-light-solid) !important;
+  font-weight: 600;
+}
+
+.fx-settings-tabs .ant-tabs-ink-bar {
+  background: var(--ant-color-primary) !important;
+}

web/src/styles/sider-menu.css

@@ -5,13 +5,24 @@
   margin-block: 2px;
 }
 
-.foxel-sider-menu .ant-menu-item-selected {
-  font-weight: 600;
+.foxel-sider-menu .ant-menu-item-selected { font-weight: 600; }
+
+/* 亮色主题：选中项使用主色，文字用浅色文本 */
+html[data-theme='light'] .foxel-sider-menu .ant-menu-item-selected {
+  background: var(--ant-color-primary) !important;
+  color: var(--ant-color-text-light-solid) !important;
+}
+html[data-theme='light'] .foxel-sider-menu .ant-menu-item-selected .ant-menu-item-icon {
+  color: var(--ant-color-text-light-solid) !important;
 }
 
-.foxel-sider-menu .ant-menu-item-selected,
-.foxel-sider-menu .ant-menu-item-selected .ant-menu-item-icon {
-  color: #fff !important;
+/* 暗色主题：选中项使用主色背景（浅），文字使用常规文本色以保持对比度 */
+html[data-theme='dark'] .foxel-sider-menu .ant-menu-item-selected {
+  background: var(--ant-color-primary-bg) !important;
+  color: var(--ant-color-text) !important;
+}
+html[data-theme='dark'] .foxel-sider-menu .ant-menu-item-selected .ant-menu-item-icon {
+  color: var(--ant-color-text) !important;
 }
 
 .foxel-sider-menu .ant-menu-item-selected::after {
@@ -21,3 +32,8 @@
 .foxel-sider-menu .ant-menu-item .ant-menu-item-icon {
   transition: color .18s;
 }
+
+/* 悬停（未选中）背景 */
+.foxel-sider-menu .ant-menu-item:not(.ant-menu-item-selected):hover {
+  background: var(--ant-color-fill-tertiary) !important;
+}