@sokeai/cli 1.0.76 → 1.0.78

package/README.md

@@ -278,20 +278,20 @@ SOKE_APP_CONFIG=app.pre.yaml go run main.go
 
 #### 1️⃣ 接口封装为 CLI 命令
 
-**步骤 1: 在 shortcuts 目录下定义接口元数据**
+**步骤 1: 在 operations 目录下定义接口元数据**
 
 ```bash
 # 创建新模块目录
-mkdir -p shortcuts/your-module
+mkdir -p operations/your-module
 
 # 创建命令定义文件
-touch shortcuts/your-module/list_items.go
+touch operations/your-module/list_items.go
 ```
 
 **示例：定义一个查询列表的命令**
 
 ```go
-// shortcuts/your-module/list_items.go
+// operations/your-module/list_items.go
 package yourmodule
 
 import "soke-cli/internal/client"
@@ -332,7 +332,7 @@ func ListItemsShortcut() client.Shortcut {
 **步骤 2: 注册命令到模块**
 
 ```go
-// shortcuts/your-module/shortcuts.go
+// operations/your-module/registry.go
 package yourmodule
 
 import "soke-cli/internal/client"
@@ -354,7 +354,7 @@ package yourmodule
 
 import (
     "soke-cli/internal/client"
-    yourmodule "soke-cli/shortcuts/your-module"
+    yourmodule "soke-cli/operations/your-module"
     "github.com/spf13/cobra"
 )
 
@@ -698,7 +698,7 @@ soke-cli/
 │   ├── client/            # API 客户端封装
 │   ├── core/              # 配置管理
 │   └── output/            # 输出格式化
