imaclawhub 1.0.0

package/README.md

@@ -0,0 +1,97 @@
+# imaclawhub
+
+通过 ensure 服务获取技能压缩包并解压到本地。默认解压到**与执行命令所在目录平级**的文件夹（即当前目录的上一级下的 `<slug>`）。
+
+## 前置条件
+
+- 默认使用 ensure 服务 `https://imahub.imaclaw.ai`（暴露 `/skills/ensure` 接口）。也可通过环境变量 `IMACLAWHUB_BASE_URL` 或 API 选项指定其他地址。
+
+## 安装
+
+```bash
+npm install imaclawhub
+```
+
+## 安装库之后，如何用它「安装技能」
+
+安装好 `imaclawhub` 后，用下面任一方式把某个技能拉到本地并解压（默认解压到与当前目录平级的 `<slug>` 文件夹）。
+
+### 方式一：命令行（推荐）
+
+在项目目录或任意目录执行：
+
+```bash
+# 把 <技能名称或slug> 对应的技能解压到当前目录平级
+npx imaclawhub <技能名称或slug>
+```
+
+示例：
+
+```bash
+npx imaclawhub my-skill
+```
+
+若已全局安装（`npm install -g imaclawhub`），可直接：
+
+```bash
+imaclawhub my-skill
+```
+
+指定 ensure 服务地址（环境变量）：
+
+```bash
+IMACLAWHUB_BASE_URL=https://其他地址 npx imaclawhub my-skill
+```
+
+执行成功后，技能会解压到**与当前目录平级**的、以该技能 slug 命名的文件夹（例如在 `~/projects/my-app` 下执行则解压到 `~/projects/my-skill`）。
+
+### 方式二：在代码里调用
+
+```javascript
+import { ensureToDesktop } from 'imaclawhub';
+
+const result = await ensureToDesktop('my-skill');
+if (result.ok) {
+  console.log('已解压到:', result.path);  // 如 /Users/你/projects/my-skill（与当前目录平级）
+} else {
+  console.error('失败:', result.error);
+}
+```
+
+## 使用说明（详细）
+
+### 作为库使用
+
+```javascript
+import { ensureToDesktop, ensureSkill, getDesktopPath } from 'imaclawhub';
+
+// 一键：调用 ensure 并解压（默认解压到与当前目录平级）
+const result = await ensureToDesktop('my-skill');
+if (result.ok) {
+  console.log('解压路径:', result.path);
+} else {
+  console.error(result.error);
+}
+
+// 解压到桌面：传入 outputDir 为桌面路径
+const result2 = await ensureToDesktop('my-skill', { outputDir: getDesktopPath() });
+
+// 仅调用 ensure 获取信息（含 downloadUrl）
+const info = await ensureSkill('my-skill', { baseUrl: 'https://imahub.imaclaw.ai' });
+```
+
+选项：
+
+- `ensureToDesktop(skillName, options)`
+  - `options.baseUrl`: ensure 服务地址，默认 `https://imahub.imaclaw.ai`
+  - `options.outputDir`: 解压目标父目录，默认与当前目录平级（`process.cwd()` 的上一级）
+  - `options.subdir`: 解压后的文件夹名，默认使用接口返回的 `slug`
+
+## 发布到 npm
+
+```bash
+npm login
+npm publish
+```
+
+如需发布为 scoped 包（如 `@your-org/imaclawhub`），在 `package.json` 中把 `name` 改为 `@your-org/imaclawhub` 后执行 `npm publish --access public`。

package/cli.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+
+import { ensureToDesktop } from './index.js';
+
+const skillName = process.argv[2];
+if (!skillName) {
+  console.error('用法: imaclawhub <技能名称或slug>');
+  console.error('示例: imaclawhub my-skill');
+  process.exit(1);
+}
+
+const baseUrl = process.env.IMACLAWHUB_BASE_URL || 'https://imahub.imaclaw.ai';
+
+ensureToDesktop(skillName, { baseUrl })
+  .then((result) => {
+    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);
+  });

package/index.js

@@ -0,0 +1,105 @@
+import { join } from 'path';
+import { homedir, platform } from 'os';
+import { mkdir } from 'fs/promises';
+import { cwd } from 'process';
+import AdmZip from 'adm-zip';
+
+const DEFAULT_BASE_URL = 'https://imahub.imaclaw.ai';
+/**
+ * 获取桌面目录路径（跨平台）
+ * @returns {string}
+ */
+export function getDesktopPath() {
+  const home = homedir();
+  if (platform() === 'win32') {
+    return process.env.USERPROFILE ? join(process.env.USERPROFILE, 'Desktop') : join(home, 'Desktop');
+  }
+  return join(home, 'Desktop');
+}
+
+/**
+ * 调用 ensure 接口获取技能信息（含下载 URL）
+ * @param {string} skillName - 技能名称或 slug
+ * @param {{ baseUrl?: string }} options
+ * @returns {Promise<{ found: boolean, downloadUrl?: string, slug?: string, name?: string, error?: string }>}
+ */
+export async function ensureSkill(skillName, options = {}) {
+  const baseUrl = (options.baseUrl || DEFAULT_BASE_URL).replace(/\/$/, '');
+  const name = String(skillName).trim();
+  if (!name) {
+    return { found: false, 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 data;
+}
+
+/**
+ * 从 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 接口获取技能 zip URL，下载并解压到指定目录
+ * 默认解压到「执行命令所在目录」的平级目录（即上级目录下的 <slug> 文件夹）
+ * @param {string} skillName - 技能名称或 slug
+ * @param {{ baseUrl?: string, outputDir?: string, subdir?: string }} options
+ *   - baseUrl: ensure 服务地址，默认 https://imahub.imaclaw.ai
+ *   - outputDir: 解压目标父目录，默认 process.cwd() 的上一级（与当前目录平级）
+ *   - subdir: 解压后的文件夹名，默认使用 slug
+ * @returns {Promise<{ ok: boolean, path?: string, slug?: string, error?: string }>}
+ */
+export async function ensureToDesktop(skillName, options = {}) {
+  const baseUrl = options.baseUrl || DEFAULT_BASE_URL;
+  const ensureResult = await ensureSkill(skillName, { baseUrl });
+  if (!ensureResult.found || ensureResult.error) {
+    return {
+      ok: false,
+      error: ensureResult.error || '未找到该技能',
+    };
+  }
+  const downloadUrl = ensureResult.downloadUrl;
+  if (!downloadUrl) {
+    return {
+      ok: false,
+      error: 'ensure 接口未返回 downloadUrl',
+    };
+  }
+  // 默认：与执行命令的目录平级（上级目录下的 <slug>）
+  const baseDir = options.outputDir ?? join(cwd(), '..');
+  const subdir = options.subdir ?? options.desktopSubdir ?? ensureResult.slug ?? skillName.trim();
+  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: true,
+    path: extractResult.path,
+    slug: ensureResult.slug,
+  };
+}

package/package.json

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