﻿永福扫描代理 - 使用说明
========================

适用：紫光 Uniscan Q4990 扫描仪（TWAIN 接口），在办公室老电脑（32位）通过浏览器一键扫描

快速开始
--------
1. 把整个「扫描代理-拷到老电脑」文件夹复制到你办公室的老电脑（不要改名、不要拆开）。
2. 双击「diagnostic.bat」做环境自检（检查 NAPS2、TWAIN 驱动、端口 18751 是否空闲）。
3. 双击「start-agent.bat」启动代理。窗口应依次出现：
       [设备] 找到 NAPS2：...路径...
       [模式] 优先使用 NAPS2（TWAIN 命令行）模式
       [就绪] 永福扫描代理已启动：http://localhost:18751/
   如果没看到「[就绪]」这行，说明启动失败，请把窗口里的报错信息发给我。
4. 在老电脑本机的浏览器打开：http://localhost:18751/exam-grader/grader.html
   （localhost 指的是老电脑自己，不是别的机器）
5. 在页面点「扫描仪扫描」按钮。
6. 代理调用 NAPS2 + TWAIN 驱动完成扫描，扫描仪开始工作，扫完的图片自动回到网页。

文件说明
--------
start-agent.bat     启动扫描代理（自动定位同目录里的 NAPS2 便携版）
diagnostic.bat      环境自检工具
scanagent-twain.ps1 代理主脚本（监听 18751 端口，调用 TWAIN 驱动）
naps2-7.5.3\       NAPS2 便携版（已验证可扫描，请随文件夹一起拷贝）
  App\
    NAPS2.Console.exe  命令行扫描工具

技术要点
--------
- 代理监听本机 18751 端口
- 用 NAPS2 调用 TWAIN 驱动（紫光 Q4990 只支持 TWAIN，不支持 WIA）
- 扫描格式：JPG，默认 300dpi、彩色
- 支持连续进纸（feeder）模式：一次可扫多页
- 扫描文件存临时目录，回传网页后自动删除

常见问题
--------
Q：双击 bat 提示「不是内部或外部命令」？
A：说明文件夹被改名或拆分了。请保持整个文件夹原样，所有文件放在同一目录。

Q：代理窗口没出现「[就绪]」就退出了？
A：看窗口里最后的报错发给我；最常见是端口 18751 被旧代理占用——
   先关掉其它代理窗口，再双击一次 start-agent.bat。

Q：点扫描后没反应 / 扫描仪不工作？
A：先单独打开 NAPS2 图形界面手动扫一次，确认扫描仪和 TWAIN 驱动正常；
   再回到网页点扫描。代理窗口会打印每张扫描的进度。

Q：NAPS2 报错「未找到扫描仪」？
A：确认紫光 Q4990 已开机、USB 已连、TWAIN 驱动已装
   （C://Windows//twain_32//Uniscan 目录存在）。

Q：想用紫光原厂 MyScan 软件？
A：代理默认优先用 NAPS2 一键扫描；若同机装了 MyScan，代理也会检测到并作为
   手动备用（启动 MyScan 后需手动点它的「扫描」，代理再取图）。一般直接用 NAPS2 即可。

一键启动客户端（多乐滋扫描端，推荐）
------------------------------------
为了方便，本文件夹新增了「一键启动客户端」，把「检测代理 → 自动启动代理 → 打开扫描页」
三步合成一步，老师双击即可，无需手动开代理、手动开浏览器。

用法：
1. 先把「扫描代理-拷到老电脑」整文件夹拷到老电脑（同前）。
2. 双击「install-shortcut.ps1」→ 会在桌面生成「多乐滋扫描端」快捷方式
   （若系统禁止运行 ps1，可右键 → 用 PowerShell 运行）。
3. 以后直接双击桌面「多乐滋扫描端」快捷方式：
   - 自动检测 18751 端口，代理没开就自动拉起（窗口最小化）；
   - 等代理就绪后，自动用 Edge 以「无地址栏应用窗口」打开扫描页
     https://yongfu-grader.pages.dev/exam-grader/scanclient.html
   - 扫描页即「小乐风」界面：顶部扫描仪状态、四步进度条（扫描→上传→考号识别→客观题识别）、
     左侧就绪面板（磁盘剩余/待上传/已上传/数据目录/最新扫描缩略图），下方为扫描台账与异常卷处理。

文件说明（新增）：
launch-scanclient.bat  一键启动器（检测代理→启动→打开 Edge 应用窗口）
install-shortcut.ps1   生成桌面「多乐滋扫描端」快捷方式
launch-scanclient.ico  多乐滋吉祥物图标（桌面快捷方式与 bat 文件均使用此图标）
launch-scanclient.png  吉祥物图片（备用）

注：一键启动器依赖本机已安装 Microsoft Edge；若没有，会改用系统默认浏览器打开
    （此时不是无地址栏的应用窗口，但功能一致）。

图标说明
--------
桌面「多乐滋扫描端」快捷方式、launch-scanclient.bat 文件、扫描客户端窗口
（浏览器标签页与任务栏）均使用多乐滋小乐吉祥物图标，认图标即可认准是本系统。

========================
