@sokeai/cli 1.0.75 → 1.0.77

package/skills/soke-course/README.md

@@ -81,6 +81,8 @@ soke-cli course +list-course-users --course-id "COURSE-UUID"
 | `+list-categories` | 查询课程分类（获取 category-id） |
 | `+create` | 创建课程基本信息 |
 | `+update` | 更新课程信息 |
+| `+delete` | 删除未发布或已关闭课程 |
+| `+advanced` | 更新课程高级设置 |
 | `+publish` | 发布课程 |
 | `+get-course` | 查询课程详情 |
 | `+list-courses` | 查询课程列表 |
@@ -142,6 +144,11 @@ 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: 管理现有课程
@@ -162,6 +169,9 @@ soke-cli course +update \
   --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 \
@@ -209,8 +219,8 @@ const endTime = new Date('2024-12-31').getTime();   // 1735660799000
 - `2`: 已关闭
 
 **课程来源 (is-in)**:
-- `0`: 采购课
-- `1`: 自建课
+- `0`: 外部课列表
+- `1`: 内部课列表
 
 **学习模式 (study_type)**:
 - `1`: 自由式（可任意顺序学习）

package/skills/soke-course/SKILL.md

@@ -214,13 +214,14 @@ Gate 2→3: ✅ 课件 ≥ 1
 #### Phase 3: 课程设置
 
   → read references/subs/settings/SOP.md 执行
-    基础: title/description（course +update）
+    基础: title/credit/description/image（course +update）
 
   → read references/subs/template/SOP.md Step 3 执行
     将当前所有设置项以表格形式展示（仅「设置项」+「当前值」两列）
     告知用户: "想修改哪项？直接告诉我就行。"
   用户指令处理:
-    - 标题/描述 → exec: course +update（✅ CLI 支持） → 刷新表格
+    - 标题/学分/描述/封面 → exec: course +update（✅ CLI 支持） → 刷新表格
+    - 学习模式/倍速/人脸/提醒/评价/拖动/评论/文档防挂机/交流群二维码 → exec: course +advanced（✅ CLI 支持；交流群二维码本地图片用 --image-file，命令内部只上传 OSS，不进入图片库） → 刷新表格
     - 其他设置 → "已记录: {项} → {新值}（需在后台操作: {路径}）" → 刷新表格
     - "可以了"/"继续" → 退出 Phase 3
   循环直到用户确认
@@ -231,8 +232,9 @@ Gate 3→4: 无硬阻塞
 
   → read references/subs/publish/SOP.md 执行
     Gate Check: 标题/分类/课件数量/转码状态
-    通过 → course +publish
-    定时/审批/批量 → ⚠️ CLI 不支持
+    直接发布 → course +publish --course-id <uuid>
+    定时发布 → course +publish --course-id <uuid> --publish-time "<北京时间>"
+    审批/批量 → ⚠️ CLI 不支持
 
 Gate 4→5: ✅ status=1
 
@@ -261,7 +263,7 @@ Gate 4→5: ✅ status=1
 #### Phase 6: 运营维护
 
   → read references/subs/query/SOP.md 执行（进度/记录/人脸）
-  → read references/subs/publish/SOP.md 执行（关闭/删除，⚠️）
+  → read references/subs/publish/SOP.md 执行（关闭/删除；删除仅允许 status=0/2）
   → read references/subs/copy/SOP.md 执行（复制，⚠️）
 
 ### 3.3 课件子流程
@@ -291,7 +293,7 @@ Gate 4→5: ✅ status=1
 
 ### 3.8 维护子流程
 
-流程: read references/subs/publish/SOP.md（关闭/删除）/ references/subs/copy/SOP.md（复制）/ references/subs/category/SOP.md（分类）
+流程: read references/subs/publish/SOP.md（关闭/删除，删除前必须校验 status=0 未发布或 status=2 已关闭）/ references/subs/copy/SOP.md（复制）/ references/subs/category/SOP.md（分类）
 
 ### SOP 执行 5 步法
 
@@ -378,11 +380,11 @@ Gate 4→5: ✅ status=1
 |------|------|
 | 课件类型 | image/article/link/quiz/homework |
 | 分类 | 新增分类 |
