Appearance
拍照识人操作指南
拍照识人模块支持教师和管理员通过手机拍照快速检索学生身份，并提供学生头像照片质量检测与人脸特征库管理能力。本文档介绍拍照检索、结果查看、特征库管理等操作步骤。
功能入口
Web 端（管理后台）
- 特征库管理：登录后台 → 左侧导航栏 → 教务管理 → 拍照识人 → 「特征库管理」标签
- 检索日志：登录后台 → 左侧导航栏 → 教务管理 → 拍照识人 → 「检索日志」标签
小程序端
- 拍照检索：首页 → 点击「拍照识人」图标 → 进入拍照检索页面
- 检索历史：首页 → 点击「拍照识人」图标 → 「检索历史」标签
App 端
- 功能与小程序端一致，入口为 App 首页 → 「拍照识人」模块
权限要求
拍照识人仅对持有 face:search 权限的教师/管理员开放，学生账号无法看到入口。首次使用时需勾选确认《人脸识别授权书》后方可进入功能。
所需权限角色
| 角色名称 | 可执行操作 | 说明 |
|---|---|---|
| 系统管理员 | 全部操作 | 拥有拍照识人的所有权限，包括特征库管理、检索日志查看、拍照检索 |
| 安全管理员 | 全部操作 | 与系统管理员权限一致，专用于安全管理场景 |
| 教师（已授权） | 拍照检索 + 查看自己的检索历史 | 需持有 face:search 权限，首次使用需签署授权书 |
| 运维人员 | 特征库管理 + 检索日志 | 可管理特征库数据和查看检索日志，不可执行拍照检索 |
| 学生 | 无法访问 | 学生账号无权访问拍照识人功能 |
菜单路径明细
| 功能 | 完整菜单路径 | 页面说明 |
|---|---|---|
| 拍照检索（小程序） | 小程序首页 → 拍照识人 | 通过拍照或相册检索学生身份 |
| 特征库管理（Web） | 登录后台 → 教务管理 → 拍照识人 → 特征库管理 | 管理人脸特征数据（建库/更新/删除） |
| 检索日志（Web） | 登录后台 → 教务管理 → 拍照识人 → 检索日志 | 查看所有检索调用记录 |
页面布局说明
小程序端 - 拍照检索页面
┌──────────────────────────────────┐
│ 页面顶部 │
│ 标题：拍照识人 │
│ │
│ 拍照区域 │
│ ┌──────────────────────────────┐ │
│ │ │ │
│ │ 摄像头预览区域 │ │
│ │ （人脸框引导线居中显示） │ │
│ │ │ │
│ └──────────────────────────────┘ │
│ │
│ 操作按钮 │
│ [拍照] [从相册选择] │
│ │
│ 检索结果区域（检索后显示） │
│ ┌──────────────────────────────┐ │
│ │ 候选结果列表（Top5） │ │
│ │ ┌────┬────┬────┬────┬────┐ │ │
│ │ │头像│姓名│班级│学号│相似度│ │ │
│ │ ├────┼────┼────┼────┼────┤ │ │
│ │ │ ... │... │... │... │0.95│ │ │
│ │ └────┴────┴────┴────┴────┘ │ │
│ │ 命中结果高亮显示（绿色边框） │ │
│ │ 未命中结果显示灰色 │ │
│ └──────────────────────────────┘ │
│ │
│ [重新拍照] │
└──────────────────────────────────┘Web 端 - 特征库管理页面
┌──────────────────────────────────────────────────────────┐
│ 面包屑导航：教务管理 > 拍照识人 > 特征库管理 │
│ │
│ 操作栏 │
│ [批量导入] [新增] [导出] │
│ 搜索框：输入姓名/班级/学号搜索 [搜索] │
│ │
│ 筛选条件栏 │
│ 年级：[全部 ▼] 班级：[全部 ▼] 入库状态：[全部 ▼] │
│ │
│ 统计信息 │
│ 特征库总人数：XXXX 人 本月新增：XX 人 本月更新：XX 人 │
│ │
│ 特征库列表（表格） │
│ ┌───┬────┬────┬────┬────┬────┬────┬─────┐ │
│ │序号│头像│姓名│班级│学号│质量分│入库时间│ 操作 │ │
│ ├───┼────┼────┼────┼────┼────┼────┼─────┤ │
│ │ 1 │[图]│... │... │... │85 │... │[查看][更新][删除]│ │
│ └───┴────┴────┴────┴────┴────┴────┴─────┘ │
│ │
│ 分页栏：共 XX 条 每页 [20 ▼] 条 < 1 2 3 ... > │
└──────────────────────────────────────────────────────────┘Web 端 - 检索日志页面
┌──────────────────────────────────────────────────────────┐
│ 面包屑导航：教务管理 > 拍照识人 > 检索日志 │
│ │
│ 筛选条件栏 │
│ 时间范围：[起始日期] - [结束日期] │
│ 调用者：[全部 ▼] 所属学校：[全部 ▼] │
│ 命中状态：[全部 ▼] 搜索框：输入姓名/调用者 [查询] │
│ │
│ 操作栏 │
│ [导出 Excel] │
│ │
│ 检索日志列表（表格） │
│ ┌───┬────┬────┬────┬────┬────┬────┬─────┐ │
│ │序号│调用者│学校│检索时间│命中人员│相似度│耗时│ 操作 │ │
│ ├───┼────┼────┼────┼────┼────┼────┼─────┤ │
│ │ 1 │... │... │... │... │0.92│1.5s│[查看原始图]│ │
│ └───┴────┴────┴────┴────┴────┴────┴─────┘ │
│ │
│ 分页栏：共 XX 条 每页 [50 ▼] 条 < 1 2 3 ... > │
└──────────────────────────────────────────────────────────┘数据状态说明
特征库入库状态
| 状态 | 颜色标记 | 含义 | 可执行操作 |
|---|---|---|---|
| 已入库 | 绿色标签 | 人脸特征已成功提取并入库 | 查看、更新照片、删除 |
| 入库失败 | 红色标签 | 照片质量不达标或特征提取失败 | 查看失败原因、重新上传 |
| 待更新 | 黄色标签 | 已有入库记录但照片需要更新 | 更新照片 |
检索结果状态
| 状态 | 颜色标记 | 含义 | 说明 |
|---|---|---|---|
| 命中 | 绿色高亮 | 相似度 >= 0.40，特征库中找到匹配学生 | 可点击查看详情 |
| 未命中 | 灰色显示 | 相似度 < 0.40，特征库中未找到匹配学生 | 可能该学生未入库或照片质量不佳 |
检索日志命中状态筛选
| 状态 | 说明 |
|---|---|
| 全部 | 所有检索记录 |
| 命中 | 检索结果中存在相似度 >= 0.40 的候选 |
| 未命中 | 检索结果中所有候选相似度均 < 0.40 |
筛选和搜索功能
特征库管理页面
| 筛选/搜索项 | 控件类型 | 取值来源 | 说明 |
|---|---|---|---|
| 搜索框 | 文本输入 | -- | 支持按姓名、班级、学号模糊搜索 |
| 年级 | 下拉选择 | 数据来源于班级管理中的年级列表 | 筛选指定年级 |
| 班级 | 下拉选择 | 数据来源于班级管理中的班级列表（联动年级） | 筛选指定班级 |
| 入库状态 | 下拉选择 | 已入库 / 入库失败 / 待更新 | 筛选指定入库状态 |
检索日志页面
| 筛选/搜索项 | 控件类型 | 取值来源 | 说明 |
|---|---|---|---|
| 时间范围 | 日期范围选择器 | -- | 选择起止日期，默认最近 7 天 |
| 调用者 | 下拉选择 | 数据来源于系统中持有 face:search 权限的用户列表 | 筛选指定调用者的检索记录 |
| 所属学校 | 下拉选择 | 数据来源于学校列表 | 筛选指定学校（多校区场景） |
| 命中状态 | 下拉选择 | 命中 / 未命中 | 筛选检索结果是否命中 |
| 搜索框 | 文本输入 | -- | 支持按命中人员姓名、调用者姓名搜索 |
操作步骤
步骤1：完成首次授权
- 首次进入拍照识人功能，系统弹出《人脸识别授权书》。
- 阅读授权书内容，了解人脸数据采集与使用范围。
- 勾选「我已阅读并同意」。
- 点击「确认授权」，进入功能主页。
授权说明
授权书仅需确认一次，后续使用无需重复勾选。授权记录会写入审计日志，如需撤回授权请联系学校管理员。
步骤2：拍照检索学生身份
- 在小程序端首页点击「拍照识人」图标进入检索页。
- 点击「拍照」按钮调用手机摄像头，或点击「相册」从手机相册选择已有照片。
- 将镜头对准学生面部，保持人脸居中、清晰，点击拍摄。
- 系统自动上传照片并执行 1:N 检索，约 2 秒内返回结果。
拍照技巧
- 保持光线充足，避免逆光拍摄导致面部过暗。
- 拍摄距离建议 0.5-1.5 米，确保人脸在画面中占比适中。
- 尽量拍摄正脸，侧脸角度过大可能影响识别准确率。
- 画面中仅保留目标学生一人，多人同框会导致检索失败。
网络要求
检索过程需上传照片至服务器，请确保手机网络畅通。弱网环境下可能延长响应时间，建议在 Wi-Fi 或 4G/5G 环境下使用。
步骤3：查看检索结果
- 检索完成后，页面展示 Top5 候选学生列表。
- 每条候选包含：学生头像、姓名、班级、学号、相似度分值。
- 候选结果按相似度从高到低排序，最高相似度结果置顶并高亮显示。
- 相似度达到 0.40 及以上的结果标记为「命中」，低于阈值的标记为「未命中」。
- 点击某条候选可查看该学生详细信息。
检索结果字段说明
| 字段 | 说明 |
|---|---|
| 学生头像 | 特征库中存储的学生证件照 |
| 姓名 | 学生姓名 |
| 班级 | 学生当前所在班级 |
| 学号 | 学生学号 |
| 相似度 | 检索照片与特征库照片的匹配程度，范围 0-1，越高越匹配 |
| 匹配状态 | 相似度 >= 0.40 显示"命中"（绿色），< 0.40 显示"未命中"（灰色） |
结果判读
- 相似度越高匹配越可靠，建议优先参考 Top1 结果。
- 当 Top5 相似度均低于 0.40 时，说明特征库中可能无该学生，或照片质量不佳，建议重新拍照或核实该人员是否为本校学生。
- 系统仅在照片中检测到一张人脸时返回结果，多人同框请单独拍摄目标学生。
步骤4：管理人脸特征库（Web 端）
- 在 Web 端进入「教务管理」→「拍照识人」→「特征库管理」标签。
- 可按姓名、班级、学号检索已入库学生特征记录。
- 支持以下管理操作：
- 批量建库：点击「批量导入」，上传学生照片压缩包，系统自动提取特征并入库。
- 增量更新：点击「新增」，选择学生并上传单张照片，完成单个学生特征入库或更新。
- 人员删除：选中学生记录，点击「删除」，从特征库移除该学生特征。
单个新增/更新 - 字段说明
| 字段名称 | 控件类型 | 是否必填 | 默认值 | 取值范围 / 说明 |
|---|---|---|---|---|
| 选择学生 | 人员选择器 | 必填 | 无 | 从学生列表中选择，支持按姓名/学号搜索 |
| 上传照片 | 文件选择器 | 必填 | 无 | 支持 jpg/png 格式，文件大小不超过 5MB，分辨率不低于 640x480 |
批量建库 - 压缩包格式要求
| 要求 | 说明 |
|---|---|
| 压缩格式 | ZIP 格式 |
| 文件命名 | 每张照片以学号命名，如 "2025001.jpg" |
| 照片格式 | JPG/PNG |
| 单张照片大小 | 不超过 5MB |
| 压缩包总大小 | 不超过 500MB |
| 照片数量 | 单次批量不超过 10000 张 |
建库建议
- 批量建库时建议使用学生证件照或统一采集的正面照，质量越高识别越准。
- 1 万人规模批量建库约需 25 分钟，建议在非高峰时段执行。
- 学生毕业或转学后请及时删除特征，保持特征库与在校名册一致。
照片质量要求
入库照片需满足质量分 quality >= 60 且人脸占比 >= 7%，否则将被系统拦截。请勿使用模糊、侧脸、遮挡或多人的照片入库。
步骤5：查看审计日志（Web 端）
- 在 Web 端进入「拍照识人」→「检索日志」标签。
- 可按时间范围、调用者姓名、所属学校、命中结果等条件筛选。
- 每条日志记录：调用者、所属学校、检索时间、命中人员、相似度、检索耗时。
- 点击「导出」可将日志导出为 Excel 文件存档备查。
检索日志字段说明
| 列名 | 说明 |
|---|---|
| 调用者 | 执行检索的教师/管理员姓名 |
| 所属学校 | 调用者所属学校 |
| 检索时间 | 精确到秒，如 2025-09-01 14:30:25 |
| 命中人员 | 检索结果中相似度最高的人员姓名（如未命中则显示"无"） |
| 相似度 | 最高相似度分值 |
| 检索耗时 | 本次检索的处理时间（秒） |
| 操作 | 查看原始检索图片（仅 7 天内可查看） |
日志说明
所有检索调用均强制记录审计日志，无法手动删除。拍照检索图片在 OSS 中保留 7 天后自动删除，日志中的检索结果记录长期留存以备审计追溯。
批量操作
批量导入人脸特征
- 入口：「特征库管理」页面 → 点击「批量导入」按钮
- 操作方式：
- 点击「下载导入模板」获取命名规范说明
- 按模板要求准备照片压缩包（以学号命名每张照片）
- 点击「上传压缩包」选择 ZIP 文件
- 点击「开始建库」
- 系统显示建库进度：已处理/成功/失败
- 建库完成后可查看明细，下载失败记录
- 导入限制：单次最多 10000 张照片，压缩包不超过 500MB
- 处理时间：4 核 8G 服务器处理 1 万人约需 25 分钟
批量删除人脸特征
- 入口：「特征库管理」页面 → 勾选多条记录 → 点击「批量删除」按钮
- 操作方式：
- 在特征库列表中勾选多条记录（支持全选当前页）
- 点击「批量删除」
- 系统弹出确认窗口，显示将删除的人数
- 点击「确认删除」
- 删除后该部分学生将无法被拍照识人检索到
- 注意事项：批量删除不可撤销，请仔细确认后再操作
导出特征库数据
- 入口：「特征库管理」页面 → 点击「导出」按钮
- 导出格式：Excel（.xlsx）
- 导出内容：当前筛选条件下的特征库记录，包含姓名、学号、班级、入库时间、质量分等（不含照片）
- 导出限制：单次最多导出 10000 条记录
导出检索日志
- 入口：「检索日志」页面 → 点击「导出 Excel」按钮
- 导出格式：Excel（.xlsx）
- 导出内容：当前筛选条件下的所有检索日志记录
- 导出限制：单次最多导出 50000 条记录
权限说明
角色与功能对照表
| 功能 | 系统管理员 | 安全管理员 | 教师（已授权） | 运维人员 | 学生 |
|---|---|---|---|---|---|
| 拍照检索 | ✅ | ✅ | ✅ | ❌ | ❌ |
| 特征库管理（查看） | ✅ | ✅ | ❌ | ✅ | ❌ |
| 特征库管理（新增/更新） | ✅ | ✅ | ❌ | ✅ | ❌ |
| 特征库管理（删除） | ✅ | ✅ | ❌ | ❌ | ❌ |
| 批量建库 | ✅ | ✅ | ❌ | ✅ | ❌ |
| 查看检索日志 | ✅ | ✅ | ❌ | ✅ | ❌ |
| 导出检索日志 | ✅ | ✅ | ❌ | ✅ | ❌ |
| 查看自己的检索历史 | ✅ | ✅ | ✅ | ❌ | ❌ |
数据权限范围
- 系统管理员 / 安全管理员：可管理全校人脸特征库，查看全校检索日志
- 教师（已授权）：仅可执行拍照检索，检索范围为本校特征库
- 运维人员：可管理特征库和查看检索日志，但不可执行拍照检索和删除特征
- 学生：无法访问拍照识人功能
- 跨校隔离：每所学校独立维护人脸特征库，系统按学校严格隔离，无法跨校检索学生信息
关联功能
| 关联模块 | 联动说明 |
|---|---|
| 设备管理 | 人脸特征库的数据与设备管理中的人脸同步共享同一数据源；门禁设备的人脸识别也使用相同的特征数据 |
| 人员管理 | 特征库中的学生信息（姓名、学号、班级）来源于人员管理模块 |
| 班级管理 | 特征库中按班级筛选的数据来源于班级管理模块 |
| 学生管理 | 新生入学后需在特征库中建库才能被拍照识人检索到；学生毕业/转学后需及时清理特征数据 |
注意事项
- 拍照识人仅限教师/管理员使用，学生账号无权访问，禁止用于学生之间互相检索身份。
- 每所学校独立维护人脸特征库，系统按学校严格隔离，无法跨校检索学生信息。
- 拍照检索的原始图片仅临时存储 7 天，到期自动删除，不会长期留存。
- 特征库照片质量直接影响识别准确率，入库前请确保照片符合质量要求。
- 检索结果仅供参考，最终身份确认请结合实际场景人工判断。
- 如长时间无法检索或结果异常，请联系管理员检查特征库是否已完成建库。
- 特征库容量与学校规模相关，建议定期清理已离校人员数据。
- 所有检索操作均记录审计日志，请合规使用，不得用于非工作目的。
常见问题
Q：拍照后提示"未检测到人脸"怎么办？ A：请确认拍摄画面中存在清晰的正脸，避免逆光、遮挡或人脸过小。建议调整拍摄距离和角度后重新拍摄。若多次尝试仍失败，可能是照片中学生未在特征库中登记。
Q：检索结果相似度都很低（低于 0.40）是什么原因？ A：常见原因有三种：一是该学生尚未录入特征库；二是入库照片与当前拍照差异过大（如发型、妆容变化）；三是拍摄照片质量不佳。建议先确认该学生是否已建库，必要时重新拍摄或更新入库照片。
Q：学生上传头像时被提示"照片质量不达标"如何处理？ A：系统要求照片质量分不低于 60、人脸占比不低于 7%。请引导学生使用正面、清晰、无遮挡的证件照，避免逆光、侧脸或多人同框，重新上传即可。
Q：新生入学后多久可以使用拍照识人？ A：需先将新生照片录入人脸特征库。管理员在 Web 端「特征库管理」中通过批量导入或单张新增完成入库后，新生即可被检索到。单张照片入库耗时不超过 1 秒。
Q：批量建库很慢，正常吗？ A：批量建库速度与服务器配置及照片数量有关。4 核 8G 服务器处理 1 万人约需 25 分钟。若耗时远超预期，请确认服务器资源是否被其他服务占用，建议在非高峰时段执行批量建库。
Q：学生毕业或转学后特征库如何处理？ A：管理员应在 Web 端「特征库管理」中及时删除已离校学生的特征记录，确保特征库与在校名册保持一致。删除后该学生将无法被检索到，符合数据最小化原则。
Q：能否查询历史检索记录？ A：可以。管理员在 Web 端「检索日志」中可查看所有检索调用的完整记录，包括调用者、学校、命中人员、相似度和耗时，支持按条件筛选并导出 Excel。
Q：手机拍的照片会被永久保存吗？ A：不会。拍照检索的图片存储在阿里云 OSS 中，7 天后由系统自动删除，不会长期留存。审计日志仅保留检索结果信息，不含原始照片。
Q：提示"照片质量分低于 60"怎么办？ A：说明上传的照片不满足入库质量要求。常见原因：照片模糊、光线不足、人脸角度偏转过大、照片分辨率过低。请重新拍摄或更换一张正面、清晰、光线充足的证件照。照片分辨率建议不低于 640x480。
Q：提示"人脸占比低于 7%"怎么办？ A：说明照片中人脸面积占整张照片的比例太小。请重新裁剪照片，确保人脸在照片中占比足够大，或者使用更近距离拍摄的照片。系统要求人脸占比不低于 7% 以确保特征提取的准确性。
Q：提示"该学生已存在特征记录"怎么办？ A：说明该学生的照片已在特征库中。如需更新照片，请在「特征库管理」中找到该学生记录，点击「更新」按钮上传新照片。新照片将替代旧照片进行特征提取。
Q：提示"压缩包格式错误"怎么办？ A：请确认上传的文件为 ZIP 格式，且内部照片文件为 JPG 或 PNG 格式。压缩包内不要包含子文件夹，所有照片应直接位于压缩包根目录下。每张照片文件名须为学生学号（如 2025001.jpg）。
Q：检索时提示"服务繁忙"怎么办？ A：可能是同时使用拍照检索的人数较多，服务器负载较高。请稍等几秒后重试。如持续出现该提示，请联系系统管理员检查服务器资源使用情况。
Q：教师首次使用时看不到"拍照识人"入口怎么办？ A：请确认该教师账号是否已被分配 face:search 权限。如未分配，请联系系统管理员在「权限管理」中为该教师角色添加 face:search 权限。权限添加后重新登录即可看到入口。
Q：检索结果中 Top1 不是正确的学生怎么办？ A：可能原因：一是该学生入库照片与当前拍照差异过大（如季节变化、发型变化）；二是特征库中该学生照片质量不佳。建议让该学生在「特征库管理」中更新一张近期的正面照片，提高识别准确率。