@aiyiran/myclaw 1.1.34 → 1.1.35

package/skills/yiran-course-template-pipeline/template-index.json

@@ -0,0 +1,269 @@
+{
+  "index_updated_at": "2026-04-22T05:11:25Z",
+  "templates": {
+    "A": {
+      "100": {
+        "系列": "A",
+        "编号": "100",
+        "名称": "给依然老师设计一个AI画像",
+        "文件夹名": "a100_给依然老师设计一个AI画像",
+        "路径": "templates/a100_给依然老师设计一个AI画像",
+        "student_json": "templates/a100_给依然老师设计一个AI画像/__student__.json",
+        "teacher_json": "templates/a100_给依然老师设计一个AI画像/__teacher__.json",
+        "入口文件": "templates/a100_给依然老师设计一个AI画像/index.html",
+        "一句话说明": "先让 AI 生成一个老师形象，再用网页把它展示出来，重点练习描述和小修改。",
+        "主能力标签": "表达构建",
+        "任务类型标签": "视听表达",
+        "关键词": [
+          "a100_给依然老师设计一个AI画像",
+          "先让 AI 生成一个老师形象，再用网页把它展示出来，重点练习描述和小修改。",
+          "初次接触",
+          "需要明确目标",
+          "持续迭代",
+          "围绕明确对象生成形象",
+          "把人物图片放进网页中完成展示",
+          "通过小幅修改让作品逐步变好",
+          "给依然老师设计一个AI画像",
+          "表达构建",
+          "视听表达"
+        ],
+        "files": [
+          "__demo__.html",
+          "__student-view__.html",
+          "__student__.json",
+          "__teacher-view__.html",
+          "__teacher__.json",
+          "index.html"
+        ],
+        "updated_at": "2026-04-22T04:32:31Z"
+      },
+      "101": {
+        "系列": "A",
+        "编号": "101",
+        "名称": "做3张同主题图片",
+        "文件夹名": "a101_做3张同主题图片",
+        "路径": "templates/a101_做3张同主题图片",
+        "student_json": "templates/a101_做3张同主题图片/__student__.json",
+        "teacher_json": "templates/a101_做3张同主题图片/__teacher__.json",
+        "入口文件": "templates/a101_做3张同主题图片/__demo__.html",
+        "一句话说明": "先确定一个有趣的主题，再用 AI 生成 3 张风格统一、但情节不同的系列图片。",
+        "主能力标签": "表达构建",
+        "任务类型标签": "视听表达",
+        "关键词": [
+          "a101_做3张同主题图片",
+          "先确定一个有趣的主题，再用 AI 生成 3 张风格统一、但情节不同的系列图片。",
+          "初次接触",
+          "需要明确目标",
+          "练习通过提示词锁定画面风格",
+          "理解作品一致性的价值",
+          "初步接触提示词的模块化修改",
+          "做3张同主题图片",
+          "表达构建",
+          "视听表达"
+        ],
+        "files": [
+          "__demo__.html",
+          "__student-view__.html",
+          "__student__.json",
+          "__teacher-view__.html",
+          "__teacher__.json"
+        ],
+        "updated_at": "2026-04-22T04:32:32Z"
+      },
+      "102": {
+        "系列": "A",
+        "编号": "102",
+        "名称": "图片资源展示",
+        "文件夹名": "a102_图片资源展示",
+        "路径": "templates/a102_图片资源展示",
+        "student_json": "templates/a102_图片资源展示/__student__.json",
+        "teacher_json": "templates/a102_图片资源展示/__teacher__.json",
+        "入口文件": "templates/a102_图片资源展示/index.html",
+        "一句话说明": "把图片放到网页上，做成一个方便点击查看的小展示页。",
+        "主能力标签": "第二能力：表达构建",
+        "任务类型标签": "视听表达",
+        "关键词": [
+          "a102_图片资源展示",
+          "把图片放到网页上，做成一个方便点击查看的小展示页。",
+          "刚开始接触网页展示的学生",
+          "需要先从添加素材开始动手的学生",
+          "把本地图片放进网页里",
+          "理解图片展示卡片的基本结构",
+          "为后续继续扩充图片资源做准备",
+          "图片资源展示",
+          "第二能力：表达构建",
+          "视听表达"
+        ],
+        "files": [
+          "__demo__.html",
+          "__student-view__.html",
+          "__student__.json",
+          "__teacher-view__.html",
+          "__teacher__.json",
+          "index.html",
+          "tmpsz_k5dxa.png",
+          "努力学习的小朋友.png",
+          "可爱机甲.png",
+          "小组吉祥物第一版_1024x1024_20260421_173654.png",
+          "小组吉祥物第二版-中等_1024x1024_20260421_175052.png",
+          "小组图标第一版-中等-微调_1024x1024_20260421_184340.png",
+          "小组图标第一版-中等_1024x1024_20260421_180057.png",
+          "小组徽章第一版-简单_1024x1024_20260421_184717.png",
+          "小组标志第一版-中等_1024x1024_20260421_175402.png",
+          "搞笑小朋友.png",
+          "搞笑小朋友_即梦.png",
+          "班级小组徽章Logo优化版_1024x1024_20260421_185141.png"
+        ],
+        "updated_at": "2026-04-22T04:47:01Z"
+      },
+      "103": {
+        "系列": "A",
+        "编号": "103",
+        "名称": "做一个介绍页面",
+        "文件夹名": "a103_做一个介绍页面",
+        "路径": "templates/a103_做一个介绍页面",
+        "student_json": "templates/a103_做一个介绍页面/__student__.json",
+        "teacher_json": "templates/a103_做一个介绍页面/__teacher__.json",
+        "入口文件": "templates/a103_做一个介绍页面/__demo__.html",
+        "一句话说明": "用一张图片加一段文字，做一个属于自己的介绍页面，练一练图文组合的技巧。",
+        "主能力标签": "表达构建",
+        "任务类型标签": "视听表达",
+        "关键词": [
+          "a103_做一个介绍页面",
+          "用一张图片加一段文字，做一个属于自己的介绍页面，练一练图文组合的技巧。",
+          "初次接触网页制作",
+          "有一点基础想练排版",
+          "图片与文字的组合方式",
+          "网页结构的基本层次感",
+          "排版的视觉优先级",
+          "做一个介绍页面",
+          "表达构建",
+          "视听表达"
+        ],
+        "files": [
+          "__demo__.html",
+          "__student-view__.html",
+          "__student__.json",
+          "__teacher-view__.html",
+          "__teacher__.json"
+        ],
+        "updated_at": "2026-04-22T04:32:34Z"
+      },
+      "104": {
+        "系列": "A",
+        "编号": "104",
+        "名称": "做一个会出招的神奇按钮",
+        "文件夹名": "a104_做一个会出招的神奇按钮",
+        "路径": "templates/a104_做一个会出招的神奇按钮",
+        "student_json": "templates/a104_做一个会出招的神奇按钮/__student__.json",
+        "teacher_json": "templates/a104_做一个会出招的神奇按钮/__teacher__.json",
+        "入口文件": "templates/a104_做一个会出招的神奇按钮/index.html",
+        "一句话说明": "先试试按钮效果，再改一点，最后加一个你自己的新按钮。",
+        "主能力标签": "迭代推进",
+        "任务类型标签": "游戏机制",
+        "关键词": [
+          "a104_做一个会出招的神奇按钮",
+          "先试试按钮效果，再改一点，最后加一个你自己的新按钮。",
+          "想先动手再思考的学生",
+          "刚开始学网页互动的学生",
+          "容易卡在空白页不知从哪开始的学生",
+          "先运行现成示例，快速进入任务",
+          "从已有功能里挑一个做小改动",
+          "理解一个按钮对应一个功能",
+          "把新增功能接入现有页面结构",
+          "做一个会出招的神奇按钮",
+          "迭代推进",
+          "游戏机制"
+        ],
+        "files": [
+          "__demo__.html",
+          "__student-view__.html",
+          "__student__.json",
+          "__teacher-view__.html",
+          "__teacher__.json",
+          "bg_music.mp3",
+          "index.html",
+          "炫酷机甲_1024x1024_20260416_125127.png"
+        ],
+        "updated_at": "2026-04-22T04:32:35Z"
+      }
+    },
+    "B": {
+      "100": {
+        "系列": "B",
+        "编号": "100",
+        "名称": "做一个按钮页面",
+        "文件夹名": "b100_做一个按钮页面",
+        "路径": "templates/b100_做一个按钮页面",
+        "student_json": "templates/b100_做一个按钮页面/__student__.json",
+        "teacher_json": "templates/b100_做一个按钮页面/__teacher__.json",
+        "入口文件": "templates/b100_做一个按钮页面/__demo__.html",
+        "一句话说明": "亲手做一个会“变魔术”的按钮，学习网页是如何接收指令并产生变化的。",
+        "主能力标签": "表达构建",
+        "任务类型标签": "游戏机制",
+        "关键词": [
+          "b100_做一个按钮页面",
+          "亲手做一个会“变魔术”的按钮，学习网页是如何接收指令并产生变化的。",
+          "喜欢做项目",
+          "需要明确目标",
+          "掌握基础的 JavaScript 点击事件绑定",
+          "理解 HTML/CSS/JS 三者如何协作完成交互",
+          "学习利用 CSS Class 切换来实现视觉变化",
+          "做一个按钮页面",
+          "表达构建",
+          "游戏机制"
+        ],
+        "files": [
+          "__demo__.html",
+          "__student-view__.html",
+          "__student__.json",
+          "__teacher-view__.html",
+          "__teacher__.json"
+        ],
+        "updated_at": "2026-04-22T04:32:36Z"
+      }
+    },
+    "C": {
+      "100": {
+        "系列": "C",
+        "编号": "100",
+        "名称": "给小组作品做一次小修改",
+        "文件夹名": "c100_给小组作品做一次小修改",
+        "路径": "templates/c100_给小组作品做一次小修改",
+        "student_json": "templates/c100_给小组作品做一次小修改/__student__.json",
+        "teacher_json": "templates/c100_给小组作品做一次小修改/__teacher__.json",
+        "入口文件": "templates/c100_给小组作品做一次小修改/index.html",
+        "一句话说明": "先看这 3 个小组作品，找出一个你最想改的小地方，再把这个修改要求说给 AI。",
+        "主能力标签": "问题判断",
+        "任务类型标签": "改编优化",
+        "关键词": [
+          "c100_给小组作品做一次小修改",
+          "先看这 3 个小组作品，找出一个你最想改的小地方，再把这个修改要求说给 AI。",
+          "已经能看懂图片内容，但不太会说哪里有问题的学生",
+          "会说喜欢或不喜欢，但不太会提出具体修改点的学生",
+          "已经能做第一版作品，想练习小步修改的学生",
+          "先发现一个具体问题",
+          "把大问题收成一个最小修改点",
+          "用简单的话把修改要求说清楚",
+          "比较修改前后有没有更接近自己的想法",
+          "给小组作品做一次小修改",
+          "问题判断",
+          "改编优化"
+        ],
+        "files": [
+          "__demo__.html",
+          "__student-view__.html",
+          "__student__.json",
+          "__teacher-view__.html",
+          "__teacher__.json",
+          "demo.html",
+          "index.html",
+          "小组吉祥物_26.png",
+          "小组图形标志_83.png",
+          "班级小组徽章_47.png"
+        ],
+        "updated_at": "2026-04-22T04:32:36Z"
+      }
+    }
+  }
+}

