Banjixiaoguanjia

自动化班级小管家作业截图工具。支持连接 Chrome 调试端口、进入指定课程、滚动查看学生列表、截取学生作业图片。专为小学数学老师设计，用于批量获取学生作业截图进行批改。

Install

openclaw skills install @wosuiyu/banjixiaoguanjia

班级小管家作业截图

自动化班级小管家 (banjixiaoguanjia.com) 作业截图工具，支持批量获取学生作业图片。

功能特性

🔌 连接 Chrome 调试端口 (CDP)
📖 自动进入指定课程
👨‍🎓 滚动查看所有学生
📸 批量截取学生作业图片
🤖 支持 AI 图像分析 (GLM/MiniMax)

编码规范

重要: 所有文件、路径、目录统一使用 UTF-8 编码

脚本文件保存为 UTF-8 with BOM
文件路径处理使用 UTF-8 编码
输出报告使用 UTF-8 编码
避免使用 GBK/GB2312 编码

前置要求

Chrome 浏览器 已安装
已登录 班级小管家（首次使用需要手动登录）

💡 提示: 使用 capture-new-browser.js 脚本时，无需手动启动 Chrome 调试模式，脚本会自动处理浏览器启动和复用。

📖 脚本使用手册

⚠️ 重要:

详细的脚本使用流程请查看 SCRIPT-GUIDE.md
必须严格按照 SCRIPT-GUIDE.md 使用脚本，不要随意尝试目录下其他脚本
本目录下脚本众多，部分脚本有bug或已过时

快速开始

🆕 推荐使用脚本: `capture-new-browser.js` (v1.9.0+)

最新版功能:

✅ 自动复用浏览器: 检测已打开的班级小管家页面，有则复用，无则启动新浏览器（开启调试端口 9222）
✅ 动态学生列表: 自动获取学生列表，不固定学生名字，支持任意班级
✅ 智能截图: 采用固定步长滚动（400像素），确保截图顺序正确
✅ 改正作业处理: 自动检测"改正如下"标签，单独截图改正部分
✅ 浏览器保持打开: 脚本结束时无限等待，防止浏览器被意外关闭
✅ 窗口大小: 1280x1000（高度 1000）
✅ 使用本地 Chrome: 不是 Chrome for Testing

使用方法:

bash

node capture-new-browser.js "课程名称"

示例:

bash

node capture-new-browser.js "二下(第38节)"

输出位置: 桌面/课程名称/

浏览器复用逻辑:

第一次运行：启动新浏览器，自动开启调试端口 9222
后续运行：检测并复用已打开的浏览器，无需重新扫码登录
脚本完成：浏览器保持打开，可继续手动查看和批改

旧版脚本（不推荐）

截图 + AI分析作业数量:

bash

node capture-36-fixed.js "二下(第36节)"

⚠️ 注意: 旧版脚本需要手动启动 Chrome 调试模式，且不会自动复用浏览器

核心 API

连接到 Chrome

javascript

const { chromium } = require('playwright');
const browser = await chromium.connectOverCDP('http://localhost:9222');

进入课程

javascript

// 启用辅助功能
await page.evaluate(() => {
  const el = document.querySelector('flt-semantics-placeholder');
  if (el) el.click();
});

// 查找并点击课程
await page.evaluate((courseName) => {
  const elements = document.querySelectorAll('flt-semantics[aria-label]');
  for (const el of elements) {
    const label = el.getAttribute('aria-label');
    if (label && label.includes(courseName)) {
      el.dispatchEvent(new MouseEvent('click', { bubbles: true }));
      break;
    }
  }
}, '三上(第11节)');

滚动查找课程（课程列表页面）

⚠️ 关键发现: Flutter 页面需要使用 scrollIntoView 滚动到已知课程来触发动态加载更多课程！

正确方法:

javascript

