@sokeai/cli 1.0.78 → 1.0.80

package/skills/multi/soke-course/references/shared.md

@@ -1,185 +0,0 @@
----
-name: soke-shared
-summary: 授客CLI共享基础（配置/登录/权限/错误处理/安全规则）
-version: 1.0.0
-description: "授客CLI共享基础：应用配置初始化、认证登录（auth login）、权限管理、错误处理、安全规则。当用户需要第一次配置（soke-cli auth login）、使用登录授权（soke-cli auth login）、遇到权限不足、或首次使用soke-cli时触发。"
----
-
-# soke-cli 共享规则
-
-本技能指导你如何通过soke-cli操作授客AI资源，以及有哪些注意事项。
-
-## 配置初始化
-
-首次使用需运行 `soke-cli auth login` 完成应用配置。
-
-当你帮用户初始化配置时，引导用户按照交互式提示完成配置：
-
-```bash
-# 初始化配置
-soke-cli auth login
-```
-
-配置项包括：
-- `app_id`: 开放平台应用ID
-- `app_key`: 开放平台应用Key
-- `app_secret`: 开放平台应用Secret
-- `api_base_url`: API地址（默认: https://opendev.soke.cn）
-- `corpid`: 企业ID
-
-配置文件保存在 `~/.soke-cli/config.json`
-
-## 认证
-
-### 用户登录
-
-用户需要通过OAuth授权获取访问令牌：
-
-```bash
-# 用户登录授权
-soke-cli auth login
-```
-
-登录成功后，`access_token` 和 `refresh_token` 会自动保存到配置文件中。
-
-### Token管理
-
-- **access_token**: 用户访问令牌，用于调用API
-- **refresh_token**: 刷新令牌，用于获取新的access_token
-- Token过期后需要重新执行 `soke-cli auth login`
-
-### 查看当前配置
-
-```bash
-# 查看当前配置（不显示敏感信息）
-soke-cli config show
-```
-
-## 权限不足处理
-
-遇到权限相关错误时，通常有以下几种情况：
-
-### 1. 未登录或Token过期
-
-**错误特征**: 返回401 Unauthorized或Token无效
-
-**解决方案**:
-```bash
-soke-cli auth login
-```
-
-### 2. 缺少必要权限
-
-**错误特征**: 返回403 Forbidden或权限不足提示
-
-**解决方案**:
-- 联系管理员在开放平台后台为应用开通相应权限
-- 确认企业ID（corpid）和应用配置正确
-
-### 3. 参数错误
-
-**错误特征**: 返回400 Bad Request或参数验证失败
-
-**解决方案**:
-- 检查必需参数是否提供
-- 使用 `--help` 查看命令参数说明
-- 参考API文档确认参数格式
-
-## 命令结构
-
-### Shortcuts（推荐）
-
-Shortcuts是对常用操作的高级封装，参数友好，最适合AI Agent调用：
-
-```bash
-soke-cli <service> +<verb> [flags]
-```
-
-示例：
-```bash
-soke-cli exam +get-exam-user --exam-id exam123 --dept-user-id user456
-soke-cli course +list-courses --page 1 --page-size 10
-```
-
-### 通用API调用
-
-支持直接调用任意API：
-
-```bash
-soke-cli api <METHOD> <path> [--data <json>] [--params <json>]
-```
-
-示例：
-```bash
-soke-cli api GET /users/me
-soke-cli api POST /some/endpoint --data '{"key": "value"}'
-```
-
-## 输出格式
-
-### JSON格式（默认）
-
-所有命令默认输出JSON格式，便于程序解析：
-
-```bash
-soke-cli exam +list-exams --format json
-```
-
-### 表格格式
-
-部分命令支持表格格式输出，更易读：
-
-```bash
-soke-cli exam +list-exams --format table
-```
-
-## 安全规则
-
-- **禁止输出密钥**（app_secret、access_token）到终端明文
-- **写入/删除操作前必须确认用户意图**
-- 敏感操作建议先使用 `--dry-run`（如果支持）预览
-
-## 错误处理
-
-当命令执行失败时：
-
-1. **检查配置**: 运行 `soke-cli config show` 确认配置正确
-2. **检查登录状态**: 如果是认证错误，运行 `soke-cli auth login`
-3. **检查参数**: 使用 `soke-cli <service> <command> --help` 查看参数说明
-4. **查看错误信息**: 错误响应中通常包含详细的错误原因
-
-## 常见问题
-
-### Q: 如何获取app_key和app_secret？
-
-A: 登录授客AI开放平台（https://opendev.soke.cn），创建应用后即可获取。
-
-### Q: Token过期了怎么办？
-
-A: 重新执行 `soke-cli auth login` 进行授权。
-
-### Q: 如何切换企业？
-
-A: 运行 `soke-cli auth login` 重新配置，或直接编辑 `~/.soke-cli/config.json` 文件。
-
-### Q: 支持哪些业务模块？
-
-A: 目前支持以下模块：
-- `contact`: 组织架构（部门、用户、岗位、讲师）
-- `course`: 课程管理
-- `exam`: 考试管理
-- `training`: 培训管理
-- `learning_map`: 学习地图
-- `credit`: 学分管理
-- `point`: 积分管理
-- `news`: 资讯管理
-- `certificate`: 证书管理
-- 等等...
-
-每个模块都有对应的Skill，AI Agent会根据用户意图自动选择。
-
-## 相关链接
-
-- 授客AI开放平台: https://opendev.soke.cn
-- NPM包: @sokeai/cli
-- 代码仓库: https://codeup.aliyun.com/5edbc121d1d1abe63b55f1c7/soke/soke-cli.git