package/skills/yiran-course-template-pipeline/template-index.md

@@ -0,0 +1,52 @@
+# 模板索引
+
+每次 templates 内模板有变化后，都应重新运行本脚本。
+
+## A100 给依然老师设计一个AI画像
+- 路径：templates/a100_给依然老师设计一个AI画像
+- 入口文件：templates/a100_给依然老师设计一个AI画像/index.html
+- 主能力标签：表达构建
+- 任务类型标签：视听表达
+- 关键词：a100_给依然老师设计一个AI画像, 先让 AI 生成一个老师形象，再用网页把它展示出来，重点练习描述和小修改。, 初次接触, 需要明确目标, 持续迭代, 围绕明确对象生成形象, 把人物图片放进网页中完成展示, 通过小幅修改让作品逐步变好, 给依然老师设计一个AI画像, 表达构建, 视听表达
+
+## A101 做3张同主题图片
+- 路径：templates/a101_做3张同主题图片
+- 入口文件：templates/a101_做3张同主题图片/__demo__.html
+- 主能力标签：表达构建
+- 任务类型标签：视听表达
+- 关键词：a101_做3张同主题图片, 先确定一个有趣的主题，再用 AI 生成 3 张风格统一、但情节不同的系列图片。, 初次接触, 需要明确目标, 练习通过提示词锁定画面风格, 理解作品一致性的价值, 初步接触提示词的模块化修改, 做3张同主题图片, 表达构建, 视听表达
+
+## A102 图片资源展示
+- 路径：templates/a102_图片资源展示
+- 入口文件：templates/a102_图片资源展示/index.html
+- 主能力标签：第二能力：表达构建
+- 任务类型标签：视听表达
+- 关键词：a102_图片资源展示, 把图片放到网页上，做成一个方便点击查看的小展示页。, 刚开始接触网页展示的学生, 需要先从添加素材开始动手的学生, 把本地图片放进网页里, 理解图片展示卡片的基本结构, 为后续继续扩充图片资源做准备, 图片资源展示, 第二能力：表达构建, 视听表达
+
+## A103 做一个介绍页面
+- 路径：templates/a103_做一个介绍页面
+- 入口文件：templates/a103_做一个介绍页面/__demo__.html
+- 主能力标签：表达构建
+- 任务类型标签：视听表达
+- 关键词：a103_做一个介绍页面, 用一张图片加一段文字，做一个属于自己的介绍页面，练一练图文组合的技巧。, 初次接触网页制作, 有一点基础想练排版, 图片与文字的组合方式, 网页结构的基本层次感, 排版的视觉优先级, 做一个介绍页面, 表达构建, 视听表达
+
+## A104 做一个会出招的神奇按钮
+- 路径：templates/a104_做一个会出招的神奇按钮
+- 入口文件：templates/a104_做一个会出招的神奇按钮/index.html
+- 主能力标签：迭代推进
+- 任务类型标签：游戏机制
+- 关键词：a104_做一个会出招的神奇按钮, 先试试按钮效果，再改一点，最后加一个你自己的新按钮。, 想先动手再思考的学生, 刚开始学网页互动的学生, 容易卡在空白页不知从哪开始的学生, 先运行现成示例，快速进入任务, 从已有功能里挑一个做小改动, 理解一个按钮对应一个功能, 把新增功能接入现有页面结构, 做一个会出招的神奇按钮, 迭代推进, 游戏机制
+
+## B100 做一个按钮页面
+- 路径：templates/b100_做一个按钮页面
+- 入口文件：templates/b100_做一个按钮页面/__demo__.html
+- 主能力标签：表达构建
+- 任务类型标签：游戏机制
+- 关键词：b100_做一个按钮页面, 亲手做一个会“变魔术”的按钮，学习网页是如何接收指令并产生变化的。, 喜欢做项目, 需要明确目标, 掌握基础的 JavaScript 点击事件绑定, 理解 HTML/CSS/JS 三者如何协作完成交互, 学习利用 CSS Class 切换来实现视觉变化, 做一个按钮页面, 表达构建, 游戏机制
+
+## C100 给小组作品做一次小修改
+- 路径：templates/c100_给小组作品做一次小修改
+- 入口文件：templates/c100_给小组作品做一次小修改/index.html
+- 主能力标签：问题判断
+- 任务类型标签：改编优化
+- 关键词：c100_给小组作品做一次小修改, 先看这 3 个小组作品，找出一个你最想改的小地方，再把这个修改要求说给 AI。, 已经能看懂图片内容，但不太会说哪里有问题的学生, 会说喜欢或不喜欢，但不太会提出具体修改点的学生, 已经能做第一版作品，想练习小步修改的学生, 先发现一个具体问题, 把大问题收成一个最小修改点, 用简单的话把修改要求说清楚, 比较修改前后有没有更接近自己的想法, 给小组作品做一次小修改, 问题判断, 改编优化

