let captured = '';
const orig = window.history.pushState.bind(window.history);
window.history.pushState = function(s, t, url) { captured = url; orig(s, t, url); };
[...document.querySelectorAll('app-lesson-card.square-item')]
  .find(c => c.textContent.includes('课程标题关键词'))
  ?.querySelector('a')?.click();
return captured; // 返回类似 "/course/detail?courseId=d5b19f94..."

随后调用 navigate 命令，跳转至 https://lawschool.lawyerpass.com 拼接捕获到的路径。

选课入口校验（⚠️ 关键）

部分来自「课程广场」的课程需先完成选课操作，视频区域才会加载显示：

// 步骤 1：检测并点击选课按钮
const btn = [...document.querySelectorAll('button, a, [class*=btn]')]
  .find(el => el.textContent.includes('选修并学习'));
if (btn) { btn.click(); return 'clicked_enroll'; }
return 'no_enroll_btn';

若成功点击 → 等待 3 秒 → 点击确认弹窗：

const confirm = [...document.querySelectorAll('button, [class*=btn], [class*=confirm]')]
  .find(el => el.textContent.match(/确定|确认|OK/));
confirm?.click();

再等待 3 秒后，执行 video.play() 开始播放。

视频状态检测

const v = document.querySelector('video');
if (!v) return JSON.stringify({ found: false, url: location.href });
return JSON.stringify({
  found: true,
  ct: Math.round(v.currentTime),
  dur: Math.round(v.duration),
  paused: v.paused,
  ended: v.ended,
  url: location.href
});

播放完成判定条件：ended === true 或 ct >= dur - 3

注意：部分视频结束时 ended 为 false，但 ct === dur —— 必须同时检查两项条件。

定时任务配置

{
  "schedule": { "kind": "every", "everyMs": 480000 },
  "sessionTarget": "isolated",
  "payload": { "kind": "agentTurn", "timeoutSeconds": 120 }
}

⚠️ 请勿将 everyMs 设为小于 300000（即 5 分钟） —— 将导致 API 调用频率超限错误。

状态文件结构说明

完整 video_state.json 结构定义详见 references/state-schema.md。 可使用 scripts/lawschool_init_state.py 脚本生成初始状态文件。

通知机制

每次视频开始播放和播放完成时，均需调用 message 工具发送通知：

• 播放完成：✅ 播完：{title}（{done}/{total}）
• 开始播放：▶ 开始：{title}，{duration}，第{done+1}/{total}门
• 全部完成：🎉 全部{total}门完成！

参考文档