// 滚动到最后一个已知课程，触发 Flutter 加载更多
await page.evaluate(() => {
  const elements = document.querySelectorAll('flt-semantics[aria-label]');
  let lastCourseEl = null;
  
  for (const el of elements) {
    const label = el.getAttribute('aria-label');
    if (label && (label.includes('第') || label.includes('年级'))) {
      lastCourseEl = el;
    }
  }
  
  if (lastCourseEl) {
    lastCourseEl.scrollIntoView({ block: 'start' });
  }
});

await page.waitForTimeout(1500); // 等待加载完成

完整查找流程:

javascript

async function findCourseWithScroll(courseName, maxScrolls = 20) {
  for (let i = 0; i < maxScrolls; i++) {
    // 1. 在当前视图查找目标课程
    const found = await page.evaluate((name) => {
      const elements = document.querySelectorAll('flt-semantics[aria-label]');
      for (const el of elements) {
        const label = el.getAttribute('aria-label');
        if (label && label.includes(name)) {
          return { found: true, label };
        }
      }
      return { found: false };
    }, courseName);
    
    if (found.found) return found;
    
    // 2. 滚动到最后一个课程，触发加载更多
    await page.evaluate(() => {
      const elements = document.querySelectorAll('flt-semantics[aria-label]');
      let lastCourseEl = null;
      for (const el of elements) {
        const label = el.getAttribute('aria-label');
        if (label && (label.includes('第') || label.includes('年级'))) {
          lastCourseEl = el;
        }
      }
      if (lastCourseEl) lastCourseEl.scrollIntoView({ block: 'start' });
    });
    
    await page.waitForTimeout(1500);
  }
}

滚动查看学生

javascript

// 获取滚动容器
const scrollContainer = await page.evaluate(() => {
  return document.querySelector('[style*="overflow-y: scroll"]');
});

// 滚动到指定位置
await page.evaluate((scrollTop) => {
  const el = document.querySelector('[style*="overflow-y: scroll"]');
  if (el) el.scrollTop = scrollTop;
}, 100);

截图学生作业

javascript

await page.screenshot({ 
  path: `screenshots/${studentName}.png`, 
  fullPage: true 
});

完整示例

javascript

const { chromium } = require('playwright');

async function captureHomework(courseName, outputDir = './screenshots') {
  const browser = await chromium.connectOverCDP('http://localhost:9222');
  const context = browser.contexts()[0] || await browser.newContext();
  const pages = context.pages();
  let page = pages.find(p => p.url().includes('banjixiaoguanjia'));
  
  if (!page) {
    page = await context.newPage();
    await page.goto('https://service.banjixiaoguanjia.com/appweb/');
  }
  
  // 启用辅助功能
  await page.evaluate(() => {
    const el = document.querySelector('flt-semantics-placeholder');
    if (el) el.click();
  });
  await page.waitForTimeout(2000);
  
  // 进入课程
  await page.evaluate((name) => {
    const elements = document.querySelectorAll('flt-semantics[aria-label]');
    for (const el of elements) {
      const label = el.getAttribute('aria-label');
      if (label && label.includes(name)) {
        el.dispatchEvent(new MouseEvent('click', { bubbles: true }));
        break;
      }
    }
  }, courseName);
  
  await page.waitForTimeout(4000);
  
  // 获取学生列表
  const students = await page.evaluate(() => {
    const elements = document.querySelectorAll('flt-semantics[aria-label]');
    const list = [];
    for (const el of elements) {
      const label = el.getAttribute('aria-label');
      if (label && label.length > 20) {
        const lines = label.split('\n');
        const name = lines[0].trim();
        if (name && name.length < 15 && !name.includes('详情') && !name.includes('查看')) {
          list.push(name);
        }
      }
    }
    return list;
  });
  
  // 截图每个学生
  for (const student of students) {
    await page.screenshot({ 
      path: `${outputDir}/${student}.png`, 
      fullPage: true 
    });
    console.log(`✓ 已截图: ${student}`);
  }
  
  await browser.close();
}

技术要点

课程详情页 vs 批改页面的区别

