Upload 3 files

Dockerfile

@@ -3,18 +3,25 @@ FROM node:lts-alpine3.19
 # Arguments
 ARG APP_HOME=/home/node/app
 ARG PLUGINS="" # Comma-separated list of plugin git URLs
+ARG USERNAME=""
+ARG PASSWORD=""
 
 # Install system dependencies
 # Add unzip for extracting the application code
 # Keep git for potential use by scripts or future plugin updates
 # Add wget to download the zip file
-RUN apk add --no-cache gcompat tini git unzip wget
+# Add curl for health checks and keep-alive
+# Add dos2unix to fix CRLF issues
+RUN apk add --no-cache gcompat tini git unzip wget curl dos2unix
 
 # Create app directory
 WORKDIR ${APP_HOME}
 
-# Set NODE_ENV to production
+# Set NODE_ENV to production and set credentials from ARGs
 ENV NODE_ENV=production
+ENV APP_HOME=${APP_HOME}
+ENV USERNAME=${USERNAME}
+ENV PASSWORD=${PASSWORD}
 
 # --- BEGIN: Clone SillyTavern Core from GitHub (staging branch) ---
 RUN \
@@ -71,119 +78,21 @@ RUN git config --global --add safe.directory "${APP_HOME}"
 # Ensure the node user owns the application directory and its contents
 RUN chown -R node:node ${APP_HOME}
 
+# No longer download external health.sh
+# RUN git clone --depth 1 https://github.com/fuwei99/docker-health.sh.git /tmp/health_repo && \
+#    cp /tmp/health_repo/health.sh ${APP_HOME}/health.sh && \
+#    rm -rf /tmp/health_repo
+
+# Make the downloaded script executable
+# RUN chmod +x ${APP_HOME}/health.sh
+
+# Copy the entrypoint script from the repository
+COPY entrypoint.sh /usr/local/bin/entrypoint.sh
+
+# Make the new entrypoint executable
+RUN chmod +x /usr/local/bin/entrypoint.sh
+
 EXPOSE 8000
 
