aisoulhub 1.0.0

package/.trae/specs/create-aisoulhub-cli/checklist.md

@@ -0,0 +1,9 @@
+# Checklist
+- [x] 运行 `npx aisoulhub` 可正确唤起 CLI 帮助信息。
+- [x] 若未安装 `openclaw`，执行命令时能正确提示并退出。
+- [x] 若未登录，执行命令时能正确提示输入邮箱，并保存至 `~/.aisoulhub.json`。
+- [x] 执行 `install` 命令时，能正确提供"创建新 agent"或"选择已有 agent"的交互选项。
+- [x] `install` 命令能够成功从远端下载指定 zip 包，并正确解压到目标 workspace 目录中（包含 `SOUL.md`、`AGENTS.md`、`IDENTITY.md`、`meta.json`）。
+- [x] `install` 命令能够正确读取 `meta.json` 并触发 skill 安装流程。
+- [x] 执行 `update` 命令时，能正确展示已有的 agent 列表供用户选择。
+- [x] `update` 命令能够正确完成下载、解压覆盖及 skill 更新流程。

package/.trae/specs/create-aisoulhub-cli/spec.md

@@ -0,0 +1,49 @@
+# aisoulhub CLI Spec
+
+## Why
+需要一个名为 `aisoulhub` 的 npx 包（CLI 工具），用于便捷地从 aisoulhub.com 下载、安装和更新 AI Soul 配置文件及配套的 skills，并无缝集成到 openclaw agent 的工作流中。
+
+## What Changes
+- 初始化 Node.js CLI 项目，包名为 `aisoulhub`。
+- 实现环境依赖检查：强制要求本地已安装 `openclaw`。
+- 实现用户简单的邮箱登录态管理（记录至 `~/.aisoulhub.json`）。
+- 实现 `npx aisoulhub install <ai_soul_id>` 命令：包含 Agent 选择/创建、文件下载、解压、覆盖 workspace 以及根据 `meta.json` 安装技能。
+- 实现 `npx aisoulhub update` 命令：包含待更新 Agent 的选择、配置文件下载及技能更新。
+
+## Impact
+- Affected specs: 提供了快速部署和更新 openclaw agent 的能力。
+- Affected code: 新增 `aisoulhub` CLI 的全套业务逻辑代码，包括依赖检查、网络请求、文件系统操作及外部命令调用。
+
+## ADDED Requirements
+### Requirement: 环境依赖检查
+系统必须在执行核心命令前检查是否安装了 `openclaw`。
+#### Scenario: 未安装 openclaw
+- **WHEN** 用户执行 `aisoulhub install` 或 `update`，且系统中找不到 `openclaw` 命令。
+- **THEN** 提示用户 "请按照 https://openclaw.ai 的指引安装 openclaw"，随后退出程序。
+
+### Requirement: 用户登录态管理
+系统必须在执行安装或更新前验证用户是否已提供邮箱。
+#### Scenario: 首次使用未登录
+- **WHEN** 用户执行 `aisoulhub install` 或 `update`，且 `~/.aisoulhub.json` 不存在或未包含邮箱信息。
+- **THEN** 提示用户输入邮箱，无需密码验证，将邮箱保存在 `~/.aisoulhub.json` 中并继续后续流程。
+
+### Requirement: Install 命令
+系统必须支持从远端下载指定的 AI Soul 包并部署到选定的 Agent。
+#### Scenario: 成功安装
+- **WHEN** 用户执行 `npx aisoulhub install <ai_soul_id>`。
+- **THEN**
+  1. 提示用户选择操作：创建新 agent (`openclaw agents add` 命令) 或 选择已有 agent (`openclaw agents list` 命令)。
+  2. 从 `https://aisoulhub.com/packages/<ai_soul_id>.zip` 下载对应包。
+  3. 将包解压到所选 agent 的 workspace 目录，释放出 `SOUL.md`、`AGENTS.md`、`IDENTITY.md`、`meta.json`。
+  4. 解析 `meta.json` 中的 skill 列表，遍历并执行对应 skill 的安装命令。
+
+### Requirement: Update 命令
+系统必须支持对已部署的 Agent 进行更新。
+#### Scenario: 成功更新
+- **WHEN** 用户执行 `npx aisoulhub update`。
+- **THEN**
+  1. 调用 `openclaw agents list` 获取 agent 列表，并提示用户选择需要更新的 agent。
+  2. 获取所选 agent 对应的 `<ai_soul_id>`（可能需要从本地 workspace 的 meta.json 中读取，或要求用户输入）。
+  3. 从远端下载对应的 zip 包。
+  4. 解压并覆盖文件（`SOUL.md`、`AGENTS.md`、`IDENTITY.md`、`meta.json`）。
+  5. 重新解析并执行 `meta.json` 中 skill 列表的安装或更新流程。

