@sokeai/cli 1.0.21 → 1.0.25

package/scripts/local-test.sh

@@ -0,0 +1,225 @@
+#!/bin/bash
+
+# soke-cli 本地测试脚本
+# 用于本地开发测试：编译 -> 安装到全局 -> 验证功能
+
+# 颜色输出
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+echo -e "${BLUE}========================================${NC}"
+echo -e "${BLUE}  soke-cli 本地测试${NC}"
+echo -e "${BLUE}========================================${NC}"
+echo ""
+
+# 步骤1: 编译
+echo -e "${YELLOW}[1/4] 编译 soke-cli...${NC}"
+if go build -o soke-cli main.go; then
+    echo -e "${GREEN}✓ 编译成功${NC}"
+else
+    echo -e "${RED}✗ 编译失败${NC}"
+    exit 1
+fi
+echo ""
+
+# 步骤2: 检查本地版本功能
+echo -e "${YELLOW}[2/4] 检查本地版本功能...${NC}"
+echo -e "  检查 learning-profile 模块..."
+if ./soke-cli learning-profile --help &>/dev/null; then
+    echo -e "${GREEN}  ✓ learning-profile 模块存在${NC}"
+else
+    echo -e "${RED}  ✗ learning-profile 模块不存在${NC}"
+    exit 1
+fi
+
+echo -e "  检查 contact +search-dept 命令..."
+if ./soke-cli contact +search-dept --help &>/dev/null; then
+    echo -e "${GREEN}  ✓ contact +search-dept 命令存在${NC}"
+else
+    echo -e "${RED}  ✗ contact +search-dept 命令不存在${NC}"
+    exit 1
+fi
+echo ""
+
+# 步骤3: 安装到全局
+echo -e "${YELLOW}[3/4] 安装到全局...${NC}"
+
+# 查找全局 CLI 路径
+GLOBAL_CLI=$(which soke-cli 2>/dev/null)
+if [ -z "$GLOBAL_CLI" ]; then
+    echo -e "${YELLOW}  未找到全局 soke-cli 安装${NC}"
+    echo -e "${YELLOW}  请先通过 npm 安装: npm install -g @sokeai/cli${NC}"
+    echo -e "${YELLOW}  跳过全局安装，仅测试本地版本${NC}"
+    SKIP_GLOBAL=true
+else
+    echo -e "  全局 CLI 路径: ${BLUE}${GLOBAL_CLI}${NC}"
+
+    # 检查是否需要更新
+    NEED_UPDATE=false
+    if ! $GLOBAL_CLI learning-profile --help &>/dev/null; then
+        echo -e "${YELLOW}  全局版本不支持 learning-profile 模块${NC}"
+        NEED_UPDATE=true
+    elif ! $GLOBAL_CLI contact +search-dept --help &>/dev/null; then
+        echo -e "${YELLOW}  全局版本不支持 contact +search-dept 命令${NC}"
+        NEED_UPDATE=true
+    fi
+
+    if [ "$NEED_UPDATE" = true ]; then
+        echo -e "${YELLOW}  需要更新全局安装${NC}"
+        echo ""
+        echo -e "${YELLOW}  是否要用本地版本覆盖全局安装? (y/n)${NC}"
+        read -r CONFIRM
+
+        if [ "$CONFIRM" = "y" ] || [ "$CONFIRM" = "Y" ]; then
+            # 备份原文件
+            BACKUP_FILE="${GLOBAL_CLI}.backup.$(date +%Y%m%d_%H%M%S)"
+            echo -e "  备份原文件到: ${BACKUP_FILE}"
+            if sudo cp $GLOBAL_CLI $BACKUP_FILE; then
+                echo -e "${GREEN}  ✓ 备份成功${NC}"
+            else
+                echo -e "${RED}  ✗ 备份失败${NC}"
+                exit 1
+            fi
+
+            # 安装新版本
+            echo -e "  安装新版本..."
+            if sudo cp ./soke-cli $GLOBAL_CLI; then
+                echo -e "${GREEN}  ✓ 安装成功${NC}"
+                echo -e "${BLUE}  备份文件: ${BACKUP_FILE}${NC}"
+            else
+                echo -e "${RED}  ✗ 安装失败${NC}"
+                echo -e "${YELLOW}  恢复备份...${NC}"
+                sudo cp $BACKUP_FILE $GLOBAL_CLI
+                exit 1
+            fi
+            SKIP_GLOBAL=false
+        else
+            echo -e "${YELLOW}  跳过全局安装${NC}"
+            SKIP_GLOBAL=true
+        fi
+    else
+        echo -e "${GREEN}  ✓ 全局版本已是最新，无需更新${NC}"
+        SKIP_GLOBAL=false
+    fi
+fi
+echo ""
+
+# 步骤3.5: 分发 Skills 到本地 Agent
+echo -e "${YELLOW}[3.5/4] 分发 Skills 到本地 Agent...${NC}"
+if [ "$SKIP_GLOBAL" = false ]; then
+    echo -e "  执行 scripts/install.js 同步 Skills..."
+    # 注入特殊环境变量或者直接调用 node 执行
+    # 我们只想要触发 syncSkillsToSokeclawWorkspace 和 syncSkillsToWorkclawRegistry
+    # 但原 install.js 会尝试下载二进制文件，所以我们新建一个临时脚本或修改调用方式
+    
+    # 为了安全起见，这里直接使用 node 运行一小段脚本引入 install.js 中的逻辑
+    cat > ./scripts/sync-skills-local.js << 'EOF'
+const fs = require('fs');
+const path = require('path');
+const installCode = fs.readFileSync(path.join(__dirname, 'install.js'), 'utf8');
+
+// 提取需要的函数
+const syncFn1Match = installCode.match(/function syncSkillsToSokeclawWorkspace\(\) \{[\s\S]*?\n\}/);
+const syncFn2Match = installCode.match(/function syncSkillsToWorkclawRegistry\(\) \{[\s\S]*?\n\}/);
+
+// 我们更推荐直接利用已经写好的 js 模块（如果它是通过 module.exports 导出的）
+// 但因为 install.js 是直接执行的脚本，我们通过简单的 node 脚本手动拷贝
+const os = require('os');
+function copyDirRecursive(srcDir, destDir) {
+  if (!fs.existsSync(srcDir)) return;
+  if (!fs.existsSync(destDir)) fs.mkdirSync(destDir, { recursive: true });
+  const entries = fs.readdirSync(srcDir, { withFileTypes: true });
+  for (const entry of entries) {
+    const srcPath = path.join(srcDir, entry.name);
+    const destPath = path.join(destDir, entry.name);
+    if (entry.isDirectory()) { copyDirRecursive(srcPath, destPath); continue; }
+    fs.copyFileSync(srcPath, destPath);
+  }
+}
+
+const homeDir = os.homedir();
+const defaultSokeclawDir = path.join(homeDir, '.sokeclaw', 'openai-agents', 'workspaces', 'main', 'skills');
+const packageRoot = path.join(__dirname, '..');
+const packagedSkillsDir = path.join(packageRoot, 'skills');
+
+if (fs.existsSync(packagedSkillsDir)) {
+  const skillNames = fs.readdirSync(packagedSkillsDir).filter(n => n.startsWith('soke-'));
+  if (fs.existsSync(defaultSokeclawDir)) {
+    for (const skillName of skillNames) {
+      const src = path.join(packagedSkillsDir, skillName);
+      const dest = path.join(defaultSokeclawDir, skillName);
+      copyDirRecursive(src, dest);
+      console.log(`  ✓ 同步 ${skillName} 到 ${dest}`);
+    }
+  }
+}
+EOF
+    node ./scripts/sync-skills-local.js
+    rm ./scripts/sync-skills-local.js
+    echo -e "${GREEN}  ✓ Skills 同步完成${NC}"
+else
+    echo -e "${YELLOW}  跳过全局安装，同时跳过 Skills 同步${NC}"
+fi
+echo ""
+
+# 步骤4: 运行功能测试
+echo -e "${YELLOW}[4/4] 运行功能测试...${NC}"
+
+# 测试本地版本
+echo -e "  ${BLUE}测试本地版本:${NC}"
+if ./soke-cli learning-profile +list --help &>/dev/null; then
+    echo -e "${GREEN}  ✓ learning-profile +list 命令可用${NC}"
+else
+    echo -e "${RED}  ✗ learning-profile +list 命令不可用${NC}"
+    exit 1
+fi
+
+if ./soke-cli contact +search-dept --help &>/dev/null; then
+    echo -e "${GREEN}  ✓ contact +search-dept 命令可用${NC}"
+else
+    echo -e "${RED}  ✗ contact +search-dept 命令不可用${NC}"
+    exit 1
+fi
+
+if ./soke-cli contact +search-user --help &>/dev/null; then
+    echo -e "${GREEN}  ✓ contact +search-user 命令可用${NC}"
+else
+    echo -e "${RED}  ✗ contact +search-user 命令不可用${NC}"
+    exit 1
+fi
+
+# 测试全局版本（如果已安装）
+if [ "$SKIP_GLOBAL" = false ] && [ -n "$GLOBAL_CLI" ]; then
+    echo ""
+    echo -e "  ${BLUE}测试全局版本:${NC}"
+    if $GLOBAL_CLI learning-profile +list --help &>/dev/null; then
+        echo -e "${GREEN}  ✓ learning-profile +list 命令可用${NC}"
+    else
+        echo -e "${RED}  ✗ learning-profile +list 命令不可用${NC}"
+        echo -e "${YELLOW}  提示: 全局安装可能未成功更新${NC}"
+    fi
+
+    if $GLOBAL_CLI contact +search-dept --help &>/dev/null; then
+        echo -e "${GREEN}  ✓ contact +search-dept 命令可用${NC}"
+    else
+        echo -e "${RED}  ✗ contact +search-dept 命令不可用${NC}"
+        echo -e "${YELLOW}  提示: 全局安装可能未成功更新${NC}"
+    fi
+
+    if $GLOBAL_CLI contact +search-user --help &>/dev/null; then
+        echo -e "${GREEN}  ✓ contact +search-user 命令可用${NC}"
+    else
+        echo -e "${RED}  ✗ contact +search-user 命令不可用${NC}"
+        echo -e "${YELLOW}  提示: 全局安装可能未成功更新${NC}"
+    fi
+fi
+echo ""
+
+# 完成
+echo -e "${GREEN}========================================${NC}"
+echo -e "${GREEN}  本地测试完成! ✓${NC}"
+echo -e "${GREEN}========================================${NC}"
+

