@sokeai/cli 1.0.78 → 1.0.80

package/skills/mono/references/modules/soke-course/references/subs/publish/SOP.md

@@ -1,168 +0,0 @@
----
-name: soke-course-publish
-version: 1.0.0
-description: 发布管理 — 发布前 Gate Check 五道校验 + 发布操作，含状态流转与审批规则
-tags: [soke, publish, gate-check, status, approval]
----
-
-# 发布管理
-
-## 触发描述
-
-课程内容与设置准备就绪后，需要将课程发布上线供学员学习时触发本技能。发布前需通过 Gate Check 五道校验，通过后方可执行发布操作。
-
-## 课程状态流转
-
-```
-  ┌──────────┐     发布      ┌──────────┐
-  │ 0: 未发布 │ ──────────→  │ 1: 已发布 │
-  └──────────┘               └─────┬────┘
-       ↑                           │
-       │         关闭               │
-       └───────────────────────────┘
-              ← 重新发布
-              
-  ┌──────────┐
-  │ 2: 已关闭 │
-  └──────────┘
-```
-
-| 状态码 | 含义 | 说明 |
-|--------|------|------|
-| `0` | 未发布 | 课程初始状态，可编辑，学员不可见 |
-| `1` | 已发布 | 已上线，学员可见可学习 |
-| `2` | 已关闭 | 已下线，学员不可见，可重新发布 |
-
-> 已关闭 (status=2) 的课程可重新发布回到 status=1，也可继续编辑后重新发布。
-
-## 执行流程
-
-### 第一步：Gate Check（发布前置校验）
-
-执行 `course +publish` 前，系统自动完成以下 5 项校验。**任何一项不通过则发布失败。**
-
-| 序号 | 校验项 | 通过条件 | 不通过提示 |
-|------|--------|----------|-----------|
-| 1 | **标题** | 课程标题不为空 | "请填写课程标题" |
-| 2 | **分类** | 已选择课程所属分类 | "请选择课程分类" |
-| 3 | **课件 ≥ 1** | 课程下至少有 1 节课件 | "请至少添加一节课件" |
-| 4 | **无转码失败课件** | 所有视频/音频课件转码状态为成功 | "存在转码失败的课件，请重新上传" |
-| 5 | **无转码中课件** | 没有正在转码的课件（转码完成后才可发布） | "课件转码中，请稍候再发布" |
-
-> 文档类课件无需转码，校验项 4、5 仅针对视频和音频课件。
-
-### 第二步：执行发布 `course +publish`
-
-直接发布：
-
-```bash
-soke course +publish --course-id <courseId>
-```
-
-定时发布：
-
-```bash
-soke course +publish \
-  --course-id <courseId> \
-  --publish-time "2026-07-14 17:24:42"
-```
-
-| 参数 | 必填 | 说明 |
-|------|------|------|
-| `--course-id` | 是 | 课程 ID |
-| `--publish-time` | 否 | 定时发布时间，输入北京时间；不传则直接发布 |
-
-> 实现口径：传入非零 `--publish-time` 时开启定时发布；未传或传 `0000-00-00 00:00:00` 时不开启定时发布。
-
-发布成功后课程状态由 `0` → `1`。
-
-## 关闭课程
-
-关闭已发布课程：
-
-```bash
-soke course +update --course-id <courseId> --action close
-```
-
-关闭成功后课程状态由 `1` → `2`，学员端不可见，历史学习记录保留。已关闭课程可再次执行 `course +publish` 重新发布。
-
-## 删除课程
-
-删除未发布或已关闭课程：
-
-```bash
-soke course +delete --course-id <courseId>
-```
-
-删除前必须先查询课程状态。仅允许删除 `status=0` 未发布或 `status=2` 已关闭课程；`status=1` 已发布课程必须先执行 `course +update --course-id <courseId> --action close` 关闭后再删除。删除成功后课程状态变为已删除（`status=-1` 或 `status=3`）。
-
-## ⚠️ CLI 不支持的操作
-
-| 操作 | 说明 | 替代路径 |
-|------|------|---------|
-| **审批流** | 发布需经过审批流程 | 后台 → 系统设置 → 审批设置 |
-| **批量发布** | 一次发布多门课程 | 后台 → 课程管理 → 批量操作 |
-
-## 审批规则
-
-### 默认审批配置
-
-| 配置项 | 默认值 | 说明 |
-|--------|--------|------|
-| 审批开关 | **关闭** | 默认不启用审批流，发布即上线 |
-| 审批流层级 | 1 级 | 如需开启，仅支持 1 级审批 |
-| 第一级审批人 | **不可删除** | 审批流至少保留 1 个审批节点 |
-| 默认审批人 | **主管理员** | 系统默认审批人为租户主管理员 |
-| 审批模式 | **或签** | 第一级多个审批人时，任一人通过即可 |
-
-### 开启审批流
-
-```
-后台 → 系统设置 → 审批设置 → 课程发布审批
-```
-
-开启后，发布操作将生成审批单，审批通过后课程才正式上线（status 变为 1）。
-
-## 输出标准
-
-发布成功：
-
-```
-✅ 课程发布成功
-- 课程: {title} (ID: {courseId})
-- 状态: 已发布 (status=1)
-- 学员端已可见
-```
-
-Gate Check 不通过（示例）：
-
-```
-❌ 发布校验未通过
-- [✗] 标题：请填写课程标题
-- [✓] 分类：已选择
-- [✗] 课件：请至少添加一节课件
-- [✓] 转码失败：无
-- [✓] 转码中：无
-
-请完成上述校验项后重新发布。
-```
-
-## 注意事项
-
-1. 先过 Gate Check，再执行 publish — 校验项全部通过是发布的必要条件
-2. 转码是异步过程，上传视频/音频后需等待转码完成再发布
-3. 课程关闭后学员端不可见，但历史学习记录保留
-4. 关闭后可重新发布，状态回到 1
-5. 删除课程不可逆，CLI 只允许删除未发布(status=0)或已关闭(status=2)课程
-6. 审批流默认关闭，如需开启需后台手动配置
-
-## 检查清单
-
-- [ ] 标题已填写（非空）
-- [ ] 分类已选择
-- [ ] 课件数 ≥ 1
-- [ ] 无转码失败的课件
-- [ ] 无正在转码中的课件
-- [ ] 五道校验全部通过
-- [ ] publish 执行成功，状态确认变为 1
-- [ ] 如涉及审批流，已告知默认关闭及后台配置路径

