@42ailab/42plugin 0.1.21 → 0.1.23

package/src/config.ts

@@ -12,13 +12,54 @@ const dataDir =
     ? path.join(process.env.APPDATA || os.homedir(), '42plugin')
     : path.join(os.homedir(), '.42plugin'));
 
+/**
+ * 平台配置 - 支持多种 AI 编程助手
+ * 未来可扩展支持 Codex、Gemini 等
+ */
+export interface PlatformConfig {
+  id: string;
+  name: string;
+  globalDir: string; // 全局安装目录（用户级）
+  projectDir: string; // 项目安装目录名
+}
+
+const homeDir = os.homedir();
+
+export const platforms: Record<string, PlatformConfig> = {
+  claude: {
+    id: 'claude',
+    name: 'Claude Code',
+    globalDir: path.join(homeDir, '.claude'),
+    projectDir: '.claude',
+  },
+  // 预留：未来扩展
+  // codex: {
+  //   id: 'codex',
+  //   name: 'OpenAI Codex CLI',
+  //   globalDir: path.join(homeDir, '.codex'),
+  //   projectDir: '.codex',
+  // },
+  // gemini: {
+  //   id: 'gemini',
+  //   name: 'Google Gemini',
+  //   globalDir: path.join(homeDir, '.gemini'),
+  //   projectDir: '.gemini',
+  // },
+};
+
+// 当前默认平台
+export const currentPlatform: PlatformConfig = platforms.claude;
+
 export const config = {
   // 目录
   dataDir,
   cacheDir: path.join(dataDir, 'cache'),
-  globalDir: path.join(dataDir, 'global'),
+  globalDir: currentPlatform.globalDir, // 全局安装目录：~/.claude
   dbPath: path.join(dataDir, 'local.db'),
 
+  // 平台
+  platform: currentPlatform,
+
   // API
   apiBaseUrl: process.env.API_BASE_URL || 'https://api.42plugin.com',
   webBaseUrl: process.env.WEB_BASE_URL || 'https://42plugin.com',
@@ -34,3 +75,22 @@ export const config = {
 export const getDataDir = () => config.dataDir;
 export const getCacheDir = () => config.cacheDir;
 export const getDbPath = () => config.dbPath;
+
+/**
+ * 获取全局目录路径
+ * @param platformId 平台 ID（默认当前平台）
+ */
+export const getGlobalDir = (platformId?: string): string => {
+  if (platformId && platforms[platformId]) {
+    return platforms[platformId].globalDir;
+  }
+  return config.globalDir;
+};
+
+/**
+ * 判断路径是否为全局目录
+ */
+export const isGlobalDir = (dirPath: string): boolean => {
+  const resolved = path.resolve(dirPath);
+  return Object.values(platforms).some((p) => path.resolve(p.globalDir) === resolved);
+};

package/src/db.ts

@@ -367,6 +367,37 @@ export async function getInstallations(projectPath: string): Promise<LocalInstal
   }));
 }
 