页面	学生信息格式	查找条件
课程详情页	`球球\n2026-03-21 14:20\n 1.听课顺序...`	`includes('2026-') && includes('课内')`
批改页面	`球球的作业(1/11)`	匹配正则 `/(.+?)的作业\((\d+)\/(\d+)\)/`

⚠️ 关键: 两个页面的学生信息格式完全不同，不能用相同的查找条件！

Flutter 页面特殊处理

启用辅助功能: 必须先点击 flt-semantics-placeholder
点击方式: 使用 dispatchEvent(new MouseEvent('click', { bubbles: true }))
滚动容器: 查找 [style*="overflow-y: scroll"] 元素
语义元素: 通过 flt-semantics[aria-label] 定位

【关键】滚动截图策略

⚠️ 重要发现: 每次截图前必须先复位，否则 scrollTop 会累积导致截图错误！

正确流程:

javascript

// 1. 先复位 scrollTop = -1000（关键！）
await page.evaluate(() => {
  const el = document.querySelector('[style*="overflow-y: scroll"]');
  if (el) el.scrollTop = -1000;
});

// 2. 等待复位完成
await page.waitForTimeout(500);

// 3. 设置具体的 scrollTop 值
await page.evaluate((scrollTop) => {
  const el = document.querySelector('[style*="overflow-y: scroll"]');
  if (el) el.scrollTop = scrollTop;
}, 12);  // 例如: Zoey 的位置

// 4. 等待滚动完成
await page.waitForTimeout(1000);

// 5. 截图
await page.screenshot({ path: 'Zoey.png' });

二下第31节经验值:

学生	scrollTop	说明
灿灿	-3	只看到灿灿
Zoey	12	只看到Zoey和球球
球球	15	到底部，显示"没有更多了"

错误示范 (不复位):

javascript

// ❌ 错误：不复位会导致 scrollTop 累积
await page.evaluate(() => {
  el.scrollTop = 12;  // 如果之前是 10，现在变成 22！
});

故障排除

无法连接到 Chrome

检查 Chrome 是否以 --remote-debugging-port=9222 启动
检查端口是否被占用: curl http://localhost:9222/json/version

找不到课程

确保已登录班级小管家
检查课程名称是否完全匹配（包含年级、班级信息）

点击无效

确保已启用辅助功能
使用 dispatchEvent 而非普通 click()

Qwen3.5-Plus 图像分析

截图完成后，使用 Qwen3.5-Plus (通义千问) 分析学生作业提交情况。

依赖安装

bash

pip install openai

环境变量设置

bash

# Windows PowerShell
$env:DASHSCOPE_API_KEY="sk-your-api-key"

# Windows CMD
set DASHSCOPE_API_KEY=sk-your-api-key

# 永久设置（Windows）
[Environment]::SetEnvironmentVariable("DASHSCOPE_API_KEY", "sk-your-api-key", "User")

使用方法

javascript

const { BanjixiaoguanjiaCapture } = require('./skills/banjixiaoguanjia');

const capture = new BanjixiaoguanjiaCapture();

// 截图并分析（自动使用 DASHSCOPE_API_KEY 环境变量）
const result = await capture.captureAndAnalyze('一下(第9节)');

// 输出分析结果
for (const item of result.analysis) {
  console.log(`学生: ${item.student}`);
  console.log(`分析: ${item.analysis}`);
}

分析结果示例

text

学生姓名：KIKI
课内作业：6张
奥数作业：7张

API Key 获取

访问 https://bailian.console.aliyun.com
注册/登录阿里云账号
在控制台获取 API Key

作业图片下载完整流程

流程概述

text

阶段1: AI分析（Qwen）
├── 截图所有学生作业
├── 使用Qwen分析每张截图
└── 获取：学生姓名 + 课内数量 + 奥数数量

