XiucuiGuan/teachany-hepbl

TeachAnyHEPBL

Turn a university course project goal (+ optional discipline / course / deliverable) into:

1. PNG long image — structured HE-PBL breakdown + course knowledge-system graph
2. Interactive webpage — 与长图内容一致的交互式项目拆解网页，含可在线填写的项目书、小组信息栏，支持一键提交到教师邮箱（规范见 references/interactive-webpage.md）
3. Edit URL — https://www.teachany.cn/pbl?... for chat refinement, node tweaks, courseware

The decomposition uses TeachAny's six-stage pipeline on teachany.cn (LLM + curriculum index). Do not invent knowledge nodes yourself — align against the target course syllabus (课程大纲 / 培养方案) rather than fabricating chapter-level structure.

Workflow

1. Parse the course project goal and optional fields (see references/parameters.md). Default --grade university.
2. Run the bundled CLI from this skill directory (where SKILL.md lives):

python3 scripts/hepbl-decompose.py \
  --goal "用户的项目任务原文" \
  --grade university \
  --subject computer-science \
  -o ./pbl-output

3. On first run, install deps if missing: pip install playwright && playwright install chromium
4. Draft the HE-PBL design following references/course-blueprint.md — three-dimension objectives, Bloom's levels, prerequisite chain, academic workflow. Use references/examples.md as style reference.
5. 设计方案权威校准（存在设计方案文档时强制，不得跳过）：从设计方案逐字提炼 overlay JSON → 运行 scripts/calibrate_hepbl.py 重建网页与长图（详见下文「设计方案权威校准门禁」与「技术路线可视化规范」）。
6. Reply with the PNG path, interactive webpage path, node counts from JSON, the three-dimension objectives, and edit_url (never include auto=1 in links you give users).
7. If Playwright fails, follow references/fallback.md — still return an edit link.

受限机器替换脚本（保留原方案，跑不通时改用）

scripts/hepbl-decompose-local.py 是原脚本的替换版（原 hepbl-decompose.py 保留不动），针对以下已验证的本机问题：

1. Playwright 自带 Chromium 下载停滞（CDN 不可达）→ 自动回退 channel="msedge" 系统 Edge
2. 360s 超时不够 → TIMEOUT_MS = 900_000（pbl 页统一索引 localStorage 超配额，每次全量重建约 100–180s，全流程实测 8–11 分钟，务必后台运行）
3. goto 偶发 net::ERR_NETWORK_CHANGED → 自动重试 3 次（间隔 5s）

# 用法与原脚本完全一致（模板仍按 ../assets/hepbl-report.html 相对定位，勿移动）
python scripts/hepbl-decompose-local.py --goal "..." --grade university --subject mathematics -o ./pbl-output

排障速查：长图有了但缺交互网页 = 脚本被复制到别处运行导致 ../assets/ 模板找不到（静默跳过，把模板放回同级即可）；本机 SciPy 被 Windows 应用控制策略拦截（_trlib DLL），LP 类项目代码一律 PuLP(CBC) 为主、SciPy 用 try/except 设为可选交叉验证（NumPy/PuLP 正常）。

HE-PBL design standards (required in output)

Every design MUST include:

• 知识目标 / 能力目标 / 素质目标（three-dimension objectives）
• Bloom's taxonomy level（记忆 / 理解 / 应用 / 分析 / 评价 / 创造）per objective
• 前置知识要求（prerequisite chain to prior courses / chapters）
• 核心概念与难点 mapped to the course knowledge system
• 项目流程：文献调研 → 方案设计 → 实施验证 → 成果汇报
• 可评估产出 with academic standards（实验报告 / 设计文档 / 答辩）

See references/course-blueprint.md for the full standard.

设计方案权威校准门禁（强制）

存在设计方案文档（如「PBL 项目设计方案」md）时，引擎拆解只是初稿，最终交付必须过校准门禁：

1. 逐字提炼 overlay：节点名、三维目标、约束数字、基准结果（x*/Z*/影子价格）、阶段学时全部从设计方案文档逐字摘取，不得编造或改写。
2. null 删除污染：引擎编造字段（techRoute/pathPlan/projectBlueprint/stats）在 overlay 中置 null，deep_merge 时删除；_ 前缀元数据键剥离。
3. 长图 = 网页：用 scripts/calibrate_hepbl.py 重建网页与长图（Playwright 整页截图，device_scale_factor=2），交付前完成自查（节点名与设计方案一致、payload 零残留、summary 与节点数一致）。
4. 统一标题：overlay 必须含 title 字段（与设计方案标题逐字一致）——网页 Hero、标签页、导出报告、长图标题全部取自 DATA.title（缺失回退 goal）。
5. 继续编辑入口：网页端「在 TeachAnyHE 打开」按钮一键复制 @skill:TeachAnyHE 技能调用指令（粘贴到 WorkBuddy 对话框即以高等教育场景继续编辑）；引擎 teachany.cn 链接降级为「TeachAny 引擎初稿」小字链接保留（DATA.edit_url）。

技术路线可视化规范

• 网页端优先渲染 techStages[]（stage/hours/tasks[]/output）+ toolChain[]（name/use）分层流程图：工具链 chips → 箭头衔接 → 阶段卡（序号圆点 + 连接线 + 学时徽章 + 任务清单 + 阶段产出）；缺失时回退 projectPhases 四段式列表。
• 数据契约与区块结构见 references/interactive-webpage.md；完整 overlay 示例见 references/calibration-example-lp.json。

Output template

## HE-PBL 课程设计拆解

**项目**：{title}

![课程知识路径拆解]({png_path})

- **图谱节点**：{nodeCount}（大纲对齐 {matched} · 拓展 {external}）
- **知识目标**：{...}
- **能力目标**：{...}
- **素质目标**：{...}
- **布鲁姆层级**：{...}
- **交互式网页**：[打开项目拆解网页]({html_path})（可在线填写项目书、小组信息并提交教师邮箱）
- **继续编辑**：网页端「在 TeachAnyHE 打开」按钮一键复制技能调用指令（粘贴到 WorkBuddy 对话框即以 HE 场景继续编辑）· 引擎初稿链接：{edit_url}

「在 TeachAnyHE 打开」按钮复制的指令粘贴到 WorkBuddy 对话框，可继续对话修改拆解、调整知识点、一键制作课件。

Show the PNG in chat when the environment supports images.

Why not hand-write the graph?

TeachAny matches nodes against curriculum indexes, runs relevance review, and builds dependency edges. A plain LLM list misses 大纲对齐 and produces fake node IDs.

Examples

See references/examples.md for a full HE-PBL example library across 数学 / 计算机 / 通信 / 电气 courses. Quick examples:

Example 1 — 数据结构：python3 scripts/hepbl-decompose.py --goal "设计校园导航最短路径系统…" --grade university --subject computer-science --deliverable engineering-prototype -o ./pbl-output

Example 2 — 信号与系统：python3 scripts/hepbl-decompose.py --goal "FIR 滤波器设计与频谱分析…" --grade university --subject communications --deliverable simulation-report -o ./pbl-output

Additional resources

• Parameter reference: references/parameters.md
• HE-PBL design standard: references/course-blueprint.md
• Interactive webpage spec: references/interactive-webpage.md
• Example library: references/examples.md
• Playwright unavailable: references/fallback.md