package/skills/multi/soke-course/references/subs/ai/SOP.md

@@ -1,153 +0,0 @@
----
-name: soke-course-ai
-version: 1.0.0
-description: AI做课（远期规划） — 7项AI功能概述，全部需后台操作
-tags: [soke, ai, smart-generation, auto-courseware, future]
----
-
-# AI做课（远期规划）
-
-## 触发描述
-
-用户询问是否支持 AI 自动生成课程、AI 智能出题、AI 课件制作等功能时触发本技能。以下所有功能均为远期规划，CLI 不支持，需通过后台操作。
-
-## ⚠️ CLI 不支持
-
-所有 AI 做课功能均需前往：
-
-```
-后台 → 课程管理 → AI做课
-```
-
-## AI 功能全景
-
-### 1. AI 智能生成 `smart_generation`
-
-自动生成课程核心元信息：
-
-- **课程标题**：根据输入主题/关键词生成多个备选标题
-- **课程封面**：AI 生成课程封面图（多种风格可选）
-- **课程描述**：自动撰写课程简介和学习目标
-- **讲师介绍**：生成讲师简介文案
-
-```
-后台 → 课程管理 → AI做课 → 智能生成
-```
-
-### 2. AI 文件导入 `file_import`
-
-支持导入以下文件格式自动解析为课程结构：
-
-| 格式 | 说明 |
-|------|------|
-| **Word (.docx)** | 解析标题层级生成章节，正文生成课件内容 |
-| **Xmind (.xmind)** | 解析思维导图结构，中心主题→课程，分支→章节 |
-| **Freemind (.mm)** | 同上，FreeMind 思维导图格式 |
-| **Markdown (.md)** | 解析 H1-H6 标题生成课程层级 |
-| **PPT (.pptx)** | 每页幻灯片生成一节课件，讲义区生成课件描述 |
-
-```
-后台 → 课程管理 → AI做课 → 文件导入
-```
-
-### 3. AI 课件制作 `ai_lesson_creation`
-
-对视频/音频课件进行智能处理：
-
-| 功能 | 说明 |
-|------|------|
-| **AI 字幕** | 自动语音识别 (ASR) 生成字幕，支持多语言 |
-| **互动题** | 在视频播放中插入互动选择题，提升参与度 |
-| **推荐题** | AI 分析课件内容后推荐相关练习题 |
-| **随堂小测** | 课件学完后自动弹出 AI 生成的迷你测验 |
-
-```
-后台 → 课程管理 → AI做课 → 课件制作
-```
-
-### 4. AI 课上测验 `ai_in_class_quiz`
-
-基于课件内容自动生成课堂测验：
-
-- 支持单选题、多选题、判断题
-- 题目难度自动分级（简单/中等/困难）
-- 批量生成，人工审核后发布
-
-```
-后台 → 课程管理 → AI做课 → 课上测验
-```
-
-### 5. AI 智能学习 `ai_smart_learning`
-
-构建课程知识库以实现智能化学习体验：
-
-- 提取课件核心知识点建立知识图谱
-- 学员可向 AI 提问课程相关问题
-- AI 根据学员薄弱点推荐复习内容
-- 支持知识库自定义补充 FAQ
-
-```
-后台 → 课程管理 → AI做课 → 智能学习
-```
-
-### 6. AI 作业 `ai_homework`
-
-AI 辅助作业设计：
-
-- 根据课程内容自动生成作业题目
-- 支持主观题 AI 辅助批改
-- 生成作业参考答案与评分标准
-- 个性化作业推荐（薄弱知识点针对性练习）
-
-```
-后台 → 课程管理 → AI做课 → AI作业
-```
-
-### 7. AI 绘图 `ai_art`
-
-AI 生成课程视觉素材：
-
-- **课程封面生成**：多种风格（扁平、3D、手绘、科技、商务等）
-- **课件配图**：根据课件内容自动生成插图
-- **证书背景**：AI 生成结业证书背景图
-- **品牌素材**：课程 Logo、水印等视觉元素
-
-```
-后台 → 课程管理 → AI做课 → AI绘图
-```
-
-## 输出标准
-
-当用户询问 AI 做课功能时，输出：
-
-```
-🤖 AI 做课功能（远期规划 — 全部需后台操作）
-
-支持 7 大功能，入口：后台 → 课程管理 → AI做课
-
-1. 智能生成 — 标题/封面/描述/讲师
-2. 文件导入 — Word/Xmind/Freemind/Markdown/PPT
-3. 课件制作 — 字幕/互动题/推荐题/随堂小测
-4. 课上测验 — 自动出题，多题型，难度分级
-5. 智能学习 — 知识库 + AI问答 + 智能推荐
-6. AI 作业 — 自动出题 + 辅助批改 + 个性化推荐
-7. AI 绘图 — 封面/配图/证书背景/品牌素材
-
-⚠️ 以上功能 CLI 均不支持，请前往后台操作。
-```
-
-## 注意事项
-
-1. 以上功能为远期规划，具体上线时间和功能范围以产品实际发布为准
-2. AI 生成内容（标题/描述/题目/封面等）建议人工审核后使用
-3. 文件导入的解析效果取决于源文件格式规范程度，建议导入后检查结构完整性
-4. AI 字幕的识别准确率受视频音频质量影响，建议提供清晰音质的素材
-5. AI 作业批改仅适用于客观题和结构化主观题，开放性问题准确率有限
-6. AI 绘图生成的视觉素材建议确认版权和使用条款后再投入使用
-7. 所有 AI 功能均需消耗 AI 调用配额，具体额度以租户套餐为准
-
-## 检查清单
-
-- [ ] 用户已了解所有 AI 功能为远期规划
-- [ ] 用户已确认需要前往后台操作
-- [ ] 如涉及具体功能，已提供对应后台路径

