@lyra-ai/toolkit 0.2.6 → 0.2.7

package/QUICKSTART.md

@@ -134,9 +134,6 @@ skillhub list --json
 # 诊断问题
 skillhub doctor
 
-# 更新技能包
-skillhub update --scope user
-
 # 移除
 skillhub remove code-review --scope user
 ```
@@ -150,7 +147,7 @@ skillhub publish ./my-skill
 ## skillhub 工作流
 
 ```
-login（认证） → search（发现） → install（安装） → list/doctor（管理） → update（更新）
+login（认证） → search（发现） → install（安装） → list/doctor（管理）
 ```
 
 - **`login`** 存储 registry token

package/README.md

@@ -13,7 +13,7 @@
 安装后，你的 AI 编码数据自动进入组织分析平台，生成专属的多维度效能看板。
 
 ```bash
-toolkit install --agent claudecode --registry http://your-platform:38000
+toolkit install --registry http://your-platform:38000
 ```
 
 - 会话结束后自动同步，无需手动操作
@@ -117,7 +117,6 @@ AI 技能包管理器：搜索、安装、发布、管理 AI coding agent 技能
 - `skillhub remove <slug> [--scope user|project] [--agent <profile>] [--json]` → 移除技能包
 - `skillhub doctor [--fix] [--json]` → 诊断技能包安装状态
 - `skillhub publish <path> [--json]` → 发布技能包到 registry
-- `skillhub update [--scope user|project] [--agent <profile>] [--json]` → 更新已安装技能包
 
 ### Agent profiles（`--agent`）
 

package/bin/toolkit.mjs

@@ -3,7 +3,7 @@
  * toolkit — 研发工具集 CLI 入口
  *
  * 用法:
- *   toolkit install claudecode --registry <url>   安装插件
+ *   toolkit install --registry <url>   安装插件(自动检测 AI Coding Agent)
  *   toolkit status                                 查看状态
  *   toolkit flush                                  手动上传
  *   toolkit uninstall [--purge]                    卸载
@@ -23,8 +23,8 @@ const cmd = args[0];
 const HELP = `toolkit — 研发工具集
 
 命令:
-  install --agent <name> --registry <url>  安装插件(适配指定 AI Coding Agent)
-    --agent claudecode                      Claude Code(SessionEnd hook 插件)
+  install --registry <url>                安装插件(自动检测本机 AI Coding Agent)
+                                            当前支持: Claude Code (~/.claude)
   status                                    查看安装状态 + 待同步会话
   flush                                     手动触发一次同步
   config                                    配置管理
@@ -44,29 +44,18 @@ async function main() {
     return;
   }
 
