commit 475d442401199696f6335f26f8f87869570f0701 Author: hblu Date: Sat Dec 6 16:55:44 2025 +0800 Initial commit diff --git a/.gitea/workflows/autograde.yml b/.gitea/workflows/autograde.yml new file mode 100644 index 0000000..1ce1244 --- /dev/null +++ b/.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 + diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..dd6eea8 --- /dev/null +++ b/.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 + diff --git a/README.md b/README.md new file mode 100644 index 0000000..99c31d9 --- /dev/null +++ b/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 分 + diff --git a/REPORT.md b/REPORT.md new file mode 100644 index 0000000..06f374c --- /dev/null +++ b/REPORT.md @@ -0,0 +1,33 @@ +# 作业 1 反思报告 + +## 1. 我的 Prompt 策略 + +你是如何向 AI 描述需求的?请分享你认为最有效的一次 prompt,并说明为什么它效果好。 + +> [在此处回答] + +## 2. 与 AI 协作的体验 + +在完成这个作业的过程中,你和 AI 的协作顺利吗? + +- 有没有 AI "理解错误"的时候?你是怎么纠正的? +- 有没有让你惊喜的地方? +- 整体体验如何? + +> [在此处回答] + +## 3. 我的思考与判断 + +AI 可以生成代码,但最终的判断是你做的。请回答: + +- 最终代码中,哪部分是你主动要求修改或优化的?为什么? +- 你是如何验证代码正确性的?(比如:自己写测试、手动测试、阅读代码等) + +> [在此处回答] + +## 4. 学习收获 + +- 通过这次作业,你对"用 AI 写代码"有什么新的认识? +- 你觉得在 AI 时代,程序员最重要的能力是什么? + +> [在此处回答] diff --git a/requirements.txt b/requirements.txt new file mode 100644 index 0000000..5575905 --- /dev/null +++ b/requirements.txt @@ -0,0 +1,3 @@ +pytest>=7.4 +python-dotenv>=1.0 +requests>=2.31 diff --git a/src/__init__.py b/src/__init__.py new file mode 100644 index 0000000..8b13789 --- /dev/null +++ b/src/__init__.py @@ -0,0 +1 @@ + diff --git a/src/card_generator.py b/src/card_generator.py new file mode 100644 index 0000000..f1921a7 --- /dev/null +++ b/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="经济与管理学院", + ) + ) diff --git a/tests/test_public.py b/tests/test_public.py new file mode 100644 index 0000000..1138b55 --- /dev/null +++ b/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