@sokeai/cli 1.0.78 → 1.0.80

package/skills/multi/soke-course/references/subs/template/SOP.md

@@ -1,223 +1,50 @@
----
-name: course-template
-version: 1.1.0
-description: 课程模板选择 — 7套预置配置，按业务场景快速初始化课程设置
-tags: [soke, course, template, preset]
----
+# 课程模板子 SOP
 
-# 课程模板
+> 创建课程后（Step 1.3）立即触发。模板会自动应用 CLI 支持的高级设置；后台能力只生成待办清单，不声称已完成。
 
-## 触发描述
+## Step 1 选择（编码 C，不用弹窗）
 
-创建课程（Step 1.3 完成）后立即触发。根据用户业务场景推荐对应模板，输出预置配置清单。Phase 3 时展示当前所有设置项，用户可用自然语言逐项覆盖。
+速查表带 C 编码展示（C1-C7），用户回复 C 编号选定：
 
-## 模板速查
+| 模板编码与名称 | 适用场景 | 高级设置 | 小测验 |
+|---|---|---|---|---|
+| C1 合规必修 | 安全/合规/法务 | 解锁+人脸+禁倍速禁拖动+提醒+评价；证书/签名/审批需后台 | 单课程：不加；批量：不加（固定） |
+| C2 考核认证 | 上岗/资格鉴定 | 解锁+评价；证书/审批需后台 | 单课程：加（默认）；批量：不加（固定） |
+| C3 新人入职 | 新员工/转岗 | 自由学习+倍速+未学提醒+评价 | 单课程：不加（默认）；批量：不加（固定） |
+| C4 知识分享 | 内部分享/兴趣 | 自由学习+倍速+拖动；免费设置需后台 | 单课程：加（默认）；批量：不加（固定） |
+| C5 领导力/软技能 | 管理/沟通 | 拖动+评价；作业/证书/钉钉群需后台 | 单课程：不加；批量：不加（固定） |
+| C6 产品/业务 | 新品上线/业务更新 | 自由学习+倍速+未学提醒；定时发布需后台 | 单课程：加（默认）；批量：不加（固定） |
+| C7 不选择模板 | 精细控制 | 无预设 | 单课程：无默认；批量：不加（固定） |
 
-| # | 模板名称 | 一句话场景 | 特征标签 |
-|---|---------|-----------|---------|
-| 1 | 合规必修（最严） | 安全/合规/法务培训 | 🔒最严管控 |
-| 2 | 考核认证 | 上岗/资格/技能鉴定 | 📝考试+证书 |
-| 3 | 新人入职 | 新员工/转岗培训 | 🚀快速上手 |
-| 4 | 知识分享 | 内部分享/兴趣课程 | 📖自由学习 |
-| 5 | 领导力/软技能 | 管理/沟通/职业素养 | 🎓进阶提升 |
-| 6 | 产品/业务培训 | 新产品上线/业务更新 | 📦快速推送 |
-| 7 | 不选择模板 | 手动逐项配置 | ✋自行设置 |
+## Step 1.5 模板→设置固定映射（选中即自动应用）
 
----
+选中模板后：CLI 支持项**立即 `course +advanced` 固定写入**；后台项一行话术记录；小测验默认值带入 Phase 2 弹窗作推荐项。
 
-## 配置映射表
+| 模板 | +advanced 固定参数 | 小测验默认 |
+|------|------------------|---------|
+| C1 合规必修 | --study-type 2 --is-accelerate 0 --is-drag 0 --open-face-recognition 1 --evaluate-required 1 --is-remind 1 | D2 |
+| C2 考核认证 | --study-type 2 --evaluate-required 1 | D1 |
+| C3 新人入职 | --study-type 1 --is-accelerate 1 --is-remind 1 --evaluate-required 1 | D2 |
+| C4 知识分享 | --study-type 1 --is-accelerate 1 --is-drag 1 | D1 |
+| C5 领导力/软技能 | --is-drag 1 --evaluate-required 1 | D2 |
+| C6 产品/业务 | --study-type 1 --is-accelerate 1 --is-remind 1 | D1 |
+| C7 不选择 | 不写 | 无默认，弹窗问 |
 
