@sokeai/cli 1.0.78 → 1.0.80

package/skills/multi/soke-course/references/intent-cases.md

@@ -1,99 +1,65 @@
-# 意图识别案例库
-
-## create（创建课程）
-
-| # | 用户输入 | 提取 | 上下文 | 路由 |
-|---|---------|------|--------|------|
-| 1 | "帮我创建一门Python数据分析的线上课，放技术培训分类里" | title=Python数据分析, category=技术培训 | 无 course-id | Phase 1 |
-| 2 | "做课：新员工入职培训" | title=新员工入职培训 | 无 course-id | Phase 1（需补充分类） |
-| 3 | "新建一门课" | — | 无 course-id | Phase 1（需补充标题+分类） |
-| 4 | "开课：产品知识" | title=产品知识 | 无 course-id | Phase 1（需补充分类） |
-| 5 | "帮我生成一门关于安全培训的课程" | title=安全培训 | 无 course-id | Phase 1 |
-
-## add_lesson（添加课件）
-
-| # | 用户输入 | 提取 | 上下文 | 路由 |
-|---|---------|------|--------|------|
-| 6 | "给这门课加个视频" + video.mp4 | type=video, file=video.mp4 | course-id 已知 | Phase 2 |
-| 7 | "上传课件" + lesson.pdf | type=document, file=lesson.pdf | course-id 已知 | Phase 2 |
-| 8 | "再传一个音频" + lecture.mp3 | type=audio, file=lecture.mp3 | course-id 已知 | Phase 2 |
-| 9 | "课件排序调整一下" | sort | course-id 已知 | Phase 2 Step 2.5 |
-| 10 | "第一个和第三个课件换一下位置" | sort | course-id 已知 | Phase 2 Step 2.5 |
-
-## settings（设置）
-
-| # | 用户输入 | 提取 | 路由 |
-|---|---------|------|------|
-| 11 | "设置学分 10 分" | credit=10 | Phase 3 |
-| 12 | "修改一下课程描述" | description | Phase 3 |
-| 13 | "把讲师改成张三" | lector=张三 | Phase 3（⚠️ CLI 不支持） |
-| 14 | "换个封面" | cover | Phase 3（⚠️ CLI 不支持） |
-| 15 | "加几个标签" | tags | Phase 3（⚠️ CLI 不支持） |
-
-## advanced（高级设置）
-
-| # | 用户输入 | 提取 | 路由 |
-|---|---------|------|------|
-| 16 | "开启倍速" | is_accelerate=1 | Phase 3（course +advanced） |
-| 17 | "改成解锁式学习" | study_type=2 | Phase 3（course +advanced） |
-| 18 | "开启人脸识别" | open_face_recognition=1 | Phase 3（course +advanced） |
-| 19 | "设置未学提醒，每周推送" | is_remind=1, remind_days=7 | Phase 3（course +advanced） |
-| 20 | "关联证书" | certificate | Phase 3（⚠️ 不支持） |
-
-## charge（收费）
-
-| # | 用户输入 | 提取 | 路由 |
-|---|---------|------|------|
-| 21 | "设置收费 99 元" | charge, price=99 | Phase 3（⚠️ 不支持） |
-| 22 | "开启试看，前两个课件免费" | trial, trial_lessons=2 | Phase 3（⚠️ 不支持） |
-
-## publish（发布）
-
-| # | 用户输入 | 提取 | 路由 |
-|---|---------|------|------|
-| 23 | "发布课程" | publish | Phase 4 |
-| 24 | "上线吧" | publish | Phase 4 |
-| 25 | "定时发布，下周一早上9点" | scheduled, publish_time | Phase 4 |
-| 26 | "提交审批" | approval | Phase 4（⚠️ 不支持） |
-
-## assign（指派）
-
-| # | 用户输入 | 提取 | 路由 |
-|---|---------|------|------|
-| 27 | "指派给研发部" | dept=研发部 | Phase 5 |
-| 28 | "安排张三学习" | user=张三 | Phase 5 |
-| 29 | "全员必修" | compulsory=1, all | Phase 5 |
-| 30 | "设为选修课" | compulsory=0 | Phase 5 |
-
-## query（查询）
-
-| # | 用户输入 | 提取 | 路由 |
-|---|---------|------|------|
-| 31 | "看看学习进度" | progress | Phase 6 |
-| 32 | "谁学完了" | completed | Phase 6 |
-| 33 | "完成率多少" | completion_rate | Phase 6 |
-| 34 | "张三学到哪了" | user=张三 | Phase 6 |
-
-## maintain（维护）
-
-| # | 用户输入 | 提取 | 路由 |
-|---|---------|------|------|
-| 35 | "关闭这门课" | close | Phase 6（course +update --action close） |
-| 36 | "删除课程" | delete | Phase 6（先查 status，仅 0/2 可删） |
-| 37 | "复制这门课，叫 V2.0" | copy, title=V2.0 | Phase 6（⚠️ 不支持） |
-| 38 | "批量发布这几门" | batch, publish | Phase 6（⚠️ 不支持） |
-
-## 歧义消解案例
-
-| # | 用户输入 | 情况 | 处理 |
-|---|---------|------|------|
-| 39 | "上传一下" | 没有课程上下文，没有附件 | 询问: 你要上传课件到哪门课？还是先创建新课程？ |
-| 40 | "帮我看看" | 没有课程上下文 | 列课程列表让用户选 |
-| 41 | "设置一下" | 有 course-id 但不清楚要设什么 | 列设置选项：基础设置/高级设置/收费设置 |
-
-## 关键提取规则
-
-1. **有 course-id 上下文** → 在当前课程操作，不创建新课程
-2. **有文件附件** → 倾向课件上传意图
-3. **无 course-id + 无附件 + 无明确操作** → 列出课程让用户选
-4. **创建词 + 无 course-id** → 走 Phase 1 全流程
+# 意图识别案例库（v6）
+
+## create
+
+| 用户输入 | 提取 | 路由 |
+|---------|------|------|
+| "帮我创建一门Python数据分析的线上课，放技术培训分类里" | title+category | Phase 1 |
+| "做课：新员工入职培训" | title | Phase 1（补分类弹窗） |
+| "新建一门课" | — | Phase 1（补标题+分类） |
+
+## add_lesson（含类型选择）
+
+| 用户输入 | 提取 | 路由 |
+|---------|------|------|
+| "给这门课加个视频" + video.mp4 | type=video | 2.0→视频链 |
+| "上传课件" + lesson.pdf | document | 2.0→文档链 |
+| "加几张产品图" + *.png | photo | 2.0→2.7 photo 链 |
+| "加个小测验" | exam | 2.0→2.6 出题方式弹窗 |
+| "用安全考试卷一做个测验" | paper-title | 2.6.2a 引用 |
+| "这份试题表做成测验" + .xlsx | 导入试卷 | 2.6.2b 建题链 |
+| "第一个和第三个课件换位置" | sort | 2.5 `+lesson-sort --sort-list` |
+
+## settings
+
+| 用户输入 | 路由 |
+|---------|------|
+| "设置学分 10 分" | +update --credit（CLI ✅） |
+| "换个封面" + 图片 | photo 链取 photoUri → +update --image（CLI ✅，v6 修正） |
+| "换个封面"（无图） | photo +list 选已有 → photoUri |
+| "把讲师改成张三" / "加标签" | ⚠️ 后台（lector/tags 无 CLI） |
+| "开启倍速/人脸识别/未学提醒" | +advanced（CLI ✅） |
+| "设置收费 99 元" | ⚠️ 后台（subs/charge 话术） |
+
+## publish / maintain
+
+| 用户输入 | 路由 |
+|---------|------|
+| "发布/上线吧" | Phase 4 |
+| "定时发布，下周一早上9点" | +publish --publish-time |
+| "关闭这门课" | `+update --action close`（CLI ✅，v6 修正；弹窗确认） |
+| "删除课程" / "复制这门课" | ⚠️ 后台话术 |
+| "提交审批" | ⚠️ 后台话术 |
+
+## assign / query
+
+| 用户输入 | 路由 |
+|---------|------|
+| "指派给研发部，必修" | Phase 4 |
+| "看看学习进度/谁学完了/完成率" | 未指定课程先 `+list-courses --status 1 --page-size 20` 展示前 20 个；选定后进入 Phase 5 query |
+| "作业都谁交了" | clock 链 |
+
+## 歧义消解
+
+| 用户输入 | 处理 |
+|---------|------|
+| "上传一下"（无课程无附件） | 弹窗：上传到哪门课？还是新建？ |
+| "创建课程"（无标题） | 先登录检查，再拉取真实一级分类列表；不得直接展示占位分类或空的 B 表格 |
+| "帮我看看" | `+list-courses` 弹窗选 |
+| "设置一下" | 弹窗：基础/高级/收费 |
+
+## 提取规则
+
+1. 有 course-id → 当前课程操作，不新建；
+2. 有附件 → 倾向课件（按扩展名定类型：图片→photo，xlsx/docx 试题表→exam 导入，其余→素材）；
+3. 创建词 + 无 course-id → Phase 1。

