feat: add Docker image support for local testing and CI/CD

- Add Dockerfile for bootcs-cli base image
- Add bootcs-evaluate.sh script for standardized evaluation
- Add GitHub Actions workflow for building and pushing images
- Update README with Docker usage instructions

Author: William Yang

.github/workflows/docker.yml

@@ -0,0 +1,71 @@
+name: Build and Push Docker Image
+
+on:
+  push:
+    branches: [main]
+    tags: ['v*']
+  pull_request:
+    branches: [main]
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_NAME: ${{ github.repository }}
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to Container Registry
+        if: github.event_name != 'pull_request'
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract metadata
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+          tags: |
+            type=ref,event=branch
+            type=ref,event=pr
+            type=semver,pattern={{version}}
+            type=semver,pattern={{major}}.{{minor}}
+            type=sha,prefix=
+            type=raw,value=latest,enable={{is_default_branch}}
+
+      - name: Build and push
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          push: ${{ github.event_name != 'pull_request' }}
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+
+  test:
+    runs-on: ubuntu-latest
+    needs: build
+    if: github.event_name != 'pull_request'
+    
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Test Docker image
+        run: |
+          docker run --rm ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}:latest --version
+          echo "Docker image test passed!"

Dockerfile

@@ -0,0 +1,35 @@
+# bootcs-cli Docker Image
+# 用于本地自测和 GitHub Actions 评测
+
+FROM python:3.11-slim
+
+LABEL org.opencontainers.image.source="https://github.com/bootcs-cn/bootcs-cli"
+LABEL org.opencontainers.image.description="BootCS CLI for code checking and evaluation"
+LABEL org.opencontainers.image.licenses="GPL-3.0"
+
+# 安装系统依赖
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    build-essential \
+    clang \
+    gcc \
+    git \
+    make \
+    valgrind \
+    && rm -rf /var/lib/apt/lists/*
+
+# 设置工作目录
+WORKDIR /app
+
+# 复制项目文件
+COPY pyproject.toml README.md LICENSE ./
+COPY bootcs/ ./bootcs/
+
+# 安装 bootcs
+RUN pip install --no-cache-dir -e .
+
+# 创建工作目录
+WORKDIR /workspace
+
+# 入口点
+ENTRYPOINT ["python", "-m", "bootcs"]
+CMD ["--help"]

README.md

@@ -18,6 +18,8 @@ BootCS 命令行工具 - 用于代码检查和提交
 
 ## 安装
 
+### 方式一：Python 安装
+
 ```bash
 # 开发模式安装
 git clone https://github.com/bootcs-cn/bootcs-cli.git
@@ -27,6 +29,16 @@ source .venv/bin/activate
 pip install -e .
 ```
 
+### 方式二：Docker 镜像
+
+```bash
+# 拉取基础镜像
+docker pull ghcr.io/bootcs-cn/bootcs-cli:latest
+
+# 拉取包含 CS50 检查脚本的镜像
+docker pull ghcr.io/bootcs-cn/bootcs-cli:cs50
+```
+
 ## 快速开始
 
 ### 1. 登录
@@ -102,6 +114,71 @@ bootcs logout
 | `-m, --message MSG` | 自定义提交消息                          |
 | `-y, --yes`         | 跳过确认提示                            |
 
+## Docker 使用
+
+### 本地自测
+
+使用 Docker 镜像可以在本地快速进行代码检查，无需安装 Python 环境：
+
+```bash
+# 使用基础镜像检查代码
+docker run --rm -v $(pwd):/workspace -v /path/to/checks:/checks \
+  ghcr.io/bootcs-cn/bootcs-cli:latest \
+  check course-cs50/hello --local /checks/hello
+
+# 使用课程专用镜像（已包含检查脚本）
+docker run --rm -v $(pwd):/workspace \
+  ghcr.io/bootcs-cn/bootcs-cli:cs50 \
+  check course-cs50/hello --local /checks/hello
+```
+
+### GitHub Actions 评测
+
+在 GitHub Actions 中使用 Docker 镜像进行自动评测：
+
+```yaml
+# .github/workflows/evaluate.yml
+name: Evaluate
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  evaluate:
+    runs-on: ubuntu-latest
+    container:
+      image: ghcr.io/bootcs-cn/bootcs-cli:cs50
+    steps:
+      - uses: actions/checkout@v4
+      - name: Run check
+        run: |
+          bootcs check course-cs50/hello --local /checks/hello --output json > result.json
+      - name: Upload result
+        uses: actions/upload-artifact@v4
+        with:
+          name: result
+          path: result.json
+```
+
+### 使用评测脚本
+
+镜像中包含 `bootcs-evaluate.sh` 脚本，用于标准化评测：
+
+```bash
+# 脚本用法
+bootcs-evaluate.sh <slug> <checks_path> <student_code_path>
+
+# 示例
+docker run --rm \
+  -v $(pwd):/workspace \
+  -v /path/to/output:/output \
+  ghcr.io/bootcs-cn/bootcs-cli:cs50 \
+  bootcs-evaluate.sh course-cs50/hello /checks/hello /workspace
+
+# 结果输出到 /output/result.json
+```
+
 ## 开发
 
 ```bash

scripts/bootcs-evaluate.sh

@@ -0,0 +1,52 @@
+#!/bin/bash
+# bootcs-evaluate.sh - 评测入口脚本
+# 用于 GitHub Actions 评测 workflow
+
+set -e
+
+# 参数
+SLUG="${1:-}"
+CHECKS_PATH="${2:-/checks}"
+STUDENT_CODE_PATH="${3:-/workspace}"
+
+if [ -z "$SLUG" ]; then
+    echo "Usage: bootcs-evaluate.sh <slug> [checks_path] [student_code_path]"
+    echo "Example: bootcs-evaluate.sh course-cs50/hello /checks /workspace"
+    exit 1
+fi
+
+# 解析 slug
+COURSE=$(echo "$SLUG" | cut -d'/' -f1)
+STAGE=$(echo "$SLUG" | cut -d'/' -f2)
+
+# 检查目录
+CHECK_DIR="${CHECKS_PATH}/${STAGE}"
+if [ ! -d "$CHECK_DIR" ]; then
+    echo "Error: Check directory not found: $CHECK_DIR"
+    exit 1
+fi
+
+# 切换到学生代码目录
+cd "$STUDENT_CODE_PATH"
+
+echo "========================================"
+echo "BootCS Evaluation"
+echo "========================================"
+echo "Slug:        $SLUG"
+echo "Check Dir:   $CHECK_DIR"
+echo "Working Dir: $(pwd)"
+echo "========================================"
+echo ""
+
+# 运行检查
+python -m bootcs check "$SLUG" --local "$CHECK_DIR" --output json
+
+# 获取退出码
+EXIT_CODE=$?
+
+echo ""
+echo "========================================"
+echo "Evaluation completed with exit code: $EXIT_CODE"
+echo "========================================"
+
+exit $EXIT_CODE