连接你的 AI 工作台

用 Codex、Claude Code 等 AI 工作台查询班级、分析成绩，确认后发布和管理

三步连接

下载并解压
保留完整的 aichafen-teacher 文件夹，下载包已配置当前服务地址
交给你的 AI 工作台
将文件夹交给工作台，并发送下面这段话
请安装这个爱查分教师 Skill，检查 Python 依赖，连接后查询我的班级。所有发布、修改、关闭和删除操作先给我预览，等我确认后执行。
微信扫码授权
工作台会打开二维码。使用教师账号微信扫码，核对查询到的班级后即可开始

手动安装与环境要求

需要 Python 3.9+、联网和本地脚本执行能力。先在解压后的 aichafen-teacher 目录执行对应命令

Windows · PowerShell

先执行 py -3 --version 检查 Python。找不到 py 时尝试 python --version，确认版本后将下面的 py -3 替换为 python；尚未安装时可从 Python 官网安装，再重新打开工作台

& {
    $ErrorActionPreference = "Stop"
    [Console]::OutputEncoding = [System.Text.UTF8Encoding]::new()
    py -3 scripts/install.py --target codex
    if ($LASTEXITCODE -ne 0) { throw "安装失败，请先处理提示；更新已有安装需加 --update" }
    Set-Location -LiteralPath "$HOME\.agents\skills\aichafen-teacher"
    py -3 -m venv .venv
    if ($LASTEXITCODE -ne 0) { throw "Python 环境创建失败" }
    & ".\.venv\Scripts\python.exe" -m pip install -r requirements.txt
    if ($LASTEXITCODE -ne 0) { throw "依赖安装失败" }
    & ".\.venv\Scripts\python.exe" scripts/chafen_login.py
    if ($LASTEXITCODE -ne 0) { throw "扫码授权未完成" }
    & ".\.venv\Scripts\python.exe" scripts/chafen_grade_query.py class
}

直接调用环境中的 Python 即可，无需运行激活脚本或修改 PowerShell 执行策略。文件路径带空格或中文时用引号包裹

macOS / Linux / WSL

python3 scripts/install.py --target codex &&
cd "$HOME/.agents/skills/aichafen-teacher" &&
python3 -m venv .venv &&
.venv/bin/python -m pip install -r requirements.txt &&
.venv/bin/python scripts/chafen_login.py &&
.venv/bin/python scripts/chafen_grade_query.py class

WSL 使用 Linux 的 Python 和用户目录。在工作台实际运行命令的环境中安装和扫码，切换 Windows／WSL 环境后重新安装并扫码；二维码未自动打开时，复制脚本显示的图片链接到浏览器扫码

Claude Code 将 --target codex 改为 --target claude，并将安装路径中的 .agents 改为 .claude。Windows 安装在当前用户目录下，其余环境使用各自的用户目录

已安装时，检查后给安装命令加 --update 可更新并保留本机凭据。需要时重新打开工作台对话，完整说明随下载包提供

可以做什么

成绩: 上传 Excel 发布，查询考试与分析数据，修改考试信息、总分显示，关闭、重新开放或删除考试
班级: 查询、创建、改名、排序、调整显示设置，删除或从回收站恢复班级
操作确认: 查询直接执行；发布和修改先展示预览，明确确认后执行。确认 15 分钟内有效且仅使用一次

使用你的教师权限

连接后按当前教师账号权限访问班级和成绩。上传表格的原始字段继续完整保留，显示开关只控制系统生成的统计内容

请在信任的工作台中使用。凭据保存在本机，不要分享 credentials.json 或 .plans 文件夹；停止使用时删除本机凭据