-### 1. 合规必修（最严）
+## Step 2 输出配置清单
 
-| 设置项 | 值 | CLI | 说明 |
-|--------|-----|:---:|------|
-| 学习模式 | 必修 + 解锁式(LongDragon) | ⚠️ | 后台：学习设置 |
-| 人脸识别 | 开启 | ⚠️ | 后台：学习设置 → 人脸识别 |
-| 倍速播放 | 禁用 | ⚠️ | 后台：学习设置 → 播放控制 |
-| 拖动进度条 | 禁用 | ⚠️ | 后台：学习设置 → 播放控制 |
-| 电子签名 | 开启 | ⚠️ | 后台：证书设置 → 签名管理 |
-| 收费 | 可选 | ⚠️ | 后台：收费设置 |
-| 截止时间 | 需设置 | ⚠️ | 后台：学习设置 |
-| 课程评价 | 打星评价 | ⚠️ | 后台：评价设置 |
-| 关联证书 | 是 | ⚠️ | 后台：证书设置 |
-| 发布方式 | 审批发布 | ⚠️ | 后台：发布设置 |
+选 1-6 → 先按 Step 1.5 执行 `course +advanced`，再输出该模板设置表，每行标注执行通道：
+- **CLI**：学习模式/倍速/拖动/人脸/提醒/评价/防挂机/评论/二维码 → `course +advanced`；标题/学分/描述/封面 → `course +update`；
+- **后台**：证书/签名（证书设置）、价格/试看（收费设置）、审批发布（审批设置）、截止时间/自动配课（学习/指派设置）、小测验/作业课件（课件添加）。
+选 C7 → 不输出，进入下一步。
 
-**适用场景**：安全培训、合规培训、法务必修课。需要强制学习+防作弊+可追溯。
+## Step 3 Phase 3 设置表（可逐项改）
 
----
+展示「设置项 | 当前值」两列；用户指令处理：
+- CLI 支持项 → 立即执行 +update/+advanced → 刷新表；
+- 后台项 → 「已记录: {项} → {新值}（需在后台操作: {路径}）」→ 刷新表；
+- 「可以了/继续」→ 退出。
 
-### 2. 考核认证
+## 注意
 