package/.trae/specs/create-aisoulhub-cli/tasks.md

@@ -0,0 +1,24 @@
+# Tasks
+- [x] Task 1: 项目初始化
+  - [x] SubTask 1.1: 初始化 package.json，配置 bin 字段，包名为 aisoulhub。
+  - [x] SubTask 1.2: 安装所需依赖项 (例如 axios, commander, inquirer/prompts, unzipper, shelljs 等)。
+- [x] Task 2: 实现前置检查模块
+  - [x] SubTask 2.1: 实现 `openclaw` 环境依赖检查逻辑。
+  - [x] SubTask 2.2: 实现读取/写入 `~/.aisoulhub.json` 的邮箱登录逻辑。
+- [x] Task 3: 实现工具类与核心业务逻辑
+  - [x] SubTask 3.1: 封装调用 `openclaw agents list` 和 `openclaw agents add` 的方法。
+  - [x] SubTask 3.2: 封装 zip 文件下载和解压方法。
+  - [x] SubTask 3.3: 封装读取解析 `meta.json` 并遍历执行 skill 安装的逻辑。
+- [x] Task 4: 实现 `install` 命令
+  - [x] SubTask 4.1: 解析 `<ai_soul_id>` 参数。
+  - [x] SubTask 4.2: 串联前置检查、Agent 选择/创建、文件下载解压及技能安装流程。
+- [x] Task 5: 实现 `update` 命令
+  - [x] SubTask 5.1: 串联前置检查、Agent 选择列表展示。
+  - [x] SubTask 5.2: 确定所选 Agent 对应的 ai_soul_id 并下载对应的 zip 包。
+  - [x] SubTask 5.3: 执行文件解压覆盖及技能更新覆盖流程。
+
+# Task Dependencies
+- [Task 2] depends on [Task 1]
+- [Task 3] depends on [Task 1]
+- [Task 4] depends on [Task 2, Task 3]
+- [Task 5] depends on [Task 2, Task 3]

package/README.md

@@ -0,0 +1,2 @@
+# install-tool
+

package/bin/aisoulhub.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+
+import { main } from '../src/index.js';
+
+main().catch(err => {
+  console.error(err);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "aisoulhub",
+  "version": "1.0.0",
+  "description": "",
+  "main": "index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "publish": "npm publish --access public"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "bin": {
+    "aisoulhub": "./bin/aisoulhub.js"
+  },
+  "type": "module",
+  "dependencies": {
+    "@inquirer/prompts": "^8.3.2",
+    "axios": "^1.13.6",
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "ora": "^9.3.0",
+    "shelljs": "^0.10.0",
+    "unzipper": "^0.12.3"
+  }
+}

package/src/commands/install.js

