byteplan-cli 1.3.0 → 1.3.2

package/README.md

@@ -43,14 +43,55 @@ byteplan model columns <modelCode>
 byteplan data query <modelCode>
 ```
 
-### Dimension & LOV Commands
+### Skills Commands
+
+BytePlan CLI 提供了一系列 Claude Code Skills，可以安装到多个 AI CLI 平台。
+
+### 查看可用 Skills
+
+```bash
+byteplan skills list
+```
+
+### 安装 Skills
+
+支持多平台安装，使用 `-p` 或 `--platform` 参数指定目标平台：
+
+```bash
+# 安装到 Claude Code
+byteplan skills install byteplan-api -p claude-code
+
+# 安装到多个平台
+byteplan skills install -p claude-code,codex,openclaw
+
+# 安装所有 Skills
+byteplan skills install-all -p claude-code
+```
+
+### 支持的平台
+
+| Platform | 目录 | 说明 |
+|----------|------|------|
+| `claude-code` (alias: `claude`) | `~/.claude/commands` | Claude Code CLI |
+| `codex` | `~/.codex` | OpenAI Codex CLI |
+| `openclaw` | `~/.openclaw/skills` | OpenClaw |
+
+### 自定义目录
+
+也可以使用 `-d` 参数指定自定义目录：
 
 ```bash
-# Get dimension values
-byteplan dim <dimCode>
+# 向后兼容：指定自定义目录
+byteplan skills install byteplan-api -d ~/.claude/commands
+
+# 组合使用：覆盖平台默认目录
+byteplan skills install byteplan-api -p claude-code -d /custom/path
+```
 
-# Get LOV values
-byteplan lov <lovCode>
+### 查看已安装 Skills
+
+```bash
+byteplan skills installed -p claude-code
 ```
 
 ## Options

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "byteplan-cli",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "description": "BytePlan CLI - Command line tool for BytePlan API",
   "keywords": [
     "byteplan",

package/src/cli.js

@@ -246,13 +246,15 @@ dataCmd
         pageSize: parseInt(options.size),
       });
 
+      // result.data 可能是数组（直接数据）或对象（包含 data 子字段）
+      const rows = Array.isArray(result.data) ? result.data : (result.data?.data || []);
       printJSON({
-        headers: result.data?.headers || [],
-        data: result.data?.data || [],
+        headers: result.headers || result.data?.headers || [],
+        data: rows,
         pagination: {
-          pageNum: result.data?.pageNum || parseInt(options.page),
-          pageSize: result.data?.pageSize || parseInt(options.size),
-          total: result.data?.total || 0,
+          pageNum: result.pageNum || result.data?.pageNum || parseInt(options.page),
+          pageSize: result.pageSize || result.data?.pageSize || parseInt(options.size),
+          total: result.total || result.data?.total || 0,
         },
       });
     } catch (error) {

package/src/commands/skills.js

@@ -12,6 +12,14 @@ import { createRequire } from 'module';
 
 const require = createRequire(import.meta.url);
 
+// 平台默认目录映射
+const PLATFORM_DIRS = {
+  'claude-code': path.join(homedir(), '.claude', 'commands'),
+  'claude': path.join(homedir(), '.claude', 'commands'),  // alias
+  'codex': path.join(homedir(), '.codex'),
+  'openclaw': path.join(homedir(), '.openclaw', 'skills'),
+};
+
 // Skills 源目录（在 npm 包中）
 const getSkillsSourceDir = () => {
   // 获取当前模块所在目录，然后向上找到项目根目录
@@ -20,10 +28,47 @@ const getSkillsSourceDir = () => {
   return path.join(currentDir, '..', '..', 'skills');
 };
 
-// Skills 默认目标目录（仅用于提示）
-const getDefaultSkillsTargetDir = () => {
-  return path.join(homedir(), '.claude', 'skills');
-};
+// 解析平台和目录参数，返回目标目录列表
+function resolveTargetDirs(platformArg, dirArg) {
+  const targets = [];
+
+  if (platformArg) {
+    // 解析平台列表（逗号分隔）
+    const platforms = platformArg.split(',').map(p => p.trim());
+
+    for (const platform of platforms) {
+      const normalizedName = platform.toLowerCase();
+      const defaultDir = PLATFORM_DIRS[normalizedName];
+
+      if (!defaultDir) {
+        return {
+          error: true,
+          message: `Unknown platform: ${platform}`,
+          available: Object.keys(PLATFORM_DIRS).filter(k => !k.includes('-')),
+        };
+      }
+
+      targets.push({
+        platform: normalizedName,
+        targetDir: dirArg || defaultDir, // 如果指定了 -d，覆盖所有平台的默认目录
+      });
+    }
+  } else if (dirArg) {
+    // 向后兼容：只指定 -d 的情况
+    targets.push({
+      platform: 'custom',
+      targetDir: dirArg,
+    });
+  } else {
+    // 都不指定，返回错误
+    return {
+      error: true,
+      message: 'Must specify at least one of --platform or --dir',
+    };
+  }
+
+  return { targets };
+}
 
 function printJSON(data) {
   console.log(JSON.stringify(data, null, 2));
@@ -108,20 +153,28 @@ function getInstalledSkills(targetDir) {
 // Skills 命令
 const skillsCmd = new Command('skills')
   .description('Manage BytePlan Claude Code skills')
-  .requiredOption('-d, --dir <directory>', 'Target installation directory (required)')
+  .option('-d, --dir <directory>', 'Target installation directory (overrides platform default)')
+  .option('-p, --platform <platforms>', 'Target platform(s): claude-code, codex, openclaw (comma-separated for multiple)')
   .addHelpText('after', `
 Commands:
   skills list              List all available skills
