@sokeai/cli 1.0.76 → 1.0.78

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

@@ -2,22 +2,23 @@
 
 ## 命令说明
 
-`soke-cli course +list-courses` 用于查询课程列表，支持按时间范围、分类、状态等条件筛选。
+`soke-cli course +list-courses` 用于查询课程列表，转发到 `/skills/course/list`，支持按课程列表模糊搜索关键字、课程分类、课程状态、课程来源、我的课程和协同关系筛选。
 
 ## 基本用法
 
-### 查询指定时间范围的课程
+### 查询已发布课程
 
 ```bash
 soke-cli course +list-courses \
-  --start-time 1704038400000 \
-  --end-time 1735660799000
+  --status 1 \
+  --page 1 \
+  --page-size 10
 ```
 
 **说明**:
-- `--start-time`: 课程创建开始时间（Unix时间戳，毫秒）
-- `--end-time`: 课程创建结束时间（Unix时间戳，毫秒）
-- 时间范围不能超过365天
+- `--status`: 课程状态，默认 `1`
+- `--page`: 页码，默认 `1`
+- `--page-size`: 每页数据，默认 `10`
 
 ## 高级筛选
 
@@ -26,20 +27,14 @@ soke-cli course +list-courses \
 ```bash
 # 查询已发布的课程
 soke-cli course +list-courses \
-  --start-time 1704038400000 \
-  --end-time 1735660799000 \
   --status 1
 
 # 查询未发布的课程
 soke-cli course +list-courses \
-  --start-time 1704038400000 \
-  --end-time 1735660799000 \
   --status 0
 
 # 查询已关闭的课程
 soke-cli course +list-courses \
-  --start-time 1704038400000 \
-  --end-time 1735660799000 \
   --status 2
 ```
 
@@ -51,44 +46,46 @@ soke-cli course +list-courses \
 ### 按课程来源筛选
 
 ```bash
-# 查询自建课
+# 查询内部课列表
 soke-cli course +list-courses \
-  --start-time 1704038400000 \
-  --end-time 1735660799000 \
   --is-in 1
 
-# 查询采购课
+# 查询外部课列表
 soke-cli course +list-courses \
-  --start-time 1704038400000 \
-  --end-time 1735660799000 \
   --is-in 0
 ```
 
 **来源说明**:
-- `0`: 采购课（从外部采购的课程）
-- `1`: 自建课（企业自己创建的课程）
+- `0`: 外部课列表
+- `1`: 内部课列表
 
-### 按课程分类筛选
+### 按关键字筛选
 
 ```bash
-soke-cli course +list-categories
+soke-cli course +list-courses \
+  --keyword "测试"
+```
+
+**说明**：`--keyword` 是课程列表模糊搜索关键字。
 
+### 按课程分类筛选
+
+```bash
 soke-cli course +list-courses \
-  --start-time 1704038400000 \
-  --end-time 1735660799000 \
-  --category-id "category-uuid-here"
+  --category-path "category-uuid-here"
 ```
 
+**说明**：`--category-path` 会作为接口参数 `categoryPath` 传递，用于按照课程分类 ID 筛选课程。
+
 ### 组合筛选
 
 ```bash
-# 查询已发布的自建课，且属于特定分类
+# 查询已发布的内部课，只看我创建的，并限制课程分类
 soke-cli course +list-courses \
-  --start-time 1704038400000 \
-  --end-time 1735660799000 \
   --status 1 \
   --is-in 1 \
-  --category-id "category123"
+  --is-my 1 \
+  --category-path "category123"
 ```
 
 ## 分页查询
@@ -96,22 +93,32 @@ soke-cli course +list-courses \
 ```bash
 # 第一页，每页10条
 soke-cli course +list-courses \
-  --start-time 1704038400000 \
-  --end-time 1735660799000 \
   --page 1 \
   --page-size 10
 
 # 第二页，每页10条
 soke-cli course +list-courses \
-  --start-time 1704038400000 \
-  --end-time 1735660799000 \
   --page 2 \
   --page-size 10
 ```
 
 **分页说明**:
 - `--page`: 页码，从1开始，默认为1