package/skills/multi/soke-course/references/sop-full-workflow.md

@@ -1,177 +1,81 @@
-# 全流程 SOP — Phase 1-6 详细操作
-
-## Phase 1: 创建课程骨架
-
-### Step 1.1: 权限检查
-  目标: 确认用户已登录且有创建课程权限
-  自身: soke-cli config show
-  输出: 登录状态
-  失败: 引导 soke-cli auth login
-
-### Step 1.2: 获取分类
-  读取: subs/category/SOP.md 执行
-  输入: 用户指定的分类关键词（可选）
-  操作:
-    用户指定名称 → course +list-categories → 精确匹配 → 模糊匹配 → 列全部
-    用户不指定 → 列出所有 → 让用户选
-    "随便" → 取第一个
-    无分类 → 提示创建（⚠️ CLI 不支持 → 告知后台路径）
-  提取: category-id → 存上下文
-  失败: 列所有分类让用户手动选
-
-### Step 1.3: 创建课程
-  自身: course +create --title "xxx" --category-id "xxx"
-  可选: --description "..."
-  提取: course-id + title + category + status → 存上下文
-  失败: 检查标题长度、分类 UUID 有效性
-
-Gate 1→2: ✅ course-id 非空
-
----
-
-## Phase 2: 构建课件
-
-### Step 2.1: 选择素材来源
-  → `ask_user_question` 弹窗: "从哪儿添加课件素材？" → ["📁 本地上传"/"📚 素材库选择"]
-  选"本地上传" → 进入 Step 2.2
-  选"素材库选择" → 进入 Step 2.2b
-
-### Step 2.2: 本地上传
-  调度: soke-material
-  告知: 可上传视频(.mp4/.avi/.mov/.mkv/.webm)、音频(.mp3/.wav/.ogg/.flac/.aac)、文档(.pdf/.ppt/.pptx/.doc/.docx/.xls/.xlsx)
-  ⚠️ 不支持 CLI: 图片/文章/外链/小测验/作业 → 告知后台路径
-  输入: 本地文件路径
-  操作: file +upload --path <path>（自动根据扩展名判断类型）
-  输出: { uuid, filename, type, ext, filesize, object }
-  提取: media-id + 全字段 → 存 media_ids[] 数组
-  失败: 检查文件存在/格式/大小
-  → 进入 Step 2.3
-
-### Step 2.2b: 素材库选择
-  调度: soke-material
-  操作: file list-files --page-size 100（分页拉取）
-  展示: 文件名 / 类型 / 大小 / 日期（截取前 20-50 条）
-  告知: "输入关键词搜索素材，或输入序号选择"
-  用户输入:
-    - 关键词 → 模糊匹配文件名 → 弹窗列匹配项
-    - 序号 → 直接确认该素材
-  提取: 全字段 → 存 media_ids[]
-  无匹配: 弹窗 "素材库中没找到，切到本地上传？" → ["切本地上传"/"重新搜索"]
-  选"切本地上传" → 回到 Step 2.2
-  → 进入 Step 2.3
-
-### Step 2.3: 创建课件
-  调度: soke-lesson
-  输入: course-id + 所有 Step 2.2 字段 + 自定义 title
-  操作: course +lesson-create --course-id <uuid> --title "..." --media-id <uuid> --type video|audio|document --length <s> --object "..." --filename "..." --ext "..." --filesize <bytes>
-  输出: { uuid, title, type, transcode_status }
-  提取: lesson-id → 存 lesson_ids[] 数组
-
-### Step 2.4: 循环
-  询问: "还要加课件吗？"
-  是 → 回到 Step 2.1
-  否 → 进入 Step 2.5
-
-### Step 2.5: 排序（可选）
-  询问: "要调整课件顺序吗？"
-  是 → 调度 soke-lesson 排序
-  否 → 进入 Phase 3
-
-Gate 2→3: ✅ lesson_ids 长度 ≥ 1
-
----
-
-## Phase 3: 课程设置
-
-### Step 3.1: 基础设置
-  读取: subs/settings/SOP.md 执行
-  输入: course-id + 要修改的字段
-  操作: course +update --course-id <uuid> --title "..." --description "..."
-  成功: 更新后数据
-  失败: 检查字段有效性
-
-### Step 3.2: 高级设置
-  调度: soke-course-settings
-  操作: course +advanced --course-id <uuid> ...
-  支持: 学习模式/待办推送/截止后学习/人脸识别/学习中人脸识别/未学提醒/倍速/拖动/评价/交流群二维码/文档防挂机/评论
-  交流群二维码: 用户给本地图片时，使用 course +advanced --image-file <path>，命令内部只上传 OSS 并生成 imageOssUrl，不进入图片库
-  证书/签名仍需后台操作。
-
-### Step 3.3: 收费设置（可选）
-  读取: subs/charge/SOP.md 执行
-  全部 ⚠️ CLI 不支持:
-    "收费设置（价格/试看）需在后台→课程编辑→收费设置中手动配置。"
-
-Gate 3→4: 无硬阻塞（设置可跳过）
-
----
-
-## Phase 4: 发布
-
-### Step 4.1: Gate Check
-  读取: subs/publish/SOP.md 执行
-  检查项:
-    ① 标题非空 — course +get-course → title
-    ② 分类已选 — course +get-course → category_id
-    ③ 课件 ≥ 1 — course +lesson-list → count
-    ④ 无转码失败 — course +lesson-list → 逐条 transcode_status
-    ⑤ 无转码中 — course +lesson-list → 逐条（警告）
-  结果:
-    全部通过 → 执行发布
-    阻塞项 → 列出 + 修复指引，停止
-    仅警告 → 询问是否忽略
-
-### Step 4.2: 执行发布
-  直接发布: course +publish --course-id <uuid>
-  定时发布: course +publish --course-id <uuid> --publish-time "<北京时间>"
-  提取: 发布状态 → 存上下文
-  失败: 检查 Gate Check 结果
-
-### Step 4.3: 后续（可选）
-  审批/批量 → ⚠️ CLI 不支持 → 告知后台路径
-
-Gate 4→5: ✅ status=1
-
----
-
-## Phase 5: 指派学员
-
-### Step 5.1: 拉取全量部门
-  调度: soke-assign
-  exec: soke assign +list-departments
-  提取: 全量部门名称+ID → 存内存（供模糊搜索用）
-
-### Step 5.2: 用户输入关键词搜索部门
-  告知: "请输入要指派的部门名称（支持模糊搜索）"
-  用户输入关键词 → 在部门列表中模糊匹配（不区分大小写、部分匹配）
-  匹配结果:
-    - 唯一匹配 → 直接确认使用
-    - 多个匹配 → `ask_user_question` 弹窗列出匹配项让用户选
-    - 无匹配 → 建议换关键词，或弹窗列所有部门
-
-### Step 5.3: 确认指派方式
-  → `ask_user_question` 弹窗: "必修还是选修？" → ["必修"/"选修"]
-
-### Step 5.4: 执行指派
-  调度: soke-assign
-  操作: assign +create --module course --module-id <uuid> --compulsory 1|0 --user-ids "<ids>"
-  输出: 指派 UUID + 指派人数
-  通知: "已指派 N 人，学员将收到学习通知"
-
----
-
-## Phase 6: 运营维护
-
-### Step 6.1: 查询进度
-  读取: subs/query/SOP.md 执行
-  操作: course +list-course-users / +get-course-user / +list-lesson-learns / +list-lesson-faces
-
-### Step 6.2: 关闭/删除
-  读取: subs/publish/SOP.md 执行
-  关闭: course +update --course-id <uuid> --action close
-  删除: 先查 status，仅 status=0 未发布或 status=2 已关闭时执行 course +delete --course-id <uuid>
-  阻塞: status=1 已发布课程不能直接删除，先关闭再删除
-
-### Step 6.3: 复制（⚠️ CLI 不支持）
-  读取: subs/copy/SOP.md 执行
-  告知: "课程复制需在后台→已发布/已关闭列表→复制中操作"
+# 全流程 SOP — Phase 1-5 详细操作
+
+> 命令参数以 cli-facts.md 为准；交互按 SKILL.md 编码方案（A-H）；本文件只定义步骤与提取项。单课程首轮同时罗列标题输入、课件来源、分类和模板；批量课程按批量流程分步收集。
+
+## Phase 1 创建课程骨架
+
+### Step 1.1 权限检查（结构性）
+`command -v soke-cli` 缺 → read soke-cli-install-guide.md 引导安装。
+`soke-cli config show` 无「用户凭证」→ `soke-cli auth login`（浏览器人工）→ 回查。
+
+### Step 1.2 分模式收集（编码）
+模式按上下文路由：已有 `course-id` 直接进入当前课程操作；已提供目录路径进入批量课程；已提供单个文件或课程标题进入单课程。仅意图无法判断时才弹出模式选择。
+单课程首轮必须严格按以下顺序输出：
+1. `请输入你要上传的课程标题：`
+2. `A 课件来源`及选项表；
+3. `B 课程分类（一级 · 第 X/Y 页）`及真实分类表；
+4. 分类提示：`回复「搜索 XX」可模糊匹配；"下一页"翻页（当前仅第 X/Y 页）。如需新分类请后台新建后回「分类建好了」。`；
+5. `C 课程模板`及模板表；
+6. 输入提示：请直接提供课程标题、课件来源、分类和模板；本地上传时同时提供文件路径，也可拖入文件。
+分类和模板表中的编码必须放在名称前；允许一次提供标题、A/B/C选项，也允许分多次补充。
+批量课程：按 B0-B3 分步收集分类、模板和目录路径，不要求单独课程标题。
+分类列表：一级、10 个/页，支持“搜索XX”和“下一页”；表格下方固定提示「如果没有找到需要的分类，请回复“搜索XX”搜索，或回复“下一页”查找」。
+分类：展示分类树并优先让用户选择末级分类；用户回 B 编号/名称 → 提取 category-id；不得默认使用一级分类；名称唯一匹配直接用。
+
+### Step 1.3 创建课程
+创建前按「标题 + 分类 + 当前未发布状态」查重；疑似重复时列出课程 ID 和状态，等待用户选择复用或继续创建。确认无重复后执行 `course +create --title "xxx" --category-id "xxx" [--description]`。
+提取 course-id + title + status → **未提取禁止下一步**。
+
+### Step 1.4 模板（编码 C）
+C1-C6 → read subs/template/SOP.md，立即执行 CLI 支持的 `course +advanced` 固定映射；输出「设置项｜值｜状态」表，后台项标记待后台配置；C7 → 跳过。高级设置写入失败时停止，不进入课件上传。
+
+Gate 1→2：course-id 非空。
+
+## Phase 2 构建课件
+
+### Step 2.1-2.3 来源 A
+A1 本地：read subs/material → `file +upload --file <path>` → 非图片字段对象；
+A2 素材库：`file list-files --page-size 20` → 展示编号列表（20 个/页、「下一页」翻页、「搜索 XX」搜索）→ 回编号 → 全字段；无匹配 → 提示改 A1 或重搜；
+类型按扩展名自动判（视频/音频/文档/图片），图片统一走 subs/photo 链；
+read subs/lesson → `course +lesson-create` → 提取 lesson-id；图片不得套用 file +upload 六字段规则。
+
+### Step 2.4 小测验 D
+课件完成后问「加小测验吗？回复 D1 加 / D2 不加」；
+D1 → 「出题方式：H1 选择试卷 / H2 导入试卷」；
+H1 引用：先拉取前 20 份试卷，并在当前对话中直接用 Markdown 表格罗列，不使用弹窗；不得在远程页面、远程课程界面或平台内容中展示试卷列表；表格下方固定提示「回复“搜索 XX”可模糊匹配；“下一页”翻页（当前仅 1 页）。」用户回复编号或名称后，执行 `course +lesson-create --type exam --title "<测试名称>" --paper-title "<关键词>"`（或 --paper-id）[--minute --second]；
+H2 上传：read subs/exam/SOP.md 全链 → 挂载。小测验导入或挂载成功后，必须立即进入 Phase 4，弹出“指派课程 + 发布课程”条件选择，不得只输出导入成功状态。
+
+### Step 2.5 排序
+默认不问；用户说"调顺序" → `course +lesson-sort --sort-list "id1,id2"`。
+
+Gate 2→3：`+lesson-list` count ≥ 1。
+
+## Phase 3 课程设置（默认展示摘要）
+课件完成后默认展示一次设置摘要表（基础：标题/分类/学分/描述/封面；高级：学习模式/倍速/拖动/人脸/提醒/评价/防挂机/评论/二维码）；
+用户回复修改项 → CLI 项立即 `+update`/`+advanced`，后台项「已记录→后台路径」；回复「继续」→ 跳过。
+收费 read subs/charge 后台话术。封面新图走 photo 链。
+Gate 3→4：无硬阻塞。
+
+## Phase 4 指派 + 发布（最后一步，条件弹窗）
+4.0 指派弹窗：询问「是否需要将课程指派给学员？」；选项固定为「1. 指派（推荐）」「2. 不指派」。选 1 后再选择指派对象和学习类型；选 2 不出现学习类型问题。
+
+指派完成并通过 Gate Check 后，发布弹窗询问「是否确认发布这门课程？」；选项固定为「1. 发布」「2. 不发布」。仅选 1 执行发布。
+4.1 G1 → 弹窗2 两问：[指派对象 部门/人员 ｜ 学习类型 F1/F2]；选择部门后先 `+list-departments` 递归拉全树，再用原生选择弹窗罗列部门名称、成员数和 ID，用户选定后传 `--dept-ids` + `--dept-names` 执行 `assign +create --learn-type`；人员→`+list-users --keyword` 编号选；`+list` 回查；G2 → 不出现 F 问；
+4.2 Gate Check 6 项（subs/publish + sop-publish-check）→ 🔴列阻塞停止；仅 🟡 才允许用户确认继续。转码中/失败不得发布。
+4.3 用户回复 E1 后，必须重新获取课程、课件和指派状态并再次 Gate Check；若状态发生变化，旧确认失效，重新展示确认。仅二次检查通过后执行 `course +publish --course-id <id> [--publish-time "北京时间"]`，禁止代发布；直接发布回查 status==1，定时发布回查 publish_time。审批/批量 → 后台话术。
+
+## 批量生成课程（batch）
+
+B0 Step 1.0 模式弹窗选「批量生成课程」。
+B1 分类+模板同单课程（C 表带设置两列）；+advanced 映射逐课生效。
+B2 文本收批量目录路径。
+B3 扫描只访问二级：一级文件夹→课程名=文件夹名、课件=其内支持文件；一级文件→课程名=文件名、课件=该文件；扩展名大小写不敏感；默认不跟随符号链接、忽略隐藏文件；不支持扩展名跳过并备注；空目录、无支持课件、无权限或同名冲突必须阻止确认并要求修改计划。
+B4 先展示批量计划表（课程名｜课件数｜课件列表），再使用原生二选一弹窗询问「确认批量上传」或「返回修改计划」；仅用户选择「确认批量上传」后执行。
+B5 逐课：+create → 逐文件 +upload → +lesson-create（六字段）→ +advanced；**无小测验**；每门课、每个文件分别记录状态并逐课输出进度。单门失败保留已产生的 ID，继续其他课程；超时先回查，禁止盲目重试。
+B6 一次弹窗三问（G/F/E）对全部课程生效；E1 → 每门课重新查询状态并再次 Gate Check，通过后才发布。
+B7 输出批量结果表（课程｜course-id｜课件数｜指派｜发布状态｜失败动作｜是否可重试），提供失败课程的可恢复位置。每个动作至少记录 course-id、文件路径、lesson-id（如有）、动作状态、错误信息和重试标记。
+
+## Phase 5 运营维护
+查询 read subs/query/SOP.md：`+list-course-users` / `+get-course-user` / `+list-lesson-learns` / `+list-lesson-faces --target-id` / clock 三命令（作业）。
+关闭：`course +update --action close`（⚠️ 文本确认「回复'确认关闭'」；被学习地图关联则不可关闭 → 后台移除）。
+删除/复制：后台话术（read subs/copy/SOP.md 讲复制规则）。