阶段2: 下载原图
├── 进入课程 → 点击第一个学生图片 → 进入批改页面
├── 下载当前学生作业（先课内，后奥数）
├── 核对：本地文件数量 vs 分析结果数量
├── 点击左侧学生名字切换到下一个学生
├── 重复下载流程
└── 直到所有学生下载完成

阶段3: 最终核对
├── 检查每个学生文件夹
├── 核对课内/奥数图片数量
└── 确认全部下载成功

关键要点

刷新会回到首页 - 操作过程中不能刷新页面
学生切换 - 在批改页面左侧点击学生名字（页面不刷新，自动回到第1张）
查看原图按钮 - 元素索引[8]，位置(814,0)，尺寸40x56
图片切换 - 使用 ArrowRight 键切换到下一张
作业顺序 - 先课内，后奥数
以分析结果为准 - 多余图片不下载
核对步骤 - 每个学生下载完成后，必须核对本地文件数量与AI分析结果是否一致

动态获取学生信息（关键修正）

⚠️ 重要: 页面顶部元素[7]显示"学生名字的作业(X/Y)"，不包含"返回"前缀！

页面结构：

元素[6]: "返回" - 返回按钮

元素[7]: "Zoey的作业(8/8)" - 学生名字和作业信息（用这个！）

javascript

// 获取当前学生名字和图片位置
const currentInfo = await page.evaluate(() => {
  const elements = document.querySelectorAll('flt-semantics');
  
  // 优先检查元素[7]（页面顶部标题，不包含"返回"前缀）
  if (elements[7]) {
    const text = elements[7].textContent || elements[7].getAttribute('aria-label') || '';
    const match = text.match(/(.+?)的作业\((\d+)\/(\d+)\)/);
    if (match) {
      return {
        student: match[1].trim(),      // 学生名字（不含"返回"前缀）
        current: parseInt(match[2]),   // 当前图片位置
        total: parseInt(match[3])      // 总图片数
      };
    }
  }
  
  // 备用：遍历所有元素查找
  for (let i = 0; i < elements.length; i++) {
    const text = elements[i].textContent || elements[i].getAttribute('aria-label') || '';
    const match = text.match(/(.+?)的作业\((\d+)\/(\d+)\)/);
    if (match) {
      let studentName = match[1].trim();
      // 去掉"返回"前缀（兼容旧版本）
      studentName = studentName.replace(/^返回/, '');
      return {
        student: studentName,
        current: parseInt(match[2]),
        total: parseInt(match[3])
      };
    }
  }
  return null;
});

// 获取左侧学生列表（v8 动态获取）
const students = await page.evaluate(() => {
  const elements = document.querySelectorAll('flt-semantics');
  const studentList = [];
  
  for (let i = 0; i < elements.length; i++) {
    const text = elements[i].textContent || elements[i].getAttribute('aria-label') || '';
    // 匹配学生名字（短文本，排除各种UI元素）
    if (text.length > 0 && text.length < 20 && 
        !text.includes('作业') && !text.includes('图片') && 
        !text.includes('查看') && !text.includes('详情') &&
        !text.includes('2026-') && !text.includes('课内') &&
        !text.includes('奥数') && !text.includes('返回') &&
        !text.includes('已点评') && !text.includes('待点评') &&
        !text.includes('没有更多') && !text.includes('收起') &&
        !text.includes('点评') && !text.includes('全部') &&
        !text.includes('未点评') && !text.includes('帮助') &&
        !text.includes('快捷键') && !text.includes('设置') &&
        !text.includes('画笔') && !text.includes('旋转') &&
        !text.includes('文字') && !text.includes('橡皮擦') &&
        !text.includes('撤销') && !text.includes('放大') &&
        !text.includes('缩小') && !text.includes('上一张') &&
        !text.includes('下一张') && !text.includes('保存')) {
      studentList.push({
        index: i,
        name: text.trim()
      });
    }
  }
  
  return studentList;
});

下载单个学生作业（含核对）

javascript