-- `--page-size`: 每页数量，最大100，默认为100
+- `--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=是 |
 
 ## 返回数据示例
 
@@ -166,66 +173,24 @@ soke-cli course +list-courses \
 | description | String | 课程描述 |
 | pc_url | String | PC端跳转链接 |
 | mobile_url | String | 移动端跳转链接 |
-| create_time | Int | 创建时间（Unix时间戳，毫秒） |
-| update_time | Int | 更新时间（Unix时间戳，毫秒） |
+| create_time | Int/String | 创建时间 |
+| update_time | Int/String | 更新时间 |
 | create_dept_user_id | String | 创建人ID |
 | create_dept_user_name | String | 创建人姓名 |
 | has_more | Int | 是否还有更多数据（1=有, 0=没有） |
 
-## 时间戳转换
-
-### JavaScript/Node.js
-```javascript
-// 获取当前时间戳（毫秒）
-const now = Date.now();
-
-// 获取指定日期的时间戳
-const date = new Date('2024-01-01 00:00:00');
-const timestamp = date.getTime();
-```
-
-### Python
-```python
-import time
-from datetime import datetime
-
-# 获取当前时间戳（毫秒）
-now = int(time.time() * 1000)
-
-# 获取指定日期的时间戳
-dt = datetime(2024, 1, 1, 0, 0, 0)
-timestamp = int(dt.timestamp() * 1000)
-```
-
-### Go
-```go
-import "time"
-
-// 获取当前时间戳（毫秒）
-now := time.Now().UnixMilli()
-
-// 获取指定日期的时间戳
-t := time.Date(2024, 1, 1, 0, 0, 0, 0, time.UTC)
-timestamp := t.UnixMilli()
-```
-
 ## 常见问题
 
-### Q: 为什么时间范围不能超过365天？
-A: 这是API的限制，为了防止一次查询返回过多数据。如果需要查询更长时间范围的数据，可以分多次查询。
-
 ### Q: 如何查询所有课程？
-A: 可以按年份分批查询，例如：
+A: 使用分页逐页查询，例如：
 ```bash
-# 查询2024年的课程
 soke-cli course +list-courses \
-  --start-time 1704038400000 \
-  --end-time 1735660799000
+  --page 1 \
+  --page-size 10
 
-# 查询2025年的课程
 soke-cli course +list-courses \
-  --start-time 1735660800000 \
-  --end-time 1767196799000
+  --page 2 \
+  --page-size 10
 ```
 
 ### Q: 如何知道是否还有更多数据？

package/skills/{soke-course → mono/references/modules/soke-course}/references/examples.md

@@ -475,6 +475,6 @@ echo "课程数据已导出到: $OUTPUT_FILE"
 
 ## 相关资源
 
-- [SKILL.md](./SKILL.md) - 完整文档
-- [README.md](./README.md) - 快速开始
-- [course-list-courses.md](./references/course-list-courses.md) - 详细参考
+- [SKILL.md](../MODULE.md) - 完整文档
+- [README.md](../README.md) - 快速开始
+- [course-list-courses.md](./course-list-courses.md) - 详细参考

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

@@ -78,8 +78,8 @@
 
 | # | 用户输入 | 提取 | 路由 |
 |---|---------|------|------|
-| 35 | "关闭这门课" | close | Phase 6（⚠️ 不支持） |
-| 36 | "删除课程" | delete | Phase 6（⚠️ 不支持） |
+| 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（⚠️ 不支持） |
 

package/skills/{soke-course → mono/references/modules/soke-course}/references/sop-full-workflow.md

@@ -166,9 +166,11 @@ Gate 4→5: ✅ status=1
   读取: subs/query/SOP.md 执行
   操作: course +list-course-users / +get-course-user / +list-lesson-learns / +list-lesson-faces
 
-### Step 6.2: 关闭/删除（⚠️ CLI 不支持）
+### 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 执行

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

@@ -76,14 +76,32 @@ soke course +publish \
 
 发布成功后课程状态由 `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 不支持的操作
 
 | 操作 | 说明 | 替代路径 |
 |------|------|---------|
 | **审批流** | 发布需经过审批流程 | 后台 → 系统设置 → 审批设置 |
 | **批量发布** | 一次发布多门课程 | 后台 → 课程管理 → 批量操作 |
-| **关闭课程** | 将已发布课程下线 | 后台 → 课程管理 → 课程操作 → 关闭 |
-| **删除课程** | 物理删除课程及所有数据 | 后台 → 课程管理 → 课程操作 → 删除 |
 
 ## 审批规则
 
