每日作业汇总技能

为江西省南昌市小学一年级学生创建专业的每日作业汇总HTML页面，先展示课堂教学内容和练习题详解，再以表格形式呈现数学、语文、英文三科作业，自动部署到在线网站并生成可分享链接。

激活触发词

当用户消息包含以下词汇时自动激活：

• 作业、每日作业、作业汇总、今日作业、今天作业
• homework、功课、布置作业
• 数学作业、语文作业、英文作业
• 作业清单、作业列表

依赖安装

首次使用前必须安装Python依赖包：

# 安装二维码和图片处理库
pip install qrcode Pillow --break-system-packages

# 或使用requirements.txt
pip install -r requirements.txt --break-system-packages

依赖说明：

• qrcode: 生成二维码图片
• Pillow: 图片处理库（qrcode依赖）

工作流程

步骤1：收集基本信息

向用户询问或从用户输入中提取以下信息：

1. 日期：作业日期（默认为今天）
2. 年级：小学几年级（默认为一年级）
3. 数学作业：具体作业内容（1-3项）
4. 语文作业：具体作业内容（1-3项）
5. 英文作业：具体作业内容（1-3项）

步骤2：搜索课堂教学内容

重要：先搜索当天的课堂教学内容，包括具体的练习题、解题方法和易错点。

2.1 搜索教学内容概览

为每个科目使用web_search工具搜索：

• 江西省南昌市小学一年级当天的教学内容
• 教材版本和课程进度
• 主要知识点和学习目标

搜索查询示例：

• 江西南昌小学一年级数学 [学期] 第[周]周 教学内容 课程安排
• 江西南昌小学一年级语文 人教版 [课文名] 教学重点
• 江西南昌小学一年级英语 [单元] 教学目标 知识点

2.2 搜索具体练习题和解题方法（关键！）

如果作业提到”课堂”、”讲解”等，必须进一步搜索练习“、”练习题：

数学科目：

• 搜索具体的题目类型和例题
• 查询：小学一年级数学 [知识点] 练习题 解题方法 易错点
• 查询：小学一年级 [运算类型] 口算技巧 解题步骤
• 例如：小学一年级 10以内加减法 练习题 解题方法 易错点

语文科目：

• 搜索具体的拼音、生字、课文练习
• 查询：小学一年级语文 [课文名/知识点] 练习题 答案解析
• 查询：小学一年级 拼音 [具体内容] 练习 常见错误
• 例如：小学一年级 韵母表 默写技巧 书写要求

英语科目：

• 搜索具体的单词、句型练习
• 查询：小学一年级英语 [单元] 练习题 重点句型
• 查询：小学英语 [单元] 单词 练习 易错点

2.3 提取并整理内容

必须包含以下内容（越具体越好）：

基础信息：

• 学习内容：今天学了什么（具体到课文名、知识点名称）
• 教学重点：老师强调的重点（具体列出）
• 学习目标：本节课要达到的目标

具体练习内容：

• 典型例题：展示1-2道课堂练习的典型题目
• 解题步骤：详细的解题方法和步骤
• 易错点分析：学生容易出错的地方及原因
• 注意事项：做题时需要特别注意的点

示例格式：

典型例题1：8 + 5 = ?
解题方法：
1. 凑十法：8 + 2 = 10，5 - 2 = 3，10 + 3 = 13
2. 拆分法：5 = 2 + 3，先算 8 + 2 = 10，再算 10 + 3 = 13

易错点：
• 容易直接数数，容易数错
• 容易算成 8 + 5 = 12（忘记进位）
• 凑十法时容易忘记剩余的数

正确答案：13

步骤3：搜索作业相关信息

使用web_search工具为每项作业搜索：

• 作业对应的书本知识点（教材页码、章节）
• 作业完成方法和技巧
• 易错点和注意事项

搜索查询示例：

• 小学一年级数学 [作业主题] 知识点 教材
• 小学一年级语文 [作业主题] 学习方法 书本
• 小学一年级英语 [作业主题] 练习技巧

步骤4：生成表格化作业汇总

为每项作业整理以下内容，用表格形式展示：

1. 作业内容：具体作业要求和任务描述
2. 重要程度：⭐⭐⭐（高）、⭐⭐（中）、⭐（低）
3. 如何完成：完成步骤、方法和注意事项
4. 书本知识：对应教材的章节、页码和知识点

重要程度判断依据：

• ⭐⭐⭐ 高：新知识点、难度较高、需要家长重点辅导
• ⭐⭐ 中：常规练习、巩固复习、需要监督完成
• ⭐ 低：简单任务、自主完成、课外拓展

步骤5：生成HTML页面

使用 assets/template.html 模板生成作业汇总页面。

模板变量说明：

• {{DATE}} – 作业日期
• {{GRADE}} – 年级
• {{MATH_CLASS_CONTENT}} – 数学课堂内容HTML
• {{MATH_PRACTICE_DETAIL}} – 数学练习题详解HTML
• {{MATH_ITEMS}} – 数学作业表格HTML
• {{CHINESE_CLASS_CONTENT}} – 语文课堂内容HTML
• {{CHINESE_PRACTICE_DETAIL}} – 语文练习题详解HTML
• {{CHINESE_ITEMS}} – 语文作业表格HTML
• {{ENGLISH_CLASS_CONTENT}} – 英文课堂内容HTML
• {{ENGLISH_PRACTICE_DETAIL}} – 英文练习题详解HTML
• {{ENGLISH_ITEMS}} – 英文作业表格HTML

课堂内容格式：

<div class="class-content">
    <h3 class="content-title">今日课堂内容</h3>
    <div class="content-box">
        <div class="content-item">
            <span class="content-label">学习内容：</span>
            <span>第5课《小蝌蚪找妈妈》</span>
        </div>
        <div class="content-item">
            <span class="content-label">教学重点：</span>
            <span>认识生字词，理解课文内容，学习小蝌蚪成长变化过程</span>
        </div>
        <div class="content-item">
            <span class="content-label">学习目标：</span>
            <span>能够正确朗读课文，认识本课15个生字</span>
        </div>
    </div>
</div>

练习题详解格式：

<div class="practice-detail">
    <div class="practice-title">课堂练习详解</div>
    
    <div class="example-question">
        <div class="question-number">例题 1</div>
        <div class="question-content">8 + 5 = ?</div>
        
        <div class="solution-steps">
            <div class="solution-title">解题方法：</div>
            <ol>
                <li><strong>方法一（凑十法）：</strong>8 + 2 = 10，5 - 2 = 3，10 + 3 = 13</li>
                <li><strong>方法二（拆分法）：</strong>将5拆成2和3，先算 8 + 2 = 10，再算 10 + 3 = 13</li>
            </ol>
        </div>
        
        <div class="mistakes-box">
            <div class="mistakes-title">易错点：</div>
            <ul>
                <li>容易直接用手指数数，容易数错</li>
                <li>容易算成 8 + 5 = 12（忘记进位）</li>
                <li>使用凑十法时容易忘记剩余的数</li>
            </ul>
        </div>
        
        <div class="answer-box">
            <span class="answer-label">正确答案：</span>
            <span class="answer-value">13</span>
        </div>
    </div>
</div>

作业表格格式：

<table class="homework-table">
    <thead>
        <tr>
            <th width="25%">作业内容</th>
            <th width="15%">重要程度</th>
            <th width="30%">如何完成</th>
            <th width="30%">书本知识</th>
        </tr>
    </thead>
    <tbody>
        <tr class="priority-high">
            <td>
                <div class="task-number">1.</div>
                <div class="task-desc">完成课本第45-46页练习题</div>
            </td>
            <td>
                <span class="priority-badge high">⭐⭐⭐ 高</span>
            </td>
            <td>
                <ul class="completion-steps">
                    <li>先复习今天学的加减法</li>
                    <li>独立完成，家长检查</li>
                    <li>注意书写工整</li>
                </ul>
            </td>
            <td>
                <div class="book-info">
                    <div><strong>教材：</strong>人教版数学一年级上册</div>
                    <div><strong>章节：</strong>第4单元 认识图形</div>
                    <div><strong>知识点：</strong>平面图形的识别与分类</div>
                </div>
            </td>
        </tr>
    </tbody>
</table>

重要程度样式：

• priority-high – 高重要度（⭐⭐⭐）：新知识、需重点辅导
• priority-medium – 中等重要度（⭐⭐）：常规练习
• priority-low – 低重要度（⭐）：简单任务、课外拓展

步骤6：保存本地文件

将生成的HTML文件保存到输出目录。

步骤7：在线部署

重要：为了方便家长随时查看作业，需要将HTML部署到免费在线网站。

自动部署

使用提供的 scripts/deploy.py 脚本自动完成部署：

python scripts/deploy.py homework_2025-01-08.html

脚本会自动：

1. 检查并安装 surge（如需要）
2. 检查 surge 登录状态，自动登录（使用配置文件）
3. 生成带日期和星期的域名（例如：homework-20250108-wed.surge.sh）
4. 部署HTML文件到在线网站
5. 生成分享链接和话术
6. 生成二维码（PNG格式）

输出示例：

日期: 2025年01月08日 周三
域名: homework-20250108-wed.surge.sh

检查 surge 登录状态...
找到 surge 配置文件
正在登录 surge...
   账号: tanfeideshouji@163.com
surge 登录成功！

正在部署到 homework-20250108-wed.surge.sh...

部署成功！

在线链接（可分享给妈妈）：
   https://homework-20250108-wed.surge.sh

分享话术：
   "今天（01月08日 周三）的作业已整理好了
   点击查看：https://homework-20250108-wed.surge.sh
   包含了今天学习的内容和作业详情"

有效期: 长期有效
提示: 下次生成新作业时，会覆盖今天的链接

二维码已生成: homework_2025-01-08_qr.png

Surge 配置（首次使用需要）

Surge 是什么？

• 免费的静态网站托管服务
• 无需注册即可部署
• 自动生成 https 链接
• 长期有效，访问速度快

方式A：使用配置文件（推荐，自动登录）

配置文件位于：config/surge_config.txt

[surge]
email = tanfeideshouji@163.com
password = tanfei123456

特点：

• 首次部署时自动登录
• 无需手动输入密码
• 下次部署自动识别登录状态

方式B：手动登录（备选）

如果配置文件不工作，可以手动登录：

surge login
# 输入邮箱：tanfeideshouji@163.com
# 输入密码：tanfei123456

登录成功后，以后部署时会自动使用已登录账号。

验证登录状态：

surge whoami
# 应该显示：tanfeideshouji@163.com

注意事项：

• 配置文件包含密码，请妥善保管
• 不要分享配置文件给他人
• 如果更改密码，需要同步更新配置文件

手动部署（备选方案）

如果自动部署失败，可使用以下方案：

方案A：Netlify Drop（最简单）

1. 访问 https://app.netlify.com/drop
2. 将生成的HTML文件拖拽上传
3. 复制 Netlify 生成的链接（例如：random-name-123456.netlify.app）
4. 分享链接给妈妈

方案B：手动使用 surge

# 安装 surge（首次使用）
npm install -g surge

# 部署
surge homework_2025-01-08.html homework-20250108-wed.surge.sh

域名规范

• 格式：homework-YYYYMMDD-weekday.surge.sh
• 日期：8位数字（例如：20250108）
• 星期：英文缩写（mon/tue/wed/thu/fri/sat/sun）
• 示例：homework-20250108-wed.surge.sh

分享建议

向妈妈分享时可包含：

• 日期和星期
• 直接链接
• 简短说明（包含学习内容和作业）
• 提醒查看重点作业（⭐⭐⭐标记的）

颜色主题

• 数学：蓝色系 (#3B82F6)
• 语文：绿色系 (#10B981)
• 英文：紫色系 (#8B5CF6)
• 重要标记：金色 (#F59E0B)

示例交互

用户输入示例：

今天的作业：
数学：完成课本第45页练习题，背诵乘法口诀
语文：预习第8课《卖火柴的小女孩》，抄写生字词
英语：听读Unit 5课文，完成练习册

Claude处理步骤：

1. 确认日期和年级（默认一年级）
2. 搜索课堂内容：
   • 搜索”江西南昌小学一年级数学 本周教学内容”
   • 搜索”江西南昌小学一年级语文 第8课 教学重点”
   • 搜索”江西南昌小学一年级英语 Unit 5 教学目标”
3. 搜索练习题详解：
   • 搜索”小学一年级数学 [知识点] 典型例题 解题方法 易错点”
   • 搜索”小学一年级 乘法口诀 练习题 记忆技巧”
   • 搜索”小学一年级语文 第8课 生字词 书写要点 易错字”
   • 提取具体例题、解题步骤、易错点分析
4. 搜索作业信息：
   • 搜索每项作业对应的书本知识点
   • 搜索完成方法和注意事项
5. 生成HTML页面：
   • 先展示每个科目的课堂内容
   • 展示练习题详解（例题+解法+易错点）
   • 再用表格展示作业详情
6. 在线部署：
   • 运行 deploy.py 脚本
   • 生成带日期和星期的链接
   • 提供分享话术
7. 输出结果：
   • 本地文件
   • 在线链接
   • 分享建议

最终输出示例：

作业汇总已生成！

本地文件：
   homework_2025-01-08.html

在线链接（可分享给妈妈）：
   https://homework-20250108-wed.surge.sh

分享话术：
   "今天（01月08日 周三）的作业已整理好了
   点击查看：https://homework-20250108-wed.surge.sh
   
   包含内容：
   今天学习的课堂内容
   三科作业详情（含重点标记）
   完成方法和注意事项
   对应的教材知识点
   
   请重点关注带⭐⭐⭐标记的作业"

使用建议：
   - 妈妈可通过链接随时查看
   - 建议保存到微信收藏或浏览器书签
   - 链接长期有效，可重复访问

生成的汇总包含：

• 每个科目先展示”今日课堂内容”（学习内容、教学重点、学习目标）
• 作业表格包含4列：作业内容、重要程度、如何完成、书本知识
• 在线可访问的链接，便于家长随时查看
• 便于家长了解学生学了什么，有针对性地辅导作业和复习

文件引用

• HTML模板: assets/template.html – 作业汇总页面模板
• 样式指南: references/style_guide.md – 设计规范
• 部署脚本: scripts/deploy.py – 自动部署脚本

关键特性

1. 课堂内容展示：先展示今日学习内容，家长了解孩子学了什么
2. 表格化作业：清晰展示作业内容、重要程度、完成方法、书本知识
3. 重要度分级：⭐⭐⭐高、⭐⭐中、⭐低，帮助家长优先辅导
4. 在线分享：自动部署到免费网站，生成可分享链接
5. 移动适配：响应式设计，手机和电脑都能完美查看