# 课程对外表达

本文件把课程 JSON 中的内部字段映射为前端业务文案。内部字段只允许出现在命令、`--jq`、排障和 Agent 内部判断中；最终答复必须使用业务名称与枚举文案。

## 字段与枚举映射

| 内部字段（禁止对外出现） | 对外名称 | 对外表达 |
|---|---|---|
| `id` / `courseId` | 课程 ID | 仅在需要定位或确认操作对象时展示 |
| `name` | 课程名称 | 原样保留 |
| `status` | 课程状态 | 1 上架 / 2 下架 |
| `showFlag` / `showFlags` | 展示平台 | 1 全平台 / 2 仅机构平台 / 3 仅平台 |
| `deep` | 目录类型 | 1 单层目录（只有节） / 2 双层目录（章+节） |
| `categoryName` | 课程类型 | 使用返回名称 |
| `categoryNameStandard` | 课程类别 | 使用返回名称 |
| `teacher` | 讲师 | 原样保留，多位用「、」分隔 |
| `currentPrice` / `originalPrice` | 现价 / 原价 | 分转换为元 |
| `rebateFlag` | 是否参与返佣 | 1 是 / 2 否 |
| `rebateWay` | 返佣方式 | 1 固定金额 / 2 固定比例 |
| `rebateCount` | 返佣金额或比例 | 固定金额按分转元，固定比例按百分比 |
| `chapterCount` / `sectionCount` | 章数 / 节数 | 直接展示 |
| `sort` | 排序 | 直接展示 |
| `createTime` | 创建时间 | 格式化为用户本地时间 |
| `freeFlag` | 是否免费试看 | 1 否 / 2 是 |
| `videoUrl` | 视频 | 用户没有要地址时只说是否已配置 |
| `coursewareUrl` | 课件 | 用户没有要链接时只列课件名称或数量 |
| `introduceUrl` | 图文介绍 | 用户没有要求时不要展示存储地址 |
| `videoType` | 是否上架直播回放 | 1 是 / 2 否 |
| `livePlatformType` | 直播流平台 | 1 腾讯云 / 2 平台 |

## 汇总口径

- 状态、目录类型、展示平台、返佣和免费试看必须翻译成中文，不得保留数字。
- 课程/章节/节优先用名称和序号表达；ID 只在用户需要精确确认操作对象时附加。
- 章节序号对用户从 1 开始；传给 CLI 的 `--index` 从 0 开始，内部换算，不向用户解释索引机制。
- 价格统一说「元」，不要展示“分”或内部存储值。
- 空课件、未配置图文介绍、未关联职业等默认值通常直接省略，除非用户明确询问。

## 推荐答复

用户问课程概况：

> 《Go 语言入门》已上架，在全部平台展示，采用双层目录，共 3 章、12 节，现价 99 元。

用户问某节是否可试看：

> 第 2 节「基础语法」可以免费试看。

用户问目录结构：

> 该课程采用双层目录：第 1 章「入门」下有 4 节，第 2 章「进阶」下有 5 节。

## 禁止答复

- 「课程 status=1、deep=2、showFlag=1、freeFlag=2。」
- 「courseSections 共 5 个，courseId=123。」
- 任何 JSON、字段名、数字枚举、空值判断或内部 ID 列表。