# course list

一句话：分页查询课程列表（当前账号可见范围），支持名称/类型/类别/状态/展示平台/创建时间筛选；常用于取课程 ID 或确认状态。

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

## 命令

```bash
# 默认第 1 页、每页 10 条（默认 JSON 输出）
zeyiji-cli course list

# 按名称模糊 + 状态（1上架 2下架）
zeyiji-cli course list --name "Go" --status 1

# 按课程类型 / 展示平台（1全平台 2仅机构平台 3仅平台）
zeyiji-cli course list --category-id 5 --show-flags 3

# 按创建时间范围（Unix 毫秒时间戳）
zeyiji-cli course list --create-time-start 1700000000000 --create-time-end 1710000000000

# 组合筛选 + 分页
zeyiji-cli course list --name "Go" --status 1 --current 2 --size 20

# 表格输出（人读）
zeyiji-cli course list -o table

# 精简 JSON：直接给后续命令取 ID
zeyiji-cli course list --jq ".records[] | {id, name, status, currentPrice}"
zeyiji-cli course list --name "Go" --jq ".records[0].id"
```

## 参数要点

| 参数 | 说明 |
|---|---|
| `--current` / `--size` | 页码（默认 1，≥1）/ 每页条数（默认 10，≥1） |
| `--name` | 课程名称，模糊搜索 |
| `--status` | 1 上架 / 2 下架 |
| `--show-flags` | 1 全平台 / 2 仅机构平台 / 3 仅平台 |
| `--category-id` | 课程类型 ID |
| `--category-id-standard` | 课程类别（国标）ID |
| `--create-time-start` / `--create-time-end` | 创建时间范围，Unix 毫秒时间戳 |

## 输出要点

- **Agent 内部 JSON**：列表在 `records[]`，总条数在 `total`；`id` 仅用于后续命令定位课程。`status`、`deep`、`showFlags` 等内部字段只用于判断，不得原样转述。
- **取 ID**：`records[].id` 可直接用于 `course detail --course-id`、`course edit --id`、`course chapter/section --course-id`；对用户只在需要确认操作对象时附「课程 ID」。
- **对外答复**：先回答课程数量或筛选结果，再按用户关注点列出课程名称、课程类型、上下架状态、展示平台、目录类型、讲师和现价。价格统一换算为「元」，ID 默认省略。
- `-o table` 已提供中文业务标签，可直接摘取相关行；仍不要复述全部列、空值或内部序号。

## 常见错误

| 现象 | 处理 |
|---|---|
| 页码 current 必须 >= 1 / 每页条数 size 必须 >= 1 | 修正分页参数 |
| 课程状态值不合法 | 只能是 1 或 2 |
| 展示平台值不合法 | 只能是 1/2/3 |