aba-data-trendlisted

# ABA个训数据趋势分析 ## 概述 本skill用于从每日反馈表PDF中提取**个训项目**数据，进行多日趋势分析，输出结构化Excel报告和中文文字总结。 ## 前��依赖 运行前确保环境中已安装： ```bash # PDF文本提取工具（必须） sudo apt-get install -y poppler-utils # Python依赖（必须） pip install openpyxl ``` ## 使用方法 **第一步**：用户上传1-10份每日反馈表PDF文件。 **第二步**：确认文件路径后，直接调用本skill目录下的脚本： ```bash python3 <skill_dir>/scripts/analyze.py \ --files <pdf1> <pdf2> <pdf3> ... \ --output <输出目录>/个训数据趋势分析.xlsx ``` 参数说明： - `--files`：一个或多个PDF文件路径，空格分隔 - `--output`：输出Excel文件路径（默认为当前目录下的 `个训数据趋势分析.xlsx`） - `--student`：学生姓名（可选，脚本会自动从PDF中提取） **第三步**：脚本会自动完成以下工作： 1. 用 `pdftotext` 提取PDF文本（比直接读PDF可靠得多） 2. 解析个训项目数据（项目名称、百分比、是否掌握） 3. 按日期排序，构建项目×日期的数据矩阵 4. 计算每个项目的趋势方向、均值、掌握状态 5. 生成Excel报告（含数据表格sheet和文字总结sheet） 6. 在终端输出文字版总结 **第四步**：将生成的Excel文件发送给用户，并在对话中展示文字总结的关键发现。 ## 支持的反馈表格式 ### 个训反馈表（1页PDF） - 文件名示例：`BR-EY-MRFK-LQL20260316个训每日反馈表.pdf` - 包含：多回合项目表格（项目名称、百分比、是否掌握）、流利度项目、负面行为、每日亮点 ### 融合反馈表（3页PDF） - 文件名示例：`BR-EY-MRFK-LQL20260316融合每日反馈表_.pdf` - 第1页包含个训项目（本skill提取此部分），后面是融合干预数据 两种格式都能正确解析，脚本会自动识别。 ## 数据解析规则 ### 多回合项目 - **百分比数据**：0%-100%，0%是有效数据 - **"无"标记**：表示当天未做该项目，不参与均值计算 - **掌握标准**：从表头提取（"连续三天80%"或"连续三天90%"） - **是否掌握**：是/否 ### 项目名称匹配 同一项目跨天可能有名称变体，脚本会做标准化匹配： - `社交故事-分享-回答` ≈ `社交故事《分享》-回答` - 但 `社交游戏-木头人（完整游戏）` ≠ `社交游戏-木头人（阶段：抓的人）`（不同教学阶段） ### 日期提取 优先从文件名提取日期，回退到PDF内容中的日期字段。 ## 趋势判断标准 | 趋势标记 | 判定规则 | |---------|--------| | ★ 稳定高位 | 所有数据点均≥80% | | ↑ 上升 | 后半段均值比前半段高15个百分点以上 | | ↓ 下降 | 后半段均值比前半段低15个百分点以上 | | ～ 波动 | 有变化但不符合上升/下降标准 | | ▽ 持续低位 | 所有数据点均≤20% | | 数据不足 | 有效数据点少于2个 | ## 输出说明 ###