package/scripts/push.sh

@@ -236,13 +236,3 @@ fi
 
 echo "  - Aliyun (origin): master 分支已更新"
 echo "  - GitHub (github): master 和 main 分支已更新"
-
-if [[ "$IS_RELEASE" == true ]]; then
-    echo ""
-    print_highlight "📦 下一步操作："
-    echo "  1. 编译二进制文件: make build"
-    echo "  2. 发布到 NPM: npm publish"
-    echo "  3. 创建 GitHub Release (可选)"
-fi
-
-echo ""

package/skills/soke-learning-profile/SKILL.md

@@ -0,0 +1,223 @@
+---
+name: soke-learning-profile
+summary: 学员学习档案查询
+version: 1.0.0
+description: "学员学习档案查询：查询学员的完整学习记录，包括课程学习、考试成绩、证书获取、学分积分等。当用户需要查询学员学习档案、查看学员学习情况、统计学员学习数据、查询学员综合学习信息时使用。"
+metadata:
+  requires:
+    bins: ["soke-cli"]
+  cliHelp: "soke-cli learning-profile --help"
+---
+
+**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../soke-shared/SKILL.md`](../soke-shared/SKILL.md)，其中包含认证、配置、权限处理**
+
+## 核心概念
+
+- **LearningProfile（学习档案）**: 学员的完整学习记录，包含课程、考试、证书、培训等多维度数据
+- **DeptUser（部门用户）**: 企业内的学员，通过 `dept_user_id` 标识
+- **Department（部门）**: 组织架构单元，通过 `dept_id` 标识
+
+## 资源关系
+
+```
+LearningProfile (学习档案)
+├── DeptUser (学员)
+│   ├── dept_user_id (学员ID)
+│   ├── dept_user_name (学员姓名)
+│   └── dept_names (所属部门)
+├── CourseData (课程数据)
+│   ├── required_learning/finished (必修课程)
+│   ├── optional_learning/finished (选修课程)
+│   └── learn_time (学习时长)
+├── ExamData (考试数据)
+│   ├── not_attempt (未开始)
+│   ├── passed (通过)
+│   ├── notpassed (未通过)
+│   └── reviewing (批阅中)
+├── CertificateData (证书数据)
+│   └── certificate_number (证书数量)
+├── PointsAndCredits (积分学分)
+│   ├── points (积分)
+│   └── credits (学分)
+└── TrainingData (培训数据)
+    ├── training_finished (线下培训)
+    ├── learning_map_finished (学习地图)
+    └── training_class_finished (培训班)
+```
+
+## Shortcuts（推荐优先使用）
+
+| Shortcut | 说明 |
+|----------|------|
+| [`+list`](#list) | 查询学员学习档案列表 |
+
+## 辅助命令（contact 模块）
+
+| Shortcut | 说明 |
+|----------|------|
+| `contact +search-user` | 根据姓名搜索学员 |
+| `contact +search-dept` | 根据名称搜索部门 |
+
+---
+
+## 命令详解
+
+### +list
+
+查询学员学习档案列表，支持按部门、学员ID筛选。
+
+**命令格式**:
+```bash
+soke-cli learning-profile +list \
+  [--dept-user-ids <user_id1,user_id2,...>] \
+  [--dept-ids <dept_id1,dept_id2,...>] \
+  [--is-new <0|1>] \
+  [--offset <offset>] \
+  [--page-size <size>]
+```
+
+**参数说明**:
+- `--dept-user-ids`: 学员ID列表，多个ID用逗号分隔（可选）
+- `--dept-ids`: 部门ID列表，多个ID用逗号分隔（可选）
+- `--is-new`: 是否新员工，0-否，1-是（可选）
+- `--offset`: 偏移量，默认从0开始（可选）
+- `--page-size`: 每页条数，最大100，默认10（可选）
+
+**返回字段**（表格显示关键字段）:
+- `姓名`: 学员姓名
+- `部门`: 所属部门
+- `职位`: 职位
+- `必修完成`: 必修课程完成情况（完成数/总数）
+- `选修完成`: 选修课程完成情况（完成数/总数）
+- `考试通过`: 考试通过数
+- `学习时长`: 学习时长（格式化为"X小时Y分钟"）
+- `证书数`: 获得证书数量
+- `学分`: 学分
+- `积分`: 积分
+
+**JSON 输出包含完整字段**（30+ 字段）:
+- 基础信息：`dept_user_id`, `dept_user_name`, `dept_names`, `position`, `job_number`, `avatar`, `is_leave`, `hired_date`
+- 课程学习：`optional_learning`, `optional_finished`, `required_learning`, `required_finished`, `learn_time`
+- 考试情况：`not_attempt`, `passed`, `notpassed`, `reviewing`
+- 证书积分：`certificate_number`, `points`, `credits`
+- 培训情况：`training_not_attempt`, `training_finished`, `class_length`
+- 学习地图：`leaning_map_attempt`, `learning_map_finished`
+- 培训班：`training_class_attempt`, `training_class_finished`
+- 其他：`live_learn_time`, `external_training_time`, `knowledge_number`, `evaluation_score`
+
+**示例**:
+```bash
+# 查询所有学员学习档案
+soke-cli learning-profile +list --offset 0 --page-size 20
+
+# 查询特定学员（单个）
+soke-cli learning-profile +list --dept-user-ids user123
+
+# 查询多个学员
+soke-cli learning-profile +list --dept-user-ids user123,user456,user789
+
+# 查询特定部门的学员
+soke-cli learning-profile +list --dept-ids dept456
+
+# 查询多个部门的学员
+soke-cli learning-profile +list --dept-ids dept456,dept789
+
+# 查询新员工的学习档案
+soke-cli learning-profile +list --is-new 1 --page-size 50
+
+# 分页查询（使用 offset）
+soke-cli learning-profile +list --offset 0 --page-size 10   # 第1页
+soke-cli learning-profile +list --offset 10 --page-size 10  # 第2页
+soke-cli learning-profile +list --offset 20 --page-size 10  # 第3页
+```
+
+**权限要求**: `learningProfile:readonly`
+
+**使用场景**:
+- 当用户询问"查询学员学习档案"时使用
+- 当用户需要查看学员学习情况、统计学习数据时使用
+- 当用户需要导出学员学习报表时使用
+
+---
+
+## 权限表
+
+| 命令 | 所需权限 | 说明 |
+|------|----------|------|
+| `+list` | `learningProfile:readonly` | 查询学员学习档案 |
+| `contact +search-user` | `contact:user:readonly` | 搜索学员 |
+| `contact +search-dept` | `contact:department:readonly` | 搜索部门 |
+
+---
+
+## 常见工作流
+
+### 工作流1: 根据姓名查询学员学习档案
+
+当用户询问"查询张三的学习档案"时：
+
+**步骤1**: 搜索学员获取 dept_user_id
+```bash
+soke-cli contact +search-user --dept-user-name "张三"
+```
+
+**步骤2**: 使用 dept_user_id 查询学习档案
+```bash
+soke-cli learning-profile +list --dept-user-ids <从步骤1获取的dept_user_id>
+```
+
+**注意**: 学习档案接口不支持按姓名直接查询，必须先通过 contact 模块获取 dept_user_id。
+
+### 工作流2: 查询部门所有学员的学习档案
+
+当用户询问"查询技术部所有学员的学习情况"时：
+
+**步骤1**: 搜索部门获取 dept_id
+```bash
+soke-cli contact +search-dept --dept-name "技术部"
+```
+
+**步骤2**: 使用 dept_id 查询该部门学员学习档案
+```bash
+soke-cli learning-profile +list --dept-ids <从步骤1获取的dept_id> --page-size 100
+```
+
+### 工作流3: 批量导出学习档案
+
+当用户需要导出学习档案数据时：
+
+```bash
+# 使用 JSON 格式输出并保存到文件
+soke-cli learning-profile +list --page-size 100 --format json > learning_profiles.json
+```
+
+---
+
+## 注意事项
+
+1. **时间格式**: `learn_time`, `class_length` 等时长字段单位为秒，表格输出时会自动格式化为"X小时Y分钟"
+2. **分页**: 使用 `offset` 和 `page_size` 进行分页，默认每页10条，最大100条
+3. **数组参数**: `dept_user_ids` 和 `dept_ids` 是数组类型，多个ID用逗号分隔
+4. **姓名查询**: 学习档案接口不支持按姓名查询，需要先通过 `contact +search-user` 获取 dept_user_id
+5. **权限**: 需要 `learningProfile:readonly` 权限，如遇权限错误参考 soke-shared
+6. **数据完整性**: 表格输出仅显示关键字段，完整数据请使用 `--format json`
+
+---
+
+## 错误处理
+
+### 权限不足
+如果遇到权限错误，参考 [`../soke-shared/SKILL.md`](../soke-shared/SKILL.md)
+
+### 参数错误
+使用 `--help` 查看命令参数说明：
+```bash
+soke-cli learning-profile +list --help
+```
+
+### 数据为空
+如果查询结果为空，检查：
+1. 筛选条件是否正确（dept_ids, dept_user_ids, is_new）
+2. 学员是否有学习记录
+3. 是否有权限查看该部门/学员的数据
+4. 注意：学习档案接口不支持按姓名查询，需要先获取 dept_user_id