package/skills/multi/soke-course/references/sop-lesson-types.md

@@ -1,66 +1,29 @@
-# 课件类型创建 SOP
+# 课件类型 SOP（v6 实测修正）
 
-## 支持的课件类型（CLI 可用）
+## CLI 可创建的类型（5 种）
 
-### video（视频课件）
+| 类型 | 判断 | 链路 |
+|------|------|------|
+| video | .mp4/.avi/.mov/.mkv/.webm | file +upload → lesson-create --type video |
+| audio | .mp3/.wav/.ogg/.flac/.aac | 同上 audio（length 默认300） |
+| document | .pdf/.ppt/.pptx/.doc/.docx/.xls/.xlsx | 同上 document（无需转码） |
+| photo_gallery | .jpg/.jpeg/.png 等 | photo-gallery +create → lesson-create --type photo_gallery --media-id（**v6：CLI 支持，旧文档作废**） |
+| exam | 用户提"测验/试卷" | 选择试卷(--paper-title/--paper-id) 或 导入试卷(subs/exam 建题链) |
 
-**判断**: 文件后缀 .mp4|.avi|.mov|.mkv|.webm|.flv|.wmv
+高级配置（视频积分/下载开关/弹题等）⚠️ 后台→课件编辑。
 
-**流程**:
-1. 调度 soke-material → file +upload --file <video.mp4>
-2. 提取: { uuid, filename, type: "video", ext, filesize, object }
-3. 调度 soke-lesson → course +lesson-create --type video --length <秒> ...（参数全部来自步骤2）
+## CLI 不可创建（后台话术）
 