package/skills/mono/references/modules/soke-course/references/subs/query/SOP.md

@@ -1,165 +0,0 @@
----
-name: soke-course-query
-version: 1.0.0
-description: 数据查询 — 课程/学员/学习记录/人脸验证数据查询
-tags: [soke, query, data, analytics, learning-records]
----
-
-# 数据查询
-
-## 触发描述
-
-需要查询课程数据、学员学习记录、人脸验证记录等运营数据时触发本技能。支持课程维度、学员维度、课件维度的多层级数据查询。
-
-## 通用约束
-
-- 课程列表走 `/skills/course/list`，不再使用创建时间范围筛选。
-- 学习记录类查询如包含时间参数，时间戳仍使用**毫秒级 Unix timestamp**。
-- **状态码含义**：
-  - `status`（课程）：`0`=未发布，`1`=已发布，`2`=已关闭
-  - `face_status`（人脸）：`1`=验证成功，`2`=验证失败
-
-## 执行流程
-
-### 1. 课程列表 `+list-courses`
-
-```bash
-soke course +list-courses
-```
-
-| 参数 | 必填 | 说明 |
-|------|------|------|
-| `--keyword` | 否 | 课程列表模糊搜索关键字 |
-| `--category-path` | 否 | 课程分类 ID，用于按照分类筛选课程 |
-| `--status` | 否 | 按状态过滤（0/1/2） |
-| `--is-in` | 否 | 课程来源：0=外部课列表，1=内部课列表（默认 1） |
-| `--is-my` | 否 | 是否只看我创建的（默认 0） |
-| `--is-joint` | 否 | 协同给我的（默认 0） |
-| `--joint-out` | 否 | 我协同出去的（默认 0） |
-| `--page` | 否 | 页码（默认 1） |
-| `--page-size` | 否 | 每页条数（默认 10） |
-
-返回课程列表，包含课程 ID、标题、状态、创建时间、学习人数等摘要。
-
-### 2. 课程详情 `+get-course`
-
-```bash
-soke course +get-course --course-id <courseId>
-```
-
-| 参数 | 必填 | 说明 |
-|------|------|------|
-| `--course-id` | 是 | 课程 ID |
-
-返回课程完整信息：标题、描述、分类、状态、讲师、课件数、学习人数、完成率等。
-
-### 3. 课程学员列表 `+list-course-users`
-
-```bash
-soke course +list-course-users --course-id <courseId>
-```
-
-| 参数 | 必填 | 说明 |
-|------|------|------|
-| `--course-id` | 是 | 课程 ID |
-| `--status` | 否 | 学习状态过滤（进行中/已完成/未开始） |
-| `--keyword` | 否 | 按学员姓名搜索 |
-| `--page` | 否 | 页码 |
-| `--page-size` | 否 | 每页条数 |
-
-返回该课程所有学员列表，包含用户 ID、姓名、部门、学习进度、学习时长、完成状态。
-
-### 4. 学员详情 `+get-course-user`
-
-```bash
-soke course +get-course-user \
-  --course-id <courseId> \
-  --user-id <userId>
-```
-
-| 参数 | 必填 | 说明 |
-|------|------|------|
-| `--course-id` | 是 | 课程 ID |
-| `--user-id` | 是 | 学员 ID |
-
-返回单个学员在该课程下的详细学习记录：每节课时进度、总时长、完成状态、成绩等。
-
-### 5. 课件学习记录 `+list-lesson-learns`
-
-```bash
-soke course +list-lesson-learns \
-  --lesson-id <lessonId> \
-  --start-time <ms> \
-  --end-time <ms>
-```
-
-| 参数 | 必填 | 说明 |
-|------|------|------|
-| `--lesson-id` | 是 | 课件 ID |
-| `--start-time` | 是 | 起始时间（ms），跨度 ≤ 365 天 |
-| `--end-time` | 是 | 结束时间（ms） |
-| `--user-id` | 否 | 按学员过滤 |
-
-返回指定课件在时间范围内的学员学习记录：用户、学习时长、完成百分比、首次学习时间、最后学习时间。
-
-### 6. 人脸验证记录 `+list-lesson-faces`
-
-```bash
-soke course +list-lesson-faces \
-  --lesson-id <lessonId> \
-  --start-time <ms> \
-  --end-time <ms>
-```
-
-| 参数 | 必填 | 说明 |
-|------|------|------|
-| `--lesson-id` | 是 | 课件 ID |
-| `--start-time` | 是 | 起始时间（ms），跨度 ≤ 365 天 |
-| `--end-time` | 是 | 结束时间（ms） |
-| `--user-id` | 否 | 按学员过滤 |
-| `--face-status` | 否 | 验证状态：`1`=成功，`2`=失败 |
-
-返回人脸验证记录，包含：
-- 用户信息
-- 验证时间
-- `face_status`：`1` = 验证成功，`2` = 验证失败
-- 失败原因（如有人脸不匹配、超时等）
-
-## 输出标准
-
-以结构化表格或摘要形式输出查询结果，示例如下：
-
-**课程列表**：
-```
-📋 课程列表 (共 N 门)
-
-| 标题 | 状态 | 学员数 | 完成率 | 创建时间 |
-|------|------|--------|--------|----------|
-| ...  | ...  | ...    | ...    | ...      |
-```
-
-**学员学习记录**：
-```
-📊 {courseTitle} — 学员学习记录 (共 N 人)
-
-| 姓名 | 部门 | 进度 | 学习时长 | 状态 |
-|------|------|------|----------|------|
-| ...  | ...  | ...  | ...      | ...  |
-```
-
-## 注意事项
-
-1. **时间跨度**：所有时间范围查询（start-time / end-time）跨度不超过 365 天，超过需分段查询
-2. **时间戳单位**：统一使用毫秒 (ms)，`Date.now()` 风格的时间戳，如 `1700000000000`
-3. **分页查询**：大数据量查询务必使用分页参数，避免超时
-4. **face_status 枚举**：仅 `1`（成功）和 `2`（失败），无其他状态值
-5. **课程状态枚举**：`0`（未发布）/ `1`（已发布）/ `2`（已关闭），查询时按需过滤
-6. 人脸验证记录仅在人脸识别功能已开启的课程中产生数据
-
-## 检查清单
-
-- [ ] 时间范围 ≤ 365 天
-- [ ] 时间戳已确认采用毫秒单位
-- [ ] 分页参数对大结果集已设置
-- [ ] face_status 查询值为 1 或 2
-- [ ] course status 查询值为 0/1/2

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

