istarshine 1.0.0 → 1.0.2

package/bin/cli.js

@@ -9,20 +9,21 @@ import { Command } from 'commander';
 import { install_skill } from '../lib/install.js';
 import { search_skills } from '../lib/search.js';
 import { list_skills } from '../lib/list.js';
+import { find_skills } from '../lib/find.js';
 
 const program = new Command();
 
 program
   .name('istarshine')
   .description('iStarshine Skills Hub CLI - 一键安装和管理 Skills')
-  .version('1.0.0');
+  .version('1.0.2');
 
 // install 子命令
 program
   .command('install <skill-name>')
   .description('安装指定名称的 Skill 到当前项目')
   .option('-d, --dir <path>', '安装目标目录', '.kiro/skills')
-  .option('--server <url>', 'Skills Hub 服务器地址', 'https://xgzn.istarshine.com')
+  .option('--server <url>', 'Skills Hub 服务器地址', 'https://skills.istarshine.com')
   .action(async (skill_name, options) => {
     await install_skill(skill_name, options);
   });
@@ -31,7 +32,7 @@ program
 program
   .command('search <keyword>')
   .description('搜索 Skills Hub 中的 Skill')
-  .option('--server <url>', 'Skills Hub 服务器地址', 'https://xgzn.istarshine.com')
+  .option('--server <url>', 'Skills Hub 服务器地址', 'https://skills.istarshine.com')
   .action(async (keyword, options) => {
     await search_skills(keyword, options);
   });
@@ -40,9 +41,19 @@ program
 program
   .command('list')
   .description('列出热门 Skills')
-  .option('--server <url>', 'Skills Hub 服务器地址', 'https://xgzn.istarshine.com')
+  .option('--server <url>', 'Skills Hub 服务器地址', 'https://skills.istarshine.com')
   .action(async (options) => {
     await list_skills(options);
   });
 
+// find 子命令
+program
+  .command('find [keyword]')
+  .description('搜索 Skills Hub 中的 Skill，不带关键词时浏览热门')
+  .option('--server <url>', 'Skills Hub 服务器地址', 'https://skills.istarshine.com')
+  .option('--install', '搜索后进入快速安装模式', false)
+  .action(async (keyword, options) => {
+    await find_skills(keyword, options);
+  });
+
 program.parse();

package/lib/find.js

@@ -0,0 +1,136 @@
+/**
+ * find 命令实现
+ * 搜索 Skills Hub 中的 Skill，支持关键词搜索和热门浏览
+ */
+
+import { createInterface } from 'readline';
+import { fetch_json } from './api.js';
+import { format_skill_list } from './format.js';
+import { install_skill } from './install.js';
+
+/**
+ * 执行 find 命令
+ * @param {string|undefined} keyword - 搜索关键词，为空时进入热门浏览模式
+ * @param {object} options - 命令行选项
+ * @param {string} options.server - Skills Hub 服务器地址
+ * @param {boolean} options.install - 是否启用快速安装模式
+ */
+export async function find_skills(keyword, options) {
+  const { server = 'https://skills.istarshine.com' } = options;
+  const chalk = (await import('chalk')).default;
+  const ora = (await import('ora')).default;
+
+  if (keyword) {
+    // 关键词搜索模式
+    const spinner = ora(`正在搜索: ${keyword}`).start();
+
+    try {
+      const url = `${server}/api/skills/search?keyword=${encodeURIComponent(keyword)}`;
+      const results = await fetch_json(url);
+
+      if (!results || results.length === 0) {
+        spinner.info(chalk.yellow(`未找到与 "${keyword}" 相关的 Skill，请尝试其他关键词`));
+        return;
+      }
+
+      spinner.succeed(chalk.green(`找到 ${results.length} 个结果:\n`));
+
+      // 使用共享格式化函数输出结果列表
+      await format_skill_list(results);
+
+      // --install 模式：提示用户选择安装
+      if (options.install) {
+        await prompt_install(results, options, chalk);
+      } else {
+        console.log(chalk.gray(`\n安装命令: npx istarshine install <skill-name>`));
+      }
+
+    } catch (err) {
+      spinner.fail(chalk.red(`搜索失败: ${err.message}`));
+      process.exit(1);
+    }
+  } else {
+    // 热门浏览模式
+    const spinner = ora('正在获取热门 Skills...').start();
+
+    try {
+      const url = `${server}/api/skills/popular`;
+      const results = await fetch_json(url);
+
+      if (!results || results.length === 0) {
+        spinner.info(chalk.yellow('暂无热门 Skill'));
+        return;
+      }
+
+      spinner.succeed(chalk.green(`热门 Skills:\n`));
+
+      // 使用共享格式化函数输出热门列表（含排名序号）
+      await format_skill_list(results, { show_rank: true });
+
+      // --install 模式：提示用户选择安装
+      if (options.install) {
+        await prompt_install(results, options, chalk);
+      } else {
+        console.log(chalk.gray(`\n安装命令: npx istarshine install <skill-name>`));
+      }
+
+    } catch (err) {
+      spinner.fail(chalk.red(`获取列表失败: ${err.message}`));
+      process.exit(1);
+    }
+  }
+}
+
+/**
+ * 交互式安装提示
+ * 提示用户输入要安装的 Skill 名称，验证后调用 install_skill 执行安装
+ * @param {Array} results - 搜索结果列表
+ * @param {object} options - 命令行选项
+ * @param {object} chalk - chalk 实例
+ */
+async function prompt_install(results, options, chalk) {
+  // 构建有效名称集合，用于快速验证
+  const valid_names = new Set(results.map(s => s.name));
+
+  const rl = createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+
+  return new Promise((resolve) => {
+    // Ctrl+C 时取消安装，正常退出
+    rl.on('close', () => {
+      console.log(chalk.gray('\n已取消安装'));
+      resolve();
+    });
+
+    const ask = () => {
+      rl.question(chalk.cyan('\n输入要安装的 Skill 名称（留空取消）: '), async (answer) => {
+        const name = answer.trim();
+
+        // 输入空值时取消安装
+        if (!name) {
+          rl.close();
+          return;
+        }
+
+        // 验证名称是否在搜索结果中
+        if (!valid_names.has(name)) {
+          console.log(chalk.red(`"${name}" 不在搜索结果中，请输入正确的 Skill 名称`));
+          ask();
+          return;
+        }
+
+        // 名称有效，关闭 readline 并执行安装
+        rl.close();
+        await install_skill(name, {
+          dir: '.kiro/skills',
+          server: options.server,
+        });
+        resolve();
+      });
+    };
+
+    ask();
+  });
+}