-# Entrypoint: Read config from environment variable CONFIG_YAML if set, copy default if not, configure git, then run node server.js directly
-ENTRYPOINT ["tini", "--", "sh", "-c", " \
-    # --- BEGIN: Update SillyTavern Core at Runtime --- \
-    echo '--- Attempting to update SillyTavern Core from GitHub (staging branch) ---'; \
-    if [ -d \".git\" ] && [ \"$(git rev-parse --abbrev-ref HEAD)\" = \"staging\" ]; then \
-      echo 'Existing staging branch found. Resetting and pulling latest changes...'; \
-      git reset --hard HEAD && \
-      git pull origin staging || echo 'WARN: git pull failed, continuing with code from build time.'; \
-      echo '--- SillyTavern Core update check finished. ---'; \
-    else \
-      echo 'WARN: .git directory not found or not on staging branch. Skipping runtime update. Code from build time will be used.'; \
-    fi; \
-    # --- END: Update SillyTavern Core at Runtime --- \
-
-    echo '--- Checking for CONFIG_YAML environment variable ---'; \
-    # Ensure the CWD has correct permissions for writing config.yaml
-    # mkdir -p ./config && chown node:node ./config; # Removed mkdir
-    if [ -n \"$CONFIG_YAML\" ]; then \
-      echo 'Environment variable CONFIG_YAML found. Writing to ./config.yaml (root directory)...'; \
-      # Write directly to ./config.yaml in the CWD
-      printf '%s\n' \"$CONFIG_YAML\" > ./config.yaml && \
-      chown node:node ./config.yaml && \
-      echo 'Config written to ./config.yaml and permissions set successfully.'; \
-      # --- BEGIN DEBUG: Print the written config file ---
-      echo '--- Verifying written ./config.yaml ---'; \
-      cat ./config.yaml; \
-      echo '--- End of ./config.yaml ---'; \
-      # --- END DEBUG ---
-    else \
-      echo 'Warning: Environment variable CONFIG_YAML is not set or empty. Attempting to copy default config...'; \
-      # Copy default if ENV VAR is missing and the example exists
-      if [ -f \"./public/config.yaml.example\" ]; then \
-          # Copy default to ./config.yaml in the CWD
-          cp \"./public/config.yaml.example\" \"./config.yaml\" && \
-          chown node:node ./config.yaml && \
-          echo 'Copied default config to ./config.yaml'; \
-      else \
-          echo 'Warning: Default config ./public/config.yaml.example not found.'; \
-      fi; \
-    fi; \
-
-    # --- BEGIN: Configure Git default identity at Runtime --- \
-    echo '--- Configuring Git default user identity at runtime ---'; \
-    git config --global user.name \"SillyTavern Sync\" && \
-    git config --global user.email \"sillytavern-sync@example.com\"; \
-    echo '--- Git identity configured for runtime user. ---'; \
-    # --- END: Configure Git default identity at Runtime --- \
-
-    # --- BEGIN: Dynamically Install Plugins at Runtime --- \
-    echo '--- Checking for PLUGINS environment variable ---'; \
-    if [ -n \"$PLUGINS\" ]; then \
-      echo \"*** Installing Plugins specified in PLUGINS environment variable: $PLUGINS ***\" && \
-      # Ensure plugins directory exists
-      mkdir -p ./plugins && chown node:node ./plugins && \
-      # Set comma as delimiter
-      IFS=',' && \
-      # Loop through each plugin URL
-      for plugin_url in $PLUGINS; do \
-        # Trim leading/trailing whitespace
-        plugin_url=$(echo \"$plugin_url\" | sed 's/^[[:space:]]*//;s/[[:space:]]*$//') && \
-        if [ -z \"$plugin_url\" ]; then continue; fi && \
-        # Extract plugin name
-        plugin_name_git=$(basename \"$plugin_url\") && \
-        plugin_name=${plugin_name_git%.git} && \
-        plugin_dir=\"./plugins/$plugin_name\" && \
-        echo \"--- Installing plugin: $plugin_name from $plugin_url into $plugin_dir ---\" && \
-        # Remove existing dir if it exists
-        rm -rf \"$plugin_dir\" && \
-        # Clone the plugin (run as root, fix perms later)
-        git clone --depth 1 \"$plugin_url\" \"$plugin_dir\" && \
-        if [ -f \"$plugin_dir/package.json\" ]; then \
-          echo \"--- Installing dependencies for $plugin_name ---\" && \
-          (cd \"$plugin_dir\" && npm install --no-audit --no-fund --loglevel=error --no-progress --omit=dev --force && npm cache clean --force) || echo \"WARN: Failed to install dependencies for $plugin_name\"; \
-        else \
-           echo \"--- No package.json found for $plugin_name, skipping dependency install. ---\"; \
-        fi || echo \"WARN: Failed to clone $plugin_name from $plugin_url, skipping...\"; \
-      done && \
-      # Reset IFS
-      unset IFS && \
-      # Fix permissions for plugins directory after installation
-      echo \"--- Setting permissions for plugins directory ---\" && \
-      chown -R node:node ./plugins && \
-      echo \"*** Plugin installation finished. ***\"; \
-    else \
-      echo 'PLUGINS environment variable is not set or empty, skipping runtime plugin installation.'; \
-    fi; \
-    # --- END: Dynamically Install Plugins at Runtime --- \
-
-    echo 'Starting SillyTavern server directly...'; \
-
-    # --- BEGIN: Cleanup before start --- \
-    # Remove .gitignore
-    echo 'Attempting final removal of .gitignore...' && \
-    rm -f .gitignore && \
-    if [ ! -e .gitignore ]; then \
-      echo '.gitignore successfully removed.'; \
-    else \
-      # This case is unlikely with rm -f unless permissions prevent removal
-      echo 'WARN: .gitignore could not be removed or reappeared.'; \
-    fi; \
-    # Remove .git directory
-    echo 'Attempting final removal of .git directory...' && \
-    rm -rf .git && \
-    if [ ! -d .git ]; then \
-      echo '.git directory successfully removed.'; \
-    else \
-      # This case usually indicates a permission issue
-      echo 'WARN: .git directory could not be removed.'; \
-    fi; \
-    # --- END: Cleanup before start --- \
-
-    # Execute node server directly, bypassing docker-entrypoint.sh
-    exec node server.js; \
-  "]
+# Entrypoint: Execute the self-contained startup script
+ENTRYPOINT ["tini", "--", "/usr/local/bin/entrypoint.sh"]

README.md

@@ -1,230 +1,390 @@
----
-title: SillyTavern Docker & HF部署
-emoji: 🥂
-colorFrom: pink
-colorTo: blue
-sdk: docker
-pinned: false
-app_port: 8000 # SillyTavern 默认端口
-# 定义所需的 Hugging Face Secrets
-secrets:
-  - name: CONFIG_YAML
-    description: "你的 config.yaml 文件内容（无注释）"
-    required: true # 配置是必需的
-  - name: PLUGINS
-    description: "要安装的插件Git URL列表（逗号分隔）"
-    required: false # 插件是可选的
----
-
-# SillyTavern Docker 与 Hugging Face 部署指南
-
-本指南说明了如何使用提供的 `Dockerfile` 来构建和运行 SillyTavern，以及如何在 Hugging Face Spaces 上进行部署。部署的核心思想是通过环境变量在容器启动时动态配置 SillyTavern 和安装插件。
-
-## 关键文件
-
-*   `Dockerfile`: 用于构建 SillyTavern 运行环境的 Docker 镜像。它会：
-    *   基于官方 Node.js Alpine 镜像。
-    *   安装必要的系统依赖（如 `git`）。
-    *   从 GitHub 克隆 SillyTavern 的 `staging` 分支代码。
-    *   设置工作目录和用户权限。
-    *   定义容器启动时的 `ENTRYPOINT` 脚本，该脚本负责：
-        *   读取 `CONFIG_YAML` 环境变量并写入 `./config.yaml` 文件。
-        *   读取 `PLUGINS` 环境变量，并克隆、安装指定的插件。
-        *   启动 SillyTavern 服务器 (`node server.js`)。
-*   `README.md`: 本说明文件。
-
-## 配置方式：环境变量
-
-我们通过两个主要的环境变量来配置容器：
-
-1.  `CONFIG_YAML`: **必需**。
-    *   **作用**: 定义 SillyTavern 的运行配置。
-    *   **内容**: 下面是推荐的默认配置内容。你可以直接复制粘贴使用，但**强烈建议你修改其中的认证信息**。
-    *   **推荐配置内容**:
-        ```yaml
-        dataRoot: ./data
-        listen: true
-        listenAddress:
-          ipv4: 0.0.0.0
-          ipv6: '[::]'
-        protocol:
-            ipv4: true
-            ipv6: false
-        dnsPreferIPv6: false
-        autorunHostname: "auto"
-        port: 8000
-        autorunPortOverride: -1
-        ssl:
-          enabled: false
-          certPath: "./certs/cert.pem"
-          keyPath: "./certs/privkey.pem"
-        whitelistMode: false
-        enableForwardedWhitelist: false
-        whitelist:
-          - ::1
-          - 127.0.0.1
-        whitelistDockerHosts: true
-        basicAuthMode: true
-        basicAuthUser:
-          username: "用户名" # 请务必修改为你自己的用户名
-          password: "密码" # 请务必修改为你自己的密码
-        enableCorsProxy: false
-        requestProxy:
-          enabled: false
-          url: "socks5://username:password@example.com:1080"
-          bypass:
-            - localhost
-            - 127.0.0.1
-        enableUserAccounts: false
-        enableDiscreetLogin: false
-        autheliaAuth: false
-        perUserBasicAuth: false
-        sessionTimeout: -1
-        disableCsrfProtection: false
-        securityOverride: false
-        logging:
-          enableAccessLog: true
-          minLogLevel: 0
-        rateLimiting:
-          preferRealIpHeader: false
-        autorun: false
-        avoidLocalhost: false
-        backups:
-          common:
-            numberOfBackups: 50
-          chat:
-            enabled: true
-            checkIntegrity: true
-            maxTotalBackups: -1
-            throttleInterval: 10000
-        thumbnails:
-          enabled: true
-          format: "jpg"
-          quality: 95
-          dimensions: { 'bg': [160, 90], 'avatar': [96, 144] }
-        performance:
-          lazyLoadCharacters: false
-          memoryCacheCapacity: '100mb'
-          useDiskCache: true
-        allowKeysExposure: false
-        skipContentCheck: false
-        whitelistImportDomains:
-          - localhost
-          - cdn.discordapp.com
-          - files.catbox.moe
-          - raw.githubusercontent.com
-        requestOverrides: []
-        extensions:
-          enabled: true
-          autoUpdate: true
-          models:
-            autoDownload: true
-            classification: Cohee/distilbert-base-uncased-go-emotions-onnx
-            captioning: Xenova/vit-gpt2-image-captioning
-            embedding: Cohee/jina-embeddings-v2-base-en
-            speechToText: Xenova/whisper-small
-            textToSpeech: Xenova/speecht5_tts
-        enableDownloadableTokenizers: true
-        promptPlaceholder: "[Start a new chat]"
-        openai:
-          randomizeUserId: false
-          captionSystemPrompt: ""
-        deepl:
-          formality: default
-        mistral:
-          enablePrefix: false
-        ollama:
-          keepAlive: -1
-          batchSize: -1
-        claude:
-          enableSystemPromptCache: false
-          cachingAtDepth: -1
-        enableServerPlugins: true
-        enableServerPluginsAutoUpdate: false
-        ```
-    *   **⚠️ 重要警告**: 请务必修改上方配置中 `basicAuthUser` 下的 `username` 和 `password` 为你自己的凭据，以确保��全！**不要使用默认的 "用户名" 和 "密码"！**
-    *   **注意**: 必须是有效的 YAML 格式，且**不应包含任何 `#` 开头的注释行**。
-
-2.  `PLUGINS`: **可选**。
-    *   **作用**: 指定需要在容器启动时自动安装的 SillyTavern 插件。
-    *   **内容**: 一个**逗号分隔**的插件 Git 仓库 URL 列表。
-    *   **推荐安装**: 强烈建议安装 `cloud-saves` 插件，以便在不同部署环境（如本地和 Hugging Face）之间同步数据。
-        *   **插件地址**: `https://github.com/fuwei99/cloud-saves.git`
-        *   **重要前置条件**: 为了让容器/Hugging Face Space 能够拉取你的存档，你**必须**先在你本地的 SillyTavern 中安装好 `cloud-saves` 插件，并**至少进行一次数据存档操作**。这样，远程部署的环境才能通过该插件下载你的存档。
-    *   **格式示例**: `https://github.com/fuwei99/cloud-saves.git` (注意包含推荐的 cloud-saves 插件)
-    *   **注意**: URL 之间**只能用英文逗号 `,` 分隔**，且逗号前后**不能有空格**。如果留空或不提供此变量，则不会安装额外插件。
-
-## 方法一：本地 Docker 部署
-
-你可以在本地使用 Docker 来构建和运行 SillyTavern。
-
-1.  **构建镜像**: 在包含 `Dockerfile` 的目录下，运行：
-    ```bash
-    docker build -t sillytavern-local .
-    ```
-    将 `sillytavern-local` 替换为你想要的镜像名称。
-
-2.  **准备配置**: 将你的 `config.yaml` 内容（无注释）准备好。
-
-3.  **运行容器**: 使用 `docker run` 命令，并通过 `-e` 参数传递环境变量。
-    *   将上方提供的**推荐配置内容**复制，并作为 `CONFIG_YAML` 环境变量的值。**确保你已经修改了其中的用户名和密码！**
-    *   如果你需要安装插件（**推荐安装 `cloud-saves`**），请准备好插件 URL 列表。
-
-    ```bash
-    # 示例：使用推荐配置并安装 cloud-saves 插件
-    # 1. 将推荐配置（修改密码后）保存到名为 config_no_comments.yaml 的文件中
-    # 2. 运行以下命令
-
-    docker run -p 8000:8000 --name my-sillytavern \\
-      -e CONFIG_YAML="$(cat config_no_comments.yaml)" \\
-      -e PLUGINS='https://github.com/fuwei99/cloud-saves.git' \\
-      sillytavern-local
-
-    # 如果你需要安装更多插件，用逗号隔开添加到 PLUGINS 变量中
-    # 例如：
-    # docker run -p 8000:8000 --name my-sillytavern \
-    #   -e CONFIG_YAML="$(cat config_no_comments.yaml)" \
-    #   -e PLUGINS='https://github.com/fuwei99/cloud-saves.git,https://github.com/user/other-plugin.git' \
-    #   sillytavern-local
-    ```
-    *   `-p 8000:8000`: 将容器的 8000 端口映射到宿主机的 8000 端口。
-    *   `--name my-sillytavern`: 为容器命名，方便管理。
-    *   `-e CONFIG_YAML="$(cat config_no_comments.yaml)"`: 从文件读取配置内容并传递。这是处理多行 YAML 最可靠的方式。**再次确认：运行前务必修改 `config_no_comments.yaml` 文件中的用户名和密码！**
-    *   `-e PLUGINS='...'`: 传递插件列表，这里以安装 `cloud-saves` 为例。
-
-4.  **访问**: 打开浏览器访问 `http://localhost:8000`。
-
-## 方法二：Hugging Face Spaces 部署
-
-这是推荐的在线部署方式，利用 Hugging Face 的免费计算资源和 Secrets 管理功能。
-
-1.  **创建 Space**: 在 Hugging Face 上创建一个新的 Space，选择 **Docker** SDK。
-
-2.  **上传文件**: 将本项目中的 `Dockerfile` 和 `README.md` 文件上传到你的 Space 仓库根目录。
-
-3.  **配置 Secrets**: 进入你的 Space 页面的 **Settings -> Secrets** 部分。
-    *   **添加 `CONFIG_YAML` Secret**:
-        *   点击 "New secret"。
-        *   名称 (Name) 输入: `CONFIG_YAML`
-        *   值 (Value) 粘贴: **复制上方提供的推荐配置内容**。**再次强调：粘贴前请务必修改 `basicAuthUser` 下的 `username` 和 `password` 为你自己的安全凭据！**
-        *   点击 "Add secret"。
-    *   **(推荐) 添加 `PLUGINS` Secret**:
-        *   再次点击 "New secret"。
-        *   名称 (Name) 输入: `PLUGINS`
-        *   值 (Value) 粘贴: 推荐至少包含 `cloud-saves` 插件。例如：`https://github.com/fuwei99/cloud-saves.git`。如果你需要其他插件，用逗号隔开添加，例如：`https://github.com/fuwei99/cloud-saves.git,https://github.com/user/other-plugin.git`。
-        *   **重要提醒**: 请确保你已经在本地 SillyTavern 安装了 `cloud-saves` 并至少进行了一次存档。
-        *   点击 "Add secret"。如果你确实不需要任何额外插件，可以跳过这一步。
-
-4.  **构建与启动**: Hugging Face 会自动检测到 `Dockerfile` 和 Secrets，并开始构建镜像、启动容器。你可以在 Space 的 **Logs** 标签页查看构建和启动过程。
-
-5.  **访问**: 构建成功并启动后，通过 Space 提供的公共 URL 访问 SillyTavern 界面。
-
-## 插件访问
-
-如果通过 `PLUGINS` 环境变量安装了��件，你需要根据各个插件的说明文档找到访问其界面的路径。
-
-*   对于推荐安装的 `cloud-saves` 插件，其管理界面通常位于:
-    `http://<你的SillyTavern访问地址>/api/plugins/cloud-saves/ui`
-    例如，如果是本地部署，则为 `http://127.0.0.1:8000/api/plugins/cloud-saves/ui`。如果是 Hugging Face Space，则将 `<你的SillyTavern访问地址>` 替换为你的 Space 公共 URL。
-
-其他插件的访问路径请参考其各自的文档。
+---
+title: SillyTavern Docker & HF部署
+emoji: 🥂
+colorFrom: pink
+colorTo: blue
+sdk: docker
+pinned: false
+app_port: 8000 # SillyTavern 默认端口
+# 定义所需的 Hugging Face Secrets
+secrets:
+  - name: CONFIG_YAML
+    description: "你的 config.yaml 文件内容（无注释）"
+    required: true # 配置是必需的
+  - name: PLUGINS
+    description: "要安装的插件Git URL列表（逗号分隔）"
+    required: false # 插件是可选的
+  - name: EXTENSIONS
+    description: "要安装的扩展Git URL列表（逗号分隔）"
+    required: false # 扩展是可选的
+  - name: INSTALL_FOR_ALL_USERS
+    description: "扩展安装模式：true为系统级安装，false或其他值为用户级安装"
+    required: false # 扩展安装模式是可选的
+  - name: REPO_URL
+    description: "cloud-saves插件的GitHub仓库URL（用于自动配置）"
+    required: false # cloud-saves自动配置是可选的
+  - name: GITHUB_TOKEN
+    description: "GitHub访问令牌（用于cloud-saves插件自动配置）"
+    required: false # cloud-saves自动配置是可选的
+  - name: AUTOSAVE_INTERVAL
+    description: "cloud-saves插件自动保存间隔（秒）"
+    required: false # cloud-saves自动保存配置是可选的
+  - name: AUTOSAVE_TARGET_TAG
+    description: "cloud-saves插件自动保存目标标签"
+    required: false # cloud-saves自动保存配置是可选的
+---
+
+# 最简单的方法：一键部署
+## 注意部署界面那个visibility一定要改为public，不然没办法用
+
+如果你不想手动配置，可以直接点击下方按钮，一键将 SillyTavern Docker 部署到你自己的 Hugging Face Space 中（需要先注册 Hugging Face 账号）：
+
+[![部署到 Hugging Face Spaces](https://huggingface.co/datasets/huggingface/badges/resolve/main/deploy-to-spaces-lg.svg)](https://huggingface.co/spaces/malt666/Tavern-Docker?duplicate=true)
+
+点击按钮后，按照下面的格式配置环境变量即可：
+
+PLUGINS：https://github.com/fuwei99/cloud-saves.git
+（填写云备份插件链接）
+
+CONFIG_YAML：见下方命令行复制，记得改用户名和密码，另外由于hugging face的duplicate(部署)界面有bug，复制下来的也会变成一行，所以只能进入界面之后，在setting下面找到secrets，点击CONFIG_YAML旁边的replace，重新复制粘贴一遍到value那里，这样应该就可以了。
+
+EXTENSIONS：https://github.com/N0VI028/JS-Slash-Runner,https://gitee.com/muyoou/st-memory-enhancement
+（填写扩展链接，比如酒馆助手，增强记忆插件，用英语逗号隔开）
+
+INSTALL_FOR_ALL_USERS：true
+（设置为false会安装到default-user，设置为true会安装到全局，不填写默认安装到default-user，推荐设置为true）
+
+---
+
+以下是可选secret：
+
+REPO_URL：https://github.com/yourusername/yourrepo（填写你的 GitHub 仓库地址，用于 cloud-saves 插件自动配置）
+
+GITHUB_TOKEN：ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx（填写你的 GitHub 访问令牌，用于 cloud-saves 插件自动配置）
+
+AUTOSAVE_INTERVAL：30（填写自动保存间隔分钟，不填写默认为30分）
+
+AUTOSAVE_TARGET_TAG：auto-backup（填写自动保存目标标签，不填写默认为空）
+
+
+## 如何读取或者保存存档
+
+教程见： https://github.com/fuwei99/cloud-saves
+
+*   对于推荐安装的 `cloud-saves` 插件，其管理界面通常位于:
+    `http://<你的SillyTavern访问地址>/api/plugins/cloud-saves/ui`
+    例如，如果是本地部署，则为 `http://127.0.0.1:8000/api/plugins/cloud-saves/ui`。如果是 Hugging Face Space，则将 `<你的SillyTavern访问地址>` 替换为你的 Space 公共 URL
+
+其他插件的访问路径请参考其各自的文档。
+
+
+---
+
+# SillyTavern Docker 与 Hugging Face 部署指南
+
+本指南说明了如何使用提供的 `Dockerfile` 来构建和运行 SillyTavern，以及如何在 Hugging Face Spaces 上进行部署。部署的核心思想是通过环境变量在容器启动时动态配置 SillyTavern 和安装插件。
+
+## 关键文件
+
+*   `Dockerfile`: 用于构建 SillyTavern 运行环境的 Docker 镜像。它会：
+    *   基于官方 Node.js Alpine 镜像。
+    *   安装必要的系统依赖（如 `git`）。
+    *   从 GitHub 克隆 SillyTavern 的 `staging` 分支代码。
+    *   设置工作目录和用户权限。
+    *   定义容器启动时的 `ENTRYPOINT` 脚本，该脚本负责：
+        *   读取 `CONFIG_YAML` 环境变量并写入 `./config.yaml` 文件。
+        *   读取 `PLUGINS` 环境变量，并克隆、安装指定的插件。
+        *   启动 SillyTavern 服务器 (`node server.js`)。
+*   `README.md`: 本说明文件。
+
+## 配置方式：环境变量
+
+我们通过两个主要的环境变量来配置容器：
+
+1.  `CONFIG_YAML`: **必需**。
+    *   **作用**: 定义 SillyTavern 的运行配置。
+    *   **内容**: 下面是推荐的默认配置内容。你可以直接复制粘贴使用，但**强烈建议你修改其中的认证信息**。
+    *   **推荐配置内容**:
+        ```yaml
+        dataRoot: ./data
+        listen: true
+        listenAddress:
+          ipv4: 0.0.0.0
+          ipv6: '[::]'
+        protocol:
+            ipv4: true
+            ipv6: false
+        dnsPreferIPv6: false
+        autorunHostname: "auto"
+        port: 8000
+        autorunPortOverride: -1
+        ssl:
+          enabled: false
+          certPath: "./certs/cert.pem"
+          keyPath: "./certs/privkey.pem"
+        whitelistMode: false
+        enableForwardedWhitelist: false
+        whitelist:
+          - ::1
+          - 127.0.0.1
+        whitelistDockerHosts: true
+        basicAuthMode: true
+        basicAuthUser:
+          username: "用户名" # 请务必修改为你自己的用户名
+          password: "密码" # 请务必修改为你自己的密码
+        enableCorsProxy: false
+        requestProxy:
+          enabled: false
+          url: "socks5://username:password@example.com:1080"
+          bypass:
+            - localhost
+            - 127.0.0.1
+        enableUserAccounts: false
+        enableDiscreetLogin: false
+        autheliaAuth: false
+        perUserBasicAuth: false
+        sessionTimeout: -1
+        disableCsrfProtection: false
+        securityOverride: false
+        logging:
+          enableAccessLog: true
+          minLogLevel: 0
+        rateLimiting:
+          preferRealIpHeader: false
+        autorun: false
+        avoidLocalhost: false
+        backups:
+          common:
+            numberOfBackups: 50
+          chat:
+            enabled: true
+            checkIntegrity: true
+            maxTotalBackups: -1
+            throttleInterval: 10000
+        thumbnails:
+          enabled: true
+          format: "jpg"
+          quality: 95
+          dimensions: { 'bg': [160, 90], 'avatar': [96, 144] }
+        performance:
+          lazyLoadCharacters: false
+          memoryCacheCapacity: '100mb'
+          useDiskCache: true
+        allowKeysExposure: true
+        skipContentCheck: false
+        whitelistImportDomains:
+          - localhost
+          - cdn.discordapp.com
+          - files.catbox.moe
+          - raw.githubusercontent.com
+        requestOverrides: []
+        extensions:
+          enabled: true
+          autoUpdate: false
+          models:
+            autoDownload: true
+            classification: Cohee/distilbert-base-uncased-go-emotions-onnx
+            captioning: Xenova/vit-gpt2-image-captioning
+            embedding: Cohee/jina-embeddings-v2-base-en
+            speechToText: Xenova/whisper-small
+            textToSpeech: Xenova/speecht5_tts
+        enableDownloadableTokenizers: true
+        promptPlaceholder: "[Start a new chat]"
+        openai:
+          randomizeUserId: false
+          captionSystemPrompt: ""
+        deepl:
+          formality: default
+        mistral:
+          enablePrefix: false
+        ollama:
+          keepAlive: -1
+          batchSize: -1
+        claude:
+          enableSystemPromptCache: false
+          cachingAtDepth: -1
+        enableServerPlugins: true
+        enableServerPluginsAutoUpdate: false
+        ```
+    *   **⚠️ 重要警告**: 请务必修改上方配置中 `basicAuthUser` 下的 `username` 和 `password` 为你自己的凭据，以确保安全！**不要使用默认的 "用户名" 和 "密码"！**
+    *   **注意**: 必须是有效的 YAML 格式，且**不应包含任何 `#` 开头的注释行**。
+
+2.  `PLUGINS`: **可选**。
+    *   **作用**: 指定需要在容器启动时自动安装的 SillyTavern 插件。
+    *   **内容**: 一个**逗号分隔**的插件 Git 仓库 URL 列表。
+    *   **推荐安装**: 强烈建议安装 `cloud-saves` 插件，以便在不同部署环境（如本地和 Hugging Face）之间同步数据。
+        *   **插件地址**: `https://github.com/fuwei99/cloud-saves.git`
+        *   **重要前置条件**: 为了让容器/Hugging Face Space 能够拉取你的存档，你**必须**先在你本地的 SillyTavern 中安装好 `cloud-saves` 插件，并**至少进行一次数据存档操作**。这样，远程部署的环境才能通过该插件下载你的存档。
+    *   **格式示例**: `https://github.com/fuwei99/cloud-saves.git` (注意包含推荐的 cloud-saves 插件)
+    *   **注意**: URL 之间**只能用英文逗号 `,` 分隔**，且逗号前后**不能有空格**。如果留空或不提供此变量，则不会安装额外插件。
+
+3.  `EXTENSIONS`: **可选**。
+    *   **作用**: 指定需要在容器启动时自动安装的 SillyTavern 扩展（Extensions）。
+    *   **内容**: 一个**逗号分隔**的扩展 Git 仓库 URL 列表。
+    *   **安装时机**: 扩展会在项目启动之后自动安装，确保 SillyTavern 目录结构已经准备完毕。
+    *   **格式示例**: `https://github.com/user1/extension1.git,https://github.com/user2/extension2.git`
+    *   **注意**: URL 之间**只能用英文逗号 `,` 分隔**，且逗号前后**不能有空格**。如果留空或不提供此变量，则不会安装额外扩展。
+
+4.  `INSTALL_FOR_ALL_USERS`: **可选**。
+    *   **作用**: 控制扩展的安装位置模式。
+    *   **可选值**:
+        *   `true`: 扩展安装到 `public/scripts/extensions/third-party` 目录下，对**所有用户**生效（系统级安装）。
+        *   `false` 或任何其他值，或变量不存在: 扩展安装到 `data/default-user/extensions` 目录下，仅对**默认用户**生效（用户级安装）。
+    *   **默认行为**: 如果不设置此环境变量，默认安装到用户级目录。
+    *   **格式示例**: `true` 或 `false`
+
+5.  `REPO_URL`: **可选**。
+    *   **作用**: 为 cloud-saves 插件提供 GitHub 仓库 URL，用于自动配置插件。
+    *   **前置条件**: 需要同时安装 cloud-saves 插件（通过 `PLUGINS` 环境变量）。
+    *   **格式示例**: `https://github.com/yourusername/yourrepo`
+    *   **说明**: 这是你用来存储 SillyTavern 数据备份的 GitHub 仓库地址。
+
+6.  `GITHUB_TOKEN`: **可选**。
+    *   **作用**: 为 cloud-saves 插件提供 GitHub 访问令牌，用于自动配置插件。
+    *   **前置条件**: 需要同时设置 `REPO_URL` 和安装 cloud-saves 插件。
+    *   **格式示例**: `ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`
+    *   **获取方式**: 在 GitHub Settings -> Developer settings -> Personal access tokens -> Tokens (classic) 中创建，需要 `repo` 权限。
+    *   **自动配置**: 如果同时提供了 `REPO_URL` 和 `GITHUB_TOKEN`，且安装了 cloud-saves 插件，系统会自动创建插件的配置文件。
+
+7.  `AUTOSAVE_INTERVAL`: **可选**。
+    *   **作用**: 设置 cloud-saves 插件的自动保存间隔时间（秒）。
+    *   **前置条件**: 需要同时设置 `REPO_URL` 和 `GITHUB_TOKEN`。
+    *   **格式示例**: `30`（表示每30秒自动保存一次）
+    *   **默认值**: 如果不设置，默认为 `30` 秒。
+
+8.  `AUTOSAVE_TARGET_TAG`: **可选**。
+    *   **作用**: 设置 cloud-saves 插件的自动保存目标标签。
+    *   **前置条件**: 需要同时设置 `REPO_URL` 和 `GITHUB_TOKEN`。
+    *   **格式示例**: `auto-backup` 或 `daily-save`
+    *   **默认值**: 如果不设置，默认为空字符串。
+
+## 方法一：本地 Docker 部署
+
+你可以在本地使用 Docker 来构建和运行 SillyTavern。
+
+1.  **构建镜像**: 在包含 `Dockerfile` 的目录下，运行：
+    ```bash
+    docker build -t sillytavern-local .
+    ```
+    将 `sillytavern-local` 替换为你想要的镜像名称。
+
+2.  **准备配置**: 将你的 `config.yaml` 内容（无注释）准备好。
+
+3.  **运行容器**: 使用 `docker run` 命令，并通过 `-e` 参数传递环境变量。
+    *   将上方提供的**推荐配置内容**复制，并作为 `CONFIG_YAML` 环境变量的值。**确保你已经修改了其中的用户名和密码！**
+    *   如果你需要安装插件（**推荐安装 `cloud-saves`**），请准备好插件 URL 列表。
+
+    ```bash
+    # 示例：使用推荐配置并安装 cloud-saves 插件
+    # 1. 将推荐配置（修改密码后）保存到名为 config_no_comments.yaml 的文件中
+    # 2. 运行以下命令
+
+    docker run -p 8000:8000 --name my-sillytavern \\
+      -e CONFIG_YAML="$(cat config_no_comments.yaml)" \\
+      -e PLUGINS='https://github.com/fuwei99/cloud-saves.git' \\
+      -e EXTENSIONS='https://github.com/user1/extension1.git,https://github.com/user2/extension2.git' \\
+      -e INSTALL_FOR_ALL_USERS=false \\
+      -e REPO_URL='https://github.com/yourusername/yourrepo' \\
+      -e GITHUB_TOKEN='ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' \\
+      -e AUTOSAVE_INTERVAL=30 \\
+      -e AUTOSAVE_TARGET_TAG=auto-backup \\
+      sillytavern-local
+
+    # 如果你需要安装更多插件，用逗号隔开添加到 PLUGINS 变量中
+    # 例如：
+    # docker run -p 8000:8000 --name my-sillytavern \
+    #   -e CONFIG_YAML="$(cat config_no_comments.yaml)" \
+    #   -e PLUGINS='https://github.com/fuwei99/cloud-saves.git,https://github.com/user/other-plugin.git' \
+    #   -e EXTENSIONS='https://github.com/user1/extension1.git,https://github.com/user2/extension2.git' \
+    #   -e INSTALL_FOR_ALL_USERS=false \
+    #   -e REPO_URL='https://github.com/yourusername/yourrepo' \
+    #   -e GITHUB_TOKEN='ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' \
+    #   -e AUTOSAVE_INTERVAL=30 \
+    #   -e AUTOSAVE_TARGET_TAG=auto-backup \
+    #   sillytavern-local
+    ```
+    *   `-p 8000:8000`: 将容器的 8000 端口映射到宿主机的 8000 端口。
+    *   `--name my-sillytavern`: 为容器命名，方便管理。
+    *   `-e CONFIG_YAML="$(cat config_no_comments.yaml)"`: 从文件读取配置内容并传递。这是处理多行 YAML 最可靠的方式。**再次确认：运行前务必修改 `config_no_comments.yaml` 文件中的用户名和密码！**
+    *   `-e PLUGINS='...'`: 传递插件列表，这里以安装 `cloud-saves` 为例。
+    *   `-e EXTENSIONS='...'`: 传递扩展列表，这里以安装 `extension1` 和 `extension2` 为例。
+    *   `-e INSTALL_FOR_ALL_USERS=false`: 设置扩展安装模式为用户级安装。
+    *   `-e REPO_URL='...'`: 传递 REPO_URL 环境变量。
+    *   `-e GITHUB_TOKEN='...'`: 传递 GITHUB_TOKEN 环境变量。
+    *   `-e AUTOSAVE_INTERVAL=30`: 设置 AUTOSAVE_INTERVAL 环境变量。
+    *   `-e AUTOSAVE_TARGET_TAG=auto-backup`: 设置 AUTOSAVE_TARGET_TAG 环境变量。
+
+4.  **访问**: 打开浏览器访问 `http://localhost:8000`。
+
+## 方法二：Hugging Face Spaces 部署
+
+这是推荐的在线部署方式，利用 Hugging Face 的免费计算资源和 Secrets 管理功能。
+
+1.  **创建 Space**: 在 Hugging Face 上创建一个新的 Space，选择 **Docker** SDK。
+
+2.  **上传文件**: 将本项目中的 `Dockerfile` 和 `README.md` 文件上传到你的 Space 仓库根目录。
+
+3.  **配置 Secrets**: 进入你的 Space 页面的 **Settings -> Secrets** 部分。
+    *   **添加 `CONFIG_YAML` Secret**:
+        *   点击 "New secret"。
+        *   名称 (Name) 输入: `CONFIG_YAML`
+        *   值 (Value) 粘贴: **复制上方提供的推荐配置内容**。**再次强调：粘贴前请务必修改 `basicAuthUser` 下的 `username` 和 `password` 为你自己的安全凭据！**
+        *   点击 "Add secret"。
+    *   **(推荐) 添加 `PLUGINS` Secret**:
+        *   再次点击 "New secret"。
+        *   名称 (Name) 输入: `PLUGINS`
+        *   值 (Value) 粘贴: 推荐至少包含 `cloud-saves` 插件。例如：`https://github.com/fuwei99/cloud-saves.git`。如果你需要其他插件，用逗号隔开添加，例如：`https://github.com/fuwei99/cloud-saves.git,https://github.com/user/other-plugin.git`。
+        *   **重要提醒**: 请确保你已经在本地 SillyTavern 安装了 `cloud-saves` 并至少进行了一次存档。
+        *   点击 "Add secret"。如果你确实不需要任何额外插件，可以跳过这一步。
+
+    *   **(可选) 添加 `EXTENSIONS` Secret**:
+        *   再次点击 "New secret"。
+        *   名称 (Name) 输入: `EXTENSIONS`
+        *   值 (Value) 粘贴: 你需要安装的扩展 Git URL 列表，用逗号隔开。例如：`https://github.com/user1/extension1.git,https://github.com/user2/extension2.git`。
+        *   点击 "Add secret"。如果你不需要安装扩展，可以跳过这一步。
+
+    *   **(可选) 添加 `INSTALL_FOR_ALL_USERS` Secret**:
+        *   如果你添加了 `EXTENSIONS` Secret，可以继续添加这个 Secret 来控制扩展安装模式。
+        *   再次点击 "New secret"。
+        *   名称 (Name) 输入: `INSTALL_FOR_ALL_USERS`
+        *   值 (Value) 输入: `true`（系统级安装，所有用户可用）或 `false`（用户级安装，仅默认用户可用）。
+        *   **推荐**: 对于 Hugging Face Space 单用户环境，建议设置为 `false` 或不设置此 Secret。
+        *   点击 "Add secret"。如果不设置，默认为用户级安装。
+
+    *   **(可选) 添加 `REPO_URL` Secret**:
+        *   再次点击 "New secret"。
+        *   名称 (Name) 输入: `REPO_URL`
+        *   值 (Value) 输入: 你的 GitHub 仓库地址，用于 cloud-saves 插件自动配置。例如：`https://github.com/yourusername/yourrepo`
+        *   点击 "Add secret"。
+
+    *   **(可选) 添加 `GITHUB_TOKEN` Secret**:
+        *   再次点击 "New secret"。
+        *   名称 (Name) 输入: `GITHUB_TOKEN`
+        *   值 (Value) 输入: 你的 GitHub 访问令牌，用于 cloud-saves 插件自动配置。例如：`ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`
+        *   点击 "Add secret"。
+
+    *   **(可选) 添加 `AUTOSAVE_INTERVAL` Secret**:
+        *   再次点击 "New secret"。
+        *   名称 (Name) 输入: `AUTOSAVE_INTERVAL`
+        *   值 (Value) 输入: 自动保存间隔秒数，不填写默认为30秒
+        *   点击 "Add secret"。
+
+    *   **(可选) 添加 `AUTOSAVE_TARGET_TAG` Secret**:
+        *   再次点击 "New secret"。
+        *   名称 (Name) 输入: `AUTOSAVE_TARGET_TAG`
+        *   值 (Value) 输入: 自动保存目标标签，不填写默认为空
+        *   点击 "Add secret"。
+
+4.  **构建与启动**: Hugging Face 会自动检测到 `Dockerfile` 和 Secrets，并开始构建镜像、启动容器。你可以在 Space 的 **Logs** 标签页查看构建和启动过程。
+
+5.  **访问**: 构建成功并启动后，通过 Space 提供的公共 URL 访问 SillyTavern 界面。
+
+## 插件访问
+
+如果通过 `PLUGINS` 环境变量安装了插件，你需要根据各个插件的说明文档找到访问其界面的路径。
+
+*   对于推荐安装的 `cloud-saves` 插件，其管理界面通常位于:
+    `http://<你的SillyTavern访问地址>/api/plugins/cloud-saves/ui`
+    例如，如果是本地部署，则为 `http://127.0.0.1:8000/api/plugins/cloud-saves/ui`。如果是 Hugging Face Space，则将 `<你的SillyTavern访问地址>` 替换为你的 Space 公共 URL。
+
+其他插件的访问路径请参考其各自的文档。

entrypoint.sh

@@ -0,0 +1,336 @@
+#!/bin/sh
+set -e
+
+CONFIG_FILE="${APP_HOME}/config.yaml"
+
+# Priority 1: Use USERNAME/PASSWORD if both are provided
+if [ -n "${USERNAME}" ] && [ -n "${PASSWORD}" ]; then
+  echo "--- Basic auth enabled: Creating config.yaml with provided credentials. ---"
+  
+  cat <<EOT > ${CONFIG_FILE}
+dataRoot: ./data
+listen: true
+listenAddress:
+  ipv4: 0.0.0.0
+  ipv6: '[::]'
+protocol:
+    ipv4: true
+    ipv6: false
+dnsPreferIPv6: false
+autorunHostname: "auto"
+port: 8000
+autorunPortOverride: -1
+ssl:
+  enabled: false
+  certPath: "./certs/cert.pem"
+  keyPath: "./certs/privkey.pem"
+whitelistMode: false
+enableForwardedWhitelist: false
+whitelist:
+  - ::1
+  - 127.0.0.1
+whitelistDockerHosts: true
+basicAuthMode: true
+basicAuthUser:
+  username: "${USERNAME}"
+  password: "${PASSWORD}"
+enableCorsProxy: false
+requestProxy:
+  enabled: false
+  url: "socks5://username:password@example.com:1080"
+  bypass:
+    - localhost
+    - 127.0.0.1
+enableUserAccounts: false
+enableDiscreetLogin: false
+autheliaAuth: false
+perUserBasicAuth: false
+sessionTimeout: -1
+disableCsrfProtection: false
+securityOverride: false
+logging:
+  enableAccessLog: true
+  minLogLevel: 0
+rateLimiting:
+  preferRealIpHeader: false
+autorun: false
+avoidLocalhost: false
+backups:
+  common:
+    numberOfBackups: 50
+  chat:
+    enabled: true
+    checkIntegrity: true
+    maxTotalBackups: -1
+    throttleInterval: 10000
+thumbnails:
+  enabled: true
+  format: "jpg"
+  quality: 95
+  dimensions: { 'bg': [160, 90], 'avatar': [96, 144] }
+performance:
+  lazyLoadCharacters: false
+  memoryCacheCapacity: '100mb'
+  useDiskCache: true
+allowKeysExposure: true
+skipContentCheck: false
+whitelistImportDomains:
+  - localhost
+  - cdn.discordapp.com
+  - files.catbox.moe
+  - raw.githubusercontent.com
+requestOverrides: []
+extensions:
+  enabled: true
+  autoUpdate: false
+  models:
+    autoDownload: true
+    classification: Cohee/distilbert-base-uncased-go-emotions-onnx
+    captioning: Xenova/vit-gpt2-image-captioning
+    embedding: Cohee/jina-embeddings-v2-base-en
+    speechToText: Xenova/whisper-small
+    textToSpeech: Xenova/speecht5_tts
+enableDownloadableTokenizers: true
+promptPlaceholder: "[Start a new chat]"
+openai:
+  randomizeUserId: false
+  captionSystemPrompt: ""
+deepl:
+  formality: default
+mistral:
+  enablePrefix: false
+ollama:
+  keepAlive: -1
+  batchSize: -1
+claude:
+  enableSystemPromptCache: false
+  cachingAtDepth: -1
+enableServerPlugins: true
+enableServerPluginsAutoUpdate: false
+EOT
+
+# Priority 2: Use CONFIG_YAML if provided (and username/password are not)
+elif [ -n "${CONFIG_YAML}" ]; then
+  echo "--- Found CONFIG_YAML, creating config.yaml from environment variable. ---"
+  echo "${CONFIG_YAML}" | base64 -d > ${CONFIG_FILE}
+
+# Priority 3: No config provided, let the app use its defaults
+else
+    echo "--- No user/pass or CONFIG_YAML provided. App will use its default settings. ---"
+fi
+
+# --- BEGIN: Update SillyTavern Core at Runtime ---
+echo '--- Attempting to update SillyTavern Core from GitHub (staging branch) ---'
+if [ -d ".git" ] && [ "$(git rev-parse --abbrev-ref HEAD)" = "staging" ]; then
+  echo 'Existing staging branch found. Resetting and pulling latest changes...'
+  git reset --hard HEAD && \
+  git pull origin staging || echo 'WARN: git pull failed, continuing with code from build time.'
+  echo '--- SillyTavern Core update check finished. ---'
+else
+  echo 'WARN: .git directory not found or not on staging branch. Skipping runtime update. Code from build time will be used.'
+fi
+# --- END: Update SillyTavern Core at Runtime ---
+
+# --- BEGIN: Configure Git default identity at Runtime ---
+echo '--- Configuring Git default user identity at runtime ---'
+git config --global user.name "SillyTavern Sync" && \
+git config --global user.email "sillytavern-sync@example.com" && \
+git config --global --add safe.directory "${APP_HOME}/data"
+echo '--- Git identity configured for runtime user. ---'
+# --- END: Configure Git default identity at Runtime ---
+
+# --- BEGIN: Dynamically Install Plugins at Runtime ---
+echo '--- Checking for PLUGINS environment variable ---'
+if [ -n "$PLUGINS" ]; then
+  echo "*** Installing Plugins specified in PLUGINS environment variable: $PLUGINS ***"
+  # Ensure plugins directory exists
+  mkdir -p ./plugins && chown node:node ./plugins
+  # Set comma as delimiter
+  IFS=','
+  # Loop through each plugin URL
+  for plugin_url in $PLUGINS; do
+    # Trim leading/trailing whitespace
+    plugin_url=$(echo "$plugin_url" | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
+    if [ -z "$plugin_url" ]; then continue; fi
+    # Extract plugin name
+    plugin_name_git=$(basename "$plugin_url")
+    plugin_name=${plugin_name_git%.git}
+    plugin_dir="./plugins/$plugin_name"
+    echo "--- Installing plugin: $plugin_name from $plugin_url into $plugin_dir ---"
+    # Remove existing dir if it exists
+    rm -rf "$plugin_dir"
+    # Clone the plugin (run as root, fix perms later)
+    git clone --depth 1 "$plugin_url" "$plugin_dir"
+    if [ -f "$plugin_dir/package.json" ]; then
+      echo "--- Installing dependencies for $plugin_name ---"
+      (cd "$plugin_dir" && npm install --no-audit --no-fund --loglevel=error --no-progress --omit=dev --force && npm cache clean --force) || echo "WARN: Failed to install dependencies for $plugin_name"
+    else
+       echo "--- No package.json found for $plugin_name, skipping dependency install. ---"
+    fi || echo "WARN: Failed to clone $plugin_name from $plugin_url, skipping..."
+    
+    # Configure cloud-saves plugin if this is the cloud-saves plugin
+    if [ "$plugin_name" = "cloud-saves" ]; then
+      echo "--- Detected cloud-saves plugin, checking for configuration environment variables ---"
+      
+      # Set default values
+      REPO_URL_VALUE=${REPO_URL:-"https://github.com/fuwei99/sillytravern"}
+      GITHUB_TOKEN_VALUE=${GITHUB_TOKEN:-""}
+      AUTOSAVE_INTERVAL_VALUE=${AUTOSAVE_INTERVAL:-30}
+      AUTOSAVE_TARGET_TAG_VALUE=${AUTOSAVE_TARGET_TAG:-""}
+      
+      # Always set autosave to false as required
+      AUTOSAVE_ENABLED="false"
+      
+      echo "--- Creating cloud-saves plugin configuration file ---"
+      CONFIG_JSON_FILE="$plugin_dir/config.json"
+      
+      # Generate config.json file
+      cat <<EOT > ${CONFIG_JSON_FILE}
+{
+  "repo_url": "${REPO_URL_VALUE}",
+  "branch": "main",
+  "username": "cloud-saves",
+  "github_token": "${GITHUB_TOKEN_VALUE}",
+  "display_name": "",
+  "is_authorized": true,
+  "last_save": null,
+  "current_save": null,
+  "has_temp_stash": false,
+  "autoSaveEnabled": ${AUTOSAVE_ENABLED},
+  "autoSaveInterval": ${AUTOSAVE_INTERVAL_VALUE},
+  "autoSaveTargetTag": "${AUTOSAVE_TARGET_TAG_VALUE}"
+}
+EOT
+      
+      # Set correct permissions for config file
+      chown node:node ${CONFIG_JSON_FILE}
+      
+      echo "--- cloud-saves plugin configuration file created at: ${CONFIG_JSON_FILE} ---"
+    fi
+  done
+  # Reset IFS
+  unset IFS
+  # Fix permissions for plugins directory after installation
+  echo "--- Setting permissions for plugins directory ---"
+  chown -R node:node ./plugins
+  echo "*** Plugin installation finished. ***"
+else
+  echo 'PLUGINS environment variable is not set or empty, skipping runtime plugin installation.'
+fi
+# --- END: Dynamically Install Plugins at Runtime ---
+
+echo "*** Starting SillyTavern... ***"
+node ${APP_HOME}/server.js &
+SERVER_PID=$!
+
+echo "SillyTavern server started with PID ${SERVER_PID}. Waiting for it to become responsive..."
+
+# --- Health Check Logic ---
+HEALTH_CHECK_URL="http://localhost:8000/"
+CURL_COMMAND="curl -sf"
+
+# If basic auth is enabled, provide credentials to curl for health checks
+if [ -n "${USERNAME}" ] && [ -n "${PASSWORD}" ]; then
+    echo "--- Health check will use basic auth credentials. ---"
+    # The -u flag provides user:password for basic auth
+    CURL_COMMAND="curl -sf -u \"${USERNAME}:${PASSWORD}\""
+fi
+
+# Health check loop
+RETRY_COUNT=0
+MAX_RETRIES=12 # Wait for 60 seconds max
+# Use eval to correctly execute the command string with quotes
+while ! eval "${CURL_COMMAND} ${HEALTH_CHECK_URL}" > /dev/null; do
+    RETRY_COUNT=$((RETRY_COUNT+1))
+    if [ ${RETRY_COUNT} -ge ${MAX_RETRIES} ]; then
+        echo "SillyTavern failed to start. Exiting."
+        kill ${SERVER_PID}
+        exit 1
+    fi
+    echo "SillyTavern is still starting or not responsive on port 8000, waiting 5 seconds..."
+    sleep 5
+done
+
+echo "SillyTavern started successfully! Beginning periodic keep-alive..."
+
+# --- BEGIN: Install Extensions after SillyTavern startup ---
+install_extensions() {
+    echo "--- Waiting 40 seconds before installing extensions... ---"
+    sleep 40
+    
+    echo "--- Checking for EXTENSIONS environment variable ---"
+    if [ -n "$EXTENSIONS" ]; then
+        echo "*** Installing Extensions specified in EXTENSIONS environment variable: $EXTENSIONS ***"
+        
+        # Determine installation directory based on INSTALL_FOR_ALL_USERS
+        if [ "$INSTALL_FOR_ALL_USERS" = "true" ]; then
+            # System-level installation (for all users)
+            EXTENSIONS_DIR="./public/scripts/extensions/third-party"
+            echo "Installing extensions for all users in: $EXTENSIONS_DIR"
+        else
+            # User-level installation (for default user only)
+            EXTENSIONS_DIR="./data/default-user/extensions"
+            echo "Installing extensions for default user in: $EXTENSIONS_DIR"
+        fi
+        
+        # Ensure extensions directory exists
+        mkdir -p "$EXTENSIONS_DIR" && chown node:node "$EXTENSIONS_DIR"
+        
+        # Set comma as delimiter
+        IFS=','
+        
+        # Loop through each extension URL
+        for extension_url in $EXTENSIONS; do
+            # Trim leading/trailing whitespace
+            extension_url=$(echo "$extension_url" | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
+            if [ -z "$extension_url" ]; then continue; fi
+            
+            # Extract extension name
+            extension_name_git=$(basename "$extension_url")
+            extension_name=${extension_name_git%.git}
+            extension_dir="$EXTENSIONS_DIR/$extension_name"
+            
+            echo "--- Installing extension: $extension_name from $extension_url into $extension_dir ---"
+            
+            # Remove existing dir if it exists
+            rm -rf "$extension_dir"
+            
+            # Clone the extension
+            git clone --depth 1 "$extension_url" "$extension_dir"
+            
+            # Check if extension has package.json and install dependencies if needed
+            if [ -f "$extension_dir/package.json" ]; then
+                echo "--- Installing dependencies for $extension_name ---"
+                (cd "$extension_dir" && npm install --no-audit --no-fund --loglevel=error --no-progress --omit=dev --force && npm cache clean --force) || echo "WARN: Failed to install dependencies for $extension_name"
+            else
+                echo "--- No package.json found for $extension_name, skipping dependency install. ---"
+            fi || echo "WARN: Failed to clone $extension_name from $extension_url, skipping..."
+        done
+        
+        # Reset IFS
+        unset IFS
+        
+        # Fix permissions for extensions directory after installation
+        echo "--- Setting permissions for extensions directory ---"
+        chown -R node:node "$EXTENSIONS_DIR"
+        
+        echo "*** Extensions installation finished. ***"
+    else
+        echo 'EXTENSIONS environment variable is not set or empty, skipping extensions installation.'
+    fi
+}
+
+# Run the extension installation in the background
+install_extensions &
+# --- END: Install Extensions after SillyTavern startup ---
+
+# Keep-alive loop
+while kill -0 ${SERVER_PID} 2>/dev/null; do
+    echo "Sending keep-alive request to ${HEALTH_CHECK_URL}"
+    # Use eval here as well for the keep-alive command
+    eval "${CURL_COMMAND} ${HEALTH_CHECK_URL}" > /dev/null || echo "Keep-alive request failed."
+    echo "Keep-alive request sent. Sleeping for 30 minutes."
+    sleep 1800
+done &
+
+wait ${SERVER_PID}