gh_mirrors/au/auto-submit配置详解：从学校信息到邮件推送，新手也能轻松搞定

【免费下载链接】auto-submit今日校园自动提交疫情上报，通用项目地址: https://gitcode.com/gh_mirrors/au/auto-submit

今日校园自动提交疫情上报工具（auto-submit）是一款帮助学生和教职工快速完成每日健康信息上报的开源项目。通过简单的配置，即可实现自动填写表单、提交信息并发送通知，让你告别繁琐的每日打卡流程。本文将详细介绍如何从基础配置到高级功能，一步步完成项目的部署与使用。

快速开始：3分钟完成项目部署

1. 克隆项目仓库

首先需要将项目代码克隆到本地环境，打开终端执行以下命令：

git clone https://gitcode.com/gh_mirrors/au/auto-submit cd auto-submit

2. 安装依赖环境

项目基于Python开发，需要安装相关依赖包。requirements.txt文件中已列出所有必要组件，执行以下命令一键安装：

pip install -r requirements.txt

3. 配置运行环境

项目支持云函数部署，通过腾讯云函数控制台可快速创建运行环境。在创建函数时选择"空白函数"模板，运行环境指定为Python 3.6：

图：在云函数控制台创建auto-submit运行环境，选择Python 3.6作为执行环境

核心配置：学校信息与用户参数设置

主配置文件详解（config.yml）

项目的核心配置文件为config.yml，包含登录API、用户信息、表单默认值等关键参数。以下是主要配置项说明：

# 登陆相关配置 login: api: "http://www.zimo.wiki:8080/wisedu-unified-login-api-v1.0/api/login" # 用户组配置 users: - user: username: '161105024' # 学号/工号 password: '161105024' # 密码 address: 中国四川省成都市金牛区一环路北1段-129号-附9号 # 定位地址 email: 461009747@qq.com # 通知邮箱 school: 宜宾学院 # 学校全称

多用户配置技巧

如需为多个用户配置自动提交，只需取消注释config.yml中的多用户模板并添加新用户信息：

# 多用户配置示例 # - user: # username: 161105025 # password: 161105025 # address: 中国四川省成都市武侯区XX路XX号 # email: student@school.com # school: 宜宾学院

⚠️ 注意：如果表单包含图片上传项，不建议使用多用户配置，可能导致提交失败。

智能表单生成：自动匹配学校上报模板

使用generate.py生成专属配置

项目提供了自动表单生成工具generate.py，可根据学校实际表单自动生成配置模板。运行以下命令启动生成向导：

python generate.py

程序会自动获取学校表单结构，并引导你填写每项必填内容：

图：generate.py工具运行界面，通过命令行交互生成表单配置

表单配置项说明

生成的表单配置会包含以下类型（对应今日校园接口fieldType字段）：

• 类型1/5：文本输入项（如体温、今日行程）
• 类型2：单选题（如健康状况、是否接触风险人员）
• 类型3：多选题（如症状选择、出行方式）
• 类型4：图片上传（需指定图片文件名）

生成的配置会自动保存为YAML格式，可直接复制到config.yml的defaults节点中。

高级功能：邮件推送与通知设置

邮件通知配置

项目支持通过邮件发送提交结果通知，需在config.yml的Info.Email节点进行配置：

Info: Email: enable: true server: smtp.exmail.qq.com # SMTP服务器地址 port: 465 # 端口号（通常为465） account: '' # 邮箱账号 password: '' # 邮箱密码/授权码

常见邮箱SMTP服务器参考：

• QQ邮箱：smtp.qq.com（端口465）
• 163邮箱：smtp.163.com（端口465）
• 学校企业邮箱：通常格式为smtp.exmail.xx.edu.cn

其他通知方式

除邮件外，项目还支持ServerChan和Qsmg酱通知（需在config.yml中填写对应SCKEY）：

Info: ServerChan: # Server酱SCKEY Qsmg: # Qsmg酱SCKEY

依赖管理：轻松配置运行环境

本地依赖打包

如需在云函数环境部署，需将依赖包打包为zip文件。可通过以下命令生成依赖包：

pip install -r requirements.txt -t ./dependency zip -r dependency.zip ./dependency

云函数依赖配置

在云函数控制台的"层配置"中上传生成的dependency.zip，并选择Python 3.6运行环境：

图：在云函数控制台配置项目依赖层，上传dependency.zip包

常见问题解决

1. 表单提交失败

• 检查config.yml中的学校全称是否准确（需与今日校园完全一致）
• 确认address字段格式是否正确（建议使用详细地址）
• 检查网络连接，确保能正常访问今日校园服务器

2. 邮件通知不发送

• 确认SMTP服务器和端口是否正确
• 检查邮箱账号密码是否正确（部分邮箱需使用授权码）
• 查看垃圾邮件文件夹，通知邮件可能被拦截

3. 多用户配置冲突

• 确保每个用户的配置使用独立的缩进和"- user:"标识
• 避免不同用户使用相同的邮箱地址
• 包含图片上传项的表单建议单用户配置

通过以上步骤，你已经掌握了auto-submit项目的完整配置流程。无论是个人使用还是校园集体部署，这款工具都能帮你轻松搞定每日疫情上报，让健康打卡不再成为负担！

【免费下载链接】auto-submit今日校园自动提交疫情上报，通用项目地址: https://gitcode.com/gh_mirrors/au/auto-submit