istarshine 1.0.0

package/README.md

@@ -0,0 +1,39 @@
+# istarshine
+
+iStarshine Skills Hub CLI - 一键安装和管理 Agent Skills。
+
+## 用法
+
+```bash
+# 安装 skill 到当前项目
+npx istarshine install <skill-name>
+
+# 搜索 skill
+npx istarshine search <keyword>
+
+# 查看热门 skills
+npx istarshine list
+```
+
+## 选项
+
+```bash
+# 指定安装目录（默认 .kiro/skills）
+npx istarshine install my-skill --dir ./custom/path
+
+# 指定服务器地址
+npx istarshine install my-skill --server https://your-server.com
+```
+
+## 示例
+
+```bash
+# 安装一个搜索相关的 skill
+npx istarshine install web-search
+
+# 搜索所有包含 "search" 的 skill
+npx istarshine search search
+
+# 列出热门 skills
+npx istarshine list
+```

package/bin/cli.js

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+
+/**
+ * istarshine CLI 入口文件
+ * 用法: npx istarshine install <skill-name>
+ */
+
+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';
+
+const program = new Command();
+
+program
+  .name('istarshine')
+  .description('iStarshine Skills Hub CLI - 一键安装和管理 Skills')
+  .version('1.0.0');
+
+// install 子命令
+program
+  .command('install <skill-name>')
+  .description('安装指定名称的 Skill 到当前项目')
+  .option('-d, --dir <path>', '安装目标目录', '.kiro/skills')
+  .option('--server <url>', 'Skills Hub 服务器地址', 'https://xgzn.istarshine.com')
+  .action(async (skill_name, options) => {
+    await install_skill(skill_name, options);
+  });
+
+// search 子命令
+program
+  .command('search <keyword>')
+  .description('搜索 Skills Hub 中的 Skill')
+  .option('--server <url>', 'Skills Hub 服务器地址', 'https://xgzn.istarshine.com')
+  .action(async (keyword, options) => {
+    await search_skills(keyword, options);
+  });
+
+// list 子命令
+program
+  .command('list')
+  .description('列出热门 Skills')
+  .option('--server <url>', 'Skills Hub 服务器地址', 'https://xgzn.istarshine.com')
+  .action(async (options) => {
+    await list_skills(options);
+  });
+
+program.parse();

package/lib/api.js

@@ -0,0 +1,71 @@
+/**
+ * API 请求封装模块
+ * 负责与 Skills Hub 后端通信
+ */
+
+import { request } from 'https';
+import { request as http_request } from 'http';
+
+/**
+ * 发送 GET 请求，返回 JSON
+ * @param {string} url - 完整请求 URL
+ * @returns {Promise<object>} 解析后的 JSON 对象
+ */
+export function fetch_json(url) {
+  return new Promise((resolve, reject) => {
+    const is_https = url.startsWith('https');
+    const do_request = is_https ? request : http_request;
+
+    do_request(url, (res) => {
+      // 处理重定向
+      if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+        return fetch_json(res.headers.location).then(resolve).catch(reject);
+      }
+
+      if (res.statusCode !== 200) {
+        reject(new Error(`请求失败，状态码: ${res.statusCode}`));
+        return;
+      }
+
+      let data = '';
+      res.on('data', (chunk) => { data += chunk; });
+      res.on('end', () => {
+        try {
+          resolve(JSON.parse(data));
+        } catch (e) {
+          reject(new Error('响应解析失败: ' + e.message));
+        }
+      });
+    }).on('error', reject).end();
+  });
+}
+
+/**
+ * 下载二进制文件，返回 Buffer
+ * @param {string} url - 完整请求 URL
+ * @returns {Promise<Buffer>} 文件二进制数据
+ */
+export function download_file(url) {
+  return new Promise((resolve, reject) => {
+    const is_https = url.startsWith('https');
+    const do_request = is_https ? request : http_request;
+
+    do_request(url, (res) => {
+      // 处理重定向
+      if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+        return download_file(res.headers.location).then(resolve).catch(reject);
+      }
+
+      if (res.statusCode !== 200) {
+        reject(new Error(`下载失败，状态码: ${res.statusCode}`));
+        return;
+      }
+
+      const chunks = [];
+      res.on('data', (chunk) => { chunks.push(chunk); });
+      res.on('end', () => {
+        resolve(Buffer.concat(chunks));
+      });
+    }).on('error', reject).end();
+  });
+}