package/skills/multi/soke-course/scripts/check_readiness.py

@@ -1,87 +0,0 @@
-#!/usr/bin/env python3
-"""Check that the soke-course Skill and CLI prerequisites are available."""
-
-from __future__ import annotations
-
-import shutil
-import subprocess
-import sys
-from pathlib import Path
-
-
-def check_command() -> bool:
-    executable = shutil.which("soke-cli")
-    if not executable:
-        print("  ❌ soke-cli 未安装")
-        print("     请读取 references/installation.md 按步骤安装")
-        return False
-
-    try:
-        version = subprocess.run(
-            [executable, "--version"],
-            check=False,
-            capture_output=True,
-            text=True,
-        ).stdout.strip()
-    except OSError as exc:
-        print(f"  ❌ soke-cli 无法执行: {exc}")
-        return False
-
-    print(f"  ✅ soke-cli: {version or '已找到'}")
-    return True
-
-
-def check_login() -> None:
-    executable = shutil.which("soke-cli")
-    if not executable:
-        return
-    result = subprocess.run(
-        [executable, "config", "show"],
-        check=False,
-        capture_output=True,
-        text=True,
-    )
-    output = f"{result.stdout}\n{result.stderr}"
-    if "user_token" in output:
-        print("  ✅ 已登录")
-    else:
-        print("  ⚠️  未登录或 Token 过期")
-        print("     请运行: soke-cli auth login")
-
-
-def main() -> int:
-    base_dir = Path(__file__).resolve().parent.parent
-    print("🔍 课程发布主管 — 环境检查")
-    print("============================\n")
-
-    guide = base_dir / "references" / "installation.md"
-    print("📖 前置依赖:")
-    print(f"  {'✅' if guide.is_file() else '❌'} references/installation.md {'存在' if guide.is_file() else '缺失'}")
-
-    print("\n🔧 命令行工具:")
-    available = check_command()
-    if available:
-        check_login()
-
-    print("\n📋 包内依赖:")
-    for name in ("soke-material", "soke-lesson", "soke-assign"):
-        dependency = base_dir / "references" / "dependencies" / f"{name}.md"
-        print(f"  {'✅' if dependency.is_file() else '⚠️'} {name}")
-
-    print("\n📁 子能力 SOP:")
-    for name in ("category", "settings", "charge", "publish", "copy", "query", "ai"):
-        sop = base_dir / "references" / "subs" / name / "SOP.md"
-        print(f"  {'✅' if sop.is_file() else '⚠️'} {name}")
-
-    print("\n📚 参考文档:")
-    for name in ("intent-cases.md", "sop-full-workflow.md", "sop-lesson-types.md", "sop-publish-check.md", "troubleshoot.md"):
-        reference = base_dir / "references" / name
-        print(f"  {'✅' if reference.is_file() else '⚠️'} {name}")
-
-    print("\n✅ 环境检查完成")
-    return 0 if available else 1
-
-
-if __name__ == "__main__":
-    sys.exit(main())
-