-**配置项**（⚠️ CLI 暂不支持）:
-- 积分设置（完成获得）
-- 下载开关
-- 弹出学习格言
-- 弹出测试题（1-5个节点，按视频时长百分比）
-- 观看监控提示语
-→ 告知用户: "视频课件的高级配置需在后台→课件编辑中设置"
+| 类型 | 话术要点 |
+|------|---------|
+| article 文章 | 后台→课程编辑→添加课件→手动添加文章 |
+| link 外链 | 后台→添加外链 |
+| SCORM / HTML | 后台对应入口 |
+| homework 作业 | 后台→作业（三种审批：无需批改/PC批改/移动端多级）；查询走 clock |
 
-### audio（音频课件）
+quiz 小测验课件 = exam 类型，CLI 可挂载（需已有试卷）。
 
-**判断**: .mp3|.wav|.ogg|.flac|.aac|.wma|.m4a
+## 上传规则
 
-**流程**: 同 video，type=audio，默认 length=300s
-
-### document（文档课件）
-
-**判断**: .pdf|.ppt|.pptx|.doc|.docx|.xls|.xlsx|.txt
-
-**流程**: 同 video，type=document，默认 length=0s
-
----
-
-## 不支持 CLI 的课件类型（告知后台路径）
-
-### image（图片课件）
-**判断**: .jpg|.jpeg|.png|.gif|.webp|.bmp|.svg
-**话术**: "图片课件暂不支持 CLI 创建。你可以先把图片上传到 photo-gallery，然后在后台→课程编辑→添加课件→选择图片库中操作。一张图片一个课件，无数量上限。"
-
-### article（文章课件）
-**判断**: 用户输入纯文本 + 提到"文章"
-**话术**: "文章课件暂不支持 CLI 创建。请在后台→课程编辑→添加课件→手动添加文章中编辑。"
-
-### link（外链课件）
-**判断**: 用户输入含 http:// 或 https:// + 提到"链接"/"外链"
-**话术**: "外链课件暂不支持 CLI 创建。请在后台→课程编辑→添加课件→添加外链中操作。"
-
-### quiz（小测验课件）
-**判断**: 用户提到"测验"/"试卷"/"小测验"
-**话术**: "小测验课件暂不支持 CLI 创建。你可以先用 soke-exam skill 创建试卷，然后到后台→课程编辑→添加课件→小测验中关联试卷。注意：小测验仅支持客观题（单选/多选/判断），不限次数的测验必须通过才能记录进度。"
-
-### homework（作业课件）
-**判断**: 用户提到"作业"/"批改"
-**话术**: "作业课件暂不支持 CLI 创建。请在后台→课程编辑→添加课件→作业中操作。作业支持三种审批方式：①无需批改（提交自动记录进度）②PC后台批改③移动端多级审批（按人员/角色/主管审批，或签/会签）。"
-
----
-
-## 课件上传规则
-
-- 上传文件自动转存素材库
-- 都需经阿里云转码
-- 转码中/失败 → 不能发布课程
-- 上传失败时提示具体原因（文件超大小、格式不对）
-- 发布后删减课件：对未完成进度有影响，已完成无影响
+- 上传自动转存素材库；视频/音频经阿里云转码，转码失败🔴阻塞发布、转码中🟡可确认发布；文档无需转码；
+- 发布后删减课件：未完成进度受影响，已完成无影响（删除需后台）。

