@sokeai/cli 1.0.64 → 1.0.66

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

@@ -0,0 +1,223 @@
+---
+name: course-template
+version: 1.1.0
+description: 课程模板选择 — 7套预置配置，按业务场景快速初始化课程设置
+tags: [soke, course, template, preset]
+---
+
+# 课程模板
+
+## 触发描述
+
+创建课程（Step 1.3 完成）后立即触发。根据用户业务场景推荐对应模板，输出预置配置清单。Phase 3 时展示当前所有设置项，用户可用自然语言逐项覆盖。
+
+## 模板速查
+
+| # | 模板名称 | 一句话场景 | 特征标签 |
+|---|---------|-----------|---------|
+| 1 | 合规必修（最严） | 安全/合规/法务培训 | 🔒最严管控 |
+| 2 | 考核认证 | 上岗/资格/技能鉴定 | 📝考试+证书 |
+| 3 | 新人入职 | 新员工/转岗培训 | 🚀快速上手 |
+| 4 | 知识分享 | 内部分享/兴趣课程 | 📖自由学习 |
+| 5 | 领导力/软技能 | 管理/沟通/职业素养 | 🎓进阶提升 |
+| 6 | 产品/业务培训 | 新产品上线/业务更新 | 📦快速推送 |
+| 7 | 不选择模板 | 手动逐项配置 | ✋自行设置 |
+
+---
+
+## 配置映射表
+
+### 1. 合规必修（最严）
+
+| 设置项 | 值 | CLI | 说明 |
+|--------|-----|:---:|------|
+| 学习模式 | 必修 + 解锁式(LongDragon) | ⚠️ | 后台：学习设置 |
+| 人脸识别 | 开启 | ⚠️ | 后台：学习设置 → 人脸识别 |
+| 倍速播放 | 禁用 | ⚠️ | 后台：学习设置 → 播放控制 |
+| 拖动进度条 | 禁用 | ⚠️ | 后台：学习设置 → 播放控制 |
+| 电子签名 | 开启 | ⚠️ | 后台：证书设置 → 签名管理 |
+| 收费 | 可选 | ⚠️ | 后台：收费设置 |
+| 截止时间 | 需设置 | ⚠️ | 后台：学习设置 |
+| 课程评价 | 打星评价 | ⚠️ | 后台：评价设置 |
+| 关联证书 | 是 | ⚠️ | 后台：证书设置 |
+| 发布方式 | 审批发布 | ⚠️ | 后台：发布设置 |
+
+**适用场景**：安全培训、合规培训、法务必修课。需要强制学习+防作弊+可追溯。
+
+---
+
+### 2. 考核认证
+
+| 设置项 | 值 | CLI | 说明 |
+|--------|-----|:---:|------|
+| 学习模式 | 必修 + 解锁式(LongDragon) | ⚠️ | 后台：学习设置 |
+| 小测验 | 限制次数 | ⚠️ | 后台：课件设置 |
+| 作业 | 多级审批 | ⚠️ | 后台：课件设置 |
+| 人脸识别 | 选开 | ⚠️ | 后台：学习设置 → 人脸识别 |
+| 关联证书 | 是 | ⚠️ | 后台：证书设置 |
+| 发布方式 | 审批发布 | ⚠️ | 后台：发布设置 |
+
+**适用场景**：上岗考试、资格认证、技能鉴定。需考核+认证背书。
+
+---
+
+### 3. 新人入职
+
+| 设置项 | 值 | CLI | 说明 |
+|--------|-----|:---:|------|
+| 学习模式 | 必修 + 自由模式(Free) | ⚠️ | 后台：学习设置 |
+| 倍速播放 | 开启 | ⚠️ | 后台：学习设置 → 播放控制 |
+| 未学提醒 | 开启 | ⚠️ | 后台：学习设置 → 提醒设置 |
+| 截止时间 | 需设置 | ⚠️ | 后台：学习设置 |
+| 自动配课 | 开启 | ⚠️ | 后台：指派设置 |
+| 课程评价 | 打星评价 | ⚠️ | 后台：评价设置 |
+
+**适用场景**：新员工培训、转岗培训。需快速覆盖+自动推送+追踪完成。
+
+---
+
+### 4. 知识分享
+
+| 设置项 | 值 | CLI | 说明 |
+|--------|-----|:---:|------|
+| 学习模式 | 选修 + 自由模式(Free) | ⚠️ | 后台：学习设置 |
+| 倍速播放 | 开启 | ⚠️ | 后台：学习设置 → 播放控制 |
+| 拖动进度条 | 允许 | ⚠️ | 后台：学习设置 → 播放控制 |
+| 收费 | 免费 | ⚠️ | 后台：收费设置 |
+| 小测验 | 不限次数 | ⚠️ | 后台：课件设置 |
+
+**适用场景**：内部分享、兴趣课程、文化宣传。低门槛+自由学习+无考核压力。
+
+---
+
+### 5. 领导力/软技能
+
+| 设置项 | 值 | CLI | 说明 |
+|--------|-----|:---:|------|
+| 学习模式 | 选修或必修 + 自由模式(Free) | ⚠️ | 后台：学习设置 |
+| 作业 | 无需批改 | ⚠️ | 后台：课件设置 |
+| 课程评价 | 打星评价 | ⚠️ | 后台：评价设置 |
+| 关联证书 | 可选 | ⚠️ | 后台：证书设置 |
+| 钉钉群 | 可配置 | ⚠️ | 后台：学习设置 → 钉钉二维码 |
+
+**适用场景**：管理培训、沟通课程、职业素养。互动+讨论+可选认证。
+
+---
+
+### 6. 产品/业务培训
+
+| 设置项 | 值 | CLI | 说明 |
+|--------|-----|:---:|------|
+| 学习模式 | 必修 + 自由模式(Free) | ⚠️ | 后台：学习设置 |
+| 倍速播放 | 开启 | ⚠️ | 后台：学习设置 → 播放控制 |
+| 拖动进度条 | 允许 | ⚠️ | 后台：学习设置 → 播放控制 |
+| 小测验 | 开启 | ⚠️ | 后台：课件设置 |
+| 定时发布 | 需设置 | ⚠️ | 后台：发布设置 |
+| 未学提醒 | 开启 | ⚠️ | 后台：学习设置 → 提醒设置 |
+
+**适用场景**：新产品上线、业务知识更新。需快速推送+检验理解+追踪覆盖。
+
+---
+
+### 7. 不选择模板
+
+不预置任何配置项，所有设置在 Phase 3 逐项手动确认。适合模板不匹配的场景或需要精细控制的课程。
+
+---
+
+## 执行流程
+
+### Step 1: 模板选择弹窗（Phase 1 创建课程后立即触发）
+
+**先输出速查表：**
+
+```
+📋 可选模板（7种）：
+
+| # | 名称 | 适用场景 | 核心配置 |
+|---|------|---------|---------|
+| 1 | 合规必修 | 安全/合规/法务培训 | 人脸+签名+证书+审批 |
+| 2 | 考核认证 | 上岗考试/资格认证 | 考试+证书+多级审批 |
+| 3 | 新人入职 | 新员工/转岗培训 | 提醒+自动配课+评价 |
+| 4 | 知识分享 | 内部分享/兴趣课程 | 自由学习+免费+不限测验 |
+| 5 | 领导力/软技能 | 管理/沟通/职业素养 | 作业+评价+证书+钉钉群 |
+| 6 | 产品/业务培训 | 新产品上线/业务更新 | 定时发布+小测验+提醒 |
+| 7 | 不选择模板 | 模板不匹配/精细控制 | 无预设，后续逐项手动配置 |
+```
+
+**再弹窗让用户选：**
+
+```
+ask_user_question
+  question: "选择课程模板（7选1，详情见上方表格）"
+  header: "模板"
+  options:
+    - label: "1. 合规必修"     description: "安全/合规/法务 · 人脸+签名+证书+审批"
+    - label: "2. 考核认证"     description: "上岗考试/资格认证 · 考试+证书"
+    - label: "3. 新人入职"     description: "新员工/转岗 · 提醒+配课+评价"
+    - label: "4. 知识分享"     description: "内部分享/兴趣 · 自由学习+免费"
+    - label: "5. 领导力/软技能" description: "管理/沟通/素养 · 作业+证书+钉钉群"
+    - label: "6. 产品/业务培训" description: "产品上线/业务更新 · 定时+测验+提醒"
+    - label: "7. 不选择模板"   description: "无预设，逐项手动配置"
+```
+
+### Step 2: 输出模板配置
+
+用户选 1-6 → 输出该模板完整配置表：
+
+```
+✅ 已选择「{模板名称}」模板
+
+📋 该模板预置以下设置（CLI 不支持，需后台操作）：
+
+| 设置项 | 预置值 | 后台路径 |
+|--------|--------|---------|
+| xxx    | xxx    | 后台 → xxx |
+| ...    | ...    | ...       |
+
+⏭️ 后续进入 Phase 3 时，可以逐项修改以上设置。回复"继续"进入下一步。
+```
+
+用户选 7.「不选择模板」→ 不输出配置清单，直接进入 Phase 1 的路由弹窗。
+
+### Step 3: Phase 3 展示当前设置（可逐项修改）
+
+进入 Phase 3 时，将当前课程所有设置项以表格形式展示：
+
+```
+📋 当前设置（模板: {模板名称}）：
+
+| 设置项 | 当前值 |
+|--------|--------|
+| 标题   | "xxx"  |
+| 描述   | "xxx"  |
+| 学习模式 | 必修+解锁式 |
+| 人脸识别 | 开启 |
+| ... | ... |
+
+💬 想修改哪项？直接告诉我就行，比如：
+  - "标题改成 xxx"
+  - "学习模式改成自由式"
+  - "关掉人脸识别"
+  - "加一个证书"
+```
+
+用户输入修改指令后的处理：
+
+| 修改项 | CLI 支持 | 处理方式 |
+|--------|:---:|------|
+| 标题/描述 | ✅ | 执行 `course +update` 更新，表中同步刷新 |
+| 其他所有设置 | ⚠️ | "该设置需在后台修改（路径: xxx）。我会在清单中标注为待修改。" |
+| 修改模板预设值 | ⚠️ | "已记录：{设置项} → {新值}（需在后台操作）" |
+
+每次修改后刷新配置表，直到用户说"可以了"/"继续"进入下一步。
+
+---
+
+## 注意事项
+
+1. 模板选择后不自动通过 CLI 修改课程 — 大部分设置 CLI 不支持
+2. 模板选择不影响已创建的 title/description/category-id
+3. Phase 3 必须展示完整设置清单，让用户逐项确认/修改
+4. 用户选「不选择模板」(7)时，Phase 3 也需展示所有可配置项，方便用户了解能做什么
+5. 若用户选了模板但没去后台配置，发布阶段 Gate Check 可能阻塞

