zeyiji-course

course

开始前先读 ../zeyiji-shared/SKILL.md（Bootstrap、认证、配置、安全规则）。

CRITICAL — 每次执行任务前 MUST 先完成 zeyiji-shared 中的 Bootstrap 检查。

快速决策

用户意图	命令
查询课程列表	zeyiji-cli course list --name "..." --status 1
查看课程详情	zeyiji-cli course detail --course-id <ID>
创建新课程	zeyiji-cli course create --name "..." --category-id-resource <ID> --category-id <ID> ...
编辑已有课程	zeyiji-cli course edit --id <ID> --name "..."
删除课程（仅下架）	zeyiji-cli course delete --course-id <ID> --yes
添加目录（双层课程）	zeyiji-cli course chapter add --course-id <ID> --name "第一章"
编辑目录	zeyiji-cli course chapter edit --course-id <ID> --chapter-id <ID> --name "新名称"
删除目录	zeyiji-cli course chapter delete --course-id <ID> --chapter-id <ID>
添加节（单层课程）	zeyiji-cli course section add --course-id <ID> --name "第1节" --video ./v.mp4
添加节（双层课程指定目录）	zeyiji-cli course section add --course-id <ID> --chapter-index 0 --name "1.1" --video ./v.mp4
编辑节	zeyiji-cli course section edit --course-id <ID> --section-id <ID> --name "新名称"
删除节	zeyiji-cli course section delete --course-id <ID> --section-id <ID>
使用完整 JSON 创建/更新	zeyiji-cli course create --data '{"course":{...},"courseChapterDetails":[],"courseSections":[]}'
查询资源领域	zeyiji-cli api GET /back/category/page -p type=1 -p parentId=0 -p size=100 --jq ".records[] | {id, name, code}"
查询课程类型	zeyiji-cli api GET /back/category/tree -p type=1 -p parentId=<资源领域ID> --jq "def t: {id, name, sons: [(.sons // [])[] | t]}; .[] | t"
查询课程类别（国标）	zeyiji-cli api GET /back/category/tree -p type=2 --jq "def t: {id, name, sons: [(.sons // [])[] | t]}; .[] | t"
查询关联职业(职业技能)	zeyiji-cli api GET /back/profession/page -p categoryId=<课程类型ID> --jq ".records[] | {id, name}"
查询关联职业(职业资格)	zeyiji-cli api GET /back/profession/qualify/page -p categoryId=<课程类型ID> --jq ".records[] | {id, name}"
查询职业等级	zeyiji-cli api GET /back/profession/level/page -p professionId=<职业ID> --jq ".records[] | {id, name}"
查询返佣比例字典	zeyiji-cli api GET /back/sys/dict/page -p dictType=course_rebate_ratio --jq ".records[] | {dictName, dictValue}"
预览请求	加 --dry-run

Shortcuts

Shortcut	说明
course list	分页查询课程列表
course detail	查询课程详情
course create	创建课程（含章节目录）
course edit	编辑课程基本信息
course delete	删除课程（仅下架状态，不可逆）
course chapter	章节目录管理（添加/编辑/删除目录）
course section	节管理（添加/编辑/删除节）

领域安全规则（补充 shared 安全规则）

• 权限控制：course create、course edit、course delete、course chapter *、course section * 仅机构管理员（role=4）可执行，其他角色仅能查询（list/detail）。执行写入操作前先通过 zeyiji-cli auth status 确认角色
• 默认下架：AI 创建的课程 status 默认为 2，需用户自行到后台确认上架
• 关联数据必须查询：资源领域、课程类型等 ID 不能凭空填写，必须先查询接口
• 选项展示禁止 ID：AskUserQuestion 的 label 只能是中文名称，禁止展示任何数字 ID（如 712、ID: 712、712-职业技能），用户无需知道内部 ID
• 级联清空规则：资源领域 → 课程类型 → 关联职业 → 职业等级，上层变更时下层全部失效，AI 必须主动提示用户重选（详见 edit 参考文档）
• 价格单位转换：用户说的金额是「元」，传给 CLI 时必须 ×100 转为「分」
• 目录类型不可变更：编辑课程时，课程的目录类型(deep)不能修改（与前端行为一致）
• 编辑前先查询：编辑课程前应先通过 course list 或 course detail 确认课程存在
• 删除不可逆（exit 10 门禁）：course delete 删除整门课程，chapter delete 会同时删除目录下所有节，section delete 删除节，均不可恢复。这三个命令标注为 high-risk-write，不带 --yes 执行会以 exit 10 拦截，处理流程见 zeyiji-shared 的「高风险操作的审批协议」
• 删除课程前置条件：课程必须为下架状态(status=2)，上架中的课程需先执行 course edit --id <ID> --status 2 下架
• 双层目录定位：操作双层目录(deep=2)课程的节时，需通过 --chapter-id 或 --chapter-index 指定所属目录
• 章节目录单独操作：章节目录通过 course chapter / course section 子命令逐个操作，底层仍是全量提交 merge/detail

AI 编排流程（三阶段模式）

核心思想：course create / course edit 只管课程基本信息，章节目录通过独立命令逐个操作。AI 根据用户提示词自动编排多个命令。

用户提示词意图	AI 执行流程
创建课程（含目录描述）	① course create 创建基本信息 → ② 自动逐个调用 chapter add / section add 搭建目录
编辑课程（含目录修改）	① course edit 修改基本信息 → ② 自动调用 chapter/section add/edit/delete 调整目录
纯目录操作	直接调用 course chapter / course section 对应命令

关键原则：

• 所有写入操作底层都是全量提交 POST /back/ins/course/merge/detail
• chapter add/edit/delete 和 section add/add-live/edit/edit-live/delete 每次只操作一个目录/节，内部自动查询最新数据并全量提交
• AI 应根据用户提示词中的目录描述自动编排多个命令，无需用户逐步指示
• 添加章节时必须询问选填项：收集完必填字段后，主动列出讲师、免费试看、课件、关联练习等选填项及默认值，让用户确认或调整后再执行（详见 section 参考文档的「AI 交互指引」）
• 编排完成后统一执行 course detail 展示最终结果