兼容v0.2.0核心

v0.1.6
修改了部署脚本
2026-05-28 14:32:02 +08:00 · 2026-05-20 14:02:13 +08:00 · 2026-05-11 18:31:41 +08:00
47 changed files with 745 additions and 2080 deletions
--- a/.env.full.example
+++ b/.env.full.example
@ -5,8 +5,8 @@ NGINX_PORT=8080
 # Only workspace root still needs an absolute host path.
 HOST_BOTS_WORKSPACE_ROOT=/opt/dashboard-nanobot/workspace/bots

-# Fixed Docker bridge subnet for the compose network.
-# Change this if it conflicts with your host LAN / VPN / intranet routing.
+# Shared Docker network for dashboard and bot containers.
+# deploy-full.sh will reuse it when it already exists, or create it with the subnet below.
 DOCKER_NETWORK_NAME=dashboard-nanobot-network
 DOCKER_NETWORK_SUBNET=172.20.0.0/16

--- a/.env.prod.example
+++ b/.env.prod.example
@ -5,8 +5,8 @@ NGINX_PORT=8082
 # Only workspace root still needs an absolute host path.
 HOST_BOTS_WORKSPACE_ROOT=/dep/dashboard-nanobot/workspace/bots

-# Fixed Docker bridge subnet for the compose network.
-# Change this if it conflicts with your host LAN / VPN / intranet routing.
+# Shared Docker network for dashboard and bot containers.
+# deploy-prod.sh will reuse it when it already exists, or create it with the subnet below.
 DOCKER_NETWORK_NAME=dashboard-nanobot-network
 DOCKER_NETWORK_SUBNET=172.20.0.0/16

@ -48,8 +48,6 @@ DEFAULT_BOT_SYSTEM_TIMEZONE=Asia/Shanghai

 # Panel access protection (deployment secret, not stored in sys_setting)
 PANEL_ACCESS_PASSWORD=change_me_panel_password
-WORKSPACE_PREVIEW_SIGNING_SECRET=change_me_workspace_preview_signing_secret
-WORKSPACE_PREVIEW_TOKEN_TTL_SECONDS=3600

 # Browser credential requests must use an explicit CORS allowlist (deployment security setting).
 # If frontend and backend are served under the same origin via nginx `/api` proxy,
--- a/README.md
+++ b/README.md
@ -112,6 +112,7 @@ graph TD
   - 复制 `.env.prod.example` 为 `.env.prod`（位于项目根目录）
   - `data/` 会自动映射到宿主机项目根目录下的 `./data`
   - `deploy-prod.sh` 现在要求使用外部 PostgreSQL，且目标库必须提前执行 `scripts/sql/create-tables.sql` 与 `scripts/sql/init-data.sql`
+   - `DOCKER_NETWORK_NAME` 表示 Dashboard 与 Bot 共用的 Docker network；`deploy-prod.sh` 会优先复用现有 network，不存在时按 `DOCKER_NETWORK_SUBNET` 自动创建
   - 只需要配置绝对路径：
     - `HOST_BOTS_WORKSPACE_ROOT`
   - 如启用本地语音识别，请将 Whisper `.bin` 模型文件放到宿主机项目根目录的 `data/model/`
@ -122,7 +123,7 @@ graph TD
     - 如需基础镜像加速，覆盖 `PYTHON_BASE_IMAGE` / `NODE_BASE_IMAGE` / `NGINX_BASE_IMAGE`
 2. 启动服务
   - `./scripts/deploy-prod.sh`
-   - 或：`docker compose --env-file .env.prod -f docker-compose.prod.yml up -d --build`
+   - 如需手动执行 `docker compose`，请先自行创建 `DOCKER_NETWORK_NAME` 指向的 Docker network
 3. 访问
   - `http://<host>:${NGINX_PORT}`（默认 `8080`）

@ -130,6 +131,7 @@ graph TD

 - `backend` 不开放宿主机端口，仅在内部网络被 Nginx 访问。
 - `deploy-prod.sh` 仅负责前后端容器部署，不会初始化外部数据库；外部 PostgreSQL 需要事先建表并导入初始化数据。
+- `deploy-prod.sh` 会确保 `DOCKER_NETWORK_NAME` 对应的共享 Docker network 存在，但停止服务时不会删除该 network。
 - 如果启用 Redis，`REDIS_URL` 必须从 `backend` 容器内部可达；在 `docker-compose.prod.yml` 里使用 `127.0.0.1` 只会指向后端容器自己，不是宿主机。
 - Redis 不可达时，通用缓存健康检查会显示 `degraded`；面板登录认证会自动回退到数据库登录态，不再因为缓存不可达直接报错。
 - `UPLOAD_MAX_MB` 仅用于 Nginx 入口限制；后端业务校验值来自 `sys_setting.upload_max_mb`。
@ -160,6 +162,7 @@ graph TD
 1. 准备部署变量
   - 复制 `.env.full.example` 为 `.env.full`
   - `data/` 会自动映射到宿主机项目根目录下的 `./data`
+   - `DOCKER_NETWORK_NAME` 表示 Dashboard 与 Bot 共用的 Docker network；`deploy-full.sh` 会优先复用现有 network，不存在时按 `DOCKER_NETWORK_SUBNET` 自动创建
   - 必填修改：
     - `HOST_BOTS_WORKSPACE_ROOT`
     - `POSTGRES_SUPERPASSWORD`
@ -174,6 +177,7 @@ graph TD
 ### 初始化说明

 - `scripts/deploy-full.sh` 会先启动 `postgres` / `redis`，然后自动调用 `scripts/init-full-db.sh`。
+- `scripts/deploy-full.sh` 会确保 `DOCKER_NETWORK_NAME` 对应的共享 Docker network 存在，但停止服务时不会删除该 network。
 - `scripts/init-full-db.sh` 负责：
  - 等待 PostgreSQL 就绪
  - 创建或更新业务账号
--- a/backend/.env.example
+++ b/backend/.env.example
@ -26,8 +26,6 @@ REDIS_DEFAULT_TTL=60

 # Optional panel-level access password for all backend API/WS calls.
 PANEL_ACCESS_PASSWORD=
-WORKSPACE_PREVIEW_SIGNING_SECRET=
-WORKSPACE_PREVIEW_TOKEN_TTL_SECONDS=3600

 # Explicit CORS allowlist for browser credential requests.
 # For local development, the backend defaults to common Vite dev origins.
--- a/backend/api/workspace_router.py
+++ b/backend/api/workspace_router.py
@ -6,6 +6,7 @@ from sqlmodel import Session
 from core.database import get_session
 from models.bot import BotInstance
 from schemas.system import WorkspaceFileUpdateRequest, WorkspacePreviewUrlRequest
+from services.platform_system_settings_service import get_workspace_preview_token_ttl_seconds
 from services.workspace_service import (
    create_workspace_html_preview_url,
    get_workspace_tree_data,
@ -77,10 +78,13 @@ def create_workspace_preview_url(
    bot = session.get(BotInstance, bot_id)
    if not bot:
        raise HTTPException(status_code=404, detail="Bot not found")
+    ttl_seconds = payload.ttl_seconds
+    if ttl_seconds is None:
+        ttl_seconds = get_workspace_preview_token_ttl_seconds(session)
    return create_workspace_html_preview_url(
        bot_id=bot_id,
        path=payload.path,
-        ttl_seconds=payload.ttl_seconds,
+        ttl_seconds=ttl_seconds,
    )

@router.get("/api/bots/{bot_id}/workspace/download")
--- a/backend/core/database.py
+++ b/backend/core/database.py
@ -42,19 +42,6 @@ REQUIRED_TABLES = (
    "topic_item",
 )

-REQUIRED_SYS_SETTING_KEYS = (
-    "page_size",
-    "chat_pull_page_size",
-    "auth_token_ttl_hours",
-    "auth_token_max_active",
-    "upload_max_mb",
-    "allowed_attachment_extensions",
-    "workspace_download_extensions",
-    "speech_enabled",
-    "activity_event_retention_days",
-)
-
-
 def _validate_required_tables() -> None:
    inspector = inspect(engine)
    missing = [table_name for table_name in REQUIRED_TABLES if not inspector.has_table(table_name)]
@ -65,30 +52,14 @@ def _validate_required_tables() -> None:
            "Run scripts/init-full-db.sh or apply scripts/sql/create-tables.sql before starting the backend."
        )

-
-def _validate_required_sys_settings() -> None:
-    placeholders = ", ".join(f":k{i}" for i, _ in enumerate(REQUIRED_SYS_SETTING_KEYS))
-    params = {f"k{i}": key for i, key in enumerate(REQUIRED_SYS_SETTING_KEYS)}
-    with engine.connect() as conn:
-        rows = conn.execute(
-            text(f'SELECT key FROM "{SYS_SETTING_TABLE}" WHERE key IN ({placeholders})'),
-            params,
-        ).scalars().all()
-    present = {str(row or "").strip() for row in rows if str(row or "").strip()}
-    missing = [key for key in REQUIRED_SYS_SETTING_KEYS if key not in present]
-    if missing:
-        raise RuntimeError(
-            "Database seed data is not initialized. "
-            f"Missing sys_setting keys: {', '.join(missing)}. "
-            "Run scripts/init-full-db.sh or apply scripts/sql/init-data.sql before starting the backend."
-        )
-
-
 def init_database() -> None:
    with engine.connect() as conn:
        conn.execute(text("SELECT 1"))
    _validate_required_tables()
-    _validate_required_sys_settings()
+    from services.platform_system_settings_service import validate_required_system_settings
+
+    with Session(engine) as session:
+        validate_required_system_settings(session)


 def get_session():
--- a/backend/core/settings.py
+++ b/backend/core/settings.py
@ -189,15 +189,6 @@ DEFAULT_PAGE_SIZE: Final[int] = 10
 DEFAULT_CHAT_PULL_PAGE_SIZE: Final[int] = 60
 DEFAULT_AUTH_TOKEN_TTL_HOURS: Final[int] = _env_int("AUTH_TOKEN_TTL_HOURS", 24, 1, 720)
 DEFAULT_AUTH_TOKEN_MAX_ACTIVE: Final[int] = _env_int("AUTH_TOKEN_MAX_ACTIVE", 2, 1, 20)
-WORKSPACE_PREVIEW_SIGNING_SECRET: Final[str] = str(
-    os.getenv("WORKSPACE_PREVIEW_SIGNING_SECRET") or DATABASE_URL
-).strip()
-WORKSPACE_PREVIEW_TOKEN_TTL_SECONDS: Final[int] = _env_int(
-    "WORKSPACE_PREVIEW_TOKEN_TTL_SECONDS",
-    3600,
-    60,
-    86400,
-)
 DEFAULT_BOT_SYSTEM_TIMEZONE: Final[str] = str(
    os.getenv("DEFAULT_BOT_SYSTEM_TIMEZONE") or os.getenv("TZ") or "Asia/Shanghai"
 ).strip() or "Asia/Shanghai"
--- a/backend/providers/bot_workspace_provider.py
+++ b/backend/providers/bot_workspace_provider.py
@ -57,6 +57,18 @@ def _normalize_extra_config(raw: Any) -> Dict[str, Any]:
    return dict(raw)


+def _channel_delivery_flags(
+    extra: Dict[str, Any],
+    *,
+    default_send_progress: bool = True,
+    default_send_tool_hints: bool = True,
+) -> Dict[str, bool]:
+    return {
+        "sendProgress": bool(extra.get("sendProgress", default_send_progress)),
+        "sendToolHints": bool(extra.get("sendToolHints", default_send_tool_hints)),
+    }
+
+
 def _write_json_atomic(path: str, payload: Dict[str, Any]) -> None:
    os.makedirs(os.path.dirname(path), exist_ok=True)
    tmp_path = f"{path}.tmp"
@ -85,8 +97,8 @@ class BotWorkspaceProvider:
        temperature = float(bot_data.get("temperature"))
        top_p = float(bot_data.get("top_p"))
        max_tokens = int(bot_data.get("max_tokens"))
-        send_progress = bool(bot_data.get("send_progress"))
-        send_tool_hints = bool(bot_data.get("send_tool_hints"))
+        send_progress = bool(bot_data.get("send_progress", True))
+        send_tool_hints = bool(bot_data.get("send_tool_hints", True))

        bot_root = os.path.join(self.host_data_root, bot_id)
        dot_nanobot_dir = os.path.join(bot_root, ".nanobot")
@ -120,13 +132,15 @@ class BotWorkspaceProvider:
                provider_name: provider_cfg,
            },
            "channels": {
-                "sendProgress": send_progress,
-                "sendToolHints": send_tool_hints,
+                "sendProgress": True,
+                "sendToolHints": True,
                "dashboard": {
                    "enabled": True,
                    "host": "0.0.0.0",
                    "port": 9000,
                    "allowFrom": ["*"],
+                    "sendProgress": send_progress,
+                    "sendToolHints": send_tool_hints,
                },
            },
        }
@ -143,6 +157,7 @@ class BotWorkspaceProvider:
            if not channel_type or channel_type == "dashboard":
                continue
            extra = _normalize_extra_config(channel.get("extra_config"))
+            delivery_flags = _channel_delivery_flags(extra)
            enabled = bool(channel.get("is_active"))
            external_app_id = str(channel.get("external_app_id") or "").strip()
            app_secret = str(channel.get("app_secret") or "").strip()
@ -154,6 +169,7 @@ class BotWorkspaceProvider:
                    "proxy": str(extra.get("proxy") or "").strip(),
                    "replyToMessage": bool(extra.get("replyToMessage")),
                    "allowFrom": _normalize_allow_from(extra.get("allowFrom")),
+                    **delivery_flags,
                }
                continue

@ -165,6 +181,7 @@ class BotWorkspaceProvider:
                    "encryptKey": str(extra.get("encryptKey") or "").strip(),
                    "verificationToken": str(extra.get("verificationToken") or "").strip(),
                    "allowFrom": _normalize_allow_from(extra.get("allowFrom")),
+                    **delivery_flags,
                }
                continue

@ -174,6 +191,7 @@ class BotWorkspaceProvider:
                    "clientId": external_app_id,
                    "clientSecret": app_secret,
                    "allowFrom": _normalize_allow_from(extra.get("allowFrom")),
+                    **delivery_flags,
                }
                continue

@ -187,6 +205,7 @@ class BotWorkspaceProvider:
                    "groupPolicy": str(extra.get("groupPolicy") or "mention"),
                    "groupAllowFrom": extra.get("groupAllowFrom") if isinstance(extra.get("groupAllowFrom"), list) else [],
                    "reactEmoji": str(extra.get("reactEmoji") or "eyes"),
+                    **delivery_flags,
                }
                continue

@ -196,6 +215,7 @@ class BotWorkspaceProvider:
                    "appId": external_app_id,
                    "secret": app_secret,
                    "allowFrom": _normalize_allow_from(extra.get("allowFrom")),
+                    **delivery_flags,
                }
                continue

@ -205,6 +225,7 @@ class BotWorkspaceProvider:
                    "botId": external_app_id,
                    "secret": app_secret,
                    "allowFrom": _normalize_allow_from(extra.get("allowFrom")),
+                    **delivery_flags,
                }
                welcome_message = str(extra.get("welcomeMessage") or "").strip()
                if welcome_message:
@ -216,6 +237,7 @@ class BotWorkspaceProvider:
                weixin_cfg: Dict[str, Any] = {
                    "enabled": enabled,
                    "allowFrom": _normalize_allow_from(extra.get("allowFrom")),
+                    **delivery_flags,
                }
                route_tag = str(extra.get("routeTag") or "").strip()
                if route_tag:
@ -258,6 +280,7 @@ class BotWorkspaceProvider:
                    "maxBodyChars": max(1, int(extra.get("maxBodyChars") or 12000)),
                    "subjectPrefix": str(extra.get("subjectPrefix") or "Re: "),
                    "allowFrom": _normalize_allow_from(extra.get("allowFrom")),
+                    **delivery_flags,
                }
                continue

@ -266,6 +289,7 @@ class BotWorkspaceProvider:
                "appId": external_app_id,
                "appSecret": app_secret,
                **extra,
+                **delivery_flags,
            }

        _write_json_atomic(os.path.join(dot_nanobot_dir, "config.json"), config_data)