@@ -0,0 +1,91 @@
+import { checkOpenclaw, checkLogin } from '../utils/check.js';
+import { getAgents, addAgent } from '../utils/openclaw.js';
+import { downloadAndExtract } from '../utils/download.js';
+import { processMetaJson } from '../utils/meta.js';
+import { select, input } from '@inquirer/prompts';
+import chalk from 'chalk';
+import path from 'path';
+import os from 'os';
+
+export async function installCommand(aiSoulId) {
+  if (!aiSoulId) {
+    console.error(chalk.red('❌ 错误: 必须提供 ai_soul_id，例如: aisoulhub install <ai_soul_id>'));
+    process.exit(1);
+  }
+
+  // 1. 前置检查
+  checkOpenclaw();
+  await checkLogin();
+
+  // 2. 获取当前的 agents 列表
+  let agents = [];
+  try {
+    agents = getAgents();
+  } catch (err) {
+    console.error(chalk.yellow(`⚠️ 获取 agents 列表失败: ${err.message}`));
+  }
+
+  // 3. 提示用户选择或创建 Agent
+  const choices = [
+    { name: '✨ 创建新的 Agent', value: 'create_new' },
+    ...agents.map(a => ({ name: `📁 ${a.name} (${a.path})`, value: a.path }))
+  ];
+
+  const agentChoice = await select({
+    message: '请选择要安装的 Agent：',
+    choices
+  });
+
+  let targetPath = agentChoice;
+
+  if (agentChoice === 'create_new') {
+    const newAgentName = await input({
+      message: '请输入新 Agent 的名称：',
+      validate: (val) => val.trim().length > 0 ? true : 'Agent 名称不能为空'
+    });
+
+    const defaultWorkspace = path.join(os.homedir(), '.openclaw', `workspace-${newAgentName}`);
+    
+    const newWorkspacePath = await input({
+      message: '请输入新 Agent 的工作目录：',
+      default: defaultWorkspace,
+      validate: (val) => val.trim().length > 0 ? true : '工作目录不能为空'
+    });
+    
+    console.log(chalk.cyan(`🔄 正在创建 Agent [${newAgentName}]...`));
+    try {
+      addAgent(newAgentName, newWorkspacePath);
+      console.log(chalk.green(`✅ Agent [${newAgentName}] 创建成功。`));
+      
+      // 重新获取列表以获取新 agent 的路径
+      const updatedAgents = getAgents();
+      const newAgent = updatedAgents.find(a => a.name === newAgentName);
+      if (!newAgent || !newAgent.path) {
+        targetPath = newWorkspacePath;
+      } else {
+        targetPath = newAgent.path;
+      }
+    } catch (err) {
+      console.error(chalk.red(err.message));
+      process.exit(1);
+    }
+  }
+
+  if (!targetPath) {
+    console.error(chalk.red('❌ 错误: 无法确定 Agent 的工作目录路径。'));
+    process.exit(1);
+  }
+
+  console.log(chalk.blue(`ℹ️ 目标工作目录: ${targetPath}`));
+
+  // 4. 下载并解压 ZIP 文件
+  const downloadSuccess = await downloadAndExtract(aiSoulId, targetPath);
+  if (!downloadSuccess) {
+    process.exit(1);
+  }
+
+  // 5. 解析 meta.json 并安装技能
+  await processMetaJson(targetPath);
+
+  console.log(chalk.green(`🎉 成功将 ${aiSoulId} 安装到 Agent。`));
+}

package/src/commands/update.js

@@ -0,0 +1,76 @@
+import { checkOpenclaw, checkLogin } from '../utils/check.js';
+import { getAgents } from '../utils/openclaw.js';
+import { downloadAndExtract } from '../utils/download.js';
+import { processMetaJson } from '../utils/meta.js';
+import { select, input } from '@inquirer/prompts';
+import fs from 'fs';
+import path from 'path';
+import chalk from 'chalk';
+
+export async function updateCommand() {
+  // 1. 前置检查
+  checkOpenclaw();
+  await checkLogin();
+
+  // 2. 获取当前的 agents 列表
+  let agents = [];
+  try {
+    agents = getAgents();
+  } catch (err) {
+    console.error(chalk.red(`❌ 获取 agents 列表失败: ${err.message}`));
+    process.exit(1);
+  }
+
+  if (agents.length === 0) {
+    console.error(chalk.yellow('⚠️ 当前没有可更新的 Agent。请先使用 install 命令安装。'));
+    process.exit(1);
+  }
+
+  // 3. 提示用户选择 Agent
+  const choices = agents.map(a => ({ name: `📁 ${a.name} (${a.path})`, value: a.path }));
+
+  const targetPath = await select({
+    message: '请选择要更新的 Agent：',
+    choices
+  });
+
+  if (!targetPath || !fs.existsSync(targetPath)) {
+    console.error(chalk.red('❌ 错误: 无效的 Agent 工作目录。'));
+    process.exit(1);
+  }
+
+  // 4. 确定 ai_soul_id
+  let aiSoulId = null;
+  const metaPath = path.join(targetPath, 'meta.json');
+  if (fs.existsSync(metaPath)) {
+    try {
+      const content = fs.readFileSync(metaPath, 'utf-8');
+      const meta = JSON.parse(content);
+      if (meta.ai_soul_id) {
+        aiSoulId = meta.ai_soul_id;
+        console.log(chalk.blue(`ℹ️ 从 meta.json 中检测到 ai_soul_id: ${aiSoulId}`));
+      }
+    } catch (e) {
+      console.warn(chalk.yellow('⚠️ 无法解析 meta.json。'));
+    }
+  }
+
+  if (!aiSoulId) {
+    console.log(chalk.yellow('ℹ️ 未能从当前 Agent 的 meta.json 中获取 ai_soul_id。'));
+    aiSoulId = await input({
+      message: '请输入需要更新的 ai_soul_id：',
+      validate: (val) => val.trim().length > 0 ? true : 'ai_soul_id 不能为空'
+    });
+  }
+
+  // 5. 下载并解压 ZIP 文件 (覆盖)
+  const downloadSuccess = await downloadAndExtract(aiSoulId, targetPath);
+  if (!downloadSuccess) {
+    process.exit(1);
+  }
+
+  // 6. 解析 meta.json 并更新技能
+  await processMetaJson(targetPath);
+
+  console.log(chalk.green(`🎉 成功更新 Agent [${aiSoulId}]。`));
+}

