@sokeai/cli 1.0.79 → 1.0.80

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

@@ -1,291 +1,45 @@
-# 授客课程管理 Skill
-
-完整的课程生命周期管理，集成素材库和课件管理子 skills，提供模块化的课程内容管理。
-
-## 普通用户文档
-
-
-## 功能概述
-
-这个 skill 提供了完整的课程管理功能，包括：
-
-- 📚 **课程管理**: 创建、更新、发布、查询课程
-- 🏷️ **分类管理**: 查询和管理课程分类
-- 📦 **素材管理**: 集成 soke-material skill，管理素材库
-- 📝 **课件管理**: 集成 soke-lesson skill，管理课程课件
-- 👥 **学习记录**: 查询用户的课程学习记录
-- 📊 **学习统计**: 查询课件学习记录和人脸识别记录
-
-## 集成的子 Skills
-
-### 📦 soke-material - 素材库管理
-负责文件上传和素材管理
-- [详细文档](../soke-material/MODULE.md)
-
-### 📚 soke-lesson - 课件管理
-负责课件的创建和管理
-- [详细文档](../soke-lesson/MODULE.md)
-
-## 快速开始
-
-### 创建课程
-
-```bash
-# 1. 查询课程分类，获取 category-id
-soke-cli course +list-categories
-
-# 2. 创建课程（使用上一步获取的 category-id）
-soke-cli course +create --title "Go语言入门" --category-id "CATEGORY-UUID"
-
-# 3. 上传素材
-soke-cli file +upload --file ./lesson1.mp4
-
-# 4. 创建课件
-soke-cli course +lesson-create \
-  --course-id "COURSE-UUID" \
-  --title "第一课" \
-  --media-id "MATERIAL-UUID" \
-  --type "video" \
-  --length 600 \
-  --object "path/to/file.mp4" \
-  --filename "lesson1.mp4" \
-  --ext "mp4" \
-  --filesize 10485760
-
-# 5. 发布课程
-soke-cli course +publish --course-id "COURSE-UUID"
-```
-
-### 查询课程
-
-```bash
-# 查询课程列表
-soke-cli course +list-courses
-
-# 查询课程详情
-soke-cli course +get-course --course-id "COURSE-UUID"
-
-# 查询课程分类
-soke-cli course +list-categories
-
-# 查询课程学习记录
-soke-cli course +list-course-users --course-id "COURSE-UUID"
-```
-
-## 主要命令
-
-### 课程管理
-| 命令 | 说明 |
-|------|------|
-| `+list-categories` | 查询课程分类（获取 category-id） |
-| `+create` | 创建课程基本信息 |
-| `+update` | 更新课程信息 |
-| `+delete` | 删除未发布或已关闭课程 |
-| `+advanced` | 更新课程高级设置 |
-| `+publish` | 发布课程 |
-| `+get-course` | 查询课程详情 |
-| `+list-courses` | 查询课程列表 |
-
-### 课件管理（soke-lesson）
-| 命令 | 说明 |
-|------|------|
-| `+lesson-create` | 创建课件 |
-| `+lesson-get` | 查询课件详情 |
-| `+lesson-list` | 查询课件列表 |
-
-### 素材管理（soke-material）
-| 命令 | 说明 |
-|------|------|
-| `file +upload` | 上传文件到素材库 |
-| `file +list-files` | 查询素材列表 |
-| `file +get-info` | 查询素材详情 |
-
-### 学习记录
-| 命令 | 说明 |
-|------|------|
-| `+list-course-users` | 查询课程学习记录 |
-| `+get-course-user` | 查询用户学习详情 |
-| `+list-lesson-learns` | 查询课件学习记录 |
-| `+list-lesson-faces` | 查询人脸识别记录 |
-
-## 使用场景
-
-### 场景1: 创建课程
-
-适用于需要精细控制每个步骤的场景：
-
-```bash
-# 1. 查询课程分类，获取 category-id
-soke-cli course +list-categories
-
-# 2. 创建课程（使用上一步获取的 category-id）
-course_id=$(soke-cli course +create \
-  --title "Python数据分析实战" \
-  --category-id "CATEGORY-UUID" \
-  --format json | jq -r '.data.uuid')
-
-# 3. 批量上传素材
-for file in ./lessons/*.mp4; do
-  media_id=$(soke-cli file +upload --file "$file" --format json | jq -r '.data.uuid')
-  
-  # 4. 创建课件
-  soke-cli course +lesson-create \
-    --course-id "$course_id" \
-    --title "$(basename "$file" .mp4)" \
-    --media-id "$media_id" \
-    --type "video" \
-    --length 600 \
-    --object "path/to/$(basename "$file")" \
-    --filename "$(basename "$file")" \
-    --ext "mp4" \
-    --filesize $(stat -f%z "$file")
-done
-
-# 5. 发布课程
-soke-cli course +publish --course-id "$course_id"
-
-# 或定时发布课程，输入北京时间
-soke-cli course +publish \
-  --course-id "$course_id" \
-  --publish-time "2026-07-14 17:24:42"
-```
-
-### 场景2: 管理现有课程
-
-```bash
-# 查询课程列表
-soke-cli course +list-courses --status 1
-
-# 获取课程详情
-soke-cli course +get-course --course-id "COURSE-UUID"
-
-# 查询课程的课件
-soke-cli course +lesson-list --course-id "COURSE-UUID"
-
-# 更新课程信息
-soke-cli course +update \
-  --course-id "COURSE-UUID" \
-  --title "新标题" \
-  --description "新描述"
-
-# 删除未发布或已关闭课程
-soke-cli course +delete --course-id "COURSE-UUID"
-
-# 添加新课件
-media_id=$(soke-cli file +upload --file ./new-lesson.mp4 --format json | jq -r '.data.uuid')
-soke-cli course +lesson-create \
-  --course-id "COURSE-UUID" \
-  --title "新增课件" \
-  --media-id "$media_id" \
-  --type "video" \
-  --length 600 \
-  --object "path/to/new-lesson.mp4" \
-  --filename "new-lesson.mp4" \
-  --ext "mp4" \
-  --filesize 10485760
-```
-
-### 场景3: 统计课程完成情况
-
-```bash
-# 1. 获取课程列表
-soke-cli course +list-courses
-
-# 2. 查询某个课程的学习记录
-soke-cli course +list-course-users --course-id "COURSE-UUID"
-
-# 3. 查询课件学习记录
-soke-cli course +list-lesson-learns --lesson-id "LESSON-UUID"
-```
-
-## 参数说明
-
-### 时间参数
-
-所有时间参数使用 Unix 时间戳（毫秒）格式：
-
-```javascript
-// JavaScript 示例
-const startTime = new Date('2024-01-01').getTime(); // 1704038400000
-const endTime = new Date('2024-12-31').getTime();   // 1735660799000
-```
-
-### 状态参数
-
-**课程状态 (status)**:
-- `0`: 未发布
-- `1`: 已发布
-- `2`: 已关闭
-
-**课程来源 (is-in)**:
-- `0`: 外部课列表
-- `1`: 内部课列表
-
-**学习模式 (study_type)**:
-- `1`: 自由式（可任意顺序学习）
-- `2`: 解锁式（必须按顺序学习）
-
-## 注意事项
-
-1. **课程发布要求**: 课程至少需要一个课件才能发布
-2. **分类必填**: 创建课程时必须指定分类ID
-3. **素材先行**: 创建课件前必须先上传素材到素材库
-4. **类型匹配**: 课件类型必须与素材类型匹配
-5. **权限要求**: 需要相应的读写权限（`course:*:write` 或 `course:*:readonly`）
-6. **认证要求**: 所有命令都需要先完成 `soke-cli auth login`
-
-## 错误处理
-
-### 权限不足
-
-```bash
-# 错误信息: Permission denied
-# 解决方案: 检查是否已登录，并确认账号有相应权限
-soke-cli auth login
-```
-
-### 时间范围超限
-
-```bash
-# 错误信息: Time range exceeds 365 days
-# 解决方案: 缩小时间范围或分批查询
-```
-
-### 数据不存在
-
-```bash
-# 错误信息: Course not found
-# 解决方案: 检查课程ID是否正确
-```
-
-## 相关文档
-
-- [SKILL.md](./MODULE.md) - 完整的 Skill 文档和 API 参考
-- [素材库管理 Skill](../soke-material/MODULE.md) - 文件上传和素材管理
-- [课件管理 Skill](../soke-lesson/MODULE.md) - 课件创建和管理
-- [共享配置 Skill](../soke-shared/MODULE.md) - 认证和配置管理
-
-## Skill 架构
-
-```
-soke-course (主 skill)
-├── 课程管理 (本 skill)
-│   ├── +create (创建课程)
-│   ├── +update (更新课程)
-│   ├── +publish (发布课程)
-│   └── 查询命令...
-├── soke-lesson (子 skill - 课件管理)
-│   ├── +lesson-create
-│   ├── +lesson-get
-│   └── +lesson-list
-└── soke-material (子 skill - 素材管理)
-    ├── file +upload
-    ├── file +create
-    └── 查询命令...
-```
-
-## 版本历史
-
-- v3.0.0 (2024-05-26): 重构为模块化架构，集成 soke-material 和 soke-lesson 子 skills
-- v2.0.0 (2024-05-25): 添加课程创建和更新功能
-- v1.0.0 (2024-05-14): 初始版本，支持课程查询、分类、学习记录等功能
+# soke-course 课程主流程编排模块
+
+授客AI课程主流程编排模块。负责课程创建、分类、模板、设置、发布、查询与维护，并编排同级模块完成素材、课件与指派。
+
+## 职责
+
+- 课程创建与分类（创建前必须真实查询分类）
+- 课程模板与高级设置（创建后立即展示模板表）
+- 课程发布、定时发布与发布前校验
+- 学习进度与课程状态查询
+- 课程关闭及其他维护路由
+- 跨模块编排并传递真实 ID
+
+## 不负责
+
+- 素材上传（调用 `soke-material`）
+- 课件创建（调用 `soke-lesson`）
+- 指派实现（调用 `soke-assign`）
+- 删除/复制课程、新建分类、收费、证书、AI 做课等（需后台）
+
+## 入口
+
+- [MODULE.md](./MODULE.md) — 模块合同与主流程（交互规范 / 意图路由 / 5 Phase / 批量）
+- `subs/category/SOP.md` — 课程分类
+- `subs/template/SOP.md` — 课程模板
+- `subs/settings/SOP.md` — 课程设置
+- `subs/publish/SOP.md` — 发布校验
+- `subs/query/SOP.md` — 数据查询
+- `subs/batch/SOP.md` — 多课程批量上传（B0-B7）
+- `subs/assign/SOP.md` — 指派交互编排
+- `subs/exam/SOP.md` — 小测验交互编排
+- `subs/photo/SOP.md` — 图片链
+- `subs/charge/SOP.md` — 收费后台话术
+- `subs/copy/SOP.md` — 维护路由（关闭/删除/复制）
+- `intent-cases.md` — 意图案例库
+- `sop-publish-check.md` — 发布 Gate Check
+- `cli-facts.md` — 命令参数事实源
+
+## 并列模块
+
+- [soke-material](../soke-material/MODULE.md)
+- [soke-lesson](../soke-lesson/MODULE.md)
+- [soke-assign](../soke-assign/MODULE.md)
+- [soke-exam](../soke-exam/MODULE.md)
+- [soke-photo-gallery](../soke-photo-gallery/MODULE.md)

