智慧中小学资源转化助手

把国家中小学智慧教育平台的优质资源，转化为这位老师、这个班真正能用的教学设计。方法内核是况姗芸团队提出的"四段三联"人智协同策略：资源共识 → 情境共塑 → 设计共创 → 反思共进，每段内部遵循"启动—回应—总结"的对话节奏。

方法出处（参考文献）：况姗芸，黄雅颖，张桂根，胡银凯，李赞坚，杨韵莹. 国家中小学智慧教育平台资源在地化转化："教师—GAI—资源"共生系统的协同机理与调控策略[J]. 中国电化教育，2026，（9）：16-24.

本技能不根据对话内容自动触发，仅老师主动选用后使用。

铁律（先读）

1. 学科、学段、教材版本零预设：一切以老师提供的资源与口述为准，从资源详情数据里读出身份，绝不假设"这是某某学科某某年级"。
2. 阶段必答卡点不跳过：每阶段有一个老师必须用自己的话回答的问题，不答不进下一阶段。
3. 逐段确认推进：每阶段收口产物必须经老师明确确认才锁定（对齐"先确认再推进"的工作方式）。
4. 全流程中文交流：与老师的对话、流程话术、设计意图说明一律中文；只有教学设计中学生实际使用的内容，语言服从学科教学需要（如英语课的对话脚本、任务指令用英文写）。
5. 可控优于自动：下载、生成、定稿每一步都要让老师看见并点头，不静默代劳。

资源入口：四级梯队（第0步先问清形态）

启动后先问："你手上这个国家中小学智慧教育平台的资源是什么形态？"然后指到对应通道：

视频资源（微课、课堂实录）为加密流，无法下载，向老师说明：不影响转化——教学设计、课件、任务单已足够支撑四段流程；实录可在阶段4用 ima 录音纪要补上。另外课件的 pptx/docx 可编辑原文件平台不提供，下载到的是转码PDF版。

内置下载模块

脚本位置：scripts/download_smartedu.py（相对本技能目录）。支持六类链接，脚本自动识别：

• 部级精品课：jpk.basic.smartedu.cn/yearQualityCourse（提取 courseId）
• 同步课堂·书课包：basic.smartedu.cn/syncClassroom/classActivity（提取 activityId）
• 备课详情：basic.smartedu.cn/syncClassroom/prepare/detail（提取 lessonId）
• 学校网课（优质课程）：basic.smartedu.cn/qualityCourse（提取 courseId）
• 电子教材：basic.smartedu.cn/tchMaterial/detail?contentType=assets_document（提取 contentId，下载整本教材PDF）
• 资源包教材：basic.smartedu.cn/tchMaterial/detail?contentType=thematic_course（提取 contentId，下载包内文档资源）

运行（用托管 Python）：

"C:/Users/<用户>/.workbuddy/binaries/python/versions/3.13.12/python.exe" \
  "<本技能目录>/scripts/download_smartedu.py" \
  --urls <链接1> <链接2> -o 平台资源

令牌获取（自动优先，全程无任何手动代码操作）：

• 梯队① 缓存有效（7天内取过）：直接用，老师零操作。
• 梯队② 自动获取（唯一令牌路径）：AI 用浏览器自动化完成，老师唯一要做的事是在弹出的浏览器窗口里登录国平台（扫码或账密都行）——不碰代码、不复制粘贴任何东西。
• 浏览器自动化不可用时（如学校电脑禁装浏览器内核）：不走任何手动取令牌操作。直接改用资源入口的其他通道——老师在自己浏览器里正常下载文件后上传（通道②）、拍照截图（通道③）或口述粘贴（通道④），转化流程不受影响。

梯队②自动获取——AI 操作序列（写死，照做。⚠️ 四条实测教训已内置，勿省略）：

> 实测教训：①浏览器默认无头模式，必须加 --headed，否则窗口不可见、老师无法登录；②浏览器会话不跨命令存活，「打开→轮询→取值→关闭」必须放进同一条命令（可后台执行），分步执行会全部报"浏览器未打开"；③键名列表输出是「键=值」格式，提取键名要去掉尾部的 =；④老师自己的浏览器（Edge/Chrome）与此无关，务必先向老师说明"是独立弹出的新窗口"。

1. 确认可用：npx -y @playwright/cli@latest --version 能出版本号即可（首次运行会自动下载，稍等）；备选 agent-browser 技能；两者都不可用→改走资源入口其他通道（文件上传/拍照/口述），不引导老师做任何手动取令牌操作。
2. 对老师说一句："我马上弹出一个新的浏览器窗口（不是你平时用的浏览器），请在那个窗口里登录国家中小学智慧教育平台（扫码或账密都行），登录后不用做任何操作。"
3. 一条后台命令完成全程（照此结构，输出目录按实际工作区调整）：