package/skills/soke-course/references/troubleshoot.md

@@ -0,0 +1,68 @@
+# 常见问题排错指南
+
+## 认证类
+
+| 错误信息 | 原因 | 修复 |
+|---------|------|------|
+| `access_key_id not configured` | 未配置登录凭证 | `soke-cli config set --key access_key_id --value <your-key>` |
+| `Token 过期 / 401 Unauthorized` | 登录 Token 已过期 | `soke-cli auth login` |
+| `Permission denied / 403` | 当前账号无操作权限 | 联系管理员在开放平台开通权限 |
+
+## 课程操作类
+
+| 错误信息 | 原因 | 修复 |
+|---------|------|------|
+| `课程标题为空` | 未设置标题 | `course +update --course-id <id> --title "标题"` |
+| `分类不存在 / category not found` | category-id 无效 | `course +list-categories` 重新查询有效分类 |
+| `课程不存在 / Course not found` | course-id 无效或已删除 | `course +list-courses` 确认课程列表 |
+| `课程状态不是未发布，不能发布` | status=1(已发布)或2(已关闭) | 已发布无需操作；已关闭不能重新发布 |
+| `课件数量不足` | 课程无课件 | 进入 Phase 2 添加课件 |
+
+## 上传类
+
+| 错误信息 | 原因 | 修复 |
+|---------|------|------|
+| `file not found` | 文件路径错误或不存在 | 检查路径是否正确，使用绝对路径 |
+| `文件类型不支持` | 格式不在支持列表中 | 转换为 .mp4/.mp3/.pdf 等支持格式 |
+| `文件大小超过限制` | 文件超过上限 | 压缩文件后重试 |
+| `OSS upload failed` | 网络问题或 Token 失效 | 重新登录后重试 |
+| `转码失败` | 文件损坏或格式异常 | 删除失败课件，确认源文件可用后重新上传 |
+
+## 课件操作类
+
+| 错误信息 | 原因 | 修复 |
+|---------|------|------|
+| `素材不存在 / media not found` | media-id 无效 | 确认素材已上传成功 `file +list-files` |
+| `课件类型不匹配` | type 与素材不符 | type 必须与素材上传响应的 type 一致 |
+| `课件已存在` | 重复创建 | 检查 `course +lesson-list` |
+| `课件数量达到上限` | 课程课件数超标 | 删除不需要的课件 |
+
+## 指派类
+
+| 错误信息 | 原因 | 修复 |
+|---------|------|------|
+| `课程未发布，不能指派` | status ≠ 1 | 先发布课程再指派 |
+| `用户不存在` | user-id 无效 | `assign +list-users` 确认有效用户 |
+| `部门不存在` | dept-id 无效 | `assign +list-departments` 确认有效部门 |
+
+## 查询类
+
+| 错误信息 | 原因 | 修复 |
+|---------|------|------|
+| `时间范围超过365天` | +list-courses 限制 | 分批查询，每年一次 |
+| `数据为空` | 筛选条件无匹配 | 放宽筛选条件或检查权限范围 |
+
+## 通用调试步骤
+
+```bash
+# 1. 检查认证状态
+soke-cli config show
+
+# 2. 检查课程是否存在
+soke-cli course +get-course --course-id "xxx" --format json
+
+# 3. 检查课件状态
+soke-cli course +lesson-list --course-id "xxx" --format json
+
+# 4. 始终使用 --format json 获取结构化输出
+```