--- a/backend/services/bot_config_service.py
+++ b/backend/services/bot_config_service.py
@ -18,7 +18,6 @@ from services.bot_service import (
    channel_api_to_config,
    list_bot_channels_from_config,
    normalize_channel_extra,
-    read_global_delivery_flags,
    sync_bot_workspace_channels,
 )
 from services.bot_mcp_service import (
@ -66,6 +65,8 @@ def _read_bot_channels_cfg(bot_id: str) -> tuple[Dict[str, Any], Dict[str, Any]]
    if not isinstance(channels_cfg, dict):
        channels_cfg = {}
        config_data["channels"] = channels_cfg
+    channels_cfg["sendProgress"] = bool(channels_cfg.get("sendProgress", True))
+    channels_cfg["sendToolHints"] = bool(channels_cfg.get("sendToolHints", True))
    return config_data, channels_cfg


@ -311,11 +312,38 @@ def update_bot_channel_config(

    rows = list_bot_channels_from_config(bot)
    row = _find_channel_row(rows, channel_id)
-    if str(row.get("channel_type") or "").strip().lower() == "dashboard" or bool(row.get("locked")):
-        raise HTTPException(status_code=400, detail="dashboard channel is built-in and cannot be modified")

    update_data = payload.model_dump(exclude_unset=True)
    existing_type = str(row.get("channel_type") or "").strip().lower()
+    if existing_type == "dashboard" or bool(row.get("locked")):
+        if "channel_type" in update_data and str(update_data.get("channel_type") or "").strip().lower() != "dashboard":
+            raise HTTPException(status_code=400, detail="dashboard channel type cannot be changed")
+        if "is_active" in update_data and update_data["is_active"] is False:
+            raise HTTPException(status_code=400, detail="dashboard channel must remain enabled")
+        config_data, channels_cfg = _read_bot_channels_cfg(bot_id)
+        extra = normalize_channel_extra(update_data.get("extra_config", row.get("extra_config")))
+        dashboard_cfg = channels_cfg.get("dashboard")
+        if not isinstance(dashboard_cfg, dict):
+            dashboard_cfg = {}
+        dashboard_cfg.update(
+            {
+                "enabled": True,
+                "host": str(dashboard_cfg.get("host") or "0.0.0.0"),
+                "port": max(1, min(int(dashboard_cfg.get("port") or 9000), 65535)),
+                "allowFrom": dashboard_cfg.get("allowFrom") if isinstance(dashboard_cfg.get("allowFrom"), list) else ["*"],
+                "sendProgress": bool(extra.get("sendProgress", dashboard_cfg.get("sendProgress", channels_cfg.get("sendProgress", True)))),
+                "sendToolHints": bool(extra.get("sendToolHints", dashboard_cfg.get("sendToolHints", channels_cfg.get("sendToolHints", True)))),
+            }
+        )
+        channels_cfg["dashboard"] = dashboard_cfg
+        row["is_active"] = True
+        row["extra_config"] = {
+            "sendProgress": bool(dashboard_cfg.get("sendProgress")),
+            "sendToolHints": bool(dashboard_cfg.get("sendToolHints")),
+        }
+        _write_bot_config_state(session, bot_id=bot_id, config_data=config_data, sync_workspace=True)
+        return row
+
    new_type = existing_type
    if "channel_type" in update_data and update_data["channel_type"] is not None:
        new_type = str(update_data["channel_type"]).strip().lower()
@ -344,15 +372,6 @@ def update_bot_channel_config(
    row["locked"] = new_type == "dashboard"

    config_data, channels_cfg = _read_bot_channels_cfg(bot_id)
-    current_send_progress, current_send_tool_hints = read_global_delivery_flags(channels_cfg)
-    if new_type == "dashboard":
-        extra = normalize_channel_extra(row.get("extra_config"))
-        channels_cfg["sendProgress"] = bool(extra.get("sendProgress", current_send_progress))
-        channels_cfg["sendToolHints"] = bool(extra.get("sendToolHints", current_send_tool_hints))
-    else:
-        channels_cfg["sendProgress"] = current_send_progress
-        channels_cfg["sendToolHints"] = current_send_tool_hints
-    channels_cfg.pop("dashboard", None)
    if existing_type != "dashboard" and existing_type in channels_cfg and existing_type != new_type:
        channels_cfg.pop(existing_type, None)
    if new_type != "dashboard":
--- a/backend/services/bot_management_service.py
+++ b/backend/services/bot_management_service.py
@ -135,8 +135,8 @@ def create_bot_record(session: Session, *, payload: BotCreateRequest) -> Dict[st
            normalized_bot_id,
            channels_override=normalize_initial_bot_channels(normalized_bot_id, payload.channels),
            global_delivery_override={
-                "sendProgress": bool(payload.send_progress) if payload.send_progress is not None else False,
-                "sendToolHints": bool(payload.send_tool_hints) if payload.send_tool_hints is not None else False,
+                "sendProgress": bool(payload.send_progress) if payload.send_progress is not None else True,
+                "sendToolHints": bool(payload.send_tool_hints) if payload.send_tool_hints is not None else True,
            },
            runtime_overrides={
                "llm_provider": llm_provider,
@ -154,8 +154,8 @@ def create_bot_record(session: Session, *, payload: BotCreateRequest) -> Dict[st
                "user_md": payload.user_md,
                "tools_md": payload.tools_md,
                "identity_md": payload.identity_md,
-                "send_progress": bool(payload.send_progress) if payload.send_progress is not None else False,
-                "send_tool_hints": bool(payload.send_tool_hints) if payload.send_tool_hints is not None else False,
+                "send_progress": bool(payload.send_progress) if payload.send_progress is not None else True,
+                "send_tool_hints": bool(payload.send_tool_hints) if payload.send_tool_hints is not None else True,
            },
        )
        record_activity_event(
--- a/backend/services/bot_service.py
+++ b/backend/services/bot_service.py
@ -62,8 +62,16 @@ def _normalize_allow_from(raw: Any) -> List[str]:

 def read_global_delivery_flags(channels_cfg: Any) -> tuple[bool, bool]:
    if not isinstance(channels_cfg, dict):
-        return False, False
-    return bool(channels_cfg.get("sendProgress")), bool(channels_cfg.get("sendToolHints"))
+        return True, True
+    return bool(channels_cfg.get("sendProgress", True)), bool(channels_cfg.get("sendToolHints", True))
+
+
+def _delivery_extra(channels_cfg: Any, cfg: Dict[str, Any]) -> Dict[str, bool]:
+    default_send_progress, default_send_tool_hints = read_global_delivery_flags(channels_cfg)
+    return {
+        "sendProgress": bool(cfg.get("sendProgress", default_send_progress)),
+        "sendToolHints": bool(cfg.get("sendToolHints", default_send_tool_hints)),
+    }


 def channel_config_to_api(bot_id: str, channel_type: str, cfg: Dict[str, Any]) -> Dict[str, Any]:
@ -81,17 +89,19 @@ def channel_config_to_api(bot_id: str, channel_type: str, cfg: Dict[str, Any]) -
            "encryptKey": cfg.get("encryptKey", ""),
            "verificationToken": cfg.get("verificationToken", ""),
            "allowFrom": _normalize_allow_from(cfg.get("allowFrom", [])),
+            **_delivery_extra({"sendProgress": True, "sendToolHints": True}, cfg),
        }
    elif ctype == "dingtalk":
        external_app_id = str(cfg.get("clientId") or "")
        app_secret = str(cfg.get("clientSecret") or "")
-        extra = {"allowFrom": _normalize_allow_from(cfg.get("allowFrom", []))}
+        extra = {"allowFrom": _normalize_allow_from(cfg.get("allowFrom", [])), **_delivery_extra({"sendProgress": True, "sendToolHints": True}, cfg)}
    elif ctype == "telegram":
        app_secret = str(cfg.get("token") or "")
        extra = {
            "proxy": cfg.get("proxy", ""),
            "replyToMessage": bool(cfg.get("replyToMessage", False)),
            "allowFrom": _normalize_allow_from(cfg.get("allowFrom", [])),
+            **_delivery_extra({"sendProgress": True, "sendToolHints": True}, cfg),
        }
    elif ctype == "slack":
        external_app_id = str(cfg.get("botToken") or "")
@ -102,22 +112,25 @@ def channel_config_to_api(bot_id: str, channel_type: str, cfg: Dict[str, Any]) -
            "groupPolicy": cfg.get("groupPolicy", "mention"),
            "groupAllowFrom": cfg.get("groupAllowFrom", []),
            "reactEmoji": cfg.get("reactEmoji", "eyes"),
+            **_delivery_extra({"sendProgress": True, "sendToolHints": True}, cfg),
        }
    elif ctype == "qq":
        external_app_id = str(cfg.get("appId") or "")
        app_secret = str(cfg.get("secret") or "")
-        extra = {"allowFrom": _normalize_allow_from(cfg.get("allowFrom", []))}
+        extra = {"allowFrom": _normalize_allow_from(cfg.get("allowFrom", [])), **_delivery_extra({"sendProgress": True, "sendToolHints": True}, cfg)}
    elif ctype == "wecom":
        external_app_id = str(cfg.get("botId") or "")
        app_secret = str(cfg.get("secret") or "")
        extra = {
            "allowFrom": _normalize_allow_from(cfg.get("allowFrom", [])),
            "welcomeMessage": str(cfg.get("welcomeMessage") or ""),
+            **_delivery_extra({"sendProgress": True, "sendToolHints": True}, cfg),
        }
    elif ctype == "weixin":
        app_secret = ""
        extra = {
            "hasSavedState": (Path(BOTS_WORKSPACE_ROOT) / bot_id / ".nanobot" / "weixin" / "account.json").is_file(),
+            **_delivery_extra({"sendProgress": True, "sendToolHints": True}, cfg),
        }
    elif ctype == "email":
        extra = {
@ -141,6 +154,7 @@ def channel_config_to_api(bot_id: str, channel_type: str, cfg: Dict[str, Any]) -
            "maxBodyChars": int(cfg.get("maxBodyChars") or 12000),
            "subjectPrefix": str(cfg.get("subjectPrefix") or "Re: "),
            "allowFrom": _normalize_allow_from(cfg.get("allowFrom", [])),
+            **_delivery_extra({"sendProgress": True, "sendToolHints": True}, cfg),
        }
    else:
        external_app_id = str(
@ -170,8 +184,11 @@ def channel_config_to_api(bot_id: str, channel_type: str, cfg: Dict[str, Any]) -
                "secret",
                "token",
                "appToken",
+                "sendProgress",
+                "sendToolHints",
            }
        }
+        extra.update(_delivery_extra({"sendProgress": True, "sendToolHints": True}, cfg))

    return {
        "id": ctype,
@ -202,6 +219,8 @@ def channel_api_to_config(row: Dict[str, Any]) -> Dict[str, Any]:
            "encryptKey": extra.get("encryptKey", ""),
            "verificationToken": extra.get("verificationToken", ""),
            "allowFrom": _normalize_allow_from(extra.get("allowFrom", [])),
+            "sendProgress": bool(extra.get("sendProgress", True)),
+            "sendToolHints": bool(extra.get("sendToolHints", True)),
        }
    if ctype == "dingtalk":
        return {
@ -209,6 +228,8 @@ def channel_api_to_config(row: Dict[str, Any]) -> Dict[str, Any]:
            "clientId": external_app_id,
            "clientSecret": app_secret,
            "allowFrom": _normalize_allow_from(extra.get("allowFrom", [])),
+            "sendProgress": bool(extra.get("sendProgress", True)),
+            "sendToolHints": bool(extra.get("sendToolHints", True)),
        }
    if ctype == "telegram":
        return {
@ -217,6 +238,8 @@ def channel_api_to_config(row: Dict[str, Any]) -> Dict[str, Any]:
            "proxy": extra.get("proxy", ""),
            "replyToMessage": bool(extra.get("replyToMessage", False)),
            "allowFrom": _normalize_allow_from(extra.get("allowFrom", [])),
+            "sendProgress": bool(extra.get("sendProgress", True)),
+            "sendToolHints": bool(extra.get("sendToolHints", True)),
        }
    if ctype == "slack":
        return {
@ -228,6 +251,8 @@ def channel_api_to_config(row: Dict[str, Any]) -> Dict[str, Any]:
            "groupPolicy": extra.get("groupPolicy", "mention"),
            "groupAllowFrom": extra.get("groupAllowFrom", []),
            "reactEmoji": extra.get("reactEmoji", "eyes"),
+            "sendProgress": bool(extra.get("sendProgress", True)),
+            "sendToolHints": bool(extra.get("sendToolHints", True)),
        }
    if ctype == "qq":
        return {
@ -235,6 +260,8 @@ def channel_api_to_config(row: Dict[str, Any]) -> Dict[str, Any]:
            "appId": external_app_id,
            "secret": app_secret,
            "allowFrom": _normalize_allow_from(extra.get("allowFrom", [])),
+            "sendProgress": bool(extra.get("sendProgress", True)),
+            "sendToolHints": bool(extra.get("sendToolHints", True)),
        }
    if ctype == "wecom":
        return {
@ -243,11 +270,15 @@ def channel_api_to_config(row: Dict[str, Any]) -> Dict[str, Any]:
            "secret": app_secret,
            "allowFrom": _normalize_allow_from(extra.get("allowFrom", [])),
            "welcomeMessage": str(extra.get("welcomeMessage") or ""),
+            "sendProgress": bool(extra.get("sendProgress", True)),
+            "sendToolHints": bool(extra.get("sendToolHints", True)),
        }
    if ctype == "weixin":
        return {
            "enabled": enabled,
            "token": app_secret,
+            "sendProgress": bool(extra.get("sendProgress", True)),
+            "sendToolHints": bool(extra.get("sendToolHints", True)),
        }
    if ctype == "email":
        return {
@ -272,6 +303,8 @@ def channel_api_to_config(row: Dict[str, Any]) -> Dict[str, Any]:
            "maxBodyChars": max(1, int(extra.get("maxBodyChars") or 12000)),
            "subjectPrefix": str(extra.get("subjectPrefix") or "Re: "),
            "allowFrom": _normalize_allow_from(extra.get("allowFrom", [])),
+            "sendProgress": bool(extra.get("sendProgress", True)),
+            "sendToolHints": bool(extra.get("sendToolHints", True)),
        }
    merged = dict(extra)
    merged.update(
@ -290,7 +323,8 @@ def list_bot_channels_from_config(bot: BotInstance) -> List[Dict[str, Any]]:
    channels_cfg = config_data.get("channels")
    if not isinstance(channels_cfg, dict):
        channels_cfg = {}
-    send_progress, send_tool_hints = read_global_delivery_flags(channels_cfg)
+    dashboard_cfg = channels_cfg.get("dashboard")
+    dashboard_extra = _delivery_extra(channels_cfg, dashboard_cfg if isinstance(dashboard_cfg, dict) else {})
    rows: List[Dict[str, Any]] = [
        {
            "id": "dashboard",
@ -300,17 +334,19 @@ def list_bot_channels_from_config(bot: BotInstance) -> List[Dict[str, Any]]:
            "app_secret": "",
            "internal_port": 9000,
            "is_active": True,
-            "extra_config": {
-                "sendProgress": send_progress,
-                "sendToolHints": send_tool_hints,
-            },
+            "extra_config": dashboard_extra,
            "locked": True,
        }
    ]
    for ctype, cfg in channels_cfg.items():
        if ctype in {"sendProgress", "sendToolHints", "dashboard"} or not isinstance(cfg, dict):
            continue
-        rows.append(channel_config_to_api(bot.id, ctype, cfg))
+        row = channel_config_to_api(bot.id, ctype, cfg)
+        row["extra_config"] = {
+            **row.get("extra_config", {}),
+            **_delivery_extra(channels_cfg, cfg),
+        }
+        rows.append(row)
    return rows


@ -513,8 +549,8 @@ def sync_bot_workspace_channels(
        bot_data.get("storage_gb"),
    )
    bot_data.update(resources)
-    send_progress = bool(bot_data.get("send_progress", False))
-    send_tool_hints = bool(bot_data.get("send_tool_hints", False))
+    send_progress = bool(bot_data.get("send_progress", True))
+    send_tool_hints = bool(bot_data.get("send_tool_hints", True))
    if isinstance(global_delivery_override, dict):
        if "sendProgress" in global_delivery_override:
            send_progress = bool(global_delivery_override.get("sendProgress"))
--- a/backend/services/platform_settings_core.py
+++ b/backend/services/platform_settings_core.py
@ -19,7 +19,9 @@ from schemas.platform import SystemSettingItem

 DEFAULT_ALLOWED_ATTACHMENT_EXTENSIONS: tuple[str, ...] = ()
 DEFAULT_ACTIVITY_EVENT_RETENTION_DAYS = 7
+DEFAULT_WORKSPACE_PREVIEW_TOKEN_TTL_SECONDS = 3600
 ACTIVITY_EVENT_RETENTION_SETTING_KEY = "activity_event_retention_days"
+WORKSPACE_PREVIEW_TOKEN_TTL_SETTING_KEY = "workspace_preview_token_ttl_seconds"
 SETTING_KEYS = (
    "page_size",
    "chat_pull_page_size",
@ -30,7 +32,7 @@ SETTING_KEYS = (
    "workspace_download_extensions",
    "speech_enabled",
 )
-PROTECTED_SETTING_KEYS = set(SETTING_KEYS) | {ACTIVITY_EVENT_RETENTION_SETTING_KEY}
+PROTECTED_SETTING_KEYS = set(SETTING_KEYS) | {ACTIVITY_EVENT_RETENTION_SETTING_KEY, WORKSPACE_PREVIEW_TOKEN_TTL_SETTING_KEY}
 SYSTEM_SETTING_DEFINITIONS: Dict[str, Dict[str, Any]] = {
    "page_size": {
        "name": "分页大小",
@ -95,6 +97,15 @@ SYSTEM_SETTING_DEFINITIONS: Dict[str, Dict[str, Any]] = {
        "is_public": False,
        "sort_order": 30,
    },
+    WORKSPACE_PREVIEW_TOKEN_TTL_SETTING_KEY: {
+        "name": "工作区预览 Token 过期秒数",
+        "category": "workspace",
+        "description": "HTML 预览地址中临时访问 Token 的默认有效时长，单位秒。",
+        "value_type": "integer",
+        "value": DEFAULT_WORKSPACE_PREVIEW_TOKEN_TTL_SECONDS,
+        "is_public": False,
+        "sort_order": 31,
+    },
    "speech_enabled": {
        "name": "语音识别开关",
        "category": "speech",
--- a/backend/services/platform_system_settings_service.py
+++ b/backend/services/platform_system_settings_service.py
@ -8,6 +8,7 @@ from services.platform_settings_core import (
    ACTIVITY_EVENT_RETENTION_SETTING_KEY,
    PROTECTED_SETTING_KEYS,
    SYSTEM_SETTING_DEFINITIONS,
+    WORKSPACE_PREVIEW_TOKEN_TTL_SETTING_KEY,
    _normalize_setting_key,
    _read_setting_value,
    _setting_item_from_row,
@ -30,15 +31,19 @@ def _prune_deprecated_system_settings(session: Session) -> None:
        session.commit()


-def validate_required_system_settings(session: Session) -> None:
-    _prune_deprecated_system_settings(session)
+def _missing_required_system_settings(session: Session) -> List[str]:
    stmt = select(PlatformSetting.key).where(PlatformSetting.key.in_(REQUIRED_SYSTEM_SETTING_KEYS))
    present = {
        str(key or "").strip()
        for key in session.exec(stmt).all()
        if str(key or "").strip()
    }
-    missing = [key for key in REQUIRED_SYSTEM_SETTING_KEYS if key not in present]
+    return [key for key in REQUIRED_SYSTEM_SETTING_KEYS if key not in present]
+
+
+def validate_required_system_settings(session: Session) -> None:
+    _prune_deprecated_system_settings(session)
+    missing = _missing_required_system_settings(session)
    if missing:
        raise RuntimeError(
            "Database seed data is not initialized. "
@ -118,3 +123,22 @@ def get_activity_event_retention_days(session: Session) -> int:
            "Fix the row manually or reapply scripts/sql/init-data.sql."
        ) from exc
    return max(1, min(3650, value))
+
+
+def get_workspace_preview_token_ttl_seconds(session: Session) -> int:
+    validate_required_system_settings(session)
+    row = session.get(PlatformSetting, WORKSPACE_PREVIEW_TOKEN_TTL_SETTING_KEY)
+    if row is None:
+        raise RuntimeError(
+            "Database seed data is not initialized. "
+            f"Missing sys_setting key: {WORKSPACE_PREVIEW_TOKEN_TTL_SETTING_KEY}. "
+            "Run scripts/init-full-db.sh or apply scripts/sql/init-data.sql before starting the backend."
+        )
+    try:
+        value = int(_read_setting_value(row))
+    except Exception as exc:
+        raise RuntimeError(
+            f"sys_setting value is invalid for key: {WORKSPACE_PREVIEW_TOKEN_TTL_SETTING_KEY}. "
+            "Fix the row manually or reapply scripts/sql/init-data.sql."
+        ) from exc
+    return max(60, value)
--- a/backend/services/workspace_preview_token_service.py
+++ b/backend/services/workspace_preview_token_service.py
@ -5,9 +5,11 @@ import json
 import time
 from typing import Any, Dict, Optional

-from core.settings import WORKSPACE_PREVIEW_SIGNING_SECRET, WORKSPACE_PREVIEW_TOKEN_TTL_SECONDS
+from core.settings import DATABASE_URL

 HTML_PREVIEW_EXTENSIONS = {".html", ".htm"}
+DEFAULT_WORKSPACE_PREVIEW_TOKEN_TTL_SECONDS = 3600
+_WORKSPACE_PREVIEW_SIGNING_KEY = DATABASE_URL


 def _b64url_encode(raw: bytes) -> str:
@ -31,7 +33,7 @@ def is_html_preview_path(path: str) -> bool:
 def create_workspace_preview_token(bot_id: str, path: str, ttl_seconds: Optional[int] = None) -> Dict[str, Any]:
    normalized_bot_id = str(bot_id or "").strip()
    normalized_path = normalize_workspace_preview_path(path)
-    ttl = max(60, min(int(ttl_seconds or WORKSPACE_PREVIEW_TOKEN_TTL_SECONDS), 86400))
+    ttl = max(60, int(ttl_seconds or DEFAULT_WORKSPACE_PREVIEW_TOKEN_TTL_SECONDS))
    expires_at = int(time.time()) + ttl
    payload = {
        "bot_id": normalized_bot_id,
@ -42,7 +44,7 @@ def create_workspace_preview_token(bot_id: str, path: str, ttl_seconds: Optional
    payload_json = json.dumps(payload, ensure_ascii=False, separators=(",", ":"), sort_keys=True).encode("utf-8")
    body = _b64url_encode(payload_json)
    signature = hmac.new(
-        WORKSPACE_PREVIEW_SIGNING_SECRET.encode("utf-8"),
+        _WORKSPACE_PREVIEW_SIGNING_KEY.encode("utf-8"),
        body.encode("ascii"),
        hashlib.sha256,
    ).digest()
@ -59,7 +61,7 @@ def resolve_workspace_preview_token(token: str) -> Optional[Dict[str, Any]]:
        return None
    body, signature_raw = raw_token.split(".", 1)
    expected_signature = hmac.new(
-        WORKSPACE_PREVIEW_SIGNING_SECRET.encode("utf-8"),
+        _WORKSPACE_PREVIEW_SIGNING_KEY.encode("utf-8"),
        body.encode("ascii"),
        hashlib.sha256,
    ).digest()
--- a/bot-images/Dashboard.Dockerfile
+++ b/bot-images/Dashboard.Dockerfile
@ -17,7 +17,7 @@ RUN apt-get update && apt-get install -y --no-install-recommends \
 RUN python -m venv /opt/venv

 WORKDIR /app
-COPY pyproject.toml README.md LICENSE THIRD_PARTY_NOTICES.md ./
+COPY pyproject.toml hatch_build.py README.md LICENSE THIRD_PARTY_NOTICES.md ./

 # 3. 先安装第三方依赖。该层只依赖 pyproject.toml，源码改动不会触发整套依赖重装。
 RUN --mount=type=cache,target=/root/.cache/pip \
--- a/bot-images/README.md
+++ b/bot-images/README.md
@ -1,62 +0,0 @@
-# Bot Images 使用说明
-
-这个目录用于构建 `nanobot-base` 相关镜像。
-
-## 1. 直接构建镜像
-
-```bash
-./bot-images/build.sh
-```
-
-执行后脚本会提示你选择：
-
- `1` 从远程拉取最新版本再构建
- `2` 从本地已有 `nanobot-base-*` 目录中选择一个构建
-
-默认行为只构建 Docker 镜像，不导出压缩产物。
-
-## 2. 构建后同时导出镜像产物
-
-如果需要把构建好的镜像发给没有源码的客户，可以加：
-
-```bash
-./bot-images/build.sh --save-artifact
-```
-
-执行完成后，会在你运行命令时的当前目录生成一个压缩包，例如：
-
-```text
-nanobot-base-v0.1.5.tar.gz
-```
-
-这个压缩包本质上是 `docker save | gzip` 的产物，可以直接拿到客户机器上导入。
-
-## 3. 指定导出目录
-
-如果不想导出到当前目录，可以指定目录：
-
-```bash
-./bot-images/build.sh --artifact-dir /path/to/output
-```
-
-执行完成后，镜像压缩包会输出到指定目录。
-
-## 4. 客户侧如何导入
-
-客户机器上拿到压缩包后可执行：
-
-```bash
-gunzip -c nanobot-base-v0.1.5.tar.gz | docker load
-```
-
-导入完成后，可用下面命令确认：
-
-```bash
-docker images | grep nanobot-base
-```
-
-## 5. 说明
-
- `--artifact-dir` 会自动包含 `--save-artifact` 的效果。
- 如果只是本机构建测试，不需要加导出参数。
- 如果后续要给多个客户复用，推荐保留导出的 `.tar.gz`，这样不需要客户再拿源码构建。
--- a/bot-images/build.sh
+++ b/bot-images/build.sh
@ -2,71 +2,12 @@
 set -e

 BASE_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-CALLER_DIR="$(pwd)"
-SAVE_ARTIFACT=false
-ARTIFACT_DIR=""
-
-usage() {
-    cat <<EOF
-Usage: $(basename "$0") [--save-artifact] [--artifact-dir PATH]
-
-Options:
-  --save-artifact    Build image and export a compressed docker image archive.
-                     Default export location is the current shell directory.
-  --artifact-dir     Custom directory for exported archive. Implies --save-artifact.
-  -h, --help         Show this help message.
-EOF
-}
-
-parse_args() {
-    while [ $# -gt 0 ]; do
-        case "$1" in
-            --save-artifact)
-                SAVE_ARTIFACT=true
-                ;;
-            --artifact-dir)
-                if [ $# -lt 2 ]; then
-                    echo "缺少 --artifact-dir 的路径参数。"
-                    exit 1
-                fi
-                SAVE_ARTIFACT=true
-                ARTIFACT_DIR="$2"
-                shift
-                ;;
-            -h|--help)
-                usage
-                exit 0
-                ;;
-            *)
-                echo "未知参数: $1"
-                usage
-                exit 1
-                ;;
-        esac
-        shift
-    done
-}
-
-export_image_artifact() {
-    local image_name=$1
-    local version=$2
-    local output_dir="${ARTIFACT_DIR:-$CALLER_DIR}"
-    local archive_name="nanobot-base-${version}.tar.gz"
-    local archive_path="${output_dir}/${archive_name}"
-
-    mkdir -p "${output_dir}"
-
-    echo ">> [额外步骤] 导出镜像产物到: ${archive_path}"
-    docker save "${image_name}" | gzip > "${archive_path}"
-    echo "✅ 已导出镜像产物: ${archive_path}"
-}

 # 执行拷贝和打包的核心函数
 build_image() {
    local dir_name=$1
    local version=$2
    local image_name="nanobot-base:${version}"
-    local previous_dir="${PWD}"

    echo "=================================================="
    echo "准备构建镜像: ${image_name}"
@ -98,16 +39,8 @@ build_image() {
    echo "=================================================="
    echo "✅ 构建完成: ${image_name}"
    echo "=================================================="
-
-    cd "${previous_dir}"
-
-    if [ "${SAVE_ARTIFACT}" = "true" ]; then
-        export_image_artifact "${image_name}" "${version}"
-    fi
 }

-parse_args "$@"
-
 echo "请选择操作模式:"
 echo "1) 从 Git 拉取最新代码并打包 (会覆盖已有同名目录)"
 echo "2) 扫描本地已有的目录并打包"
--- a/docker-compose.full.yml
+++ b/docker-compose.full.yml
@ -1,163 +1,153 @@
-# Dashboard Nanobot Docker 编排文件（Full 模式）
-# 说明：
-# 1. 当前文件用于“前端 + 后端 + PostgreSQL + Redis”整套部署。
-# 2. 数据库和 Redis 都在本 compose 中启动，适合客户没有外部中间件时使用。
-# 3. 客户通常需要重点修改 `.env` 里的端口、数据库密码、工作目录路径。
-# 4. 如果需要调整宿主机挂载路径，可以直接修改下方 `volumes`。
+services:
+  postgres:
+    image: ${POSTGRES_IMAGE:-postgres:16-alpine}
+    container_name: dashboard-nanobot-postgres
+    restart: unless-stopped
+    environment:
+      TZ: ${TZ:-Asia/Shanghai}
+      POSTGRES_USER: ${POSTGRES_SUPERUSER:-postgres}
+      POSTGRES_PASSWORD: ${POSTGRES_SUPERPASSWORD:?POSTGRES_SUPERPASSWORD is required}
+      POSTGRES_DB: ${POSTGRES_BOOTSTRAP_DB:-postgres}
+    volumes:
+      - ./data/postgres:/var/lib/postgresql/data
+    expose:
+      - "5432"
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U \"$${POSTGRES_USER}\" -d \"$${POSTGRES_DB}\""]
+      interval: 10s
+      timeout: 5s
+      retries: 10
+      start_period: 20s
+    logging:
+      driver: json-file
+      options:
+        max-size: "20m"
+        max-file: "3"

-services: # 定义当前 compose 里需要启动的服务
-  postgres: # PostgreSQL 数据库服务
-    image: ${POSTGRES_IMAGE:-postgres:16-alpine} # PostgreSQL 镜像名
-    container_name: dashboard-nanobot-postgres # PostgreSQL 容器固定名称
-    restart: unless-stopped # 异常退出后自动拉起
-    environment: # PostgreSQL 启动参数
-      TZ: ${TZ:-Asia/Shanghai} # 容器时区
-      POSTGRES_USER: ${POSTGRES_SUPERUSER:-postgres} # PostgreSQL 超级用户
-      POSTGRES_PASSWORD: ${POSTGRES_SUPERPASSWORD:?POSTGRES_SUPERPASSWORD is required} # PostgreSQL 超级用户密码
-      POSTGRES_DB: ${POSTGRES_BOOTSTRAP_DB:-postgres} # 启动时默认数据库
-    volumes: # 数据库存储挂载
-      - ./data/postgres:/var/lib/postgresql/data # 宿主机数据库目录映射到容器数据目录
-    expose: # 仅对内部网络开放
-      - "5432" # PostgreSQL 默认端口
-    healthcheck: # PostgreSQL 健康检查
-      test: ["CMD-SHELL", "pg_isready -U \"$${POSTGRES_USER}\" -d \"$${POSTGRES_DB}\""] # 检测数据库是否就绪
-      interval: 10s # 每 10 秒检查一次
-      timeout: 5s # 单次检查超时 5 秒
-      retries: 10 # 连续失败 10 次判定不健康
-      start_period: 20s # 启动后预留 20 秒缓冲时间
-    logging: # 容器日志策略
-      driver: json-file # 使用 Docker 默认 json-file 日志驱动
-      options: # 日志滚动配置
-        max-size: "20m" # 单个日志文件最大 20MB
-        max-file: "3" # 最多保留 3 个日志文件
+  redis:
+    image: ${REDIS_IMAGE:-redis:7-alpine}
+    container_name: dashboard-nanobot-redis
+    restart: unless-stopped
+    environment:
+      TZ: ${TZ:-Asia/Shanghai}
+    command: ["redis-server", "--appendonly", "yes", "--save", "60", "1000"]
+    volumes:
+      - ./data/redis:/data
+    expose:
+      - "6379"
+    healthcheck:
+      test: ["CMD", "redis-cli", "ping"]
+      interval: 10s
+      timeout: 5s
+      retries: 10
+      start_period: 10s
+    logging:
+      driver: json-file
+      options:
+        max-size: "20m"
+        max-file: "3"

-  redis: # Redis 缓存服务
-    image: ${REDIS_IMAGE:-redis:7-alpine} # Redis 镜像名
-    container_name: dashboard-nanobot-redis # Redis 容器固定名称
-    restart: unless-stopped # 异常退出后自动拉起
-    environment: # Redis 运行环境变量
-      TZ: ${TZ:-Asia/Shanghai} # 容器时区
-    command: ["redis-server", "--appendonly", "yes", "--save", "60", "1000"] # 开启 AOF 持久化并保留快照策略
-    volumes: # Redis 数据挂载
-      - ./data/redis:/data # 宿主机 Redis 数据目录映射到容器
-    expose: # 仅对内部网络开放
-      - "6379" # Redis 默认端口
-    healthcheck: # Redis 健康检查
-      test: ["CMD", "redis-cli", "ping"] # 检测 Redis 是否响应
-      interval: 10s # 每 10 秒检查一次
-      timeout: 5s # 单次检查超时 5 秒
-      retries: 10 # 连续失败 10 次判定不健康
-      start_period: 10s # 启动后预留 10 秒缓冲时间
-    logging: # 容器日志策略
-      driver: json-file # 使用 Docker 默认 json-file 日志驱动
-      options: # 日志滚动配置
-        max-size: "20m" # 单个日志文件最大 20MB
-        max-file: "3" # 最多保留 3 个日志文件
+  backend:
+    build:
+      context: .
+      dockerfile: backend/Dockerfile
+      args:
+        PYTHON_BASE_IMAGE: ${PYTHON_BASE_IMAGE:-python:3.12-slim}
+        PIP_INDEX_URL: ${PIP_INDEX_URL:-https://pypi.org/simple}
+        PIP_TRUSTED_HOST: ${PIP_TRUSTED_HOST:-}
+    image: dashboard-nanobot/backend:${BACKEND_IMAGE_TAG:-latest}
+    container_name: dashboard-nanobot-backend
+    restart: unless-stopped
+    depends_on:
+      postgres:
+        condition: service_healthy
+      redis:
+        condition: service_healthy
+    environment:
+      TZ: ${TZ:-Asia/Shanghai}
+      APP_HOST: 0.0.0.0
+      APP_PORT: 8002
+      APP_RELOAD: "false"
+      DATABASE_ECHO: "false"
+      DATABASE_POOL_SIZE: ${DATABASE_POOL_SIZE:-20}
+      DATABASE_MAX_OVERFLOW: ${DATABASE_MAX_OVERFLOW:-40}
+      DATABASE_POOL_TIMEOUT: ${DATABASE_POOL_TIMEOUT:-30}
+      DATABASE_POOL_RECYCLE: ${DATABASE_POOL_RECYCLE:-1800}
+      DATA_ROOT: /app/data
+      BOTS_WORKSPACE_ROOT: ${HOST_BOTS_WORKSPACE_ROOT}
+      DOCKER_NETWORK_NAME: ${DOCKER_NETWORK_NAME:-dashboard-nanobot-network}
+      DATABASE_URL: postgresql+psycopg://${POSTGRES_APP_USER}:${POSTGRES_APP_PASSWORD}@postgres:5432/${POSTGRES_APP_DB}
+      REDIS_ENABLED: ${REDIS_ENABLED:-true}
+      REDIS_URL: redis://redis:6379/${REDIS_DB:-8}
+      REDIS_PREFIX: ${REDIS_PREFIX:-dashboard_nanobot}
+      REDIS_DEFAULT_TTL: ${REDIS_DEFAULT_TTL:-60}
+      DEFAULT_BOT_SYSTEM_TIMEZONE: ${DEFAULT_BOT_SYSTEM_TIMEZONE:-Asia/Shanghai}
+      PANEL_ACCESS_PASSWORD: ${PANEL_ACCESS_PASSWORD:-}
+      WORKSPACE_PREVIEW_SIGNING_SECRET: ${WORKSPACE_PREVIEW_SIGNING_SECRET:-}
+      WORKSPACE_PREVIEW_TOKEN_TTL_SECONDS: ${WORKSPACE_PREVIEW_TOKEN_TTL_SECONDS:-3600}
+      CORS_ALLOWED_ORIGINS: ${CORS_ALLOWED_ORIGINS:-}
+      STT_ENABLED: ${STT_ENABLED:-true}
+      STT_MODEL: ${STT_MODEL:-ggml-small-q8_0.bin}
+      STT_MODEL_DIR: ${STT_MODEL_DIR:-/app/data/model}
+      STT_DEVICE: ${STT_DEVICE:-cpu}
+      STT_MAX_AUDIO_SECONDS: ${STT_MAX_AUDIO_SECONDS:-20}
+      STT_DEFAULT_LANGUAGE: ${STT_DEFAULT_LANGUAGE:-zh}
+      STT_FORCE_SIMPLIFIED: ${STT_FORCE_SIMPLIFIED:-true}
+      STT_AUDIO_PREPROCESS: ${STT_AUDIO_PREPROCESS:-true}
+      STT_AUDIO_FILTER: ${STT_AUDIO_FILTER:-highpass=f=120,lowpass=f=7600,afftdn=nf=-20}
+      STT_INITIAL_PROMPT: ${STT_INITIAL_PROMPT:-以下内容可能包含简体中文和英文术语。请优先输出简体中文，英文单词、缩写、品牌名和数字保持原文，不要翻译。}
+    volumes:
+      - /var/run/docker.sock:/var/run/docker.sock
+      - ./data:/app/data
+      - ${HOST_BOTS_WORKSPACE_ROOT}:${HOST_BOTS_WORKSPACE_ROOT}
+    expose:
+      - "8002"
+    healthcheck:
+      test: ["CMD", "python", "-c", "import urllib.request; urllib.request.urlopen('http://127.0.0.1:8002/api/health', timeout=3).read()"]
+      interval: 15s
+      timeout: 5s
+      retries: 5
+      start_period: 20s
+    logging:
+      driver: json-file
+      options:
+        max-size: "20m"
+        max-file: "3"

-  backend: # 后端 API 服务
-    build: # 保留构建信息，便于有源码时重新 build；离线部署通常直接用 image
-      context: . # 构建上下文为项目根目录
-      dockerfile: backend/Dockerfile # 后端 Dockerfile 路径
-      args: # 构建参数
-        PYTHON_BASE_IMAGE: ${PYTHON_BASE_IMAGE:-python:3.12-slim} # Python 基础镜像
-        PIP_INDEX_URL: ${PIP_INDEX_URL:-https://pypi.org/simple} # pip 源地址
-        PIP_TRUSTED_HOST: ${PIP_TRUSTED_HOST:-} # pip 信任主机
-    image: dashboard-nanobot/backend:${BACKEND_IMAGE_TAG:-latest} # 后端运行镜像名
-    container_name: dashboard-nanobot-backend # 后端容器固定名称
-    restart: unless-stopped # 异常退出后自动拉起
-    depends_on: # 依赖中间件健康后再启动
-      postgres: # 依赖 PostgreSQL
-        condition: service_healthy # 要求 PostgreSQL 健康
-      redis: # 依赖 Redis
-        condition: service_healthy # 要求 Redis 健康
-    environment: # 后端环境变量
-      TZ: ${TZ:-Asia/Shanghai} # 容器时区
-      APP_HOST: 0.0.0.0 # 服务监听地址，容器内通常保持 0.0.0.0
-      APP_PORT: 8000 # 服务监听端口，需与 expose 和健康检查保持一致
-      APP_RELOAD: "false" # 生产环境关闭热重载
-      DATABASE_ECHO: "false" # 生产环境关闭 SQL 日志回显
-      DATABASE_POOL_SIZE: ${DATABASE_POOL_SIZE:-20} # 数据库连接池基础连接数
-      DATABASE_MAX_OVERFLOW: ${DATABASE_MAX_OVERFLOW:-40} # 连接池额外可溢出连接数
-      DATABASE_POOL_TIMEOUT: ${DATABASE_POOL_TIMEOUT:-30} # 获取连接超时时间（秒）
-      DATABASE_POOL_RECYCLE: ${DATABASE_POOL_RECYCLE:-1800} # 连接回收周期（秒）
-      DATA_ROOT: /app/data # 容器内业务数据目录
-      BOTS_WORKSPACE_ROOT: ${HOST_BOTS_WORKSPACE_ROOT} # Bot 工作目录，容器内外路径保持一致
-      DOCKER_NETWORK_NAME: ${DOCKER_NETWORK_NAME:-dashboard-nanobot-network} # 业务容器使用的 Docker 网络名称
-      DATABASE_URL: postgresql+psycopg://${POSTGRES_APP_USER}:${POSTGRES_APP_PASSWORD}@postgres:5432/${POSTGRES_APP_DB} # Full 模式固定连接内部 PostgreSQL
-      REDIS_ENABLED: ${REDIS_ENABLED:-true} # Full 模式默认启用 Redis
-      REDIS_URL: redis://redis:6379/${REDIS_DB:-8} # Full 模式固定连接内部 Redis
-      REDIS_PREFIX: ${REDIS_PREFIX:-dashboard_nanobot} # Redis key 前缀
-      REDIS_DEFAULT_TTL: ${REDIS_DEFAULT_TTL:-60} # Redis 默认过期时间（秒）
-      DEFAULT_BOT_SYSTEM_TIMEZONE: ${DEFAULT_BOT_SYSTEM_TIMEZONE:-Asia/Shanghai} # Bot 默认时区
-      PANEL_ACCESS_PASSWORD: ${PANEL_ACCESS_PASSWORD:-} # 面板访问密码
-      WORKSPACE_PREVIEW_SIGNING_SECRET: ${WORKSPACE_PREVIEW_SIGNING_SECRET:-} # 预览签名密钥
-      WORKSPACE_PREVIEW_TOKEN_TTL_SECONDS: ${WORKSPACE_PREVIEW_TOKEN_TTL_SECONDS:-3600} # 预览令牌有效期（秒）
-      CORS_ALLOWED_ORIGINS: ${CORS_ALLOWED_ORIGINS:-} # 前端跨域白名单
-      STT_ENABLED: ${STT_ENABLED:-true} # 是否启用语音识别
-      STT_MODEL: ${STT_MODEL:-ggml-small-q8_0.bin} # 语音识别模型文件名
-      STT_MODEL_DIR: ${STT_MODEL_DIR:-/app/data/model} # 语音识别模型目录
-      STT_DEVICE: ${STT_DEVICE:-cpu} # 语音识别运行设备
-      STT_MAX_AUDIO_SECONDS: ${STT_MAX_AUDIO_SECONDS:-20} # 单次音频最大秒数
-      STT_DEFAULT_LANGUAGE: ${STT_DEFAULT_LANGUAGE:-zh} # 默认语音识别语言
-      STT_FORCE_SIMPLIFIED: ${STT_FORCE_SIMPLIFIED:-true} # 是否强制输出简体中文
-      STT_AUDIO_PREPROCESS: ${STT_AUDIO_PREPROCESS:-true} # 是否预处理音频
-      STT_AUDIO_FILTER: ${STT_AUDIO_FILTER:-highpass=f=120,lowpass=f=7600,afftdn=nf=-20} # 音频滤波参数
-      STT_INITIAL_PROMPT: ${STT_INITIAL_PROMPT:-以下内容可能包含简体中文和英文术语。请优先输出简体中文，英文单词、缩写、品牌名和数字保持原文，不要翻译。} # 语音识别初始提示词
-    volumes: # 宿主机与容器挂载关系
-      - /var/run/docker.sock:/var/run/docker.sock # 必须保留，后端需要管理 Bot 容器
-      - ./data:/app/data # 项目数据目录，建议保留在交付目录下
-      - ${HOST_BOTS_WORKSPACE_ROOT}:${HOST_BOTS_WORKSPACE_ROOT} # Bot 工作目录挂载，路径通常由客户现场决定
-    expose: # 只暴露给内部网络，不直接发布到宿主机
-      - "8000" # 后端服务端口
-    healthcheck: # 健康检查，供 nginx 依赖判断使用
-      test: ["CMD", "python", "-c", "import urllib.request; urllib.request.urlopen('http://127.0.0.1:8000/api/health', timeout=3).read()"] # 检测后端健康接口
-      interval: 15s # 每 15 秒检查一次
-      timeout: 5s # 单次检查超时 5 秒
-      retries: 5 # 连续失败 5 次判定不健康
-      start_period: 20s # 启动后预留 20 秒缓冲时间
-    logging: # 容器日志策略
-      driver: json-file # 使用 Docker 默认 json-file 日志驱动
-      options: # 日志滚动配置
-        max-size: "20m" # 单个日志文件最大 20MB
-        max-file: "3" # 最多保留 3 个日志文件
+  nginx:
+    build:
+      context: ./frontend
+      dockerfile: Dockerfile
+      args:
+        NODE_BASE_IMAGE: ${NODE_BASE_IMAGE:-node:22-alpine}
+        NGINX_BASE_IMAGE: ${NGINX_BASE_IMAGE:-nginx:alpine}
+        NPM_REGISTRY: ${NPM_REGISTRY:-https://registry.npmjs.org/}
+        VITE_API_BASE: /api
+        VITE_WS_BASE: /ws/monitor
+    image: dashboard-nanobot/nginx:${FRONTEND_IMAGE_TAG:-latest}
+    container_name: dashboard-nanobot-nginx
+    restart: unless-stopped
+    environment:
+      TZ: ${TZ:-Asia/Shanghai}
+      UPLOAD_MAX_MB: ${UPLOAD_MAX_MB:-100}
+    depends_on:
+      backend:
+        condition: service_healthy
+    ports:
+      - "${NGINX_PORT}:80"
+    healthcheck:
+      test: ["CMD", "wget", "-q", "-O", "/dev/null", "http://127.0.0.1/"]
+      interval: 15s
+      timeout: 5s
+      retries: 5
+      start_period: 10s
+    logging:
+      driver: json-file
+      options:
+        max-size: "20m"
+        max-file: "3"

-  nginx: # 前端 Nginx 服务
-    build: # 保留构建信息，离线部署通常直接使用导入镜像
-      context: ./frontend # 前端构建上下文
-      dockerfile: Dockerfile # 前端 Dockerfile 路径
-      args: # 前端构建参数
-        NODE_BASE_IMAGE: ${NODE_BASE_IMAGE:-node:22-alpine} # Node 基础镜像
-        NGINX_BASE_IMAGE: ${NGINX_BASE_IMAGE:-nginx:alpine} # Nginx 基础镜像
-        NPM_REGISTRY: ${NPM_REGISTRY:-https://registry.npmjs.org/} # npm 源地址
-        VITE_API_BASE: /api # 前端 API 前缀
-        VITE_WS_BASE: /ws/monitor # 前端 WebSocket 前缀
-    image: dashboard-nanobot/nginx:${FRONTEND_IMAGE_TAG:-latest} # 前端运行镜像名
-    container_name: dashboard-nanobot-nginx # 前端容器固定名称
-    restart: unless-stopped # 异常退出后自动拉起
-    environment: # 前端环境变量
-      TZ: ${TZ:-Asia/Shanghai} # 容器时区
-      UPLOAD_MAX_MB: ${UPLOAD_MAX_MB:-100} # 上传大小限制，传给 Nginx 配置使用
-    depends_on: # 依赖后端健康后再启动
-      backend: # 依赖后端容器
-        condition: service_healthy # 要求后端健康
-    ports: # 对外开放端口
-      - "${NGINX_PORT}:80" # 宿主机端口映射到容器 80 端口
-    healthcheck: # Nginx 健康检查
-      test: ["CMD", "wget", "-q", "-O", "/dev/null", "http://127.0.0.1/"] # 检测首页是否可访问
-      interval: 15s # 每 15 秒检查一次
-      timeout: 5s # 单次检查超时 5 秒
-      retries: 5 # 连续失败 5 次判定不健康
-      start_period: 10s # 启动后预留 10 秒缓冲时间
-    logging: # 容器日志策略
-      driver: json-file # 使用 Docker 默认 json-file 日志驱动
-      options: # 日志滚动配置
-        max-size: "20m" # 单个日志文件最大 20MB
-        max-file: "3" # 最多保留 3 个日志文件
-
-networks: # 自定义网络配置
-  default: # 默认网络
-    name: ${DOCKER_NETWORK_NAME:-dashboard-nanobot-network} # 网络名称，客户通常无需修改
-    driver: bridge # 使用 bridge 网络驱动
-    ipam: # IP 地址管理配置
-      config: # 网段配置列表
-        - subnet: ${DOCKER_NETWORK_SUBNET:-172.20.0.0/16} # 自定义子网，现场冲突时可修改
+networks:
+  default:
+    name: ${DOCKER_NETWORK_NAME:-dashboard-nanobot-network}
+    external: true
--- a/docker-compose.prod.yml
+++ b/docker-compose.prod.yml
@ -1,108 +1,98 @@
-# Dashboard Nanobot Docker 编排文件（Prod 模式）
-# 说明：
-# 1. 当前文件用于“前端 + 后端”部署。
-# 2. PostgreSQL 与 Redis 由客户现场外部提供，本文件不会启动这两个服务。
-# 3. 客户通常需要重点修改 `.env` 里的端口、数据库连接串、Redis 连接串、工作目录路径。
-# 4. 如果需要调整宿主机挂载路径，可以直接修改下方 `volumes`。
+services:
+  backend:
+    build:
+      context: .
+      dockerfile: backend/Dockerfile
+      args:
+        PYTHON_BASE_IMAGE: ${PYTHON_BASE_IMAGE:-python:3.12-slim}
+        PIP_INDEX_URL: ${PIP_INDEX_URL:-https://pypi.org/simple}
+        PIP_TRUSTED_HOST: ${PIP_TRUSTED_HOST:-}
+    image: dashboard-nanobot/backend:${BACKEND_IMAGE_TAG:-latest}
+    container_name: dashboard-nanobot-backend
+    restart: unless-stopped
+    environment:
+      APP_HOST: 0.0.0.0
+      APP_PORT: 8002
+      APP_RELOAD: "false"
+      DATABASE_ECHO: "false"
+      DATABASE_POOL_SIZE: ${DATABASE_POOL_SIZE:-20}
+      DATABASE_MAX_OVERFLOW: ${DATABASE_MAX_OVERFLOW:-40}
+      DATABASE_POOL_TIMEOUT: ${DATABASE_POOL_TIMEOUT:-30}
+      DATABASE_POOL_RECYCLE: ${DATABASE_POOL_RECYCLE:-1800}
+      DATA_ROOT: /app/data
+      BOTS_WORKSPACE_ROOT: ${HOST_BOTS_WORKSPACE_ROOT}
+      DOCKER_NETWORK_NAME: ${DOCKER_NETWORK_NAME:-dashboard-nanobot-network}
+      DATABASE_URL: ${DATABASE_URL:-}
+      REDIS_ENABLED: ${REDIS_ENABLED:-false}
+      REDIS_URL: ${REDIS_URL:-}
+      REDIS_PREFIX: ${REDIS_PREFIX:-dashboard_nanobot}
+      REDIS_DEFAULT_TTL: ${REDIS_DEFAULT_TTL:-60}
+      DEFAULT_BOT_SYSTEM_TIMEZONE: ${DEFAULT_BOT_SYSTEM_TIMEZONE:-Asia/Shanghai}
+      PANEL_ACCESS_PASSWORD: ${PANEL_ACCESS_PASSWORD:-}
+      WORKSPACE_PREVIEW_SIGNING_SECRET: ${WORKSPACE_PREVIEW_SIGNING_SECRET:-}
+      WORKSPACE_PREVIEW_TOKEN_TTL_SECONDS: ${WORKSPACE_PREVIEW_TOKEN_TTL_SECONDS:-3600}
+      CORS_ALLOWED_ORIGINS: ${CORS_ALLOWED_ORIGINS:-}
+      STT_ENABLED: ${STT_ENABLED:-true}
+      STT_MODEL: ${STT_MODEL:-ggml-small-q8_0.bin}
+      STT_MODEL_DIR: ${STT_MODEL_DIR:-/app/data/model}
+      STT_DEVICE: ${STT_DEVICE:-cpu}
+      STT_MAX_AUDIO_SECONDS: ${STT_MAX_AUDIO_SECONDS:-20}
+      STT_DEFAULT_LANGUAGE: ${STT_DEFAULT_LANGUAGE:-zh}
+      STT_FORCE_SIMPLIFIED: ${STT_FORCE_SIMPLIFIED:-true}
+      STT_AUDIO_PREPROCESS: ${STT_AUDIO_PREPROCESS:-true}
+      STT_AUDIO_FILTER: ${STT_AUDIO_FILTER:-highpass=f=120,lowpass=f=7600,afftdn=nf=-20}
+      STT_INITIAL_PROMPT: ${STT_INITIAL_PROMPT:-以下内容可能包含简体中文和英文术语。请优先输出简体中文，英文单词、缩写、品牌名和数字保持原文，不要翻译。}
+    volumes:
+      - /var/run/docker.sock:/var/run/docker.sock
+      - ./data:/app/data
+      - ${HOST_BOTS_WORKSPACE_ROOT}:${HOST_BOTS_WORKSPACE_ROOT}
+    expose:
+      - "8002"
+    healthcheck:
+      test: ["CMD", "python", "-c", "import urllib.request; urllib.request.urlopen('http://127.0.0.1:8002/api/health', timeout=3).read()"]
+      interval: 15s
+      timeout: 5s
+      retries: 5
+      start_period: 20s
+    logging:
+      driver: json-file
+      options:
+        max-size: "20m"
+        max-file: "3"

-services: # 定义当前 compose 里需要启动的服务
-  backend: # 后端 API 服务
-    build: # 保留构建信息，便于有源码时重新 build；离线部署通常直接用 image
-      context: . # 构建上下文为项目根目录
-      dockerfile: backend/Dockerfile # 后端 Dockerfile 路径
-      args: # 构建参数
-        PYTHON_BASE_IMAGE: ${PYTHON_BASE_IMAGE:-python:3.12-slim} # Python 基础镜像
-        PIP_INDEX_URL: ${PIP_INDEX_URL:-https://pypi.org/simple} # pip 源地址
-        PIP_TRUSTED_HOST: ${PIP_TRUSTED_HOST:-} # pip 信任主机
-    image: dashboard-nanobot/backend:${BACKEND_IMAGE_TAG:-latest} # 后端运行镜像名
-    container_name: dashboard-nanobot-backend # 后端容器固定名称
-    restart: unless-stopped # 异常退出后自动拉起，手动停止时不自动启动
-    environment: # 后端环境变量
-      APP_HOST: 0.0.0.0 # 服务监听地址，容器内通常保持 0.0.0.0
-      APP_PORT: 8002 # 服务监听端口，需与 expose 和健康检查保持一致
-      APP_RELOAD: "false" # 生产环境关闭热重载
-      DATABASE_ECHO: "false" # 生产环境关闭 SQL 日志回显
-      DATABASE_POOL_SIZE: ${DATABASE_POOL_SIZE:-20} # 数据库连接池基础连接数
-      DATABASE_MAX_OVERFLOW: ${DATABASE_MAX_OVERFLOW:-40} # 连接池额外可溢出连接数
-      DATABASE_POOL_TIMEOUT: ${DATABASE_POOL_TIMEOUT:-30} # 获取连接超时时间（秒）
-      DATABASE_POOL_RECYCLE: ${DATABASE_POOL_RECYCLE:-1800} # 连接回收周期（秒）
-      DATA_ROOT: /app/data # 容器内业务数据目录
-      BOTS_WORKSPACE_ROOT: ${HOST_BOTS_WORKSPACE_ROOT} # Bot 工作目录，容器内外路径保持一致
-      DOCKER_NETWORK_NAME: ${DOCKER_NETWORK_NAME:-dashboard-nanobot-network} # 业务容器使用的 Docker 网络名称
-      DATABASE_URL: ${DATABASE_URL:-} # 外部 PostgreSQL 连接串，Prod 模式必须配置
-      REDIS_ENABLED: ${REDIS_ENABLED:-false} # 是否启用 Redis
-      REDIS_URL: ${REDIS_URL:-} # 外部 Redis 连接串
-      REDIS_PREFIX: ${REDIS_PREFIX:-dashboard_nanobot} # Redis key 前缀
-      REDIS_DEFAULT_TTL: ${REDIS_DEFAULT_TTL:-60} # Redis 默认过期时间（秒）
-      DEFAULT_BOT_SYSTEM_TIMEZONE: ${DEFAULT_BOT_SYSTEM_TIMEZONE:-Asia/Shanghai} # Bot 默认时区
-      PANEL_ACCESS_PASSWORD: ${PANEL_ACCESS_PASSWORD:-} # 面板访问密码
-      WORKSPACE_PREVIEW_SIGNING_SECRET: ${WORKSPACE_PREVIEW_SIGNING_SECRET:-} # 预览签名密钥
-      WORKSPACE_PREVIEW_TOKEN_TTL_SECONDS: ${WORKSPACE_PREVIEW_TOKEN_TTL_SECONDS:-3600} # 预览令牌有效期（秒）
-      CORS_ALLOWED_ORIGINS: ${CORS_ALLOWED_ORIGINS:-} # 前端跨域白名单
-      STT_ENABLED: ${STT_ENABLED:-true} # 是否启用语音识别
-      STT_MODEL: ${STT_MODEL:-ggml-small-q8_0.bin} # 语音识别模型文件名
-      STT_MODEL_DIR: ${STT_MODEL_DIR:-/app/data/model} # 语音识别模型目录
-      STT_DEVICE: ${STT_DEVICE:-cpu} # 语音识别运行设备
-      STT_MAX_AUDIO_SECONDS: ${STT_MAX_AUDIO_SECONDS:-20} # 单次音频最大秒数
-      STT_DEFAULT_LANGUAGE: ${STT_DEFAULT_LANGUAGE:-zh} # 默认语音识别语言
-      STT_FORCE_SIMPLIFIED: ${STT_FORCE_SIMPLIFIED:-true} # 是否强制输出简体中文
-      STT_AUDIO_PREPROCESS: ${STT_AUDIO_PREPROCESS:-true} # 是否预处理音频
-      STT_AUDIO_FILTER: ${STT_AUDIO_FILTER:-highpass=f=120,lowpass=f=7600,afftdn=nf=-20} # 音频滤波参数
-      STT_INITIAL_PROMPT: ${STT_INITIAL_PROMPT:-以下内容可能包含简体中文和英文术语。请优先输出简体中文，英文单词、缩写、品牌名和数字保持原文，不要翻译。} # 语音识别初始提示词
-    volumes: # 宿主机与容器挂载关系
-      - /var/run/docker.sock:/var/run/docker.sock # 必须保留，后端需要管理 Bot 容器
-      - ./data:/app/data # 项目数据目录，建议保留在交付目录下
-      - ${HOST_BOTS_WORKSPACE_ROOT}:${HOST_BOTS_WORKSPACE_ROOT} # Bot 工作目录挂载，路径通常由客户现场决定
-    expose: # 只暴露给内部网络，不直接发布到宿主机
-      - "8002" # 后端服务端口
-    healthcheck: # 健康检查，供 nginx 依赖判断使用
-      test: ["CMD", "python", "-c", "import urllib.request; urllib.request.urlopen('http://127.0.0.1:8002/api/health', timeout=3).read()"] # 检测后端健康接口
-      interval: 15s # 每 15 秒检查一次
-      timeout: 5s # 单次检查超时 5 秒
-      retries: 5 # 连续失败 5 次判定不健康
-      start_period: 20s # 启动后预留 20 秒缓冲时间
-    logging: # 容器日志策略
-      driver: json-file # 使用 Docker 默认 json-file 日志驱动
-      options: # 日志滚动配置
-        max-size: "20m" # 单个日志文件最大 20MB
-        max-file: "3" # 最多保留 3 个日志文件
+  nginx:
+    build:
+      context: ./frontend
+      dockerfile: Dockerfile
+      args:
+        NODE_BASE_IMAGE: ${NODE_BASE_IMAGE:-node:22-alpine}
+        NGINX_BASE_IMAGE: ${NGINX_BASE_IMAGE:-nginx:alpine}
+        NPM_REGISTRY: ${NPM_REGISTRY:-https://registry.npmjs.org/}
+        VITE_API_BASE: /api
+        VITE_WS_BASE: /ws/monitor
+    image: dashboard-nanobot/nginx:${FRONTEND_IMAGE_TAG:-latest}
+    container_name: dashboard-nanobot-nginx
+    restart: unless-stopped
+    environment:
+      UPLOAD_MAX_MB: ${UPLOAD_MAX_MB:-100}
+    depends_on:
+      backend:
+        condition: service_healthy
+    ports:
+      - "${NGINX_PORT}:80"
+    healthcheck:
+      test: ["CMD", "wget", "-q", "-O", "/dev/null", "http://127.0.0.1/"]
+      interval: 15s
+      timeout: 5s
+      retries: 5
+      start_period: 10s
+    logging:
+      driver: json-file
+      options:
+        max-size: "20m"
+        max-file: "3"

-  nginx: # 前端 Nginx 服务
-    build: # 保留构建信息，离线部署通常直接使用导入镜像
-      context: ./frontend # 前端构建上下文
-      dockerfile: Dockerfile # 前端 Dockerfile 路径
-      args: # 前端构建参数
-        NODE_BASE_IMAGE: ${NODE_BASE_IMAGE:-node:22-alpine} # Node 基础镜像
-        NGINX_BASE_IMAGE: ${NGINX_BASE_IMAGE:-nginx:alpine} # Nginx 基础镜像
-        NPM_REGISTRY: ${NPM_REGISTRY:-https://registry.npmjs.org/} # npm 源地址
-        VITE_API_BASE: /api # 前端 API 前缀
-        VITE_WS_BASE: /ws/monitor # 前端 WebSocket 前缀
-    image: dashboard-nanobot/nginx:${FRONTEND_IMAGE_TAG:-latest} # 前端运行镜像名
-    container_name: dashboard-nanobot-nginx # 前端容器固定名称
-    restart: unless-stopped # 异常退出后自动拉起
-    environment: # 前端环境变量
-      UPLOAD_MAX_MB: ${UPLOAD_MAX_MB:-100} # 上传大小限制，传给 Nginx 配置使用
-    depends_on: # 依赖后端健康后再启动
-      backend: # 依赖后端容器
-        condition: service_healthy # 要求后端健康
-    ports: # 对外开放端口
-      - "${NGINX_PORT}:80" # 宿主机端口映射到容器 80 端口
-    healthcheck: # Nginx 健康检查
-      test: ["CMD", "wget", "-q", "-O", "/dev/null", "http://127.0.0.1/"] # 检测首页是否可访问
-      interval: 15s # 每 15 秒检查一次
-      timeout: 5s # 单次检查超时 5 秒
-      retries: 5 # 连续失败 5 次判定不健康
-      start_period: 10s # 启动后预留 10 秒缓冲时间
-    logging: # 容器日志策略
-      driver: json-file # 使用 Docker 默认 json-file 日志驱动
-      options: # 日志滚动配置
-        max-size: "20m" # 单个日志文件最大 20MB
-        max-file: "3" # 最多保留 3 个日志文件
-
-networks: # 自定义网络配置
-  default: # 默认网络
-    name: ${DOCKER_NETWORK_NAME:-dashboard-nanobot-network} # 网络名称，客户通常无需修改
-    driver: bridge # 使用 bridge 网络驱动
-    ipam: # IP 地址管理配置
-      config: # 网段配置列表
-        - subnet: ${DOCKER_NETWORK_SUBNET:-172.20.0.0/16} # 自定义子网，现场冲突时可修改
+networks:
+  default:
+    name: ${DOCKER_NETWORK_NAME:-dashboard-nanobot-network}
+    external: true
--- a/download_model.sh
+++ b/download_model.sh
@ -1,74 +0,0 @@
-#!/usr/bin/env bash
-
-# ==========================================
-# Whisper ggml 模型下载脚本
-# 下载的模型将存放在 data/model 目录下
-# ==========================================
-
-# 确保在项目根目录运行
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-TARGET_DIR="${SCRIPT_DIR}/data/model"
-
-# 创建目标目录
-mkdir -p "$TARGET_DIR"
-
-# Hugging Face 的 whisper.cpp 模型仓库地址
-# 使用 hf-mirror 镜像加速国内下载
-BASE_URL="https://hf-mirror.com/ggerganov/whisper.cpp/resolve/main"
-
-echo "=========================================="
-echo "请选择要下载的 Whisper 语音识别模型："
-echo "1) tiny (最小，速度最快，约 40MB)"
-echo "2) base (基础，速度快，约 74MB)"
-echo "3) small (当前默认，平衡，约 240MB)"
-echo "4) medium (推荐，效果更好，约 770MB)"
-echo "5) large-v3 (最大，效果最好，约 1.5GB)"
-echo "=========================================="
-
-read -p "请输入对应的数字 [1-5，默认 4]: " choice
-
-MODEL_NAME=""
-case $choice in
-    1) MODEL_NAME="ggml-tiny-q8_0.bin" ;;
-    2) MODEL_NAME="ggml-base-q8_0.bin" ;;
-    3) MODEL_NAME="ggml-small-q8_0.bin" ;;
-    4|"") MODEL_NAME="ggml-medium-q8_0.bin" ;;
-    5) MODEL_NAME="ggml-large-v3-q8_0.bin" ;;
-    *) 
-        echo "无效的选择，使用默认选项 4 (medium)"
-        MODEL_NAME="ggml-medium-q8_0.bin"
-        ;;
-esac
-
-echo ""
-echo "准备下载模型: $MODEL_NAME"
-echo "保存路径: $TARGET_DIR/$MODEL_NAME"
-echo ""
-
-# 下载文件
-DOWNLOAD_URL="${BASE_URL}/${MODEL_NAME}"
-
-if command -v wget >/dev/null 2>&1; then
-    echo "使用 wget 下载中..."
-    wget -c --show-progress "$DOWNLOAD_URL" -O "$TARGET_DIR/$MODEL_NAME"
-elif command -v curl >/dev/null 2>&1; then
-    echo "使用 curl 下载中..."
-    curl -L -C - -o "$TARGET_DIR/$MODEL_NAME" "$DOWNLOAD_URL"
-else
-    echo "错误：找不到 wget 或 curl 命令，无法下载文件。"
-    exit 1
-fi
-
-if [ $? -eq 0 ]; then
-    echo ""
-    echo "✅ 下载成功！"
-    echo "模型文件已保存到: $TARGET_DIR/$MODEL_NAME"
-    echo ""
-    echo "请记得更新 .env.prod 或 backend/.env 文件中的配置："
-    echo "STT_MODEL=$MODEL_NAME"
-    echo "修改后重启后端容器即可生效。"
-else
-    echo ""
-    echo "❌ 下载失败，请检查网络连接或稍后重试。"
-    exit 1
-fi
--- a/frontend/src/i18n/app.zh-cn.ts
+++ b/frontend/src/i18n/app.zh-cn.ts
@ -1,5 +1,5 @@
 export const appZhCn = {
-  title: 'Unisbot 管理面板',
+  title: 'Nanobot 管理面板',
  theme: '主题',
  language: '语言',
  dark: '深色',
--- a/frontend/src/i18n/dashboard.en.ts
+++ b/frontend/src/i18n/dashboard.en.ts
@ -266,7 +266,7 @@ export const dashboardEn = {
  modelName: 'Model Name',
  modelNamePlaceholder: 'e.g. qwen-plus',
  newApiKey: 'API Key',
-  newApiKeyPlaceholder: 'Enter API key',
+  newApiKeyPlaceholder: 'Enter API Key',
  testing: 'Testing...',
  testModelConnection: 'Test model connection',
  cancel: 'Cancel',
--- a/frontend/src/main.tsx
+++ b/frontend/src/main.tsx
@ -1,14 +1,11 @@
 import { StrictMode } from 'react'
 import { createRoot } from 'react-dom/client'
-import axios from 'axios'
 import './index.css'
 import App from './App.tsx'
 import { LucentPromptProvider } from './components/lucent/LucentPromptProvider.tsx'
 import { setupBotAccessAuth } from './utils/botAccess.ts'
 import { setupPanelAccessAuth } from './utils/panelAccess.ts'

-axios.defaults.withCredentials = true
-
 setupPanelAccessAuth();
 setupBotAccessAuth();

--- a/frontend/src/modules/dashboard/components/DashboardChannelConfigModal.tsx
+++ b/frontend/src/modules/dashboard/components/DashboardChannelConfigModal.tsx
@ -53,6 +53,40 @@ function isChannelConfigured(channel: BotChannel): boolean {
  return Boolean(String(channel.external_app_id || '').trim() || String(channel.app_secret || '').trim());
 }

+function ChannelDeliveryFields({
+  channel,
+  labels,
+  onPatch,
+}: {
+  channel: BotChannel;
+  labels: Pick<ChannelConfigLabels, 'sendProgress' | 'sendToolHints'>;
+  onPatch: (patch: Partial<BotChannel>) => void;
+}) {
+  const extra = channel.extra_config || {};
+  return (
+    <>
+      <label className="field-label ops-channel-delivery-toggle">
+        <input
+          type="checkbox"
+          checked={Boolean(extra.sendProgress)}
+          onChange={(e) => onPatch({ extra_config: { ...extra, sendProgress: e.target.checked } })}
+          style={{ marginRight: 6 }}
+        />
+        {labels.sendProgress}
+      </label>
+      <label className="field-label ops-channel-delivery-toggle">
+        <input
+          type="checkbox"
+          checked={Boolean(extra.sendToolHints)}
+          onChange={(e) => onPatch({ extra_config: { ...extra, sendToolHints: e.target.checked } })}
+          style={{ marginRight: 6 }}
+        />
+        {labels.sendToolHints}
+      </label>
+    </>
+  );
+}
+
 function ChannelFieldsEditor({
  channel,
  labels,
@ -302,23 +336,18 @@ function ChannelFieldsEditor({
 interface ChannelConfigModalProps {
  open: boolean;
  channels: BotChannel[];
-  globalDelivery: { sendProgress: boolean; sendToolHints: boolean };
  expandedChannelByKey: Record<string, boolean>;
  newChannelDraft: BotChannel;
  addableChannelTypes: ChannelType[];
  newChannelPanelOpen: boolean;
  channelCreateMenuOpen: boolean;
  channelCreateMenuRef: RefObject<HTMLDivElement | null>;
-  isSavingGlobalDelivery: boolean;
  isSavingChannel: boolean;
  weixinLoginStatus: WeixinLoginStatus | null;
-  hasSelectedBot: boolean;
  isZh: boolean;
  labels: ChannelConfigLabels;
  passwordToggleLabels: PasswordToggleLabels;
  onClose: () => void;
-  onUpdateGlobalDeliveryFlag: (key: 'sendProgress' | 'sendToolHints', value: boolean) => void;
-  onSaveGlobalDelivery: () => Promise<void> | void;
  getChannelUiKey: (channel: Pick<BotChannel, 'id' | 'channel_type'>, fallbackIndex: number) => string;
  isDashboardChannel: (channel: BotChannel) => boolean;
  onUpdateChannelLocal: (index: number, patch: Partial<BotChannel>) => void;
@ -337,23 +366,18 @@ interface ChannelConfigModalProps {
 export function ChannelConfigModal({
  open,
  channels,
-  globalDelivery,
  expandedChannelByKey,
  newChannelDraft,
  addableChannelTypes,
  newChannelPanelOpen,
  channelCreateMenuOpen,
  channelCreateMenuRef,
-  isSavingGlobalDelivery,
  isSavingChannel,
  weixinLoginStatus,
-  hasSelectedBot,
  isZh,
  labels,
  passwordToggleLabels,
  onClose,
-  onUpdateGlobalDeliveryFlag,
-  onSaveGlobalDelivery,
  getChannelUiKey,
  isDashboardChannel,
  onUpdateChannelLocal,
@ -410,7 +434,7 @@ export function ChannelConfigModal({
    <DrawerShell
      open={open}
      onClose={onClose}
-      title={labels.wizardSectionTitle}
+      title={labels.openManager}
      size="extend"
      closeLabel={labels.close}
      bodyClassName="ops-config-drawer-body"
@ -442,50 +466,18 @@ export function ChannelConfigModal({
      )}
    >
      <div className="ops-config-modal">
-        <div className="card">
-          <div className="section-mini-title">{labels.globalDeliveryTitle}</div>
-          <div className="wizard-dashboard-switches" style={{ marginTop: 8 }}>
-            <label className="field-label">
-              <input
-                type="checkbox"
-                checked={Boolean(globalDelivery.sendProgress)}
-                onChange={(e) => onUpdateGlobalDeliveryFlag('sendProgress', e.target.checked)}
-                style={{ marginRight: 6 }}
-              />
-              {labels.sendProgress}
-            </label>
-            <label className="field-label">
-              <input
-                type="checkbox"
-                checked={Boolean(globalDelivery.sendToolHints)}
-                onChange={(e) => onUpdateGlobalDeliveryFlag('sendToolHints', e.target.checked)}
-                style={{ marginRight: 6 }}
-              />
-              {labels.sendToolHints}
-            </label>
-            <LucentIconButton
-              className="btn btn-primary btn-sm icon-btn"
-              disabled={isSavingGlobalDelivery || !hasSelectedBot}
-              onClick={() => void onSaveGlobalDelivery()}
-              tooltip={labels.saveChannel}
-              aria-label={labels.saveChannel}
-            >
-              <Save size={14} />
-            </LucentIconButton>
-          </div>
-        </div>
        <div className="wizard-channel-list ops-config-list-scroll">
-          {channels.filter((channel) => !isDashboardChannel(channel)).length === 0 ? (
+          {channels.length === 0 ? (
            <div className="ops-empty-inline">{labels.channelEmpty}</div>
          ) : (
            channels.map((channel, idx) => {
-              if (isDashboardChannel(channel)) return null;
+              const dashboardChannel = isDashboardChannel(channel);
              const uiKey = getChannelUiKey(channel, idx);
              const expanded = expandedChannelByKey[uiKey] ?? idx === 0;
              const summary = [
                String(channel.channel_type || '').toUpperCase(),
                channel.is_active ? labels.enabled : labels.disabled,
-                isChannelConfigured(channel) ? labels.channelConfigured : labels.channelPending,
+                dashboardChannel ? labels.dashboardLocked : (isChannelConfigured(channel) ? labels.channelConfigured : labels.channelPending),
              ].join(' · ');
              return (
                <div key={`${channel.id}-${channel.channel_type}`} className="card wizard-channel-card wizard-channel-compact">
@ -495,6 +487,8 @@ export function ChannelConfigModal({
                      <div className="ops-config-collapsed-meta">{summary}</div>
                    </div>
                    <div className="ops-config-card-actions">
+                      {!dashboardChannel ? (
+                        <>
                          <label className="field-label">
                            <input
                              type="checkbox"
@ -513,6 +507,8 @@ export function ChannelConfigModal({
                          >
                            <Trash2 size={14} />
                          </LucentIconButton>
+                        </>
+                      ) : null}
                      <LucentIconButton
                        className="ops-plain-icon-btn"
                        onClick={() => onToggleExpandedChannel(uiKey)}
@ -526,16 +522,23 @@ export function ChannelConfigModal({
                  {expanded ? (
                    <>
                      <div className="ops-topic-grid">
+                        {dashboardChannel ? null : (
                          <ChannelFieldsEditor
                            channel={channel}
                            labels={labels}
                            passwordToggleLabels={passwordToggleLabels}
                            onPatch={(patch) => onUpdateChannelLocal(idx, patch)}
                          />
+                        )}
+                        <ChannelDeliveryFields
+                          channel={channel}
+                          labels={labels}
+                          onPatch={(patch) => onUpdateChannelLocal(idx, patch)}
+                        />
                      </div>
                      {renderWeixinLoginBlock(channel)}
                      <div className="row-between ops-config-footer">
-                        <span className="field-label">{labels.customChannel}</span>
+                        <span className="field-label">{dashboardChannel ? labels.defaultChannel : labels.customChannel}</span>
                        <button className="btn btn-primary btn-sm" disabled={isSavingChannel} onClick={() => void onSaveChannel(channel)}>
                          <Save size={14} />
                          <span style={{ marginLeft: 6 }}>{labels.saveChannel}</span>
@ -592,6 +595,11 @@ export function ChannelConfigModal({
                passwordToggleLabels={passwordToggleLabels}
                onPatch={onUpdateNewChannelDraft}
              />
+              <ChannelDeliveryFields
+                channel={newChannelDraft}
+                labels={labels}
+                onPatch={onUpdateNewChannelDraft}
+              />
            </div>
            <div className="row-between ops-config-footer">
              <span className="field-label">{labels.channelAddHint}</span>
--- a/frontend/src/modules/dashboard/components/DashboardChatComposer.tsx
+++ b/frontend/src/modules/dashboard/components/DashboardChatComposer.tsx
@ -1,5 +1,5 @@
 import { ArrowUp, ChevronLeft, Clock3, Command, Download, Eye, FileText, Mic, Paperclip, Plus, RefreshCw, RotateCcw, Square, X } from 'lucide-react';
-import type { ChangeEventHandler, KeyboardEventHandler, RefObject } from 'react';
+import { useRef, useState, type ChangeEventHandler, type DragEvent, type DragEventHandler, type KeyboardEventHandler, type RefObject } from 'react';

 import { LucentIconButton } from '../../../components/lucent/LucentIconButton';
 import { normalizeAssistantMessageText } from '../../../shared/text/messageText';
@ -26,6 +26,7 @@ interface DashboardChatComposerProps {
  filePickerRef: RefObject<HTMLInputElement | null>;
  allowedAttachmentExtensions: string[];
  onPickAttachments: ChangeEventHandler<HTMLInputElement>;
+  onDropAttachments: (files: FileList) => Promise<void> | void;
  controlCommandPanelOpen: boolean;
  controlCommandPanelRef: RefObject<HTMLDivElement | null>;
  onToggleControlCommandPanel: () => void;
@ -125,6 +126,7 @@ export function DashboardChatComposer({
  filePickerRef,
  allowedAttachmentExtensions,
  onPickAttachments,
+  onDropAttachments,
  controlCommandPanelOpen,
  controlCommandPanelRef,
  onToggleControlCommandPanel,
@ -159,6 +161,46 @@ export function DashboardChatComposer({
 }: DashboardChatComposerProps) {
  const showInterruptSubmitAction = submitActionMode === 'interrupt';
  const hasComposerDraft = Boolean(String(command || '').trim()) || pendingAttachments.length > 0 || Boolean(quotedReply);
+  const [isDraggingAttachments, setIsDraggingAttachments] = useState(false);
+  const dragDepthRef = useRef(0);
+  const canDropAttachments = canChat && !isUploadingAttachments && !isVoiceRecording && !isVoiceTranscribing;
+  const hasDraggedFiles = (event: DragEvent<HTMLDivElement>) =>
+    Array.from(event.dataTransfer?.types || []).includes('Files');
+
+  const handleAttachmentDragEnter: DragEventHandler<HTMLDivElement> = (event) => {
+    if (!hasDraggedFiles(event)) return;
+    event.preventDefault();
+    event.stopPropagation();
+    if (!canDropAttachments) return;
+    dragDepthRef.current += 1;
+    setIsDraggingAttachments(true);
+  };
+
+  const handleAttachmentDragOver: DragEventHandler<HTMLDivElement> = (event) => {
+    if (!hasDraggedFiles(event)) return;
+    event.preventDefault();
+    event.stopPropagation();
+    event.dataTransfer.dropEffect = canDropAttachments ? 'copy' : 'none';
+    if (canDropAttachments) setIsDraggingAttachments(true);
+  };
+
+  const handleAttachmentDragLeave: DragEventHandler<HTMLDivElement> = (event) => {
+    if (!hasDraggedFiles(event)) return;
+    event.preventDefault();
+    event.stopPropagation();
+    dragDepthRef.current = Math.max(0, dragDepthRef.current - 1);
+    if (dragDepthRef.current === 0) setIsDraggingAttachments(false);
+  };
+
+  const handleAttachmentDrop: DragEventHandler<HTMLDivElement> = (event) => {
+    if (!hasDraggedFiles(event)) return;
+    event.preventDefault();
+    event.stopPropagation();
+    dragDepthRef.current = 0;
+    setIsDraggingAttachments(false);
+    if (!canDropAttachments || event.dataTransfer.files.length === 0) return;
+    void onDropAttachments(event.dataTransfer.files);
+  };

  return (
    <>
@ -209,7 +251,13 @@ export function DashboardChatComposer({
          </span>
        </div>
      ) : null}
-      <div className="ops-composer">
+      <div
+        className={`ops-composer ${isDraggingAttachments ? 'is-dragging-attachments' : ''}`}
+        onDragEnter={handleAttachmentDragEnter}
+        onDragOver={handleAttachmentDragOver}
+        onDragLeave={handleAttachmentDragLeave}
+        onDrop={handleAttachmentDrop}
+      >
        <input
          ref={filePickerRef}
          type="file"
@ -219,6 +267,11 @@ export function DashboardChatComposer({
          className="ops-hidden-file-input"
        />
        <div className={`ops-composer-shell ${controlCommandPanelOpen ? 'is-command-open' : ''}`}>
+          {isDraggingAttachments ? (
+            <div className="ops-composer-drop-overlay" aria-hidden="true">
+              <Paperclip size={24} />
+            </div>
+          ) : null}
          <div className="ops-composer-float-controls" ref={controlCommandPanelRef}>
            <div className={`ops-control-command-drawer ${controlCommandPanelOpen ? 'is-open' : ''}`}>
              <button
--- a/frontend/src/modules/dashboard/components/DashboardChatPanel.css
+++ b/frontend/src/modules/dashboard/components/DashboardChatPanel.css
@ -43,6 +43,12 @@
  background: var(--panel-soft);
  padding: 10px;
  display: block;
+  transition: border-color 0.16s ease, background 0.16s ease;
+}
+
+.ops-composer.is-dragging-attachments {
+  border-color: color-mix(in oklab, var(--brand) 64%, var(--line) 36%);
+  background: color-mix(in oklab, var(--brand-soft) 18%, var(--panel-soft) 82%);
 }

 .ops-composer-shell {
@ -57,6 +63,20 @@
  background: var(--panel);
 }

+.ops-composer-drop-overlay {
+  position: absolute;
+  inset: 0;
+  z-index: 5;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  border: 1px dashed color-mix(in oklab, var(--brand) 62%, var(--line) 38%);
+  border-radius: 10px;
+  background: color-mix(in oklab, var(--panel) 70%, var(--brand-soft) 30%);
+  color: var(--brand);
+  pointer-events: none;
+}
+
 .ops-chat-top-context {
  width: 100%;
  min-width: 0;
--- a/frontend/src/modules/dashboard/components/DashboardChatPanel.tsx
+++ b/frontend/src/modules/dashboard/components/DashboardChatPanel.tsx
@ -52,6 +52,7 @@ interface DashboardChatPanelProps {
  filePickerRef: RefObject<HTMLInputElement | null>;
  allowedAttachmentExtensions: string[];
  onPickAttachments: ChangeEventHandler<HTMLInputElement>;
+  onDropAttachments: (files: FileList) => Promise<void> | void;
  controlCommandPanelOpen: boolean;
  controlCommandPanelRef: RefObject<HTMLDivElement | null>;
  onToggleControlCommandPanel: () => void;
@ -242,6 +243,7 @@ export function DashboardChatPanel({
  filePickerRef,
  allowedAttachmentExtensions,
  onPickAttachments,
+  onDropAttachments,
  controlCommandPanelOpen,
  controlCommandPanelRef,
  onToggleControlCommandPanel,
@ -370,6 +372,7 @@ export function DashboardChatPanel({
          filePickerRef={filePickerRef}
          allowedAttachmentExtensions={allowedAttachmentExtensions}
          onPickAttachments={onPickAttachments}
+          onDropAttachments={onDropAttachments}
          controlCommandPanelOpen={controlCommandPanelOpen}
          controlCommandPanelRef={controlCommandPanelRef}
          onToggleControlCommandPanel={onToggleControlCommandPanel}
--- a/frontend/src/modules/dashboard/config-managers/channelManager.ts
+++ b/frontend/src/modules/dashboard/config-managers/channelManager.ts
@ -34,11 +34,6 @@ export interface ChannelManagerLabels {
  channels: string;
 }

-export interface GlobalDeliveryState {
-  sendProgress: boolean;
-  sendToolHints: boolean;
-}
-
 interface ApiErrorDetail {
  detail?: string;
 }
@ -58,12 +53,9 @@ function resolveApiErrorMessage(error: unknown, fallback: string): string {

 interface ChannelManagerDeps extends PromptApi {
  selectedBotId: string;
-  selectedBotDockerStatus: string;
  t: ChannelManagerLabels;
-  currentGlobalDelivery: GlobalDeliveryState;
  addableChannelTypes: ChannelType[];
  currentNewChannelDraft: BotChannel;
-  refresh: () => Promise<void>;
  setShowChannelModal: (value: boolean) => void;
  setChannels: (value: BotChannel[] | ((prev: BotChannel[]) => BotChannel[])) => void;
  setExpandedChannelByKey: (
@ -73,20 +65,13 @@ interface ChannelManagerDeps extends PromptApi {
  setNewChannelPanelOpen: (value: boolean) => void;
  setNewChannelDraft: (value: BotChannel | ((prev: BotChannel) => BotChannel)) => void;
  setIsSavingChannel: (value: boolean) => void;
-  setGlobalDelivery: (
-    value: GlobalDeliveryState | ((prev: GlobalDeliveryState) => GlobalDeliveryState)
-  ) => void;
-  setIsSavingGlobalDelivery: (value: boolean) => void;
 }

 export function createChannelManager({
  selectedBotId,
-  selectedBotDockerStatus,
  t,
-  currentGlobalDelivery,
  addableChannelTypes,
  currentNewChannelDraft,
-  refresh,
  notify,
  confirm,
  setShowChannelModal,
@ -96,11 +81,11 @@ export function createChannelManager({
  setNewChannelPanelOpen,
  setNewChannelDraft,
  setIsSavingChannel,
-  setGlobalDelivery,
-  setIsSavingGlobalDelivery,
 }: ChannelManagerDeps) {
-  const createEmptyChannelExtra = (channelType: ChannelType): Record<string, unknown> =>
-    channelType === 'weixin' ? {} : {};
+  const createEmptyChannelExtra = (): Record<string, unknown> => ({
+    sendProgress: true,
+    sendToolHints: true,
+  });

  const createEmptyChannelDraft = (channelType: ChannelType = 'feishu'): BotChannel => ({
    id: 'draft-channel',
@ -110,7 +95,7 @@ export function createChannelManager({
    app_secret: '',
    internal_port: 8080,
    is_active: true,
-    extra_config: createEmptyChannelExtra(channelType),
+    extra_config: createEmptyChannelExtra(),
  });

  const channelDraftUiKey = (channel: Pick<BotChannel, 'id' | 'channel_type'>, fallbackIndex: number) => {
@ -129,10 +114,9 @@ export function createChannelManager({
  const sanitizeChannelExtra = (channelType: string, extra: Record<string, unknown>) => {
    const type = String(channelType || '').toLowerCase();
    if (type === 'dashboard') return extra || {};
-    if (type === 'weixin') return {};
    const next = { ...(extra || {}) };
-    delete next.sendProgress;
-    delete next.sendToolHints;
+    next.sendProgress = Boolean(next.sendProgress);
+    next.sendToolHints = Boolean(next.sendToolHints);
    return next;
  };

@ -143,9 +127,7 @@ export function createChannelManager({
    setChannels(rows);
    setExpandedChannelByKey((prev) => {
      const next: Record<string, boolean> = {};
-      rows
-        .filter((channel) => !isDashboardChannel(channel))
-        .forEach((channel, index) => {
+      rows.forEach((channel, index) => {
        const key = channelDraftUiKey(channel, index);
        next[key] = typeof prev[key] === 'boolean' ? prev[key] : index === 0;
      });
@ -173,14 +155,15 @@ export function createChannelManager({
  const updateChannelLocal = (index: number, patch: Partial<BotChannel>) => {
    setChannels((prev) =>
      prev.map((channel, channelIndex) => {
-        if (channelIndex !== index || channel.locked) return channel;
+        if (channelIndex !== index) return channel;
        return { ...channel, ...patch };
      }),
    );
  };

  const saveChannel = async (channel: BotChannel) => {
-    if (!selectedBotId || channel.locked || isDashboardChannel(channel)) return;
+    if (!selectedBotId) return;
+    const dashboardChannel = isDashboardChannel(channel);
    setIsSavingChannel(true);
    try {
      await axios.put(`${APP_ENDPOINTS.apiBase}/bots/${selectedBotId}/channels/${channel.id}`, {
@ -188,7 +171,7 @@ export function createChannelManager({
        external_app_id: channel.external_app_id,
        app_secret: channel.app_secret,
        internal_port: Number(channel.internal_port),
-        is_active: channel.is_active,
+        is_active: dashboardChannel ? true : channel.is_active,
        extra_config: sanitizeChannelExtra(String(channel.channel_type), channel.extra_config || {}),
      });
      await loadChannels(selectedBotId);
@ -247,32 +230,6 @@ export function createChannelManager({
    }
  };

-  const updateGlobalDeliveryFlag = (key: 'sendProgress' | 'sendToolHints', value: boolean) => {
-    setGlobalDelivery((prev) => ({ ...prev, [key]: value }));
-  };
-
-  const saveGlobalDelivery = async () => {
-    if (!selectedBotId) return;
-    setIsSavingGlobalDelivery(true);
-    try {
-      await axios.put(`${APP_ENDPOINTS.apiBase}/bots/${selectedBotId}`, {
-        send_progress: Boolean(currentGlobalDelivery.sendProgress),
-        send_tool_hints: Boolean(currentGlobalDelivery.sendToolHints),
-      });
-      if (selectedBotDockerStatus === 'RUNNING') {
-        await axios.post(`${APP_ENDPOINTS.apiBase}/bots/${selectedBotId}/stop`);
-        await axios.post(`${APP_ENDPOINTS.apiBase}/bots/${selectedBotId}/start`);
-      }
-      await refresh();
-      notify(t.channelSaved, { tone: 'success' });
-    } catch (error: unknown) {
-      const message = resolveApiErrorMessage(error, t.channelSaveFail);
-      notify(message, { tone: 'error' });
-    } finally {
-      setIsSavingGlobalDelivery(false);
-    }
-  };
-
  return {
    createEmptyChannelDraft,
    channelDraftUiKey,
@ -285,7 +242,5 @@ export function createChannelManager({
    saveChannel,
    addChannel,
    removeChannel,
-    updateGlobalDeliveryFlag,
-    saveGlobalDelivery,
  };
 }
--- a/frontend/src/modules/dashboard/hooks/useBotDashboardModule.ts
+++ b/frontend/src/modules/dashboard/hooks/useBotDashboardModule.ts
@ -283,7 +283,6 @@ export function useBotDashboardModule({
    notify,
    onPickSkillZip,
    passwordToggleLabels,
-    refresh,
    reloginWeixin,
    removeBotSkill,
    resetSupportState,
@ -351,6 +350,7 @@ export function useBotDashboardModule({
    resolveWorkspaceMediaSrc,
    saveWorkspacePreviewMarkdown,
    setPendingAttachments,
+    uploadAttachmentFiles,
    setWorkspaceAutoRefresh,
    setWorkspacePreviewDraft,
    setWorkspacePreviewFullscreen,
@ -665,6 +665,7 @@ export function useBotDashboardModule({
    removeStagedSubmission,
    pendingAttachments,
    setPendingAttachments,
+    uploadAttachmentFiles,
    attachmentUploadPercent,
    isUploadingAttachments,
    filePickerRef,
--- a/frontend/src/modules/dashboard/hooks/useDashboardChannelConfig.ts
+++ b/frontend/src/modules/dashboard/hooks/useDashboardChannelConfig.ts
@ -1,9 +1,9 @@
-import { useCallback, useEffect, useMemo, useRef, useState, type SetStateAction } from 'react';
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';

 import type { BotState } from '../../../types/bot';
 import type { ChannelLabels } from '../localeTypes';
 import { optionalChannelTypes } from '../constants';
-import { createChannelManager, type ChannelManagerLabels, type GlobalDeliveryState } from '../config-managers/channelManager';
+import { createChannelManager, type ChannelManagerLabels } from '../config-managers/channelManager';
 import type { BotChannel, WeixinLoginStatus } from '../types';

 type PromptTone = 'info' | 'success' | 'warning' | 'error';
@ -29,30 +29,14 @@ interface UseDashboardChannelConfigOptions {
  loadWeixinLoginStatus: (botId: string, silent?: boolean) => Promise<void>;
  notify: (message: string, options?: NotifyOptions) => void;
  passwordToggleLabels: { show: string; hide: string };
-  refresh: () => Promise<void>;
  reloginWeixin: () => Promise<void>;
-  selectedBot?: Pick<BotState, 'id' | 'docker_status' | 'send_progress' | 'send_tool_hints'> | null;
+  selectedBot?: Pick<BotState, 'id'> | null;
  selectedBotId: string;
  t: ChannelManagerLabels & { cancel: string; close: string };
  lc: ChannelLabels;
  weixinLoginStatus: WeixinLoginStatus | null;
 }

-const EMPTY_GLOBAL_DELIVERY: GlobalDeliveryState = {
-  sendProgress: false,
-  sendToolHints: false,
-};
-
-function readBotGlobalDelivery(
-  bot?: Pick<BotState, 'send_progress' | 'send_tool_hints'> | null,
-): GlobalDeliveryState {
-  if (!bot) return EMPTY_GLOBAL_DELIVERY;
-  return {
-    sendProgress: Boolean(bot.send_progress),
-    sendToolHints: Boolean(bot.send_tool_hints),
-  };
-}
-
 export function useDashboardChannelConfig({
  closeRuntimeMenu,
  confirm,
@ -60,7 +44,6 @@ export function useDashboardChannelConfig({
  loadWeixinLoginStatus,
  notify,
  passwordToggleLabels,
-  refresh,
  reloginWeixin,
  selectedBot,
  selectedBotId,
@ -82,31 +65,15 @@ export function useDashboardChannelConfig({
    app_secret: '',
    internal_port: 8080,
    is_active: true,
-    extra_config: {},
+    extra_config: { sendProgress: true, sendToolHints: true },
  });
  const [isSavingChannel, setIsSavingChannel] = useState(false);
-  const [isSavingGlobalDelivery, setIsSavingGlobalDelivery] = useState(false);
-  const [globalDeliveryDraftByBot, setGlobalDeliveryDraftByBot] = useState<Record<string, GlobalDeliveryState>>({});

  const addableChannelTypes = useMemo(() => {
    const exists = new Set(channels.map((channel) => String(channel.channel_type).toLowerCase()));
    return optionalChannelTypes.filter((type) => !exists.has(type));
  }, [channels]);

-  const globalDelivery = useMemo(() => {
-    if (!selectedBotId || !selectedBot) return EMPTY_GLOBAL_DELIVERY;
-    return globalDeliveryDraftByBot[selectedBotId] ?? readBotGlobalDelivery(selectedBot);
-  }, [globalDeliveryDraftByBot, selectedBot, selectedBotId]);
-
-  const setGlobalDelivery = useCallback((value: SetStateAction<GlobalDeliveryState>) => {
-    if (!selectedBotId) return;
-    setGlobalDeliveryDraftByBot((prev) => {
-      const currentValue = prev[selectedBotId] ?? readBotGlobalDelivery(selectedBot);
-      const nextValue = typeof value === 'function' ? value(currentValue) : value;
-      return { ...prev, [selectedBotId]: nextValue };
-    });
-  }, [selectedBot, selectedBotId]);
-
  const {
    resetNewChannelDraft,
    channelDraftUiKey,
@ -117,16 +84,11 @@ export function useDashboardChannelConfig({
    saveChannel,
    addChannel,
    removeChannel,
-    updateGlobalDeliveryFlag,
-    saveGlobalDelivery,
  } = createChannelManager({
    selectedBotId,
-    selectedBotDockerStatus: selectedBot?.docker_status || '',
    t,
-    currentGlobalDelivery: globalDelivery,
    addableChannelTypes,
    currentNewChannelDraft: newChannelDraft,
-    refresh,
    notify,
    confirm,
    setShowChannelModal,
@ -136,8 +98,6 @@ export function useDashboardChannelConfig({
    setNewChannelPanelOpen,
    setNewChannelDraft,
    setIsSavingChannel,
-    setGlobalDelivery,
-    setIsSavingGlobalDelivery,
  });

  useEffect(() => {
@ -172,23 +132,19 @@ export function useDashboardChannelConfig({
    setNewChannelPanelOpen(false);
    setChannelCreateMenuOpen(false);
    resetNewChannelDraft();
-    setGlobalDeliveryDraftByBot({});
  }, [resetNewChannelDraft]);

  const channelConfigModalProps = {
    open: showChannelModal,
    channels,
-    globalDelivery,
    expandedChannelByKey,
    newChannelDraft,
    addableChannelTypes,
    newChannelPanelOpen,
    channelCreateMenuOpen,
    channelCreateMenuRef,
-    isSavingGlobalDelivery,
    isSavingChannel,
    weixinLoginStatus,
-    hasSelectedBot: Boolean(selectedBot),
    isZh,
    labels: { ...lc, cancel: t.cancel, close: t.close },
    passwordToggleLabels,
@ -198,8 +154,6 @@ export function useDashboardChannelConfig({
      setNewChannelPanelOpen(false);
      resetNewChannelDraft();
    },
-    onUpdateGlobalDeliveryFlag: updateGlobalDeliveryFlag,
-    onSaveGlobalDelivery: saveGlobalDelivery,
    getChannelUiKey: channelDraftUiKey,
    isDashboardChannel,
    onUpdateChannelLocal: updateChannelLocal,
--- a/frontend/src/modules/dashboard/hooks/useDashboardConfigPanels.ts
+++ b/frontend/src/modules/dashboard/hooks/useDashboardConfigPanels.ts
@ -50,7 +50,6 @@ interface UseDashboardConfigPanelsOptions {
  notify: (message: string, options?: NotifyOptions) => void;
  onPickSkillZip: (event: ChangeEvent<HTMLInputElement>) => Promise<void>;
  passwordToggleLabels: { show: string; hide: string };
-  refresh: () => Promise<void>;
  reloginWeixin: () => Promise<void>;
  removeBotSkill: (skill: WorkspaceSkillOption) => Promise<void>;
  resetSupportState: () => void;
@ -92,7 +91,6 @@ export function useDashboardConfigPanels({
  notify,
  onPickSkillZip,
  passwordToggleLabels,
-  refresh,
  reloginWeixin,
  removeBotSkill,
  resetSupportState,
@ -159,7 +157,6 @@ export function useDashboardConfigPanels({
    loadWeixinLoginStatus,
    notify,
    passwordToggleLabels,
-    refresh,
    reloginWeixin,
    selectedBot,
    selectedBotId,
--- a/frontend/src/modules/dashboard/useBotDashboardViewProps.ts
+++ b/frontend/src/modules/dashboard/useBotDashboardViewProps.ts
@ -176,6 +176,7 @@ export function useBotDashboardViewProps({
    filePickerRef: dashboard.filePickerRef,
    allowedAttachmentExtensions: dashboard.allowedAttachmentExtensions,
    onPickAttachments: dashboard.onPickAttachments,
+    onDropAttachments: dashboard.uploadAttachmentFiles,
    controlCommandPanelOpen: dashboard.controlCommandPanelOpen,
    controlCommandPanelRef: dashboard.controlCommandPanelRef,
    onToggleControlCommandPanel: () => {
--- a/frontend/src/modules/onboarding/BotWizardModule.tsx
+++ b/frontend/src/modules/onboarding/BotWizardModule.tsx
@ -83,7 +83,6 @@ export function BotWizardModule({ onCreated, onGoDashboard, onClose, showHeader
    testProvider,
    testResult,
    updateChannel,
-    updateGlobalDeliveryFlag,
    upsertEnvParam,
  } = useBotWizard({
    ui,
@ -207,12 +206,9 @@ export function BotWizardModule({ onCreated, onGoDashboard, onClose, showHeader
        lc={lc}
        passwordToggleLabels={passwordToggleLabels}
        channels={form.channels}
-        sendProgress={Boolean(form.send_progress)}
-        sendToolHints={Boolean(form.send_tool_hints)}
        addableChannelTypes={addableChannelTypes}
        newChannelType={newChannelType}
        onClose={() => setShowChannelModal(false)}
-        onUpdateGlobalDeliveryFlag={updateGlobalDeliveryFlag}
        onUpdateChannel={updateChannel}
        onRemoveChannel={removeChannel}
        onSetNewChannelType={setNewChannelType}
--- a/frontend/src/modules/onboarding/components/BotWizardChannelModal.tsx
+++ b/frontend/src/modules/onboarding/components/BotWizardChannelModal.tsx
@ -12,12 +12,9 @@ interface BotWizardChannelModalProps {
  lc: OnboardingChannelLabels;
  passwordToggleLabels: { show: string; hide: string };
  channels: WizardChannelConfig[];
-  sendProgress: boolean;
-  sendToolHints: boolean;
  addableChannelTypes: ChannelType[];
  newChannelType: ChannelType | '';
  onClose: () => void;
-  onUpdateGlobalDeliveryFlag: (key: 'sendProgress' | 'sendToolHints', value: boolean) => void;
  onUpdateChannel: (index: number, patch: Partial<WizardChannelConfig>) => void;
  onRemoveChannel: (index: number) => void;
  onSetNewChannelType: (value: ChannelType | '') => void;
@ -135,17 +132,50 @@ function renderChannelFields({
  return null;
 }

+function renderChannelDeliveryFields({
+  channel,
+  idx,
+  lc,
+  onUpdateChannel,
+}: {
+  channel: WizardChannelConfig;
+  idx: number;
+  lc: Pick<OnboardingChannelLabels, 'sendProgress' | 'sendToolHints'>;
+  onUpdateChannel: (index: number, patch: Partial<WizardChannelConfig>) => void;
+}) {
+  const extra = channel.extra_config || {};
+  return (
+    <div className="bot-wizard-switches">
+      <label className="field-label">
+        <input
+          type="checkbox"
+          checked={Boolean(extra.sendProgress)}
+          onChange={(e) => onUpdateChannel(idx, { extra_config: { ...extra, sendProgress: e.target.checked } })}
+          style={{ marginRight: 6 }}
+        />
+        {lc.sendProgress}
+      </label>
+      <label className="field-label">
+        <input
+          type="checkbox"
+          checked={Boolean(extra.sendToolHints)}
+          onChange={(e) => onUpdateChannel(idx, { extra_config: { ...extra, sendToolHints: e.target.checked } })}
+          style={{ marginRight: 6 }}
+        />
+        {lc.sendToolHints}
+      </label>
+    </div>
+  );
+}
+
 export function BotWizardChannelModal({
  open,
  lc,
  passwordToggleLabels,
  channels,
-  sendProgress,
-  sendToolHints,
  addableChannelTypes,
  newChannelType,
  onClose,
-  onUpdateGlobalDeliveryFlag,
  onUpdateChannel,
  onRemoveChannel,
  onSetNewChannelType,
@ -157,19 +187,6 @@ export function BotWizardChannelModal({
    <div className="modal-mask" onClick={onClose}>
      <div className="modal-card modal-wide" onClick={(e) => e.stopPropagation()}>
        <h3>{lc.wizardSectionTitle}</h3>
-        <div className="card">
-          <div className="section-mini-title">{lc.globalDeliveryTitle}</div>
-          <div className="bot-wizard-switches" style={{ marginTop: 8 }}>
-            <label className="field-label">
-              <input type="checkbox" checked={sendProgress} onChange={(e) => onUpdateGlobalDeliveryFlag('sendProgress', e.target.checked)} style={{ marginRight: 6 }} />
-              {lc.sendProgress}
-            </label>
-            <label className="field-label">
-              <input type="checkbox" checked={sendToolHints} onChange={(e) => onUpdateGlobalDeliveryFlag('sendToolHints', e.target.checked)} style={{ marginRight: 6 }} />
-              {lc.sendToolHints}
-            </label>
-          </div>
-        </div>
        <div className="bot-wizard-channel-list">
          {channels.map((channel, idx) => (
            <div key={`${channel.channel_type}-${idx}`} className="card bot-wizard-channel-card bot-wizard-channel-compact">
@ -187,6 +204,7 @@ export function BotWizardChannelModal({
              </div>

              {renderChannelFields({ channel, idx, lc, passwordToggleLabels, onUpdateChannel })}
+              {renderChannelDeliveryFields({ channel, idx, lc, onUpdateChannel })}
            </div>
          ))}
        </div>
--- a/frontend/src/modules/onboarding/hooks/useBotWizard.ts
+++ b/frontend/src/modules/onboarding/hooks/useBotWizard.ts
@ -64,8 +64,8 @@ function clampStorageGb(value: number) {

 function sanitizeChannelExtra(extra: Record<string, unknown>) {
  const next = { ...(extra || {}) };
-  delete next.sendProgress;
-  delete next.sendToolHints;
+  next.sendProgress = Boolean(next.sendProgress);
+  next.sendToolHints = Boolean(next.sendToolHints);
  return next;
 }

@ -349,8 +349,6 @@ export function useBotWizard({
        user_md: form.user_md,
        tools_md: form.tools_md,
        identity_md: form.identity_md,
-        send_progress: Boolean(form.send_progress),
-        send_tool_hints: Boolean(form.send_tool_hints),
        channels: form.channels.map((channel) => ({
          channel_type: channel.channel_type,
          is_active: channel.is_active,
@ -426,7 +424,7 @@ export function useBotWizard({

  const addChannel = () => {
    if (!newChannelType || !addableChannelTypes.includes(newChannelType)) return;
-    const initialExtraConfig = {};
+    const initialExtraConfig = { sendProgress: true, sendToolHints: true };
    setForm((prev) => ({
      ...prev,
      channels: [
@ -458,13 +456,6 @@ export function useBotWizard({
    }));
  };

-  const updateGlobalDeliveryFlag = (key: 'sendProgress' | 'sendToolHints', value: boolean) => {
-    setForm((prev) => {
-      if (key === 'sendProgress') return { ...prev, send_progress: value };
-      return { ...prev, send_tool_hints: value };
-    });
-  };
-
  const upsertEnvParam = (key: string, value: string) => {
    const normalized = String(key || '').trim().toUpperCase();
    if (!normalized) return;
@ -547,7 +538,6 @@ export function useBotWizard({
    testProvider,
    testResult,
    updateChannel,
-    updateGlobalDeliveryFlag,
    upsertEnvParam,
  };
 }
--- a/frontend/src/shared/workspace/useBotWorkspace.ts
+++ b/frontend/src/shared/workspace/useBotWorkspace.ts
@ -192,6 +192,7 @@ export function useBotWorkspace({
    pendingAttachments,
    resetPendingAttachments,
    setPendingAttachments,
+    uploadAttachmentFiles,
  } = useWorkspaceAttachments({
    selectedBotId,
    workspaceCurrentPath,
@ -365,6 +366,7 @@ export function useBotWorkspace({
    resolveWorkspaceMediaSrc,
    saveWorkspacePreviewMarkdown,
    setPendingAttachments,
+    uploadAttachmentFiles,
    setWorkspaceAutoRefresh,
    setWorkspacePreviewDraft,
    setWorkspacePreviewFullscreen,
--- a/frontend/src/shared/workspace/useWorkspaceAttachments.ts
+++ b/frontend/src/shared/workspace/useWorkspaceAttachments.ts
@ -84,9 +84,10 @@ export function useWorkspaceAttachments({
    setAttachmentUploadPercent(null);
  }, [selectedBotId]);

-  const onPickAttachments = useCallback(async (event: ChangeEvent<HTMLInputElement>) => {
-    if (!selectedBotId || !event.target.files || event.target.files.length === 0) return;
-    const files = Array.from(event.target.files);
+  const uploadAttachmentFiles = useCallback(async (inputFiles: File[] | FileList) => {
+    if (!selectedBotId || isUploadingAttachments) return;
+    const files = Array.from(inputFiles);
+    if (files.length === 0) return;
    try {
      const latestAttachmentPolicy = await refreshAttachmentPolicy();
      const effectiveUploadMaxMb = latestAttachmentPolicy.uploadMaxMb;
@ -103,7 +104,6 @@ export function useWorkspaceAttachments({
        if (disallowed.length > 0) {
          const names = disallowed.map((file) => String(file.name || '').trim() || 'unknown').slice(0, 3).join(', ');
          notify(t.uploadTypeNotAllowed(names, effectiveAllowedAttachmentExtensions.join(', ')), { tone: 'warning' });
-          event.target.value = '';
          return;
        }
      }
@ -114,7 +114,6 @@ export function useWorkspaceAttachments({
        if (tooLarge.length > 0) {
          const names = tooLarge.map((file) => String(file.name || '').trim() || 'unknown').slice(0, 3).join(', ');
          notify(t.uploadTooLarge(names, effectiveUploadMaxMb), { tone: 'warning' });
-          event.target.value = '';
          return;
        }
      }
@ -178,9 +177,26 @@ export function useWorkspaceAttachments({
    } finally {
      setIsUploadingAttachments(false);
      setAttachmentUploadPercent(null);
+    }
+  }, [
+    isUploadingAttachments,
+    loadWorkspaceTree,
+    notify,
+    refreshAttachmentPolicy,
+    selectedBotId,
+    setPendingAttachments,
+    t,
+    workspaceCurrentPath,
+  ]);
+
+  const onPickAttachments = useCallback(async (event: ChangeEvent<HTMLInputElement>) => {
+    try {
+      if (!event.target.files || event.target.files.length === 0) return;
+      await uploadAttachmentFiles(event.target.files);
+    } finally {
      event.target.value = '';
    }
-  }, [loadWorkspaceTree, notify, refreshAttachmentPolicy, selectedBotId, setPendingAttachments, t, workspaceCurrentPath]);
+  }, [uploadAttachmentFiles]);

  return {
    attachmentUploadPercent,
@ -189,5 +205,6 @@ export function useWorkspaceAttachments({
    pendingAttachments,
    resetPendingAttachments,
    setPendingAttachments,
+    uploadAttachmentFiles,
  };
 }
--- a/offline/README.md
+++ b/offline/README.md
@ -1,184 +0,0 @@
-# Offline 打包与部署说明
-
-这套离线方案只放在 `offline/` 目录，不改项目原有部署脚本。
-
-## 仓库内文件
-
- `offline/export-offline-bundle.sh`
- `offline/deploy-prod-offline.sh`
- `offline/deploy-full-offline.sh`
- `offline/init-full-db-offline.sh`
- `bot-images/build.sh`
- `bot-images/README.md`
-
-## 1. 如何打包
-
-完整模式：
-
-```bash
-./offline/export-offline-bundle.sh --mode full
-```
-
-生产模式：
-
-```bash
-./offline/export-offline-bundle.sh --mode prod
-```
-
-可选参数：
-
-```bash
-./offline/export-offline-bundle.sh --mode full --env-file .env.full --output-dir offline-dist
-```
-
-说明：
-
- `full` 会导出 `backend`、`nginx`、`postgres`、`redis` 镜像。
- `prod` 只导出 `backend`、`nginx` 镜像，数据库和 Redis 由客户自己提供。
- 导出产物默认放在 `offline-dist/`。
-
-## 2. 打包后会生成什么
-
-每次导出会得到一个目录和一个压缩包，例如：
-
-```text
-offline-dist/dashboard-nanobot-full-offline-YYYYMMDD_HHMMSS/
-offline-dist/dashboard-nanobot-full-offline-YYYYMMDD_HHMMSS.tar.gz
-```
-
-产物根目录主要包含：
-
- `docker-compose.yml`
- `.env`
- `import-images.sh`
- `init-db.sh`
- `start.sh`
- `stop.sh`
- `README.txt`
-
-其中导出的 `docker-compose.yml` 会带中文注释，方便客户直接按注释修改端口、挂载路径、数据库与 Redis 配置。
-
-此外还会带上：
-
- `offline/` 内部离线脚本
- `sql/` 数据库初始化 SQL
- `data/templates/`
- `data/skills/`
- `data/model/`
-
-也就是说，发给客户的是一套部署产物，不需要把源码仓库一起发过去。
-
-## 3. 客户如何部署
-
-客户拿到压缩包后按下面做：
-
-```bash
-tar -xzf dashboard-nanobot-full-offline-YYYYMMDD_HHMMSS.tar.gz
-cd dashboard-nanobot-full-offline-YYYYMMDD_HHMMSS
-./import-images.sh
-```
-
-如果你还另外给了客户 `nanobot-base-v0.1.5.tar.gz` 这类 Bot 基础镜像包，也需要先导入：
-
-```bash
-gunzip -c nanobot-base-v0.1.5.tar.gz | docker load
-```
-
-然后修改：
-
- `.env`
- 如果要改挂载路径，再改 `docker-compose.yml`
-
-再初始化数据库：
-
-```bash
-./init-db.sh
-```
-
-最后启动：
-
-```bash
-./start.sh
-```
-
-停止：
-
-```bash
-./stop.sh
-```
-
-## 4. 客户主要改哪些配置
-
-`.env` 里通常需要改：
-
- `PUBLIC_HOST`
- `NGINX_PORT`
- `HOST_BOTS_WORKSPACE_ROOT`
- `DOCKER_NETWORK_SUBNET`
- `PANEL_ACCESS_PASSWORD`
-
-`prod` 模式额外常改：
-
- `DATABASE_URL`
- `REDIS_ENABLED`
- `REDIS_URL`
-
-`full` 模式额外常改：
-
- `POSTGRES_SUPERPASSWORD`
- `POSTGRES_APP_PASSWORD`
-
-## 5. 挂载路径怎么改
-
-默认挂载关系在导出产物里的 `docker-compose.yml`：
-
- `./data:/app/data`
- `${HOST_BOTS_WORKSPACE_ROOT}:${HOST_BOTS_WORKSPACE_ROOT}`
- `/var/run/docker.sock:/var/run/docker.sock`
-
-如果客户现场要换宿主机路径，直接改产物里的：
-
- `.env` 中的 `HOST_BOTS_WORKSPACE_ROOT`
- `docker-compose.yml` 中的 volume 挂载项
-
-建议：
-
- `HOST_BOTS_WORKSPACE_ROOT` 必须是宿主机绝对路径
- 保留 `/var/run/docker.sock:/var/run/docker.sock`
- `./data` 最好保留在产物目录下，方便整体交付
-
-## 6. 数据库说明
-
-`prod` 模式：
-
- 客户需要提前准备 PostgreSQL
- 推荐直接执行：
-  - `./init-db.sh`
- 这个脚本会自动使用 `.env` 里的 `DATABASE_URL` 执行 `sql/create-tables.sql` 和 `sql/init-data.sql`
- 如果客户想手工执行，也可以执行：
-  - `sql/create-tables.sql`
-  - `sql/init-data.sql`
-
-`full` 模式：
-
- 产物里包含 PostgreSQL 和 Redis 镜像
- `./init-db.sh` 可以手工初始化数据库
- `start.sh` 启动完整栈时也会自动初始化数据库
-
-## 7. Bot 基础镜像说明
-
- 离线部署包里的 `./import-images.sh` 只负责导入当前离线包自带的业务镜像。
- 如果客户现场还需要运行依赖 `nanobot-base` 的 Bot 容器，则还需要额外导入单独提供的 `nanobot-base-*.tar.gz`。
- 导入命令：
-
-```bash
-gunzip -c nanobot-base-v0.1.5.tar.gz | docker load
-```
-
- 如果没有导入这类镜像，Dashboard 主服务可以启动，但相关 Bot 运行时容器可能会因为缺少基础镜像而启动失败。
-
-## 8. 看哪份文档
-
- 研发/打包同学看本文件：`offline/README.md`
- 客户部署时看导出产物根目录里的：`README.txt`
- 如果要单独构建和导出 `nanobot-base` 镜像，看：`bot-images/README.md`
--- a/offline/deploy-full-offline.sh
+++ b/offline/deploy-full-offline.sh
@ -1,177 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-ROOT_DIR="$(cd "$(dirname "$0")/.." && pwd)"
-ENV_FILE="${1:-$ROOT_DIR/.env}"
-COMPOSE_FILE="$ROOT_DIR/docker-compose.yml"
-DATA_DIR="$ROOT_DIR/data"
-INIT_DB_SCRIPT="$ROOT_DIR/offline/init-full-db-offline.sh"
-AGENT_TEMPLATES_FILE="$DATA_DIR/templates/agent_md_templates.json"
-TOPIC_PRESETS_FILE="$DATA_DIR/templates/topic_presets.json"
-SKILLS_DIR="$DATA_DIR/skills"
-
-if [[ ! -f "$ENV_FILE" && -f "$ROOT_DIR/.env.full" ]]; then
-  ENV_FILE="$ROOT_DIR/.env.full"
-fi
-
-if [[ ! -f "$COMPOSE_FILE" && -f "$ROOT_DIR/docker-compose.full.yml" ]]; then
-  COMPOSE_FILE="$ROOT_DIR/docker-compose.full.yml"
-fi
-
-require_file() {
-  local path="$1"
-  local hint="${2:-}"
-  if [[ -f "$path" ]]; then
-    return 0
-  fi
-  echo "Missing file: $path"
-  [[ -n "$hint" ]] && echo "$hint"
-  exit 1
-}
-
-require_dir() {
-  local path="$1"
-  local hint="${2:-}"
-  if [[ -d "$path" ]]; then
-    return 0
-  fi
-  echo "Missing directory: $path"
-  [[ -n "$hint" ]] && echo "$hint"
-  exit 1
-}
-
-require_env() {
-  local name="$1"
-  [[ -n "${!name:-}" ]] || { echo "Missing required env: $name"; exit 1; }
-}
-
-read_env_value() {
-  local key="$1"
-  local line=""
-  local value=""
-
-  while IFS= read -r line || [[ -n "$line" ]]; do
-    line="${line%$'\r'}"
-    [[ -z "${line//[[:space:]]/}" ]] && continue
-    [[ "${line#\#}" != "$line" ]] && continue
-    [[ "${line#export }" != "$line" ]] && line="${line#export }"
-    [[ "$line" == "$key="* ]] || continue
-    value="${line#*=}"
-    if [[ "$value" =~ ^\"(.*)\"$ ]]; then
-      value="${BASH_REMATCH[1]}"
-    elif [[ "$value" =~ ^\'(.*)\'$ ]]; then
-      value="${BASH_REMATCH[1]}"
-    fi
-    printf '%s' "$value"
-    return 0
-  done < "$ENV_FILE"
-
-  return 1
-}
-
-load_env_var() {
-  local name="$1"
-  local default_value="${2:-}"
-  local value=""
-  value="$(read_env_value "$name" || true)"
-  if [[ -z "$value" ]]; then
-    value="$default_value"
-  fi
-  printf -v "$name" '%s' "$value"
-}
-
-wait_for_health() {
-  local container_name="$1"
-  local timeout_seconds="$2"
-  local elapsed=0
-  local status=""
-
-  while (( elapsed < timeout_seconds )); do
-    status="$(
-      docker inspect --format '{{if .State.Health}}{{.State.Health.Status}}{{else}}{{.State.Status}}{{end}}' "$container_name" 2>/dev/null || true
-    )"
-    if [[ "$status" == "healthy" || "$status" == "running" ]]; then
-      echo "[deploy-full-offline] $container_name is $status"
-      return 0
-    fi
-    sleep 2
-    elapsed=$((elapsed + 2))
-  done
-
-  echo "[deploy-full-offline] timed out waiting for $container_name (last status: ${status:-unknown})"
-  docker logs --tail 80 "$container_name" 2>/dev/null || true
-  exit 1
-}
-
-require_file "$ENV_FILE" "Expected bundle config file such as .env"
-require_file "$COMPOSE_FILE"
-require_file "$INIT_DB_SCRIPT"
-require_file "$AGENT_TEMPLATES_FILE"
-require_file "$TOPIC_PRESETS_FILE"
-require_dir "$SKILLS_DIR"
-
-load_env_var HOST_BOTS_WORKSPACE_ROOT
-load_env_var POSTGRES_SUPERUSER postgres
-load_env_var POSTGRES_SUPERPASSWORD
-load_env_var POSTGRES_BOOTSTRAP_DB postgres
-load_env_var POSTGRES_APP_DB
-load_env_var POSTGRES_APP_USER
-load_env_var POSTGRES_APP_PASSWORD
-load_env_var NGINX_PORT 8080
-load_env_var PUBLIC_HOST ""
-
-require_env HOST_BOTS_WORKSPACE_ROOT
-require_env POSTGRES_SUPERUSER
-require_env POSTGRES_SUPERPASSWORD
-require_env POSTGRES_BOOTSTRAP_DB
-require_env POSTGRES_APP_DB
-require_env POSTGRES_APP_USER
-require_env POSTGRES_APP_PASSWORD
-require_env NGINX_PORT
-
-case "$HOST_BOTS_WORKSPACE_ROOT" in
-  /*) ;;
-  *)
-    echo "HOST_BOTS_WORKSPACE_ROOT must be an absolute host path: $HOST_BOTS_WORKSPACE_ROOT"
-    exit 1
-    ;;
-esac
-
-if [[ ! -S /var/run/docker.sock ]]; then
-  echo "Missing required mount source: /var/run/docker.sock"
-  exit 1
-fi
-
-echo "[deploy-full-offline] using env: $ENV_FILE"
-mkdir -p \
-  "$DATA_DIR" \
-  "$DATA_DIR/postgres" \
-  "$DATA_DIR/redis" \
-  "$DATA_DIR/model" \
-  "$HOST_BOTS_WORKSPACE_ROOT"
-
-docker compose --env-file "$ENV_FILE" -f "$COMPOSE_FILE" config -q
-
-echo "[deploy-full-offline] starting postgres and redis"
-docker compose --env-file "$ENV_FILE" -f "$COMPOSE_FILE" up -d postgres redis
-
-wait_for_health "dashboard-nanobot-postgres" 120
-wait_for_health "dashboard-nanobot-redis" 60
-
-echo "[deploy-full-offline] initializing application database"
-"$INIT_DB_SCRIPT" "$ENV_FILE"
-
-echo "[deploy-full-offline] starting backend and nginx"
-docker compose --env-file "$ENV_FILE" -f "$COMPOSE_FILE" up -d backend nginx
-
-wait_for_health "dashboard-nanobot-backend" 180
-wait_for_health "dashboard-nanobot-nginx" 120
-
-echo "[deploy-full-offline] service status"
-docker compose --env-file "$ENV_FILE" -f "$COMPOSE_FILE" ps
-
-if [[ -n "$PUBLIC_HOST" ]]; then
-  echo "[deploy-full-offline] open: http://${PUBLIC_HOST}:${NGINX_PORT}"
-fi
-
-echo "[deploy-full-offline] done"
--- a/offline/deploy-prod-offline.sh
+++ b/offline/deploy-prod-offline.sh
@ -1,142 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-ROOT_DIR="$(cd "$(dirname "$0")/.." && pwd)"
-ENV_FILE="${1:-$ROOT_DIR/.env}"
-DATA_DIR="$ROOT_DIR/data"
-COMPOSE_FILE="$ROOT_DIR/docker-compose.yml"
-AGENT_TEMPLATES_FILE="$DATA_DIR/templates/agent_md_templates.json"
-TOPIC_PRESETS_FILE="$DATA_DIR/templates/topic_presets.json"
-SKILLS_DIR="$DATA_DIR/skills"
-
-if [[ ! -f "$ENV_FILE" && -f "$ROOT_DIR/.env.prod" ]]; then
-  ENV_FILE="$ROOT_DIR/.env.prod"
-fi
-
-if [[ ! -f "$COMPOSE_FILE" && -f "$ROOT_DIR/docker-compose.prod.yml" ]]; then
-  COMPOSE_FILE="$ROOT_DIR/docker-compose.prod.yml"
-fi
-
-require_file() {
-  local path="$1"
-  local hint="${2:-}"
-  if [[ -f "$path" ]]; then
-    return 0
-  fi
-  echo "Missing file: $path"
-  [[ -n "$hint" ]] && echo "$hint"
-  exit 1
-}
-
-require_dir() {
-  local path="$1"
-  local hint="${2:-}"
-  if [[ -d "$path" ]]; then
-    return 0
-  fi
-  echo "Missing directory: $path"
-  [[ -n "$hint" ]] && echo "$hint"
-  exit 1
-}
-
-require_env() {
-  local name="$1"
-  [[ -n "${!name:-}" ]] || { echo "Missing required env: $name"; exit 1; }
-}
-
-read_env_value() {
-  local key="$1"
-  local line=""
-  local value=""
-
-  while IFS= read -r line || [[ -n "$line" ]]; do
-    line="${line%$'\r'}"
-    [[ -z "${line//[[:space:]]/}" ]] && continue
-    [[ "${line#\#}" != "$line" ]] && continue
-    [[ "${line#export }" != "$line" ]] && line="${line#export }"
-    [[ "$line" == "$key="* ]] || continue
-    value="${line#*=}"
-    if [[ "$value" =~ ^\"(.*)\"$ ]]; then
-      value="${BASH_REMATCH[1]}"
-    elif [[ "$value" =~ ^\'(.*)\'$ ]]; then
-      value="${BASH_REMATCH[1]}"
-    fi
-    printf '%s' "$value"
-    return 0
-  done < "$ENV_FILE"
-
-  return 1
-}
-
-load_env_var() {
-  local name="$1"
-  local default_value="${2:-}"
-  local value=""
-  value="$(read_env_value "$name" || true)"
-  if [[ -z "$value" ]]; then
-    value="$default_value"
-  fi
-  printf -v "$name" '%s' "$value"
-}
-
-is_truthy() {
-  local value="${1:-}"
-  value="$(printf '%s' "$value" | tr '[:upper:]' '[:lower:]')"
-  [[ "$value" =~ ^(1|true|yes|on)$ ]]
-}
-
-require_file "$ENV_FILE" "Expected bundle config file such as .env"
-require_file "$COMPOSE_FILE"
-require_file "$AGENT_TEMPLATES_FILE"
-require_file "$TOPIC_PRESETS_FILE"
-require_dir "$SKILLS_DIR"
-
-load_env_var HOST_BOTS_WORKSPACE_ROOT
-load_env_var DATABASE_URL
-load_env_var NGINX_PORT 8080
-load_env_var REDIS_ENABLED false
-load_env_var REDIS_URL
-load_env_var PUBLIC_HOST ""
-
-require_env HOST_BOTS_WORKSPACE_ROOT
-require_env DATABASE_URL
-require_env NGINX_PORT
-
-case "$HOST_BOTS_WORKSPACE_ROOT" in
-  /*) ;;
-  *)
-    echo "HOST_BOTS_WORKSPACE_ROOT must be an absolute host path: $HOST_BOTS_WORKSPACE_ROOT"
-    exit 1
-    ;;
-esac
-
-if [[ ! -S /var/run/docker.sock ]]; then
-  echo "Missing required mount source: /var/run/docker.sock"
-  exit 1
-fi
-
-if [[ "$DATABASE_URL" != postgresql* ]]; then
-  echo "Unsupported DATABASE_URL for deploy-prod-offline.sh: $DATABASE_URL"
-  exit 1
-fi
-
-if is_truthy "$REDIS_ENABLED" && [[ -z "$REDIS_URL" ]]; then
-  echo "Missing required env: REDIS_URL"
-  exit 1
-fi
-
-echo "[deploy-prod-offline] using env: $ENV_FILE"
-mkdir -p "$DATA_DIR" "$DATA_DIR/model" "$HOST_BOTS_WORKSPACE_ROOT"
-
-echo "[deploy-prod-offline] expecting external PostgreSQL to be pre-initialized with sql/create-tables.sql and sql/init-data.sql, or by running ./init-db.sh"
-docker compose --env-file "$ENV_FILE" -f "$COMPOSE_FILE" config -q
-docker compose --env-file "$ENV_FILE" -f "$COMPOSE_FILE" up -d
-
-echo "[deploy-prod-offline] service status"
-docker compose --env-file "$ENV_FILE" -f "$COMPOSE_FILE" ps
-
-if [[ -n "$PUBLIC_HOST" ]]; then
-  echo "[deploy-prod-offline] open: http://${PUBLIC_HOST}:${NGINX_PORT}"
-fi
-
-echo "[deploy-prod-offline] done"
--- a/offline/export-offline-bundle.sh
+++ b/offline/export-offline-bundle.sh
@ -1,459 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-ROOT_DIR="$(cd "$(dirname "$0")/.." && pwd)"
-MODE="full"
-ENV_FILE=""
-OUTPUT_DIR="$ROOT_DIR/offline-dist"
-VERSION="$(date +"%Y%m%d_%H%M%S")"
-
-usage() {
-  cat <<EOF
-Usage: $(basename "$0") [--mode full|prod] [--env-file path] [--output-dir path]
-
-Options:
-  --mode        Export deployment bundle for full or prod mode. Default: full
-  --env-file    Compose env file used for image tags and build args.
-  --output-dir  Output directory for offline bundles. Default: offline-dist
-  -h, --help    Show this help message.
-EOF
-}
-
-parse_args() {
-  while (( $# > 0 )); do
-    case "$1" in
-      --mode)
-        [[ $# -ge 2 ]] || { echo "Missing value for --mode"; exit 1; }
-        MODE="$2"
-        shift
-        ;;
-      --env-file)
-        [[ $# -ge 2 ]] || { echo "Missing value for --env-file"; exit 1; }
-        ENV_FILE="$2"
-        shift
-        ;;
-      --output-dir)
-        [[ $# -ge 2 ]] || { echo "Missing value for --output-dir"; exit 1; }
-        OUTPUT_DIR="$2"
-        shift
-        ;;
-      -h|--help)
-        usage
-        exit 0
-        ;;
-      *)
-        echo "Unexpected argument: $1"
-        usage
-        exit 1
-        ;;
-    esac
-    shift
-  done
-}
-
-require_file() {
-  local path="$1"
-  [[ -f "$path" ]] || { echo "Missing file: $path"; exit 1; }
-}
-
-require_dir() {
-  local path="$1"
-  [[ -d "$path" ]] || { echo "Missing directory: $path"; exit 1; }
-}
-
-read_env_value() {
-  local env_path="$1"
-  local key="$2"
-  local line=""
-  local value=""
-
-  while IFS= read -r line || [[ -n "$line" ]]; do
-    line="${line%$'\r'}"
-    [[ -z "${line//[[:space:]]/}" ]] && continue
-    [[ "${line#\#}" != "$line" ]] && continue
-    [[ "${line#export }" != "$line" ]] && line="${line#export }"
-    [[ "$line" == "$key="* ]] || continue
-    value="${line#*=}"
-    if [[ "$value" =~ ^\"(.*)\"$ ]]; then
-      value="${BASH_REMATCH[1]}"
-    elif [[ "$value" =~ ^\'(.*)\'$ ]]; then
-      value="${BASH_REMATCH[1]}"
-    fi
-    printf '%s' "$value"
-    return 0
-  done < "$env_path"
-
-  return 1
-}
-
-load_env_value() {
-  local key="$1"
-  local default_value="${2:-}"
-  local value=""
-
-  value="$(read_env_value "$ENV_FILE" "$key" || true)"
-  if [[ -z "$value" ]]; then
-    value="$default_value"
-  fi
-  printf '%s' "$value"
-}
-
-ensure_image_available() {
-  local image_ref="$1"
-  if docker image inspect "$image_ref" >/dev/null 2>&1; then
-    return 0
-  fi
-  echo "[export] local image not found, pulling: $image_ref"
-  docker pull "$image_ref"
-}
-
-copy_into_bundle() {
-  local src="$1"
-  local dst="$BUNDLE_DIR/$1"
-  mkdir -p "$(dirname "$dst")"
-  if [[ -d "$ROOT_DIR/$src" ]]; then
-    cp -R "$ROOT_DIR/$src" "$dst"
-  else
-    cp "$ROOT_DIR/$src" "$dst"
-  fi
-}
-
-write_bundle_compose() {
-  cp "$ROOT_DIR/docker-compose.$MODE.yml" "$BUNDLE_DIR/docker-compose.yml"
-}
-
-copy_sql_bundle() {
-  mkdir -p "$BUNDLE_DIR/sql"
-  cp "$ROOT_DIR/scripts/sql/create-tables.sql" "$BUNDLE_DIR/sql/"
-  cp "$ROOT_DIR/scripts/sql/init-data.sql" "$BUNDLE_DIR/sql/"
-
-  if [[ "$MODE" == "full" ]]; then
-    cp "$ROOT_DIR/scripts/sql/init-postgres-bootstrap.sql" "$BUNDLE_DIR/sql/"
-    cp "$ROOT_DIR/scripts/sql/init-postgres-app.sql" "$BUNDLE_DIR/sql/"
-  fi
-}
-
-upsert_env_file() {
-  local file="$1"
-  local key="$2"
-  local value="$3"
-  local tmp_file=""
-
-  tmp_file="$(mktemp)"
-  awk -v key="$key" -v value="$value" '
-    BEGIN { updated = 0 }
-    {
-      if ($0 ~ "^[[:space:]]*#") {
-        print
-        next
-      }
-      if ($0 ~ "^" key "=") {
-        print key "=" value
-        updated = 1
-        next
-      }
-      print
-    }
-    END {
-      if (!updated) {
-        print key "=" value
-      }
-    }
-  ' "$file" > "$tmp_file"
-  mv "$tmp_file" "$file"
-}
-
-prepare_bundle_env() {
-  local target="$BUNDLE_DIR/${ROOT_ENV_FILE}"
-
-  cp "$ROOT_DIR/.env.$MODE.example" "$target"
-  {
-    echo ""
-    echo "# Offline bundle helper field."
-    echo "# Used only for README / start script output."
-    echo "PUBLIC_HOST=127.0.0.1"
-  } >> "$target"
-
-  upsert_env_file "$target" "BACKEND_IMAGE_TAG" "$BACKEND_IMAGE_TAG"
-  upsert_env_file "$target" "FRONTEND_IMAGE_TAG" "$FRONTEND_IMAGE_TAG"
-  upsert_env_file "$target" "NGINX_PORT" "$(load_env_value NGINX_PORT 8080)"
-  upsert_env_file "$target" "HOST_BOTS_WORKSPACE_ROOT" "$(load_env_value HOST_BOTS_WORKSPACE_ROOT /opt/dashboard-nanobot/workspace/bots)"
-  upsert_env_file "$target" "DOCKER_NETWORK_NAME" "$(load_env_value DOCKER_NETWORK_NAME dashboard-nanobot-network)"
-  upsert_env_file "$target" "DOCKER_NETWORK_SUBNET" "$(load_env_value DOCKER_NETWORK_SUBNET 172.20.0.0/16)"
-  upsert_env_file "$target" "PANEL_ACCESS_PASSWORD" "$(load_env_value PANEL_ACCESS_PASSWORD change_me_panel_password)"
-
-  if [[ "$MODE" == "prod" ]]; then
-    upsert_env_file "$target" "DATABASE_URL" "$(load_env_value DATABASE_URL postgresql+psycopg://postgres:change_me_db_password@127.0.0.1:5432/nanobot)"
-    upsert_env_file "$target" "REDIS_ENABLED" "$(load_env_value REDIS_ENABLED true)"
-    upsert_env_file "$target" "REDIS_URL" "$(load_env_value REDIS_URL redis://127.0.0.1:6379/8)"
-  else
-    upsert_env_file "$target" "POSTGRES_IMAGE" "$POSTGRES_IMAGE"
-    upsert_env_file "$target" "REDIS_IMAGE" "$REDIS_IMAGE"
-    upsert_env_file "$target" "POSTGRES_SUPERPASSWORD" "$(load_env_value POSTGRES_SUPERPASSWORD change_me_pg_super_password)"
-    upsert_env_file "$target" "POSTGRES_APP_PASSWORD" "$(load_env_value POSTGRES_APP_PASSWORD change_me_nanobot_password)"
-  fi
-}
-
-write_root_helper_scripts() {
-  cat > "$BUNDLE_DIR/import-images.sh" <<EOF
-#!/usr/bin/env bash
-set -euo pipefail
-
-SCRIPT_DIR="\$(cd "\$(dirname "\$0")" && pwd)"
-IMAGE_ARCHIVE="\$SCRIPT_DIR/${IMAGE_ARCHIVE}"
-
-if [[ ! -f "\$IMAGE_ARCHIVE" ]]; then
-  echo "Missing image archive: \$IMAGE_ARCHIVE"
-  exit 1
-fi
-
-echo "[import-images] loading images from ${IMAGE_ARCHIVE}"
-gunzip -c "\$IMAGE_ARCHIVE" | docker load
-echo "[import-images] done"
-EOF
-
-  cat > "$BUNDLE_DIR/init-db.sh" <<EOF
-#!/usr/bin/env bash
-set -euo pipefail
-
-SCRIPT_DIR="\$(cd "\$(dirname "\$0")" && pwd)"
-ENV_FILE="\$SCRIPT_DIR/${ROOT_ENV_FILE}"
-
-if [[ ! -f "\$ENV_FILE" ]]; then
-  echo "Missing env file: \$ENV_FILE"
-  exit 1
-fi
-
-if [[ "${MODE}" == "prod" ]]; then
-  if [[ ! -f "\$SCRIPT_DIR/offline/init-prod-db-offline.sh" ]]; then
-    echo "Missing script: \$SCRIPT_DIR/offline/init-prod-db-offline.sh"
-    exit 1
-  fi
-  "\$SCRIPT_DIR/offline/init-prod-db-offline.sh" "\$ENV_FILE"
-else
-  if [[ ! -f "\$SCRIPT_DIR/offline/init-full-db-offline.sh" ]]; then
-    echo "Missing script: \$SCRIPT_DIR/offline/init-full-db-offline.sh"
-    exit 1
-  fi
-  "\$SCRIPT_DIR/offline/init-full-db-offline.sh" "\$ENV_FILE"
-fi
-EOF
-
-  cat > "$BUNDLE_DIR/start.sh" <<EOF
-#!/usr/bin/env bash
-set -euo pipefail
-
-SCRIPT_DIR="\$(cd "\$(dirname "\$0")" && pwd)"
-ENV_FILE="\$SCRIPT_DIR/${ROOT_ENV_FILE}"
-
-if [[ ! -f "\$ENV_FILE" ]]; then
-  echo "Missing env file: \$ENV_FILE"
-  exit 1
-fi
-
-"\$SCRIPT_DIR/offline/deploy-${MODE}-offline.sh" "\$ENV_FILE"
-EOF
-
-  cat > "$BUNDLE_DIR/stop.sh" <<EOF
-#!/usr/bin/env bash
-set -euo pipefail
-
-SCRIPT_DIR="\$(cd "\$(dirname "\$0")" && pwd)"
-ENV_FILE="\$SCRIPT_DIR/${ROOT_ENV_FILE}"
-
-if [[ ! -f "\$ENV_FILE" ]]; then
-  echo "Missing env file: \$ENV_FILE"
-  exit 1
-fi
-
-docker compose --env-file "\$ENV_FILE" -f "\$SCRIPT_DIR/docker-compose.yml" down
-EOF
-
-  chmod +x \
-    "$BUNDLE_DIR/import-images.sh" \
-    "$BUNDLE_DIR/init-db.sh" \
-    "$BUNDLE_DIR/start.sh" \
-    "$BUNDLE_DIR/stop.sh"
-}
-
-write_bundle_readme() {
-  cat > "$BUNDLE_DIR/README.txt" <<EOF
-Dashboard Nanobot Offline Bundle
-Mode: ${MODE}
-Version: ${VERSION}
-
-This directory is ready to send directly to the customer.
-
-Included:
- ${IMAGE_ARCHIVE}
- ${ROOT_ENV_FILE}
- docker-compose.yml
- import-images.sh
- init-db.sh
- start.sh
- stop.sh
- offline/
- sql/
- data/templates/
- data/skills/
- data/model/
-
-Customer Quick Start:
-1. Extract this bundle on the target server.
-2. Import images:
-   ./import-images.sh
-3. If a separate bot base image archive was also provided, import it before startup:
-   gunzip -c nanobot-base-<version>.tar.gz | docker load
-4. Edit config:
-   ${ROOT_ENV_FILE}
-5. Initialize database:
-   ./init-db.sh
-6. Start service:
-   ./start.sh
-7. Stop service:
-   ./stop.sh
-
-Fields customer usually needs to edit:
- PUBLIC_HOST
- NGINX_PORT
- HOST_BOTS_WORKSPACE_ROOT
- DOCKER_NETWORK_SUBNET
- PANEL_ACCESS_PASSWORD
-EOF
-
-  if [[ "$MODE" == "prod" ]]; then
-    cat >> "$BUNDLE_DIR/README.txt" <<EOF
- DATABASE_URL
- REDIS_ENABLED
- REDIS_URL
-
-Prod mode note:
- Customer must prepare external PostgreSQL in advance.
- Customer can run ./init-db.sh to initialize external PostgreSQL automatically.
- If they prefer manual import, run sql/create-tables.sql and sql/init-data.sql before startup.
-EOF
-  else
-    cat >> "$BUNDLE_DIR/README.txt" <<EOF
- POSTGRES_SUPERPASSWORD
- POSTGRES_APP_PASSWORD
-
-Full mode note:
- PostgreSQL and Redis are already included in this bundle.
- ./init-db.sh can initialize the application database manually if needed.
- start.sh will also trigger database initialization during full startup flow.
-EOF
-  fi
-
-  cat >> "$BUNDLE_DIR/README.txt" <<EOF
-
-Access URL:
- http://<PUBLIC_HOST>:<NGINX_PORT>
-
-Mounts used by this deployment:
- ./data -> /app/data
- HOST_BOTS_WORKSPACE_ROOT -> same path inside backend container
- /var/run/docker.sock -> /var/run/docker.sock
-
-Mount note:
- Customer can edit docker-compose.yml directly if they want to change host mount paths.
- If customer also received a separate nanobot-base image archive and does not import it, Bot-related runtime containers may fail to start.
-EOF
-}
-
-parse_args "$@"
-
-case "$MODE" in
-  full|prod)
-    ;;
-  *)
-    echo "Unsupported mode: $MODE"
-    exit 1
-    ;;
-esac
-
-if [[ -z "$ENV_FILE" ]]; then
-  if [[ -f "$ROOT_DIR/.env.$MODE" ]]; then
-    ENV_FILE="$ROOT_DIR/.env.$MODE"
-  else
-    ENV_FILE="$ROOT_DIR/.env.$MODE.example"
-  fi
-fi
-
-COMPOSE_FILE="$ROOT_DIR/docker-compose.$MODE.yml"
-BUNDLE_NAME="dashboard-nanobot-${MODE}-offline-${VERSION}"
-BUNDLE_DIR="$OUTPUT_DIR/$BUNDLE_NAME"
-ARCHIVE_FILE="$OUTPUT_DIR/${BUNDLE_NAME}.tar.gz"
-IMAGE_ARCHIVE="docker-images-${MODE}.tar.gz"
-ROOT_ENV_FILE=".env"
-
-require_file "$ENV_FILE"
-require_file "$COMPOSE_FILE"
-require_file "$ROOT_DIR/offline/deploy-${MODE}-offline.sh"
-require_dir "$ROOT_DIR/data/templates"
-require_dir "$ROOT_DIR/data/skills"
-require_dir "$ROOT_DIR/data/model"
-
-BACKEND_IMAGE_TAG="$(load_env_value BACKEND_IMAGE_TAG latest)"
-FRONTEND_IMAGE_TAG="$(load_env_value FRONTEND_IMAGE_TAG latest)"
-BACKEND_IMAGE="dashboard-nanobot/backend:${BACKEND_IMAGE_TAG}"
-FRONTEND_IMAGE="dashboard-nanobot/nginx:${FRONTEND_IMAGE_TAG}"
-IMAGE_REFS=("$BACKEND_IMAGE" "$FRONTEND_IMAGE")
-
-if [[ "$MODE" == "full" ]]; then
-  POSTGRES_IMAGE="$(load_env_value POSTGRES_IMAGE postgres:16-alpine)"
-  REDIS_IMAGE="$(load_env_value REDIS_IMAGE redis:7-alpine)"
-  IMAGE_REFS+=("$POSTGRES_IMAGE" "$REDIS_IMAGE")
-fi
-
-mkdir -p "$OUTPUT_DIR"
-rm -rf "$BUNDLE_DIR"
-mkdir -p "$BUNDLE_DIR"
-
-echo "=== Export Dashboard Nanobot Offline Bundle ==="
-echo "[export] mode: $MODE"
-echo "[export] env file: $ENV_FILE"
-echo "[export] bundle dir: $BUNDLE_DIR"
-
-echo "[1/5] validating compose file"
-docker compose --env-file "$ENV_FILE" -f "$COMPOSE_FILE" config -q
-
-echo "[2/5] building backend and nginx images"
-docker compose --env-file "$ENV_FILE" -f "$COMPOSE_FILE" build backend nginx
-
-if [[ "$MODE" == "full" ]]; then
-  echo "[3/5] ensuring dependency images are available"
-  ensure_image_available "$POSTGRES_IMAGE"
-  ensure_image_available "$REDIS_IMAGE"
-else
-  echo "[3/5] prod mode uses external PostgreSQL/Redis"
-fi
-
-echo "[4/5] exporting docker images"
-docker save "${IMAGE_REFS[@]}" | gzip > "$BUNDLE_DIR/$IMAGE_ARCHIVE"
-
-echo "[5/5] collecting deployment files"
-copy_into_bundle "offline/deploy-$MODE-offline.sh"
-copy_into_bundle "data/templates"
-copy_into_bundle "data/skills"
-copy_into_bundle "data/model"
-
-if [[ "$MODE" == "prod" ]]; then
-  copy_into_bundle "offline/init-prod-db-offline.sh"
-fi
-
-if [[ "$MODE" == "full" ]]; then
-  copy_into_bundle "offline/init-full-db-offline.sh"
-fi
-
-copy_sql_bundle
-write_bundle_compose
-prepare_bundle_env
-
-write_root_helper_scripts
-write_bundle_readme
-
-tar -C "$OUTPUT_DIR" -czf "$ARCHIVE_FILE" "$BUNDLE_NAME"
-
-echo "[done] archive: $ARCHIVE_FILE"
-echo "[done] images:"
-printf '  - %s\n' "${IMAGE_REFS[@]}"
--- a/offline/init-full-db-offline.sh
+++ b/offline/init-full-db-offline.sh
@ -1,207 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-ROOT_DIR="$(cd "$(dirname "$0")/.." && pwd)"
-ENV_FILE="${1:-$ROOT_DIR/.env}"
-COMPOSE_FILE="$ROOT_DIR/docker-compose.yml"
-BOOTSTRAP_SQL="$ROOT_DIR/sql/init-postgres-bootstrap.sql"
-APP_SQL="$ROOT_DIR/sql/init-postgres-app.sql"
-SCHEMA_SQL="$ROOT_DIR/sql/create-tables.sql"
-SEED_SQL="$ROOT_DIR/sql/init-data.sql"
-
-if [[ ! -f "$ENV_FILE" && -f "$ROOT_DIR/.env.full" ]]; then
-  ENV_FILE="$ROOT_DIR/.env.full"
-fi
-
-if [[ ! -f "$COMPOSE_FILE" && -f "$ROOT_DIR/docker-compose.full.yml" ]]; then
-  COMPOSE_FILE="$ROOT_DIR/docker-compose.full.yml"
-fi
-
-if [[ ! -f "$BOOTSTRAP_SQL" && -f "$ROOT_DIR/scripts/sql/init-postgres-bootstrap.sql" ]]; then
-  BOOTSTRAP_SQL="$ROOT_DIR/scripts/sql/init-postgres-bootstrap.sql"
-fi
-
-if [[ ! -f "$APP_SQL" && -f "$ROOT_DIR/scripts/sql/init-postgres-app.sql" ]]; then
-  APP_SQL="$ROOT_DIR/scripts/sql/init-postgres-app.sql"
-fi
-
-if [[ ! -f "$SCHEMA_SQL" && -f "$ROOT_DIR/scripts/sql/create-tables.sql" ]]; then
-  SCHEMA_SQL="$ROOT_DIR/scripts/sql/create-tables.sql"
-fi
-
-if [[ ! -f "$SEED_SQL" && -f "$ROOT_DIR/scripts/sql/init-data.sql" ]]; then
-  SEED_SQL="$ROOT_DIR/scripts/sql/init-data.sql"
-fi
-
-require_file() {
-  local path="$1"
-  local hint="${2:-}"
-  if [[ -f "$path" ]]; then
-    return 0
-  fi
-  echo "Missing file: $path"
-  [[ -n "$hint" ]] && echo "$hint"
-  exit 1
-}
-
-require_env() {
-  local name="$1"
-  [[ -n "${!name:-}" ]] || { echo "Missing required env: $name"; exit 1; }
-}
-
-read_env_value() {
-  local key="$1"
-  local line=""
-  local value=""
-
-  while IFS= read -r line || [[ -n "$line" ]]; do
-    line="${line%$'\r'}"
-    [[ -z "${line//[[:space:]]/}" ]] && continue
-    [[ "${line#\#}" != "$line" ]] && continue
-    [[ "${line#export }" != "$line" ]] && line="${line#export }"
-    [[ "$line" == "$key="* ]] || continue
-    value="${line#*=}"
-    if [[ "$value" =~ ^\"(.*)\"$ ]]; then
-      value="${BASH_REMATCH[1]}"
-    elif [[ "$value" =~ ^\'(.*)\'$ ]]; then
-      value="${BASH_REMATCH[1]}"
-    fi
-    printf '%s' "$value"
-    return 0
-  done < "$ENV_FILE"
-
-  return 1
-}
-
-load_env_var() {
-  local name="$1"
-  local default_value="${2:-}"
-  local value=""
-  value="$(read_env_value "$name" || true)"
-  if [[ -z "$value" ]]; then
-    value="$default_value"
-  fi
-  printf -v "$name" '%s' "$value"
-}
-
-is_truthy() {
-  local value="${1:-}"
-  value="$(printf '%s' "$value" | tr '[:upper:]' '[:lower:]')"
-  [[ "$value" =~ ^(1|true|yes|on)$ ]]
-}
-
-wait_for_postgres() {
-  local timeout_seconds="${1:-120}"
-  local elapsed=0
-
-  while (( elapsed < timeout_seconds )); do
-    if docker compose --env-file "$ENV_FILE" -f "$COMPOSE_FILE" exec -T \
-      -e PGPASSWORD="$POSTGRES_SUPERPASSWORD" \
-      postgres \
-      pg_isready -U "$POSTGRES_SUPERUSER" -d "$POSTGRES_BOOTSTRAP_DB" >/dev/null 2>&1; then
-      return 0
-    fi
-    sleep 2
-    elapsed=$((elapsed + 2))
-  done
-
-  echo "[init-full-db-offline] timed out waiting for postgres"
-  docker compose --env-file "$ENV_FILE" -f "$COMPOSE_FILE" logs --tail 100 postgres || true
-  exit 1
-}
-
-require_file "$ENV_FILE" "Expected bundle config file such as .env"
-require_file "$COMPOSE_FILE"
-require_file "$BOOTSTRAP_SQL"
-require_file "$APP_SQL"
-require_file "$SCHEMA_SQL"
-require_file "$SEED_SQL"
-
-load_env_var POSTGRES_SUPERUSER postgres
-load_env_var POSTGRES_SUPERPASSWORD
-load_env_var POSTGRES_BOOTSTRAP_DB postgres
-load_env_var POSTGRES_APP_DB
-load_env_var POSTGRES_APP_USER
-load_env_var POSTGRES_APP_PASSWORD
-load_env_var UPLOAD_MAX_MB 100
-load_env_var STT_ENABLED true
-
-require_env POSTGRES_SUPERUSER
-require_env POSTGRES_SUPERPASSWORD
-require_env POSTGRES_BOOTSTRAP_DB
-require_env POSTGRES_APP_DB
-require_env POSTGRES_APP_USER
-require_env POSTGRES_APP_PASSWORD
-
-docker compose --env-file "$ENV_FILE" -f "$COMPOSE_FILE" up -d postgres >/dev/null
-
-wait_for_postgres 120
-
-echo "[init-full-db-offline] ensuring role/database exist"
-docker compose --env-file "$ENV_FILE" -f "$COMPOSE_FILE" exec -T \
-  -e PGPASSWORD="$POSTGRES_SUPERPASSWORD" \
-  postgres \
-  psql \
-  -v ON_ERROR_STOP=1 \
-  -v app_db="$POSTGRES_APP_DB" \
-  -v app_user="$POSTGRES_APP_USER" \
-  -v app_password="$POSTGRES_APP_PASSWORD" \
-  -U "$POSTGRES_SUPERUSER" \
-  -d "$POSTGRES_BOOTSTRAP_DB" \
-  -f - < "$BOOTSTRAP_SQL"
-
-echo "[init-full-db-offline] ensuring schema privileges in $POSTGRES_APP_DB"
-docker compose --env-file "$ENV_FILE" -f "$COMPOSE_FILE" exec -T \
-  -e PGPASSWORD="$POSTGRES_SUPERPASSWORD" \
-  postgres \
-  psql \
-  -v ON_ERROR_STOP=1 \
-  -v app_user="$POSTGRES_APP_USER" \
-  -U "$POSTGRES_SUPERUSER" \
-  -d "$POSTGRES_APP_DB" \
-  -f - < "$APP_SQL"
-
-echo "[init-full-db-offline] applying application schema"
-docker compose --env-file "$ENV_FILE" -f "$COMPOSE_FILE" exec -T \
-  -e PGPASSWORD="$POSTGRES_SUPERPASSWORD" \
-  postgres \
-  psql \
-  -v ON_ERROR_STOP=1 \
-  -U "$POSTGRES_SUPERUSER" \
-  -d "$POSTGRES_APP_DB" \
-  -f - < "$SCHEMA_SQL"
-
-PAGE_SIZE_JSON="10"
-CHAT_PULL_PAGE_SIZE_JSON="60"
-AUTH_TOKEN_TTL_HOURS_JSON="24"
-AUTH_TOKEN_MAX_ACTIVE_JSON="2"
-UPLOAD_MAX_MB_JSON="$UPLOAD_MAX_MB"
-ALLOWED_ATTACHMENT_EXTENSIONS_JSON="[]"
-WORKSPACE_DOWNLOAD_EXTENSIONS_JSON='[".pdf", ".doc", ".docx", ".xls", ".xlsx", ".xlsm", ".ppt", ".pptx", ".odt", ".ods", ".odp", ".wps"]'
-if is_truthy "$STT_ENABLED"; then
-  SPEECH_ENABLED_JSON="true"
-else
-  SPEECH_ENABLED_JSON="false"
-fi
-ACTIVITY_EVENT_RETENTION_DAYS_JSON="7"
-
-echo "[init-full-db-offline] applying initial data"
-docker compose --env-file "$ENV_FILE" -f "$COMPOSE_FILE" exec -T \
-  -e PGPASSWORD="$POSTGRES_SUPERPASSWORD" \
-  postgres \
-  psql \
-  -v ON_ERROR_STOP=1 \
-  -v page_size_json="$PAGE_SIZE_JSON" \
-  -v chat_pull_page_size_json="$CHAT_PULL_PAGE_SIZE_JSON" \
-  -v auth_token_ttl_hours_json="$AUTH_TOKEN_TTL_HOURS_JSON" \
-  -v auth_token_max_active_json="$AUTH_TOKEN_MAX_ACTIVE_JSON" \
-  -v upload_max_mb_json="$UPLOAD_MAX_MB_JSON" \
-  -v allowed_attachment_extensions_json="$ALLOWED_ATTACHMENT_EXTENSIONS_JSON" \
-  -v workspace_download_extensions_json="$WORKSPACE_DOWNLOAD_EXTENSIONS_JSON" \
-  -v speech_enabled_json="$SPEECH_ENABLED_JSON" \
-  -v activity_event_retention_days_json="$ACTIVITY_EVENT_RETENTION_DAYS_JSON" \
-  -U "$POSTGRES_SUPERUSER" \
-  -d "$POSTGRES_APP_DB" \
-  -f - < "$SEED_SQL"
-
-echo "[init-full-db-offline] done"
--- a/offline/init-prod-db-offline.sh
+++ b/offline/init-prod-db-offline.sh
@ -1,118 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-ROOT_DIR="$(cd "$(dirname "$0")/.." && pwd)"
-ENV_FILE="${1:-$ROOT_DIR/.env}"
-SCHEMA_SQL="$ROOT_DIR/sql/create-tables.sql"
-SEED_SQL="$ROOT_DIR/sql/init-data.sql"
-
-if [[ ! -f "$ENV_FILE" && -f "$ROOT_DIR/.env.prod" ]]; then
-  ENV_FILE="$ROOT_DIR/.env.prod"
-fi
-
-require_file() {
-  local path="$1"
-  local hint="${2:-}"
-  if [[ -f "$path" ]]; then
-    return 0
-  fi
-  echo "Missing file: $path"
-  [[ -n "$hint" ]] && echo "$hint"
-  exit 1
-}
-
-require_env() {
-  local name="$1"
-  [[ -n "${!name:-}" ]] || { echo "Missing required env: $name"; exit 1; }
-}
-
-read_env_value() {
-  local key="$1"
-  local line=""
-  local value=""
-
-  while IFS= read -r line || [[ -n "$line" ]]; do
-    line="${line%$'\r'}"
-    [[ -z "${line//[[:space:]]/}" ]] && continue
-    [[ "${line#\#}" != "$line" ]] && continue
-    [[ "${line#export }" != "$line" ]] && line="${line#export }"
-    [[ "$line" == "$key="* ]] || continue
-    value="${line#*=}"
-    if [[ "$value" =~ ^\"(.*)\"$ ]]; then
-      value="${BASH_REMATCH[1]}"
-    elif [[ "$value" =~ ^\'(.*)\'$ ]]; then
-      value="${BASH_REMATCH[1]}"
-    fi
-    printf '%s' "$value"
-    return 0
-  done < "$ENV_FILE"
-
-  return 1
-}
-
-load_env_var() {
-  local name="$1"
-  local default_value="${2:-}"
-  local value=""
-  value="$(read_env_value "$name" || true)"
-  if [[ -z "$value" ]]; then
-    value="$default_value"
-  fi
-  printf -v "$name" '%s' "$value"
-}
-
-is_truthy() {
-  local value="${1:-}"
-  value="$(printf '%s' "$value" | tr '[:upper:]' '[:lower:]')"
-  [[ "$value" =~ ^(1|true|yes|on)$ ]]
-}
-
-require_file "$ENV_FILE" "Expected bundle config file such as .env"
-require_file "$SCHEMA_SQL"
-require_file "$SEED_SQL"
-
-if ! command -v psql >/dev/null 2>&1; then
-  echo "Missing command: psql"
-  echo "Please install PostgreSQL client tools on the target host, then rerun ./init-db.sh"
-  exit 1
-fi
-
-load_env_var DATABASE_URL
-load_env_var UPLOAD_MAX_MB 100
-load_env_var STT_ENABLED true
-
-require_env DATABASE_URL
-
-PAGE_SIZE_JSON="10"
-CHAT_PULL_PAGE_SIZE_JSON="60"
-AUTH_TOKEN_TTL_HOURS_JSON="24"
-AUTH_TOKEN_MAX_ACTIVE_JSON="2"
-UPLOAD_MAX_MB_JSON="$UPLOAD_MAX_MB"
-ALLOWED_ATTACHMENT_EXTENSIONS_JSON="[]"
-WORKSPACE_DOWNLOAD_EXTENSIONS_JSON='[".pdf", ".doc", ".docx", ".xls", ".xlsx", ".xlsm", ".ppt", ".pptx", ".odt", ".ods", ".odp", ".wps"]'
-if is_truthy "$STT_ENABLED"; then
-  SPEECH_ENABLED_JSON="true"
-else
-  SPEECH_ENABLED_JSON="false"
-fi
-ACTIVITY_EVENT_RETENTION_DAYS_JSON="7"
-
-echo "[init-prod-db-offline] applying schema with DATABASE_URL"
-psql "$DATABASE_URL" -v ON_ERROR_STOP=1 -f "$SCHEMA_SQL"
-
-echo "[init-prod-db-offline] applying initial data with DATABASE_URL"
-psql \
-  "$DATABASE_URL" \
-  -v ON_ERROR_STOP=1 \
-  -v page_size_json="$PAGE_SIZE_JSON" \
-  -v chat_pull_page_size_json="$CHAT_PULL_PAGE_SIZE_JSON" \
-  -v auth_token_ttl_hours_json="$AUTH_TOKEN_TTL_HOURS_JSON" \
-  -v auth_token_max_active_json="$AUTH_TOKEN_MAX_ACTIVE_JSON" \
-  -v upload_max_mb_json="$UPLOAD_MAX_MB_JSON" \
-  -v allowed_attachment_extensions_json="$ALLOWED_ATTACHMENT_EXTENSIONS_JSON" \
-  -v workspace_download_extensions_json="$WORKSPACE_DOWNLOAD_EXTENSIONS_JSON" \
-  -v speech_enabled_json="$SPEECH_ENABLED_JSON" \
-  -v activity_event_retention_days_json="$ACTIVITY_EVENT_RETENTION_DAYS_JSON" \
-  -f "$SEED_SQL"
-
-echo "[init-prod-db-offline] done"
--- a/scripts/deploy-full.sh
+++ b/scripts/deploy-full.sh
@ -81,6 +81,23 @@ load_env_var() {
  printf -v "$name" '%s' "$value"
 }

+ensure_docker_network() {
+  local network_name="$1"
+  local network_subnet="${2:-}"
+
+  if docker network inspect "$network_name" >/dev/null 2>&1; then
+    echo "[deploy-full] reusing docker network: $network_name"
+    return 0
+  fi
+
+  echo "[deploy-full] creating docker network: $network_name"
+  if [[ -n "$network_subnet" ]]; then
+    docker network create --driver bridge --subnet "$network_subnet" "$network_name" >/dev/null
+  else
+    docker network create --driver bridge "$network_name" >/dev/null
+  fi
+}
+
 wait_for_health() {
  local container_name="$1"
  local timeout_seconds="$2"
@ -119,6 +136,8 @@ load_env_var POSTGRES_APP_DB
 load_env_var POSTGRES_APP_USER
 load_env_var POSTGRES_APP_PASSWORD
 load_env_var NGINX_PORT 8080
+load_env_var DOCKER_NETWORK_NAME dashboard-nanobot-network
+load_env_var DOCKER_NETWORK_SUBNET 172.20.0.0/16

 require_env HOST_BOTS_WORKSPACE_ROOT
 require_env POSTGRES_SUPERUSER
@ -138,6 +157,7 @@ mkdir -p \
  "$HOST_BOTS_WORKSPACE_ROOT"

 docker compose --env-file "$ENV_FILE" -f "$COMPOSE_FILE" config -q
+ensure_docker_network "$DOCKER_NETWORK_NAME" "$DOCKER_NETWORK_SUBNET"

 echo "[deploy-full] starting postgres and redis"
 docker compose --env-file "$ENV_FILE" -f "$COMPOSE_FILE" up -d postgres redis
--- a/scripts/deploy-prod.sh
+++ b/scripts/deploy-prod.sh
@ -80,6 +80,23 @@ load_env_var() {
  printf -v "$name" '%s' "$value"
 }

+ensure_docker_network() {
+  local network_name="$1"
+  local network_subnet="${2:-}"
+
+  if docker network inspect "$network_name" >/dev/null 2>&1; then
+    echo "[deploy] reusing docker network: $network_name"
+    return 0
+  fi
+
+  echo "[deploy] creating docker network: $network_name"
+  if [[ -n "$network_subnet" ]]; then
+    docker network create --driver bridge --subnet "$network_subnet" "$network_name" >/dev/null
+  else
+    docker network create --driver bridge "$network_name" >/dev/null
+  fi
+}
+
 if [[ ! -f "$ENV_FILE" ]]; then
  echo "[WARNING] Missing env file: $ENV_FILE"
  echo "[WARNING] Creating it from: $ROOT_DIR/.env.prod.example ..."
@ -97,6 +114,8 @@ require_dir "$SKILLS_DIR" "Expected tracked skills directory under project-root
 load_env_var HOST_BOTS_WORKSPACE_ROOT
 load_env_var DATABASE_URL
 load_env_var NGINX_PORT 8080
+load_env_var DOCKER_NETWORK_NAME dashboard-nanobot-network
+load_env_var DOCKER_NETWORK_SUBNET 172.20.0.0/16
 load_env_var REDIS_ENABLED false
 load_env_var REDIS_URL

@ -121,6 +140,7 @@ mkdir -p "$DATA_DIR" "$DATA_DIR/model" "$HOST_BOTS_WORKSPACE_ROOT"

 echo "[deploy] expecting external PostgreSQL to be pre-initialized with scripts/sql/create-tables.sql and scripts/sql/init-data.sql"
 docker compose --env-file "$ENV_FILE" -f "$COMPOSE_FILE" config -q
+ensure_docker_network "$DOCKER_NETWORK_NAME" "$DOCKER_NETWORK_SUBNET"
 docker compose --env-file "$ENV_FILE" -f "$COMPOSE_FILE" up -d --build

 echo "[deploy] service status"
--- a/scripts/init-full-db.sh
+++ b/scripts/init-full-db.sh
@ -155,6 +155,7 @@ AUTH_TOKEN_MAX_ACTIVE_JSON="2"
 UPLOAD_MAX_MB_JSON="$UPLOAD_MAX_MB"
 ALLOWED_ATTACHMENT_EXTENSIONS_JSON="[]"
 WORKSPACE_DOWNLOAD_EXTENSIONS_JSON='[".pdf", ".doc", ".docx", ".xls", ".xlsx", ".xlsm", ".ppt", ".pptx", ".odt", ".ods", ".odp", ".wps"]'
+WORKSPACE_PREVIEW_TOKEN_TTL_SECONDS_SEED_JSON="3600"
 if [[ "${STT_ENABLED,,}" =~ ^(1|true|yes|on)$ ]]; then
  SPEECH_ENABLED_JSON="true"
 else
@ -175,6 +176,7 @@ docker compose --env-file "$ENV_FILE" -f "$COMPOSE_FILE" exec -T \
  -v upload_max_mb_json="$UPLOAD_MAX_MB_JSON" \
  -v allowed_attachment_extensions_json="$ALLOWED_ATTACHMENT_EXTENSIONS_JSON" \
  -v workspace_download_extensions_json="$WORKSPACE_DOWNLOAD_EXTENSIONS_JSON" \
+  -v workspace_preview_token_ttl_seconds_json="$WORKSPACE_PREVIEW_TOKEN_TTL_SECONDS_SEED_JSON" \
  -v speech_enabled_json="$SPEECH_ENABLED_JSON" \
  -v activity_event_retention_days_json="$ACTIVITY_EVENT_RETENTION_DAYS_JSON" \
  -U "$POSTGRES_SUPERUSER" \
--- a/scripts/sql/init-data.sql
+++ b/scripts/sql/init-data.sql
@ -1,4 +1,44 @@
 \set ON_ERROR_STOP on
+\if :{?page_size_json}
+\else
+\set page_size_json 10
+\endif
+\if :{?chat_pull_page_size_json}
+\else
+\set chat_pull_page_size_json 60
+\endif
+\if :{?auth_token_ttl_hours_json}
+\else
+\set auth_token_ttl_hours_json 24
+\endif
+\if :{?auth_token_max_active_json}
+\else
+\set auth_token_max_active_json 2
+\endif
+\if :{?upload_max_mb_json}
+\else
+\set upload_max_mb_json 100
+\endif
+\if :{?allowed_attachment_extensions_json}
+\else
+\set allowed_attachment_extensions_json []
+\endif
+\if :{?workspace_download_extensions_json}
+\else
+\set workspace_download_extensions_json '[".pdf", ".doc", ".docx", ".xls", ".xlsx", ".xlsm", ".ppt", ".pptx", ".odt", ".ods", ".odp", ".wps"]'
+\endif
+\if :{?workspace_preview_token_ttl_seconds_json}
+\else
+\set workspace_preview_token_ttl_seconds_json 3600
+\endif
+\if :{?speech_enabled_json}
+\else
+\set speech_enabled_json true
+\endif
+\if :{?activity_event_retention_days_json}
+\else
+\set activity_event_retention_days_json 7
+\endif

 BEGIN;

@ -22,6 +62,7 @@ VALUES
    ('upload_max_mb', '上传大小限制', 'upload', '单文件上传大小限制，单位 MB。', 'integer', :'upload_max_mb_json', FALSE, 20, NOW(), NOW()),
    ('allowed_attachment_extensions', '允许附件后缀', 'upload', '允许上传的附件后缀列表，留空表示不限制。', 'json', :'allowed_attachment_extensions_json', FALSE, 20, NOW(), NOW()),
    ('workspace_download_extensions', '工作区下载后缀', 'workspace', '命中后缀的工作区文件默认走下载模式。', 'json', :'workspace_download_extensions_json', FALSE, 30, NOW(), NOW()),
+    ('workspace_preview_token_ttl_seconds', '工作区预览 Token 过期秒数', 'workspace', 'HTML 预览地址中临时访问 Token 的默认有效时长，单位秒。', 'integer', :'workspace_preview_token_ttl_seconds_json', FALSE, 31, NOW(), NOW()),
    ('speech_enabled', '语音识别开关', 'speech', '控制 Bot 语音转写功能是否启用。', 'boolean', :'speech_enabled_json', TRUE, 32, NOW(), NOW()),
    ('activity_event_retention_days', '活动事件保留天数', 'maintenance', 'bot_activity_event 运维事件的保留天数，超期记录会自动清理。', 'integer', :'activity_event_retention_days_json', FALSE, 34, NOW(), NOW())
 ON CONFLICT (key) DO UPDATE
@ -34,8 +75,6 @@ SET
    sort_order = EXCLUDED.sort_order,
    updated_at = NOW();

-DELETE FROM sys_setting WHERE key = 'command_auto_unlock_seconds';
-
 INSERT INTO skill_market_item (
    skill_key,
    display_name,
Author	SHA1	Message	Date
mula.liu	617e0b2a2a	兼容v0.2.0核心	2026-05-28 14:32:02 +08:00
mula.liu	1c9f66c816	v0.1.6	2026-05-20 14:02:13 +08:00
mula.liu	ec974e6694	修改了部署脚本	2026-05-11 18:31:41 +08:00