-| 课程设置 | credit/point/lector_id/tags/cover上传/简介插图 |
-| 高级设置 | 学习模式/倍速/人脸/提醒/评价/证书/签名/钉钉群 |
+| 课程设置 | point/lector_id/tags/简介插图 |
+| 高级设置 | 证书/签名 |
 | 收费 | 价格/试看 |
-| 发布 | 定时/审批/批量 |
-| 维护 | 关闭/删除/复制 |
+| 发布 | 审批/批量 |
+| 维护 | 复制 |
 
 ### 中断恢复
 用户"继续"/"接着做": 检查 course-id → 有:查状态+课件→报告→继续 | 无:列课程→选→恢复

package/skills/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/references/intent-cases.md

@@ -30,14 +30,14 @@
 | 14 | "换个封面" | cover | Phase 3（⚠️ CLI 不支持） |
 | 15 | "加几个标签" | tags | Phase 3（⚠️ CLI 不支持） |
 
-## advanced_settings（高级设置）
+## advanced（高级设置）
 
 | # | 用户输入 | 提取 | 路由 |
 |---|---------|------|------|
-| 16 | "开启倍速" | speed | Phase 3（⚠️ 不支持） |
-| 17 | "改成解锁式学习" | study_type=2 | Phase 3（⚠️ 不支持） |
-| 18 | "开启人脸识别" | face_recognition | Phase 3（⚠️ 不支持） |
-| 19 | "设置未学提醒，每周推送" | remind_cycle=7 | Phase 3（⚠️ 不支持） |
+| 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（收费）
@@ -53,7 +53,7 @@
 |---|---------|------|------|
 | 23 | "发布课程" | publish | Phase 4 |
 | 24 | "上线吧" | publish | Phase 4 |
-| 25 | "定时发布，下周一早上9点" | scheduled | Phase 4（⚠️ 不支持） |
+| 25 | "定时发布，下周一早上9点" | scheduled, publish_time | Phase 4 |
 | 26 | "提交审批" | approval | Phase 4（⚠️ 不支持） |
 
 ## assign（指派）
@@ -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/references/sop-full-workflow.md

@@ -92,8 +92,10 @@ Gate 2→3: ✅ lesson_ids 长度 ≥ 1
 
 ### Step 3.2: 高级设置
   调度: soke-course-settings
-  全部 ⚠️ CLI 不支持，统一告知:
-    "高级设置（学习模式/倍速/人脸/提醒/评价/证书/签名/钉钉群）需在后台→课程编辑→高级设置中手动配置。"
+  操作: course +advanced --course-id <uuid> ...
+  支持: 学习模式/待办推送/截止后学习/人脸识别/学习中人脸识别/未学提醒/倍速/拖动/评价/交流群二维码/文档防挂机/评论
+  交流群二维码: 用户给本地图片时，使用 course +advanced --image-file <path>，命令内部只上传 OSS 并生成 imageOssUrl，不进入图片库
+  证书/签名仍需后台操作。
 
 ### Step 3.3: 收费设置（可选）
   读取: subs/charge/SOP.md 执行
@@ -120,12 +122,13 @@ Gate 3→4: 无硬阻塞（设置可跳过）
     仅警告 → 询问是否忽略
 
 ### Step 4.2: 执行发布
-  自身: course +publish --course-id <uuid>
+  直接发布: course +publish --course-id <uuid>
+  定时发布: course +publish --course-id <uuid> --publish-time "<北京时间>"
   提取: 发布状态 → 存上下文
   失败: 检查 Gate Check 结果
 
 ### Step 4.3: 后续（可选）
-  定时发布/审批/批量 → ⚠️ CLI 不支持 → 告知后台路径
+  审批/批量 → ⚠️ CLI 不支持 → 告知后台路径
 
 Gate 4→5: ✅ status=1
 
@@ -163,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/references/sop-publish-check.md

@@ -52,8 +52,10 @@
 - 审批人为空 → 默认通过
 - 多级审批: 一级不可删除，默认主管理员和或签
 
-## 定时发布（⚠️ CLI 暂不支持）
+## 定时发布
 
+- 执行: `course +publish --course-id <uuid> --publish-time "<北京时间>"`
+- 输入北京时间，会在规定时间发布课程
 - 到时间点自动发布并推送消息
 - 未到点时学员收不到消息、前端看不到
 

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

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

package/skills/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、标题、状态、创建时间、学习人数等摘要。