async function downloadStudentImages(page, studentName, keNeiCount, aoShuCount, outputDir) {
  const totalCount = keNeiCount + aoShuCount;
  
  // 创建目录
  const keNeiDir = path.join(outputDir, studentName, '课内');
  const aoShuDir = path.join(outputDir, studentName, '奥数');
  
  if (!fs.existsSync(keNeiDir)) fs.mkdirSync(keNeiDir, { recursive: true });
  if (!fs.existsSync(aoShuDir)) fs.mkdirSync(aoShuDir, { recursive: true });
  
  // 下载课内作业（第1到keNeiCount张）
  for (let i = 1; i <= keNeiCount; i++) {
    const savePath = path.join(keNeiDir, `图片${i}.jpg`);
    
    // 点击"查看原图"按钮（元素[8]）
    await page.evaluate(() => {
      const elements = document.querySelectorAll('flt-semantics');
      if (elements[8]) {
        elements[8].dispatchEvent(new MouseEvent('click', { bubbles: true }));
      }
    });
    
    await page.waitForTimeout(3000);
    
    // 获取图片URL并下载
    const context = page.context();
    const pages = context.pages();
    const newPage = pages.find(p => p !== page && p.url().includes('img.banjixiaoguanjia.com'));
    
    if (newPage) {
      const imageUrl = newPage.url();
      execSync(`curl -L -o "${savePath}" "${imageUrl}"`, { timeout: 30000 });
      await newPage.close();
      await page.waitForTimeout(500);
    }
    
    // 切换到下一张
    if (i < totalCount) {
      await page.keyboard.press('ArrowRight');
      await page.waitForTimeout(1500);
    }
  }
  
  // 下载奥数作业（第1到aoShuCount张）
  for (let i = 1; i <= aoShuCount; i++) {
    const savePath = path.join(aoShuDir, `图片${i}.jpg`);
    
    // 点击"查看原图"按钮
    await page.evaluate(() => {
      const elements = document.querySelectorAll('flt-semantics');
      if (elements[8]) {
        elements[8].dispatchEvent(new MouseEvent('click', { bubbles: true }));
      }
    });
    
    await page.waitForTimeout(3000);
    
    // 获取图片URL并下载
    const context = page.context();
    const pages = context.pages();
    const newPage = pages.find(p => p !== page && p.url().includes('img.banjixiaoguanjia.com'));
    
    if (newPage) {
      const imageUrl = newPage.url();
      execSync(`curl -L -o "${savePath}" "${imageUrl}"`, { timeout: 30000 });
      await newPage.close();
      await page.waitForTimeout(500);
    }
    
    // 切换到下一张
    if (i < aoShuCount) {
      await page.keyboard.press('ArrowRight');
      await page.waitForTimeout(1500);
    }
  }
  
  // ===== 核对步骤 =====
  console.log(`\n核对 ${studentName} 的下载结果...`);
  
  // 核对课内作业
  const keNeiFiles = fs.readdirSync(keNeiDir).filter(f => f.endsWith('.jpg'));
  console.log(`  课内作业: 预期 ${keNeiCount} 张, 实际 ${keNeiFiles.length} 张`);
  if (keNeiFiles.length !== keNeiCount) {
    console.log(`  ⚠️ 课内作业数量不匹配!`);
  } else {
    console.log(`  ✓ 课内作业核对通过`);
  }
  
  // 核对奥数作业
  const aoShuFiles = fs.readdirSync(aoShuDir).filter(f => f.endsWith('.jpg'));
  console.log(`  奥数作业: 预期 ${aoShuCount} 张, 实际 ${aoShuFiles.length} 张`);
  if (aoShuFiles.length !== aoShuCount) {
    console.log(`  ⚠️ 奥数作业数量不匹配!`);
  } else {
    console.log(`  ✓ 奥数作业核对通过`);
  }
  
  // 核对总数
  const totalFiles = keNeiFiles.length + aoShuFiles.length;
  console.log(`  总计: 预期 ${totalCount} 张, 实际 ${totalFiles} 张`);
  if (totalFiles !== totalCount) {
    console.log(`  ⚠️ 总数不匹配!`);
    return false;  // 返回失败状态
  } else {
    console.log(`  ✓ ${studentName} 全部核对通过`);
    return true;   // 返回成功状态
  }
}

