chore: integrate current open pull requests

.env.example

@@ -0,0 +1,184 @@
+# ==========================================
+# AstrBot Instance Configuration: ${INSTANCE_NAME}
+# AstrBot 实例配置文件：${INSTANCE_NAME}
+# ==========================================
+# 将此文件复制为 .env 并根据需要修改。
+# Copy this file to .env and modify as needed.
+# 注意：在此处设置的变量将覆盖默认配置。
+# Note: Variables set here override application defaults.
+
+# ------------------------------------------
+# 实例标识 / Instance Identity
+# ------------------------------------------
+
+# 实例名称（用于日志和服务名）
+# Instance name (used in logs/service names)
+INSTANCE_NAME="${INSTANCE_NAME}"
+
+# ------------------------------------------
+# 核心配置 / Core Configuration
+# ------------------------------------------
+
+# AstrBot 根目录路径
+# AstrBot root directory path
+# 默认 Default: 当前工作目录，桌面客户端为 ~/.astrbot，服务器为 /var/lib/astrbot/<instance>/
+# 示例 Example: /var/lib/astrbot/mybot
+ASTRBOT_ROOT="${ASTRBOT_ROOT}"
+
+# 日志等级
+# Log level
+# 可选值 Values: DEBUG, INFO, WARNING, ERROR, CRITICAL
+# 默认 Default: INFO
+# ASTRBOT_LOG_LEVEL=INFO
+
+# 启用插件热重载（开发时有用）
+# Enable plugin hot reload (useful for development)
+# 可选值 Values: 0 (禁用 disabled), 1 (启用 enabled)
+# 默认 Default: 0
+# ASTRBOT_RELOAD=0
+
+# 禁用匿名使用统计
+# Disable anonymous usage statistics
+# 可选值 Values: 0 (启用统计 enabled), 1 (禁用统计 disabled)
+# 默认 Default: 0
+ASTRBOT_DISABLE_METRICS=0
+
+# 覆盖 Python 可执行文件路径（用于本地代码执行功能）
+# Override Python executable path (for local code execution)
+# 示例 Example: /usr/bin/python3, /home/user/.pyenv/shims/python
+# PYTHON=/usr/bin/python3
+
+# 启用演示模式（可能限制部分功能）
+# Enable demo mode (may restrict certain features)
+# 可选值 Values: True, False
+# 默认 Default: False
+# DEMO_MODE=False
+
+# 启用测试模式（影响日志和部分行为）
+# Enable testing mode (affects logging and behavior)
+# 可选值 Values: True, False
+# 默认 Default: False
+# TESTING=False
+
+# 标记：是否通过桌面客户端执行（主要用于内部）
+# Flag: running via desktop client (internal use)
+# 可选值 Values: 0, 1
+# ASTRBOT_DESKTOP_CLIENT=0
+
+# 标记：是否通过 systemd 服务执行
+# Flag: running via systemd service
+# 可选值 Values: 0, 1
+ASTRBOT_SYSTEMD=1
+
+# ------------------------------------------
+# 管理面板配置 / Dashboard Configuration
+# ------------------------------------------
+
+# 启用或禁用 WebUI 管理面板
+# Enable or disable WebUI dashboard
+# 可选值 Values: True, False
+# 默认 Default: True
+ASTRBOT_DASHBOARD_ENABLE=True
+
+# 允许跨域请求的来源域名（多个用逗号分隔，允许所有则用 *）
+# Allowed CORS origins for WebUI dashboard (comma-separated, or * for all)
+# 示例 Example: https://dash.astrbot.men
+# 默认 Default: *
+# ASTRBOT_CORS_ALLOW_ORIGIN="*"
+
+# ------------------------------------------
+# 国际化配置 / Internationalization Configuration
+# ------------------------------------------
+
+# CLI 界面语言
+# CLI interface language
+# 可选值 Values: zh (中文), en (英文)
+# 默认 Default: zh (跟随系统 locale / follows system locale)
+# ASTRBOT_CLI_LANG=zh
+
+# ------------------------------------------
+# 网络配置 / Network Configuration
+# ------------------------------------------
+
+# API 绑定主机
+# API bind host
+# 示例 Example: 0.0.0.0 (所有接口 all interfaces), 127.0.0.1 (仅本地 localhost only)
+ASTRBOT_HOST="${ASTRBOT_HOST}"
+
+# API 绑定端口
+# API bind port
+# 示例 Example: 3000, 6185, 8080
+ASTRBOT_PORT="${ASTRBOT_PORT}"
+
+# 是否为 API 启用 SSL/TLS
+# Enable SSL/TLS for API
+# 可选值 Values: true, false
+# 默认 Default: false
+ASTRBOT_SSL_ENABLE=false
+
+# SSL 证书路径（PEM 格式）
+# SSL certificate path (PEM format)
+# 示例 Example: /etc/astrbot/certs/myinstance/fullchain.pem
+ASTRBOT_SSL_CERT=""
+
+# SSL 私钥路径（PEM 格式）
+# SSL private key path (PEM format)
+# 示例 Example: /etc/astrbot/certs/myinstance/privkey.pem
+ASTRBOT_SSL_KEY=""
+
+# SSL CA 证书链路径（可选，用于客户端验证）
+# SSL CA certificates bundle (optional, for client verification)
+# 示例 Example: /etc/ssl/certs/ca-certificates.crt
+ASTRBOT_SSL_CA_CERTS=""
+
+# ------------------------------------------
+# 代理配置 / Proxy Configuration
+# ------------------------------------------
+
+# HTTP 代理地址
+# HTTP proxy URL
+# 示例 Example: http://127.0.0.1:7890, socks5://127.0.0.1:1080
+# http_proxy=
+
+# HTTPS 代理地址
+# HTTPS proxy URL
+# 示例 Example: http://127.0.0.1:7890, socks5://127.0.0.1:1080
+# https_proxy=
+
+# 不走代理的主机列表（逗号分隔）
+# Hosts to bypass proxy (comma-separated)
+# 示例 Example: localhost,127.0.0.1,192.168.0.0/16,.local
+# no_proxy=localhost,127.0.0.1
+
+# ------------------------------------------
+# 第三方集成 / Third-party Integrations
+# ------------------------------------------
+
+# 阿里云 DashScope API 密钥（用于 Rerank 服务）
+# Alibaba DashScope API Key (for Rerank service)
+# 获取地址 Get from: https://dashscope.console.aliyun.com/
+# 示例 Example: sk-xxxxxxxxxxxx
+# DASHSCOPE_API_KEY=
+
+# Coze 集成
+# Coze integration
+# 获取地址 Get from: https://www.coze.com/
+# COZE_API_KEY=
+# COZE_BOT_ID=
+
+# 计算机控制相关的数据目录（用于截图/文件存储）
+# Computer control data directory (for screenshots/file storage)
+# 示例 Example: /var/lib/astrbot/bay_data
+# BAY_DATA_DIR=
+
+# ------------------------------------------
+# 平台特定配置 / Platform-specific Configuration
+# ------------------------------------------
+
+# QQ 官方机器人测试模式开关
+# QQ official bot test mode
+# 可选值 Values: on, off
+# 默认 Default: off
+# TEST_MODE=off
+
+# End of template / 模板结束