-  skills installed         List installed skills (requires -d)
-  skills install [names]   Install skills to target directory (requires -d)
-  skills install-all       Install all BytePlan skills (requires -d)
+  skills installed         List installed skills (requires -p or -d)
+  skills install [names]   Install skills (requires -p or -d)
+  skills install-all       Install all BytePlan skills (requires -p or -d)
+
+Supported Platforms:
+  claude-code (alias: claude)  → ~/.claude/commands
+  codex                        → ~/.codex
+  openclaw                     → ~/.openclaw/skills
 
 Examples:
   $ byteplan skills list
-  $ byteplan skills installed -d ~/.claude/skills
-  $ byteplan skills install byteplan-api byteplan-analysis -d ~/.claude/skills
-  $ byteplan skills install-all -d ~/.claude/skills
-  $ byteplan skills install-all -d /custom/path/skills
+  $ byteplan skills installed -p claude-code
+  $ byteplan skills install byteplan-api -p claude-code
+  $ byteplan skills install byteplan-api byteplan-analysis -p claude-code,codex
+  $ byteplan skills install-all -p claude-code,openclaw
+  $ byteplan skills install byteplan-api -d ~/.claude/commands
+  $ byteplan skills install byteplan-api -p claude-code -d /custom/path
 `);
 
 // skills list 子命令
@@ -151,18 +204,32 @@ skillsCmd
   .description('List installed BytePlan skills in target directory')
   .action(() => {
     try {
-      // 获取父命令的 -d 选项（requiredOption 已确保必传）
       const parentOptions = skillsCmd.opts();
-      const targetDir = parentOptions.dir;
-      const skills = getInstalledSkills(targetDir);
+      const platformArg = parentOptions.platform;
+      const dirArg = parentOptions.dir;
+
+      const resolved = resolveTargetDirs(platformArg, dirArg);
+      if (resolved.error) {
+        printJSON(resolved);
+        process.exit(1);
+      }
+
+      const results = {};
+      for (const target of resolved.targets) {
+        const skills = getInstalledSkills(target.targetDir);
+        results[target.platform] = {
+          targetDir: target.targetDir,
+          skills: skills.map(s => ({
+            name: s.name,
+            description: s.description,
+          })),
+          count: skills.length,
+        };
+      }
 
       printJSON({
-        skills: skills.map(s => ({
-          name: s.name,
-          description: s.description,
-        })),
-        total: skills.length,
-        targetDir: targetDir,
+        platforms: results,
+        totalPlatforms: resolved.targets.length,
       });
     } catch (error) {
       printError(error);
@@ -176,22 +243,26 @@ skillsCmd
   .option('-a, --all', 'Install all BytePlan skills', false)
   .addHelpText('after', `
 Examples:
