@sokeai/cli 1.0.77 → 1.0.78

package/skills/multi/soke-course/SKILL.md

@@ -0,0 +1,399 @@
+---
+name: soke-course
+description: >
+  线上课创建与发布的端到端编排技能，课程发布主管。
+  负责识别用户意图、选择执行流程、校验前置条件、调度 3 个并列技能完成全链路操作。
+  当用户想创建课程、上传课件、配置设置、发布课程、指派学员时触发。
+---
+
+# 课程发布主管
+
+> **CRITICAL — 开始前 MUST 先用 Read 工具读取 [`./references/installation.md`](./references/installation.md)，其中包含认证、配置、权限处理。**
+
+## 交互规范（必须遵守）
+
+**任何需要用户从固定选项中做选择的场景，必须调用 `ask_user_question` 工具弹窗，禁止纯文本罗列让用户打字。**
+
+适用场景：
+- 选择课程分类（列出所有分类，最后一项为"🆕 新建分类"）
+- 歧义消解（不确定用户想做什么时）
+- 确认是否继续（"还要加课件吗？"/"调顺序吗？"/"确认发布？"）
+- 选择发布对象（部门/用户列表）
+- 中断恢复（从已有课程列表中选择继续哪个）
+- 任何其他有 2-4 个固定选项的决策点
+
+弹窗标准格式：
+```
+ask_user_question
+  question: "选择课程分类"
+  header: "分类"
+  options:
+    - label: "📁 技术研发"  description: "一级分类"
+    - label: "📁 企业管理"  description: "一级分类"
+    - label: "🆕 新建分类"  description: "前往管理后台新建分类"
+```
+
+## 使用前提
+
+1. 已安装 `soke-cli`
+2. 已登录授权 — 首次执行时自动检查并引导登录
+
+**登录状态检查与自动登录（必须执行）：**
+
+```bash
+# 第一步：检查登录状态
+soke-cli config show
+```
+
+若返回包含 `user_token` → ✅ 已登录，继续。
+
+若返回无 `user_token` 或报错 → ⚠️ 未登录，立即执行：
+
+```bash
+# 第二步：自动打开浏览器完成 OAuth 授权
+# soke-cli auth login 会自动调用系统默认浏览器打开授权页面
+soke-cli auth login
+```
+
+`soke-cli auth login` 执行后会自动打开浏览器到授客AI开放平台授权页，用户在浏览器中完成登录授权即可。授权成功后 CLI 终端会显示 `✅ 已登录`，Token 自动保存至 `~/.soke-cli/config.json`。
+
+> 如果浏览器没有自动打开，终端会输出授权链接，手动复制到浏览器打开即可完成授权。
+
+**任何课程操作之前，必须先通过上述两步确认登录状态。未登录时禁止跳过，必须完成登录后再继续。**
+
+## 一、触发描述
+
+### 触发词
+
+| 意图 | 触发词 |
+|------|--------|
+| 创建课程 | 创建/新建/做课/开课/生成课程 |
+| 课件管理 | 添加课件/加视频/加音频/加文档/课件排序/调顺序 |
+| 课程设置 | 设置学分/积分/讲师/封面/标签/修改分类/简介 |
+| 高级设置 | 倍速/人脸/提醒/学习模式/解锁/评价/证书/签名/钉钉群 |
+| 收费设置 | 收费/价格/试看/免费/付费 |
+| 发布 | 发布/上线/定时发布/审批 |
+| 指派 | 指派/安排学习/分配学员/必修/选修 |
+| 查询 | 学习进度/完成率/谁学了/谁完成 |
+| 维护 | 关闭/删除/下架/复制/克隆 |
+| 分类管理 | 分类/课程分类/添加分类/新建分类 |
+
+### 上下文触发
+- 对话已有 course-id → 在当前课程上操作，不创建新课程
+- 用户上传文件 + 提"课件"/"课程" → 课件子流程
+
+### 不触发（交给独立 skill）
+- 纯考试/题库/试卷
+- 学习地图
+- 纯素材浏览（不提课程）
+- 单查学员档案（无课程上下文）
+
+## 二、输入要求
+
+### 创建课程
+  必填: 课程标题 + 课程分类
+  可选: 描述/学分/讲师/标签/封面
+
+### 添加课件
+  必填: 课件内容（文件路径或文本）
+  从上下文获取: course-id
+
+### 发布
+  从上下文获取: course-id
+  前置: Gate Check 全部通过
+
+### 指派
+  必填: 部门名或用户名 + course-id
+
+## 三、执行流程
+
+### 3.1 意图路由
+
+```
+用户消息 → 关键词 → 意图 → 路由
+
+create       → 3.2 全流程创建
+add_lesson   → 3.3 课件子流程
+settings     → 3.4 设置子流程（→ read references/subs/settings/SOP.md）
+publish      → 3.5 发布子流程（→ read references/subs/publish/SOP.md）
+assign       → 3.6 指派子流程
+query        → 3.7 查询子流程（→ read references/subs/query/SOP.md）
+maintain     → 3.8 维护子流程
+category     → read references/subs/category/SOP.md
+```
+
+歧义消解: 上下文有 course-id → 当前课程操作 | 有文件附件 → 倾向课件 | 不确定 → `ask_user_question` 弹窗列出可能的操作让用户点选（如"创建课程"/"添加课件"/"修改设置"）
+
+### 3.2 全流程创建（主链路）
+
+> 完整 SOP 见 references/sop-full-workflow.md
+
+#### Phase 1: 创建课程骨架
+
+Step 1.1 权限检查（自动登录）
+  exec: soke-cli config show
+  → 有 user_token → ✅ 跳过登录
+  → 无 user_token → exec: soke-cli auth login（自动打开浏览器）
+    等待用户在浏览器中完成授权
+    再次 exec: soke-cli config show 确认 user_token 已写入
+  登录完成 → 继续下一步
+
+Step 1.2 获取分类
+  → read references/subs/category/SOP.md 执行
+  执行: soke course +list-categories 获取分类树
+  策略:
+    1. 用户已指定分类名 → 精确/模糊匹配到唯一结果 → 直接使用
+    2. 匹配到多个结果 → `ask_user_question` 弹窗让用户选一个，最后加一项"🆕 新建分类"
+    3. 用户未指定 → `ask_user_question` 弹窗列出所有一级分类，最后加一项"🆕 新建分类"
+    4. 用户说"随便" → 取第一个一级分类
+  → 用户选"🆕 新建分类" → 告知："CLI 暂不支持新建分类，请前往管理后台 → 课程管理 → 分类设置 → 新增分类" → 新建完成后说"分类建好了"再继续
+  提取: category-id → 存上下文
+
+Step 1.3 创建课程
+  自身: course +create --title "xxx" --category-id "xxx"
+  提取: course-id → 存上下文
+
+Step 1.4 选择模板（创建课程后立即触发）
+  → read references/subs/template/SOP.md 执行
+  弹窗: `ask_user_question` 列出 7 个模板（含"7. 不选择模板"）
+  用户选 1-6 → 输出该模板的配置清单（标注后台路径） → 确认后继续
+  用户选 7 → 不输出配置，直接进入路由弹窗
+  详见: references/subs/template/SOP.md
+
+Gate 1→2: ✅ 有 course-id
+
+Phase 1 完成后 → `ask_user_question` 弹窗: "下一步？" → ["添加课件"/"先做设置"/"直接发布"]
+  选"添加课件" → 进入 Phase 2
+  选"先做设置" → 跳到 Phase 3
+  选"直接发布" → 跳到 Phase 4（需通过 Gate Check）
+
+#### Phase 2: 构建课件
+
+Step 2.1 选择素材来源
+  → `ask_user_question` 弹窗: "从哪儿添加课件素材？" → ["📁 本地上传"/"📚 素材库选择"]
+  选"本地上传" → 进入 Step 2.2
+  选"素材库选择" → 进入 Step 2.2b
+
+Step 2.2 本地上传
+  可上传: 视频(.mp4/.avi/.mov/.mkv/.webm)、音频(.mp3/.wav/.ogg/.flac/.aac)、文档(.pdf/.ppt/.pptx/.doc/.docx/.xls/.xlsx)
+  ⚠️ 不支持 CLI: 图片/文章/外链/小测验/作业 → 告知后台路径
+  → 用户提供本地文件路径
+  → 调度 soke-material: file +upload（自动根据扩展名判断类型）
+  提取: media-id + 全字段信息 → 存 media_ids[]
+  → 进入 Step 2.3
+
+Step 2.2b 素材库选择
+  → 调度 soke-material
+  exec: soke file list-files（分页拉取全量素材列表）
+  展示: 文件名 / 类型 / 大小 / 日期（分页或截取前 20 条）
+  告知用户: "输入关键词搜索素材（文件名模糊匹配），或输入序号选择"
+  用户输入关键词 → 在素材列表中模糊匹配 → 弹窗列匹配项
+  用户选序号 → 确认该素材 → 提取全字段信息 → 存 media_ids[]
+  无目标素材 → 弹窗: "素材库中没找到，要不要切换到本地上传？" → ["切本地上传"/"重新搜索"]
+  选"切本地上传" → 回到 Step 2.2
+  → 进入 Step 2.3
+
+Step 2.3 创建课件
+  → 调度 soke-lesson
+  参数全部来自 Step 2.2 或 Step 2.2b 的返回
+  提取: lesson-id
+  存: lesson_ids[]
+
+Step 2.4 循环
+  → `ask_user_question` 弹窗: "还要加课件吗？" → ["继续加课件"/"不了，进入下一步"]
+
+Step 2.5 排序（可选）
+  → `ask_user_question` 弹窗: "需要调整课件顺序吗？" → ["调整顺序"/"保持现状"]
+  选"调整" → 调度 soke-lesson 排序
+
+Gate 2→3: ✅ 课件 ≥ 1
+
+#### Phase 3: 课程设置
+
+  → read references/subs/settings/SOP.md 执行
+    基础: title/credit/description/image（course +update）
+
+  → read references/subs/template/SOP.md Step 3 执行
+    将当前所有设置项以表格形式展示（仅「设置项」+「当前值」两列）
+    告知用户: "想修改哪项？直接告诉我就行。"
+  用户指令处理:
+    - 标题/学分/描述/封面 → exec: course +update（✅ CLI 支持） → 刷新表格
+    - 学习模式/倍速/人脸/提醒/评价/拖动/评论/文档防挂机/交流群二维码 → exec: course +advanced（✅ CLI 支持；交流群二维码本地图片用 --image-file，命令内部只上传 OSS，不进入图片库） → 刷新表格
+    - 其他设置 → "已记录: {项} → {新值}（需在后台操作: {路径}）" → 刷新表格
+    - "可以了"/"继续" → 退出 Phase 3
+  循环直到用户确认
+
+Gate 3→4: 无硬阻塞
+
+#### Phase 4: 发布
+
+  → read references/subs/publish/SOP.md 执行
+    Gate Check: 标题/分类/课件数量/转码状态
+    直接发布 → course +publish --course-id <uuid>
+    定时发布 → course +publish --course-id <uuid> --publish-time "<北京时间>"
+    审批/批量 → ⚠️ CLI 不支持
+
+Gate 4→5: ✅ status=1
+
+#### Phase 5: 指派学员
+
+  → 调度 soke-assign
+
+  Step 5.1 拉取部门列表
+    exec: soke assign +list-departments
+    提取: 全量部门名称+ID → 存内存
+
+  Step 5.2 用户输入关键词搜索
+    告知用户: "请输入要指派的部门名称（支持模糊搜索）"
+    用户输入关键词 → 在部门列表中模糊匹配（不区分大小写，支持部分匹配）
+    匹配结果:
+      - 唯一匹配 → 直接确认使用
+      - 多个匹配 → `ask_user_question` 弹窗列出匹配的部门让用户选
+      - 无匹配 → 建议换个关键词，或 `ask_user_question` 弹窗列所有部门
+
+  Step 5.3 确认指派方式
+    → `ask_user_question` 弹窗: "必修还是选修？" → ["必修"/"选修"]
+
+  Step 5.4 执行指派
+    exec: soke assign +create --module course --module-id <courseId> --compulsory 1|0 --user-ids "<用部门 ID 查到的人员>"
+
+#### Phase 6: 运营维护
+
+  → read references/subs/query/SOP.md 执行（进度/记录/人脸）
+  → read references/subs/publish/SOP.md 执行（关闭/删除；删除仅允许 status=0/2）
+  → read references/subs/copy/SOP.md 执行（复制，⚠️）
+
+### 3.3 课件子流程
+
+前提: 上下文有 course-id
+流程: = Phase 2（判断类型→上传→创建→循环→排序）
+
+### 3.4 设置子流程
+
+前提: 上下文有 course-id
+流程: read references/subs/settings/SOP.md + references/subs/charge/SOP.md 执行
+
+### 3.5 发布子流程
+
+前提: course-id + status=0
+流程: read references/subs/publish/SOP.md 执行 → Gate Check → 发布 → 询问指派
+
+### 3.6 指派子流程
+
+前提: course-id + status=1
+流程: 调度 soke-assign → 拉全量部门 → 用户输入关键词搜索 → 确认 → 指派
+
+### 3.7 查询子流程
+
+前提: course-id
+流程: read references/subs/query/SOP.md 执行 → 进度/记录/人脸
+
+### 3.8 维护子流程
+
+流程: read references/subs/publish/SOP.md（关闭/删除，删除前必须校验 status=0 未发布或 status=2 已关闭）/ references/subs/copy/SOP.md（复制）/ references/subs/category/SOP.md（分类）
+
+### SOP 执行 5 步法
+
+1. READ `references/subs/<name>/SOP.md` → 理解输入输出
+2. BUILD 从上下文提取参数
+3. EXEC 按 SOP 流程调用 CLI
+4. PARSE 按 SOP 输出标准解析
+5. STORE 关键值写入上下文
+
+上下文变量: course_id / category_id / lesson_ids[] / media_ids[] / course_status / current_phase
+
+## 四、输出标准
+
+### 每步即时输出
+```
+✅ <做了什么>
+📋 <关键数据>
+⏭️ <下一步建议>
+```
+
+### 阶段状态报告
+```
+📋 课程: <标题> (id: <uuid>)
+   Phase 1 ✅ 已创建
+   Phase 2 🔄 课件 3 个
+     ├─ ✅ 第1课: 环境搭建 (video, 转码完成)
+     ├─ ✅ 第2课: Pandas (video, 转码中)
+     └─ ✅ 第3课: 数据清洗.pdf (document)
+   Phase 3 ⏸️  设置
+   Phase 4 ⏸️  发布（阻塞: 第2课转码中）
+   Phase 5 ⏸️  指派
+   下一步: 等转码完成后发布
+```
+
+### Gate Check 矩阵
+
+| # | 检查项 | 获取方式 | 严重度 | 不通过时 |
+|---|--------|---------|--------|---------|
+| 1 | 标题非空 | +get-course.title | 🔴阻塞 | 请设置标题 |
+| 2 | 分类已选 | +get-course.category_id | 🔴阻塞 | 请选择分类 |
+| 3 | 课件≥1 | +lesson-list count | 🔴阻塞 | 至少1个课件 |
+| 4 | 无转码失败 | +lesson-list.transcode_status | 🔴阻塞 | 课件[X]转码失败 |
+| 5 | 无转码中 | +lesson-list.transcode_status | 🟡警告 | 课件[X]转码中，确认发布？ |
+| 6 | 付费方式 | 需确认 | 🟡警告 | — |
+
+### 最终交付
+```
+📦 课程已发布: <标题>
+🔗 ID: <uuid> | 📊 课件: 5 个 | 👥 已指派: 研发部(32人)
+⏭️ 查看进度: 说"看看学习进度"
+```
+
+## 五、注意事项
+
+### 硬规则
+1. 不编造参数 — UUID 来自真实返回
+2. 不跳过 Gate — 发布前逐项校验
+3. 不静默失败 — 失败: 查排错文档 → 中文告知 → 修复建议 → 保存进度 → 提供选项
+4. 类型必须匹配 — 课件与素材类型一致
+5. 一个 course-id 贯穿全部
+
+### 架构分工
+
+**外部并列技能**（独立 skill，通过 skill 调度）:
+- 上传文件到素材库 → soke-material
+- 基于素材创建课件 → soke-lesson
+- 将课程指派给学员 → soke-assign
+
+**内嵌 SOP**（references/subs/ 下，按需 read 执行）:
+- 管理课程分类 → references/subs/category/SOP.md
+- 配置课程设置 → references/subs/settings/SOP.md
+- 设置收费 → references/subs/charge/SOP.md
+- 发布校验和发布 → references/subs/publish/SOP.md
+- 复制课程 → references/subs/copy/SOP.md
+- 查询学习数据 → references/subs/query/SOP.md
+- AI生成课程 → references/subs/ai/SOP.md
+- 课程模板（7套预置配置） → references/subs/template/SOP.md
+
+### 已知 CLI 缺失
+
+统一话术: "XXX 功能暂不支持 CLI 操作，请在后台手动设置。"
+
+| 类别 | 缺失 |
+|------|------|
+| 课件类型 | image/article/link/quiz/homework |
+| 分类 | 新增分类 |
+| 课程设置 | point/lector_id/tags/简介插图 |
+| 高级设置 | 证书/签名 |
+| 收费 | 价格/试看 |
+| 发布 | 审批/批量 |
+| 维护 | 复制 |
+
+### 中断恢复
+用户"继续"/"接着做": 检查 course-id → 有:查状态+课件→报告→继续 | 无:列课程→选→恢复
+
+## 六、交付前自查
+
+- [ ] 每步有明确调度目标
+- [ ] 关键返回值已存入上下文
+- [ ] 每步完成有下一步建议
+- [ ] 发布前过完整 Gate Check
+- [ ] CLI 不支持功能已告知替代路径
+- [ ] 失败有修复建议
+- [ ] 所有固定选项的决策点均使用 `ask_user_question` 弹窗（禁止纯文本罗列让用户打字）
+- [ ] 分类选择弹窗最后一项始终为"🆕 新建分类"
+- [ ] 状态报告完整