@@ -135,7 +153,7 @@ Gate Check 不通过（示例）：
 2. 转码是异步过程，上传视频/音频后需等待转码完成再发布
 3. 课程关闭后学员端不可见，但历史学习记录保留
 4. 关闭后可重新发布，状态回到 1
-5. 删除课程不可逆，CLI 不提供删除入口
+5. 删除课程不可逆，CLI 只允许删除未发布(status=0)或已关闭(status=2)课程
 6. 审批流默认关闭，如需开启需后台手动配置
 
 ## 检查清单

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

@@ -13,8 +13,8 @@ tags: [soke, query, data, analytics, learning-records]
 
 ## 通用约束
 
-- **时间范围限制**：所有查询的时间跨度 ≤ 365 天（如超出返回错误）
-- **时间戳格式**：所有时间戳均为**毫秒级 Unix timestamp**
+- 课程列表走 `/skills/course/list`，不再使用创建时间范围筛选。
+- 学习记录类查询如包含时间参数，时间戳仍使用**毫秒级 Unix timestamp**。
 - **状态码含义**：
   - `status`（课程）：`0`=未发布，`1`=已发布，`2`=已关闭
   - `face_status`（人脸）：`1`=验证成功，`2`=验证失败
@@ -29,13 +29,15 @@ soke course +list-courses
 
 | 参数 | 必填 | 说明 |
 |------|------|------|
-| `--keyword` | 否 | 按标题/描述模糊搜索 |
+| `--keyword` | 否 | 课程列表模糊搜索关键字 |
+| `--category-path` | 否 | 课程分类 ID，用于按照分类筛选课程 |
 | `--status` | 否 | 按状态过滤（0/1/2） |
-| `--category-id` | 否 | 按分类过滤 |
+| `--is-in` | 否 | 课程来源：0=外部课列表，1=内部课列表（默认 1） |
+| `--is-my` | 否 | 是否只看我创建的（默认 0） |
+| `--is-joint` | 否 | 协同给我的（默认 0） |
+| `--joint-out` | 否 | 我协同出去的（默认 0） |
 | `--page` | 否 | 页码（默认 1） |
-| `--page-size` | 否 | 每页条数（默认 20） |
-| `--start-time` | 否 | 创建时间起始（ms） |
-| `--end-time` | 否 | 创建时间结束（ms），与 start-time 跨度 ≤ 365 天 |
+| `--page-size` | 否 | 每页条数（默认 10） |
 
 返回课程列表，包含课程 ID、标题、状态、创建时间、学习人数等摘要。
 

package/skills/{soke-course → mono/references/modules/soke-course}/references/subs/settings/SOP.md

@@ -27,6 +27,7 @@ soke course +update \
 | 参数 | 必填 | 说明 |
 |------|------|------|
 | `--course-id` | 是 | 课程 ID |
+| `--action` | 否 | 操作类型，默认 `update`；传 `close` 可关闭课程 |
 | `--title` | 否 | 课程标题 |
 | `--credit` | 否 | 学分 |
 | `--description` | 否 | 课程描述/简介 |
@@ -122,7 +123,7 @@ soke-cli course +advanced \
 
 ## 注意事项
 
-1. `course +update` 支持标题、学分、描述、封面图和分类 ID 修改
+1. `course +update` 支持标题、学分、描述、封面图、分类 ID 修改，以及通过 `--action close` 关闭课程
 2. 封面图地址来自图片库列表接口返回的 `photoUri`
 3. 分类修改可通过 `--category-id` 更新
 4. 高级设置项之间可能存在依赖关系（如开启视频学习中人脸识别后再设置识别次数），建议按表格顺序逐项配置

package/skills/{soke-exam/SKILL.md → mono/references/modules/soke-exam/MODULE.md}

@@ -11,7 +11,7 @@ metadata:
 
 # 考试管理 (exam)
 
-**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../soke-shared/SKILL.md`](../soke-shared/SKILL.md)，其中包含认证、配置、权限处理**
+**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../soke-shared/MODULE.md`](../soke-shared/MODULE.md)，其中包含认证、配置、权限处理**
 
 ## 核心概念
 

package/skills/mono/references/modules/soke-exam-question-pool/MODULE.md