-  $ byteplan skills install byteplan-api byteplan-analysis -d ~/.claude/skills
-  $ byteplan skills install --all -d ~/.claude/skills
-  $ byteplan skills install byteplan-api -d /custom/path/skills
+  $ byteplan skills install byteplan-api -p claude-code
+  $ byteplan skills install byteplan-api byteplan-analysis -p claude-code,codex
+  $ byteplan skills install --all -p claude-code
+  $ byteplan skills install byteplan-api -d ~/.claude/commands
+  $ byteplan skills install byteplan-api -p claude-code -d /custom/path
 `)
   .action(async (names, options) => {
     try {
-      // 获取父命令的 -d 选项（requiredOption 已确保必传）
       const parentOptions = skillsCmd.opts();
-      const targetDir = parentOptions.dir;
-      const sourceDir = getSkillsSourceDir();
+      const platformArg = parentOptions.platform;
+      const dirArg = parentOptions.dir;
 
-      // 确保目标目录存在
-      if (!existsSync(targetDir)) {
-        mkdirSync(targetDir, { recursive: true });
+      const resolved = resolveTargetDirs(platformArg, dirArg);
+      if (resolved.error) {
+        printJSON(resolved);
+        process.exit(1);
       }
 
+      const sourceDir = getSkillsSourceDir();
+
       // 获取要安装的 skills
       let toInstall = names || [];
       if (options.all || toInstall.length === 0) {
@@ -213,22 +284,39 @@ Examples:
         process.exit(1);
       }
 
-      // 安装 skills
-      const installed = [];
-      for (const skillName of toInstall) {
-        const skillSourcePath = path.join(sourceDir, skillName);
-        const skillTargetPath = path.join(targetDir, skillName);
-
-        // 复制 skill 目录
-        cpSync(skillSourcePath, skillTargetPath, { recursive: true });
-        installed.push(skillName);
+      // 安装到各目标目录
+      const results = {};
+      for (const target of resolved.targets) {
+        const targetDir = target.targetDir;
+
+        // 确保目标目录存在
+        if (!existsSync(targetDir)) {
+          mkdirSync(targetDir, { recursive: true });
+        }
+
+        // 安装 skills
+        const installed = [];
+        for (const skillName of toInstall) {
+          const skillSourcePath = path.join(sourceDir, skillName);
+          const skillTargetPath = path.join(targetDir, skillName);
+
+          // 复制 skill 目录
+          cpSync(skillSourcePath, skillTargetPath, { recursive: true });
+          installed.push(skillName);
+        }
+
+        results[target.platform] = {
+          targetDir: targetDir,
+          installed: installed,
+          count: installed.length,
+        };
       }
 
       printJSON({
         success: true,
-        installed: installed,
-        total: installed.length,
-        targetDir: targetDir,
+        platforms: results,
+        totalPlatforms: resolved.targets.length,
+        totalSkills: toInstall.length,
       });
     } catch (error) {
       printError(error);
@@ -241,35 +329,55 @@ skillsCmd
   .description('Install all BytePlan skills to target directory')
   .action(async () => {
     try {
-      // 获取父命令的 -d 选项（requiredOption 已确保必传）
       const parentOptions = skillsCmd.opts();
-      const targetDir = parentOptions.dir;
-      const sourceDir = getSkillsSourceDir();
+      const platformArg = parentOptions.platform;
+      const dirArg = parentOptions.dir;
 
-      // 确保目标目录存在
-      if (!existsSync(targetDir)) {
-        mkdirSync(targetDir, { recursive: true });
+      const resolved = resolveTargetDirs(platformArg, dirArg);
+      if (resolved.error) {
+        printJSON(resolved);
+        process.exit(1);
       }
 
+      const sourceDir = getSkillsSourceDir();
+
       // 获取所有 skills
       const availableSkills = getAvailableSkills();
-
-      // 安装所有 skills
-      const installed = [];
-      for (const skill of availableSkills) {
-        const skillSourcePath = path.join(sourceDir, skill.name);
-        const skillTargetPath = path.join(targetDir, skill.name);
-
-        // 复制 skill 目录
-        cpSync(skillSourcePath, skillTargetPath, { recursive: true });
-        installed.push(skill.name);
+      const toInstall = availableSkills.map(s => s.name);
+
+      // 安装到各目标目录
+      const results = {};
+      for (const target of resolved.targets) {
+        const targetDir = target.targetDir;
+
+        // 确保目标目录存在
+        if (!existsSync(targetDir)) {
+          mkdirSync(targetDir, { recursive: true });
+        }
+
+        // 安装所有 skills
+        const installed = [];
+        for (const skillName of toInstall) {
+          const skillSourcePath = path.join(sourceDir, skillName);
+          const skillTargetPath = path.join(targetDir, skillName);
+
+          // 复制 skill 目录
+          cpSync(skillSourcePath, skillTargetPath, { recursive: true });
+          installed.push(skillName);
+        }
+
+        results[target.platform] = {
+          targetDir: targetDir,
+          installed: installed,
+          count: installed.length,
+        };
       }
 
       printJSON({
         success: true,
-        installed: installed,
-        total: installed.length,
-        targetDir: targetDir,
+        platforms: results,
+        totalPlatforms: resolved.targets.length,
+        totalSkills: toInstall.length,
       });
     } catch (error) {
       printError(error);