切换到下一个学生（v8 动态获取 + 索引点击）

⚠️ 重要: 切换学生后必须验证是否成功，并确保回到第1张图片！

v8 改进: 动态获取学生列表，通过索引点击，支持任意课程

javascript

// 动态获取学生列表并切换到目标学生
async function switchToStudent(page, targetStudentName) {
  console.log(`切换到学生: ${targetStudentName}`);
  
  // 1. 获取左侧学生列表
  const students = await page.evaluate(() => {
    const elements = document.querySelectorAll('flt-semantics');
    const studentList = [];
    for (let i = 0; i < elements.length; i++) {
      const text = elements[i].textContent || elements[i].getAttribute('aria-label') || '';
      if (text.length > 0 && text.length < 20 && 
          !text.includes('作业') && !text.includes('图片') && 
          !text.includes('查看') && !text.includes('详情') &&
          !text.includes('2026-') && !text.includes('课内') &&
          !text.includes('奥数') && !text.includes('返回') &&
          !text.includes('已点评') && !text.includes('待点评') &&
          !text.includes('没有更多') && !text.includes('收起') &&
          !text.includes('点评') && !text.includes('全部') &&
          !text.includes('未点评') && !text.includes('帮助') &&
          !text.includes('快捷键') && !text.includes('设置') &&
          !text.includes('画笔') && !text.includes('旋转') &&
          !text.includes('文字') && !text.includes('橡皮擦') &&
          !text.includes('撤销') && !text.includes('放大') &&
          !text.includes('缩小') && !text.includes('上一张') &&
          !text.includes('下一张') && !text.includes('保存')) {
        studentList.push({ index: i, name: text.trim() });
      }
    }
    return studentList;
  });
  
  // 2. 查找目标学生
  const targetInfo = students.find(s => s.name === targetStudentName);
  if (!targetInfo) {
    console.log(`  ⚠️ 未在学生列表中找到 ${targetStudentName}`);
    return null;
  }
  
  // 3. 使用索引点击
  await page.evaluate((index) => {
    const elements = document.querySelectorAll('flt-semantics');
    if (elements[index]) {
      elements[index].dispatchEvent(new MouseEvent('click', { bubbles: true }));
    }
  }, targetInfo.index);
  
  // 4. 等待页面刷新（切换学生后会自动回到第1张图片）
  await page.waitForTimeout(4000);
  
  // 5. 验证切换是否成功（检查页面顶部元素[7]）
  const info = await page.evaluate(() => {
    const elements = document.querySelectorAll('flt-semantics');
    if (elements[7]) {
      const text = elements[7].textContent || elements[7].getAttribute('aria-label') || '';
      const match = text.match(/(.+?)的作业\((\d+)\/(\d+)\)/);
      if (match) {
        return {
          student: match[1].trim(),
          current: parseInt(match[2]),
          total: parseInt(match[3])
        };
      }
    }
    return null;
  });
  
  if (info && info.student === targetStudentName) {
    console.log(`✓ 已切换到 ${targetStudentName}: 第${info.current}/${info.total}张`);
    return info;
  } else {
    console.log(`  ⚠️ 切换后显示: ${info ? `${info.student} (第${info.current}/${info.total}张)` : '未知'}`);
    return null;
  }
}

作业分析功能

使用 `analyze-homework.js` 进行作业批改

javascript

const { HomeworkAnalyzer } = require('./analyze-homework');

const analyzer = new HomeworkAnalyzer();

// 分析单个学生作业
await analyzer.analyze('一下(第9节)', '大瑀', '课内');

// 输出：
// - 一下(第9节)大瑀课内分析.txt
// - 一下(第9节)大瑀课内分析.docx