package/skills/multi/soke-course/references/sop-publish-check.md

@@ -1,76 +1,19 @@
-# 发布前置 Gate Check 完整矩阵
+# 发布/关闭 Gate Check 矩阵（唯一定义）
 
-## 校验清单
+> 本文件为闸门矩阵唯一事实源；SKILL.md 与 subs/publish 均引用此处。四要素：检查项/获取方式/严重度/不通过处理。
 
-| # | 检查项 | 获取方式 | 严重度 | 不通过时提示 | 修复指引 |
-|---|--------|---------|--------|-------------|---------|
-| 1 | 课程标题非空 | `course +get-course` → `data.title` | 🔴 阻塞 | "课程标题不能为空" | 执行 `course +update --title "新标题"` |
-| 2 | 课程分类已选 | `course +get-course` → `data.category_id` | 🔴 阻塞 | "课程分类不能为空" | 先查分类 `+list-categories`，再 `+update --category-id` |
-| 3 | 课件数量 ≥ 1 | `course +lesson-list` → `data.list.length` | 🔴 阻塞 | "课程至少需要 1 个课件才能发布" | 进入 Phase 2 添加课件 |
-| 4 | 所有课件无转码失败 | `course +lesson-list` → 逐条检查 `.transcode_status` | 🔴 阻塞 | "课件 [X] 转码失败，请删除后重新上传" | 删除失败课件，重新上传素材 |
-| 5 | 所有课件无转码中 | `course +lesson-list` → 逐条检查 `.transcode_status` | 🟡 警告 | "课件 [X] 还在转码中，发布后学员暂时看不到该课件。确认发布吗？" | 可忽略警告继续，或等转码完成 |
-| 6 | 课程未被学习地图关联（关闭时） | 需在后台检查 | 🟡 警告 | "该课程被学习地图关联，无法关闭" | 先在学习地图中移除此课程 |
+| # | 检查项 | 获取方式 | 严重度 | 不通过处理 |
+|---|--------|---------|--------|-----------|
+| 1 | 标题非空 | `+get-course` → title | 🔴 | `+update --title` |
+| 2 | 分类已选 | `+get-course` → category_id | 🔴 | `+list-categories` 后 `+update --category-id` |
+| 3 | 课件 ≥ 1 | `+lesson-list` count | 🔴 | 回 Phase 2 |
+| 4 | 无转码失败 | `+lesson-list` 逐条 transcode_status | 🔴 | 删失败课件重传 |
+| 5 | 无转码中 | 同上 | 🟡 | 弹窗确认（发布后学员暂不可见） |
+| 6 | 付费方式已确认 | 询问用户 | 🟡 | 收费需后台配置，确认免费或已配置 |
+| 7 | 关闭时：无学习地图关联 | 后台确认 | 🟡(关闭) | 先在学习地图移除该课程 |
 
