@sokeai/cli 1.0.0 → 1.0.2

package/README.md

@@ -42,9 +42,52 @@ cd soke-cli
 make install
 ```
 
+## AI Agent Skills
+
+`soke-cli` 提供了 AI Agent 技能（Skills），使 AI 助手能够自动发现和调用 CLI 功能，无需记忆复杂的命令参数。
+
+### 安装 Skills
+
+```bash
+# 安装 CLI 后，安装 AI Agent Skills
+npx skills add liuchenlong1111/soke-cli -y -g
+```
+
+### 使用方式
+
+安装 Skills 后，在支持 Skills 的 AI Agent（如 Claude Code）中，可以直接用自然语言描述需求：
+
+- **"查询考试成绩"** - AI 会自动调用 `soke-cli exam +get-exam-user`
+- **"列出最近的考试"** - AI 会自动调用 `soke-cli exam +list-exams`
+- **"查看考试分类"** - AI 会自动调用 `soke-cli exam +list-categories`
+
+AI Agent 会自动：
+1. 识别你的意图
+2. 选择合适的命令
+3. 提示你提供必要的参数
+4. 执行命令并展示结果
+
+### 可用的 Skills
+
+- **soke-shared**: 配置初始化、用户认证、权限处理等基础功能
+- **soke-exam**: 考试管理（查询考试、考试成绩、考试分类）
+- 更多业务模块的 Skills 正在开发中...
+
+详细文档：[skills/README.md](skills/README.md)
+
 ## 快速开始
 
-### 1. 初始化配置
+### 1. 安装 CLI 和 Skills
+
+```bash
+# 安装 CLI
+npm install -g @sokeai/cli
+
+# 安装 AI Agent Skills（可选，推荐）
+npx skills add liuchenlong1111/soke-cli -y -g
+```
+
+### 2. 初始化配置
 首次使用前，需要配置你的开放平台凭证：
 ```bash
 soke-cli config init
@@ -53,7 +96,7 @@ soke-cli config init
 
 可以使用 `soke-cli config show` 来查看当前配置。
 