@@ -0,0 +1,123 @@
+---
+name: soke-exam-question-pool
+summary: 授客学堂题库答题练习（拉取题库列表/选择题库/随机出题/实时判分/进度追踪），支持填空、判断、单选、多选、不定项五种题型，答题状态持久化
+version: 2.0.0
+description: "授客学堂题库答题练习：通过 soke-cli exam-question-pool 分页拉取可练习题库列表，选择题库后随机逐题出题、实时判分并反馈进度。支持填空、判断、单选、多选、不定项五种题型，答题状态本地持久化。当用户需要刷题、题库练习、随机答题或查看答题进度时使用。"
+metadata:
+  requires:
+    bins: [soke-cli]
+  cliHelp: soke-cli exam-question-pool --help
+---
+
+# 可练习题库交互式练习系统
+
+核心链路全量分页选库随机逐题实时反馈
+
+## 交互流程总览
+
+用户触发练习Step1全量分页拉取全部题库展示供选择Step2用户选择一个题库Step3拉取该题库全部题目加载答题状态Step4从未答题目中随机抽一道呈现判分Step5询问下一题结束重开循环Step4
+
+## Step1全量分页拉取题库列表
+
+soke-cli exam-question-pool +list --page 1 --page-size 100 --status 1 --format json
+
+循环拉取检查data.hasMore若为1则继续翻页直到hasMore为0合并所有页data.list按uuid去重
+重要API分页存在跨页重叠bug相邻两页可能返回相同uuid的题库必须按uuid去重不能简单拼接
+优先使用page-size100一次拉全减少分页次数和重叠风险
+
+### 展示规则
+
+每个题库一行选项只显示序号和题库名称格式为title
+不要显示题目数question_count和状态pass_status
+题库总数小于等于20一次性展示全部
+题库总数大于20分页展示每页最多20个末尾追加下一页翻到底后追加上一页
+
+## Step2用户选择题库
+
+用户输入编号取pool_id为选中项的uuid
+若用户说随机选一个从未完成题库中随机选全部完成则全量随机
+
+## Step3拉取题目和初始化状态
+
+soke-cli exam-question-pool +questions --pool-id UUID --format json
+
+注意pool-id的值不要加引号否则会报参数格式错误
+
+提取data.content中所有题目uuid type title choices answer show_answer analysis
+
+### 答题状态文件
+
+路径C:\Users\soke\.qclaw\workspace\.exam-state\{pool-uuid}.json
+
+格式pool_id uuid pool_title 题库名 total 5 correct 0 answered 空数组
+
+文件不存在或pool_id不匹配新建answered为空数组
+答完一题追加uuid到answered正确则correct加1
+结束答题保留state
+重新开始清空answered为空数组correct为0
+answered长度大于等于total自动提示本轮全部答完
+已展示但未作答的题目不算已答用户在题目展示后说退出结束退出答题等该题不计入answered不计入correct不出现在本轮总结表格中只有用户实际选择了选项或输入了答案并提交才算作答
+
+## Step4随机出题和呈现
+
+### 随机逻辑
+
+从data.content排除answered中已有uuid
+剩余题目随机选一道
+每次进入题库出题顺序随机不固定
+
+### 用户输出红线
+
+严禁在面向用户的任何输出中暴露内部标识字段包括但不限于uuid pool_id source_id category_id target_id dept_user_id company_id answer_type display
+这些字段仅用于内部逻辑和状态文件不要出现在题目展示判分反馈进度统计小结表格或任何用户可见的文本中
+如果需要区分题目在内部用uuid但在用户界面只用序号或题目内容来标识
+用户看到的内容应该像正常的练习题一样干净简洁没有任何技术性ID字段
+
+### 按题型呈现
+
+A填空题type fill文本输入禁止变选择题
+纯文本呈现题目提示用户输入答案
+题目展示标题填空题第X题共N题题目将title中的span标签替换为括号加下划线提示多个空请用英文逗号分隔如答案1答案2答案3
+重要提示示例绝不能使用当前题目的正确答案只能用答案1答案2答案3等占位符
+填空判分show_answer为二维数组用户逗号分隔答案按序对应每个空匹配子数组中任一值即算对忽略首尾空格大小写不敏感全对正确部分对逐空标注全错错误
+
+B判断题type determine
+标题判断题第X题共N题选项A正确B错误判分show_answer A正确B错误
+
+C单选题type single_choice
+标题单选题第X题共N题选项A choices0 title B choices1 title等判分show_answer如A用户选了选项A即对
+
+D多选题type choice
+标题多选题第X题共N题选项同单选判分用户所选字母集合与show_answer字母集合完全一致顺序无关
+
+E不定项选择type uncertain_choice
+同多选题标题标注不定项选择
+
+## Step5判分反馈和循环
+
+答完后纯文本反馈正确或错误你的答案正确答案解析如有进度已答n题共total题正确m题pct百分比
+然后询问下一步下一题结束答题重新开始本轮
+下一题保存状态回到Step4
+结束答题保存状态显示本轮小结退出当前题目未作答则不计入总结
+重新开始本轮清空answered和correct回到Step4
+本轮答完时仅提供重新开始和结束
+
+### 本轮小结规则
+
+总结表格只包含实际作答的题目即uuid已写入answered的题目
+已展示但用户说退出未作答的题目不出现在总结中下次进入该题库时仍会出现
+进度统计以状态文件中的answered和correct为准不要自行脑补
+
+## Shortcuts参考
+
+list获取可练习题库列表
+get获取题库详情
+questions获取题库全部题目
+
+## 重要注意
+
+data.content数量可能与all_count不一致过滤题以实际返回为准
+填空show_answer是string二维数组每空可能有多个可接受值
+状态文件路径C:\Users\soke\.qclaw\workspace\.exam-state\uuid.json先确保目录存在
+每次出题前根据当前状态重新计算未答题池保证随机性
+填空题提示示例不能泄露正确答案统一用答案1答案2答案3占位