package/src/index.js

@@ -0,0 +1,38 @@
+import { Command } from 'commander';
+import { installCommand } from './commands/install.js';
+import { updateCommand } from './commands/update.js';
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+export async function main() {
+  const pkgPath = path.join(__dirname, '../package.json');
+  const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+
+  const program = new Command();
+
+  program
+    .name('aisoulhub')
+    .description('AISoulHub CLI 命令行工具，用于安装和更新 Agent 技能与配置')
+    .version(pkg.version);
+
+  program
+    .command('install')
+    .description('安装新的 Agent 配置及技能')
+    .argument('<ai_soul_id>', '指定要安装的 ai_soul_id (例如：12345)')
+    .action(async (aiSoulId) => {
+      await installCommand(aiSoulId);
+    });
+
+  program
+    .command('update')
+    .description('更新已存在的 Agent 配置及技能')
+    .action(async () => {
+      await updateCommand();
+    });
+
+  program.parseAsync(process.argv);
+}

package/src/utils/check.js

@@ -0,0 +1,53 @@
+import shell from 'shelljs';
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import chalk from 'chalk';
+import { input } from '@inquirer/prompts';
+
+export function checkOpenclaw() {
+  if (!shell.which('openclaw')) {
+    console.error(chalk.red('❌ 错误: 未找到 openclaw 命令。请按照 https://openclaw.ai 的指引安装 openclaw，然后重试。'));
+    process.exit(1);
+  }
+}
+
+const CONFIG_PATH = path.join(os.homedir(), '.aisoulhub.json');
+
+export async function checkLogin() {
+  let config = {};
+  if (fs.existsSync(CONFIG_PATH)) {
+    try {
+      const content = fs.readFileSync(CONFIG_PATH, 'utf-8');
+      config = JSON.parse(content);
+    } catch (e) {
+      // ignore parse error
+    }
+  }
+
+  if (!config.email) {
+    console.log(chalk.yellow('ℹ️ 未检测到登录信息，请输入您的邮箱进行登录：'));
+    const email = await input({ 
+      message: '请输入您的邮箱地址:',
+      validate: (value) => {
+        const pass = value.match(/^[^\s@]+@[^\s@]+\.[^\s@]+$/);
+        if (pass) {
+          return true;
+        }
+        return '请输入有效的邮箱地址';
+      }
+    });
+
+    config.email = email;
+    try {
+      fs.writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2), 'utf-8');
+      console.log(chalk.green(`✅ 登录成功！邮箱: ${email} 已保存。`));
+    } catch (e) {
+      console.log(chalk.yellow(`⚠️ 登录成功，但无法保存到 ${CONFIG_PATH}: ${e.message}`));
+    }
+  } else {
+    console.log(chalk.blue(`ℹ️ 当前登录邮箱: ${config.email}`));
+  }
+  
+  return config.email;
+}

package/src/utils/download.js

@@ -0,0 +1,57 @@
+import axios from 'axios';
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import unzipper from 'unzipper';
+import ora from 'ora';
+import chalk from 'chalk';
+
+export async function downloadAndExtract(aiSoulId, targetPath) {
+  const url = `https://aisoulhub.com/packages/${aiSoulId}.zip`;
+  const tempDir = os.tmpdir();
+  const zipPath = path.join(tempDir, `${aiSoulId}.zip`);
+
+  const spinner = ora(`正在下载包 ${aiSoulId}...`).start();
+
+  try {
+    const response = await axios({
+      method: 'GET',
+      url,
+      responseType: 'stream',
+      // Provide a mock user-agent just in case
+      headers: { 'User-Agent': 'aisoulhub-cli/1.0.0' }
+    });
+
+    const writer = fs.createWriteStream(zipPath);
+    response.data.pipe(writer);
+
+    await new Promise((resolve, reject) => {
+      writer.on('finish', resolve);
+      writer.on('error', reject);
+    });
+
+    spinner.text = `下载完成，正在解压...`;
+
+    // Ensure target path exists
+    if (!fs.existsSync(targetPath)) {
+      fs.mkdirSync(targetPath, { recursive: true });
+    }
+
+    // Unzip
+    await fs.createReadStream(zipPath)
+      .pipe(unzipper.Extract({ path: targetPath }))
+      .promise();
+
+    spinner.succeed(chalk.green(`包 ${aiSoulId} 下载并解压成功！`));
+
+    // Cleanup temp zip
+    fs.unlinkSync(zipPath);
+    return true;
+  } catch (err) {
+    spinner.fail(chalk.red(`下载或解压失败: ${err.message}`));
+    if (fs.existsSync(zipPath)) {
+      fs.unlinkSync(zipPath);
+    }
+    return false;
+  }
+}