package/skills/soke-course/scripts/check_readiness.sh

@@ -0,0 +1,82 @@
+#!/bin/bash
+# soke-course 环境就绪检查
+# 检查 soke-cli 安装、登录状态、子能力 SOP 完整性
+
+set -e
+
+BASE_DIR="$(cd "$(dirname "$0")/.." && pwd)"
+
+echo "🔍 课程发布主管 — 环境检查"
+echo "============================"
+echo ""
+
+# 0. 安装指南
+echo "📖 前置依赖:"
+GUIDE="$BASE_DIR/soke-cli安装指南.md"
+if [ -f "$GUIDE" ]; then
+    echo "  ✅ soke-cli安装指南.md 存在"
+else
+    echo "  ❌ soke-cli安装指南.md 缺失 — AI 将无法读取认证说明"
+fi
+
+# 1. 检查 soke-cli
+echo ""
+echo "🔧 命令行工具:"
+if ! command -v soke-cli &> /dev/null; then
+    echo "  ❌ soke-cli 未安装"
+    echo "     请 Read soke-cli安装指南.md 按步骤安装"
+    exit 1
+fi
+echo "  ✅ soke-cli: $(soke-cli --version)"
+
+# 2. 检查登录状态
+CONFIG=$(soke-cli config show 2>/dev/null || echo "")
+if echo "$CONFIG" | grep -q "user_token"; then
+    echo "  ✅ 已登录"
+else
+    echo "  ⚠️  未登录或 Token 过期"
+    echo "     请运行: soke-cli auth login"
+    echo "     详见: soke-cli安装指南.md → 用户登录授权"
+fi
+
+# 3. 检查并列 skill
+echo ""
+echo "📋 并列技能:"
+PARALLEL_SKILLS=("soke-material" "soke-lesson" "soke-assign")
+for skill in "${PARALLEL_SKILLS[@]}"; do
+    SKILL_PATH="$BASE_DIR/../$skill/SKILL.md"
+    if [ -f "$SKILL_PATH" ]; then
+        echo "  ✅ $skill"
+    else
+        echo "  ⚠️  $skill (未找到)"
+    fi
+done
+
+# 4. 检查内嵌子能力 SOP
+echo ""
+echo "📁 子能力 SOP (references/subs/):"
+SUBS=("category" "settings" "charge" "publish" "copy" "query" "ai")
+for sub in "${SUBS[@]}"; do
+    SOP_PATH="$BASE_DIR/references/subs/$sub/SOP.md"
+    if [ -f "$SOP_PATH" ]; then
+        echo "  ✅ $sub"
+    else
+        echo "  ⚠️  $sub (未找到)"
+    fi
+done
+
+# 5. 检查 references 参考文件
+echo ""
+echo "📚 参考文档:"
+REFS=("intent-cases.md" "sop-full-workflow.md" "sop-lesson-types.md" "sop-publish-check.md" "troubleshoot.md")
+for ref in "${REFS[@]}"; do
+    REF_PATH="$BASE_DIR/references/$ref"
+    if [ -f "$REF_PATH" ]; then
+        echo "  ✅ $ref"
+    else
+        echo "  ⚠️  $ref (未找到)"
+    fi
+done
+
+echo ""
+echo "✅ 环境检查完成"