核心功能
Webtop Homework Skill 是一款专为以色列学校家庭设计的综合性作业管理系统,深度整合三大核心服务:
1. Webtop门户集成:通过Playwright浏览器自动化,抓取SmartSchool/Webtop学生门户的作业数据,支持多学生账户并行管理,自动解析复杂作业结构(希伯来语内容)。
2. Google Calendar智能同步:
- 个人日历与家庭共享日历双轨运行
- 自动将作业截止日期转为日历事件
- 晚间事件自动清理(可配置时间,默认18:00后)
- 智能冲突检测:识别课外活动、医疗预约与作业截止的重叠
- 颜色编码系统:按事件类型(课程/考试/庆祝/医疗/家庭活动)自动分类
3. WhatsApp自动化通知:
- 通过clawdbot平台发送格式化消息
- 支持群组广播与个人定向通知
- 定时推送每日/每周作业摘要
- 富文本格式含表情符号与结构化排版
技术架构:Python 3.7+,依赖Playwright、Google Calendar API、OAuth 2.0,采用JSON持久化存储作业状态与哈希比对实现增量监控。
显著优势
- 多子女家庭优化:单一界面管理多个学生账户,独立颜色标识
- 自动化程度高:Cron定时任务实现零人工干预的日报推送与日历清理
- 以色列本地化:原生支持希伯来语作业解析,适配当地学校系统Webtop
- 隐私设计:敏感凭证(学生密码、WhatsApp JID)强制环境变量隔离,代码库零硬编码
局限性与风险
- 强依赖外部服务:Google API配额限制、WhatsApp非官方集成稳定性、Webtop界面变更导致爬虫失效
- 技术门槛:需自行配置OAuth凭证、Playwright浏览器环境、Linux cron任务
- 安全敏感:存储学生凭证与Google令牌,虽建议权限限制但无内置加密
- 地域限制:Webtop为以色列特定平台,其他国家学校系统无法直接使用
适用人群
以色列多子女家庭的技术型父母,需同时追踪2名以上学生的作业与课外活动,且已使用Google Workspace生态。
常规风险
- 凭证泄露风险(
students_data.json、token.pickle文件权限管理) - WhatsApp账号封禁风险(非官方API使用)
- 数据准确性依赖:Webtop抓取延迟或解析错误导致遗漏作业
- 自动化操作风险:晚间事件批量删除可能误删重要日程