package/skills/yiran-course-template-pipeline//345/272/237/345/274/203/rewrite_html_refs.py

@@ -0,0 +1,102 @@
+#!/usr/bin/env python3
+"""
+[废弃] 扫描 HTML 引用并重写为 CDN 绝对地址
+
+原本为解决 /api/file 加载时相对路径失效的问题而设计。
+现状：模板预览已改为直接从 CDN 加载，相对路径天然可用，重写无必要。
+"""
+
+import re
+from pathlib import Path
+from typing import Dict, Optional, Set
+from urllib.parse import urlparse, unquote
+
+from qiniu import Auth, put_file_v2, CdnManager
+
+QINIU_KEY    = "T3tgxM7EMx1j4VESw4m4PIfFXoOvBo-wQEOQewXX"
+QINIU_SECRET = "PVZvlKVOjX2RqlV2ILMg-QwpNMssOlpVbaEzypz0"
+QINIU_BUCKET = "yiran1"
+CDN_DOMAIN   = "https://cdn.yiranlaoshi.com"
+CDN_PREFIX   = "myclaw/live/yiran/skills/yiran-playground-template-use/templates"
+
+q           = Auth(QINIU_KEY, QINIU_SECRET)
+cdn_manager = CdnManager(q)
+
+ATTR_RE = re.compile(r'(src|href)=["\']([^"\']+)["\']', re.IGNORECASE)
+URL_RE  = re.compile(r'url\(["\']?([^)"\']+)["\']?\)', re.IGNORECASE)
+SKIP_PREFIXES = ('data:', '#', 'mailto:', 'javascript:')
+
+
+def is_external(url):
+    return url.startswith('http://') or url.startswith('https://') or url.startswith('//')
+
+
+def find_local_file(ref, base_dir):
+    if any(ref.startswith(p) for p in SKIP_PREFIXES):
+        return None
+    if is_external(ref):
+        filename = Path(unquote(urlparse(ref).path)).name
+        candidate = base_dir / filename
+        return candidate if candidate.is_file() else None
+    else:
+        candidate = (base_dir / ref).resolve()
+        if candidate.is_file() and str(candidate).startswith(str(base_dir.resolve())):
+            return candidate
+        return None
+
+
+def collect_refs(html):
+    refs = set()
+    for m in ATTR_RE.finditer(html):
+        refs.add(m.group(2))
+    for m in URL_RE.finditer(html):
+        refs.add(m.group(1))
+    return refs
+
+
+def rewrite_html(html, ref_map):
+    def replace_attr(m):
+        attr, val = m.group(1), m.group(2)
+        return '{}="{}"'.format(attr, ref_map.get(val, val))
+    def replace_url(m):
+        val = m.group(1)
+        return 'url("{}")'.format(ref_map.get(val, val))
+    html = ATTR_RE.sub(replace_attr, html)
+    html = URL_RE.sub(replace_url, html)
+    return html
+
+
+def upload_file(local_path, folder_name):
+    key = "{}/{}/{}".format(CDN_PREFIX, folder_name, local_path.name)
+    token = q.upload_token(QINIU_BUCKET, key, 3600, policy={'insertOnly': 0})
+    ret, info = put_file_v2(token, key, str(local_path))
+    if info.status_code != 200:
+        raise RuntimeError("上传失败 {}: {}".format(local_path.name, info))
+    cdn_url = "{}/{}".format(CDN_DOMAIN, key)
+    cdn_manager.refresh_urls([cdn_url])
+    return cdn_url
+
+
+def rewrite_and_upload(folder_path):
+    folder_name = folder_path.name
+    html_files  = list(folder_path.glob('*.html'))
+    uploaded = {}
+    all_refs = {}
+
+    for html_file in html_files:
+        html = html_file.read_text(encoding='utf-8')
+        for ref in collect_refs(html):
+            if ref in all_refs:
+                continue
+            local = find_local_file(ref, folder_path)
+            if local:
+                if local not in uploaded:
+                    cdn_url = upload_file(local, folder_name)
+                    uploaded[local] = cdn_url
+                all_refs[ref] = uploaded[local]
+
+    for html_file in html_files:
+        html = html_file.read_text(encoding='utf-8')
+        new_html = rewrite_html(html, all_refs)
+        html_file.write_text(new_html, encoding='utf-8')
+        upload_file(html_file, folder_name)

