# 使用教程

本技能有两种**平行**的使用方式：

- **数据管理**：在左侧「候选人汇总表」上点工具栏 / 行内按钮
- **对话任务**：用自然语言让 Agent 完成同一能力

定时任务是否提供：**见下方「入口三」**（当前为占位，按需启用）。

---

## 本技能做什么

```text
【候选人汇总表 + 一卡通消费 + 综测排名 + 历史资助】 → 【四类异常检测】 → 【复核建议清单】 → 【辅导员人工复核 → 终审】
```

- **输入**：辅导员批量勾选的候选人 + 一卡通消费数据 + 综测成绩排名 + 本学年已获资助记录 + 生源地人均 GDP
- **输出**：《奖助评定复核建议清单》HTML 报告 + 高风险个案推送
- **说明**：本技能不替代辅导员终审；所有异常仍需人工填写核查说明

---

## 开始前

确认：

1. 已安装并登录匠厂客户端
2. 已在技能市场安装本技能（建议更新到最新版）
3. 学生工作部 API / 一卡通中心 API / 教务系统 API 凭证已配置
4. 【如需】首次使用前先在「数据管理 → 一卡通消费」点击「立即同步」
5. 【如需】首次使用前先在「数据管理 → 生源地 GDP」点击「同步最新公开数据」

---

## 入口一：数据管理

适合：辅导员、学生处资助中心科员。

### 左侧各表是干什么的

| 表名（中文） | 作用 |
|--------------|------|
| 候选人汇总表 | 各班级辅导员批量勾选的国家助学金 / 励志奖学金 / 校级奖学金候选人 |
| 复核建议清单 | 防伪校验产出的高风险个案清单（含异常详情） |
| 困难认定 | 学生《家庭经济困难认定表》数据（只读） |
| 一卡通消费 | 学生食堂 / 超市月均消费额（只读） |
| 历史资助 | 本学年已获资助记录（用于累计金额比对） |

### 首次准备（若需要）

1. 进入 **数据管理** → **一卡通消费**
2. 点击表顶 **「立即同步」**（空表可点）
3. 成功后应看到：全校学生的一卡通月均消费额

### 主流程：批量校验某班级候选人

1. 进入 **候选人汇总表**
2. 勾选某班级所有候选人 → 点击 **「AI 校验」**
3. 等待 10~30 秒（按班级规模）
4. 完成后：
   - 复核建议清单表新增若干行（含高风险个案）
   - 异常候选人行状态变为「已标注」
   - 辅导员工作台收到待复核通知
   - 学生处资助中心科员收到复核个案汇总

### 行级 / 批量

| 你想做什么 | 操作 |
|------------|------|
| 校验一位候选人 | **候选人汇总表** 行内 → **「AI 校验」** |
| 批量校验某班级 | 勾选多行 → **「批量校验」** |
| 标记为待复核 | **候选人汇总表** 行内 → **「标记为待复核」** |
| 提交复核结果 | **复核建议清单** 行内 → **「提交复核结果」** |
| 查看复核清单 | **复核建议清单** 行内 → **「查看清单」** |
| 同步一卡通数据 | **一卡通消费** 表顶 → **「立即同步」** |

---

## 入口二：对话任务

适合：临时提问、不想切换表的用户。

### 什么时候用对话

- 临时想校验一位候选人，但不想打开数据管理
- 想用自然语言解释「为什么这位学生被标为异常」
- 想看「本月一共多少位高风险个案」

### 示例话术

| 你想做什么 | 可以这样说 |
|------------|------------|
| 校验一位候选人 | 「帮我校验张同学的助学金申请」 |
| 批量校验 | 「请把 XX 班所有候选人都校验一遍」 |
| 标记待复核 | 「把李同学标记为待复核」 |
| 提交复核 | 「张同学的核查说明已写好，提交复核」 |
| 查看本月统计 | 「本月一共多少位高风险个案？」 |

### Agent 可能追问什么

- 缺参数时：「请告诉我学生姓名 / 学号 / 班级」
- 一卡通数据缺失时：「该生一卡通消费数据未同步，请先到数据管理同步」
- 失败时：可改用数据管理点按钮重新触发

---

## 入口三：定时任务

### 本技能当前为占位（按需启用）

本技能**当前未启用定时任务入口**。如未来启用，建议场景：

- 每学期评定季开始前 7 天自动同步一卡通数据
- 评定季期间每日自动扫描已提交候选人的异常

启用条件：学生工作部系统提供定时回调 API，并经学生处资助中心确认自动化边界。

当前请使用 **数据管理** 或 **对话任务**。

---

## 主能力对照表

| 想做什么 | 数据管理 | 对话任务 |
|----------|----------|----------|
| 校验一位候选人 | **候选人汇总表** 行内 → **「AI 校验」** | 「帮我校验张同学的助学金申请」 |
| 批量校验 | 勾选多行 → **「批量校验」** | 「请把 XX 班所有候选人都校验一遍」 |
| 标记待复核 | 行内 → **「标记为待复核」** | 「把李同学标记为待复核」 |
| 提交复核结果 | **复核建议清单** 行内 → **「提交复核结果」** | 「张同学的核查说明已写好，提交复核」 |
| 查看复核清单 | **复核建议清单** 行内 → **「查看清单」** | 「把本月复核清单发给我」 |

按钮名必须与 `assets/actions.json` 的 `label` 一致。

---

## 常见卡住怎么办

| 现象 | 你可以先试 |
|------|------------|
| 「AI 校验」点不了 | 是否已配置三套 API；是否装错版本 |
| 校验很久没结果 | 看任务中心进度；候选人 > 500 可能耗时较久 |
| 异常过多 | 检查一卡通同步是否完整；本源 GDP 数据是否最新 |
| 复核提交失败 | 是否填写完整核查说明；是否在审核期内 |
| 学生一卡通数据缺失 | 学生可能近期未消费；可手动标记为「数据缺失」并跳过此项 |

仍无法解决时，把「你用的入口 + 操作步骤 + 界面提示原文」发给支持人员。