-| 设置项 | 值 | CLI | 说明 |
-|--------|-----|:---:|------|
-| 学习模式 | 必修 + 解锁式(LongDragon) | ⚠️ | 后台：学习设置 |
-| 小测验 | 限制次数 | ⚠️ | 后台：课件设置 |
-| 作业 | 多级审批 | ⚠️ | 后台：课件设置 |
-| 人脸识别 | 选开 | ⚠️ | 后台：学习设置 → 人脸识别 |
-| 关联证书 | 是 | ⚠️ | 后台：证书设置 |
-| 发布方式 | 审批发布 | ⚠️ | 后台：发布设置 |
-
-**适用场景**：上岗考试、资格认证、技能鉴定。需考核+认证背书。
-
----
-
-### 3. 新人入职
-
-| 设置项 | 值 | CLI | 说明 |
-|--------|-----|:---:|------|
-| 学习模式 | 必修 + 自由模式(Free) | ⚠️ | 后台：学习设置 |
-| 倍速播放 | 开启 | ⚠️ | 后台：学习设置 → 播放控制 |
-| 未学提醒 | 开启 | ⚠️ | 后台：学习设置 → 提醒设置 |
-| 截止时间 | 需设置 | ⚠️ | 后台：学习设置 |
-| 自动配课 | 开启 | ⚠️ | 后台：指派设置 |
-| 课程评价 | 打星评价 | ⚠️ | 后台：评价设置 |
-
-**适用场景**：新员工培训、转岗培训。需快速覆盖+自动推送+追踪完成。
-
----
-
-### 4. 知识分享
-
-| 设置项 | 值 | CLI | 说明 |
-|--------|-----|:---:|------|
-| 学习模式 | 选修 + 自由模式(Free) | ⚠️ | 后台：学习设置 |
-| 倍速播放 | 开启 | ⚠️ | 后台：学习设置 → 播放控制 |
-| 拖动进度条 | 允许 | ⚠️ | 后台：学习设置 → 播放控制 |
-| 收费 | 免费 | ⚠️ | 后台：收费设置 |
-| 小测验 | 不限次数 | ⚠️ | 后台：课件设置 |
-
-**适用场景**：内部分享、兴趣课程、文化宣传。低门槛+自由学习+无考核压力。
-
----
-
-### 5. 领导力/软技能
-
-| 设置项 | 值 | CLI | 说明 |
-|--------|-----|:---:|------|
-| 学习模式 | 选修或必修 + 自由模式(Free) | ⚠️ | 后台：学习设置 |
-| 作业 | 无需批改 | ⚠️ | 后台：课件设置 |
-| 课程评价 | 打星评价 | ⚠️ | 后台：评价设置 |
-| 关联证书 | 可选 | ⚠️ | 后台：证书设置 |
-| 钉钉群 | 可配置 | ⚠️ | 后台：学习设置 → 钉钉二维码 |
-
-**适用场景**：管理培训、沟通课程、职业素养。互动+讨论+可选认证。
-
----
-
-### 6. 产品/业务培训
-
-| 设置项 | 值 | CLI | 说明 |
-|--------|-----|:---:|------|
-| 学习模式 | 必修 + 自由模式(Free) | ⚠️ | 后台：学习设置 |
-| 倍速播放 | 开启 | ⚠️ | 后台：学习设置 → 播放控制 |
-| 拖动进度条 | 允许 | ⚠️ | 后台：学习设置 → 播放控制 |
-| 小测验 | 开启 | ⚠️ | 后台：课件设置 |
-| 定时发布 | 需设置 | ⚠️ | 后台：发布设置 |
-| 未学提醒 | 开启 | ⚠️ | 后台：学习设置 → 提醒设置 |
-
-**适用场景**：新产品上线、业务知识更新。需快速推送+检验理解+追踪覆盖。
-
----
-
-### 7. 不选择模板
-
-不预置任何配置项，所有设置在 Phase 3 逐项手动确认。适合模板不匹配的场景或需要精细控制的课程。
-
----
-
-## 执行流程
-
-### Step 1: 模板选择弹窗（Phase 1 创建课程后立即触发）
-
-**先输出速查表：**
-
-```
-📋 可选模板（7种）：
-
-| # | 名称 | 适用场景 | 核心配置 |
-|---|------|---------|---------|
-| 1 | 合规必修 | 安全/合规/法务培训 | 人脸+签名+证书+审批 |
-| 2 | 考核认证 | 上岗考试/资格认证 | 考试+证书+多级审批 |
-| 3 | 新人入职 | 新员工/转岗培训 | 提醒+自动配课+评价 |
-| 4 | 知识分享 | 内部分享/兴趣课程 | 自由学习+免费+不限测验 |
-| 5 | 领导力/软技能 | 管理/沟通/职业素养 | 作业+评价+证书+钉钉群 |
-| 6 | 产品/业务培训 | 新产品上线/业务更新 | 定时发布+小测验+提醒 |
-| 7 | 不选择模板 | 模板不匹配/精细控制 | 无预设，后续逐项手动配置 |
-```
-
-**再弹窗让用户选：**
-
-```
-ask_user_question
-  question: "选择课程模板（7选1，详情见上方表格）"
-  header: "模板"
-  options:
-    - label: "1. 合规必修"     description: "安全/合规/法务 · 人脸+签名+证书+审批"
-    - label: "2. 考核认证"     description: "上岗考试/资格认证 · 考试+证书"
-    - label: "3. 新人入职"     description: "新员工/转岗 · 提醒+配课+评价"
-    - label: "4. 知识分享"     description: "内部分享/兴趣 · 自由学习+免费"
-    - label: "5. 领导力/软技能" description: "管理/沟通/素养 · 作业+证书+钉钉群"
-    - label: "6. 产品/业务培训" description: "产品上线/业务更新 · 定时+测验+提醒"
-    - label: "7. 不选择模板"   description: "无预设，逐项手动配置"
-```
-
-### Step 2: 输出模板配置
-
-用户选 1-6 → 输出该模板完整配置表：
-
-```
-✅ 已选择「{模板名称}」模板
-
-📋 该模板预置以下设置（CLI 不支持，需后台操作）：
-
-| 设置项 | 预置值 | 后台路径 |
-|--------|--------|---------|
-| xxx    | xxx    | 后台 → xxx |
-| ...    | ...    | ...       |
-
-⏭️ 后续进入 Phase 3 时，可以逐项修改以上设置。回复"继续"进入下一步。
-```
-
-用户选 7.「不选择模板」→ 不输出配置清单，直接进入 Phase 1 的路由弹窗。
-
-### Step 3: Phase 3 展示当前设置（可逐项修改）
-
-进入 Phase 3 时，将当前课程所有设置项以表格形式展示：
-
-```
-📋 当前设置（模板: {模板名称}）：
-
-| 设置项 | 当前值 |
-|--------|--------|
-| 标题   | "xxx"  |
-| 描述   | "xxx"  |
-| 学习模式 | 必修+解锁式 |
-| 人脸识别 | 开启 |
-| ... | ... |
-
-💬 想修改哪项？直接告诉我就行，比如：
-  - "标题改成 xxx"
-  - "学习模式改成自由式"
-  - "关掉人脸识别"
-  - "加一个证书"
-```
-
-用户输入修改指令后的处理：
-
-| 修改项 | CLI 支持 | 处理方式 |
-|--------|:---:|------|
-| 标题/描述 | ✅ | 执行 `course +update` 更新，表中同步刷新 |
-| 其他所有设置 | ⚠️ | "该设置需在后台修改（路径: xxx）。我会在清单中标注为待修改。" |
-| 修改模板预设值 | ⚠️ | "已记录：{设置项} → {新值}（需在后台操作）" |
-
-每次修改后刷新配置表，直到用户说"可以了"/"继续"进入下一步。
-
----
-
-## 注意事项
-
-1. 模板选择后不自动通过 CLI 修改课程 — 大部分设置 CLI 不支持
-2. 模板选择不影响已创建的 title/description/category-id
-3. Phase 3 必须展示完整设置清单，让用户逐项确认/修改
-4. 用户选「不选择模板」(7)时，Phase 3 也需展示所有可配置项，方便用户了解能做什么
-5. 若用户选了模板但没去后台配置，发布阶段 Gate Check 可能阻塞
+- 模板不影响已创建的 title/description/category-id；
+- 选模板但未去后台配置的项，发布 Gate 不阻塞（均为非硬项）。