package/skills/yiran-playground-template-use/SKILL.md

@@ -82,10 +82,8 @@ python3 scripts/deploy_to_workspace.py <template_path> <workspace_path> --with-t
 
 - `SKILL.md`：本说明
 - `search-agent-prompt.md`：AI 搜索指引
-- `template-index.json`：模板索引（自动生成，不手改）
-- `template-index.md`：模板索引可读版本（自动生成，不手改）
+- `template-index.json`：模板索引（由 pipeline 生成并同步，不手改）
 - `templates/`：模板库，每个子文件夹是一个独立模板
-- `scripts/build_template_index.py`：重建索引
 - `scripts/query_template.py`：查询主脚本
 - `scripts/prepare_playgrounds.py`：内部准备脚本
 - `scripts/deploy_to_workspace.py`：对外 workspace 投放脚本
@@ -94,12 +92,4 @@ python3 scripts/deploy_to_workspace.py <template_path> <workspace_path> --with-t
 
 ## 索引维护
 
-`yiran-course-template-pipeline` 打包新模板后会自动触发索引重建。
-
-`template-index.json` 与 `template-index.md` 都视为自动产物，不手动编辑。
-
-如需手动重建：
-
-```bash
-python3 scripts/build_template_index.py
-```
+`template-index.json` 由 `yiran-course-template-pipeline` 的 publish 流程统一生成和上传 CDN，本 skill 不负责维护。