-├── shortcuts/             # 业务模块快捷命令元数据定义
+├── operations/             # 业务模块快捷命令元数据定义
 │   └── your-module/       # 各模块的 API 路径、参数、默认值等
 ├── skills/                # AI Agent Skills 定义
 │   ├── README.md          # Skills 使用说明

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@sokeai/cli",
-    "version": "1.0.76",
+    "version": "1.0.78",
     "description": "授客AI官方CLI工具 - 支持AI Agent Skills",
     "bin": {
         "soke-cli": "scripts/run.js"

package/scripts/build-binaries.sh

@@ -28,7 +28,7 @@ CONFIG_BASE64=$(base64 < "${CONFIG_FILE}" | tr -d '\n')
 echo -e "${YELLOW}使用配置文件: ${CONFIG_FILE}${NC}"
 
 # 编译参数
-LDFLAGS="-s -w -X codeup.aliyun.com/5edbc121d1d1abe63b55f1c7/soke/soke-cli/internal/version.Version=${VERSION} -X codeup.aliyun.com/5edbc121d1d1abe63b55f1c7/soke/soke-cli/internal/core.EmbeddedConfigBase64=${CONFIG_BASE64}"
+LDFLAGS="-s -w -X soke-cli/internal/version.Version=${VERSION} -X soke-cli/internal/core.EmbeddedConfigBase64=${CONFIG_BASE64}"
 
 # 创建输出目录
 BIN_DIR="bin"

package/scripts/e2e-test.sh

@@ -123,6 +123,16 @@ should_test_module() {
 echo -e "${BLUE}开始测试...${NC}"
 echo ""
 
+# ==================== AI Training 模块 ====================
+if should_test_module "ai-training"; then
+    echo -e "${YELLOW}[AI Training 模块]${NC}"
+    test_command "ai-training" "+list-packages" "--page 1 --page-size 10" "获取AI教练知识包列表"
+    test_command "ai-training" "+list-scenarios" "--page 1 --page-size 10" "获取AI陪练场景列表"
+    test_command "ai-training" "+list-role-avatars" "" "获取AI陪练角色头像列表"
+    test_command "ai-training" "+list-role-voices" "" "获取AI陪练角色音色列表"
+    echo ""
+fi
+
 # ==================== Contact 模块 ====================
 if should_test_module "contact"; then
     echo -e "${YELLOW}[Contact 模块]${NC}"
@@ -131,6 +141,7 @@ if should_test_module "contact"; then
     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" "+list-positions" "--page 1 --page-size 10" "获取职位列表"
     # 搜索接口暂未授权，跳过
     # test_command "contact" "+search-user" "--dept-user-name 测试" "搜索用户"
     # test_command "contact" "+search-dept" "--dept-name 测试" "搜索部门"
@@ -140,6 +151,7 @@ fi
 # ==================== Learning Profile 模块 ====================
 if should_test_module "learning-profile"; then
     echo -e "${YELLOW}[Learning Profile 模块]${NC}"
+    test_command "learning-profile" "+list" "--help" "检查学习档案列表命令"
     # 学习档案接口暂未授权，跳过
     # test_command "learning-profile" "+list" "--offset 0 --page-size 10" "获取学习档案列表"
     # test_command "learning-profile" "+list" "--is-new 1 --page-size 5" "获取新员工学习档案"
@@ -149,8 +161,10 @@ 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-courses" "--page 1 --page-size 10" "获取课程列表"
     test_command "course" "+list-categories" "" "获取课程分类"
+    test_command "course" "+category-tree" "--parent-id 1" "获取课程分类树"
+    test_command "course" "+search" "--category-id 1" "按分类搜索课程"
     test_command "course" "+list-lessons" "--course-id F4025496-6566-4ACD-8CD4-06E3D55BBA79" "获取课程章节"
     echo ""
 fi
@@ -166,6 +180,19 @@ if should_test_module "exam"; then
     echo ""
 fi
 
+# ==================== Exam Question Pool 模块 ====================
+if should_test_module "exam-question-pool"; then
+    echo -e "${YELLOW}[Exam Question Pool 模块]${NC}"
+    test_command "exam-question-pool" "+list" "--page 1 --page-size 10" "获取可练习题库列表"
+    test_command "exam-question-pool" "+get" "--help" "检查题库详情命令"
+    test_command "exam-question-pool" "+questions" "--help" "检查题库题目命令"
+    test_command "exam-question-pool" "+finish" "--help" "检查题库交卷命令"
+    # 详情/题目/交卷接口需要有效题库 UUID，避免在默认 e2e 中硬编码环境数据
+    # test_command "exam-question-pool" "+get" "--pool-id <pool_uuid>" "获取可练习题库详情"
+    # test_command "exam-question-pool" "+questions" "--pool-id <pool_uuid>" "获取可练习题库题目"
+    echo ""
+fi
+
 # ==================== Exam Write 模块 (写操作) ====================
 # 创建题库接口服务端故障，暂时跳过写操作测试
 if false && should_test_module "exam-write"; then
@@ -223,8 +250,8 @@ 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" "" "获取证书分类"
+    test_command "certificate" "+list" "--page 1 --limit 10" "获取证书列表"
+    test_command "certificate" "++category" "" "获取证书分类"
     echo ""
 fi
 
@@ -258,9 +285,54 @@ if should_test_module "learning-map"; then
     echo ""
 fi
 
+# ==================== Photo Gallery 模块 ====================
+if should_test_module "photo-gallery"; then
+    echo -e "${YELLOW}[Photo Gallery 模块]${NC}"
+    test_command "photo-gallery" "+list-categories" "--page 1 --limit 100" "获取图片库分类列表"
+    test_command "photo-gallery" "+list" "--page 1 --limit 20" "获取图片库列表"
+    test_command "photo-gallery" "+get" "--help" "检查图片详情命令"
+    test_command "photo-gallery" "+create" "--help" "检查图片上传命令"
+    test_command "photo-gallery" "+batch-delete" "--help" "检查图片批量删除命令"
+    # 上传/删除为写操作，默认 e2e 不执行
+    # test_command "photo-gallery" "+get" "--uuid <photo_uuid>" "获取图片详情"
+    echo ""
+fi
+
+# ==================== Task 模块 ====================
+if should_test_module "task"; then
+    echo -e "${YELLOW}[Task 模块]${NC}"
+    test_command "task" "+create" "--help" "检查创建异步任务命令"
+    test_command "task" "+get" "--help" "检查查询异步任务命令"
+    # +create 会创建异步任务，+get 需要任务 ID；默认 e2e 不执行真实写入
+    # test_command "task" "+get" "--id <task_id>" "查询异步任务"
+    echo ""
+fi
+
+# ==================== Training Demand 模块 ====================
+if should_test_module "training-demand"; then
+    echo -e "${YELLOW}[Training Demand 模块]${NC}"
+    test_command "training-demand" "+list-categories" "" "获取培训需求分类列表"
+    test_command "training-demand" "+list" "--page 1 --limit 10 --create-time-order desc" "获取培训需求列表"
+    test_command "training-demand" "+create" "--help" "检查提交培训需求命令"
+    test_command "training-demand" "+vote" "--help" "检查培训需求投票命令"
+    # 创建/投票为写操作，默认 e2e 不执行
+    # test_command "training-demand" "+create" "--title 测试需求 --category-uuid <category_uuid> --level 0" "提交培训需求"
+    # test_command "training-demand" "+vote" "--uuid <demand_uuid>" "投票培训需求"
+    echo ""
+fi
+
+# ==================== User 模块 ====================
+if should_test_module "user"; then
+    echo -e "${YELLOW}[User 模块]${NC}"
+    test_command "user" "+setting" "--name system_setting --cloud-storage 0" "获取用户系统设置"
+    echo ""
+fi
+
 # ==================== News 模块 ====================
 if should_test_module "news"; then
     echo -e "${YELLOW}[News 模块]${NC}"
+    test_command "news" "+list-news" "--help" "检查新闻列表命令"
+    test_command "news" "+list-categories" "--help" "检查新闻分类命令"
     # 新闻接口暂未上线，跳过
     # test_command "news" "+list-news" "" "获取新闻列表"
     # test_command "news" "+list-categories" "" "获取新闻分类"

package/scripts/install.js

@@ -109,7 +109,7 @@ function detectSkillNames(packagedSkillsDir) {
 
 function syncSkillsToSokeclawWorkspace() {
   const packageRoot = path.join(__dirname, '..');
-  const packagedSkillsDir = path.join(packageRoot, 'skills');
+  const packagedSkillsDir = path.join(packageRoot, 'skills', 'multi');
   if (!fs.existsSync(packagedSkillsDir)) return;
 
   const targetDirs = detectSokeclawWorkspaceSkillsDirs();
@@ -228,7 +228,7 @@ function syncSkillsToWorkclawRegistry() {
   }
 
   const packageRoot = path.join(__dirname, '..');
-  const packagedSkillsDir = path.join(packageRoot, 'skills');
+  const packagedSkillsDir = path.join(packageRoot, 'skills', 'multi');
   if (!fs.existsSync(packagedSkillsDir)) return;
 
   let registry;

package/scripts/local-test.js

@@ -383,7 +383,7 @@ function main() {
 
   // 检测项目目录
   const packageRoot = path.join(__dirname, '..');
-  const packagedSkillsDir = path.join(packageRoot, 'skills');
+  const packagedSkillsDir = path.join(packageRoot, 'skills', 'multi');
 
   if (!fs.existsSync(packagedSkillsDir)) {
     logError(`Skills 目录不存在: ${packagedSkillsDir}`);

package/scripts/test-auto-detect.js

@@ -68,7 +68,7 @@ function parseSkillMetadata(skillDir) {
 
 // 测试
 const packageRoot = path.join(__dirname, '..');
-const skillsDir = path.join(packageRoot, 'skills');
+const skillsDir = path.join(packageRoot, 'skills', 'multi');
 
 console.log('🔍 测试自动检测功能\n');
 console.log('Skills 目录:', skillsDir);
@@ -102,7 +102,24 @@ for (const skillName of skillNames) {
 // 验证结果
 console.log('📊 验证结果:\n');
 
-const expectedSkills = ['soke-course', 'soke-exam', 'soke-shared'];
+const expectedSkills = [
+  'soke-ai-coach-director',
+  'soke-ai-training',
+  'soke-assign',
+  'soke-certificate',
+  'soke-course',
+  'soke-exam',
+  'soke-exam-question-pool',
+  'soke-learning-map',
+  'soke-learning-profile',
+  'soke-lesson',
+  'soke-material',
+  'soke-photo-gallery',
+  'soke-shared',
+  'soke-supervisor',
+  'soke-task',
+  'soke-training-demand'
+];
 const missingSkills = expectedSkills.filter(s => !skillNames.includes(s));
 const extraSkills = skillNames.filter(s => !expectedSkills.includes(s));
 
@@ -120,6 +137,6 @@ console.log('');
 console.log('🎉 测试完成！');
 console.log('');
 console.log('💡 提示:');
-console.log('   - 新增 skill 时，只需在 skills/ 目录下创建 soke-* 目录');
+console.log('   - 新增 skill 时，只需在 skills/multi/ 目录下创建 soke-* 目录');
 console.log('   - 确保每个 skill 都有 SKILL.md 文件，包含完整的 frontmatter');
 console.log('   - install.js 会自动检测并注册所有 skills');

package/skills/README.md

@@ -1,198 +1,49 @@
-# 授客CLI AI Agent Skills
+# soke-cli Skills
 
-本目录包含授客CLI的AI Agent技能定义，使AI Agent能够自动发现和调用授客CLI的各种功能。
+本目录提供两种可复制安装的发布布局：
 
-## 安装方法
+| 布局 | 路径 | 用途 |
+|---|---|---|
+| Mono | `skills/mono/` | 推荐；一个入口包含全部业务模块和内部资料 |
+| Multi | `skills/multi/` | 按 `soke-*` 模块独立安装 |
 
-### 前提条件
+## 安装
 
-1. 已安装授客CLI：
-```bash
-npm install -g @sokeai/cli
-```
-
-2. 已完成配置和认证：
-```bash
-soke-cli auth login
-```
-
-### 安装Skills
-
-**方式1：从GitHub安装（推荐）**
-
-```bash
-# 全局安装所有skills
-npx skills add <org>/soke-cli -y -g
-
-# 或安装特定skill
-npx skills add <org>/soke-cli --skill soke-exam -y -g
-```
-
-> 注意：需要先将本项目推送到GitHub公开仓库，然后将 `<org>` 替换为实际的GitHub组织或用户名。
-
-**方式2：本地安装（开发测试）**
-
-```bash
-# 复制到全局skills目录
-cp -r skills/soke-shared ~/.claude/skills/
-cp -r skills/soke-exam ~/.claude/skills/
-cp -r skills/soke-training-demand ~/.claude/skills/
-cp -r skills/soke-task ~/.claude/skills/
-
-# 或复制到项目级skills目录
-mkdir -p .claude/skills
-cp -r skills/soke-shared .claude/skills/
-cp -r skills/soke-exam .claude/skills/
-```
-
-### 验证安装
-
-安装完成后，AI Agent会自动加载这些skills。你可以通过以下方式验证：
-
-1. 在AI Agent对话中询问："查询考试成绩"
-2. AI Agent应该能够识别并使用 `soke-exam` skill
-3. AI Agent会自动执行 `soke-cli exam +get-exam-user` 命令
-
-## Skills列表
-
-### soke-shared
-
-**功能**: 共享基础规则，包含配置、认证、权限处理
-
-**触发条件**: 
-- 首次使用soke-cli
-- 需要配置初始化
-- 需要用户登录
-- 遇到权限错误
+Mono：
 
-**关键内容**:
-- 用户认证（`soke-cli auth login`）
-- 权限不足处理
-- 错误处理规范
-- 安全规则
-
-### soke-exam
-
-**功能**: 考试管理，查询考试、考试用户和成绩
-
-**触发条件**:
-- 查询考试成绩
-- 查看考试列表
-- 查询考试用户信息
-- 查看考试分类
-
-**支持的命令**:
-- `+list-exams`: 列出考试列表
-- `+list-exam-users`: 列出考试用户成绩列表
-- `+get-exam-user`: 获取单个考试用户详细成绩
-- `+list-categories`: 列出考试分类
-
-**使用示例**:
 ```bash
-# 查询考试成绩
-soke-cli exam +get-exam-user --exam-id exam123 --dept-user-id user456
-
-# 列出考试
-soke-cli exam +list-exams --start-time 1672502400000 --end-time 1704038400000
-```
-
-## 目录结构
-
-```
-skills/
-├── soke-shared/              # 共享基础skill
-│   └── SKILL.md
-├── soke-exam/                # 考试管理skill
-│   ├── SKILL.md
-│   └── references/           # 详细文档
-│       └── exam-get-exam-user.md
-└── README.md                 # 本文件
-```
-
-## Skill文件格式
-
-每个skill目录包含一个 `SKILL.md` 文件，格式如下：
-
-```markdown
----
-name: skill-name              # 技能名称
-version: 1.0.0                # 版本号
-description: "简短描述。当用户需要...时使用。"  # 触发条件（关键）
-metadata:
-  requires:
-    bins: ["soke-cli"]        # 依赖的CLI工具
-  cliHelp: "soke-cli exam --help"  # 帮助命令
----
-
-# Skill标题
-
-[Markdown格式的详细说明]
+cp -R skills/mono ~/.claude/skills/soke-cli
 ```
 
-**关键字段说明**:
-- `name`: 技能标识符，小写字母、数字、连字符
-- `version`: 语义版本号
-- `description`: **最重要**，AI用它判断何时触发此skill，必须包含"当用户需要...时使用"
-- `metadata.requires.bins`: 依赖的CLI工具列表
-
-## 开发新的Skill
-
-### 步骤1：创建目录
+Multi：
 
 ```bash
-mkdir -p skills/soke-<module>/references
+cp -R skills/multi/soke-exam ~/.claude/skills/
 ```
 
-### 步骤2：编写SKILL.md
+复制后，目标 Skill 目录必须保留其内部的 `references/`、`scripts/`、`examples/`、`assets/` 等资料；这些是对应 Skill 的内部资源，不是额外安装单元。Multi 模块不依赖其他兄弟目录。
 
-参考 `soke-exam/SKILL.md` 的格式，包含：
-1. Frontmatter（name, version, description, metadata）
-2. 核心概念说明
-3. Shortcuts列表
-4. 命令详解
-5. 权限表
-6. 常见工作流
+## 使用前提
 
-### 步骤3：编写详细文档（可选）
-
-在 `references/` 目录下为每个重要命令创建详细文档。
-
-### 步骤4：测试
+先安装并登录 CLI：
 
 ```bash
-# 本地安装测试
-cp -r skills/soke-<module> ~/.claude/skills/
-
-# 在AI Agent中测试触发条件
+npm install -g @sokeai/cli@latest
+soke-cli auth login
 ```
 
-## 后续扩展
-
-可以按相同模式创建其他业务模块的skills：
-
-- `soke-course` - 课程管理
-- `soke-contact` - 组织架构（部门、用户、讲师）
-- `soke-training` - 培训管理
-- `soke-training-demand` - 培训需求收集
-- `soke-task` - 异步任务管理
-- `soke-credit` - 学分管理
-- `soke-certificate` - 证书管理
-- 等等...
+详细认证、配置和排错说明以 [Mono 安装指南](mono/references/installation.md) 或所安装模块自身的 `references/installation.md` 为准。
 
-## 注意事项
+## 模块索引
 
-1. **Description字段至关重要**: 这是AI匹配skill的唯一依据，必须清晰描述触发场景
-2. **命令示例要完整**: 包含所有必需参数，避免AI猜测
-3. **引用共享规则**: 每个业务skill都应引用soke-shared，避免重复
-4. **保持简洁**: SKILL.md应该是快速参考，详细文档放在references/目录
-5. **版本管理**: 更新skill时记得更新version字段
+Multi 中可独立安装的模块：
 
-## 相关链接
+`soke-shared`、`soke-course`、`soke-material`、`soke-lesson`、`soke-assign`、`soke-exam`、`soke-exam-question-pool`、`soke-learning-map`、`soke-learning-profile`、`soke-certificate`、`soke-photo-gallery`、`soke-training-demand`、`soke-task`、`soke-supervisor`、`soke-ai-training`、`soke-ai-coach-director`。
 
-- 授客AI开放平台: https://opendev.soke.cn
-- NPM包: @sokeai/cli
-- Skills规范: https://github.com/agent-skills/spec
+模块的触发条件、命令参数和工作流只维护在各自的 `SKILL.md` 中。需要全部能力时安装 Mono，不要同时安装 Mono 与对应 Multi 模块，以免重复加载。
 
-## 许可证
+## 维护约定
 
-MIT
+- 新增业务模块时，只在 `skills/multi/<module>/` 创建独立 Skill，再同步一份模块参考资料到 `skills/mono/references/modules/<module>/`。
+- Mono 入口只负责路由和跨模块规则；详细流程放在模块 `MODULE.md` 或专项参考文件中。
+- 独立安装所需的共享资料可以在 Multi 模块中保留副本；Mono 内部不得再创建同一资料的平行副本。