@@ -1,223 +0,0 @@
----
-name: course-template
-version: 1.1.0
-description: 课程模板选择 — 7套预置配置，按业务场景快速初始化课程设置
-tags: [soke, course, template, preset]
----
-
-# 课程模板
-
-## 触发描述
-
-创建课程（Step 1.3 完成）后立即触发。根据用户业务场景推荐对应模板，输出预置配置清单。Phase 3 时展示当前所有设置项，用户可用自然语言逐项覆盖。
-
-## 模板速查
-
-| # | 模板名称 | 一句话场景 | 特征标签 |
-|---|---------|-----------|---------|
-| 1 | 合规必修（最严） | 安全/合规/法务培训 | 🔒最严管控 |
-| 2 | 考核认证 | 上岗/资格/技能鉴定 | 📝考试+证书 |
-| 3 | 新人入职 | 新员工/转岗培训 | 🚀快速上手 |
-| 4 | 知识分享 | 内部分享/兴趣课程 | 📖自由学习 |
-| 5 | 领导力/软技能 | 管理/沟通/职业素养 | 🎓进阶提升 |
-| 6 | 产品/业务培训 | 新产品上线/业务更新 | 📦快速推送 |
-| 7 | 不选择模板 | 手动逐项配置 | ✋自行设置 |
-
----
-
-## 配置映射表
-
-### 1. 合规必修（最严）
-
-| 设置项 | 值 | CLI | 说明 |
-|--------|-----|:---:|------|
-| 学习模式 | 必修 + 解锁式(LongDragon) | ⚠️ | 后台：学习设置 |
-| 人脸识别 | 开启 | ⚠️ | 后台：学习设置 → 人脸识别 |
-| 倍速播放 | 禁用 | ⚠️ | 后台：学习设置 → 播放控制 |
-| 拖动进度条 | 禁用 | ⚠️ | 后台：学习设置 → 播放控制 |
-| 电子签名 | 开启 | ⚠️ | 后台：证书设置 → 签名管理 |
-| 收费 | 可选 | ⚠️ | 后台：收费设置 |
-| 截止时间 | 需设置 | ⚠️ | 后台：学习设置 |
-| 课程评价 | 打星评价 | ⚠️ | 后台：评价设置 |
-| 关联证书 | 是 | ⚠️ | 后台：证书设置 |
-| 发布方式 | 审批发布 | ⚠️ | 后台：发布设置 |
-
-**适用场景**：安全培训、合规培训、法务必修课。需要强制学习+防作弊+可追溯。
-
----
-
-### 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 可能阻塞

