Initial commit

.gitea/workflows/autograde.yml

@@ -0,0 +1,178 @@
+name: autograde-assignment-01-infocard
+
+on:
+  push:
+    branches:
+      - main
+    tags:
+      - 'submit'
+      - 'submit-*'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  check-trigger:
+    runs-on: docker
+    container:
+      image: alpine:latest
+    outputs:
+      should_run: ${{ steps.check.outputs.trigger }}
+    steps:
+      - name: Check commit message for trigger keyword
+        id: check
+        run: |
+          COMMIT_MSG="${{ github.event.head_commit.message || '' }}"
+          echo "Commit message: $COMMIT_MSG"
+          if echo "$COMMIT_MSG" | grep -q "完成作业"; then
+            echo "trigger=true" >> $GITHUB_OUTPUT
+            echo "✅ Commit contains \"完成作业\"，即将执行评分"
+          else:
+            echo "trigger=false" >> $GITHUB_OUTPUT
+            echo "⛔ 只有包含“完成作业”的提交才会执行自动评分" >&2
+          fi
+
+  grade:
+    needs: check-trigger
+    if: needs.check-trigger.outputs.should_run == 'true'
+    runs-on: docker
+    container:
+      image: python:3.11
+      options: --user root
+    timeout-minutes: 20
+
+    steps:
+      - name: Configure APT mirror (Aliyun)
+        run: |
+          set -e
+          for f in /etc/apt/sources.list /etc/apt/sources.list.d/*.list /etc/apt/sources.list.d/*.sources; do
+            [ -f "$f" ] || continue
+            sed -i -E 's|https?://deb.debian.org|http://mirrors.aliyun.com|g' "$f" || true
+            sed -i -E 's|https?://security.debian.org|http://mirrors.aliyun.com/debian-security|g' "$f" || true
+            sed -i -E 's|https?://archive.ubuntu.com|http://mirrors.aliyun.com|g' "$f" || true
+            sed -i -E 's|https?://ports.ubuntu.com|http://mirrors.aliyun.com|g' "$f" || true
+          done
+          apt-get -o Acquire::Check-Valid-Until=false update -y
+          DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends git ca-certificates python3-pip rsync fonts-noto-cjk fonts-wqy-microhei
+          rm -rf /var/lib/apt/lists/*
+
+      - name: Checkout code
+        env:
+          GITHUB_TOKEN: ${{ github.token }}
+        run: |
+          git config --global --add safe.directory ${{ github.workspace }}
+          git init
+          REPO_URL="${{ github.server_url }}/${{ github.repository }}.git"
+          AUTH_URL=$(echo "$REPO_URL" | sed "s|://|://${GITHUB_TOKEN}@|")
+          git remote add origin "$AUTH_URL"
+          git fetch --depth=1 origin ${{ github.sha }}
+          git checkout ${{ github.sha }}
+
+      - name: Fix permissions
+        run: chown -R $(whoami):$(whoami) ${{ github.workspace }} || true
+
+      - name: Fetch hidden tests and grading scripts
+        working-directory: ${{ github.workspace }}
+        env:
+          EXTERNAL_GITEA_HOST: ${{ secrets.EXTERNAL_GITEA_HOST }}
+        run: |
+          set -e
+          TESTS_USERNAME="${RUNNER_TESTS_USERNAME:-}"
+          TESTS_TOKEN="${RUNNER_TESTS_TOKEN:-}"
+          if [ -z "$TESTS_TOKEN" ] || [ -z "$TESTS_USERNAME" ]; then
+            echo "❌ RUNNER_TESTS_USERNAME / RUNNER_TESTS_TOKEN not set!"
+            exit 1
+          fi
+
+          # Resolve host
+          if [ -n "$EXTERNAL_GITEA_HOST" ]; then
+            HOST="$EXTERNAL_GITEA_HOST"
+          elif [ -n "$GITEA_ROOT_URL" ]; then
+            HOST=$(echo "$GITEA_ROOT_URL" | sed 's|https\?://||' | sed 's|/$||')
+          else
+            HOST=$(echo "${{ github.server_url }}" | sed 's|https\?://||' | cut -d'/' -f1)
+          fi
+
+          ORG=$(echo "${{ github.repository }}" | cut -d'/' -f1)
+          REPO_NAME=$(echo "${{ github.repository }}" | cut -d'/' -f2)
+
+          if echo "$REPO_NAME" | grep -q -- '-stu_'; then
+            ASSIGNMENT_ID=$(echo "$REPO_NAME" | sed 's/-stu_.*//')
+          elif echo "$REPO_NAME" | grep -q -- '-template'; then
+            ASSIGNMENT_ID=$(echo "$REPO_NAME" | sed 's/-template.*//')
+          else
+            ASSIGNMENT_ID="assignment-01-infocard"
+          fi
+
+          echo "📥 Fetching tests from ${ORG}/${ASSIGNMENT_ID}-tests..."
+          AUTH_URL="http://${TESTS_USERNAME}:${TESTS_TOKEN}@${HOST}/${ORG}/${ASSIGNMENT_ID}-tests.git"
+          git -c http.sslVerify=false clone --depth=1 "$AUTH_URL" _priv_tests
+
+          rm -rf .autograde
+          mkdir -p .autograde
+          cp _priv_tests/autograde/*.py .autograde/
+          cp _priv_tests/autograde/*.sh .autograde/ 2>/dev/null || true
+
+          # Copy Python tests
+          if [ -d "_priv_tests/python" ]; then
+            mkdir -p tests
+            rsync -a _priv_tests/python/ tests/
+            echo "✅ Private tests copied"
+          fi
+
+          # Copy test groups
+          if [ -f "_priv_tests/test_groups.json" ]; then
+            cp _priv_tests/test_groups.json .
+          fi
+
+          # Copy LLM rubrics
+          if [ -d "_priv_tests/llm" ]; then
+            mkdir -p .llm_rubrics
+            cp _priv_tests/llm/*.json .llm_rubrics/ 2>/dev/null || true
+          fi
+
+          rm -rf _priv_tests
+
+      - name: Install Python dependencies
+        run: |
+          pip config set global.index-url https://mirrors.aliyun.com/pypi/simple
+          pip install --no-cache-dir -r requirements.txt
+
+      - name: Run tests
+        run: |
+          mkdir -p test-results
+          pytest --junitxml=test-results/junit.xml || true
+
+      - name: Grade programming tests
+        run: |
+          python ./.autograde/grade_grouped.py \
+            --junit-dir test-results \
+            --groups test_groups.json \
+            --out grade.json \
+            --summary summary.md
+
+      - name: Grade REPORT.md
+        run: |
+          if [ -f REPORT.md ] && [ -f .llm_rubrics/rubric_report.json ]; then
+            python ./.autograde/llm_grade.py \
+              --question "请评估这份反思报告" \
+              --answer REPORT.md \
+              --rubric .llm_rubrics/rubric_report.json \
+              --out report_grade.json \
+              --summary report_summary.md
+            echo "✅ REPORT.md graded"
+          else
+            echo '{"total": 0, "flags": ["missing_file"]}' > report_grade.json
+            echo "⚠️ REPORT.md or rubric not found"
+          fi
+
+      - name: Aggregate grades
+        run: |
+          python ./.autograde/aggregate_grade.py \
+            --programming grade.json \
+            --report report_grade.json \
+            --out final_grade.json \
+            --summary final_summary.md
+

.gitignore

@@ -0,0 +1,15 @@
+__pycache__/
+.pytest_cache/
+.autograde/
+.llm_rubrics/
+test-results/
+*.pyc
+*.pyo
+.DS_Store
+grade*.json
+final_grade.json
+*.xml
+*.pdf
+metadata.json
+report_*.json
+

README.md

@@ -0,0 +1,25 @@
+# 作业 1：个人信息卡生成器
+
+## 任务
+- 在 `src/card_generator.py` 完成 `generate_card`：格式化输出个人信息卡。
+- 支持可选字段为空时的占位、手机号标准化、邮箱基本校验、宽度控制。
+- 通过公开测试与隐藏测试；提交 `REPORT.md` 反思。
+
+## 环境与依赖
+- Python 3.11+
+- 安装依赖：`pip install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple`
+
+## 本地运行
+```bash
+pytest -q
+```
+
+## 提交要求
+- 提交信息需包含关键字“完成作业”以触发评分。
+- 确保 `REPORT.md` 已填写。
+
+## 评分构成（总分 15）
+- Core 测试：8 分
+- Edge 测试：4 分
+- REPORT.md：3 分
+

REPORT.md

@@ -0,0 +1,33 @@
+# 作业 1 反思报告
+
+## 1. 我的 Prompt 策略
+
+你是如何向 AI 描述需求的？请分享你认为最有效的一次 prompt，并说明为什么它效果好。
+
+> [在此处回答]
+
+## 2. 与 AI 协作的体验
+
+在完成这个作业的过程中，你和 AI 的协作顺利吗？
+
+- 有没有 AI "理解错误"的时候？你是怎么纠正的？
+- 有没有让你惊喜的地方？
+- 整体体验如何？
+
+> [在此处回答]
+
+## 3. 我的思考与判断
+
+AI 可以生成代码，但最终的判断是你做的。请回答：
+
+- 最终代码中，哪部分是你主动要求修改或优化的？为什么？
+- 你是如何验证代码正确性的？（比如：自己写测试、手动测试、阅读代码等）
+
+> [在此处回答]
+
+## 4. 学习收获
+
+- 通过这次作业，你对"用 AI 写代码"有什么新的认识？
+- 你觉得在 AI 时代，程序员最重要的能力是什么？
+
+> [在此处回答]

requirements.txt

@@ -0,0 +1,3 @@
+pytest>=7.4
+python-dotenv>=1.0
+requests>=2.31

src/__init__.py

@@ -0,0 +1 @@
+

src/card_generator.py

@@ -0,0 +1,84 @@
+"""
+个人信息卡生成器
+
+你的任务是实现 generate_card 函数，生成格式化的个人信息卡。
+
+功能要求：
+1. 生成带边框的文本卡片，包含标题"个人信息卡"
+2. 显示姓名、邮箱、手机、学校、专业等信息
+3. 手机号标准化：无论输入格式如何，统一显示为 138-1234-5678 格式
+4. 邮箱校验：检查是否包含 @ 和 .，无效邮箱应抛出异常
+5. 可选字段（学校、专业）为空时显示"未填写"
+6. 支持多个手机号（以列表形式传入）
+7. 控制卡片宽度，超长内容需要处理（截断或换行）
+
+示例输出：
+┌────────────────────────────────┐
+│         个人信息卡              │
+├────────────────────────────────┤
+│ 姓名：张三                      │
+│ 邮箱：zhangsan@example.com     │
+│ 手机：138-1234-5678            │
+│ 学校：上海应用技术大学          │
+│ 专业：计算机科学与技术          │
+└────────────────────────────────┘
+
+提示：
+- 可以让 AI 帮你设计代码结构
+- 思考：如何处理中文和英文混合时的对齐问题？
+- 思考：邮箱校验应该多严格？基本检查还是正则表达式？
+"""
+
+from typing import Optional, Union, Sequence
+
+
+def generate_card(
+    name: str,
+    email: str,
+    phone: Union[str, Sequence[str]],
+    school: Optional[str] = None,
+    major: Optional[str] = None,
+) -> str:
+    """
+    生成个人信息卡
+
+    Args:
+        name: 姓名（必填）
+        email: 邮箱（必填，需要基本格式校验）
+        phone: 手机号（必填，可以是字符串或列表）
+        school: 学校（可选）
+        major: 专业（可选）
+
+    Returns:
+        str: 格式化的信息卡文本
+
+    Raises:
+        ValueError: 当邮箱格式无效时
+    """
+    # TODO: 在此实现你的代码
+    # 
+    # 建议的实现步骤：
+    # 1. 校验邮箱格式
+    # 2. 标准化手机号
+    # 3. 处理可选字段
+    # 4. 构建卡片内容
+    # 5. 添加边框和格式化
+    #
+    # 你可以：
+    # - 创建辅助函数来组织代码
+    # - 向 AI 描述你的需求，让它帮你实现
+    # - 先实现基本功能，再处理边界情况
+    pass
+
+
+if __name__ == "__main__":
+    # 测试你的实现
+    print(
+        generate_card(
+            name="张三",
+            email="zhangsan@example.com",
+            phone="13812345678",
+            school="上海应用技术大学",
+            major="经济与管理学院",
+        )
+    )

tests/test_public.py

@@ -0,0 +1,44 @@
+"""
+公开测试 - 学生可见
+这些测试帮助你验证基本功能是否正确
+"""
+
+import pytest
+from src.card_generator import generate_card
+
+
+def test_card_basic_info():
+    """测试基本信息是否正确显示"""
+    card = generate_card(
+        name="张三",
+        email="zhangsan@example.com",
+        phone="13812345678",
+        school="上海应用技术大学",
+        major="经济与管理学院",
+    )
+    # 检查基本内容
+    assert "张三" in card
+    assert "zhangsan@example.com" in card
+    assert "上海应用技术大学" in card
+    assert "个人信息卡" in card
+
+
+def test_card_has_border():
+    """测试卡片是否有边框"""
+    card = generate_card(
+        name="张三",
+        email="test@example.com",
+        phone="13812345678",
+    )
+    lines = card.strip().splitlines()
+    # 检查边框字符
+    assert lines[0].startswith("┌")
+    assert lines[0].endswith("┐")
+    assert lines[-1].startswith("└")
+    assert lines[-1].endswith("┘")
+
+
+def test_card_phone_format():
+    """测试手机号是否标准化为 138-1234-5678 格式"""
+    card = generate_card("张三", "test@example.com", "13812345678")
+    assert "138-1234-5678" in card