@42ailab/42plugin 0.1.9 → 0.1.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@42ailab/42plugin",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "活水插件",
   "type": "module",
   "main": "src/index.ts",
@@ -51,11 +51,13 @@
     "open": "^10.1.0",
     "ora": "^8.1.1",
     "pg": "^8.12.0",
+    "prompts": "^2.4.2",
     "tar": "^7.4.3"
   },
   "devDependencies": {
     "@types/bun": "latest",
     "@types/cli-progress": "^3.11.6",
+    "@types/prompts": "^2.4.9",
     "@types/tar": "^6.1.13",
     "typescript": "^5.7.0"
   }

package/src/cli.ts

@@ -24,7 +24,9 @@ const program = new Command();
 program
   .name('42plugin')
   .description('活水插件 - AI 插件管理工具')
-  .version(version);
+  .version(version, '-v, --version', '显示版本号')
+  .option('--verbose', '详细输出')
+  .option('--no-color', '禁用颜色输出');
 
 // 注册命令
 program.addCommand(authCommand);

package/src/services/kit.ts

@@ -0,0 +1,117 @@
+/**
+ * 套包管理服务
+ *
+ * 管理用户的套包（Kit），包括列出、创建、选择等操作
+ */
+import prompts from 'prompts';
+import chalk from 'chalk';
+import { api } from './api';
+
+export interface Kit {
+  id: string;
+  name: string;
+  title: string | null;
+  description: string | null;
+}
+
+/**
+ * 获取用户的套包列表
+ */
+export async function listUserKits(): Promise<Kit[]> {
+  return api.listUserKits();
+}
+
+/**
+ * 创建默认套包
+ *
+ * 当用户没有套包时，自动创建名为 "main" 的套包
+ */
+export async function createDefaultKit(): Promise<Kit> {
+  return api.createKit({
+    name: 'main',
+    title: 'Main',
+    description: '默认插件套包',
+  });
+}
+
+/**
+ * 按名称获取套包
+ */
+export async function getKitByName(name: string): Promise<Kit | null> {
+  try {
+    return await api.getKit(name);
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * 确定目标套包
+ *
+ * 优先级：
+ * 1. 命令行 --kit 参数指定
+ * 2. 用户选择（如有多个套包）
+ * 3. 自动创建 main 套包（如用户无套包）
+ *
+ * @param kitOption 命令行指定的套包名称
+ * @param skipPrompt 是否跳过交互式选择
+ */
+export async function resolveTargetKit(kitOption?: string, skipPrompt?: boolean): Promise<Kit> {
+  // 1. 明确指定套包
+  if (kitOption) {
+    const kit = await getKitByName(kitOption);
+    if (!kit) {
+      throw new Error(`套包 "${kitOption}" 不存在`);
+    }
+    return kit;
+  }
+
+  // 2. 获取用户套包列表
+  const kits = await listUserKits();
+
+  // 3. 无套包 → 自动创建 main
+  if (kits.length === 0) {
+    console.log(chalk.yellow('您还没有套包，正在创建默认套包 "main"...'));
+    const newKit = await createDefaultKit();
+    console.log(chalk.green(`✓ 已创建套包: ${newKit.name}`));
+    return newKit;
+  }
+
+  // 4. 仅一个套包 → 直接使用
+  if (kits.length === 1) {
+    return kits[0];
+  }
+
+  // 5. 跳过交互 → 使用第一个套包
+  if (skipPrompt) {
+    return kits[0];
+  }
+
+  // 6. 多个套包 → 交互选择
+  const response = await prompts({
+    type: 'select',
+    name: 'kit',
+    message: '选择目标套包:',
+    choices: kits.map(k => ({
+      title: formatKitChoice(k),
+      value: k,
+    })),
+  });
+
+  if (!response.kit) {
+    throw new Error('未选择套包');
+  }
+
+  return response.kit;
+}
+
+/**
+ * 格式化套包选择项
+ */
+function formatKitChoice(kit: Kit): string {
+  const desc = kit.title || kit.description;
+  if (desc) {
+    return `${kit.name} - ${desc}`;
+  }
+  return kit.name;
+}

package/src/services/manifest.ts

@@ -0,0 +1,146 @@
+/**
+ * 插件清单解析服务
+ *
+ * 从插件目录读取 SKILL.md / AGENT.md / COMMAND.md / HOOK.md / MCP.md
+ * 解析 frontmatter 获取插件元数据
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import matter from 'gray-matter';
+
+export type CapabilityType = 'skill' | 'agent' | 'command' | 'hook' | 'mcp';
+
+export interface PluginManifest {
+  name: string;           // 必填，插件名称
+  title: string;          // 必填，显示标题
+  description: string;    // 必填，描述
+  type: CapabilityType;   // 插件类型
+  version: string;        // 版本号
+  tags?: string[];        // 标签
+  author?: string;        // 作者（可选，默认用当前用户）
+  filePath: string;       // 清单文件路径
+  content: string;        // 文件内容（不含 frontmatter）
+}
+
+/** 类型文件映射 */
+const TYPE_FILES: Record<string, CapabilityType> = {
+  'SKILL.md': 'skill',
+  'AGENT.md': 'agent',
+  'COMMAND.md': 'command',
+  'HOOK.md': 'hook',
+  'MCP.md': 'mcp',
+};
+
+/**
+ * 从目录读取插件清单
+ *
+ * 扫描顺序：SKILL.md → AGENT.md → COMMAND.md → HOOK.md → MCP.md
+ * 返回第一个找到的清单
+ */
+export async function readManifest(pluginPath: string): Promise<PluginManifest> {
+  const resolvedPath = path.resolve(pluginPath);
+
+  // 检查目录是否存在
+  try {
+    const stat = await fs.stat(resolvedPath);
+    if (!stat.isDirectory()) {
+      throw new Error(`路径不是目录: ${resolvedPath}`);
+    }
+  } catch (error) {
+    if ((error as NodeJS.ErrnoException).code === 'ENOENT') {
+      throw new Error(`目录不存在: ${resolvedPath}`);
+    }
+    throw error;
+  }
+
+  // 扫描清单文件
+  for (const [filename, type] of Object.entries(TYPE_FILES)) {
+    const filePath = path.join(resolvedPath, filename);
+
+    try {
+      const content = await fs.readFile(filePath, 'utf-8');
+      const { data: frontmatter, content: body } = matter(content);
+
+      // 验证必填字段
+      const name = frontmatter.name || path.basename(resolvedPath);
+      const title = frontmatter.title || frontmatter.name || name;
+      const description = frontmatter.description || '';
+
+      if (!description) {
+        throw new Error(`${filename} 缺少 description 字段`);
+      }
+
+      return {
+        name: sanitizeName(name),
+        title,
+        description,
+        type,
+        version: frontmatter.version || '1.0.0',
+        tags: Array.isArray(frontmatter.tags) ? frontmatter.tags : undefined,
+        author: frontmatter.author,
+        filePath,
+        content: body.trim(),
+      };
+    } catch (error) {
+      // 文件不存在，继续检查下一个
+      if ((error as NodeJS.ErrnoException).code === 'ENOENT') {
+        continue;
+      }
+      // 其他错误（如解析错误）直接抛出
+      throw error;
+    }
+  }
+
+  // 未找到任何清单文件
+  throw new Error(
+    `未找到插件清单文件。请在目录中创建以下文件之一:\n` +
+    `  - SKILL.md (技能插件)\n` +
+    `  - AGENT.md (代理插件)\n` +
+    `  - COMMAND.md (命令插件)\n` +
+    `  - HOOK.md (钩子插件)\n` +
+    `  - MCP.md (MCP 插件)`
+  );
+}
+
+/**
+ * 清理插件名称
+ * - 转小写
+ * - 空格替换为连字符
+ * - 移除非法字符
+ */
+function sanitizeName(name: string): string {
+  return name
+    .toLowerCase()
+    .replace(/\s+/g, '-')
+    .replace(/[^a-z0-9-_]/g, '')
+    .replace(/-+/g, '-')
+    .replace(/^-|-$/g, '');
+}
+
+/**
+ * 验证清单完整性
+ */
+export function validateManifest(manifest: PluginManifest): { valid: boolean; errors: string[] } {
+  const errors: string[] = [];
+
+  if (!manifest.name || manifest.name.length < 2) {
+    errors.push('name 字段必须至少 2 个字符');
+  }
+
+  if (!manifest.title || manifest.title.length < 2) {
+    errors.push('title 字段必须至少 2 个字符');
+  }
+
+  if (!manifest.description || manifest.description.length < 10) {
+    errors.push('description 字段必须至少 10 个字符');
+  }
+
+  if (manifest.name && !/^[a-z0-9-_]+$/.test(manifest.name)) {
+    errors.push('name 只能包含小写字母、数字、连字符和下划线');
+  }
+
+  return {
+    valid: errors.length === 0,
+    errors,
+  };
+}