# course detail

一句话：查询单个课程的完整信息与章节目录；用于取章/节 ID 与序号，以及取 `introduceUrl` 原文后再修改图文介绍。

向用户汇报前 MUST 遵循 [课程对外表达](zeyiji-course-presentation.md)。

## 命令

```bash
# 表格模式：基本信息 + 章节目录
zeyiji-cli course detail --course-id 123 -o table

# 完整 JSON（默认输出格式）
zeyiji-cli course detail --course-id 123

# 取课程基本信息
zeyiji-cli course detail --course-id 123 --jq ".course | {id, name, status, deep, currentPrice}"

# 单层目录：取节 ID/名称/序号
zeyiji-cli course detail --course-id 123 --jq ".courseSections[] | {id, name, sort, freeFlag}"

# 双层目录：取章 ID、章名与节列表
zeyiji-cli course detail --course-id 123 \
  --jq ".courseChapterDetails[] | {chapterId: .courseChapter.id, chapter: .courseChapter.name, sections: [.courseSections[] | {id, name}]}"

# 改图文介绍前取富文本原文（供 --introduce-replace 的 old 值）
zeyiji-cli course detail --course-id 123 --jq ".course.introduceUrl"
```

## 参数要点

| 参数 | 说明 |
|---|---|
| `--course-id` | 必填，课程 ID（可先用 `course list --name "..."` 取 ID） |

## 输出要点

- `-o table` 显示课程基本信息（含目录类型、章数、节数）与目录；双层目录按「第 N 章: 名称 (ID:x)」+ 每节「序号. 名称 (ID:x)」展示。
- 表格里的序号从 1 开始；传给 `--index` 时要用 0 起的列表位置（序号 - 1），`chapter edit/delete --index` 同理（第 N 章 → N-1）。
- 单层目录的节在顶层 `courseSections[]`；双层目录的章在 `courseChapterDetails[]`，节嵌套在每章的 `courseSections[]`，两者不要混用。
- 目录类型决定可用命令：单层目录只能用 `section`，双层目录用 `chapter` + `section`。Agent 内部可读取 `deep` 判断，但对外只说「单层目录 / 双层目录」。
- 默认输出为原始 JSON，仅供 Agent 解析；可配合 `--jq` 精简。改富文本前必须先取图文介绍原文确认。
- **对外答复**：按课程对外表达翻译课程状态、展示平台、目录类型、返佣与免费试看；课程/章/节优先用名称与序号，不展示 JSON 字段名、枚举数字或内部 ID 列表。

## 常见错误

| 现象 | 处理 |
|---|---|
| 课程ID不能为空 | 补 `--course-id` |
| 课程不存在（ID: x） | 用 `course list` 查正确 ID |