imahub-test 1.0.1

package/README.md

@@ -0,0 +1,80 @@
+# imahub
+
+通过 ensure 服务获取技能列表并解压到本地。默认安装到本机 openclaw 的 skills 目录（`~/.openclaw/skills/<名称>`），可通过环境变量 `IMAHUB_OUTPUT_DIR` 设置安装目录。使用默认安装目录时会先检查本机是否已安装 openclaw（存在 `~/.openclaw` 目录），未安装则提示先安装 openclaw 并中断；支持 Mac / Linux / Windows。
+
+## 全局安装
+
+```bash
+npm install imahub -g
+```
+
+## 使用
+
+全局安装后可直接执行
+```bash
+imahub install <技能名称>
+```
+
+查看版本号
+```bash
+imahub -v
+```
+## 或者直接使用npx
+
+```bash
+npx imahub install <技能名称>
+```
+
+会请求 ensure 接口获取匹配列表，列出序号后输入数字选择并下载。示例：`npx imahub install claw`。
+
+**设置安装目录**（可选项，一般不需要设置）  
+已安装 openclaw 时，技能会默认安装到 `~/.openclaw/skills`，无需额外配置。仅在需要安装到其他目录（如未安装 openclaw 或自定义路径）时再设置：
+
+- 命令：`imahub set dir '<路径>'`，会写入 `~/.imahub/config.json`，之后安装**直接**使用该目录。
+```bash
+imahub set dir /path/to/my/skills
+imahub set dir "/path/with spaces"
+```
+- 清空已设定目录：`imahub set dir --clear`，恢复为默认（需已安装 openclaw）。
+- 或环境变量：`IMAHUB_OUTPUT_DIR`（优先级高于 set dir 配置）。
+优先级：环境变量 > `imahub set dir` 配置 > `~/.openclaw/skills`。直接运行 `imahub` 不加参数可查看当前安装目录。
+
+**检查 openclaw 是否已安装**：`imahub check openclaw`，会输出「已安装」或「未安装」及默认技能目录。
+
+## 发布脚本（测试包 / 正式包）
+
+已内置两套发布命令，分别管理包名、请求地址、版本号：
+
+- 测试包：`imahub-test`
+- 正式包：`imahub`
+
+配置文件：
+
+- `release.config.json`：管理包名、请求地址、registry、npm tag
+- `release.versions.json`：分别维护 `test` / `prod` 版本号
+
+命令：
+
+```bash
+# 测试包发布（默认 patch 递增）
+npm run publish:test
+
+# 正式包发布（默认 patch 递增）
+npm run publish:prod
+
+# 指定版本递增类型
+npm run publish:test -- minor
+npm run publish:prod -- major
+
+# 直接指定目标版本
+npm run publish:test -- 0.2.0
+npm run publish:prod -- 1.1.0
+
+# 仅校验，不真正发布
+npm run publish:test -- --dry-run
+```
+
+说明：
+
+- 测试包默认使用 `beta` tag，正式包使用 `latest` tag。
+- 发布前脚本会自动更新 `package.json` 的 `name/version`，并同步替换 `index.js` 中的 `DEFAULT_BASE_URL`。

package/cli.js

