dev

.env.example

@@ -0,0 +1,93 @@
+# ==========================================
+# AstrBot Environment Configuration Example
+# ==========================================
+# Copy this file to .env and adjust the values as needed.
+# Note: Variables set here will override default configurations.
+
+# ------------------------------------------
+# Core Configuration (核心配置)
+# ------------------------------------------
+
+# AstrBot root directory path. Defaults to current working directory or ~/.astrbot for desktop client.
+# ASTRBOT_ROOT=/path/to/astrbot
+
+# Log level. Options: DEBUG, INFO, WARNING, ERROR, CRITICAL. Default: INFO.
+# ASTRBOT_LOG_LEVEL=INFO
+
+# Enable plugin auto-reload. Set to "1" to enable. Useful for development.
+# ASTRBOT_RELOAD=0
+
+# Disable metrics upload. Set to "1" to disable anonymous usage statistics.
+# ASTRBOT_DISABLE_METRICS=0
+
+# Python executable path override (used for local code execution feature).
+# PYTHON=/usr/bin/python3
+
+# Enable demo mode (might restrict some features).
+# DEMO_MODE=False
+
+# Enable testing mode (affects logging and some behaviors).
+# TESTING=False
+
+# Flag indicating execution via desktop client (Internal use mostly).
+# ASTRBOT_DESKTOP_CLIENT=0
+
+# Flag indicating execution via systemd service.
+# ASTRBOT_SYSTEMD=0
+
+# ------------------------------------------
+# Dashboard Configuration (管理面板配置)
+# ------------------------------------------
+
+# Enable or disable the WebUI Dashboard. Default: True.
+# ASTRBOT_DASHBOARD_ENABLE=True
+
+# Dashboard bind host. Default: 0.0.0.0 (listen on all interfaces).
+# ASTRBOT_DASHBOARD_HOST=0.0.0.0
+
+# Dashboard bind port. Default: 6185.
+# ASTRBOT_DASHBOARD_PORT=6185
+
+# Enable SSL (HTTPS) for the dashboard.
+# ASTRBOT_DASHBOARD_SSL_ENABLE=False
+
+# SSL Certificate path (required if SSL is enabled).
+# ASTRBOT_DASHBOARD_SSL_CERT=/path/to/cert.pem
+
+# SSL Key path (required if SSL is enabled).
+# ASTRBOT_DASHBOARD_SSL_KEY=/path/to/key.pem
+
+# SSL CA Certificates path (optional).
+# ASTRBOT_DASHBOARD_SSL_CA_CERTS=/path/to/ca.pem
+
+# ------------------------------------------
+# Network Configuration (网络配置)
+# ------------------------------------------
+
+# HTTP/HTTPS Proxy URL (e.g., http://127.0.0.1:7890).
+# http_proxy=
+# https_proxy=
+
+# No proxy list (comma-separated domains/IPs to bypass proxy).
+# no_proxy=localhost,127.0.0.1
+
+# ------------------------------------------
+# Integrations (第三方集成)
+# ------------------------------------------
+
+# Alibaba DashScope API Key (used for Rerank service).
+# DASHSCOPE_API_KEY=sk-xxxxxxxxxxxx
+
+# Coze Integration
+# COZE_API_KEY=
+# COZE_BOT_ID=
+
+# Computer Use data directory (for screenshot/file storage related to computer control).
+# BAY_DATA_DIR=
+
+# ------------------------------------------
+# Platform Specific (平台特定配置)
+# ------------------------------------------
+
+# Test mode for QQ Official Bot.
+# TEST_MODE=off

.envrc

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

.github/workflows/deploy-dashboard.yml

@@ -0,0 +1,53 @@
+name: Deploy Dashboard to GitHub Pages
+
+on:
+  schedule:
+    - cron: '0 0 * * *'  # Runs daily at midnight UTC
+  workflow_dispatch:      # Allow manual triggering
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Only allow one concurrent deployment at a time
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+
+      - name: Install dependencies
+        working-directory: dashboard
+        run: bun install
+
+      - name: Build dashboard
+        working-directory: dashboard
+        run: bun run build
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: dashboard/dist
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.github/workflows/smoke_test.yml

@@ -5,9 +5,9 @@ on:
     branches:
       - master
     paths-ignore:
-      - 'README*.md'
-      - 'changelogs/**'
-      - 'dashboard/**'
+      - "README*.md"
+      - "changelogs/**"
+      - "dashboard/**"
   pull_request:
   workflow_dispatch:
 
@@ -16,7 +16,7 @@ jobs:
     name: Run smoke tests
     runs-on: ubuntu-latest
     timeout-minutes: 10
-    
+
     steps:
       - name: Checkout
         uses: actions/checkout@v6
@@ -26,8 +26,8 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v6
         with:
-          python-version: '3.12'
-      
+          python-version: "3.12"
+
       - name: Install UV package manager
         run: |
           pip install uv
@@ -40,6 +40,9 @@ jobs:
       - name: Run smoke tests
         run: |
           uv run main.py &
+          # uv tool install -e . --force
+          # astrbot init -y 
+          # astrbot run --backend-only &
           APP_PID=$!
 
           echo "Waiting for application to start..."

.gitignore

@@ -61,5 +61,5 @@ GenieData/
 .codex/
 .opencode/
 .kilocode/
+.serena
 .worktrees/
-

.python-version

@@ -1 +1 @@
-3.12
+3.12

AGENTS.md

@@ -3,8 +3,10 @@
 ### Core
 
 ```
-uv sync
-uv run main.py
+uv tool install -e . --force
+astrbot init
+astrbot run # start the bot 
+astrbot run --backend-only # start the backend only
 ```
 
 Exposed an API server on `http://localhost:6185` by default.
@@ -13,8 +15,8 @@ Exposed an API server on `http://localhost:6185` by default.
 
 ```
 cd dashboard
-pnpm install # First time only. Use npm install -g pnpm if pnpm is not installed.
-pnpm dev
+bun install # First time only.
+bun dev
 ```
 
 Runs on `http://localhost:3000` by default.
@@ -27,6 +29,15 @@ Runs on `http://localhost:3000` by default.
 4. When committing, ensure to use conventional commits messages, such as `feat: add new agent for data analysis` or `fix: resolve bug in provider manager`.
 5. Use English for all new comments.
 6. For path handling, use `pathlib.Path` instead of string paths, and use `astrbot.core.utils.path_utils` to get the AstrBot data and temp directory.
+7. Use Python 3.12+ type hinting syntax (e.g., `list[str]` over `List[str]`, `int | None` over `Optional[int]`). Avoid using `Any` and ensure comprehensive type annotations are provided.
+8. When introducing new environment variables:
+   - Use the `ASTRBOT_` prefix for naming (e.g., `ASTRBOT_ENABLE_FEATURE`).
+   - Add the variable and description to `.env.example`.
+   - Update `astrbot/cli/commands/cmd_run.py`:
+     - Add to the module docstring under "Environment Variables Used in Project".
+     - Add to the `keys_to_print` list in the `run` function for debug output.
+9. To check all available CLI commands and their usage recursively, run `astrbot help --all`.
+
 
 ## PR instructions