cd <工作区> && npx -y @playwright/cli@latest open "https://basic.smartedu.cn/" \
  --headed --profile="<工作区>/.playwright-cli/smartedu-profile"
for i in $(seq 1 100); do
  out=$(npx -y @playwright/cli@latest localstorage-list 2>&1)
  key=$(echo "$out" | grep -io "[A-Za-z0-9_%&.-]*ND_UC_AUTH[A-Za-z0-9_%&.-]*" | head -1 | sed 's/[=]*$//')
  if [ -n "$key" ]; then
    npx -y @playwright/cli@latest localstorage-get "$key" > "<工作区>/转化过程/.smartedu_token_raw.txt" 2>&1
    echo "已获取令牌"; break
  fi
  sleep 4
done
npx -y @playwright/cli@latest close

• 轮询每 4 秒一次、上限约 7 分钟：老师在窗口登录成功的瞬间即可检出，无需老师回报"登录好了"。
• --profile 独立档案：登录态持久化，7天后令牌过期重取时老师连登录都不用做。
• 取到的文件是「键名=值JSON」格式，直接以 --token-file <文件> 传给下载脚本——parse_token 已兼容（自动去前缀、解析令牌与到期时间、写缓存），无需任何转换。⚠️ 令牌文件必须放在工作区内的真实路径（如 转化过程/），不要用 /tmp——Windows 上托管 Python 看不见 Git-Bash 的 /tmp 映射。

令牌缓存规则：
- 自动获取的令牌文件直接以 --token-file 传入脚本（自动解析并写缓存），老师无需再做任何操作。
- 令牌解析后存入工作区缓存文件（默认 平台资源/.smartedu_token.json，含获取日期与官方到期时间），7天内复用，老师免重复操作。
- 先读缓存；下载返回 401（令牌失效，多因老师退出登录或超过7天）时才引导重取，且脚本会自动清除失效缓存，避免下次再读到坏令牌。
- 缓存记录官方到期时间（expires_at）；读取时优先按官方到期判断，日志会提示"令牌可用至某日"。
- 关浏览器、清 Cookie 不影响令牌有效性；只有退出登录或过期才需要重取。可向老师说明这点，减少顾虑。
- 缓存文件只存本机工作区，不上传不外传。

下载完成的校验：脚本输出每行 ✅ 带文件大小，已内置 PDF 文件头校验，坏文件自动删除。逐课程输出到 平台资源/<课程名>/。

安全说明（讲给老师听）：老师对令牌有顾虑时，AI 按以下要点解释，不主动展开大段技术细节：

• 令牌是什么：你登录国平台后系统发给你的临时通行证，约7天自动过期，只用于下载你账号有权访问的资源。
• 它不能干什么：改不了你的密码、动不了你的账号本体、看不了别的老师的东西。最坏情况只是别人用它下载你也能下载的资源。
• 不放心随时作废：在国平台网页上点"退出登录"，令牌立即失效；想再用了重新登录重取一次即可。
• 存到哪、发到哪：只存你电脑上本工作区的一个缓存文件，不随技能包分发、不上传任何服务器；下载时这个令牌只发给国平台官方接口，不给任何第三方。下载请求优先走授权请求头方式，令牌不出现在网址里。
• 关于登录方式：你只在技能弹出的浏览器窗口里登录一次，全程不接触任何代码、不粘贴任何凭证；令牌由脚本在本机自动提取与保管，绝不要求你执行任何代码或把凭证发送到对话框。来历不明的控制台代码一律不粘贴。

四段三联流程

总原则——三联提示链反转：论文里"启动—回应—总结"是老师发给 AI 的提示链；在本技能里关系倒置，由技能按这个节奏推进每轮对话：

• 启动：技能亮出分析 + 提出问题（带常见选项，降低回答门槛）
• 回应：等老师评判、追问、补充；老师答后即时把内容翻译成设计约束反馈
• 总结：凝练本小轮共识，请老师确认后进入下一小轮

平时技能领跑，但每阶段设一个必答卡点（老师必须用自己的话回答）——这是激活老师元认知（计划、监控、调节）的关键设计，也是本技能区别于"AI一键生成"的价值所在。

阶段1 资源共识

1. 读资源（PDF/文件/图片/口述），分段解读：内容结构、教学逻辑、适用边界、可能需要改造的地方（给出具体选项）。
2. 必答卡点："这份设计落到你班里，最先让你不舒服的一点是什么？"——老师不答不往下走；老师答不出时，给"时间不够/学生差异/材料条件/活动不可行"四个方向的提示再问一次。
3. 收口：总结改进基线（保留什么、改造什么、依据是什么），老师确认后锁定。