package/src/utils/meta.js

@@ -0,0 +1,37 @@
+import fs from 'fs';
+import path from 'path';
+import chalk from 'chalk';
+import { installSkill } from './openclaw.js';
+
+export async function processMetaJson(workspacePath) {
+  const metaPath = path.join(workspacePath, 'meta.json');
+  if (!fs.existsSync(metaPath)) {
+    console.log(chalk.yellow(`ℹ️ 未找到 meta.json，跳过技能安装。(${metaPath})`));
+    return;
+  }
+
+  try {
+    const content = fs.readFileSync(metaPath, 'utf-8');
+    const meta = JSON.parse(content);
+    const skills = meta.skills || [];
+    
+    if (skills.length === 0) {
+      console.log(chalk.blue('ℹ️ meta.json 中没有定义需要安装的技能。'));
+      return;
+    }
+
+    console.log(chalk.cyan(`🔄 开始安装 ${skills.length} 个技能...`));
+    for (const skill of skills) {
+      console.log(chalk.blue(`⏳ 正在安装技能: ${skill}...`));
+      const success = installSkill(workspacePath, skill);
+      if (success) {
+        console.log(chalk.green(`✅ 技能 ${skill} 安装成功。`));
+      } else {
+        console.log(chalk.red(`❌ 技能 ${skill} 安装失败。`));
+      }
+    }
+    console.log(chalk.green('🎉 所有技能安装流程结束。'));
+  } catch (err) {
+    console.error(chalk.red(`❌ 读取或解析 meta.json 失败: ${err.message}`));
+  }
+}

package/src/utils/openclaw.js

@@ -0,0 +1,65 @@
+import shell from 'shelljs';
+
+export function getAgents() {
+  const result = shell.exec('openclaw agents list --json', { silent: true });
+  if (result.code !== 0) {
+    throw new Error('获取 agents 列表失败: ' + result.stderr);
+  }
+  
+  // Try to parse JSON first
+  try {
+    const list = JSON.parse(result.stdout);
+    if (Array.isArray(list)) {
+      return list.map(item => ({
+        name: item.id || item.name,
+        path: item.workspace || item.path || item.agentDir
+      }));
+    }
+  } catch (err) {
+    // Not JSON, parse text
+  }
+
+  // Fallback text parsing
+  const lines = result.stdout.split('\n');
+  const agents = [];
+  
+  // Regex to match agent name and path. E.g., "- agent1 (/path/to/agent1)" or "agent1: /path/to/agent1"
+  // Let's just do a generic parsing or return raw lines if we can't be sure.
+  for (const line of lines) {
+    const match = line.match(/(?:-\s+)?(\w+)(?:\s+\((.*?)\)|:\s+(.*))?/);
+    if (match && match[1] && match[1] !== 'Agents') {
+      const name = match[1].trim();
+      const pathStr = (match[2] || match[3] || '').trim();
+      if (name) {
+        agents.push({ name, path: pathStr || null });
+      }
+    }
+  }
+  return agents;
+}
+
+export function addAgent(name, workspacePath) {
+  let cmd = `openclaw agents add "${name}"`;
+  if (workspacePath) {
+    cmd += ` --non-interactive --workspace "${workspacePath}"`;
+  }
+  const result = shell.exec(cmd, { silent: true });
+  if (result.code !== 0) {
+    throw new Error(`创建 agent [${name}] 失败: ` + result.stderr);
+  }
+  return result.stdout;
+}
+
+export function installSkill(workspacePath, skillStr) {
+  // Try `openclaw mcp install` or similar
+  const result = shell.exec(`openclaw mcp add ${skillStr}`, { cwd: workspacePath, silent: true });
+  if (result.code !== 0) {
+    // fallback
+    const fallback = shell.exec(`openclaw skills add ${skillStr}`, { cwd: workspacePath, silent: true });
+    if (fallback.code !== 0) {
+      console.error(`安装技能 ${skillStr} 失败: `, fallback.stderr || result.stderr);
+      return false;
+    }
+  }
+  return true;
+}