-  // toolkit install --agent <name> --registry <url>
+  // toolkit install --registry <url>(自动检测 AI Coding Agent)
   if (cmd === 'install') {
-    const agentIdx = args.indexOf('--agent');
-    const agent = agentIdx >= 0 ? args[agentIdx + 1] : null;
-    if (!agent) {
-      console.error('ERROR: 缺少 --agent <name>');
-      console.error('  用法: toolkit install --agent claudecode --registry <url>');
-      console.error('  支持: claudecode');
-      process.exit(2);
-    }
-    if (agent !== 'claudecode') {
-      console.error(`ERROR: 暂不支持 agent "${agent}"。目前支持: claudecode`);
-      process.exit(2);
-    }
     const regIdx = args.indexOf('--registry');
     let registry = regIdx >= 0 ? args[regIdx + 1] : null;
     if (!registry) {
       console.error('ERROR: 缺少 --registry <url>');
-      console.error('  用法: toolkit install --agent claudecode --registry <url>');
+      console.error('  用法: toolkit install --registry <url>');
+      console.error('  (自动检测本机 AI Coding Agent,当前支持: Claude Code)');
       process.exit(2);
     }
     const { install } = await import(pathToFileURL(path.join(srcDir, 'install.mjs')).href);
-    await install(registry, { agent });
+    await install(registry);
     return;
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lyra-ai/toolkit",
-  "version": "0.2.6",
+  "version": "0.2.7",
   "description": "面向 AI agent 的零依赖开发工具集",
   "type": "module",
   "bin": {

package/src/config-cmd.mjs

@@ -27,7 +27,7 @@ export function configCmd(args) {
   if (!sub || sub === 'list' || sub === 'help' || sub === '--help') {
     const config = load();
     if (!config.registry && !config.uid) {
-      console.error('配置文件不存在。先运行: toolkit install claudecode --registry <url>');
+      console.error('配置文件不存在。先运行: toolkit install --registry <url>');
       process.exit(1);
     }
     const pf = config['project-filter'];

package/src/install.mjs

@@ -1,8 +1,9 @@
 #!/usr/bin/env node
 /**
- * install.mjs — `toolkit install --agent claudecode --registry <url>`
+ * install.mjs — `toolkit install --registry <url>`
  *
- * 用 Claude Code 官方「Skills 目录 plugin」机制(@skills-dir)注册:
+ * 自动检测本机 AI Coding Agent:目前识别 Claude Code(~/.claude),
+ * 命中即用其官方「Skills 目录 plugin」机制(@skills-dir)注册:
  *   ~/.claude/skills/toolkit/  ← 含 .claude-plugin/plugin.json + hooks/hooks.json
  *                                 + hook.mjs + flush.mjs + shared/
  *
@@ -75,13 +76,13 @@ function cleanupLegacy() {
   return cleaned;
 }
 
-export async function install(registry, opts = {}) {
-  const agent = opts.agent || 'claudecode';
-  // 1. 检测 Claude Code
-  // (后续 --agent qoder 时,检测 ~/.qoder)
+export async function install(registry) {
+  // 1. 自动检测本机 AI Coding Agent:目前仅识别 Claude Code(~/.claude)。
+  //    后续可扩展其它 agent(如 ~/.qoder)。
   const claudeDir = path.join(HOME, '.claude');
   if (!fs.existsSync(claudeDir)) {
-    console.error('ERROR: ~/.claude not found. Is Claude Code installed?');
+    console.error('ERROR: 未检测到任何已支持的 AI Coding Agent。');
+    console.error('  当前支持: Claude Code (需存在 ~/.claude 目录)');
     process.exit(1);
   }
 

package/src/skillhub.mjs

@@ -3339,21 +3339,11 @@ export function unzipSync(data, opts) {
 
 
 // ==================================================================
-// === Tools: self-implemented replacements (semverGt + readline) ===
+// === Tools: self-implemented replacements (readline prompts) ===
 // ==================================================================
 
 import readline from 'node:readline';
 
-function semverGt(a, b) {
-  const pa = String(a).replace(/^v/, '').split('.').map(Number);
-  const pb = String(b).replace(/^v/, '').split('.').map(Number);
-  for (let i = 0; i < 3; i++) {
-    if ((pa[i] ?? 0) > (pb[i] ?? 0)) return true;
-    if ((pa[i] ?? 0) < (pb[i] ?? 0)) return false;
-  }
-  return false;
-}
-
 async function promptSelect(message, choices) {
   const rl = readline.createInterface({ input: process.stdin, output: process.stderr });
   process.stderr.write(`${message}\n`);
@@ -3395,7 +3385,6 @@ async function promptMultiselect(message, choices) {
 // === Version Info ===
 // ==================================================================
 
-const PKG_NAME = "@astron-team/skillhub";
 const PKG_VERSION = "0.1.8";
 
 // ==================================================================
@@ -3417,7 +3406,6 @@ class CliError extends Error {
 
 const DEFAULT_REGISTRY = '';
 const CLI_VERSION = PKG_VERSION;
-const CLI_PACKAGE_NAME = PKG_NAME;
 const EXIT = {
   generic: 1,
   auth: 2,
@@ -3614,79 +3602,6 @@ async function readBoundedResponseBody(response, maxBytes = MAX_PACKAGE_BYTES) {
   return result.buffer;
 }
 
-// ==================================================================
-// === Source: platform/updater ===
-// ==================================================================
-
-import { spawn } from 'node:child_process';
-
-async function runUpdateCommand(command) {
-  try {
-    const [program, ...args] = command;
-    if (!program) {
-      return { success: false, output: 'empty update command' };
-    }
-
-    const spawnOptions = {
-      stdio: ['ignore', 'pipe', 'pipe'],
-      ...(process.platform === 'win32' && { shell: true })
-    };
-
-    return await new Promise((resolve) => {
-      const proc = spawn(program, args, spawnOptions);
-      const chunks = [];
-
-      proc.stdout?.on('data', (chunk) => chunks.push(Buffer.from(chunk)));
-      proc.stderr?.on('data', (chunk) => chunks.push(Buffer.from(chunk)));
-      proc.on('error', (error) => resolve({ success: false, output: error.message }));
-      proc.on('close', (code) => resolve({
-        success: code === 0,
-        output: Buffer.concat(chunks).toString('utf-8')
-      }));
-    });
-  } catch (error) {
-    return {
-      success: false,
-      output: error instanceof Error ? error.message : String(error)
-    };
-  }
-}
-
-// ==================================================================
-// === Source: platform/package-manager ===
-// ==================================================================
-
-function detectInstallMode(argv = process.argv, env = process.env) {
-  const execPath = argv[1] ?? '';
-
-  if (execPath.includes('_npx/') || execPath.includes('_npx\\')) {
-    return 'npx';
-  }
-
-  const npmExecPath = env.npm_execpath ?? '';
-  if (npmExecPath.includes('npx')) {
-    return 'npx';
-  }
-
-  const bunInstall = env.BUN_INSTALL ?? '';
-  if (bunInstall && execPath.startsWith(bunInstall)) {
-    return 'bun-global';
-  }
-  if (execPath.includes('/.bun/') || execPath.includes('\\.bun\\')) {
-    return 'bun-global';
-  }
-
-  const npmGlobalPrefix = env.npm_config_prefix ?? '';
-  if (npmGlobalPrefix && execPath.startsWith(npmGlobalPrefix)) {
-    return 'npm-global';
-  }
-  if (execPath.includes('/lib/node_modules/') || execPath.includes('/node_modules/.bin/')) {
-    return 'npm-global';
-  }
-
-  return 'unknown';
-}
-
 // ==================================================================
 // === Source: platform/archive ===
 // ==================================================================
@@ -4192,97 +4107,6 @@ class SkillHubClient {
   }
 }
 
-// ==================================================================
-// === Source: clients/npm-registry-client ===
-// ==================================================================
-
-const DEFAULT_NPM_REGISTRY = 'https://registry.npmjs.org';
-
-function readEnv(env, name) {
-  const exactValue = env[name]?.trim();
-  if (exactValue) {
-    return exactValue;
-  }
-
-  const lowerName = name.toLowerCase();
-  for (const [key, value] of Object.entries(env)) {
-    const normalizedValue = value?.trim();
-    if (key.toLowerCase() === lowerName && normalizedValue) {
-      return normalizedValue;
-    }
-  }
-  return undefined;
-}
-
-function resolveNpmRegistry(env) {
-  return readEnv(env, 'SKILLHUB_NPM_REGISTRY')
-    ?? readEnv(env, 'npm_config_registry')
-    ?? readEnv(env, 'NPM_CONFIG_REGISTRY')
-    ?? DEFAULT_NPM_REGISTRY;
-}
-
-function buildLatestUrl(registry, packageName) {
-  try {
-    const base = registry.endsWith('/') ? registry : `${registry}/`;
-    return new URL(`${encodeURIComponent(packageName)}/latest`, base).toString();
-  } catch {
-    throw new CliError('invalid npm registry URL', EXIT.usage, {
-      registry,
-      next: 'check npm registry configuration and retry'
-    });
-  }
-}
-
-class NpmRegistryClient {
-  constructor(fetchImpl = fetch, timeoutMs = 10000, env = process.env) {
-    this.fetchImpl = fetchImpl;
-    this.timeoutMs = timeoutMs;
-    this.env = env;
-  }
-
-  async latestVersion(packageName = CLI_PACKAGE_NAME) {
-    const registry = resolveNpmRegistry(this.env);
-    const url = buildLatestUrl(registry, packageName);
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), this.timeoutMs);
-    try {
-      let response;
-      try {
-        response = await this.fetchImpl(url, {
-          signal: controller.signal
-        });
-      } catch (error) {
-        const isTimeout = error instanceof Error && error.name === 'AbortError';
-        throw new CliError('npm registry unreachable', EXIT.network, {
-          registry,
-          cause: error instanceof Error ? error.message : String(error),
-          next: isTimeout
-            ? 'check npm registry connectivity or proxy settings and retry'
-            : 'check npm registry/proxy configuration and retry'
-        });
-      }
-      if (!response.ok) {
-        throw new CliError(`npm registry returned ${response.status}`, EXIT.network, { registry });
-      }
-      let body;
-      try {
-        body = await response.json();
-      } catch (error) {
-        throw new CliError('npm registry response invalid', EXIT.network, {
-          registry,
-          cause: error instanceof Error ? error.message : String(error)
-        });
-      }
-      if (typeof body !== 'object' || body === null || !('version' in body) || typeof body.version !== 'string') {
-        throw new CliError('npm registry response missing version', EXIT.network, { registry });
-      }
-      return body.version;
-    } finally {
-      clearTimeout(timer);
-    }
-  }
-}
-
 // ==================================================================
 // === Source: services/registry-service ===
 // ==================================================================
@@ -4340,7 +4164,7 @@ async function deleteToolkitToken() {
 function requireRegistry(registry) {
   if (!registry) {
     throw new CliError(
-      '未配置 registry。运行: toolkit install claudecode --registry <url>',
+      '未配置 registry。运行: toolkit install --registry <url>',
       EXIT.config
     );
   }
@@ -4529,84 +4353,6 @@ async function removeLocalSkill(options) {
   return { removed };
 }
 
-// ==================================================================
-// === Source: services/update-service ===
-// ==================================================================
-
-class UpdateService {
-  constructor(deps) {
-    this.deps = deps;
-  }
-
-  async update(options) {
-    const current = this.deps.currentVersion;
-    const latest = await this.deps.latestVersion();
-
-    if (!semverGt(latest, current)) {
-      return {
-        updated: false,
-        available: false,
-        currentVersion: current,
-        latestVersion: latest
-      };
-    }
-
-    if (options.checkOnly) {
-      return {
-        updated: false,
-        available: true,
-        currentVersion: current,
-        latestVersion: latest
-      };
-    }
-
-    const mode = this.deps.detectInstallMode();
-
-    switch (mode) {
-      case 'npx':
-        return {
-          updated: false,
-          available: true,
-          currentVersion: current,
-          latestVersion: latest,
-          next: `Run: npx ${CLI_PACKAGE_NAME}@latest <command> or install globally: npm install -g ${CLI_PACKAGE_NAME}`
-        };
-
-      case 'npm-global': {
-        const result = await this.deps.run(['npm', 'install', '-g', `${CLI_PACKAGE_NAME}@latest`]);
-        return {
-          updated: result.success,
-          available: true,
-          currentVersion: current,
-          latestVersion: latest,
-          error: result.success ? undefined : result.output
-        };
-      }
-
-      case 'bun-global': {
-        const result = await this.deps.run(['bun', 'add', '-g', `${CLI_PACKAGE_NAME}@latest`]);
-        return {
-          updated: result.success,
-          available: true,
-          currentVersion: current,
-          latestVersion: latest,
-          error: result.success ? undefined : result.output
-        };
-      }
-
-      case 'unknown':
-      default:
-        return {
-          updated: false,
-          available: true,
-          currentVersion: current,
-          latestVersion: latest,
-          next: `Update manually: npm install -g ${CLI_PACKAGE_NAME}@latest or bun add -g ${CLI_PACKAGE_NAME}@latest`
-        };
-    }
-  }
-}
-
 // ==================================================================
 // === Source: services/doctor-service ===
 // ==================================================================
@@ -5044,11 +4790,6 @@ const commands = {
     summary: 'Publish a local skill package',
     usage: 'skillhub publish <path> [--namespace <slug>] [--visibility <public|namespace-only|private>] [--registry <url>] [--json]',
     examples: ['skillhub publish ./my-skill', 'skillhub publish ./my-skill --namespace myspace']
-  },
-  update: {
-    summary: 'Check or update CLI itself',
-    usage: 'skillhub update [--check] [--json]',
-    examples: ['skillhub update --check', 'skillhub update']
   }
 };
 
@@ -5483,58 +5224,6 @@ function toServerVisibility(visibility) {
   return visibility.toUpperCase().replace(/-/g, '_');
 }
 
-// ==================================================================
-// === Source: commands/update ===
-// ==================================================================
-
-async function updateCommand(options) {
-  const json = Boolean(options.json);
-  const checkOnly = Boolean(options.check);
-
-  const service = new UpdateService({
-    currentVersion: CLI_VERSION,
-    latestVersion: () => new NpmRegistryClient().latestVersion(),
-    detectInstallMode: () => detectInstallMode(),
-    run: runUpdateCommand
-  });
-
-  const result = await service.update({ checkOnly });
-
-  if (!result.available) {
-    return printResult(
-      json
-        ? { ok: true, upToDate: true, version: result.currentVersion }
-        : `Already up to date (${result.currentVersion})`,
-      json
-    );
-  }
-
-  if (result.updated) {
-    return printResult(
-      json
-        ? { ok: true, updated: true, from: result.currentVersion, to: result.latestVersion }
-        : `Updated skillhub ${result.currentVersion} -> ${result.latestVersion}`,
-      json
-    );
-  }
-
-  if (result.error) {
-    throw new CliError(result.error, EXIT.generic, { from: result.currentVersion, to: result.latestVersion });
-  }
-
-  const lines = [`Update available: ${result.currentVersion} -> ${result.latestVersion}`];
-  if (result.next) {
-    lines.push(result.next);
-  }
-
-  return printResult(
-    json
-      ? { ok: true, available: true, from: result.currentVersion, to: result.latestVersion, next: result.next }
-      : lines.join('\n'),
-    json
-  );
-}
-
 // ==================================================================
 // === Source: index (CLI entry point) ===
 // ==================================================================
@@ -5685,10 +5374,6 @@ cli.command('help [command]', 'Show help')
 cli.command('version', 'Show CLI version')
   .option('--json', 'Output JSON');
 
-cli.command('update', 'Update CLI to latest version')
-  .option('--check', 'Check for updates without installing')
-  .option('--json', 'Output JSON');
-
 cli.command('login', 'Save registry and token')
   .option('--registry <url>', 'Registry URL')
   .option('--token <token>', 'API token')
@@ -5756,8 +5441,6 @@ async function dispatchCommand(commandName, args, options) {
       return helpCommand([...args, ...(options.json ? ['--json'] : [])]);
     case 'version':
       return versionCommand(options.json ? ['--json'] : []);
-    case 'update':
-      return updateCommand(options);
     case 'login':
       return loginCommand(options);
     case 'logout':

package/src/status.mjs

@@ -41,7 +41,7 @@ export function collectStatus() {
   lines.push('════════════════════════════════════════');
 
   if (!pluginExists && !configExists) {
-    lines.push('  ❌ 未安装。运行: toolkit install claudecode --registry <url>');
+    lines.push('  ❌ 未安装。运行: toolkit install --registry <url>');
     return lines.join('\n');
   }
 

package/src/zentao.mjs

@@ -327,6 +327,48 @@ export function shapeBugListItem(b) {
   };
 }
 
+// 去除 HTML 标签 + 折叠空白：action.comment/desc 可能含 <p>/<strong>/<br> 等
+function stripHtml(s) {
+  if (!s) return '';
+  return String(s)
+    .replace(/<br\s*\/?\s*>/gi, '\n')
+    .replace(/<\/p>\s*<p[^>]*>/gi, '\n')
+    .replace(/<[^>]+>/g, '')
+    .replace(/&nbsp;/g, ' ')
+    .replace(/&lt;/g, '<')
+    .replace(/&gt;/g, '>')
+    .replace(/&amp;/g, '&')
+    .replace(/[ \t]+\n/g, '\n')
+    .replace(/\n{3,}/g, '\n\n')
+    .trim();
+}
+
+// 历史动作/评论轨迹：原始 actions[] 清洗为精简结构
+//   { actor, action, date, comment, extra, changes: [{ field, fieldName, old, new }] }
+// comment/desc 去标签；history 取字段变更明细；空 comment / 无变更的动作仍保留（动作本身有意义）
+export function shapeActions(actions) {
+  if (!Array.isArray(actions)) return [];
+  return actions
+    .filter((a) => a && typeof a === 'object')
+    .map((a) => ({
+      actor: a.actor ?? '',
+      action: a.action ?? '',
+      date: a.date ?? '',
+      comment: stripHtml(a.comment),
+      extra: a.extra ? stripHtml(String(a.extra)) : '',
+      changes: Array.isArray(a.history)
+        ? a.history
+            .filter((h) => h && typeof h === 'object')
+            .map((h) => ({
+              field: h.field ?? '',
+              fieldName: h.fieldName ?? h.field ?? '',
+              old: h.old ?? '',
+              new: h.new ?? '',
+            }))
+        : [],
+    }));
+}
+
 export function shapeBugDetail(b) {
   return {
     ...shapeBugListItem(b),
@@ -336,6 +378,7 @@ export function shapeBugDetail(b) {
     resolvedDate: b.resolvedDate ?? '', resolvedBuild: b.resolvedBuild ?? '',
     closedBy: userToAccount(b.closedBy), closedDate: b.closedDate ?? '',
     lastEditedBy: userToAccount(b.lastEditedBy), lastEditedDate: b.lastEditedDate ?? '',
+    actions: shapeActions(b.actions),
   };
 }
 
@@ -377,14 +420,26 @@ export function bugListToMarkdown({ total, count, bugs }) {
 
 export function bugDetailToMarkdown(b) {
   const f = (k) => b[k] === '' || b[k] == null ? '-' : b[k];
-  return [
+  const lines = [
     `# Bug #${b.id}: ${b.title}`, '',
     `- **Severity**: ${b.severity} | **Priority**: ${b.priority} | **Status**: ${b.status}`,
     `- **Project**: ${b.projectId} | **Product**: ${b.productId}`,
     `- **OpenedBy**: ${b.openedBy} ${b.openedDate} | **AssignedTo**: ${f('assignedTo')}`,
     `- **Resolution**: ${f('resolution')} by ${f('resolvedBy')} ${f('resolvedDate')}`,
     '', '## Steps', '', b.steps || '(empty)',
-  ].join('\n');
+  ];
+  if (Array.isArray(b.actions) && b.actions.length) {
+    lines.push('', '## History', '');
+    for (const a of b.actions) {
+      const extra = a.extra ? ` → **${a.extra}**` : '';
+      lines.push(`- **${a.actor || '?'}** \`${a.action || '?'}\` _${a.date || '?'}_${extra}`);
+      if (a.comment) lines.push(`  > ${a.comment.replace(/\n/g, '\n  > ')}`);
+      for (const c of a.changes) {
+        lines.push(`  - ${c.fieldName || c.field}: \`${c.old || '∅'}\` → \`${c.new || '∅'}\``);
+      }
+    }
+  }
+  return lines.join('\n');
 }
 
 // HTTP 状态码 -> 统一错误 kind/message