JenkinWoo/sheeridVerify

[](https://github.com/JenkinWoo/sheeridVerify/actions/workflows/ci.yml) [](https://nodejs.org/) [](LICENSE) sheeridVerify 是一个基于 Node.js 的验证流程学习项目，提供本地 Web 工作台、任务队列、浏览器表单交互及 HTTP 状态查询，供学校教学、学术研究和获得授权的流程测试使用。 需要 Node.js >= 22.15 与 npm。从 GitHub 获取源码： 使用下载的 ZIP 时，解压后进入其中包含 package.json 的目录。在项目根目录安装依赖与浏览器： 首次使用时复制配置，已有个人配置请直接编辑原文件。 Windows PowerShell： Linux / macOS： 编辑 config/sheerid.local.json，设置获授权的国家、学校、data.organization.emailDomain 和材料来源。该文件必须是标准 JSON，不支持 // 注释或尾随逗号。网页会按姓名和配置后缀生成邮箱，仅应使用自己有权使用的真实地址与资料。document.path 与 document.url 只能填写其中一个；示例配置不包含可直接提交的真实资料。 打开 http://127.0.0.1:8787。本地默认访问密码为 JenkinWoo；对外开放前必须通过 ONEWEBPASSWORD 更换密码，并配置 HTTPS 入口。Linux 有界面浏览器需要可用桌面；完整部署步骤和环境变量模板见 部署指南。 测试使用模拟接口及本地页面，不向真实验证接口提交数据。未安装 Camoufox 时会跳过浏览器相关用例；网页和浏览器改动应在安装浏览器后验证。GitHub Actions 在 Node.js 22、24 上运行不含已安装浏览器的测试。欢迎按 贡献指南 提交问题和改进，报告前请删除个人资料、凭据及真实验证链接。 项目采用 ISC License，与 package.json 的协议声明一致。教学与研究是项目的预期用途，不额外收窄 ISC 的开源授权范围。软件按原样提供；第三方依赖和平台分别适用自己的许可和条款。请在使用前阅读完整的 用途说明与免责声明。 本项目认可并支持 LINUX DO 社区 的开源分享精神，感谢社区为开发者提供技术交流、经验分享与开源项目展示的平台。欢迎在遵守社区规则的前提下交流使用体验与改进建议。 社区推广材料见 LINUX DO 发帖草稿，其中包含推广声明模板与 AI 辅助生成的项目介绍图片。 当前命令行先用 Node.js 内置 fetch 查询状态，再选择执行流程：需要填写学生资料时使用 Camoufox，需要材料验证时使用纯 fetch 接口。材料上传保持文件原始内容，不生成或修改证明文件。 打开 http://127.0.0.1:8787。页面填写验证链接、名、姓、出生日期、代理和访问密码。url、firstName、lastName、birthDate 必须由创建任务接口传入，缺少时拒绝入队。邮箱不再由前端传入，而是每次根据配置文件中的 emailDomain 域名后缀按 First name + 点 + Last name @xxx.edu（如 first.last@xxxx.edu）格式自动拼接生成。国家、学校、材料来源、浏览器、超时、邮箱后缀等设置，每次启动任务时从 config/sheerid.local.json 读取；提交值不会写回配置文件。当前配置及示例配置不再保存验证链接和个人信息。 POST /api/jobs 的 JSON 请求体示例（认证仍使用会话 Cookie 或 X-Web-Password，写请求携带…