sophhub 0.1.0 → 0.1.2

package/README.md

@@ -0,0 +1,122 @@
+# SophHub CLI
+
+SophHub CLI 是一个命令行工具，用于浏览和下载 AI Agent Skill。
+
+## 安装
+
+```bash
+npm install -g sophhub
+```
+
+或者用 `npx` 免安装直接运行：
+
+```bash
+npx sophhub list
+```
+
+要求 Node.js >= 18。
+
+## 使用
+
+### 查看所有 Skill
+
+```bash
+sophhub list
+```
+
+按类型筛选：
+
+```bash
+sophhub list --type builtin
+sophhub list --type store
+```
+
+以 JSON 格式输出（方便脚本和管道消费）：
+
+```bash
+sophhub list --json
+sophhub list --type store --json
+```
+
+### 下载 Skill
+
+下载到当前目录：
+
+```bash
+sophhub download weather
+```
+
+指定输出目录：
+
+```bash
+sophhub download didi-ride -o ./my-skills
+```
+
+### 查看版本
+
+```bash
+sophhub --version
+```
+
+### 查看帮助
+
+```bash
+sophhub --help
+sophhub list --help
+sophhub download --help
+```
+
+## 配置
+
+可通过 `~/.sophhubrc.json` 配置默认行为：
+
+```json
+{
+  "defaultOutput": "."
+}
+```
+
+| 字段 | 说明 | 默认值 |
+| --- | --- | --- |
+| `defaultOutput` | download 默认输出目录 | `.`（当前目录） |
+
+命令行参数 `-o` 优先级高于配置文件。
+
+## 开发
+
+```bash
+# 克隆仓库
+git clone git@gitlab.sophgo.vip:llm-open-platform/sophclaw-skills.git
+cd sophclaw-skills/cli
+
+# 安装依赖
+npm install
+
+# 准备内置 skill（从仓库根目录拷贝到 cli/skills/）
+bash scripts/prepublish.sh
+
+# 全局注册命令（符号链接，修改代码即时生效）
+npm link
+
+# 调试
+sophhub list
+sophhub download weather -o /tmp/test
+
+# 调试完毕后卸载
+npm unlink -g sophhub
+```
+
+## 发版
+
+```bash
+cd cli
+
+# 升版本（patch / minor / major）
+npm version patch
+
+# 发布（自动触发 prepublish 打包 skills）
+npm publish
+
+# 推送 tag
+git push && git push --tags
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sophhub",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "SophHub CLI - Manage and download AI Agent skills",
   "type": "module",
   "bin": {

package/skills/VERSIONS.md

@@ -1,27 +1,27 @@
 # Skill Versions
 
-| Skill | Type | Version | Updated At |
-| --- | --- | --- | --- |
-| clawhub | builtin | 1.0.0 | 2026-04-08 |
-| flight-booking | builtin | 1.1.0 | 2026-04-08 |
-| inventory-management | builtin | 1.0.0 | 2026-04-08 |
-| schedule-reminder | builtin | 1.0.0 | 2026-04-08 |
-| skill-creator | builtin | 1.0.0 | 2026-04-08 |
-| sophnet-customer-management | builtin | 1.0.0 | 2026-04-08 |
-| sophnet-customized-marketing | builtin | 1.0.0 | 2026-04-08 |
-| sophnet-face-search | builtin | 1.0.0 | 2026-04-08 |
-| sophnet-image-edit | builtin | 1.0.0 | 2026-04-08 |
-| sophnet-image-generate | builtin | 1.0.0 | 2026-04-08 |
-| sophnet-image-ocr | builtin | 1.0.0 | 2026-04-08 |
-| sophnet-infinite-talk | builtin | 1.0.0 | 2026-04-08 |
-| sophnet-oss | builtin | 1.0.0 | 2026-04-08 |
-| sophnet-qa-install | builtin | 2.0.0 | 2026-04-08 |
-| sophnet-training-install | builtin | 2.0.0 | 2026-04-08 |
-| sophnet-tts | builtin | 1.0.0 | 2026-04-08 |
-| sophnet-video-generate | builtin | 1.0.0 | 2026-04-08 |
-| video-understand | builtin | 1.0.0 | 2026-04-08 |
-| weather | builtin | 1.0.0 | 2026-04-08 |
-| web-scraper | builtin | 1.0.0 | 2026-04-08 |
-| website-builder | builtin | 1.0.0 | 2026-04-08 |
-| didi-ride | store | 1.0.0 | 2026-04-09 |
-| flyai | store | 1.0.10 | 2026-04-09 |
+| Skill | Type | Version | Updated At | Display Name | Description |
+| --- | --- | --- | --- | --- | --- |
+| clawhub | builtin | 1.0.0 | 2026-04-08 |  |  |
+| flight-booking | builtin | 1.1.0 | 2026-04-08 |  |  |
+| inventory-management | builtin | 1.0.0 | 2026-04-08 |  |  |
+| schedule-reminder | builtin | 1.0.0 | 2026-04-08 |  |  |
+| skill-creator | builtin | 1.0.0 | 2026-04-08 |  |  |
+| sophnet-customer-management | builtin | 1.0.0 | 2026-04-08 |  |  |
+| sophnet-customized-marketing | builtin | 1.0.0 | 2026-04-08 |  |  |
+| sophnet-face-search | builtin | 1.0.0 | 2026-04-08 |  |  |
+| sophnet-image-edit | builtin | 1.0.0 | 2026-04-08 |  |  |
+| sophnet-image-generate | builtin | 1.0.0 | 2026-04-08 |  |  |
+| sophnet-image-ocr | builtin | 1.0.0 | 2026-04-08 |  |  |
+| sophnet-infinite-talk | builtin | 1.0.0 | 2026-04-08 |  |  |
+| sophnet-oss | builtin | 1.0.0 | 2026-04-08 |  |  |
+| sophnet-qa-install | builtin | 2.0.0 | 2026-04-08 |  |  |
+| sophnet-training-install | builtin | 2.0.0 | 2026-04-08 |  |  |
+| sophnet-tts | builtin | 1.0.0 | 2026-04-08 |  |  |
+| sophnet-video-generate | builtin | 1.0.0 | 2026-04-08 |  |  |
+| video-understand | builtin | 1.0.0 | 2026-04-08 |  |  |
+| weather | builtin | 1.0.0 | 2026-04-08 |  |  |
+| web-scraper | builtin | 1.0.0 | 2026-04-08 |  |  |
+| website-builder | builtin | 1.0.0 | 2026-04-08 |  |  |
+| didi-ride | store | 1.0.0 | 2026-04-09 | 滴滴出行 | 打车、路线规划、周边搜索、订单查询 |
+| flyai | store | 1.0.10 | 2026-04-09 | 飞猪旅行 | 机票、酒店、景点门票、旅行搜索与预订 |

package/src/commands/download.js

@@ -5,7 +5,6 @@ import readline from 'node:readline/promises';
 import { findSkill } from '../utils/versions.js';
 import { getSkillDir } from '../utils/paths.js';
 import { loadConfig } from '../utils/config.js';
-import { downloadFromGitlab } from '../utils/gitlab.js';
 
 async function confirmOverwrite(destDir) {
   const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
@@ -19,41 +18,17 @@ async function confirmOverwrite(destDir) {
   }
 }
 
-async function downloadFromBuiltin(type, skillName, outputDir) {
-  const srcDir = getSkillDir(type, skillName);
-
-  try {
-    await fs.access(srcDir);
-  } catch {
-    throw new Error(
-      `Skill directory not found in package: ${srcDir}\n` +
-        'The bundled skills may be outdated. Try --source gitlab for the latest version.',
-    );
-  }
-
-  const destDir = path.join(outputDir, skillName);
-  await fs.cp(srcDir, destDir, { recursive: true });
-  return destDir;
-}
-
 export function registerDownloadCommand(program) {
   program
     .command('download')
     .description('Download a skill to local directory')
     .argument('<skill-name>', 'Name of the skill to download')
     .option('-o, --output <dir>', 'Target directory (default: current directory)')
-    .option('-s, --source <source>', 'Data source: builtin (default) or gitlab')
     .action(async (skillName, opts) => {
       try {
         const config = await loadConfig();
-        const source = opts.source || config.defaultSource || 'builtin';
         const outputDir = path.resolve(opts.output || config.defaultOutput || '.');
 
-        if (source !== 'builtin' && source !== 'gitlab') {
-          console.error(chalk.red(`Invalid source "${source}". Use "builtin" or "gitlab".`));
-          process.exit(1);
-        }
-
         const skill = await findSkill(skillName);
         if (!skill) {
           console.error(chalk.red(`Skill "${skillName}" not found.`));
@@ -78,22 +53,22 @@ export function registerDownloadCommand(program) {
         await fs.mkdir(outputDir, { recursive: true });
 
         console.log();
-        console.log(chalk.gray(`  Downloading ${skillName} from ${source}...`));
+        console.log(chalk.gray(`  Downloading ${skillName}...`));
 
-        let result;
-        if (source === 'gitlab') {
-          const repoUrl = config.gitlabRepo;
-          result = await downloadFromGitlab(repoUrl, skill.type, skillName, outputDir);
-        } else {
-          result = await downloadFromBuiltin(skill.type, skillName, outputDir);
+        const srcDir = getSkillDir(skill.type, skillName);
+        try {
+          await fs.access(srcDir);
+        } catch {
+          throw new Error(`Skill directory not found in package: ${srcDir}`);
         }
 
+        await fs.cp(srcDir, destDir, { recursive: true });
+
         console.log();
         console.log(chalk.green('  ✓ Download complete'));
         console.log(chalk.gray(`    Skill:   ${skill.name}`));
         console.log(chalk.gray(`    Version: ${skill.version}`));
-        console.log(chalk.gray(`    Source:  ${source}`));
-        console.log(chalk.gray(`    Path:    ${result}`));
+        console.log(chalk.gray(`    Path:    ${destDir}`));
         console.log();
       } catch (err) {
         console.error(chalk.red(`\n  Failed to download: ${err.message}\n`));

package/src/commands/list.js

@@ -35,23 +35,34 @@ export function registerListCommand(program) {
           return;
         }
 
+        const hasDisplayInfo = skills.some((s) => s.displayName || s.description);
+
+        const head = [
+          chalk.cyan('Skill'),
+          chalk.cyan('Type'),
+          chalk.cyan('Version'),
+          chalk.cyan('Updated At'),
+        ];
+        if (hasDisplayInfo) {
+          head.push(chalk.cyan('Display Name'), chalk.cyan('Description'));
+        }
+
         const table = new Table({
-          head: [
-            chalk.cyan('Skill'),
-            chalk.cyan('Type'),
-            chalk.cyan('Version'),
-            chalk.cyan('Updated At'),
-          ],
+          head,
           style: { head: [], border: [] },
         });
 
         for (const s of skills) {
-          table.push([
+          const row = [
             s.name,
             s.type === 'builtin' ? chalk.blue(s.type) : chalk.green(s.type),
             s.version,
             s.updatedAt,
-          ]);
+          ];
+          if (hasDisplayInfo) {
+            row.push(s.displayName, s.description);
+          }
+          table.push(row);
         }
 
         console.log();

package/src/utils/config.js

@@ -6,8 +6,6 @@ const CONFIG_PATH = path.join(os.homedir(), '.sophhubrc.json');
 
 const DEFAULTS = {
   defaultOutput: '.',
-  defaultSource: 'builtin',
-  gitlabRepo: 'git@gitlab.sophgo.vip:llm-open-platform/sophclaw-skills.git',
 };
 
 export async function loadConfig() {

package/src/utils/versions.js

@@ -1,18 +1,8 @@
 import fs from 'node:fs/promises';
 import { getVersionsPath } from './paths.js';
 
-/**
- * Parse VERSIONS.md markdown table into an array of skill objects.
- * Expected format:
- *   | Skill | Type | Version | Updated At |
- *   | --- | --- | --- | --- |
- *   | weather | builtin | 1.0.0 | 2026-04-08 |
- */
-export async function parseVersions() {
-  const content = await fs.readFile(getVersionsPath(), 'utf-8');
+function parseMarkdownTable(content) {
   const lines = content.split('\n').filter((l) => l.trim().startsWith('|'));
-
-  // skip header row and separator row (first two | lines)
   const dataLines = lines.slice(2);
 
   return dataLines
@@ -27,11 +17,18 @@ export async function parseVersions() {
         type: cells[1],
         version: cells[2],
         updatedAt: cells[3],
+        displayName: cells[4] || '',
+        description: cells[5] || '',
       };
     })
     .filter(Boolean);
 }
 
+export async function parseVersions() {
+  const content = await fs.readFile(getVersionsPath(), 'utf-8');
+  return parseMarkdownTable(content);
+}
+
 export async function findSkill(skillName) {
   const skills = await parseVersions();
   return skills.find((s) => s.name === skillName) || null;

package/src/utils/gitlab.js

@@ -1,67 +0,0 @@
-import { execFile } from 'node:child_process';
-import { promisify } from 'node:util';
-import fs from 'node:fs/promises';
-import path from 'node:path';
-import os from 'node:os';
-
-const execFileAsync = promisify(execFile);
-
-/**
- * Download a skill directory from GitLab using `git archive --remote`.
- * Falls back to sparse-checkout if archive is not supported by the server.
- */
-export async function downloadFromGitlab(repoUrl, type, skillName, outputDir) {
-  const destDir = path.join(outputDir, skillName);
-  const subPath = `${type}/${skillName}`;
-
-  // Try git archive first (most efficient, single-command)
-  try {
-    await fs.mkdir(destDir, { recursive: true });
-    const { stdout } = await execFileAsync(
-      'git',
-      ['archive', '--remote', repoUrl, 'HEAD', subPath],
-      { maxBuffer: 50 * 1024 * 1024 },
-    );
-
-    // pipe tar output through extraction
-    const tar = execFileAsync('tar', ['-x', '-C', outputDir], {
-      maxBuffer: 50 * 1024 * 1024,
-    });
-    tar.child.stdin.write(stdout);
-    tar.child.stdin.end();
-    await tar;
-
-    // git archive extracts to {type}/{skillName}/, move to {outputDir}/{skillName}/
-    const extracted = path.join(outputDir, type, skillName);
-    if (extracted !== destDir) {
-      await fs.cp(extracted, destDir, { recursive: true });
-      await fs.rm(path.join(outputDir, type), { recursive: true, force: true });
-    }
-    return destDir;
-  } catch {
-    // archive --remote not supported, fall back to sparse checkout
-  }
-
-  return downloadViaSparseCheckout(repoUrl, subPath, destDir);
-}
-
-async function downloadViaSparseCheckout(repoUrl, subPath, destDir) {
-  const tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'sophhub-'));
-
-  try {
-    await execFileAsync(
-      'git',
-      ['clone', '--filter=blob:none', '--sparse', '--depth=1', repoUrl, tmpDir],
-      { timeout: 120_000 },
-    );
-
-    await execFileAsync('git', ['sparse-checkout', 'set', subPath], { cwd: tmpDir });
-
-    const src = path.join(tmpDir, subPath);
-    await fs.cp(src, destDir, { recursive: true });
-
-    return destDir;
-  } finally {
-    await fs.rm(tmpDir, { recursive: true, force: true }).catch(() => {});
-  }
-}