package/lib/install.js

@@ -0,0 +1,65 @@
+/**
+ * install 命令实现
+ * 根据 skill 名称搜索、下载 zip 并解压到本地目录
+ */
+
+import { fetch_json, download_file } from './api.js';
+import { createWriteStream, mkdirSync, existsSync } from 'fs';
+import { join, resolve } from 'path';
+import { extract_zip } from './zip.js';
+
+/**
+ * 安装指定名称的 skill
+ * 流程: 按名称搜索 -> 找到精确匹配 -> 下载 zip -> 解压到目标目录
+ * @param {string} skill_name - skill 名称
+ * @param {object} options - 命令行选项 { dir, server }
+ */
+export async function install_skill(skill_name, options) {
+  const { dir, server } = options;
+  // 动态导入 chalk 和 ora（ESM 模块）
+  const chalk = (await import('chalk')).default;
+  const ora = (await import('ora')).default;
+
+  const spinner = ora(`正在搜索 Skill: ${skill_name}`).start();
+
+  try {
+    // 1. 按名称搜索 skill
+    const search_url = `${server}/api/skills/search?keyword=${encodeURIComponent(skill_name)}`;
+    const results = await fetch_json(search_url);
+
+    // 精确匹配名称
+    const skill = results.find(s => s.name === skill_name);
+    if (!skill) {
+      spinner.fail(chalk.red(`未找到名为 "${skill_name}" 的 Skill`));
+      if (results.length > 0) {
+        console.log(chalk.yellow('\n你是不是想找:'));
+        results.slice(0, 5).forEach(s => {
+          console.log(`  ${chalk.cyan(s.name)}  ${s.display_name || ''}`);
+        });
+      }
+      process.exit(1);
+    }
+
+    // 2. 下载 zip 压缩包
+    spinner.text = `正在下载 ${skill_name}@${skill.version || 'latest'}...`;
+    const download_url = `${server}/api/skills/${skill.id}/download`;
+    const zip_buffer = await download_file(download_url);
+
+    // 3. 解压到目标目录
+    const target_dir = resolve(process.cwd(), dir, skill_name);
+    spinner.text = `正在解压到 ${target_dir}...`;
+
+    if (!existsSync(target_dir)) {
+      mkdirSync(target_dir, { recursive: true });
+    }
+
+    await extract_zip(zip_buffer, target_dir);
+
+    spinner.succeed(chalk.green(`${skill_name}@${skill.version || 'latest'} 安装成功`));
+    console.log(chalk.gray(`  安装路径: ${target_dir}`));
+
+  } catch (err) {
+    spinner.fail(chalk.red(`安装失败: ${err.message}`));
+    process.exit(1);
+  }
+}

package/lib/list.js

@@ -0,0 +1,46 @@
+/**
+ * list 命令实现
+ * 列出 Skills Hub 中的热门 Skills
+ */
+
+import { fetch_json } from './api.js';
+
+/**
+ * 列出热门 skills
+ * @param {object} options - 命令行选项 { server }
+ */
+export async function list_skills(options) {
+  const { server } = options;
+  const chalk = (await import('chalk')).default;
+  const ora = (await import('ora')).default;
+
+  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`));
+
+    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}`);
+    });
+
+    console.log(chalk.gray(`\n安装命令: npx istarshine install <skill-name>`));
+
+  } catch (err) {
+    spinner.fail(chalk.red(`获取列表失败: ${err.message}`));
+    process.exit(1);
+  }
+}

package/lib/search.js

@@ -0,0 +1,46 @@
+/**
+ * search 命令实现
+ * 搜索 Skills Hub 中的 Skill 并展示结果
+ */
+
+import { fetch_json } from './api.js';
+
+/**
+ * 搜索并展示 skill 列表
+ * @param {string} keyword - 搜索关键词
+ * @param {object} options - 命令行选项 { server }
+ */
+export async function search_skills(keyword, options) {
+  const { server } = options;
+  const chalk = (await import('chalk')).default;
+  const ora = (await import('ora')).default;
+
+  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`));
+
+    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}`);
+    });
+
+    console.log(chalk.gray(`\n安装命令: npx istarshine install <skill-name>`));
+
+  } catch (err) {
+    spinner.fail(chalk.red(`搜索失败: ${err.message}`));
+    process.exit(1);
+  }
+}