package/skills/multi/soke-course/agents/openai.yaml

@@ -0,0 +1,7 @@
+display_name: 课程发布主管
+short_description: 端到端管理线上课创建与发布全流程，自动完成分类选择、课件上传、课程设置、发布校验及学员指派调度。
+default_prompt: 帮我创建一门线上课
+dependencies:
+  - soke-material
+  - soke-lesson
+  - soke-assign

package/skills/multi/soke-course/examples/create-basic.md

@@ -0,0 +1,70 @@
+# 最简创建样例
+
+**场景**: 用户只给标题和分类，创建+发布
+
+**对话流程:**
+
+```
+用户: 创建一门课，叫 Python入门，分类选技术培训
+
+主管:
+  ✅ 获取分类 "技术培训" → uuid: cat_001
+  
+  ✅ 创建课程
+  📋 课程: Python入门 (id: course_001), 状态: 未发布
+  
+  ⏭️ 需要添加课件吗？
+
+用户: 先不加了，帮我发布
+
+主管:
+  ⚠️ Gate Check 未通过:
+  🔴 课件数量: 0 — 课程至少需要 1 个课件才能发布
+  
+  ⏭️ 需要添加课件吗？还是稍后再处理？
+
+用户: 那加个视频吧 + demo.mp4
+
+主管:
+  ✅ 上传 demo.mp4 → media-id: media_001
+  ✅ 创建课件 "demo" (video) → lesson-id: lesson_001
+  📋 lesson_001: 转码中...
+  
+  💡 课件已添加。需要调整顺序吗？
+
+用户: 不用，发布吧
+
+主管:
+  🔍 Gate Check:
+    ① ✅ 标题: Python入门
+    ② ✅ 分类: 技术培训 (cat_001)
+    ③ ✅ 课件: 1 个
+    ④ ✅ 无转码失败课件
+    ⑤ 🟡 课件 "demo" 正在转码 — 发布后学员暂时看不到，确认？
+  
+  ⏭️ 有 1 项警告，确认发布吗？
+
+用户: 确认
+
+主管:
+  ✅ 课程已发布
+  
+  📦 Python入门
+  🔗 ID: course_001
+  📊 课件: 1 个
+  📊 状态: ✅ 已发布
+  
+  ⏭️ 需要指派学员吗？
+
+用户: 暂时不用
+
+主管:
+  📋 Python入门 (id: course_001)
+     Phase 1 ✅ 已创建
+     Phase 2 ✅ 课件 1 个
+     Phase 3 ⏸️  (跳过)
+     Phase 4 ✅ 已发布
+     Phase 5 ⏸️  (跳过)
+     
+  ⏭️ 随时说"看看学习进度"来查看
+```