@@ -0,0 +1,142 @@
+#!/usr/bin/env node
+
+import { readFileSync } from 'fs';
+import {
+  ensureSkillList,
+  ensureToDesktop,
+  getOpenClawSkillsDir,
+  getConfiguredOutputDir,
+  setConfiguredOutputDir,
+  clearConfiguredOutputDir,
+  isOpenClawInstalled,
+} from './index.js';
+
+const CLI_NAME = 'imahub';
+const CLI_VERSION = JSON.parse(readFileSync(new URL('./package.json', import.meta.url), 'utf-8')).version;
+const OUTPUT_DIR_ENV = 'IMAHUB_OUTPUT_DIR';
+const LEGACY_OUTPUT_DIR_ENV = 'IMACLAWHUB_OUTPUT_DIR';
+
+// 安装目录优先级：环境变量 > imahub set dir 配置 > ~/.openclaw/skills
+const outputDir =
+  process.env[OUTPUT_DIR_ENV] ||
+  process.env[LEGACY_OUTPUT_DIR_ENV] ||
+  getConfiguredOutputDir() ||
+  getOpenClawSkillsDir();
+
+function printUsage() {
+  console.error(`用法: ${CLI_NAME} install <技能名称或关键词>`);
+  console.error(`      ${CLI_NAME} check openclaw   # 检查是否已安装 openclaw`);
+  console.error(`      ${CLI_NAME} set dir <路径>   # 设定安装目录（已设置则直接安装到该目录）`);
+  console.error(`      ${CLI_NAME} set dir --clear # 清空已设定的安装目录`);
+  console.error(`      ${CLI_NAME} -v              # 查看版本号`);
+  console.error(`示例: ${CLI_NAME} install my-skill  或  ${CLI_NAME} install "AI 衣橱搭配"`);
+  console.error(
+    '安装目录: ' +
+      outputDir +
+      (isOpenClawInstalled()
+        ? ' (已检测到 openclaw)'
+        : ` (未检测到 openclaw，请先安装或 ${CLI_NAME} set dir <路径>)`)
+  );
+}
+
+const args = process.argv.slice(2);
+const arg0 = args[0];
+const arg1 = args[1];
+
+if (arg0 === 'version' || arg0 === '--version' || arg0 === '-v') {
+  console.log(CLI_VERSION);
+  process.exit(0);
+} else if (!arg0 || arg0 === 'help' || arg0 === '--help' || arg0 === '-h') {
+  printUsage();
+  process.exit(arg0 ? 0 : 1);
+} else 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 或使用 ${CLI_NAME} set dir <路径> 指定安装目录）`);
+  }
+  process.exit(installed ? 0 : 1);
+} else if (arg0 === 'set' && arg1 === 'dir') {
+  const dir = args.length > 2 ? args.slice(2).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);
+      });
+    // flow stops here (async)
+  } else if (!dir) {
+    console.error(`用法: ${CLI_NAME} set dir <安装目录路径>`);
+    console.error(`      ${CLI_NAME} set dir --clear   # 清空已设定的安装目录`);
+    console.error(`示例: ${CLI_NAME} set dir /path/to/skills  或  ${CLI_NAME} 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 {
+  // 主用法：imahub install "AI 衣橱搭配"，兼容旧写法：imahub "AI 衣橱搭配"
+  const skillArgs = arg0 === 'install' ? args.slice(1) : args;
+  const skillName = skillArgs.join(' ').trim();
+  if (!skillName) {
+    printUsage();
+    process.exit(1);
+  }
+
+  function run() {
+    const options = { outputDir };
+    ensureToDesktop(skillName, options)
+      .then((result) => {
+        if (result.ok) {
+          console.log('安装成功');
+        } else {
+          console.error('失败:', result.error);
+          process.exit(1);
+        }
+      })
+      .catch((err) => {
+        console.error(err.message || err);
+        process.exit(1);
+      });
+  }
+
+  (async () => {
+    const usingDefaultOpenClawDir =
+      !process.env[OUTPUT_DIR_ENV] &&
+      !process.env[LEGACY_OUTPUT_DIR_ENV] &&
+      !getConfiguredOutputDir();
+    if (usingDefaultOpenClawDir && !isOpenClawInstalled()) {
+      console.error(`未检测到 openclaw，请先安装 openclaw 或使用 ${CLI_NAME} set dir <路径> 指定安装目录。`);
+      process.exit(1);
+    }
+    const { list, error } = await ensureSkillList(skillName);
+    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();
+  })().catch((err) => {
+    console.error(err.message || err);
+    process.exit(1);
+  });
+}

package/index.js

@@ -0,0 +1,304 @@
+import { join } from 'path';
+import { homedir, platform } from 'os';
+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://qa-imahub.imaclaw.ai';
+const CONFIG_FILENAME = 'config.json';
+
+function normalizeListItem(item = {}) {
+  const skill = item.skill && typeof item.skill === 'object' ? item.skill : item;
+  const latestVersion =
+    (item.latestVersion && typeof item.latestVersion === 'object' && item.latestVersion) ||
+    (item.version && typeof item.version === 'object' && item.version) ||
+    (skill.latestVersion && typeof skill.latestVersion === 'object' && skill.latestVersion) ||
+    null;
+
+  return {
+    name: item.displayName || skill.displayName || item.name || skill.name || skill.slug || item.slug || '',
+    slug: skill.slug || item.slug || '',
+    version:
+      (typeof latestVersion?.version === 'string' && latestVersion.version.trim()) ||
+      (typeof item.version === 'string' && item.version.trim()) ||
+      '',
+    downloadUrl: item.downloadUrl || skill.downloadUrl || skill.url || item.url || '',
+    error: item.error || skill.error || '',
+  };
+}
+
+function normalizeDetailItem(data = {}, requestedSlug = '') {
+  const skill = data.skill && typeof data.skill === 'object' ? data.skill : {};
+  const latestVersion = data.latestVersion && typeof data.latestVersion === 'object' ? data.latestVersion : {};
+
+  return {
+    name: skill.displayName || data.displayName || requestedSlug,
+    slug: skill.slug || data.resolvedSlug || requestedSlug,
+    version: (typeof latestVersion.version === 'string' && latestVersion.version.trim()) || '',
+    downloadUrl: data.downloadUrl || '',
+    error: data.error || '',
+  };
+}
+
+async function trackSkillInstallEvent(item = {}, source = 'imahub-cli') {
+  const slug = String(item?.slug || '').trim();
+  if (!slug) return;
+
+  const baseUrl = DEFAULT_BASE_URL.replace(/\/$/, '');
+  const url = `${baseUrl}/api/v1/skills/track/install`;
+  const version = typeof item?.version === 'string' ? item.version.trim() : '';
+
+  try {
+    await fetch(url, {
+      method: 'POST',
+      headers: { 'content-type': 'application/json' },
+      body: JSON.stringify({
+        slug,
+        source,
+        ...(version ? { version } : {}),
+      }),
+    });
+  } catch {
+    // 埋点失败不影响安装主流程
+  }
+}
+
+function pickAutoDownloadItem(skillName, list = []) {
+  if (!Array.isArray(list) || list.length === 0) return null;
+  if (list.length === 1) return list[0];
+
+  const query = String(skillName || '').trim().toLowerCase();
+  if (!query) return null;
+
+  const exactMatches = list.filter((item) => {
+    const slug = String(item.slug || '').trim().toLowerCase();
+    const name = String(item.name || '').trim().toLowerCase();
+    return slug === query || name === query;
+  });
+  if (exactMatches.length === 1) return exactMatches[0];
+
+  return list[0];
+}
+
+/**
+ * 获取 openclaw 根目录（skills 的父目录）
+ * Mac / Linux: ~/.openclaw，Windows: %USERPROFILE%\.openclaw
+ * @returns {string}
+ */
+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;
+}
+
+/** imahub 配置目录：~/.imahub（兼容读取旧的 ~/.imaclawhub） */
+function getImahubConfigDir() {
+  const home = homedir();
+  if (platform() === 'win32') {
+    const base = process.env.USERPROFILE || home;
+    return join(base, '.imahub');
+  }
+  return join(home, '.imahub');
+}
+
+function getLegacyImaclawhubConfigDir() {
+  const home = homedir();
+  if (platform() === 'win32') {
+    const base = process.env.USERPROFILE || home;
+    return join(base, '.imaclawhub');
+  }
+  return join(home, '.imaclawhub');
+}
+
+/**
+ * 读取通过 imahub set dir 设置的安装目录，未设置则返回 null
+ * 优先读取 ~/.imahub/config.json，兼容回退 ~/.imaclawhub/config.json
+ * @returns {string | null}
+ */
+export function getConfiguredOutputDir() {
+  try {
+    const configPaths = [
+      join(getImahubConfigDir(), CONFIG_FILENAME),
+      join(getLegacyImaclawhubConfigDir(), CONFIG_FILENAME),
+    ];
+    for (const configPath of configPaths) {
+      if (!existsSync(configPath)) continue;
+      const raw = readFileSync(configPath, 'utf-8');
+      const data = JSON.parse(raw);
+      const dir = data?.outputDir;
+      if (typeof dir === 'string' && dir.trim()) {
+        return dir.trim();
+      }
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * 保存安装目录（供 imahub set dir 使用）
+ * @param {string} dir - 绝对或相对路径
+ * @returns {Promise<void>}
+ */
+export async function setConfiguredOutputDir(dir) {
+  const path = dir.trim();
+  if (!path) throw new Error('安装目录不能为空');
+  const configDir = getImahubConfigDir();
+  await mkdir(configDir, { recursive: true });
+  const configPath = join(configDir, CONFIG_FILENAME);
+  await writeFile(configPath, JSON.stringify({ outputDir: path }, null, 2), 'utf-8');
+}
+
+/**
+ * 清空已设置的安装目录（删除 ~/.imahub/config.json，并兼容清理旧的 ~/.imaclawhub/config.json）
+ * @returns {Promise<void>}
+ */
+export async function clearConfiguredOutputDir() {
+  const configPaths = [
+    join(getImahubConfigDir(), CONFIG_FILENAME),
+    join(getLegacyImaclawhubConfigDir(), CONFIG_FILENAME),
+  ];
+  for (const configPath of configPaths) {
+    if (existsSync(configPath)) {
+      await unlink(configPath);
+    }
+  }
+}
+
+/**
+ * 通过 slug 精准详情接口获取技能下载信息
+ * @param {string} skillName - 技能 slug
+ * @returns {Promise<{ list: Array<{ name: string, slug: string, version?: string, downloadUrl?: string, error?: string }>, error?: string }>}
+ */
+export async function ensureSkillList(skillName) {
+  const baseUrl = DEFAULT_BASE_URL.replace(/\/$/, '');
+  const slug = String(skillName).replace(/\s+/g, ' ').trim();
+  if (!slug) {
+    return { list: [], error: '缺少技能 slug' };
+  }
+
+  try {
+    const detailUrl = `${baseUrl}/api/v1/skills/${encodeURIComponent(slug)}`;
+    const res = await fetch(detailUrl);
+    const data = await res.json().catch(() => ({}));
+    if (res.ok) {
+      const item = normalizeDetailItem(data, slug);
+      if (item.slug && item.downloadUrl) {
+        return { list: [item] };
+      }
+    }
+  } catch {
+    // 详情接口异常时回退旧接口，避免完全不可用
+  }
+
+  const legacyUrl = `${baseUrl}/skills/ensure?name=${encodeURIComponent(slug)}`;
+  const legacyRes = await fetch(legacyUrl);
+  const legacyData = await legacyRes.json().catch(() => ({}));
+  if (!legacyRes.ok) {
+    return { list: [], error: legacyData.error || `HTTP ${legacyRes.status}` };
+  }
+  // 支持接口直接返回数组，或 { list } / { items }
+  const rawList = Array.isArray(legacyData) ? legacyData : (legacyData.list || legacyData.items || []);
+  return { list: rawList.map((item) => normalizeListItem(item)).filter((item) => item.slug || item.downloadUrl) };
+}
+
+/**
+ * 从 URL 下载 zip 并解压到指定目录
+ * @param {string} zipUrl - zip 下载地址
+ * @param {string} outDir - 解压目标目录
+ * @returns {Promise<{ ok: boolean, path?: string, error?: string }>}
+ */
+export async function downloadAndExtractZip(zipUrl, outDir) {
+  const res = await fetch(zipUrl, { redirect: 'follow' });
+  if (!res.ok) {
+    return { ok: false, error: `下载失败: HTTP ${res.status}` };
+  }
+  const buf = Buffer.from(await res.arrayBuffer());
+  const zip = new AdmZip(buf);
+  await mkdir(outDir, { recursive: true });
+  zip.extractAllTo(outDir, true);
+  return { ok: true, path: outDir };
+}
+
+/**
+ * 通过 ensure 接口获取技能列表，自动选择结果并下载解压到指定目录
+ * 默认解压到本机 openclaw 的 skills 目录（~/.openclaw/skills/<名称>）
+ * @param {string} skillName - 技能名称或关键词
+ * @param {{ outputDir?: string, subdir?: string, selectedIndex?: number, item?: { slug: string, name?: string, downloadUrl?: string } }} options
+ *   - outputDir: 解压目标父目录，默认 getOpenClawSkillsDir()（~/.openclaw/skills）
+ *   - subdir: 解压后的文件夹名，默认使用输入的名称（如「AI 衣橱搭配」），为空则用 slug
+ *   - selectedIndex: 兼容旧参数，传入时按指定序号下载
+ *   - item: 兼容旧参数，传入时直接使用该项下载
+ * @returns {Promise<{ ok: boolean, path?: string, slug?: string, list?: Array, error?: string }>}
+ */
+export async function ensureToDesktop(skillName, options = {}) {
+  // 每次安装都重新拉取列表
+  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: list.length ? '列表中暂无可用下载链接' : '未找到匹配的技能',
+      list,
+    };
+  }
+
+  let item = options.item;
+  if (!item && options.selectedIndex != null) {
+    const idx = Number(options.selectedIndex);
+    if (idx >= 0 && idx < downloadable.length) item = downloadable[idx];
+  }
+  if (!item) {
+    item = pickAutoDownloadItem(skillName, downloadable);
+  }
+
+  const downloadUrl = item.downloadUrl;
+  if (!downloadUrl) {
+    return { ok: false, error: item.error || '该项无下载链接', slug: item.slug };
+  }
+
+  const baseDir = options.outputDir ?? getOpenClawSkillsDir();
+  // 优先使用用户输入的名称作为文件夹名，如 imahub install 'AI 衣橱搭配' → 解压到 .../AI 衣橱搭配
+  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) {
+    return { ok: false, error: extractResult.error, slug: item.slug };
+  }
+  await trackSkillInstallEvent(item);
+  return { ok: true, path: extractResult.path, slug: item.slug };
+}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "imahub-test",
+  "version": "1.0.1",
+  "description": "Fetch skill from local ensure API and extract to Desktop",
+  "type": "module",
+  "main": "index.js",
+  "exports": {
+    ".": "./index.js"
+  },
+  "bin": {
+    "imahub": "cli.js",
+    "imaclawhub": "cli.js"
+  },
+  "files": [
+    "index.js",
+    "cli.js",
+    "README.md"
+  ],
+  "scripts": {
+    "dev": "node cli.js",
+    "start": "node cli.js",
+    "publish:test": "node scripts/publish.mjs test",
+    "publish:prod": "node scripts/publish.mjs prod"
+  },
+  "keywords": [
+    "clawhub",
+    "skills",
+    "imahub",
+    "imaclawhub"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "adm-zip": "^0.5.16"
+  }
+}