-## 校验流程
+流程：全过→执行；有🔴→列阻塞+修复指引→停止；仅🟡→弹窗确认。
 
-```
-开始 Gate Check
-    │
-    ▼
-逐项检查 ①-⑥
-    │
-    ├── 全部通过 → 执行发布
-    │
-    ├── 有 🔴 阻塞项 → 列出所有阻塞项 + 每项修复指引 → 停止发布
-    │
-    └── 仅 🟡 警告 → 列出警告 → 询问: "有 X 项警告，确认继续发布吗？"
-                         ├── 确认 → 执行发布
-                         └── 取消 → 先处理警告项
-```
+转码状态码：success ✅ / transcoding|pending 🟡 / failed 🔴。文档课件不参与 4、5。
 
-## 转码状态码对照
-
-| 状态值 | 含义 | 能否发布 |
-|--------|------|---------|
-| success | 转码成功 | ✅ |
-| transcoding | 转码中 | ⚠️ 可忽略警告发布，但学员暂时看不到 |
-| failed | 转码失败 | ❌ 阻塞，必须删除重传 |
-| pending | 待转码 | ⚠️ 同 transcoding |
-
-## 发布后验证
-
-发布后执行:
-1. `course +get-course --course-id <uuid>` → 确认 `status == 1`
-2. `course +lesson-list --course-id <uuid>` → 确认课件状态
-
-## 审批流程（⚠️ CLI 暂不支持）
-
-- 默认关闭
-- 开启后: 未发布课程需审批才能发布
-- 审批通过 → 发布成功
-- 审批驳回 → 修改后可重新提交
-- 审批人为空 → 默认通过
-- 多级审批: 一级不可删除，默认主管理员和或签
-
-## 定时发布
-
-- 执行: `course +publish --course-id <uuid> --publish-time "<北京时间>"`
-- 输入北京时间，会在规定时间发布课程
-- 到时间点自动发布并推送消息
-- 未到点时学员收不到消息、前端看不到
-
-## 批量操作（⚠️ CLI 暂不支持）
-
-- 批量发布: 跨页最多选 40 条
-- 批量指派: 增量不是替换
-
-## 课程状态流转
-
-```
-上传 → 上传成功 → 转码中 → 未发布(status=0) → 发布(status=1)
-                                                  ↕
-                                              已关闭(status=2)
-上传 → 上传失败（可修改重试）
-转码 → 转码失败（可删除重传）
-未发布 → 编辑/删除/提交审批
-```
+发布后验证：`+get-course` status==1；`+lesson-list` 课件状态。