package/lib/zip.js

@@ -0,0 +1,92 @@
+/**
+ * zip 解压模块
+ * 使用 Node.js 内置 zlib 实现，无需额外依赖
+ */
+
+import { writeFileSync, mkdirSync } from 'fs';
+import { join, dirname } from 'path';
+
+/**
+ * 解析 zip Buffer，返回所有文件条目
+ * @param {Buffer} zip_buffer - zip 文件的二进制数据
+ * @returns {Array<{name: string, data: Buffer}>} 文件条目列表
+ */
+async function parse_zip_entries(zip_buffer) {
+  const { inflateRawSync } = await import('node:zlib');
+  const entries = [];
+  let offset = 0;
+
+  while (offset < zip_buffer.length) {
+    const signature = zip_buffer.readUInt32LE(offset);
+    // local file header 签名: 0x04034b50
+    if (signature !== 0x04034b50) break;
+
+    const compression_method = zip_buffer.readUInt16LE(offset + 8);
+    const compressed_size = zip_buffer.readUInt32LE(offset + 18);
+    const name_length = zip_buffer.readUInt16LE(offset + 26);
+    const extra_length = zip_buffer.readUInt16LE(offset + 28);
+
+    const name_start = offset + 30;
+    const file_name = zip_buffer.subarray(name_start, name_start + name_length).toString('utf8');
+    const data_start = name_start + name_length + extra_length;
+    const raw_data = zip_buffer.subarray(data_start, data_start + compressed_size);
+
+    // 跳过目录条目
+    if (!file_name.endsWith('/')) {
+      let content;
+      if (compression_method === 0) {
+        content = raw_data;
+      } else if (compression_method === 8) {
+        content = inflateRawSync(raw_data);
+      } else {
+        throw new Error(`不支持的压缩方式: ${compression_method}，文件: ${file_name}`);
+      }
+      entries.push({ name: file_name, data: content });
+    }
+
+    offset = data_start + compressed_size;
+  }
+
+  return entries;
+}
+
+/**
+ * 检测并去除 zip 内的公共顶层目录前缀
+ * 例如所有文件都在 "auto-ops/" 下，则去掉这个前缀
+ * @param {Array<{name: string, data: Buffer}>} entries - 文件条目列表
+ * @returns {Array<{name: string, data: Buffer}>} 处理后的条目列表
+ */
+function strip_common_prefix(entries) {
+  if (entries.length === 0) return entries;
+
+  // 找第一个路径段作为候选前缀
+  const first_part = entries[0].name.split('/')[0] + '/';
+
+  // 检查是否所有文件都在这个前缀下
+  const all_match = entries.every(e => e.name.startsWith(first_part));
+  if (!all_match) return entries;
+
+  // 去掉公共前缀
+  return entries.map(e => ({
+    name: e.name.slice(first_part.length),
+    data: e.data,
+  })).filter(e => e.name.length > 0);
+}
+
+/**
+ * 解压 zip Buffer 到指定目录
+ * 自动去除 zip 内的公共顶层目录前缀
+ * @param {Buffer} zip_buffer - zip 文件的二进制数据
+ * @param {string} target_dir - 解压目标目录
+ */
+export async function extract_zip(zip_buffer, target_dir) {
+  let entries = await parse_zip_entries(zip_buffer);
+  entries = strip_common_prefix(entries);
+
+  for (const entry of entries) {
+    const file_path = join(target_dir, entry.name);
+    const file_dir = dirname(file_path);
+    mkdirSync(file_dir, { recursive: true });
+    writeFileSync(file_path, entry.data);
+  }
+}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "istarshine",
+  "version": "1.0.0",
+  "description": "iStarshine Skills Hub CLI - 一键安装和管理 Skills",
+  "type": "module",
+  "main": "index.js",
+  "bin": {
+    "istarshine": "./bin/cli.js"
+  },
+  "keywords": [
+    "istarshine",
+    "skills",
+    "cli",
+    "agent"
+  ],
+  "author": "istarshine",
+  "license": "MIT",
+  "dependencies": {
+    "commander": "^12.1.0",
+    "chalk": "^5.3.0",
+    "ora": "^8.1.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "bin/",
+    "lib/",
+    "README.md"
+  ]
+}