adspecs 0.1.29 → 0.1.31

package/src/commands/plugin.js

@@ -30,7 +30,14 @@ function checkClaudeCli() {
  * @param {string} platform - 'claude' | 'qoder'
  */
 function getPluginName(platform) {
-  var manifestDir = platform === 'qoder' ? '.qoder-plugin' : '.claude-plugin';
+  var manifestDir;
+  if (platform === 'qoder') {
+    manifestDir = '.qoder-plugin';
+  } else if (platform === 'workbuddy') {
+    manifestDir = '.workbuddy-plugin';
+  } else {
+    manifestDir = '.claude-plugin';
+  }
   const pluginJsonPath = path.join(PLUGIN_DIR, manifestDir, 'plugin.json');
   if (!fs.existsSync(pluginJsonPath)) {
     // 回退到 .claude-plugin
@@ -47,18 +54,22 @@ function getPluginName(platform) {
 
 /**
  * 检测当前可用的 AI 平台
- * @returns {'claude'|'qoder'}
+ * @returns {'claude'|'qoder'|'workbuddy'}
  */
 function detectInstalledPlatform() {
   // 显式环境变量优先
   var explicit = (process.env.ADSPECS_PLATFORM || '').toLowerCase();
-  if (explicit === 'qoder' || explicit === 'claude') {
+  if (['qoder', 'claude', 'workbuddy'].includes(explicit)) {
     return explicit;
   }
   // 检测 claude CLI
   if (checkClaudeCli()) {
     return 'claude';
   }
+  // WorkBuddy 运行环境检测（HOME 下有 ~/.workbuddy）
+  if (fs.existsSync(path.join(os.homedir(), '.workbuddy'))) {
+    return 'workbuddy';
+  }
   // 默认回退 qoder（当前运行环境）
   return 'qoder';
 }
@@ -68,7 +79,7 @@ function detectInstalledPlatform() {
  *
  * @param {object} options
  * @param {string} options.scope - 安装范围: user|project
- * @param {string} options.platform - 目标平台: claude|qoder（可选，自动检测）
+ * @param {string} options.platform - 目标平台: claude|qoder|workbuddy（可选，自动检测）
  */
 exports.install = async function install(options) {
   const scope = options.scope || 'user';
@@ -83,13 +94,80 @@ exports.install = async function install(options) {
   console.log(`   目标平台:  ${platform}`);
   console.log('');
 
-  if (platform === 'qoder') {
+  if (platform === 'workbuddy') {
+    await installForWorkBuddy(pluginName, scope);
+  } else if (platform === 'qoder') {
     await installForQoder(pluginName, scope);
   } else {
     await installForClaude(pluginName, scope);
   }
 };
 
+/**
+ * 检查 codebuddy CLI 是否可用（WorkBuddy 共享 CodeBuddy CLI）
+ */
+function checkCodebuddyCli() {
+  try {
+    execSync('codebuddy --version', { stdio: 'ignore' });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * WorkBuddy 平台安装
+ * 通过 CodeBuddy 插件系统安装，自动处理 skills/hooks 加载和 enabledPlugins
+ * 若 CLI 不可用则回退为手工配置 enabledPlugins
+ */
+async function installForWorkBuddy(pluginName, scope) {
+  const workbuddyManifest = path.join(PLUGIN_DIR, '.workbuddy-plugin', 'plugin.json');
+  if (!fs.existsSync(workbuddyManifest)) {
+    throw new Error(`未找到 WorkBuddy 插件清单: ${workbuddyManifest}`);
+  }
+
+  if (checkCodebuddyCli()) {
+    // 方式 A：通过 CodeBuddy CLI 安装（自动处理一切）
+    const scopeFlag = scope === 'project' ? '--scope project' : '--scope user';
+    console.log(chalk.gray('   通过 CodeBuddy CLI 安装 adspecs 插件...'));
+    try {
+      execSync(`codebuddy plugin install "${PLUGIN_DIR}" ${scopeFlag}`, {
+        encoding: 'utf8',
+        stdio: 'pipe'
+      });
+      console.log(chalk.green('   ✅ adspecs 插件安装成功'));
+      console.log(chalk.gray('   请重启 WorkBuddy 使 skills 与 hooks 生效。'));
+    } catch (err) {
+      const stderr = err.stderr ? err.stderr.toString() : '';
+      const combined = stderr + (err.stdout ? err.stdout.toString() : '');
+      if (combined.includes('already exists') || combined.includes('already installed')) {
+        console.log(chalk.yellow('   ⏭ 插件已安装，跳过'));
+      } else {
+        throw new Error(`WorkBuddy 插件安装失败: ${combined.trim() || err.message}`);
+      }
+    }
+  } else {
+    // 方式 B：回退为手工配置（无 CLI 时）
+    // 完整注册：创建 marketplace 目录 → junction 链接 → known_marketplaces.json → enabledPlugins
+    console.log(chalk.yellow('   ⚠ 未检测到 codebuddy CLI，使用手工配置方式'));
+    console.log('');
+
+    const { registerWorkBuddyPlugin } = require('../utils');
+    const result = registerWorkBuddyPlugin(PLUGIN_DIR, pluginName);
+
+    if (result.success) {
+      console.log(chalk.green('   ✅ 已完成 WorkBuddy 插件注册'));
+      console.log(chalk.gray('   📁 插件目录:'));
+      console.log(chalk.gray(`      ${PLUGIN_DIR}`));
+      console.log(chalk.gray('   📁 marketplace:'));
+      console.log(chalk.gray(`      ~/.workbuddy/plugins/marketplaces/local/`));
+    } else {
+      throw new Error(`WorkBuddy 插件注册失败: ${result.reason}`);
+    }
+    console.log(chalk.gray('   请重启 WorkBuddy 使 skills 与 hooks 生效。'));
+  }
+}
+
 /**
  * Qoder 平台安装
  * 自动注册到 Qoder 插件系统：
@@ -256,23 +334,7 @@ async function installQoderProject(pluginName, qoderManifest) {
   }
 }
 
-/**
- * 递归复制目录（排除指定目录名）
- */
-function copyDirRecursive(src, dest, excludeDirs) {
-  fs.mkdirSync(dest, { recursive: true });
-  const entries = fs.readdirSync(src, { withFileTypes: true });
-  for (const entry of entries) {
-    if (excludeDirs && excludeDirs.includes(entry.name)) continue;
-    const srcPath = path.join(src, entry.name);
-    const destPath = path.join(dest, entry.name);
-    if (entry.isDirectory()) {
-      copyDirRecursive(srcPath, destPath, excludeDirs);
-    } else {
-      fs.copyFileSync(srcPath, destPath);
-    }
-  }
-}
+const { copyDirRecursive } = require('../utils');
 
 /**
  * Qoder 用户级卸载 — 移除链接 + 注册表条目 + 启用配置
@@ -420,12 +482,94 @@ function printSkillList() {
   console.log('');
 }
 
+/**
+ * WorkBuddy 平台卸载
+ * 通过 CodeBuddy CLI 卸载，或手工清除 settings.json 中的 enabledPlugins 条目
+ */
+async function uninstallWorkBuddy(pluginName, scope) {
+  if (checkCodebuddyCli()) {
+    const scopeFlag = scope === 'project' ? '--scope project' : '--scope user';
+    try {
+      execSync(`codebuddy plugin uninstall ${pluginName} ${scopeFlag}`, {
+        stdio: 'pipe',
+      });
+      console.log(chalk.green(`   ✅ ${pluginName} 插件已卸载`));
+    } catch (err) {
+      const stderr = err.stderr ? err.stderr.toString() : '';
+      if (stderr.includes('not installed') || stderr.includes('not found')) {
+        console.log(chalk.yellow(`   ⏭ ${pluginName} 未安装，无需卸载`));
+      } else {
+        throw new Error(`WorkBuddy 插件卸载失败: ${stderr || err.message}`);
+      }
+    }
+  } else {
+    // 回退：手工清除 marketplace 注册 + junction 链接 + enabledPlugins 条目
+    const workbuddyHome = path.join(os.homedir(), '.workbuddy');
+    const localMarketplaceDir = path.join(workbuddyHome, 'plugins', 'marketplaces', 'local');
+    const pluginLinkPath = path.join(localMarketplaceDir, pluginName);
+    const settingsPath = path.join(workbuddyHome, 'settings.json');
+    const knownMarketplacesPath = path.join(workbuddyHome, 'plugins', 'known_marketplaces.json');
+
+    let cleaned = false;
+
+    // 1. 移除 junction / 目录
+    if (fs.existsSync(pluginLinkPath)) {
+      try {
+        fs.rmSync(pluginLinkPath, { recursive: true, force: true });
+        console.log(chalk.green('   ✅ 已移除插件链接'));
+        cleaned = true;
+      } catch (err) {
+        console.log(chalk.yellow(`   ⚠ 移除插件链接失败: ${err.message}`));
+      }
+    }
+
+    // 2. 从 settings.json 移除
+    if (fs.existsSync(settingsPath)) {
+      let settings = {};
+      try { settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8')); } catch (_e) { /* use default */ }
+      if (settings.enabledPlugins) {
+        const keysBefore = Object.keys(settings.enabledPlugins).length;
+        for (var key in settings.enabledPlugins) {
+          if (key.startsWith(pluginName + '@')) {
+            delete settings.enabledPlugins[key];
+          }
+        }
+        const keysAfter = Object.keys(settings.enabledPlugins).length;
+        if (keysBefore > keysAfter) {
+          fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n', 'utf8');
+          console.log(chalk.green('   ✅ 已从 settings.json 移除插件配置'));
+          cleaned = true;
+        } else {
+          console.log(chalk.yellow('   ⏭ 未在 settings.json 中找到插件配置'));
+        }
+      }
+    }
+
+    // 3. 从 known_marketplaces.json 移除 local marketplace
+    if (fs.existsSync(knownMarketplacesPath)) {
+      let knownMarketplaces = {};
+      try { knownMarketplaces = JSON.parse(fs.readFileSync(knownMarketplacesPath, 'utf8')); } catch (_e) { /* use default */ }
+      if (knownMarketplaces.local) {
+        delete knownMarketplaces.local;
+        fs.writeFileSync(knownMarketplacesPath, JSON.stringify(knownMarketplaces, null, 4) + '\n', 'utf8');
+        console.log(chalk.green('   ✅ 已从 known_marketplaces.json 移除 local marketplace'));
+        cleaned = true;
+      }
+    }
+
+    if (!cleaned) {
+      console.log(chalk.yellow('   ⏭ 未找到需要清理的插件配置'));
+    }
+  }
+  console.log(chalk.gray('   请重启 WorkBuddy 使变更生效。'));
+}
+
 /**
  * 卸载插件
  *
  * @param {object} options
  * @param {string} options.scope - 卸载范围: user|project
- * @param {string} options.platform - 目标平台: claude|qoder（可选，自动检测）
+ * @param {string} options.platform - 目标平台: claude|qoder|workbuddy（可选，自动检测）
  */
 exports.uninstall = async function uninstall(options) {
   const scope = options.scope || 'user';
@@ -437,7 +581,9 @@ exports.uninstall = async function uninstall(options) {
   console.log(`   目标平台:  ${platform}`);
   console.log('');
 
-  if (platform === 'qoder') {
+  if (platform === 'workbuddy') {
+    await uninstallWorkBuddy(pluginName, scope);
+  } else if (platform === 'qoder') {
     if (scope === 'project') {
       // Qoder 项目级卸载：移除项目链接
       const targetDir = path.join(process.cwd(), '.qoder-plugin');

package/src/commands/update.js

@@ -81,7 +81,11 @@ module.exports = async function update(options) {
     console.log(chalk.green.bold(`✅ 升级完成: ${oldVersion} → ${newVersion}`));
   }
   console.log('');
-  console.log('   Claude Code 插件注册已通过 postinstall 钩子自动刷新。');
+  console.log('   🔄 插件注册刷新：');
+  console.log('      Claude Code  — postinstall 钩子已自动刷新命令行插件注册');
+  console.log('      Qoder / CodeBuddy / WorkBuddy — postinstall 钩子已自动刷新插件注册');
+  console.log('      如未自动刷新，请执行 adspecs plugin install --platform <platform>');
+  console.log('');
   console.log(`   验证: ${chalk.gray('adspecs --version')}`);
   console.log('');
 };

package/src/utils.js

@@ -9,6 +9,7 @@
 
 const path = require('path');
 const fs = require('fs');
+const os = require('os');
 
 /**
  * 获取插件根目录（即 adspecs/ 目录）
@@ -70,6 +71,119 @@ function safeWriteJson(filePath, data) {
   fs.writeFileSync(filePath, JSON.stringify(data, null, 2) + '\n', 'utf8');
 }
 
+/**
+ * 递归复制目录（排除指定目录名）
+ * @param {string} src
+ * @param {string} dest
+ * @param {string[]} excludeDirs
+ */
+function copyDirRecursive(src, dest, excludeDirs) {
+  fs.mkdirSync(dest, { recursive: true });
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+  for (const entry of entries) {
+    if (excludeDirs && excludeDirs.includes(entry.name)) continue;
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+    if (entry.isDirectory()) {
+      copyDirRecursive(srcPath, destPath, excludeDirs);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+/**
+ * 注册 WorkBuddy 本地插件 marketplace
+ *
+ * 手工方式完成完整注册，无需 codebuddy CLI：
+ *   1. 创建 ~/.workbuddy/plugins/marketplaces/local/ 目录
+ *   2. 创建 junction 链接（或回退复制）指向插件目录
+ *   3. 在 known_marketplaces.json 中注册 local marketplace
+ *   4. 在 settings.json 的 enabledPlugins 中启用插件
+ *
+ * @param {string} pluginDir - adspecs 插件根目录
+ * @param {string} [pluginName='adspecs'] - 插件名称
+ * @returns {{success: boolean, reason?: string}}
+ */
+function registerWorkBuddyPlugin(pluginDir, pluginName) {
+  pluginName = pluginName || 'adspecs';
+
+  const workbuddyHome = path.join(os.homedir(), '.workbuddy');
+
+  // 检查 WorkBuddy 配置目录是否存在
+  if (!fs.existsSync(workbuddyHome)) {
+    return { success: false, reason: '未检测到 WorkBuddy 配置目录 (~/.workbuddy)' };
+  }
+
+  const localMarketplaceDir = path.join(workbuddyHome, 'plugins', 'marketplaces', 'local');
+  const pluginLinkPath = path.join(localMarketplaceDir, pluginName);
+  const settingsPath = path.join(workbuddyHome, 'settings.json');
+  const knownMarketplacesPath = path.join(workbuddyHome, 'plugins', 'known_marketplaces.json');
+
+  try {
+    // 1. 创建 local marketplace 目录
+    fs.mkdirSync(localMarketplaceDir, { recursive: true });
+
+    // 2. 创建 junction / symlink（已存在则先移除重建）
+    if (fs.existsSync(pluginLinkPath)) {
+      try { fs.rmSync(pluginLinkPath, { recursive: true, force: true }); } catch (_err) {
+        try { fs.unlinkSync(pluginLinkPath); } catch (_e) { /* ignore */ }
+      }
+    }
+    try {
+      fs.symlinkSync(pluginDir, pluginLinkPath, 'junction');
+    } catch (_symlinkErr) {
+      // junction 创建失败 → 回退为复制关键目录
+      fs.mkdirSync(pluginLinkPath, { recursive: true });
+      const entriesToCopy = ['.workbuddy-plugin', 'skills', 'hooks', 'references', 'commands'];
+      for (const entry of entriesToCopy) {
+        const srcPath = path.join(pluginDir, entry);
+        if (!fs.existsSync(srcPath)) continue;
+        const destPath = path.join(pluginLinkPath, entry);
+        if (fs.lstatSync(srcPath).isDirectory()) {
+          copyDirRecursive(srcPath, destPath, ['node_modules']);
+        } else {
+          fs.copyFileSync(srcPath, destPath);
+        }
+      }
+      // 同步复制根目录关键文件
+      for (const file of ['package.json', 'CLAUDE.md', 'README.md']) {
+        const srcFile = path.join(pluginDir, file);
+        if (fs.existsSync(srcFile)) {
+          fs.copyFileSync(srcFile, path.join(pluginLinkPath, file));
+        }
+      }
+    }
+
+    // 3. 注册 local marketplace
+    let knownMarketplaces = safeReadJson(knownMarketplacesPath, {});
+    const now = new Date().toISOString();
+
+    knownMarketplaces.local = {
+      type: 'directory',
+      source: {
+        source: 'directory',
+        path: localMarketplaceDir
+      },
+      installLocation: localMarketplaceDir,
+      autoUpdate: false,
+      description: 'Local plugins',
+      lastUpdated: now
+    };
+    safeWriteJson(knownMarketplacesPath, knownMarketplaces);
+
+    // 4. 启用插件
+    let settings = safeReadJson(settingsPath, {});
+    if (!settings.enabledPlugins) settings.enabledPlugins = {};
+    settings.enabledPlugins[`${pluginName}@local`] = true;
+    safeWriteJson(settingsPath, settings);
+
+    return { success: true };
+  } catch (err) {
+    return { success: false, reason: err.message };
+  }
+}
+
 module.exports = {
   getPluginDir,
   getPkg,
@@ -77,4 +191,6 @@ module.exports = {
   isInsidePlugin,
   safeReadJson,
   safeWriteJson,
+  copyDirRecursive,
+  registerWorkBuddyPlugin,
 };