.envrc

@@ -0,0 +1,2 @@
+git pull
+git status

.github/actions/build-dashboard/action.yml

@@ -0,0 +1,46 @@
+name: Build dashboard
+description: Build the dashboard and optionally package or copy the dist output.
+
+inputs:
+  version:
+    description: Version string to write into dist/assets/version. Defaults to the checked-out commit SHA.
+    required: false
+    default: ""
+  archive-name:
+    description: Optional zip file name to create under the dashboard directory.
+    required: false
+    default: ""
+  copy-dist-to:
+    description: Optional repository-relative directory to receive dashboard/dist.
+    required: false
+    default: ""
+
+runs:
+  using: composite
+  steps:
+    - name: Build dashboard dist
+      shell: bash
+      run: |
+        cd dashboard
+        pnpm install --frozen-lockfile
+        pnpm run build
+        mkdir -p dist/assets
+        version="${{ inputs.version }}"
+        if [ -z "$version" ]; then
+          version="$(git rev-parse HEAD)"
+        fi
+        echo "$version" > dist/assets/version
+
+    - name: Archive dashboard dist
+      if: ${{ inputs.archive-name != '' }}
+      shell: bash
+      run: |
+        cd dashboard
+        zip -r "${{ inputs.archive-name }}" dist
+
+    - name: Copy dashboard dist
+      if: ${{ inputs.copy-dist-to != '' }}
+      shell: bash
+      run: |
+        mkdir -p "${{ inputs.copy-dist-to }}"
+        cp -r dashboard/dist "${{ inputs.copy-dist-to }}/"

