兼容v0.2.0核心

.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.
+# Shared Docker network for dashboard and bot containers.
-# Change this if it conflicts with your host LAN / VPN / intranet routing.
+# 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
 

.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.
+# Shared Docker network for dashboard and bot containers.
-# Change this if it conflicts with your host LAN / VPN / intranet routing.
+# 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,

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 就绪
   - 创建或更新业务账号

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.

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")

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():

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"

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_progress = bool(bot_data.get("send_progress", True))
-        send_tool_hints = bool(bot_data.get("send_tool_hints"))
+        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,
+                "sendProgress": True,
-                "sendToolHints": send_tool_hints,
+                "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)

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":

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,
+                "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 False,
+                "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_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 False,
+                "send_tool_hints": bool(payload.send_tool_hints) if payload.send_tool_hints is not None else True,
             },
         )
         record_activity_event(

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 True, True
-    return bool(channels_cfg.get("sendProgress")), bool(channels_cfg.get("sendToolHints"))
+    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": {
+            "extra_config": dashboard_extra,
-                "sendProgress": send_progress,
-                "sendToolHints": send_tool_hints,
-            },
             "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_progress = bool(bot_data.get("send_progress", True))
-    send_tool_hints = bool(bot_data.get("send_tool_hints", False))
+    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"))

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",

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:
+def _missing_required_system_settings(session: Session) -> List[str]:
-    _prune_deprecated_system_settings(session)
     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)

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()

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 \

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`，这样不需要客户再拿源码构建。

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) 扫描本地已有的目录并打包"

docker-compose.full.yml

@@ -1,163 +1,153 @@
-# Dashboard Nanobot Docker 编排文件（Full 模式）
+services:
-# 说明：
+  postgres:
-# 1. 当前文件用于“前端 + 后端 + PostgreSQL + Redis”整套部署。
+    image: ${POSTGRES_IMAGE:-postgres:16-alpine}
-# 2. 数据库和 Redis 都在本 compose 中启动，适合客户没有外部中间件时使用。
+    container_name: dashboard-nanobot-postgres
-# 3. 客户通常需要重点修改 `.env` 里的端口、数据库密码、工作目录路径。
+    restart: unless-stopped
-# 4. 如果需要调整宿主机挂载路径，可以直接修改下方 `volumes`。
+    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 里需要启动的服务
+  redis:
-  postgres: # PostgreSQL 数据库服务
+    image: ${REDIS_IMAGE:-redis:7-alpine}
-    image: ${POSTGRES_IMAGE:-postgres:16-alpine} # PostgreSQL 镜像名
+    container_name: dashboard-nanobot-redis
-    container_name: dashboard-nanobot-postgres # PostgreSQL 容器固定名称
+    restart: unless-stopped
-    restart: unless-stopped # 异常退出后自动拉起
+    environment:
-    environment: # PostgreSQL 启动参数
+      TZ: ${TZ:-Asia/Shanghai}
-      TZ: ${TZ:-Asia/Shanghai} # 容器时区
+    command: ["redis-server", "--appendonly", "yes", "--save", "60", "1000"]
-      POSTGRES_USER: ${POSTGRES_SUPERUSER:-postgres} # PostgreSQL 超级用户
+    volumes:
-      POSTGRES_PASSWORD: ${POSTGRES_SUPERPASSWORD:?POSTGRES_SUPERPASSWORD is required} # PostgreSQL 超级用户密码
+      - ./data/redis:/data
-      POSTGRES_DB: ${POSTGRES_BOOTSTRAP_DB:-postgres} # 启动时默认数据库
+    expose:
-    volumes: # 数据库存储挂载
+      - "6379"
-      - ./data/postgres:/var/lib/postgresql/data # 宿主机数据库目录映射到容器数据目录
+    healthcheck:
-    expose: # 仅对内部网络开放
+      test: ["CMD", "redis-cli", "ping"]
-      - "5432" # PostgreSQL 默认端口
+      interval: 10s
-    healthcheck: # PostgreSQL 健康检查
+      timeout: 5s
-      test: ["CMD-SHELL", "pg_isready -U \"$${POSTGRES_USER}\" -d \"$${POSTGRES_DB}\""] # 检测数据库是否就绪
+      retries: 10
-      interval: 10s # 每 10 秒检查一次
+      start_period: 10s
-      timeout: 5s # 单次检查超时 5 秒
+    logging:
-      retries: 10 # 连续失败 10 次判定不健康
+      driver: json-file
-      start_period: 20s # 启动后预留 20 秒缓冲时间
+      options:
-    logging: # 容器日志策略
+        max-size: "20m"
-      driver: json-file # 使用 Docker 默认 json-file 日志驱动
+        max-file: "3"
-      options: # 日志滚动配置
-        max-size: "20m" # 单个日志文件最大 20MB
-        max-file: "3" # 最多保留 3 个日志文件
 
-  redis: # Redis 缓存服务
+  backend:
-    image: ${REDIS_IMAGE:-redis:7-alpine} # Redis 镜像名
+    build:
-    container_name: dashboard-nanobot-redis # Redis 容器固定名称
+      context: .
-    restart: unless-stopped # 异常退出后自动拉起
+      dockerfile: backend/Dockerfile
-    environment: # Redis 运行环境变量
+      args:
-      TZ: ${TZ:-Asia/Shanghai} # 容器时区
+        PYTHON_BASE_IMAGE: ${PYTHON_BASE_IMAGE:-python:3.12-slim}
-    command: ["redis-server", "--appendonly", "yes", "--save", "60", "1000"] # 开启 AOF 持久化并保留快照策略
+        PIP_INDEX_URL: ${PIP_INDEX_URL:-https://pypi.org/simple}
-    volumes: # Redis 数据挂载
+        PIP_TRUSTED_HOST: ${PIP_TRUSTED_HOST:-}
-      - ./data/redis:/data # 宿主机 Redis 数据目录映射到容器
+    image: dashboard-nanobot/backend:${BACKEND_IMAGE_TAG:-latest}
-    expose: # 仅对内部网络开放
+    container_name: dashboard-nanobot-backend
-      - "6379" # Redis 默认端口
+    restart: unless-stopped
-    healthcheck: # Redis 健康检查
+    depends_on:
-      test: ["CMD", "redis-cli", "ping"] # 检测 Redis 是否响应
+      postgres:
-      interval: 10s # 每 10 秒检查一次
+        condition: service_healthy
-      timeout: 5s # 单次检查超时 5 秒
+      redis:
-      retries: 10 # 连续失败 10 次判定不健康
+        condition: service_healthy
-      start_period: 10s # 启动后预留 10 秒缓冲时间
+    environment:
-    logging: # 容器日志策略
+      TZ: ${TZ:-Asia/Shanghai}
-      driver: json-file # 使用 Docker 默认 json-file 日志驱动
+      APP_HOST: 0.0.0.0
-      options: # 日志滚动配置
+      APP_PORT: 8002
-        max-size: "20m" # 单个日志文件最大 20MB
+      APP_RELOAD: "false"
-        max-file: "3" # 最多保留 3 个日志文件
+      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 服务
+  nginx:
-    build: # 保留构建信息，便于有源码时重新 build；离线部署通常直接用 image
+    build:
-      context: . # 构建上下文为项目根目录
+      context: ./frontend
-      dockerfile: backend/Dockerfile # 后端 Dockerfile 路径
+      dockerfile: Dockerfile
-      args: # 构建参数
+      args:
-        PYTHON_BASE_IMAGE: ${PYTHON_BASE_IMAGE:-python:3.12-slim} # Python 基础镜像
+        NODE_BASE_IMAGE: ${NODE_BASE_IMAGE:-node:22-alpine}
-        PIP_INDEX_URL: ${PIP_INDEX_URL:-https://pypi.org/simple} # pip 源地址
+        NGINX_BASE_IMAGE: ${NGINX_BASE_IMAGE:-nginx:alpine}
-        PIP_TRUSTED_HOST: ${PIP_TRUSTED_HOST:-} # pip 信任主机
+        NPM_REGISTRY: ${NPM_REGISTRY:-https://registry.npmjs.org/}
-    image: dashboard-nanobot/backend:${BACKEND_IMAGE_TAG:-latest} # 后端运行镜像名
+        VITE_API_BASE: /api
-    container_name: dashboard-nanobot-backend # 后端容器固定名称
+        VITE_WS_BASE: /ws/monitor
-    restart: unless-stopped # 异常退出后自动拉起
+    image: dashboard-nanobot/nginx:${FRONTEND_IMAGE_TAG:-latest}
-    depends_on: # 依赖中间件健康后再启动
+    container_name: dashboard-nanobot-nginx
-      postgres: # 依赖 PostgreSQL
+    restart: unless-stopped
-        condition: service_healthy # 要求 PostgreSQL 健康
+    environment:
-      redis: # 依赖 Redis
+      TZ: ${TZ:-Asia/Shanghai}
-        condition: service_healthy # 要求 Redis 健康
+      UPLOAD_MAX_MB: ${UPLOAD_MAX_MB:-100}
-    environment: # 后端环境变量
+    depends_on:
-      TZ: ${TZ:-Asia/Shanghai} # 容器时区
+      backend:
-      APP_HOST: 0.0.0.0 # 服务监听地址，容器内通常保持 0.0.0.0
+        condition: service_healthy
-      APP_PORT: 8000 # 服务监听端口，需与 expose 和健康检查保持一致
+    ports:
-      APP_RELOAD: "false" # 生产环境关闭热重载
+      - "${NGINX_PORT}:80"
-      DATABASE_ECHO: "false" # 生产环境关闭 SQL 日志回显
+    healthcheck:
-      DATABASE_POOL_SIZE: ${DATABASE_POOL_SIZE:-20} # 数据库连接池基础连接数
+      test: ["CMD", "wget", "-q", "-O", "/dev/null", "http://127.0.0.1/"]
-      DATABASE_MAX_OVERFLOW: ${DATABASE_MAX_OVERFLOW:-40} # 连接池额外可溢出连接数
+      interval: 15s
-      DATABASE_POOL_TIMEOUT: ${DATABASE_POOL_TIMEOUT:-30} # 获取连接超时时间（秒）
+      timeout: 5s
-      DATABASE_POOL_RECYCLE: ${DATABASE_POOL_RECYCLE:-1800} # 连接回收周期（秒）
+      retries: 5
-      DATA_ROOT: /app/data # 容器内业务数据目录
+      start_period: 10s
-      BOTS_WORKSPACE_ROOT: ${HOST_BOTS_WORKSPACE_ROOT} # Bot 工作目录，容器内外路径保持一致
+    logging:
-      DOCKER_NETWORK_NAME: ${DOCKER_NETWORK_NAME:-dashboard-nanobot-network} # 业务容器使用的 Docker 网络名称
+      driver: json-file
-      DATABASE_URL: postgresql+psycopg://${POSTGRES_APP_USER}:${POSTGRES_APP_PASSWORD}@postgres:5432/${POSTGRES_APP_DB} # Full 模式固定连接内部 PostgreSQL
+      options:
-      REDIS_ENABLED: ${REDIS_ENABLED:-true} # Full 模式默认启用 Redis
+        max-size: "20m"
-      REDIS_URL: redis://redis:6379/${REDIS_DB:-8} # Full 模式固定连接内部 Redis
+        max-file: "3"
-      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: # 前端 Nginx 服务
+networks:
-    build: # 保留构建信息，离线部署通常直接使用导入镜像
+  default:
-      context: ./frontend # 前端构建上下文
+    name: ${DOCKER_NETWORK_NAME:-dashboard-nanobot-network}
-      dockerfile: Dockerfile # 前端 Dockerfile 路径
+    external: true
-      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} # 自定义子网，现场冲突时可修改

docker-compose.prod.yml

@@ -1,108 +1,98 @@
-# Dashboard Nanobot Docker 编排文件（Prod 模式）
+services:
-# 说明：
+  backend:
-# 1. 当前文件用于“前端 + 后端”部署。
+    build:
-# 2. PostgreSQL 与 Redis 由客户现场外部提供，本文件不会启动这两个服务。
+      context: .
-# 3. 客户通常需要重点修改 `.env` 里的端口、数据库连接串、Redis 连接串、工作目录路径。
+      dockerfile: backend/Dockerfile
-# 4. 如果需要调整宿主机挂载路径，可以直接修改下方 `volumes`。
+      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 里需要启动的服务
+  nginx:
-  backend: # 后端 API 服务
+    build:
-    build: # 保留构建信息，便于有源码时重新 build；离线部署通常直接用 image
+      context: ./frontend
-      context: . # 构建上下文为项目根目录
+      dockerfile: Dockerfile
-      dockerfile: backend/Dockerfile # 后端 Dockerfile 路径
+      args:
-      args: # 构建参数
+        NODE_BASE_IMAGE: ${NODE_BASE_IMAGE:-node:22-alpine}
-        PYTHON_BASE_IMAGE: ${PYTHON_BASE_IMAGE:-python:3.12-slim} # Python 基础镜像
+        NGINX_BASE_IMAGE: ${NGINX_BASE_IMAGE:-nginx:alpine}
-        PIP_INDEX_URL: ${PIP_INDEX_URL:-https://pypi.org/simple} # pip 源地址
+        NPM_REGISTRY: ${NPM_REGISTRY:-https://registry.npmjs.org/}
-        PIP_TRUSTED_HOST: ${PIP_TRUSTED_HOST:-} # pip 信任主机
+        VITE_API_BASE: /api
-    image: dashboard-nanobot/backend:${BACKEND_IMAGE_TAG:-latest} # 后端运行镜像名
+        VITE_WS_BASE: /ws/monitor
-    container_name: dashboard-nanobot-backend # 后端容器固定名称
+    image: dashboard-nanobot/nginx:${FRONTEND_IMAGE_TAG:-latest}
-    restart: unless-stopped # 异常退出后自动拉起，手动停止时不自动启动
+    container_name: dashboard-nanobot-nginx
-    environment: # 后端环境变量
+    restart: unless-stopped
-      APP_HOST: 0.0.0.0 # 服务监听地址，容器内通常保持 0.0.0.0
+    environment:
-      APP_PORT: 8002 # 服务监听端口，需与 expose 和健康检查保持一致
+      UPLOAD_MAX_MB: ${UPLOAD_MAX_MB:-100}
-      APP_RELOAD: "false" # 生产环境关闭热重载
+    depends_on:
-      DATABASE_ECHO: "false" # 生产环境关闭 SQL 日志回显
+      backend:
-      DATABASE_POOL_SIZE: ${DATABASE_POOL_SIZE:-20} # 数据库连接池基础连接数
+        condition: service_healthy
-      DATABASE_MAX_OVERFLOW: ${DATABASE_MAX_OVERFLOW:-40} # 连接池额外可溢出连接数
+    ports:
-      DATABASE_POOL_TIMEOUT: ${DATABASE_POOL_TIMEOUT:-30} # 获取连接超时时间（秒）
+      - "${NGINX_PORT}:80"
-      DATABASE_POOL_RECYCLE: ${DATABASE_POOL_RECYCLE:-1800} # 连接回收周期（秒）
+    healthcheck:
-      DATA_ROOT: /app/data # 容器内业务数据目录
+      test: ["CMD", "wget", "-q", "-O", "/dev/null", "http://127.0.0.1/"]
-      BOTS_WORKSPACE_ROOT: ${HOST_BOTS_WORKSPACE_ROOT} # Bot 工作目录，容器内外路径保持一致
+      interval: 15s
-      DOCKER_NETWORK_NAME: ${DOCKER_NETWORK_NAME:-dashboard-nanobot-network} # 业务容器使用的 Docker 网络名称
+      timeout: 5s
-      DATABASE_URL: ${DATABASE_URL:-} # 外部 PostgreSQL 连接串，Prod 模式必须配置
+      retries: 5
-      REDIS_ENABLED: ${REDIS_ENABLED:-false} # 是否启用 Redis
+      start_period: 10s
-      REDIS_URL: ${REDIS_URL:-} # 外部 Redis 连接串
+    logging:
-      REDIS_PREFIX: ${REDIS_PREFIX:-dashboard_nanobot} # Redis key 前缀
+      driver: json-file
-      REDIS_DEFAULT_TTL: ${REDIS_DEFAULT_TTL:-60} # Redis 默认过期时间（秒）
+      options:
-      DEFAULT_BOT_SYSTEM_TIMEZONE: ${DEFAULT_BOT_SYSTEM_TIMEZONE:-Asia/Shanghai} # Bot 默认时区
+        max-size: "20m"
-      PANEL_ACCESS_PASSWORD: ${PANEL_ACCESS_PASSWORD:-} # 面板访问密码
+        max-file: "3"
-      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: # 前端 Nginx 服务
+networks:
-    build: # 保留构建信息，离线部署通常直接使用导入镜像
+  default:
-      context: ./frontend # 前端构建上下文
+    name: ${DOCKER_NETWORK_NAME:-dashboard-nanobot-network}
-      dockerfile: Dockerfile # 前端 Dockerfile 路径
+    external: true
-      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} # 自定义子网，现场冲突时可修改

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

frontend/src/i18n/app.zh-cn.ts

@@ -1,5 +1,5 @@
 export const appZhCn = {
-  title: 'Unisbot 管理面板',
+  title: 'Nanobot 管理面板',
   theme: '主题',
   language: '语言',
   dark: '深色',

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',

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();
 

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>

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

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;

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}

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> =>
+  const createEmptyChannelExtra = (): Record<string, unknown> => ({
-    channelType === 'weixin' ? {} : {};
+    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;
+    next.sendProgress = Boolean(next.sendProgress);
-    delete next.sendToolHints;
+    next.sendToolHints = Boolean(next.sendToolHints);
     return next;
   };
 
@@ -143,9 +127,7 @@ export function createChannelManager({
     setChannels(rows);
     setExpandedChannelByKey((prev) => {
       const next: Record<string, boolean> = {};
-      rows
+      rows.forEach((channel, index) => {
-        .filter((channel) => !isDashboardChannel(channel))
-        .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,
   };
 }

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,

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,

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,

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: () => {

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}

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>

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;
+  next.sendProgress = Boolean(next.sendProgress);
-  delete next.sendToolHints;
+  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,
   };
 }

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,

frontend/src/shared/workspace/useWorkspaceAttachments.ts

@@ -84,9 +84,10 @@ export function useWorkspaceAttachments({
     setAttachmentUploadPercent(null);
   }, [selectedBotId]);
 
-  const onPickAttachments = useCallback(async (event: ChangeEvent<HTMLInputElement>) => {
+  const uploadAttachmentFiles = useCallback(async (inputFiles: File[] | FileList) => {
-    if (!selectedBotId || !event.target.files || event.target.files.length === 0) return;
+    if (!selectedBotId || isUploadingAttachments) return;
-    const files = Array.from(event.target.files);
+    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,
   };
 }

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`

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"

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"

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[@]}"

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"

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"

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

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"

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" \

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,