package/lib/format.js

@@ -0,0 +1,33 @@
+/**
+ * 共享格式化模块
+ * 提供统一的 skill 列表格式化输出函数
+ */
+
+/**
+ * 格式化并输出 skill 列表
+ * @param {Array} skills - skill 对象数组
+ * @param {object} options - 格式化选项
+ * @param {boolean} options.show_rank - 是否显示排名序号
+ * @returns {void} 直接输出到 console
+ */
+export async function format_skill_list(skills, options = {}) {
+  const chalk = (await import('chalk')).default;
+  const { show_rank = false } = options;
+
+  skills.forEach((skill, index) => {
+    // 格式化各字段，缺失时使用默认值
+    const name = chalk.cyan(skill.name);
+    const version = chalk.gray(`v${skill.version || '?'}`);
+    const downloads = chalk.gray(`↓${skill.downloads || 0}`);
+    const likes = chalk.gray(`♥${skill.likes || 0}`);
+    const display = skill.display_name ? chalk.white(` - ${skill.display_name}`) : '';
+
+    // 根据 show_rank 选项决定是否显示排名序号
+    if (show_rank) {
+      const rank = chalk.gray(`${index + 1}.`);
+      console.log(`  ${rank} ${name} ${version} ${downloads} ${likes}${display}`);
+    } else {
+      console.log(`  ${name} ${version} ${downloads} ${likes}${display}`);
+    }
+  });
+}

package/lib/list.js

@@ -4,6 +4,7 @@
  */
 
 import { fetch_json } from './api.js';
+import { format_skill_list } from './format.js';
 
 /**
  * 列出热门 skills
@@ -27,15 +28,8 @@ export async function list_skills(options) {
 
     spinner.succeed(chalk.green(`热门 Skills:\n`));
 
-    results.forEach((skill, index) => {
-      const rank = chalk.gray(`${index + 1}.`);
-      const name = chalk.cyan(skill.name);
-      const version = chalk.gray(`v${skill.version || '?'}`);
-      const downloads = chalk.gray(`↓${skill.downloads || 0}`);
-      const likes = chalk.gray(`♥${skill.likes || 0}`);
-      const display = skill.display_name ? chalk.white(` - ${skill.display_name}`) : '';
-      console.log(`  ${rank} ${name} ${version} ${downloads} ${likes}${display}`);
-    });
+    // 使用共享格式化函数输出热门列表（含排名序号）
+    await format_skill_list(results, { show_rank: true });
 
     console.log(chalk.gray(`\n安装命令: npx istarshine install <skill-name>`));
 

package/lib/search.js

@@ -4,6 +4,7 @@
  */
 
 import { fetch_json } from './api.js';
+import { format_skill_list } from './format.js';
 
 /**
  * 搜索并展示 skill 列表
@@ -28,14 +29,8 @@ export async function search_skills(keyword, options) {
 
     spinner.succeed(chalk.green(`找到 ${results.length} 个结果:\n`));
 
-    results.forEach(skill => {
-      const name = chalk.cyan(skill.name);
-      const version = chalk.gray(`v${skill.version || '?'}`);
-      const downloads = chalk.gray(`↓${skill.downloads || 0}`);
-      const likes = chalk.gray(`♥${skill.likes || 0}`);
-      const display = skill.display_name ? chalk.white(` - ${skill.display_name}`) : '';
-      console.log(`  ${name} ${version} ${downloads} ${likes}${display}`);
-    });
+    // 使用共享格式化函数输出结果列表
+    await format_skill_list(results);
 
     console.log(chalk.gray(`\n安装命令: npx istarshine install <skill-name>`));
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "istarshine",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "iStarshine Skills Hub CLI - 一键安装和管理 Skills",
   "type": "module",
   "main": "index.js",