package/skills/mono/references/modules/soke-course/cli-facts.md

@@ -0,0 +1,107 @@
+# CLI 事实表（唯一事实源）
+
+> 实测于 soke-cli v1.0.77（2026-08-29）。本表为所有命令参数的唯一事实源；子 SOP 只写用法示例，参数以本表为准。
+> 兜底规则：本表未覆盖的命令 → 跑 `soke-cli <cmd> --help` 实测后补录本表。
+> 通用：所有命令支持 `--format json`（结构化输出推荐）；时间戳均为毫秒。
+> 返回契约：以下“必取字段”是进入下一步的最低要求；实际响应可能包裹在 `data/list/items` 中，先定位字段再继续。未知字段或未知状态不得按成功推断，需保留原始 JSON 并执行 `--help`/实测确认。
+
+## course 组
+
+### +create 创建课程
+`--title`(必填) `--category-id`(必填) `--description`
+返回最低字段：`course-id`、`title`、`status`。
+
+### +update 更新/关闭课程
+`--course-id`(必填) `--title` `--credit` `--description` `--category-id`
+`--image`(封面，**只收图片库 photoUri**) `--image-x/y/w/h`(裁剪)
+`--action` = update(默认) | **close（关闭课程，CLI 支持！删除才需后台）**
+
+### +advanced 高级设置
+`--course-id`(必填)；`--study-type` 1自由/2解锁；`--is-accelerate` 倍速；`--is-drag`/`--drag-type` 拖动；
+`--open-face-recognition` 课前人脸；`--is-first-face` 0不/1首次/2每次；`--learning-face-recognition`/`--face-recognition-times` 学习中人脸；
+`--open-workrecord` 待办；`--allow-after-expiration` 截止后学习；`--is-remind`/`--remind-days`/`--remind-time`/`--remind-content` 未学提醒；
+`--evaluate-required` 打星评价；`--is-hang`/`--hang-time`(≤60分) 文档防挂机；`--comment-switch` 评论；
+`--image-file`(本地二维码图，内部传 OSS 不进图片库，jpg/jpeg/png) 与 `--image-oss-url` 二选一
+
+### +publish 发布
+`--course-id`(必填) `--publish-time`("YYYY-MM-DD HH:MM:SS" 北京时间；默认 0000-00-00 00:00:00=立即)
+返回最低字段：`course-id`、`status`；定时发布另需回查 `publish-time`。
+
+### +get-course / +list-courses
+get: `--course-id`
+list: `--keyword` `--category-path`(分类筛选，**不是 --category-id**) `--status`(0/1/2，**默认1**) `--is-in`(0外部/1内部，默认1) `--is-my` `--is-joint` `--joint-out` `--page` `--page-size`(默认10)
+**⚠️ 无 --start-time/--end-time（旧文档的时间范围/365天限制对本命令不成立）**
+
+### +list-categories
+`--page` `--page-size`(max 100)。当前事实表未确认 `--parent-id`/`--level`，不得直接使用；如需末级分类，先按返回的 parent_id/level 递归查询或执行 --help 实测后补录。
+
+### +lesson-create 创建课件
+`--course-id`(必填) `--title` `--type` video/audio/photo_gallery/document/exam
+非 exam：`--media-id`(素材UUID，**不是 --uuid**) `--filename` `--ext` `--filesize` `--object` `--length`(秒，**不是 --duration**)
+exam：`--paper-id` 或 `--paper-title`(列表匹配) `--pool-id`(可选) `--minute`(默认30)/`--second`
+通用：`--point` `--sort`
+返回最低字段：`lesson-id`、`course-id`、`type`、`status`；非 exam 还需保留上传对象字段。
+
+### +lesson-list / +lesson-get / +lesson-sort
+list: `--course-id` `--keyword` `--type`(video/audio/image/document/link/live/exam/questionnaire/sign_in) `--page` `--limit`(默认10，**不是 --page-size**)
+get: `--id`(课件ID，**不是 --lesson-id**)
+sort: `--course-id` `--sort-list`("id1,id2,..."，**不是 --order**)
+
+### 学习数据查询
++list-course-users: `--course-id` `--finish-start-time`/`--finish-end-time`(**必传，跨度≤7天**，回归实测) `--userid-list`(逗号,≤100) `--page` `--page-size`
++get-course-user: `--course-id` `--dept-user-id`
++list-lesson-learns: `--lesson-id` `--course-id` `--userid-list` `--finish-start-time`/`--finish-end-time` `--page` `--page-size`
++list-lesson-faces: `--target-id`(=课件uuid，**不是 --lesson-id**) `--userid-list` `--page` `--page-size`（**无时间参数**）
+
+## file 组（素材库）
+
++upload: `--file`(本地路径，**不是 --path**；不支持图片) `--type`(默认自动检测) `--length`(默认视频600/音频300/**文档120**) `--category-id` `--module`(默认material) `--object-name` `--storage`
+返回最低字段：`uuid`、`filename`、`type`、`ext`、`filesize`、`object`、`length`；图片不得使用此命令。
+list-files: **无 + 前缀** → `soke-cli file list-files --page --page-size`
+get-info: **无 + 前缀** → `soke-cli file get-info --file-id`
++create: 创建素材库文件（已有 OSS 对象时）
+
+## assign 组（指派）
+
++list-departments: `--keyword` `--parent-id`(默认"1"=仅顶级，**全树需递归**) `--page` `--limit`
++list-users: `--dept-id` `--keyword` `--search-target`(name/phone/job_number) `--list-all` `--is-in` `--page` `--limit`
++create: `--module`(course/exam/learning_map) `--target-id`(**不是 --module-id**) `--learn-type` **required/optional（不是 --compulsory 1|0）** `--user-ids` `--user-names`(对应) `--dept-ids` `--dept-names` `--date` `--set-message`/`--message-switch`/`--message-content`
+返回最低字段：`target-id`、目标类型、实际指派数量和已存在/新增/失败明细。
++list: `--module` `--target-id` `--keyword` `--learn-type` `--page` `--limit`
+
+## photo-gallery 组（图片库）
+
++create: `--file`(本地图片) `--title` `--category-id`(默认empty) → 返回 uuid/photoUri
++list: `--file-keyword` `--category-id` `--from` `--page` `--limit`
++get: `--uuid`（含完整访问 URL）
+
+## exam 最小建题链（subs/exam 专用）
+
++create-pool: `--title` `--path`('["分类uuid"]') `--description` `--status`
++create-question: `--pool-id` `--type`(single_choice/choice/uncertain_choice/determine/fill/essay/material) `--title`(fill 用 `[[答案N]]`，**不传 --answer**) `--score`(>0) `--difficulty`(simple/medium/hard) `--choices`('[{"key":"A1","value":"A"}]') `--answer`(选择/判断为索引数组) `--answer-type`(fill) `--analysis`
++create-paper: `--title`(≤50) `--pool-id`('["pool_uuid"]') `--pattern`(questionType/random/selection/import) `--type-metas`(JSON: {"single_choice":{"count":N,"score":N},...})
++update-paper: `--paper-id` `--title`(**publish 必重传**) `--action publish`
++list-papers: `--page` `--page-size`(默认10) → 试卷列表（H1 选择试卷用，取 title/paper-id）
++get-paper: `--paper-id`（含完整字段与发布状态）
+
+## clock 组（作业查询，只读；**--page/--page-size 强制必传**）
+
+list-learnings: `--target-id`(课程ID) `--start-time`/`--end-time`(毫秒) `--page` `--page-size`
+list-logs: `--clock-id`(来自 list-learnings) `--start-time`/`--end-time` `--page` `--page-size`
+list-log-lessons: `--target-id`(提交ID，来自 list-logs) `--page` `--page-size`
+
+## 漂移修正表（旧文档 → 实际）
+
+| 旧 | 实际 |
+|----|------|
+| file +upload --path | --file |
+| file +list-files / +get-info | 无 + 前缀 |
+| lesson-create --uuid / --duration | --media-id / --length |
+| lesson-get --lesson-id | --id |
+| lesson-sort --order | --sort-list |
+| lesson-list --page-size | --limit |
+| list-courses --start-time/--end-time/--category-id | 不存在；用 --keyword/--category-path |
+| list-lesson-faces --lesson-id + 时间范围 | --target-id，无时间参数 |
+| assign --module-id / --compulsory 1\|0 | --target-id / --learn-type required\|optional |
+| 关闭课程仅后台 | +update --action close |
+| 文档默认时长 0s | 120s |

package/skills/mono/references/modules/soke-course/intent-cases.md

@@ -0,0 +1,41 @@
+# 意图案例库（Gate 0 路由参考）
+
+> 本文件承载「显式调用本技能但意图不明」时的路由判定案例，供 Gate 0 兜底决策。命令参数以 `cli-facts.md` 为准。
+
+## 路由总表
+
+| 用户说法（示例） | 判定意图 | 路由 |
+| --- | --- | --- |
+| 创建/新建/做课/开课/上传课程 | create | Phase 1 全流程 |
+| 加课件/传视频/调顺序 | add_lesson | Phase 2（需 course-id） |
+| 改学分/换封面/开倍速/人脸/提醒 | settings | Phase 3 |
+| 指派/必修/选修 | assign | Phase 4（发布前） |
+| 发布/上线/定时发布 | publish | Phase 4（最后一步，仅明确 E1 执行） |
+| 进度/完成率/谁学了/作业提交 | query | Phase 5 |
+| 关闭/删除/复制 | maintain | Phase 5 维护 |
+| 有哪些分类/查分类 | category | read subs/category |
+
+## 上下文规则
+
+- **有 course-id** → 当前课程操作，不新建。
+- **学习统计未指定课程** → 先列已发布线上课前 20 个 + 表格下方提示，选定后再查统计。
+- **有文件附件** → 倾向课件（add_lesson / Phase 2）。
+- **歧义** → 弹窗列可能操作。
+- **显式调用本技能且意图不明或与课程无关** → 默认走创建/上传主流程（提示输入标题 → 收集 A/B/C），不展开无关话题。
+- **含明确他意图**（查询/发布/指派/设置/维护）→ 对应 Phase。
+
+## 兜底示例
+
+| 用户说法 | 判定 | 说明 |
+| --- | --- | --- |
+| 「帮我做个课」 | create | 进入 Phase 1，提示输入标题 |
+| 「把 xxx.mp4 传上去」 | add_lesson | 有文件附件 → 倾向课件，需 course-id |
+| 「课程 123 学分改成 5」 | settings | 有 course-id + 设置意图 |
+| 「这课谁学了」 | query | 未指定课程 → 先列前 20 已发布课 |
+| 「随便，你看着办」 | create | 意图不明 → 默认创建主流程 |
+| 「帮我把课程关了」 | maintain | 关闭场景 |
+
+## 边界
+
+- 本文件只做意图判定，不做业务执行；执行细节以各 Phase 与 subs SOP 为准。
+- 与课程无关的闲聊/他领域请求，不在此展开，直接回落到对应技能或澄清。

package/skills/mono/references/modules/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 ../../shared/installation.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 (subs/):"
+for sub in category settings charge publish copy query template batch assign exam photo; do
+    if [ -f "$BASE_DIR/subs/$sub/SOP.md" ]; then
+        echo "  ✅ $sub"
+    else
+        echo "  ❌ $sub (缺失)"
+    fi
+done
+
+echo "📚 参考文档:"
+for ref in cli-facts.md intent-cases.md sop-publish-check.md; do
+    if [ -f "$BASE_DIR/$ref" ]; then
+        echo "  ✅ $ref"
+    else
+        echo "  ❌ $ref (缺失)"
+    fi
+done
+
+echo ""
+echo "✅ 环境检查完成"

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

@@ -0,0 +1,46 @@
+# 发布 Gate Check（课程发布前校验）
+
+> 本文件是发布状态流转与 Gate Check 矩阵的唯一定义。执行动作见 `subs/publish/SOP.md`。参数以 `cli-facts.md` 为准。
+
+## 状态流转（收敛定案）
+
+- 0 未发布 → 1 已发布：`course +publish`；
+- 1 → 2 已关闭：`course +update --action close`（**CLI 支持**；删除才需后台）；
+- 2 → 1：**已关闭可重新发布**。
+
+## 立即发布 Gate Check（6 项）
+
+| # | 检查项 | 阻塞级别 |
+| --- | --- | --- |
+| 1 | 标题非空 | 🔴 阻塞 |
+| 2 | 分类已设置 | 🔴 阻塞 |
+| 3 | 课件数量 ≥ 1 | 🔴 阻塞 |
+| 4 | 无转码失败课件 | 🔴 阻塞 |
+| 5 | 转码中的课件 | 🟡 警告 |
+| 6 | 其他非硬项（后台待配项） | 🟡 警告 |
+
+规则：
+
+- 🔴 阻塞 → 列全部阻塞项 + 修复指引 → 停止发布；
+- 仅 🟡 → 弹窗「有 X 项警告，确认继续发布吗？」（发布警告用原生弹窗）；
+- 转码中/失败不得进入发布执行。
+
+## 关闭场景额外检查（第 7 项）
+
+- **7. 关闭前确认无学习地图关联**（有关联需先解除或引导后台处理）。
+
+## 回查规则
+
+- 立即发布：执行 `course +publish` 后回查 status==1。
+- 定时发布：回查 publish_time，未到时间时允许 status 仍为 0。
+- 执行前重新获取课程状态并再次 Gate Check，确认仍是当前课程与计划。
+
+## 输出标准
+
+- 成功：✅ 课程发布成功 / 标题 / ID / status=1 / 学员端可见。
+- 定时：✅ 已设置定时发布 / 标题 / ID / publish_time / 当前 status=0（到点后回查）。
+- 不通过：❌ 逐项 [✓]/[✗] 列表 + 修复指引。
+
+## ⚠️ CLI 不支持
+
+审批流（后台→系统设置→审批设置；默认关闭）、批量发布（后台）、删除课程（后台，不可逆）。

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

@@ -0,0 +1,40 @@
+# 指派子 SOP（课程流程编排视角）
+
+> 本 SOP 只承载「课程创建/上传流程中」的指派交互编排规则；指派命令的真实参数以 `../../cli-facts.md` 的 assign 组为准，指派实现细节见 `../../../soke-assign/MODULE.md`。
+
+## 触发
+
+Phase 4 弹窗1 用户选择「1. 指派（推荐）」后触发本 SOP。
+
+## 交互顺序（硬规则）
+
+1. 弹窗1 确认指派后，紧接着固定收集两问：**学习类型（F1 必修 / F2 选修）｜ 指派对象（部门指派 / 人员指派）**。
+2. **G2（不指派）不出现学习类型问，也不出现指派部门/人员问**。
+3. 指派对象选项**隐藏用户组/职位**，只保留「部门指派 / 人员指派」。
+
+## 部门指派
+
+- 用户选部门指派后，**先执行 `assign +list-departments` 递归拉取部门树**，再使用原生选择弹窗罗列部门名称和成员数；**不能只要求用户输入部门名称**。
+- 用户选定部门后，执行 `assign +create`，使用 `--dept-ids`/`--dept-names`。
+- `--learn-type` 用 `required`（F1 必修）/ `optional`（F2 选修），**不是** `--compulsory 1|0`。
+
+## 人员指派
+
+- 用户选人员指派后，用关键词 `assign +list-users` 编号选定用户。
+- 用户选定人员后，执行 `assign +create`，使用 `--user-ids`/`--user-names`。
+
+## 完成判定
+
+指派真正成功，当且仅当 `assign +list`（基于 `--target-id` 资源 ID 查询）能查到对应用户/部门的指派记录，且 `--learn-type` 标记与请求一致。仅 `+create` 回显成功但 `+list` 查不到的，视为未完成，不得报告「指派成功」。
+
+## 前置条件
+
+- 未发布课程同样可以指派，无「先发布才能指派」限制。
+- 批量指派建议单次不超过 500 人，超出分批处理。
+
+## 检查清单
+
+- [ ] 弹窗2 已收集指派对象 + 学习类型（G2 跳过学习类型）
+- [ ] 部门指派已先拉部门树并用原生弹窗罗列，未要求用户裸输部门名
+- [ ] `--learn-type` 用 required/optional，未使用旧参数 --compulsory
+- [ ] 指派完成后用 assign +list 回读验证（查不到＝未完成）