package/skills/mono/references/modules/soke-course/references/troubleshoot.md

@@ -1,68 +0,0 @@
-# 常见问题排错指南
-
-## 认证类
-
-| 错误信息 | 原因 | 修复 |
-|---------|------|------|
-| `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` | 当前账号无操作权限 | 联系管理员在开放平台开通权限 |
-
-## 课程操作类
-
-| 错误信息 | 原因 | 修复 |
-|---------|------|------|
-| `课程标题为空` | 未设置标题 | `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` |
-| `课件数量达到上限` | 课程课件数超标 | 删除不需要的课件 |
-
-## 指派类
-
-| 错误信息 | 原因 | 修复 |
-|---------|------|------|
-| `课程未发布，不能指派` | status ≠ 1 | 先发布课程再指派 |
-| `用户不存在` | user-id 无效 | `assign +list-users` 确认有效用户 |
-| `部门不存在` | dept-id 无效 | `assign +list-departments` 确认有效部门 |
-
-## 查询类
-
-| 错误信息 | 原因 | 修复 |
-|---------|------|------|
-| `时间范围超过365天` | +list-courses 限制 | 分批查询，每年一次 |
-| `数据为空` | 筛选条件无匹配 | 放宽筛选条件或检查权限范围 |
-
-## 通用调试步骤
-
-```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 获取结构化输出
-```

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

@@ -1,70 +0,0 @@
-# 最简创建样例
-
-**场景**: 用户只给标题和分类，创建+发布
-
-**对话流程:**
-
-```
-用户: 创建一门课，叫 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 ⏸️  (跳过)
-     
-  ⏭️ 随时说"看看学习进度"来查看
-```