+export interface InstallationWithProject extends LocalInstallation {
+  projectPath: string;
+  projectName: string;
+}
+
+export async function getAllInstallations(): Promise<InstallationWithProject[]> {
+  const client = await getDb();
+
+  const rows = client.prepare(`
+    SELECT i.*, p.path as project_path, p.name as project_name
+    FROM installations i
+    JOIN projects p ON i.project_id = p.id
+    ORDER BY p.path, i.installed_at DESC
+  `).all() as Record<string, unknown>[];
+
+  return rows.map((row) => ({
+    id: row.id as string,
+    projectId: row.project_id as string,
+    fullName: row.full_name as string,
+    type: row.type as PluginType,
+    version: row.version as string,
+    cachePath: row.cache_path as string,
+    linkPath: row.link_path as string,
+    source: row.source as 'direct' | 'kit',
+    sourceKit: row.source_kit as string | undefined,
+    installedAt: row.installed_at as string,
+    projectPath: row.project_path as string,
+    projectName: row.project_name as string,
+  }));
+}
+
 export async function removeInstallation(projectPath: string, fullName: string): Promise<boolean> {
   const client = await getDb();
   const absPath = path.resolve(projectPath);

package/src/services/publisher.ts

@@ -9,6 +9,8 @@
  * 5. 确认发布
  */
 
+import fs from 'fs/promises';
+import path from 'path';
 import ora from 'ora';
 import chalk from 'chalk';
 import { confirm } from '@inquirer/prompts';
@@ -24,6 +26,7 @@ import type {
   PublishResult,
   PackageResult,
   ValidationResult,
+  PluginType,
 } from '../types';
 
 export class Publisher {
@@ -49,7 +52,7 @@ export class Publisher {
     try {
       // Phase 1: 完整验证
       spinner.text = '验证插件...';
-      const validation = await this.validator.validateFull(options.path, options.name);
+      const validation = await this.validator.validateFull(options.path, options.name, options.type);
 
       // 显示验证结果
       spinner.stop();
@@ -143,6 +146,9 @@ export class Publisher {
       const uploadResult = await this.uploader.upload(metadata, pkg, versionDecision.version);
       spinner.succeed('上传完成');
 
+      // 读取文档内容
+      const docContent = await this.readDocContent(metadata.sourcePath, metadata.type);
+
       // Phase 5: 确认发布
       spinner.start('确认发布...');
       const result = await api.confirmPublish({
@@ -157,6 +163,7 @@ export class Publisher {
         description: metadata.description,
         tags: metadata.tags,
         visibility: options.visibility || 'self',
+        docContent,
       });
       spinner.succeed('发布成功');
 
@@ -234,4 +241,82 @@ export class Publisher {
     const session = await api.getSession();
     return session.user.username || session.user.name || 'unknown';
   }
+
+  /**
+   * 读取插件文档内容
+   * 优先级：类型对应文档 > README.md > 任意 .md 文件
+   */
+  private async readDocContent(sourcePath: string, pluginType: PluginType): Promise<string | undefined> {
+    const MAX_DOC_SIZE = 100 * 1024; // 100KB 限制（与 Pipeline 一致）
+
+    const stat = await fs.stat(sourcePath).catch(() => null);
+
+    // 单文件插件：文件本身就是文档
+    if (stat?.isFile() && sourcePath.endsWith('.md')) {
+      const content = await fs.readFile(sourcePath, 'utf-8');
+      if (content.length > MAX_DOC_SIZE) {
+        return content.slice(0, MAX_DOC_SIZE);
+      }
+      return content;
+    }
+
+    if (!stat?.isDirectory()) return undefined;
+
+    // 根据类型定义优先查找的文档名
+    const typeDocNames: Record<PluginType, string[]> = {
+      skill: ['SKILL.md', 'skill.md'],
+      agent: ['AGENT.md', 'agent.md'],
+      command: ['COMMAND.md', 'command.md'],
+      hook: ['HOOK.md', 'hook.md'],
+      mcp: ['MCP.md', 'mcp.md'],
+    };
+
+    const fallbackNames = ['README.md', 'readme.md'];
+
+    // 1. 优先匹配类型对应的文档
+    const primaryDocs = typeDocNames[pluginType] || [];
+    for (const name of primaryDocs) {
+      const filePath = path.join(sourcePath, name);
+      try {
+        const content = await fs.readFile(filePath, 'utf-8');
+        if (content.length > MAX_DOC_SIZE) {
+          return content.slice(0, MAX_DOC_SIZE);
+        }
+        return content;
+      } catch {
+        // 继续尝试下一个
+      }
+    }
+
+    // 2. Fallback 到 README
+    for (const name of fallbackNames) {
+      const filePath = path.join(sourcePath, name);
+      try {
+        const content = await fs.readFile(filePath, 'utf-8');
+        if (content.length > MAX_DOC_SIZE) {
+          return content.slice(0, MAX_DOC_SIZE);
+        }
+        return content;
+      } catch {
+        // 继续尝试下一个
+      }
+    }
+
+    // 3. 任意 .md 文件（最后手段）
+    try {
+      const entries = await fs.readdir(sourcePath, { withFileTypes: true });
+      const mdFile = entries.find(e => e.isFile() && e.name.endsWith('.md'));
+      if (mdFile) {
+        const content = await fs.readFile(path.join(sourcePath, mdFile.name), 'utf-8');
+        if (content.length > MAX_DOC_SIZE) {
+          return content.slice(0, MAX_DOC_SIZE);
+        }
+        return content;
+      }
+    } catch {
+      // 忽略错误
+    }
+
+    return undefined;
+  }
 }

package/src/types.ts

@@ -289,6 +289,7 @@ export interface PublishOptions {
   force?: boolean;
   visibility?: 'self' | 'public';
   name?: string;
+  type?: PluginType;  // 用户指定的类型，覆盖自动推断
 }
 
 export interface PluginMetadata {
@@ -339,6 +340,7 @@ export interface PublishConfirmRequest {
   description?: string;
   tags?: string[];
   visibility: 'self' | 'public';
+  docContent?: string;
 }
 
 export interface PublishConfirmResponse {

package/src/update-checker.ts

@@ -0,0 +1,343 @@
+/**
+ * 版本更新检查模块
+ *
+ * 功能：
+ * - 启动时后台检查 npm registry 获取最新版本
+ * - 24 小时内只检查一次，每天最多提示一次
+ * - 3 秒超时，静默失败不影响正常使用
+ * - 检测安装方式（Homebrew/npm）显示对应升级命令
+ * - 支持 NO_UPDATE_CHECK=1 环境变量禁用
+ */
+
+import fs from 'fs';
+import path from 'path';
+import chalk from 'chalk';
+import { config } from './config';
+
+// ============================================================================
+// 配置
+// ============================================================================
+
+const CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000; // 24 小时
+const NOTIFY_INTERVAL_MS = 24 * 60 * 60 * 1000; // 24 小时内只提示一次
+const FETCH_TIMEOUT_MS = 3000; // 3 秒超时
+const CACHE_FILE = path.join(config.dataDir, '.update-check');
+const NPM_REGISTRY_URL = 'https://registry.npmjs.org/@42ailab/42plugin/latest';
+
+// ============================================================================
+// 类型
+// ============================================================================
+
+interface UpdateCache {
+  lastCheck: number; // 上次检查时间戳
+  latestVersion: string | null; // 最新版本
+  lastNotified: number; // 上次提示时间戳
+}
+
+type InstallSource = 'homebrew' | 'npm';
+
+const DEFAULT_CACHE: UpdateCache = { lastCheck: 0, latestVersion: null, lastNotified: 0 };
+
+// ============================================================================
+// 缓存管理
+// ============================================================================
+
+function readCache(): UpdateCache {
+  try {
+    if (fs.existsSync(CACHE_FILE)) {
+      const content = fs.readFileSync(CACHE_FILE, 'utf-8');
+      const parsed = JSON.parse(content);
+      // 基本校验：确保必需字段存在
+      if (
+        typeof parsed.lastCheck === 'number' &&
+        typeof parsed.lastNotified === 'number'
+      ) {
+        return {
+          lastCheck: parsed.lastCheck,
+          latestVersion: parsed.latestVersion ?? null,
+          lastNotified: parsed.lastNotified,
+        };
+      }
+    }
+  } catch {
+    // 缓存读取/解析失败，返回默认值
+    // 可选：在 debug 模式下记录警告
+    if (config.debug) {
+      console.error(chalk.gray('[update-checker] 缓存读取失败，使用默认值'));
+    }
+  }
+  return { ...DEFAULT_CACHE };
+}
+
+function writeCache(cache: UpdateCache): void {
+  try {
+    fs.mkdirSync(path.dirname(CACHE_FILE), { recursive: true });
+    fs.writeFileSync(CACHE_FILE, JSON.stringify(cache));
+  } catch {
+    // 缓存写入失败，忽略
+  }
+}
+
+// ============================================================================
+// 版本比较
+// ============================================================================
+
+/**
+ * 解析版本号，处理预发布版本
+ * 例如：'1.2.3-beta.1' -> { parts: [1, 2, 3], prerelease: 'beta.1' }
+ */
+function parseVersion(v: string): { parts: number[]; prerelease: string | null } {
+  const cleaned = v.replace(/^v/, '');
+  const [main, prerelease] = cleaned.split('-', 2);
+  const parts = main.split('.').map((part) => {
+    const num = parseInt(part, 10);
+    return isNaN(num) ? 0 : num;
+  });
+  return { parts, prerelease: prerelease || null };
+}
+
+/**
+ * 比较两个版本号
+ * @returns -1 表示 a < b, 0 表示 a = b, 1 表示 a > b
+ *
+ * 规则：
+ * - 主版本号按数字比较
+ * - 预发布版本 < 正式版本 (1.0.0-beta < 1.0.0)
+ * - 预发布版本之间按字符串比较
+ */
+function compareVersions(a: string, b: string): number {
+  const va = parseVersion(a);
+  const vb = parseVersion(b);
+
+  // 比较主版本号（动态长度）
+  const maxLen = Math.max(va.parts.length, vb.parts.length);
+  for (let i = 0; i < maxLen; i++) {
+    const na = va.parts[i] || 0;
+    const nb = vb.parts[i] || 0;
+    if (na < nb) return -1;
+    if (na > nb) return 1;
+  }
+
+  // 主版本号相同，比较预发布标识
+  // 有预发布标识 < 无预发布标识
+  if (va.prerelease && !vb.prerelease) return -1;
+  if (!va.prerelease && vb.prerelease) return 1;
+
+  // 都有预发布标识，按字符串比较
+  if (va.prerelease && vb.prerelease) {
+    return va.prerelease.localeCompare(vb.prerelease);
+  }
+
+  return 0;
+}
+
+// ============================================================================
+// 安装方式检测
+// ============================================================================
+
+/**
+ * 检测 CLI 的安装来源
+ */
+function detectInstallSource(): InstallSource {
+  const execPath = process.execPath;
+
+  // Homebrew 路径特征
+  // macOS ARM: /opt/homebrew/...
+  // macOS Intel: /usr/local/Cellar/...
+  // Linux: /home/linuxbrew/.linuxbrew/...
+  if (
+    execPath.includes('/opt/homebrew') ||
+    execPath.includes('/usr/local/Cellar') ||
+    execPath.includes('/linuxbrew')
+  ) {
+    return 'homebrew';
+  }
+
+  return 'npm';
+}
+
+/**
+ * 获取升级命令
+ */
+function getUpgradeCommand(source: InstallSource): string {
+  switch (source) {
+    case 'homebrew':
+      return 'brew upgrade 42plugin';
+    case 'npm':
+    default:
+      // 使用 bun，性能更好
+      return 'bun update -g @42ailab/42plugin';
+  }
+}
+
+// ============================================================================
+// 网络请求
+// ============================================================================
+
+/**
+ * 从 npm registry 获取最新版本
+ */
+async function fetchLatestVersion(): Promise<string | null> {
+  try {
+    const response = await fetch(NPM_REGISTRY_URL, {
+      signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
+      headers: {
+        Accept: 'application/json',
+      },
+    });
+
+    if (response.ok) {
+      const data = (await response.json()) as { version?: string };
+      return data.version || null;
+    }
+  } catch {
+    // 网络错误、超时等，静默失败
+  }
+  return null;
+}
+
+// ============================================================================
+// 提示显示
+// ============================================================================
+
+/**
+ * 显示更新提示（简洁单行）
+ */
+function showUpdateNotice(currentVersion: string, latestVersion: string): void {
+  const source = detectInstallSource();
+  const command = getUpgradeCommand(source);
+
+  console.log();
+  console.log(
+    chalk.yellow(`✨ 新版本 ${latestVersion} 可用`) +
+      chalk.gray(` (当前 ${currentVersion})  `) +
+      chalk.cyan(`升级: ${command}`)
+  );
+}
+
+/**
+ * 判断是否需要显示提示并显示
+ * @returns 是否显示了提示
+ */
+function maybeShowNotice(
+  currentVersion: string,
+  latestVersion: string,
+  lastNotified: number,
+  now: number
+): boolean {
+  if (compareVersions(currentVersion, latestVersion) < 0) {
+    const needsNotify = now - lastNotified >= NOTIFY_INTERVAL_MS;
+    if (needsNotify) {
+      showUpdateNotice(currentVersion, latestVersion);
+      return true;
+    }
+  }
+  return false;
+}
+
+// ============================================================================
+// 主入口
+// ============================================================================
+
+/**
+ * 检查更新（非阻塞）
+ *
+ * 在命令执行后调用，后台检查并在需要时显示提示
+ *
+ * @param currentVersion 当前版本号
+ */
+export function checkForUpdates(currentVersion: string): void {
+  // 1. 检查是否禁用
+  if (process.env.NO_UPDATE_CHECK === '1') {
+    return;
+  }
+
+  // 2. 读取缓存
+  const cache = readCache();
+  const now = Date.now();
+
+  // 3. 判断是否需要检查
+  const needsCheck = now - cache.lastCheck >= CHECK_INTERVAL_MS;
+
+  if (needsCheck) {
+    // 后台检查，使用立即执行的异步函数
+    // 注意：这里不使用 setImmediate，因为 CLI 可能在回调执行前退出
+    // 改用 Promise，让 Node.js 事件循环保持活跃直到完成
+    (async () => {
+      try {
+        const latestVersion = await fetchLatestVersion();
+
+        // 重新读取缓存以避免竞态条件
+        const freshCache = readCache();
+        const freshNow = Date.now();
+
+        // 更新缓存
+        const newCache: UpdateCache = {
+          lastCheck: freshNow,
+          latestVersion: latestVersion ?? freshCache.latestVersion,
+          lastNotified: freshCache.lastNotified,
+        };
+
+        // 判断是否需要提示
+        if (latestVersion) {
+          const didNotify = maybeShowNotice(
+            currentVersion,
+            latestVersion,
+            freshCache.lastNotified,
+            freshNow
+          );
+          if (didNotify) {
+            newCache.lastNotified = freshNow;
+          }
+        }
+
+        writeCache(newCache);
+      } catch {
+        // 静默失败
+      }
+    })();
+  } else {
+    // 使用缓存的版本信息判断
+    if (cache.latestVersion) {
+      const didNotify = maybeShowNotice(
+        currentVersion,
+        cache.latestVersion,
+        cache.lastNotified,
+        now
+      );
+      if (didNotify) {
+        writeCache({ ...cache, lastNotified: now });
+      }
+    }
+  }
+}
+
+/**
+ * 主动检查更新（阻塞，用于 version --check）
+ *
+ * @param currentVersion 当前版本号
+ * @returns 是否有新版本
+ */
+export async function checkForUpdatesSync(currentVersion: string): Promise<boolean> {
+  const latestVersion = await fetchLatestVersion();
+
+  if (!latestVersion) {
+    console.log(chalk.gray('无法获取最新版本信息'));
+    return false;
+  }
+
+  // 更新缓存
+  writeCache({
+    lastCheck: Date.now(),
+    latestVersion,
+    lastNotified: Date.now(),
+  });
+
+  if (compareVersions(currentVersion, latestVersion) < 0) {
+    showUpdateNotice(currentVersion, latestVersion);
+    return true;
+  } else {
+    console.log(chalk.green('✓ 已是最新版本'));
+    return false;
+  }
+}