-### 2. 用户登录授权
+### 3. 用户登录授权
 配置完成后，进行设备授权登录：
 ```bash
 soke-cli auth login
@@ -61,6 +104,26 @@ soke-cli auth login
 命令会返回一个设备码和链接，请在浏览器中打开链接并输入设备码完成授权。成功后即可调用需要用户授权的接口。
 如果需要退出登录，可以执行 `soke-cli auth logout`。
 
+### 4. 开始使用
+
+**方式一：通过 AI Agent（推荐）**
+
+如果已安装 Skills，在 AI Agent 中直接用自然语言：
+```
+"查询考试成绩"
+"列出最近的考试"
+```
+
+**方式二：直接使用命令行**
+
+```bash
+# 查看课程列表
+soke-cli course +list-courses --start-time 1672502400000 --end-time 1704038400000
+
+# 查询考试成绩
+soke-cli exam +get-exam-user --exam-id exam123 --dept-user-id user456
+```
+
 ## 使用示例
 
 ### 调用快捷业务命令

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@sokeai/cli",
-    "version": "1.0.0",
-    "description": "授客AI官方CLI工具",
+    "version": "1.0.2",
+    "description": "授客AI官方CLI工具 - 支持AI Agent Skills",
     "bin": {
         "soke-cli": "scripts/run.js"
     },
@@ -15,14 +15,17 @@
     ],
     "repository": {
         "type": "git",
-        "url": "https://codeup.aliyun.com/5edbc121d1d1abe63b55f1c7/soke/soke-cli.git"
+        "url": "https://github.com/liuchenlong1111/soke-cli.git"
     },
     "keywords": [
         "soke",
         "cli",
         "授客AI",
         "shouke",
-        "command-line"
+        "command-line",
+        "ai-agent",
+        "skills",
+        "claude-code"
     ],
     "author": "授客AI",
     "license": "MIT",

package/scripts/e2e-test.sh

@@ -0,0 +1,207 @@
+#!/bin/bash
+
+# soke-cli 端到端测试脚本
+# 测试所有命令是否能正常执行
+# 支持按模块测试: ./e2e-test.sh [module_name]
+
+# 注意：不使用 set -e，让所有测试都能运行完
+
+# 颜色输出
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+# 测试结果统计
+TOTAL_TESTS=0
+PASSED_TESTS=0
+FAILED_TESTS=0
+FAILED_COMMANDS=()
+
+# 获取版本号
+VERSION=$(node -p "require('./package.json').version")
+
+# 获取要测试的模块（如果指定）
+TEST_MODULE=$1
+
+echo -e "${BLUE}========================================${NC}"
+if [ -z "$TEST_MODULE" ]; then
+    echo -e "${BLUE}  soke-cli E2E 测试 v${VERSION}${NC}"
+else
+    echo -e "${BLUE}  soke-cli E2E 测试 - ${TEST_MODULE} 模块${NC}"
+fi
+echo -e "${BLUE}========================================${NC}"
+echo ""
+
+# 检查是否已编译
+if [ ! -f "./soke-cli" ]; then
+    echo -e "${YELLOW}未找到编译文件，开始编译...${NC}"
+    go build -o soke-cli main.go
+    echo -e "${GREEN}✓ 编译完成${NC}"
+    echo ""
+fi
+
+# 检查是否已登录
+echo -e "${YELLOW}检查登录状态...${NC}"
+if ! ./soke-cli config show &>/dev/null; then
+    echo -e "${RED}错误: 未配置或未登录${NC}"
+    echo "请先运行: ./soke-cli config init && ./soke-cli auth login"
+    exit 1
+fi
+echo -e "${GREEN}✓ 已登录${NC}"
+echo ""
+
+# 测试函数
+test_command() {
+    local module=$1
+    local command=$2
+    local args=$3
+    local description=$4
+
+    TOTAL_TESTS=$((TOTAL_TESTS + 1))
+
+    echo -n "测试 [$module $command]: $description ... "
+
+    if ./soke-cli $module $command $args &>/dev/null; then
+        echo -e "${GREEN}✓ 通过${NC}"
+        PASSED_TESTS=$((PASSED_TESTS + 1))
+        return 0
+    else
+        echo -e "${RED}✗ 失败${NC}"
+        FAILED_TESTS=$((FAILED_TESTS + 1))
+        FAILED_COMMANDS+=("$module $command $args")
+        return 1
+    fi
+}
+
+# 判断是否应该运行某个模块的测试
+should_test_module() {
+    local module=$1
+    if [ -z "$TEST_MODULE" ]; then
+        return 0  # 没有指定模块，测试所有
+    elif [ "$TEST_MODULE" = "$module" ]; then
+        return 0  # 指定的模块匹配
+    else
+        return 1  # 不匹配，跳过
+    fi
+}
+
+echo -e "${BLUE}开始测试...${NC}"
+echo ""
+
+# ==================== Contact 模块 ====================
+if should_test_module "contact"; then
+    echo -e "${YELLOW}[Contact 模块]${NC}"
+    test_command "contact" "+list-departments" "" "获取部门列表"
+    test_command "contact" "+get-department" "--dept-id 1" "获取部门详情"
+    test_command "contact" "+list-department-users" "--dept-id 1" "获取部门用户列表"
+    test_command "contact" "+list-lectors" "" "获取讲师列表"
+    test_command "contact" "+list-groups" "--start-time 1672502400000 --end-time 1704038400000" "获取用户组列表"
+    test_command "contact" "+search-user" "--dept-user-name 测试" "搜索用户"
+    echo ""
+fi
+
+# ==================== Course 模块 ====================
+if should_test_module "course"; then
+    echo -e "${YELLOW}[Course 模块]${NC}"
+    test_command "course" "+list-courses" "--start-time 1672502400000 --end-time 1704038400000" "获取课程列表"
+    test_command "course" "+list-categories" "" "获取课程分类"
+    test_command "course" "+list-lessons" "--course-id F4025496-6566-4ACD-8CD4-06E3D55BBA79" "获取课程章节"
+    echo ""
+fi
+
+# ==================== Exam 模块 ====================
+if should_test_module "exam"; then
+    echo -e "${YELLOW}[Exam 模块]${NC}"
+    test_command "exam" "+list-exams" "--start-time 1672502400000 --end-time 1704038400000" "获取考试列表"
+    test_command "exam" "+list-categories" "" "获取考试分类"
+    echo ""
+fi
+
+# ==================== Certificate 模块 ====================
+if should_test_module "certificate"; then
+    echo -e "${YELLOW}[Certificate 模块]${NC}"
+    test_command "certificate" "+list-certificates" "--start-time 1672502400000 --end-time 1704038400000" "获取证书列表"
+    test_command "certificate" "+list-categories" "" "获取证书分类"
+    echo ""
+fi
+
+# ==================== Credit 模块 ====================
+if should_test_module "credit"; then
+    echo -e "${YELLOW}[Credit 模块]${NC}"
+    test_command "credit" "+list-logs" "--start-time 1672502400000 --end-time 1704038400000" "获取学分日志"
+    echo ""
+fi
+
+# ==================== Point 模块 ====================
+if should_test_module "point"; then
+    echo -e "${YELLOW}[Point 模块]${NC}"
+    test_command "point" "+list-logs" "--start-time 1672502400000 --end-time 1704038400000" "获取积分日志"
+    echo ""
+fi
+
+# ==================== Training 模块 ====================
+if should_test_module "training"; then
+    echo -e "${YELLOW}[Training 模块]${NC}"
+    test_command "training" "+list-trainings" "--start-time 1672502400000 --end-time 1704038400000" "获取培训列表"
+    test_command "training" "+list-categories" "" "获取培训分类"
+    echo ""
+fi
+
+# ==================== Learning Map 模块 ====================
+if should_test_module "learning-map"; then
+    echo -e "${YELLOW}[Learning Map 模块]${NC}"
+    test_command "learning-map" "+list-maps" "--start-time 1672502400000 --end-time 1704038400000" "获取学习地图列表"
+    test_command "learning-map" "+list-categories" "" "获取学习地图分类"
+    echo ""
+fi
+
+# ==================== News 模块 ====================
+if should_test_module "news"; then
+    echo -e "${YELLOW}[News 模块]${NC}"
+    test_command "news" "+list-news" "" "获取新闻列表"
+    test_command "news" "+list-categories" "" "获取新闻分类"
+    echo ""
+fi
+
+# ==================== Clock 模块 ====================
+if should_test_module "clock"; then
+    echo -e "${YELLOW}[Clock 模块]${NC}"
+    test_command "clock" "list-learnings" "--page 1 --page-size 10" "获取作业列表"
+    echo ""
+fi
+
+# ==================== File 模块 ====================
+if should_test_module "file"; then
+    echo -e "${YELLOW}[File 模块]${NC}"
+    test_command "file" "list-files" "" "获取素材库列表"
+    test_command "file" "list-categories" "" "获取素材库分类"
+    echo ""
+fi
+
+# ==================== 测试结果汇总 ====================
+echo ""
+echo -e "${BLUE}========================================${NC}"
+echo -e "${BLUE}  测试结果汇总${NC}"
+echo -e "${BLUE}========================================${NC}"
+echo ""
+echo -e "总测试数: ${BLUE}${TOTAL_TESTS}${NC}"
+echo -e "通过: ${GREEN}${PASSED_TESTS}${NC}"
+echo -e "失败: ${RED}${FAILED_TESTS}${NC}"
+echo ""
+
+if [ ${FAILED_TESTS} -gt 0 ]; then
+    echo -e "${RED}失败的命令:${NC}"
+    for cmd in "${FAILED_COMMANDS[@]}"; do
+        echo -e "  ${RED}✗${NC} ./soke-cli $cmd"
+    done
+    echo ""
+    echo -e "${RED}测试失败! 请修复以上问题后再发布。${NC}"
+    exit 1
+else
+    echo -e "${GREEN}========================================${NC}"
+    echo -e "${GREEN}  所有测试通过! ✓${NC}"
+    echo -e "${GREEN}========================================${NC}"
+    exit 0
+fi

package/scripts/release.sh

@@ -75,14 +75,24 @@ check_tag() {
 
 # 运行测试
 run_tests() {
-    echo -e "${YELLOW}运行测试...${NC}"
+    echo -e "${YELLOW}运行单元测试...${NC}"
 
     if ! go test ./...; then
-        echo -e "${RED}错误: 测试失败${NC}"
+        echo -e "${RED}错误: 单元测试失败${NC}"
         exit 1
     fi
 
-    echo -e "${GREEN}✓ 测试通过${NC}"
+    echo -e "${GREEN}✓ 单元测试通过${NC}"
+    echo ""
+
+    echo -e "${YELLOW}运行端到端测试...${NC}"
+
+    if ! ./scripts/e2e-test.sh; then
+        echo -e "${RED}错误: 端到端测试失败${NC}"
+        exit 1
+    fi
+
+    echo -e "${GREEN}✓ 端到端测试通过${NC}"
     echo ""
 }