imaclawhub 1.0.2 → 1.0.4

package/README.md

@@ -1,39 +1,37 @@
 # imaclawhub
 
-通过 ensure 服务获取技能列表并解压到本地。命令行会先拉取匹配列表，若有多项则提示选择序号后下载（默认解压到与执行命令所在目录平级）。
+通过 ensure 服务获取技能列表并解压到本地。默认安装到本机 openclaw 的 skills 目录（`~/.openclaw/skills/<名称>`），可通过环境变量 `IMACLAWHUB_OUTPUT_DIR` 设置安装目录。使用默认安装目录时会先检查本机是否已安装 openclaw（存在 `~/.openclaw` 目录），未安装则提示先安装 openclaw 并中断；支持 Mac / Linux / Windows。
 
-## 安装
+## 全局安装
 
 ```bash
-npm install imaclawhub
+npm install imaclawhub -g
 ```
 
 ## 使用
 
-### 命令行
-
+全局安装后可直接执行
 ```bash
-npx imaclawhub <技能名称或关键词>
+imaclawhub <技能名称>
 ```
+## 或者直接使用npx
 
-会请求 ensure 接口获取匹配列表：仅一项时自动下载；多项时列出序号，输入数字选择后下载。示例：`npx imaclawhub claw`。全局安装后可直接执行 `imaclawhub <关键词>`。
-
-### 作为库使用
-
-```javascript
-import { ensureToDesktop, ensureSkillList, getDesktopPath } from 'imaclawhub';
+```bash
+npx imaclawhub <技能名称>
+```
 
-// 获取列表后按序号下载（仅一项时自动下载；每次调用都会重新拉取列表）
-const result = await ensureToDesktop('my-skill');
-if (result.needSelection) {
-  await ensureToDesktop('my-skill', { selectedIndex: 0 });
-} else if (result.ok) console.log('解压路径:', result.path);
+会请求 ensure 接口获取匹配列表，列出序号后输入数字选择并下载。示例：`npx imaclawhub claw`。。
 
-// 解压到指定目录，如桌面
-await ensureToDesktop('my-skill', { outputDir: getDesktopPath(), selectedIndex: 0 });
+**设置安装目录**（可选项，一般不需要设置）  
+已安装 openclaw 时，技能会默认安装到 `~/.openclaw/skills`，无需额外配置。仅在需要安装到其他目录（如未安装 openclaw 或自定义路径）时再设置：
 
-// 获取技能列表（每项含 name、slug、downloadUrl 等）
-const { list } = await ensureSkillList('claw');
+- 命令：`imaclawhub set dir '<路径>'`，会写入 `~/.imaclawhub/config.json`，之后安装**直接**使用该目录。
+```bash
+imaclawhub set dir /path/to/my/skills
+imaclawhub set dir "/path/with spaces"
 ```
+- 清空已设定目录：`imaclawhub set dir --clear`，恢复为默认（需已安装 openclaw）。
+- 或环境变量：`IMACLAWHUB_OUTPUT_DIR`（优先级高于 set dir 配置）。
+优先级：环境变量 > `imaclawhub set dir` 配置 > `~/.openclaw/skills`。直接运行 `imaclawhub` 不加参数可查看当前安装目录。
 
-选项：`ensureToDesktop(skillName, options)` 支持 `outputDir`、`subdir`、`selectedIndex`、`item`。每次调用都会重新请求 ensure 拉取列表。
+**检查 openclaw 是否已安装**：`imaclawhub check openclaw`，会输出「已安装」或「未安装」及默认技能目录。

package/cli.js

@@ -1,74 +1,140 @@
 #!/usr/bin/env node
 
 import { createInterface } from 'readline';
-import { ensureSkillList, ensureToDesktop } from './index.js';
+import {
+  ensureSkillList,
+  ensureToDesktop,
+  getOpenClawSkillsDir,
+  getConfiguredOutputDir,
+  setConfiguredOutputDir,
+  clearConfiguredOutputDir,
+  isOpenClawInstalled,
+} from './index.js';
 
-// 只取第一个参数；名称带空格时请用引号：imaclawhub "AI 衣橱搭配"
-const skillName = (process.argv[2] || '').trim();
-if (!skillName) {
-  console.error('用法: imaclawhub <技能名称或关键词>');
-  console.error('示例: imaclawhub my-skill  或  imaclawhub "AI 衣橱搭配"');
-  process.exit(1);
-}
+// 安装目录优先级：环境变量 > imaclawhub set dir 配置 > ~/.openclaw/skills
+const outputDir = process.env.IMACLAWHUB_OUTPUT_DIR || getConfiguredOutputDir() || getOpenClawSkillsDir();
 
-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);
+// 命令：imaclawhub check openclaw | imaclawhub set dir '<path>'
+const arg0 = process.argv[2];
+const arg1 = process.argv[3];
+if (arg0 === 'check' && arg1 === 'openclaw') {
+  const installed = isOpenClawInstalled();
+  const skillsDir = getOpenClawSkillsDir();
+  if (installed) {
+    console.log('openclaw: 已安装');
+    console.log('默认技能目录: ' + skillsDir);
+  } else {
+    console.log('openclaw: 未安装');
+    console.log('期望目录: ' + skillsDir + '（请先安装 openclaw 或使用 imaclawhub set dir <路径> 指定安装目录）');
+  }
+  process.exit(installed ? 0 : 1);
+} else if (arg0 === 'set' && arg1 === 'dir') {
+  const dir = (process.argv[4] != null ? process.argv.slice(4).join(' ') : '').trim();
+  if (dir === '--clear' || dir === '--unset') {
+    clearConfiguredOutputDir()
+      .then(() => {
+        console.log('已清空安装目录设置，将使用默认目录（需已安装 openclaw）。');
+        process.exit(0);
+      })
+      .catch((err) => {
+        console.error('清空失败:', err.message || err);
         process.exit(1);
-      }
-    })
-    .catch((err) => {
-      console.error(err.message || err);
+      });
+    // flow stops here (async)
+  } else if (!dir) {
+    console.error('用法: imaclawhub set dir <安装目录路径>');
+    console.error('       imaclawhub set dir --clear   # 清空已设定的安装目录');
+    console.error('示例: imaclawhub set dir /path/to/skills  或  imaclawhub set dir "C:\\My Skills"');
+    process.exit(1);
+  } else {
+    setConfiguredOutputDir(dir)
+      .then(() => {
+        console.log('已设置安装目录: ' + dir);
+        process.exit(0);
+      })
+      .catch((err) => {
+        console.error('设置失败:', err.message || err);
+        process.exit(1);
+      });
+  }
+} else {
+  // 只取第一个参数；名称带空格时请用引号：imaclawhub "AI 衣橱搭配"
+  const skillName = (process.argv[2] || '').trim();
+  if (!skillName) {
+    console.error('用法: imaclawhub <技能名称或关键词>');
+    console.error('       imaclawhub check openclaw   # 检查是否已安装 openclaw');
+    console.error('       imaclawhub set dir <路径>   # 设定安装目录（已设置则直接安装到该目录）');
+    console.error('       imaclawhub set dir --clear # 清空已设定的安装目录');
+    console.error('示例: imaclawhub my-skill  或  imaclawhub "AI 衣橱搭配"');
+    console.error('安装目录: ' + outputDir + (isOpenClawInstalled() ? ' (已检测到 openclaw)' : ' (未检测到 openclaw，请先安装或 imaclawhub set dir <路径>)'));
+    process.exit(1);
+  }
+
+  function run(selectedIndex) {
+    const options = { outputDir };
+    if (selectedIndex != null) options.selectedIndex = selectedIndex;
+    ensureToDesktop(skillName, options)
+      .then((result) => {
+        if (result.ok && result.needSelection) {
+          showSelection(result.list, run);
+          return;
+        }
+        if (result.ok) {
+          console.log('安装成功');
+        } else {
+          console.error('失败:', result.error);
+          process.exit(1);
+        }
+      })
+      .catch((err) => {
+        console.error(err.message || err);
+        process.exit(1);
+      });
+  }
+
+  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);
     });
-}
-
-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('无效序号');
+
+  (async () => {
+    const usingDefaultOpenClawDir = !process.env.IMACLAWHUB_OUTPUT_DIR && !getConfiguredOutputDir();
+    if (usingDefaultOpenClawDir && !isOpenClawInstalled()) {
+      console.error('未检测到 openclaw，请先安装 openclaw 或使用 imaclawhub set dir <路径> 指定安装目录。');
+      process.exit(1);
+    }
+    const { list, error } = await ensureSkillList(skillName);
+    if (error) {
+      console.error('失败:', error);
       process.exit(1);
     }
-    onSelect(num - 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);
   });
 }
-
-// 先拉列表，始终弹出列表让用户选择后再下载
-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

@@ -1,21 +1,105 @@
 import { join } from 'path';
 import { homedir, platform } from 'os';
-import { mkdir } from 'fs/promises';
-import { cwd } from 'process';
+import { existsSync, readFileSync } from 'fs';
+import { mkdir, writeFile, unlink } from 'fs/promises';
 import AdmZip from 'adm-zip';
 
 // const DEFAULT_BASE_URL = 'http://localhost:8848';
 const DEFAULT_BASE_URL = 'https://imahub.imaclaw.ai';
+
 /**
- * 获取桌面目录路径（跨平台）
+ * 获取 openclaw 根目录（skills 的父目录）
+ * Mac / Linux: ~/.openclaw，Windows: %USERPROFILE%\.openclaw
  * @returns {string}
  */
-export function getDesktopPath() {
+function getOpenClawBaseDir() {
+  const home = homedir();
+  if (platform() === 'win32') {
+    const base = process.env.USERPROFILE || home;
+    return join(base, '.openclaw');
+  }
+  return join(home, '.openclaw');
+}
+
+/**
+ * 检查当前电脑是否已存在 openclaw 目录（即是否“已安装” openclaw 环境）
+ * @returns {boolean}
+ */
+export function isOpenClawInstalled() {
+  return existsSync(getOpenClawBaseDir());
+}
+
+/**
+ * 获取本机 openclaw 的 skills 目录（默认安装目录）
+ * Mac / Linux: ~/.openclaw/skills，Windows: %USERPROFILE%\.openclaw\skills
+ * @returns {string}
+ */
+export function getOpenClawSkillsDir() {
+  return join(getOpenClawBaseDir(), 'skills');
+}
+
+/**
+ * 确保 openclaw skills 目录存在；若不存在则创建并返回目录路径
+ * @returns {Promise<string>}
+ */
+export async function ensureOpenClawSkillsDir() {
+  const dir = getOpenClawSkillsDir();
+  await mkdir(dir, { recursive: true });
+  return dir;
+}
+
+/** imaclawhub 配置目录：~/.imaclawhub（用于保存 set dir 等配置） */
+function getImaclawhubConfigDir() {
   const home = homedir();
   if (platform() === 'win32') {
-    return process.env.USERPROFILE ? join(process.env.USERPROFILE, 'Desktop') : join(home, 'Desktop');
+    const base = process.env.USERPROFILE || home;
+    return join(base, '.imaclawhub');
+  }
+  return join(home, '.imaclawhub');
+}
+
+const CONFIG_FILENAME = 'config.json';
+
+/**
+ * 读取通过 imaclawhub set dir 设置的安装目录，未设置则返回 null
+ * @returns {string | null}
+ */
+export function getConfiguredOutputDir() {
+  try {
+    const configPath = join(getImaclawhubConfigDir(), CONFIG_FILENAME);
+    if (!existsSync(configPath)) return null;
+    const raw = readFileSync(configPath, 'utf-8');
+    const data = JSON.parse(raw);
+    const dir = data?.outputDir;
+    return typeof dir === 'string' && dir.trim() ? dir.trim() : null;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * 保存安装目录（供 imaclawhub set dir 使用）
+ * @param {string} dir - 绝对或相对路径
+ * @returns {Promise<void>}
+ */
+export async function setConfiguredOutputDir(dir) {
+  const path = dir.trim();
+  if (!path) throw new Error('安装目录不能为空');
+  const configDir = getImaclawhubConfigDir();
+  await mkdir(configDir, { recursive: true });
+  const configPath = join(configDir, CONFIG_FILENAME);
+  await writeFile(configPath, JSON.stringify({ outputDir: path }, null, 2), 'utf-8');
+}
+
+/**
+ * 清空已设置的安装目录（删除 ~/.imaclawhub/config.json 中的 outputDir）
+ * @returns {Promise<void>}
+ */
+export async function clearConfiguredOutputDir() {
+  const configPath = join(getImaclawhubConfigDir(), CONFIG_FILENAME);
+  if (existsSync(configPath)) {
+    await unlink(configPath);
   }
-  return join(home, 'Desktop');
 }
 
 /**
@@ -61,10 +145,10 @@ export async function downloadAndExtractZip(zipUrl, outDir) {
 
 /**
  * 通过 ensure 接口获取技能列表，按选中项下载并解压到指定目录
- * 默认解压到「执行命令所在目录」的平级目录（即上级目录下的 <slug> 文件夹）
+ * 默认解压到本机 openclaw 的 skills 目录（~/.openclaw/skills/<名称>）
  * @param {string} skillName - 技能名称或关键词
  * @param {{ outputDir?: string, subdir?: string, selectedIndex?: number, item?: { slug: string, name?: string, downloadUrl?: string } }} options
- *   - outputDir: 解压目标父目录，默认 process.cwd() 的上一级
+ *   - outputDir: 解压目标父目录，默认 getOpenClawSkillsDir()（~/.openclaw/skills）
  *   - subdir: 解压后的文件夹名，默认使用输入的名称（如「AI 衣橱搭配」），为空则用 slug
  *   - selectedIndex: 列表中的序号（0-based），与 item 二选一
  *   - item: 直接指定要下载的项（含 downloadUrl、slug），与 selectedIndex 二选一
@@ -99,9 +183,9 @@ export async function ensureToDesktop(skillName, options = {}) {
     return { ok: false, error: item.error || '该项无下载链接', slug: item.slug };
   }
 
-  const baseDir = options.outputDir ?? join(cwd(), '..');
+  const baseDir = options.outputDir ?? getOpenClawSkillsDir();
   // 优先使用用户输入的名称作为文件夹名，如 imaclawhub 'AI 衣橱搭配' → 解压到 .../AI 衣橱搭配
-  const subdir = options.subdir ?? options.desktopSubdir ?? (skillName.replace(/\s+/g, ' ').trim() || item.slug);
+  const subdir = options.subdir ?? (skillName.replace(/\s+/g, ' ').trim() || item.slug);
   const outDir = join(baseDir, subdir);
   const extractResult = await downloadAndExtractZip(downloadUrl, outDir);
   if (!extractResult.ok) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "imaclawhub",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Fetch skill from local ensure API and extract to Desktop",
   "type": "module",
   "main": "index.js",