package/skills/yiran-course-template-pipeline/cdn-convention.md

@@ -1,77 +0,0 @@
-# CDN 约定
-
-## 七牛云配置
-
-| 项 | 值 |
-|---|---|
-| Bucket | `yiran1` |
-| CDN 域名 | `https://cdn.yiranlaoshi.com` |
-
----
-
-## 模板文件 CDN 路径规则
-
-```
-https://cdn.yiranlaoshi.com/myclaw/live/yiran/skills/yiran-playground-template-use/templates/{文件夹名}/{文件名}
-```
-
-示例：
-```
-https://cdn.yiranlaoshi.com/myclaw/live/yiran/skills/yiran-playground-template-use/templates/a103_做一个介绍页面/__demo__.html
-https://cdn.yiranlaoshi.com/myclaw/live/yiran/skills/yiran-playground-template-use/templates/a103_做一个介绍页面/__student-view__.html
-https://cdn.yiranlaoshi.com/myclaw/live/yiran/skills/yiran-playground-template-use/templates/a103_做一个介绍页面/banner.png
-```
-
-七牛 key（去掉域名后的部分）：
-```
-myclaw/live/yiran/skills/yiran-playground-template-use/templates/{文件夹名}/{文件名}
-```
-
----
-
-## 两阶段分工
-
-### 阶段一：创作阶段（yiran-course-template-pipeline）
-
-**只关心内容质量，不关心具体 CDN 地址。**
-
-- 所有外部资源（图片、字体、JS 库）**必须使用 CDN 链接**，禁止本地相对路径
-- 使用哪个 CDN 不限，可以是 unpkg、jsDelivr、任意公开图床，也可以是 `cdn.yiranlaoshi.com`
-- 模板文件之间的引用（如 `<iframe src="__demo__.html">`）**视为相对路径，不允许**，需在创作时避免或由 publish 脚本修复
-
-### 阶段二：发布阶段（publish_template.py）
-
-**统一接管资源，重新打包到指定 CDN。**
-
-发布脚本会：
-1. 扫描模板文件夹内所有 HTML 文件的资源引用（`src`、`href`、`url()`）
-2. 对每个引用，判断本地是否存在对应文件（相对路径 → 直接找；其他 CDN 链接 → 尝试匹配本地同名文件）
-3. 将本地能找到的文件上传到七牛，路径规则见上方
-4. 将 HTML 中的原引用替换为新 CDN URL
-5. 最后上传修改后的 HTML 文件本身
-
-发布完成后，模板文件夹内的所有资源在 CDN 上完全自包含，不依赖任何外部路径。
-
----
-
-## 调用方式
-
-```bash
-# 在 move 之后执行
-python3 scripts/publish_template.py <templates 下的目标文件夹>
-```
-
-例：
-```bash
-python3 scripts/publish_template.py /path/to/.openclaw/skills/yiran-playground-template-use/templates/a103_做一个介绍页面
-```
-
----
-
-## 完整流程
-
-```
-1. build_template_views.py   创作文件夹  → 生成 __student-view__.html 等
-2. move_template_task.py     创作文件夹  → 移动改名到 templates/，重建索引
-3. publish_template.py       templates/xxx → 上传资源到七牛，重写 HTML 引用
-```

