imaclawhub 1.0.1 → 1.0.2

package/README.md

@@ -1,6 +1,6 @@
 # imaclawhub
 
-通过 ensure 服务获取技能压缩包并解压到本地（默认解压到与执行命令所在目录平级的文件夹）。
+通过 ensure 服务获取技能列表并解压到本地。命令行会先拉取匹配列表，若有多项则提示选择序号后下载（默认解压到与执行命令所在目录平级）。
 
 ## 安装
 
@@ -13,25 +13,27 @@ npm install imaclawhub
 ### 命令行
 
 ```bash
-npx imaclawhub <技能名称或slug>
+npx imaclawhub <技能名称或关键词>
 ```
 
-示例：`npx imaclawhub my-skill`。若已全局安装（`npm install -g imaclawhub`），可直接执行 `imaclawhub my-skill`。
+会请求 ensure 接口获取匹配列表：仅一项时自动下载；多项时列出序号，输入数字选择后下载。示例：`npx imaclawhub claw`。全局安装后可直接执行 `imaclawhub <关键词>`。
 
 ### 作为库使用
 
 ```javascript
-import { ensureToDesktop, ensureSkill, getDesktopPath } from 'imaclawhub';
+import { ensureToDesktop, ensureSkillList, getDesktopPath } from 'imaclawhub';
 
-// 获取技能并解压（默认解压到与当前目录平级）
+// 获取列表后按序号下载（仅一项时自动下载；每次调用都会重新拉取列表）
 const result = await ensureToDesktop('my-skill');
-if (result.ok) console.log('解压路径:', result.path);
+if (result.needSelection) {
+  await ensureToDesktop('my-skill', { selectedIndex: 0 });
+} else if (result.ok) console.log('解压路径:', result.path);
 
 // 解压到指定目录，如桌面
-await ensureToDesktop('my-skill', { outputDir: getDesktopPath() });
+await ensureToDesktop('my-skill', { outputDir: getDesktopPath(), selectedIndex: 0 });
 
-// 仅获取技能信息（含 downloadUrl）
-const info = await ensureSkill('my-skill');
+// 获取技能列表（每项含 name、slug、downloadUrl 等）
+const { list } = await ensureSkillList('claw');
 ```
 
-选项：`ensureToDesktop(skillName, options)` 支持 `outputDir`、`subdir`。
+选项：`ensureToDesktop(skillName, options)` 支持 `outputDir`、`subdir`、`selectedIndex`、`item`。每次调用都会重新请求 ensure 拉取列表。

package/cli.js

@@ -1,24 +1,74 @@
 #!/usr/bin/env node
 
-import { ensureToDesktop } from './index.js';
+import { createInterface } from 'readline';
+import { ensureSkillList, ensureToDesktop } from './index.js';
 
-const skillName = process.argv[2];
+// 只取第一个参数；名称带空格时请用引号：imaclawhub "AI 衣橱搭配"
+const skillName = (process.argv[2] || '').trim();
 if (!skillName) {
-  console.error('用法: imaclawhub <技能名称或slug>');
-  console.error('示例: imaclawhub my-skill');
+  console.error('用法: imaclawhub <技能名称或关键词>');
+  console.error('示例: imaclawhub my-skill  或  imaclawhub "AI 衣橱搭配"');
   process.exit(1);
 }
 