package/skills/multi/soke-course/references/troubleshoot.md

@@ -1,68 +1,51 @@
-# 常见问题排错指南
+# 排错指南（v6 收敛版）
+
+> 与 subs/publish/SOP.md 冲突时以 publish SOP 为准（已收敛）。
 
 ## 认证类
 
-| 错误信息 | 原因 | 修复 |
-|---------|------|------|
-| `access_key_id not configured` | 未配置登录凭证 | `soke-cli config set --key access_key_id --value <your-key>` |
-| `Token 过期 / 401 Unauthorized` | 登录 Token 已过期 | `soke-cli auth login` |
-| `Permission denied / 403` | 当前账号无操作权限 | 联系管理员在开放平台开通权限 |
+| 错误 | 原因 | 修复 |
+|------|------|------|
+| Token 过期 / 401 | 登录态失效 | `soke-cli auth login` 重新授权 |
+| Permission denied / 403 | 账号无权限 | 联系管理员在开放平台开通（course/exam/assign 各模块 :write/:readonly） |
+| soke-cli 不存在 | 未安装 | read soke-cli-install-guide.md |
 
 ## 课程操作类
 
-| 错误信息 | 原因 | 修复 |
-|---------|------|------|
-| `课程标题为空` | 未设置标题 | `course +update --course-id <id> --title "标题"` |
-| `分类不存在 / category not found` | category-id 无效 | `course +list-categories` 重新查询有效分类 |
-| `课程不存在 / Course not found` | course-id 无效或已删除 | `course +list-courses` 确认课程列表 |
-| `课程状态不是未发布，不能发布` | status=1(已发布)或2(已关闭) | 已发布无需操作；已关闭不能重新发布 |
-| `课件数量不足` | 课程无课件 | 进入 Phase 2 添加课件 |
-
-## 上传类
-
-| 错误信息 | 原因 | 修复 |
-|---------|------|------|
-| `file not found` | 文件路径错误或不存在 | 检查路径是否正确，使用绝对路径 |
-| `文件类型不支持` | 格式不在支持列表中 | 转换为 .mp4/.mp3/.pdf 等支持格式 |
-| `文件大小超过限制` | 文件超过上限 | 压缩文件后重试 |
-| `OSS upload failed` | 网络问题或 Token 失效 | 重新登录后重试 |
-| `转码失败` | 文件损坏或格式异常 | 删除失败课件，确认源文件可用后重新上传 |
-
-## 课件操作类
-
-| 错误信息 | 原因 | 修复 |
-|---------|------|------|
-| `素材不存在 / media not found` | media-id 无效 | 确认素材已上传成功 `file +list-files` |
-| `课件类型不匹配` | type 与素材不符 | type 必须与素材上传响应的 type 一致 |
-| `课件已存在` | 重复创建 | 检查 `course +lesson-list` |
-| `课件数量达到上限` | 课程课件数超标 | 删除不需要的课件 |
+| 错误 | 原因 | 修复 |
+|------|------|------|
+| 课程标题为空 | 未设置 | `course +update --title` |
+| category not found | 分类 ID 无效 | `+list-categories` 重查 |
+| Course not found | course-id 无效 | `+list-courses` 确认 |
+| 不能发布 | 课件不足/转码失败 | Gate Check 逐项修复 |
+| 已关闭课程 | — | **可重新发布**（`+publish`）；关闭用 `+update --action close` |
+
+## 上传/课件类
+
+| 错误 | 原因 | 修复 |
+|------|------|------|
+| file not found | 路径错 | 用绝对路径 |
+| 文件类型不支持 | 格式不在列表 | 转 .mp4/.mp3/.pdf 等；图片走 photo-gallery |
+| OSS upload failed | 网络/Token | 重登录后重试 |
+| 转码失败 | 源文件损坏 | 删课件重传 |
+| media not found | media-id 无效 | `file list-files` 确认 |
+| 课件类型不匹配 | type 与素材不符 | type 必须等于上传返回的 type |
 
 ## 指派类
 
