# 学生侧字段说明

这份文档用于定义学生页面要使用的数据字段。

目标是：
- 把学生页真正需要的内容从 HTML 里抽离出来
- 让模板和数据分开
- 为后续 `__student__.json -> html` 脚本做准备

当前默认模板文件位置：
`skills/course-template-pipeline/assets/student-template.html`

---

# 一、当前 __student__.json 结构

```json
{
  "任务标题": "",
  "一句话说明": "",
  "步骤": [
    {
      "标题": "",
      "说明": ""
    }
  ],
  "评价目标": [
    {
      "等级": "",
      "说明": ""
    }
  ],
  "示例区标题": "",
  "示例页面文件": ""
}
```

---

# 二、字段逐个说明

## 1）任务标题

```json
"任务标题": ""
```

### 作用
显示在学生页最上方，是学生最先看到的任务名称。

### 设定原则
- 要短
- 要清楚
- 一眼能知道要做什么

例子：
- 给依然老师设计一个AI画像
- 我自己的三国杀卡牌游戏

---

## 2）一句话说明

```json
"一句话说明": ""
```

### 作用
用一句话告诉学生：
- 先做什么
- 再做什么
- 重点练什么

### 设定原则
- 只写一句
- 不要太长
- 用学生能看懂的话

例子：
- 先让 AI 生成一个老师形象，再用网页把它展示出来，重点练习描述和小修改。

---

## 3）步骤

```json
"步骤": [
  {
    "标题": "",
    "说明": ""
  }
]
```

### 作用
给学生一个清楚的完成路径。

### 设定原则
- 一般 3 到 4 步
- 每一步分成两层：
  - 标题：短
  - 说明：学生真正要读的句子

### 标题怎么写
推荐短词：
- 先做图片
- 放进网页
- 小改一下
- 展示变化

### 说明怎么写
- 用短句
- 直接说要做什么
- 不要讲太多理由

---

## 4）评价目标

```json
"评价目标": [
  {
    "等级": "",
    "说明": ""
  }
]
```

### 作用
告诉学生做到什么程度算完成、做到更好是什么样。

### 设定原则
- 默认固定三档：
  - 一星
  - 二星
  - 三星
- 每一档都要有一句清楚说明

### 说明怎么写
- 一星：基础完成
- 二星：完成页面
- 三星：有改进、有变化展示

---

## 5）示例区标题

```json
"示例区标题": ""
```

### 作用
控制中间示例区标题文字。

### 默认建议
一般可直接写：
```json
"示例区标题": "示范样例"
```

---

## 6）示例页面文件

```json
"示例页面文件": ""
```

### 作用
告诉学生页中间 iframe 应该加载哪个页面文件。

### 设定原则
- 使用同级文件名
- 不直接写复杂路径

例如：
```json
"示例页面文件": "example.html"
```

---

# 三、设计原则

## 1）学生页字段只服务学生阅读
不要把老师看的结构化字段放进 __student__.json。

## 2）模板负责布局，__student__.json 负责内容
布局固定在模板里，__student__.json 只管填什么。

## 3）句子要短
学生页比教师页更需要控制字数。

## 4）数据和页面分开
以后改模板时，不应该被 __student__.json 限制；以后换任务时，也不应该去手改 HTML 文案。