package/skills/yiran-playground-template-use/scripts/build_template_index.py

@@ -1,103 +0,0 @@
-#!/usr/bin/env python3
-import json
-import re
-from pathlib import Path
-
-ROOT = Path(__file__).resolve().parent.parent
-TEMPLATES_DIR = ROOT / 'templates'
-OUTPUT_JSON = ROOT / 'template-index.json'
-OUTPUT_MD = ROOT / 'template-index.md'
-
-
-def read_json(path: Path):
-    try:
-        return json.loads(path.read_text(encoding='utf-8'))
-    except Exception:
-        return {}
-
-
-def parse_folder_name(name: str):
-    m = re.match(r'^([a-zA-Z]+)(\d+)_(.+)$', name)
-    if m:
-        return m.group(1).upper(), str(int(m.group(2))), m.group(3)
-    return None, None, None
-
-
-def get_entry_file(folder: Path) -> Path | None:
-    for name in ['index.html', '__demo__.html', '__student-view__.html']:
-        if (folder / name).exists():
-            return folder / name
-    return None
-
-
-def main():
-    index = {}
-    items_for_md = []
-
-    for folder in sorted(TEMPLATES_DIR.iterdir() if TEMPLATES_DIR.exists() else []):
-        if not folder.is_dir():
-            continue
-
-        series, number, _ = parse_folder_name(folder.name)
-        if not series:
-            continue
-
-        teacher = read_json(folder / '__teacher__.json')
-        student = read_json(folder / '__student__.json')
-
-        name = teacher.get('任务名称') or student.get('任务标题', '')
-        一句话 = student.get('一句话说明', '')
-        能力标签 = teacher.get('主能力标签', '')
-        类型标签 = teacher.get('任务类型标签', '')
-
-        keywords = list(dict.fromkeys(filter(None, [
-            folder.name,
-            一句话,
-            *teacher.get('适合学生类型', []),
-            *teacher.get('训练重点', []),
-            name,
-            能力标签,
-            类型标签,
-        ])))
-
-        entry = get_entry_file(folder)
-        record = {
-            '系列': series,
-            '编号': number,
-            '名称': name,
-            '文件夹名': folder.name,
-            '路径': str(folder.relative_to(ROOT)),
-            'student_json': str((folder / '__student__.json').relative_to(ROOT)) if (folder / '__student__.json').exists() else '',
-            'teacher_json': str((folder / '__teacher__.json').relative_to(ROOT)) if (folder / '__teacher__.json').exists() else '',
-            '入口文件': str(entry.relative_to(ROOT)) if entry else '',
-            '一句话说明': 一句话,
-            '主能力标签': 能力标签,
-            '任务类型标签': 类型标签,
-            '关键词': keywords,
-        }
-
-        if series not in index:
-            index[series] = {}
-        index[series][number] = record
-        items_for_md.append(record)
-
-    OUTPUT_JSON.write_text(json.dumps(index, ensure_ascii=False, indent=2), encoding='utf-8')
-
-    lines = ['# 模板索引', '', '每次 templates 内模板有变化后，都应重新运行本脚本。', '']
-    for item in items_for_md:
-        lines.append(f"## {item['系列']}{item['编号']} {item['名称']}")
-        lines.append(f"- 路径：{item['路径']}")
-        lines.append(f"- 入口文件：{item['入口文件']}")
-        lines.append(f"- 主能力标签：{item['主能力标签']}")
-        lines.append(f"- 任务类型标签：{item['任务类型标签']}")
-        if item['关键词']:
-            lines.append(f"- 关键词：{', '.join(item['关键词'])}")
-        lines.append('')
-
-    OUTPUT_MD.write_text('\n'.join(lines), encoding='utf-8')
-    print(f'已生成: {OUTPUT_JSON}')
-    print(f'已生成: {OUTPUT_MD}')
-
-
-if __name__ == '__main__':
-    main()