package/skills/{soke-learning-map/SKILL.md → mono/references/modules/soke-learning-map/MODULE.md}

@@ -12,7 +12,7 @@ metadata:
 
 # 学习地图管理 (soke-learning-map)
 
-**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`./soke-cli安装指南.md`](./soke-cli安装指南.md)，其中包含认证、配置、权限处理**
+**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../../../references/installation.md`](../../../references/installation.md)，其中包含认证、配置、权限处理**
 
 ## 使用前提
 
@@ -289,7 +289,7 @@ soke-cli learning-map +publish --uuid "MAP-UUID" --status "0"
 
 ## 步骤8：指派学习地图（可选）
 
-> 详见 [`../soke-assign/SKILL.md`](../soke-assign/SKILL.md)
+> 详见 [`../soke-assign/MODULE.md`](../soke-assign/MODULE.md)
 
 发布后指派给部门或学员，学员才能看到并开始学习。
 
@@ -380,7 +380,7 @@ soke-cli learning-map +detail --uuid "MAP-UUID" --format json
 | `+list-item-users` | 查询内容学员列表 | read |
 | `+get-map-user` | 查询单个学员详情 | read |
 
-学员统计导出任务使用独立模块：`soke-cli task +create` / `soke-cli task +get`，详见 [`../soke-task/SKILL.md`](../soke-task/SKILL.md)。
+学员统计导出任务使用独立模块：`soke-cli task +create` / `soke-cli task +get`，详见 [`../soke-task/MODULE.md`](../soke-task/MODULE.md)。
 
 ### 指派管理（soke-assign）
 
@@ -551,6 +551,5 @@ soke-cli learning-map +list-maps \
 
 ## 相关文档
 
-- [`../soke-shared/SKILL.md`](../soke-shared/SKILL.md) — 认证、配置、权限
-- [`../soke-assign/SKILL.md`](../soke-assign/SKILL.md) — 指派管理
-- [`../../docs/LEARNING_MAP_CREATE.md`](../../docs/LEARNING_MAP_CREATE.md) — 学习地图创建接口文档
+- [`../soke-shared/MODULE.md`](../soke-shared/MODULE.md) — 认证、配置、权限
+- [`../soke-assign/MODULE.md`](../soke-assign/MODULE.md) — 指派管理

package/skills/{soke-learning-profile/SKILL.md → mono/references/modules/soke-learning-profile/MODULE.md}

@@ -9,7 +9,7 @@ metadata:
   cliHelp: "soke-cli learning-profile --help"
 ---
 
-**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../soke-shared/SKILL.md`](../soke-shared/SKILL.md)，其中包含认证、配置、权限处理**
+**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../soke-shared/MODULE.md`](../soke-shared/MODULE.md)，其中包含认证、配置、权限处理**
 
 ## 核心概念
 
@@ -207,7 +207,7 @@ soke-cli learning-profile +list --page-size 100 --format json > learning_profile
 ## 错误处理
 
 ### 权限不足
-如果遇到权限错误，参考 [`../soke-shared/SKILL.md`](../soke-shared/SKILL.md)
+如果遇到权限错误，参考 [`../soke-shared/MODULE.md`](../soke-shared/MODULE.md)
 
 ### 参数错误
 使用 `--help` 查看命令参数说明：

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

@@ -0,0 +1,53 @@
+# 授客课件管理 Skill
+
+课件生命周期管理，包括基于素材创建课件、查询课件列表和详情、管理课件排序。
+
+## 快速开始
+
+### 创建课件
+
+```bash
+# 步骤1: 上传素材
+soke-cli file +upload --file ./lesson1.mp4
+# 返回: media_id
+
+# 步骤2: 创建课件
+soke-cli course +lesson-create \
+  --course-id "COURSE-UUID" \
+  --title "第一课" \
+  --media-id "MATERIAL-UUID" \
+  --type "video" \
+  --length 600 \
+  --object "ding123/course/video/lesson1.mp4" \
+  --filename "lesson1.mp4" \
+  --ext "mp4" \
+  --filesize 10485760
+```
+
+### 管理课件
+
+```bash
+# 查询课件列表
+soke-cli course +lesson-list --course-id "COURSE-UUID"
+
+# 获取课件详情
+soke-cli course +lesson-get --lesson-id "LESSON-UUID"
+```
+
+## 主要功能
+
+- ✅ 基于素材创建课件
+- ✅ 查询课件列表
+- ✅ 获取课件详情
+- ✅ 管理课件排序
+- ✅ 支持视频、音频、文档等多种类型
+
+## 课件类型
+
+- **视频课件** (video): 支持 mp4, avi, mov 等格式
+- **音频课件** (audio): 支持 mp3, wav, m4a 等格式
+- **文档课件** (document): 支持 pdf, ppt, doc 等格式
+
+## 详细文档
+
+查看 [SKILL.md](./MODULE.md) 获取完整的使用说明和 API 文档。

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

@@ -0,0 +1,49 @@
+# 授客素材库管理 Skill
+
+素材库文件管理，包括文件上传到OSS、创建素材记录、查询素材列表和详情、管理素材分类。
+
+## 快速开始
+
+### 上传文件到素材库
+
+```bash
+# 自动检测类型和时长
+soke-cli file +upload --file ./video.mp4
+
+# 指定类型和时长
+soke-cli file +upload --file ./audio.mp3 --type audio --length 236
+```
+
+### 查询素材
+
+```bash
+# 列出所有素材
+soke-cli file +list-files
+
+# 列出视频素材
+soke-cli file +list-files --type video
+
+# 获取素材详情
+soke-cli file +get-info --file-id "FILE-UUID"
+```
+
+## 主要功能
+
+- ✅ 文件上传到 OSS（自动获取签名）
+- ✅ 创建素材库记录
+- ✅ 查询素材列表（支持类型和分类筛选）
+- ✅ 获取素材详情
+- ✅ 管理素材分类
+- ✅ 自动检测文件类型
+- ✅ 自动设置默认时长
+
+## 支持的文件类型
+
+- **视频**: mp4, avi, mov, wmv, flv, mkv, webm 等
+- **音频**: mp3, wav, flac, aac, ogg, wma, m4a 等
+- **图片**: jpg, jpeg, png, gif, bmp, svg, webp 等
+- **文档**: pdf, ppt, pptx, doc, docx, xls, xlsx 等
+
+## 详细文档
+
+查看 [SKILL.md](./MODULE.md) 获取完整的使用说明和 API 文档。

package/skills/{soke-photo-gallery/SKILL.md → mono/references/modules/soke-photo-gallery/MODULE.md}

@@ -11,7 +11,7 @@ metadata:
 
 # 图片库管理 (soke-photo-gallery)
 
-**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../soke-shared/SKILL.md`](../soke-shared/SKILL.md)，其中包含认证、配置、权限处理**
+**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../soke-shared/MODULE.md`](../soke-shared/MODULE.md)，其中包含认证、配置、权限处理**
 
 ## 使用前提
 
@@ -283,5 +283,4 @@ soke-cli photo-gallery +list --format json
 
 ## 相关文档
 
-- [`../soke-shared/SKILL.md`](../soke-shared/SKILL.md) — 认证、配置、权限
-- [`../../docs/photo-gallery-api.md`](../../docs/photo-gallery-api.md) — 图片库接口文档
+- [`../soke-shared/MODULE.md`](../soke-shared/MODULE.md) — 认证、配置、权限