分析流程

text

阶段1: 准备
├── 检查答案文件（桌面/答案/课程名称/课内答案.png）
├── 获取作业图片
└── 统计图片数量

阶段2: AI分析（Qwen模型）
├── 优先批量分析（答案+所有作业图片）
├── 如果失败，切换到逐一分析
└── 生成批改结果

阶段3: 生成报告
├── 保存 TXT 文件
└── 生成 Word 文档（微软雅黑，优化排版）

提示词模板

有答案时：

text

第1张图片是XX答案.png，这是作业的标准答案，你需要认真参考答案进行作业批改。

帮我检查这些作业的对错...

无答案时：

text

帮我检查这些作业的对错...

Word 排版格式（手机阅读优化版）

设计目标：适合手机阅读，字体大、布局简洁、层次清晰

页面边距：窄边距（0.5英寸），内容更宽适合手机屏幕
字体：微软雅黑
大标题：20磅，📚表情+蓝色加粗居中
副标题：12磅，灰色居中
章节标题：16磅，▶符号+蓝色加粗
小节标题：15磅，加粗，深灰色
正文：14磅（手机阅读用大字体）
列表项：数字用蓝色加粗，内容14磅
子项：13磅，缩进显示
正确标记：绿色 ✅
错误标记：红色 ❌
页脚：12磅，灰色居中

排版特点：

流式布局，去掉表格
章节间空行分隔
颜色区分对错
层次用缩进和符号区分

阶段5: 完成当前课程

text

阶段5: 完成当前课程
├── 所有作业下载和分析完成
├── 刷新班级小管家页面（自动回到首页）
└── 等待下一次作业批改命令

操作：

javascript

// 刷新页面回到首页
await page.goto('https://service.banjixiaoguanjia.com/appweb/');
console.log('已回到首页，等待下一次作业批改命令');

更新日志

1.0.0

初始版本
支持 Chrome CDP 连接
支持课程进入和学生截图

1.1.0

新增作业图片下载功能
使用 Qwen3.5-Plus 进行AI分析
支持动态获取学生列表
支持课内/奥数分类下载

1.2.0

新增作业分析功能
支持批量/逐一分析
自动生成 Word 报告
优化排版格式（微软雅黑）

1.3.0 (2026-03-22)

关键修正: 页面顶部元素[7]显示"学生名字的作业(X/Y)"，不包含"返回"前缀
关键修正: 切换学生后必须验证是否成功，通过检查页面顶部元素[7]核对"当前第几张/一共多少张"
关键修正: 学生名字在左侧列表中的索引通常是固定的（如：球球在索引16，Zoey在索引17）
关键修正: 课程详情页查找学生的条件应该是 includes('2026-') && includes('课内')，而不是 includes('已点评')
新增 download-homework.js 完整下载脚本
新增 analyze-homework-ai.js AI分析脚本
新增: SCRIPT-GUIDE.md 脚本使用手册

1.4.0 (2026-03-22)

v8 改进: download-homework.js 使用动态获取学生列表 + 索引点击的方式切换学生
移除: 固定学生名字的专用脚本（如 download-zoey.js）
优势: 支持任意课程，无需为每个课程创建专用脚本
新增: archived-scripts/ 脚本归档目录
规范: 统一使用 UTF-8 编码处理文件、路径、目录

1.5.0 (2026-03-22)

文档更新: 在 SCRIPT-GUIDE.md 和 SKILL.md 中明确标注推荐脚本
问题记录: 标注 capture-and-analyze-36.js 有bug（学生数量判断死循环）
推荐脚本: capture-36-fixed.js 作为截图+AI分析的标准脚本
重要提示: 强调必须按照文档使用脚本，不要随意尝试其他脚本

1.6.0 (2026-03-23)