package/skills/multi/soke-course/references/course-list-courses.md

@@ -0,0 +1,216 @@
+# 课程列表查询参考
+
+## 命令说明
+
+`soke-cli course +list-courses` 用于查询课程列表，转发到 `/skills/course/list`，支持按课程列表模糊搜索关键字、课程分类、课程状态、课程来源、我的课程和协同关系筛选。
+
+## 基本用法
+
+### 查询已发布课程
+
+```bash
+soke-cli course +list-courses \
+  --status 1 \
+  --page 1 \
+  --page-size 10
+```
+
+**说明**:
+- `--status`: 课程状态，默认 `1`
+- `--page`: 页码，默认 `1`
+- `--page-size`: 每页数据，默认 `10`
+
+## 高级筛选
+
+### 按课程状态筛选
+
+```bash
+# 查询已发布的课程
+soke-cli course +list-courses \
+  --status 1
+
+# 查询未发布的课程
+soke-cli course +list-courses \
+  --status 0
+
+# 查询已关闭的课程
+soke-cli course +list-courses \
+  --status 2
+```
+
+**状态说明**:
+- `0`: 未发布
+- `1`: 已发布
+- `2`: 已关闭
+
+### 按课程来源筛选
+
+```bash
+# 查询内部课列表
+soke-cli course +list-courses \
+  --is-in 1
+
+# 查询外部课列表
+soke-cli course +list-courses \
+  --is-in 0
+```
+
+**来源说明**:
+- `0`: 外部课列表
+- `1`: 内部课列表
+
+### 按关键字筛选
+
+```bash
+soke-cli course +list-courses \
+  --keyword "测试"
+```
+
+**说明**：`--keyword` 是课程列表模糊搜索关键字。
+
+### 按课程分类筛选
+
+```bash
+soke-cli course +list-courses \
+  --category-path "category-uuid-here"
+```
+
+**说明**：`--category-path` 会作为接口参数 `categoryPath` 传递，用于按照课程分类 ID 筛选课程。
+
+### 组合筛选
+
+```bash
+# 查询已发布的内部课，只看我创建的，并限制课程分类
+soke-cli course +list-courses \
+  --status 1 \
+  --is-in 1 \
+  --is-my 1 \
+  --category-path "category123"
+```
+
+## 分页查询
+
+```bash
+# 第一页，每页10条
+soke-cli course +list-courses \
+  --page 1 \
+  --page-size 10
+
+# 第二页，每页10条
+soke-cli course +list-courses \
+  --page 2 \
+  --page-size 10
+```
+
+**分页说明**:
+- `--page`: 页码，从1开始，默认为1
+- `--page-size`: 每页数量，默认为10
+
+## 参数说明
+
+| 参数 | 默认值 | 说明 |
+|------|--------|------|
+| `--keyword` | 空 | 课程列表模糊搜索关键字 |
+| `--category-path` | 空 | 课程分类 ID，用于按照分类筛选课程 |
+| `--page` | `1` | 页码 |
+| `--is-in` | `1` | 课程来源：0=外部课列表，1=内部课列表 |
+| `--page-size` | `10` | 每页数据 |
+| `--is-my` | `0` | 是否只看我创建的：0=否，1=是 |
+| `--status` | `1` | 课程状态：0=未发布，1=已发布，2=已关闭 |
+| `--is-joint` | `0` | 协同给我的：0=否，1=是 |
+| `--joint-out` | `0` | 我协同出去的：0=否，1=是 |
+
+## 返回数据示例
+
+```json
+{
+  "code": "200",
+  "status": "ok",
+  "message": "success",
+  "data": {
+    "list": [
+      {
+        "uuid": "course-uuid-123",
+        "title": "Go语言入门教程",
+        "category_id": "category-uuid-456",
+        "certificate_id": "cert-uuid-789",
+        "lector_id": "lector-uuid-101",
+        "study_type": 1,
+        "credit": 10.00,
+        "point": 100.00,
+        "status": 1,
+        "lesson_num": 20,
+        "total_length": 7200,
+        "description": "这是一门Go语言入门课程",
+        "pc_url": "https://example.com/course/123",
+        "mobile_url": "https://m.example.com/course/123",
+        "create_time": 1704038400000,
+        "update_time": 1704124800000,
+        "create_dept_user_id": "user-uuid-111",
+        "create_dept_user_name": "张三"
+      }
+    ],
+    "has_more": 0
+  }
+}
+```
+
+## 返回字段说明
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| uuid | String | 课程唯一ID |
+| title | String | 课程标题 |
+| category_id | String | 课程分类ID |
+| certificate_id | String | 关联证书ID |
+| lector_id | String | 关联讲师ID |
+| study_type | Int | 学习模式（1=自由式, 2=解锁式） |
+| credit | Decimal | 学分数量 |
+| point | Decimal | 积分数量 |
+| status | Int | 课程发布状态（-1=删除, 0=未发布, 1=已发布, 2=关闭） |
+| lesson_num | Int | 课件数量 |
+| total_length | Int | 学时长度（单位：秒） |
+| description | String | 课程描述 |
+| pc_url | String | PC端跳转链接 |
+| mobile_url | String | 移动端跳转链接 |
+| create_time | Int/String | 创建时间 |
+| update_time | Int/String | 更新时间 |
+| create_dept_user_id | String | 创建人ID |
+| create_dept_user_name | String | 创建人姓名 |
+| has_more | Int | 是否还有更多数据（1=有, 0=没有） |
+
+## 常见问题
+
+### Q: 如何查询所有课程？
+A: 使用分页逐页查询，例如：
+```bash
+soke-cli course +list-courses \
+  --page 1 \
+  --page-size 10
+
+soke-cli course +list-courses \
+  --page 2 \
+  --page-size 10
+```
+
+### Q: 如何知道是否还有更多数据？
+A: 查看返回数据中的 `has_more` 字段：
+- `1`: 还有更多数据，需要继续分页查询
+- `0`: 没有更多数据了
+
+### Q: 学习模式的区别是什么？
+A: 
+- **自由式（1）**: 学员可以按任意顺序学习课件
+- **解锁式（2）**: 学员必须按顺序完成课件，完成前一个才能解锁下一个
+
+## 相关命令
+
+- `soke-cli course +get-course`: 获取单个课程详情
+- `soke-cli course +list-categories`: 查询课程分类
+- `soke-cli course +list-lessons`: 查询课程的课件列表
+- `soke-cli course +list-course-users`: 查询课程的学习记录
+
+## 权限要求
+
+- 权限范围: `course:course:readonly`
+- 需要先完成认证: `soke-cli auth login`