-| 错误信息 | 原因 | 修复 |
-|---------|------|------|
-| `课程未发布，不能指派` | status ≠ 1 | 先发布课程再指派 |
-| `用户不存在` | user-id 无效 | `assign +list-users` 确认有效用户 |
-| `部门不存在` | dept-id 无效 | `assign +list-departments` 确认有效部门 |
+| 错误 | 原因 | 修复 |
+|------|------|------|
+| 课程未发布不能指派 | 当前平台允许未发布课程指派；学员需发布后可见 | 先完成指派，再执行发布 Gate；发布后回查指派结果 |
+| 用户/部门不存在 | ID 无效 | `assign +list-users` / `+list-departments` 确认 |
 
-## 查询类
+## 通用调试
 
-| 错误信息 | 原因 | 修复 |
-|---------|------|------|
-| `时间范围超过365天` | +list-courses 限制 | 分批查询，每年一次 |
-| `数据为空` | 筛选条件无匹配 | 放宽筛选条件或检查权限范围 |
-
-## 通用调试步骤
+- **CLI 报错的 Error 行打印在 usage 输出的尾部**，排错用 `| tail -2`，别看 head；
+- 常见隐性必填：clock 的 --page/--page-size；list-course-users 的 finish 时间（≤7 天窗口）。
 
 ```bash
-# 1. 检查认证状态
-soke-cli config show
-
-# 2. 检查课程是否存在
-soke-cli course +get-course --course-id "xxx" --format json
-
-# 3. 检查课件状态
-soke-cli course +lesson-list --course-id "xxx" --format json
-
-# 4. 始终使用 --format json 获取结构化输出
+soke-cli config show                      # 登录态
+soke-cli doctor                           # 全量健康检查
+soke-cli <cmd> --format json              # 结构化输出
+soke-cli <cmd> --help                     # 实测参数后补录 cli-facts.md
 ```

