核心功能
IServ Skill 是一个专为德国学校 IServ 平台设计的 HTTP 客户端工具，无需浏览器自动化即可实现学生日常操作的自动化。主要功能模块包括：
邮件与通讯
- 查询未读邮件数量
- 获取最近邮件（IMAP 协议）
- Messenger 聊天列表、消息读取与发送
日历与公告
- 获取即将到来的日历事件（JSON 格式）
- 支持 announcements/news（规划中）
文件管理（best-effort）
- 浏览文件目录结构
- 递归搜索文件/文件夹
- 上传（支持分块上传与遗留表单回退）
- 下载、创建文件夹、重命名/移动、删除
作业管理（best-effort）
- 作业列表获取（HTML 解析）
- 作业详情查看与附件下载
- 作业提交（表单驱动，自动解析页面表单结构）
技术实现特点
- 纯 HTTP 实现：基于会话 cookie 认证，无浏览器依赖
- 多配置文件支持：通过环境变量支持并行多账户
- 自适应端点发现：尝试 Symfony FOS 路由，回退通用 API 路径
- 稳健的文件上传：优先使用 FS Dropzone 分块上传，失败时回退到遗留表单上传
显著优点
1. 轻量高效：相比浏览器自动化，HTTP 客户端资源占用极低，响应更快
2. 灵活配置：支持单账户/多账户环境变量配置，适合个人和机构部署
3. 功能覆盖面广：涵盖学生日常高频场景（邮件、文件、作业、日历、即时通讯）
4. 持续演进：明确标注 "best-effort" 和 "next steps"，开发透明度高
潜在局限与风险
| 方面 | 说明 |
|------|------|
| **版本兼容性** | IServ 各实例端点存在差异，部分功能标记为 "best-effort"，可能因学校实例不同而失效 |
| **作业提交** | 依赖 HTML 解析，若 IServ 更新页面结构可能导致提交失败 |
| **文件操作** | 创建文件夹、重命名、删除等高级功能受限于具体 IServ 版本支持 |
| **安全依赖** | 需妥善保管 ISERV_USER/ISERV_PASS 环境变量，避免凭证泄露 |
适用人群
- 德国中小学生/大学生：需自动化管理 IServ 日常事务
- 家长：代管子女学校平台事务
- 教育机构 IT 管理员：批量操作或数据同步场景
- 开发者：基于 IServ 数据构建第三方工具或集成
常规风险提示
- 凭证安全：严禁硬编码密码，建议使用密钥管理服务或 CI/CD 密钥注入
- 数据隐私：处理学生数据需遵守 GDPR（欧盟通用数据保护条例）
- 服务稳定性：依赖 IServ 平台可用性，学校维护期间可能中断
- 误操作风险：文件删除为不可逆操作，需谨慎使用