逻辑调整: download-homework.js 新增"已点评"检查
- 遍历学生列表时，检查每个学生是否有"已点评"标签
- 有"已点评"标签 → 跳过该学生的作业下载
- 无"已点评"标签 → 正常下载该学生作业
- 在 getStudentList() 方法中返回 skip 字段标记是否需要跳过
- 在 switchToStudent() 方法中检查 skip 字段并跳过已点评学生

1.7.0 (2026-03-23)

截图逻辑修复: capture-36-fixed.js 修复截图定位问题
- 问题: 使用 getBoundingClientRect().top 定位不准确，导致截图错误（如Zoey截图显示为球球作业）
- 解决: 收集学生列表后重新进入页面，按顺序使用固定滚动步长（400px）截图
- 关键: 不再依赖 top 值定位，而是按顺序滚动截图
"改正如下"处理: capture-36-fixed.js 添加改正作业截图逻辑
- 检测"改正如下"标签（收集学生列表时检查 fullLabel）
- 单独截图改正部分（保存为 学生名_改正.png）
- AI分析时提示不统计改正部分
"已点评"检测修复: download-homework.js 修复学生名字提取逻辑
- 问题: 左侧学生列表中的文本包含"已点评"、"良好"等标签，导致名字匹配失败
- 解决: 提取学生名字时去掉"已点评"、评级（优秀/良好/合格/待改进）、数字括号、换行符等
- 确保第一个学生也能正确检测"已点评"状态并跳过下载

1.9.0 (2026-03-29)

新版一键截图脚本: capture-new-browser.js 正式发布
- 自动复用浏览器：检测已打开的班级小管家页面，有则复用，无则启动新浏览器
- 动态学生列表：自动获取学生列表，不固定学生名字，支持任意班级
- 智能截图逻辑：采用固定步长滚动（400像素），确保截图顺序正确
- 改正作业处理：检测"改正如下"标签，单独截图改正部分
- 浏览器保持打开：脚本结束时无限等待，防止浏览器被意外关闭
- 窗口大小：1280x1000，使用本地 Chrome

1.8.0 (2026-03-24)

Word报告手机阅读优化: analyze-homework.js 重构Word生成逻辑
- 页面边距缩小到0.5英寸，适合手机屏幕
- 正文字体从12pt增大到14pt，章节标题16pt，大标题20pt
- 去掉表格布局，改用流式排版
- 添加📚表情符号和▶章节标记
- 正确内容显示绿色，错误内容显示红色
- 层次结构：大章节→小节→子项，用缩进和符号区分

Banjixiaoguanjia

Install

班级小管家作业截图

功能特性

编码规范

前置要求

📖 脚本使用手册

快速开始

🆕 推荐使用脚本: capture-new-browser.js (v1.9.0+)

旧版脚本（不推荐）

核心 API

连接到 Chrome

进入课程

滚动查找课程（课程列表页面）

滚动查看学生

截图学生作业

完整示例

技术要点

课程详情页 vs 批改页面的区别

Flutter 页面特殊处理

【关键】滚动截图策略

故障排除

无法连接到 Chrome

找不到课程

点击无效

Qwen3.5-Plus 图像分析

依赖安装

环境变量设置

使用方法

分析结果示例

API Key 获取

作业图片下载完整流程

流程概述

关键要点

动态获取学生信息（关键修正）

下载单个学生作业（含核对）

切换到下一个学生（v8 动态获取 + 索引点击）

作业分析功能

使用 analyze-homework.js 进行作业批改

分析流程

提示词模板

Word 排版格式（手机阅读优化版）

阶段5: 完成当前课程

相关技能

更新日志

1.0.0

1.1.0

1.2.0

1.3.0 (2026-03-22)

1.4.0 (2026-03-22)

1.5.0 (2026-03-22)

1.6.0 (2026-03-23)

1.7.0 (2026-03-23)

1.9.0 (2026-03-29)

1.8.0 (2026-03-24)

Related skills

🆕 推荐使用脚本: `capture-new-browser.js` (v1.9.0+)

使用 `analyze-homework.js` 进行作业批改