package/skills/multi/soke-course/scripts/check_readiness.sh

@@ -0,0 +1,45 @@
+#!/bin/bash
+# soke-course v6 环境就绪检查（自包含版：无并列技能依赖）
+set -e
+BASE_DIR="$(cd "$(dirname "$0")/.." && pwd)"
+
+echo "🔍 课程发布主管 v6 — 环境检查"
+echo "============================"
+
+echo "🔧 命令行工具:"
+if ! command -v soke-cli &> /dev/null; then
+    echo "  ❌ soke-cli 未安装 — 请 Read soke-cli-install-guide.md 按步骤安装"
+    exit 1
+fi
+echo "  ✅ soke-cli: $(soke-cli --version)"
+
+CONFIG=$(soke-cli config show 2>/dev/null || echo "")
+# config show 使用中文标签「用户凭证」，不能只匹配旧字段名。
+TOKEN_LINE=$(printf '%s\n' "$CONFIG" | grep -E '^用户凭证:' || true)
+TOKEN_VALUE=$(printf '%s\n' "$TOKEN_LINE" | sed 's/^用户凭证:[[:space:]]*//')
+if [ -n "$TOKEN_VALUE" ] && [ "$TOKEN_VALUE" != "(未设置)" ]; then
+    echo "  ✅ 已登录"
+else
+    echo "  ⚠️  未登录或 Token 过期 — 将由主流程自动执行网页登录授权"
+fi
+
+echo "📁 子能力 SOP (references/subs/):"
+for sub in category settings charge publish copy query template material lesson assign exam photo; do
+    if [ -f "$BASE_DIR/references/subs/$sub/SOP.md" ]; then
+        echo "  ✅ $sub"
+    else
+        echo "  ❌ $sub (缺失)"
+    fi
+done
+
+echo "📚 参考文档:"
+for ref in cli-facts.md intent-cases.md sop-full-workflow.md sop-lesson-types.md sop-publish-check.md troubleshoot.md examples.md; do
+    if [ -f "$BASE_DIR/references/$ref" ]; then
+        echo "  ✅ $ref"
+    else
+        echo "  ❌ $ref (缺失)"
+    fi
+done
+
+echo ""
+echo "✅ 环境检查完成"

package/skills/multi/soke-course/{references/installation.md → soke-cli-install-guide.md}

@@ -434,6 +434,9 @@ npx skills add liuchenlong1111/soke-cli -y -g
 
 ### 📖 阅读详细文档
 
+- [README.md](../README.md) - 项目概览
+- [CLAUDE.md](../CLAUDE.md) - 项目架构和开发规范
+- [skills/README.md](../skills/README.md) - AI Agent Skills 详细说明
 
 ---
 

package/skills/mono/references/modules/soke-course/agents/openai.yaml

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

package/skills/mono/references/modules/soke-course/references/course-list-courses.md

@@ -1,216 +0,0 @@
-# 课程列表查询参考
-
-## 命令说明
-
-`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`