-ensureToDesktop(skillName)
-  .then((result) => {
-    if (result.ok) {
-      console.log('解压成功:', result.path);
-    } else {
-      console.error('失败:', result.error);
+function run(selectedIndex) {
+  const options = selectedIndex != null ? { selectedIndex } : {};
+  ensureToDesktop(skillName, options)
+    .then((result) => {
+      if (result.ok && result.needSelection) {
+        showSelection(result.list, run);
+        return;
+      }
+      if (result.ok) {
+        console.log('解压成功:', result.path);
+      } else {
+        console.error('失败:', result.error);
+        process.exit(1);
+      }
+    })
+    .catch((err) => {
+      console.error(err.message || err);
       process.exit(1);
-    }
-  })
-  .catch((err) => {
-    console.error(err.message || err);
+    });
+}
+
+function showSelection(list, onSelect) {
+  if (!list || list.length === 0) {
+    console.error('没有可选项');
     process.exit(1);
+  }
+  console.log('\n请选择要下载的技能：\n');
+  list.forEach((item, i) => {
+    const version = item.version ? ` (${item.version})` : '';
+    const err = item.error ? ` - ${item.error}` : '';
+    console.log(`  ${i + 1}. ${item.name || item.slug}${version}${err}`);
+  });
+  console.log('');
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  rl.question(`输入序号 (1-${list.length}): `, (answer) => {
+    rl.close();
+    const num = parseInt(answer.trim(), 10);
+    if (Number.isNaN(num) || num < 1 || num > list.length) {
+      console.error('无效序号');
+      process.exit(1);
+    }
+    onSelect(num - 1);
   });
+}
+
+// 先拉列表，始终弹出列表让用户选择后再下载
+ensureSkillList(skillName).then(({ list, error }) => {
+  if (error) {
+    console.error('失败:', error);
+    process.exit(1);
+  }
+  const downloadable = list.filter((i) => i.downloadUrl && !i.error);
+  if (downloadable.length === 0) {
+    console.error(list.length ? '列表中暂无可用下载链接' : '未找到匹配的技能');
+    process.exit(1);
+  }
+  run(null);
+}).catch((err) => {
+  console.error(err.message || err);
+  process.exit(1);
+});

package/index.js

@@ -4,6 +4,7 @@ import { mkdir } from 'fs/promises';
 import { cwd } from 'process';
 import AdmZip from 'adm-zip';
 
+// const DEFAULT_BASE_URL = 'http://localhost:8848';
 const DEFAULT_BASE_URL = 'https://imahub.imaclaw.ai';
 /**
  * 获取桌面目录路径（跨平台）
@@ -18,26 +19,26 @@ export function getDesktopPath() {
 }
 
 /**
- * 调用 ensure 接口获取技能信息（含下载 URL）
- * @param {string} skillName - 技能名称或 slug
- * @returns {Promise<{ found: boolean, downloadUrl?: string, slug?: string, name?: string, error?: string }>}
+ * 调用 ensure 接口获取技能列表（每项含 downloadUrl 等）
+ * @param {string} skillName - 技能名称或关键词（模糊匹配）
+ * @returns {Promise<{ list: Array<{ name: string, slug: string, version?: string, downloadUrl?: string, error?: string }>, error?: string }>}
  */
-export async function ensureSkill(skillName) {
+export async function ensureSkillList(skillName) {
   const baseUrl = DEFAULT_BASE_URL.replace(/\/$/, '');
-  const name = String(skillName).trim();
+  // 兼容多个空格：规范为单个空格后再 trim
+  const name = String(skillName).replace(/\s+/g, ' ').trim();
   if (!name) {
-    return { found: false, error: '缺少技能名称' };
+    return { list: [], error: '缺少技能名称或关键词' };
   }
   const url = `${baseUrl}/skills/ensure?name=${encodeURIComponent(name)}`;
   const res = await fetch(url);
   const data = await res.json().catch(() => ({}));
   if (!res.ok) {
-    return {
-      found: false,
-      error: data.error || `HTTP ${res.status}`,
-    };
+    return { list: [], error: data.error || `HTTP ${res.status}` };
   }
-  return data;
+  // 支持接口直接返回数组，或 { list } / { items }
+  const list = Array.isArray(data) ? data : (data.list || data.items || []);
+  return { list };
 }
 
 /**
@@ -59,44 +60,52 @@ export async function downloadAndExtractZip(zipUrl, outDir) {
 }
 
 /**
- * 通过 ensure 接口获取技能 zip URL，下载并解压到指定目录
+ * 通过 ensure 接口获取技能列表，按选中项下载并解压到指定目录
  * 默认解压到「执行命令所在目录」的平级目录（即上级目录下的 <slug> 文件夹）
- * @param {string} skillName - 技能名称或 slug
- * @param {{ outputDir?: string, subdir?: string }} options
- *   - outputDir: 解压目标父目录，默认 process.cwd() 的上一级（与当前目录平级）
- *   - subdir: 解压后的文件夹名，默认使用 slug
- * @returns {Promise<{ ok: boolean, path?: string, slug?: string, error?: string }>}
+ * @param {string} skillName - 技能名称或关键词
+ * @param {{ outputDir?: string, subdir?: string, selectedIndex?: number, item?: { slug: string, name?: string, downloadUrl?: string } }} options
+ *   - outputDir: 解压目标父目录，默认 process.cwd() 的上一级
+ *   - subdir: 解压后的文件夹名，默认使用输入的名称（如「AI 衣橱搭配」），为空则用 slug
+ *   - selectedIndex: 列表中的序号（0-based），与 item 二选一
+ *   - item: 直接指定要下载的项（含 downloadUrl、slug），与 selectedIndex 二选一
+ * @returns {Promise<{ ok: boolean, path?: string, slug?: string, needSelection?: boolean, list?: Array, error?: string }>}
  */
 export async function ensureToDesktop(skillName, options = {}) {
-  const ensureResult = await ensureSkill(skillName);
-  if (!ensureResult.found || ensureResult.error) {
+  // 每次安装都重新拉取列表
+  const result = await ensureSkillList(skillName);
+  if (result.error) return { ok: false, error: result.error };
+  const list = result.list;
+  const downloadable = list.filter((i) => i.downloadUrl && !i.error);
+  if (downloadable.length === 0) {
     return {
       ok: false,
-      error: ensureResult.error || '未找到该技能',
+      error: list.length ? '列表中暂无可用下载链接' : '未找到匹配的技能',
+      list,
     };
   }
-  const downloadUrl = ensureResult.downloadUrl;
+
+  let item = options.item;
+  if (!item && options.selectedIndex != null) {
+    const idx = Number(options.selectedIndex);
+    if (idx >= 0 && idx < downloadable.length) item = downloadable[idx];
+  }
+  // 未传 selectedIndex 时始终返回列表让用户选择，不自动选中唯一项
+  if (!item) {
+    return { ok: true, needSelection: true, list: downloadable };
+  }
+
+  const downloadUrl = item.downloadUrl;
   if (!downloadUrl) {
-    return {
-      ok: false,
-      error: 'ensure 接口未返回 downloadUrl',
-    };
+    return { ok: false, error: item.error || '该项无下载链接', slug: item.slug };
   }
-  // 默认：与执行命令的目录平级（上级目录下的 <slug>）
+
   const baseDir = options.outputDir ?? join(cwd(), '..');
-  const subdir = options.subdir ?? options.desktopSubdir ?? ensureResult.slug ?? skillName.trim();
+  // 优先使用用户输入的名称作为文件夹名，如 imaclawhub 'AI 衣橱搭配' → 解压到 .../AI 衣橱搭配
+  const subdir = options.subdir ?? options.desktopSubdir ?? (skillName.replace(/\s+/g, ' ').trim() || item.slug);
   const outDir = join(baseDir, subdir);
   const extractResult = await downloadAndExtractZip(downloadUrl, outDir);
   if (!extractResult.ok) {
-    return {
-      ok: false,
-      error: extractResult.error,
-      slug: ensureResult.slug,
-    };
+    return { ok: false, error: extractResult.error, slug: item.slug };
   }
-  return {
-    ok: true,
-    path: extractResult.path,
-    slug: ensureResult.slug,
-  };
+  return { ok: true, path: extractResult.path, slug: item.slug };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "imaclawhub",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Fetch skill from local ensure API and extract to Desktop",
   "type": "module",
   "main": "index.js",
@@ -15,7 +15,10 @@
     "cli.js",
     "README.md"
   ],
-  "scripts": {},
+  "scripts": {
+    "dev": "node cli.js",
+    "start": "node cli.js"
+  },
   "keywords": [
     "clawhub",
     "skills",