@sokeai/cli 1.0.77 → 1.0.78

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

@@ -0,0 +1,112 @@
+---
+name: soke-course-category
+version: 1.1.0
+description: 分类管理 — 查询课程分类体系（6级层级），移动端展示前3级
+tags: [soke, category, classification, hierarchy]
+---
+
+# 分类管理
+
+## 触发描述
+
+在创建课程前需要选择或查询课程所属分类时触发。分类体系为 6 级树形层级结构，移动端仅展示前 3 级。
+
+## 分类体系
+
+```
+一级分类
+ └── 二级分类
+      └── 三级分类
+           └── 四级分类
+                └── 五级分类
+                     └── 六级分类
+```
+
+- **管理后台**：展示完整 6 级
+- **移动端（学员侧）**：仅展示前 3 级（一二三级）
+
+## 执行流程
+
+### Step 1: 查询分类 `course +list-categories`
+
+```bash
+soke course +list-categories
+```
+
+无必填参数，返回当前租户下完整的分类树。
+
+可选参数：
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--parent-id` | 否 | 查询指定父分类下的子分类 |
+| `--level` | 否 | 按层级过滤（1-6） |
+
+返回每个分类的 `id`、`name`、`parent_id`、`level`。
+
+### Step 2: 分类选择（弹窗交互）
+
+根据匹配结果使用 `ask_user_question` 弹窗：
+
+| 场景 | 弹窗策略 |
+|------|---------|
+| 用户已指定分类名，匹配到唯一结果 | 不弹窗，直接使用 |
+| 匹配到多个结果 | 弹窗列匹配项，最后加 `🆕 新建分类` |
+| 用户未指定分类 | 弹窗列一级分类列表，最后加 `🆕 新建分类` |
+| 用户说"随便" | 取第一个一级分类 |
+
+弹窗示例：
+```
+ask_user_question
+  question: "选择课程分类"
+  header: "分类"
+  options:
+    - label: "📁 技术研发"         description: "一级分类 · 含 8 个子分类"
+    - label: "📁 企业管理"         description: "一级分类 · 含 5 个子分类"
+    - label: "📁 产品设计"         description: "一级分类 · 含 3 个子分类"
+    - label: "🆕 新建分类"         description: "前往管理后台新建分类"
+```
+
+### Step 3: 新建分类（CLI 不支持）
+
+若用户选择 `🆕 新建分类`，告知操作路径：
+
+> "CLI 暂不支持新建分类。请前往管理后台操作：
+> **后台 → 课程管理 → 分类设置 → 新增分类**
+> 
+> 创建时会要求填写：分类名称、选择父级分类、设定排序序号。
+> 分类可分六级，手机端学员只能看到前三级。
+> 
+> 新建完成后请回复"分类建好了"，我将重新拉取分类列表继续。"
+
+用户确认后 → 重新执行 Step 1 → 再弹窗选择。
+
+## 输出标准
+
+以缩进层级列表形式展示分类树（供参考，弹窗交互时不需要打印全部）：
+
+```
+📁 技术研发 (ID: 1, L1)
+  📁 前端开发 (ID: 12, L2)
+    📁 React (ID: 121, L3)
+      📁 基础入门 (ID: 1211, L4)
+        ...
+📁 企业管理 (ID: 2, L1)
+  ...
+```
+
+## 注意事项
+
+1. 分类为租户级别数据，不同租户分类体系独立
+2. 课程必须归属于一个末级分类（通常是第 4-6 级）
+3. 移动端仅展示前 3 级，创建分类时需考虑移动端用户体验
+4. 删除分类前需清空该分类下的所有课程
+5. 分类层级一旦确定不建议频繁调整，会影响已有课程归类
+
+## 检查清单
+
+- [ ] 已通过 list-categories 获取完整分类树
+- [ ] 选择分类时已使用 `ask_user_question` 弹窗
+- [ ] 弹窗最后一项始终为 `🆕 新建分类`
+- [ ] 用户选新建时已告知后台操作路径
+- [ ] 确认目标分类 ID 存在于返回结果中

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

@@ -0,0 +1,107 @@
+---
+name: soke-course-charge
+version: 1.0.0
+description: 收费设置 — 付费课程与试学规则说明，全部需后台操作
+tags: [soke, charge, pricing, payment, trial, alipay]
+---
+
+# 收费设置
+
+## 触发描述
+
+用户需要为课程配置收费模式、设置价格、开通试学功能时触发本技能。**全部收费相关操作均需通过管理后台完成，CLI 不支持任何收费配置。**
+
+## ⚠️ CLI 不支持
+
+**所有收费设置操作均需通过后台：**
+
+```
+后台 → 课程管理 → 课程列表 → 编辑 → 收费设置
+```
+
+## 收费规则说明
+
+### 1. 支付宝商户密钥
+
+配置收费前必须先在系统层面绑定支付宝商户密钥：
+
+```
+后台 → 系统设置 → 支付设置 → 支付宝配置
+```
+
+需提供：
+- 支付宝商户 PID
+- 支付宝商户密钥（MD5 Key）
+- 支付宝公钥
+
+未配置商户密钥将无法开启任何课程收费。
+
+### 2. 付费课程试学规则
+
+试学功能仅在**同时满足以下所有条件**时可用：
+
+| 条件 | 说明 |
+|------|------|
+| 课程为付费课程 | 已设定价格且支付通道可用 |
+| 课件数量 ≥ 2 | 课程内至少有 2 节课时 |
+| 课件类型含视频/音频/文档 | 课时中包含 `video`、`audio` 或 `document` 类型的课件 |
+
+> ⚠️ 纯图文课件（不含视频/音频/文档）不满足试学条件。
+
+**试学模式规则：**
+
+- 试学期间学员可免费观看指定数量的课件
+- 试学不记录学习进度 — 付费购买后从第 1 节重新开始
+- 试学可配置开放课时数（如开放前 2 节）
+- 试学可配置时间限制（如 7 天内有效）
+
+### 3. 价格设置
+
+- 支持固定价格（一口价）
+- 支持划线价（原价 ¥199 → 现价 ¥99）
+- 支持限时优惠（设置优惠截止时间）
+- 价格单位为人民币（元），精确到小数点后两位
+
+### 4. 学员端行为
+
+- 免费课程：学员直接加入学习
+- 付费课程未购买：可试学（如已开启），或看到课程介绍页 + 购买按钮
+- 付费课程已购买：正常学习，记录进度，可获得证书（如已配置）
+
+## 输出标准
+
+当用户询问收费设置时，输出：
+
+```
+⚠️ 收费设置为后台操作，CLI 不支持
+
+配置路径：后台 → 课程管理 → 课程列表 → 编辑 → 收费设置
+
+前置条件：
+  1. 支付宝商户密钥已配置（系统设置 → 支付设置）
+  2. 课程已创建且课件已添加
+
+试学条件：
+  - 付费课程
+  - 课件 ≥ 2 节
+  - 包含 video/audio/document 类型课件
+  - 试学不记录学习进度
+
+如需配置，请前往后台操作。
+```
+
+## 注意事项
+
+1. 收费是课程的高级属性，与课程发布状态无关 — 未发布的课程也可以配置收费
+2. 修改价格不会影响已购买学员，已支付订单不受影响
+3. 关闭收费（改为免费）后，已购学员权益保留，新学员免费学习
+4. 试学课件必须在课程课件列表中，不能额外上传独立试学内容
+5. 试学数据与正式学习数据完全隔离，不产生进度混淆
+6. 退款、发票等支付后操作不在此 Skill 范围，需走财务后台流程
+
+## 检查清单
+
+- [ ] 用户已了解收费配置全部需后台操作
+- [ ] 如涉及试学，已告知前置条件（付费 + 课件≥2 + 含视频/音频/文档）
+- [ ] 如涉及支付，已提醒支付宝商户密钥配置前置
+- [ ] 已提醒试学不记录学习进度的关键规则

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

@@ -0,0 +1,80 @@
+---
+name: soke-course-copy
+version: 1.0.0
+description: 课程复制 — 复制规则说明，全部需后台操作
+tags: [soke, copy, duplicate, clone, course]
+---
+
+# 课程复制
+
+## 触发描述
+
+用户需要基于已有课程创建副本时触发本技能。**课程复制的所有操作均需通过管理后台完成，CLI 不支持。**
+
+## ⚠️ CLI 不支持
+
+```
+后台 → 课程管理 → 课程列表 → 课程操作 → 复制
+```
+
+## 复制规则
+
+### 会复制的内容
+
+| 内容 | 复制后状态 | 说明 |
+|------|-----------|------|
+| **课件（lessons）** | 进度归零 (progress=0) | 所有课件完整复制，但学习计数从 0 开始 |
+| **素材（materials）** | 完整复制 | 课件关联的素材资源（视频/音频/文档）完整复制 |
+| **作业（homework）** | 完整复制 | 作业配置和内容一并复制 |
+| **测验（quizzes）** | 作为新考试复制 | 原有测验以独立的新考试形式复制到新课程中 |
+| **基础设置** | 完整复制 | 标题（可追加"-副本"）、描述、分类等基础信息 |
+| **高级设置** | 除钉钉二维码外全部复制 | 学习模式、人脸识别、提醒、评价、证书、签名等均复制 |
+| **收费设置** | 完整复制 | 价格、试学配置等收费设置一并复制 |
+
+### 不会复制的内容
+
+| 内容 | 原因 |
+|------|------|
+| **钉钉二维码** | 群二维码与具体课程绑定，新课程需重新上传 |
+
+### 复制结果
+
+- 新课程进入 **未发布列表**（status=0）
+- 所有学习进度归零（progress=0）
+- 与原课程数据完全隔离，互不干扰
+- 新课程标题默认追加"-副本"后缀，可手动修改
+
+## 输出标准
+
+```
+⚠️ 课程复制为后台操作，CLI 不支持
+
+操作路径：后台 → 课程管理 → 课程列表 → 找到目标课程 → 操作 → 复制
+
+复制规则：
+  ✅ 会复制：课件(progress=0)、素材、作业、测验(新考试)、基础设置、
+            高级设置(除钉钉二维码)、收费设置
+  ❌ 不复制：钉钉二维码
+
+复制结果：
+  - 新课程进入未发布列表 (status=0)
+  - 所有进度归零
+  - 数据与原课程完全隔离
+```
+
+## 注意事项
+
+1. 复制操作为异步任务，大课程（课件数 > 100）可能耗时较长
+2. 视频素材引用原始文件而非物理复制，不占用额外存储空间
+3. 复制后的课程标题自动追加"-副本"，建议手动修改为目标标题
+4. 复制不携带原课程的学习数据（学习人数、完成率、评价等）
+5. 收费设置虽然复制，但建议检查价格和试学配置是否正确
+6. 作业和测验作为新的独立实体存在，修改副本不影响原课程
+7. 钉钉群二维码需为复制后的课程重新上传
+
+## 检查清单
+
+- [ ] 已告知用户课程复制需后台操作
+- [ ] 已说明复制范围（哪些会/不会复制）
+- [ ] 已提醒复制后进入未发布列表，进度归零
+- [ ] 已提醒钉钉二维码不会复制，需手动补充

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

@@ -0,0 +1,168 @@
+---
+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/multi/soke-course/references/subs/query/SOP.md

@@ -0,0 +1,165 @@
+---
+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