.github/actions/setup-pnpm-node/action.yml

@@ -0,0 +1,36 @@
+name: Setup pnpm and Node.js
+description: Install pnpm and configure Node.js with pnpm cache.
+
+inputs:
+  pnpm-version:
+    description: pnpm version to install.
+    required: true
+  node-version:
+    description: Node.js version to install.
+    required: true
+  cache-dependency-path:
+    description: Optional pnpm lockfile path for setup-node cache.
+    required: false
+    default: ""
+
+runs:
+  using: composite
+  steps:
+    - name: Setup pnpm
+      uses: pnpm/action-setup@v6.0.3
+      with:
+        version: ${{ inputs.pnpm-version }}
+
+    - name: Setup Node.js with pnpm cache
+      if: ${{ inputs.cache-dependency-path != '' }}
+      uses: actions/setup-node@v6
+      with:
+        node-version: ${{ inputs.node-version }}
+        cache: pnpm
+        cache-dependency-path: ${{ inputs.cache-dependency-path }}
+
+    - name: Setup Node.js
+      if: ${{ inputs.cache-dependency-path == '' }}
+      uses: actions/setup-node@v6
+      with:
+        node-version: ${{ inputs.node-version }}

.github/actions/setup-python-uv/action.yml

@@ -0,0 +1,47 @@
+name: Setup Python and uv
+description: Set up Python, install uv, and optionally sync dependencies.
+inputs:
+  python-version:
+    description: Python version to install.
+    required: false
+    default: "3.12"
+  uv-version:
+    description: uv version to install.
+    required: false
+    default: "0.10.12"
+  sync-deps:
+    description: Whether to run dependency sync via uv.
+    required: false
+    default: "false"
+  sync-args:
+    description: Extra arguments passed to `uv sync`.
+    required: false
+    default: ""
+runs:
+  using: composite
+  steps:
+    - name: Set up Python
+      uses: actions/setup-python@v6
+      with:
+        python-version: ${{ inputs.python-version }}
+
+    - name: Set up uv
+      uses: astral-sh/setup-uv@v7.6.0
+      with:
+        version: ${{ inputs.uv-version }}
+        enable-cache: "true"
+
+    - name: Sync dependencies
+      if: ${{ inputs.sync-deps == 'true' }}
+      shell: bash
+      run: |
+        set -euo pipefail
+        sync_args_raw="${{ inputs.sync-args }}"
+        if [[ -z "$sync_args_raw" ]]; then
+          uv sync
+          exit 0
+        fi
+
+        # Split configured sync arguments into an array to avoid glob expansion.
+        read -r -a sync_args <<< "$sync_args_raw"
+        uv sync "${sync_args[@]}"

.github/workflows/build-docs.yml

@@ -1,33 +1,33 @@
-name: release
+name: Deploy Docs
 
 on:
   push:
     tags:
       - 'v*'
   workflow_dispatch:
 
+env:
+  PNPM_VERSION: 10.28.2
+  NODE_VERSION: '24.13.0'
+
 jobs:
   build:
     runs-on: ubuntu-latest # 运行环境
     steps:
       - name: checkout
         uses: actions/checkout@v6
-      - name: Setup pnpm
-        uses: pnpm/action-setup@v6.0.8
-        with:
-          version: 10.28.2
-      - name: Setup Node.js
-        uses: actions/setup-node@v6
+      - name: Setup pnpm and Node.js
+        uses: ./.github/actions/setup-pnpm-node
         with:
-          node-version: "24.13.0"
-          cache: "pnpm"
+          pnpm-version: ${{ env.PNPM_VERSION }}
+          node-version: ${{ env.NODE_VERSION }}
           cache-dependency-path: docs/pnpm-lock.yaml
       - name: Install dependencies
+        working-directory: docs
         run: pnpm install --frozen-lockfile
-        working-directory: './docs'
       - name: Build docs
+        working-directory: docs
         run: pnpm run docs:build
-        working-directory: './docs'
       - name: scp
         uses: appleboy/scp-action@v1.0.0
         with: