技能介绍

要解决什么问题

家长或学生经常从班级群收到手写作业照片：字多、科目杂、还要自己抄进备忘录。更麻烦的是每天要对照文档勾选完成情况，而腾讯智能文档的 Todo 勾选状态无法通过 MCP 的 read/find API 读回，只能靠打开网页看 DOM。

技能如何工作

触发条件包括发作业图、提到「作业 / homework」或要求查看进度。首次使用会走初始化：关联或新建腾讯智能文档，把 file_id 写入 workspace 下的 .workbuddy/skills/homework-tracker/config.json。

核心流程分两条线：

录入：用视觉模型识别单张或多张照片中的日期、科目与条目；无日期时会主动问「这是哪天的作业？」；按科目汇总去重后，用 smartcanvas.edit 的 INSERT_BEFORE 把新日期插在文档最上方（最新在上），且始终复用同一 file_id，初始化后禁止再用 create_smartcanvas_by_mdx 建新文档。
进度：用户说「查看作业 / 完成情况」时，默认查当天或最近一天；勾选状态必须用 Playwright + Chromium 打开文档 URL，从 .dui-checkbox-normal > input[type=checkbox] 提取 checked 并与条目对齐，再按模板汇报并自检总数。

格式上有硬约束：科目标题只能用 Markdown 双星号加粗，每天序号从 1 重新开始，避免用 HTML 标签导致渲染异常。

适用边界与注意点

前置依赖包括已配置的 腾讯文档 MCP（tencent-docs）、账号超级会员（API 调用需要）、以及用于读勾选状态的 Playwright。文档建议设为「所有人可查看」以便手机端访问。腾讯智能文档不支持勾选联动、字体颜色、自动进度公式或 export；API 有速率限制，大量 DELETE 后部分 block 可能变为 disabled。