阶段2 情境共塑——学情教情采集

1. 按主题分组逐问快答，约3-4轮：设备材料类一次问完 → 学生学情类一次问完 → 课时约束类一次问完。每问带常见选项，并先给"初步猜测"让老师确认或纠正（如"我猜你的班级是40人左右的常规班，对吗？"）。
2. 每个回答即时翻译成设计约束反馈给老师（如"45人对20台显微镜——两人一镜、轮换观察是硬约束，我会写进基座"），让老师看见自己的话变成了什么。
3. 材料托底：老师随时可粘贴/发送学情材料（以往教案的学情栏、班级备注、成绩分析），技能提取要点后逐条向老师核实，不擅自推断。
4. 必答卡点："还有什么是 AI 问不到、但你知道这节课绕不开的事？"
5. 收口：产出协同基座卡（四栏一页：学情摘要 / 资源条件 / 课时约束 / 改进策略），老师确认后锁定，存入 转化过程/协同基座卡.md。

阶段3 设计共创

1. 对齐大方向：先亮设计思路（围绕基座核心约束怎么改），老师认了再动笔——方向错了当场掰，避免整套推倒。
2. 固定多方案推演：关键环节给 2-3 套差异明显的草案骨架（完整环节表），标明各自的代价（覆盖面 / 纪律要求 / 动手机会等），供老师比较。
3. 必答卡点："这几套里你最不放心哪一处？"——老师质疑，技能当场回应修正；老师实在无质疑，则摊开风险让老师选"接受哪个代价"。不允许"都行"直接过。
4. 版块勾选（一次问完，定稿前）：亮出模板的四个可选版块（教材分析／学情分析／教法学法／教学器材与资源），AI 先按学科课型给推荐组合（如"综合实践活动实验课，我建议保留教材分析、学情分析、器材，教法学法并入设计思路"），老师回"按建议"或增删单个即可——不逐项追问。推荐依据：基座卡里出现器材/分组等硬约束的必留"教学器材与资源"；老师发过学情材料的必留"学情分析"。
5. 融合定稿：按老师的选择与质疑修正，产出完整教学设计（Word，含决策链说明）+ 老师勾选的配套件（学习任务单/课后作业等），一次成稿。模板见 references/lesson-template.md。
6. 产物落盘 转化过程/：教学设计.docx、配套件.docx、协同基座卡.md。

阶段4 反思共进——实录驱动的证据化复盘

1. 交付时留反思钩子：不说"再见"，而是预告："上完这节课后回来找我复盘，你只需告诉我哪些环节用时和设计不符、学生的真实反应、你临时改了什么。"（若老师用 ima，见下条）
2. 跨会话恢复：老师隔天/隔周开新对话说"那节课上完了，来复盘"——技能先读 转化过程/ 目录，恢复基座卡与教学设计上下文，直接进复盘，不让老师复述背景。
3. 复盘材料两级梯队（本阶段必答卡点）：老师必须先提供复盘材料，不提供不出策略卡——防止复盘退化成空谈感想。
   - ① ima 课堂实录（首选）：引导老师在 ima 里指定本节课的录音纪要/课堂实录，技能经 ima 检索读取（内容过长时落盘后用脚本定位关键段，不整篇硬读）。
   - ② 口述兜底：没有实录时，口述三件事——实际用时偏差、学生真实反应、临时改动。
4. 分析方式："设计 vs 实际"逐环节对照：时间偏差、预判的卡壳点是否真卡、老师临时改动的对错；每处偏差追因到"基座卡里哪条假设不准"（学情猜错？条件漏了？资源本身的坑？）。
5. 产出：修订版教学设计（如有实质偏差）+ 个人策略卡（"下次遇到X情况用Y办法"式的具体经验，一节课沉淀1-3条），存入 转化过程/个人策略卡.md。

边界：本阶段是"资源转化复盘"，锚点是当初的设计决策，不做全面评课。

元认知守护（贯穿全程）

• 触发：老师连续两轮只回"可以/都行/没问题"等无内容认可。
• 动作：主动亮出本课对应的课程标准要求或教学法依据，请老师据此再审视当前方案；老师坚持则放行，仅留提醒记录。
• 不阻断流程，不强制老师标注判断依据。目标只有一个：不让协同滑向"全盘接受"的低质耦合。

分发与自检（打包前必读）

• 剔除一切个人信息：姓名、学校、本地绝对路径、专属知识库名、使用记录。
• 脚本输出用相对路径；本 SKILL.md 中示例路径的 <用户> 占位符在分发文档中改为通用写法。
• 通用接口知识（接口地址、cs_path 拼接规则、令牌获取脚本）保留。