@lyra-ai/toolkit 0.2.6 → 0.2.8

package/QUICKSTART.md

@@ -131,12 +131,6 @@ skillhub install code-review --agent claude-code --agent cursor
 # 查看已安装
 skillhub list --json
 
-# 诊断问题
-skillhub doctor
-
-# 更新技能包
-skillhub update --scope user
-
 # 移除
 skillhub remove code-review --scope user
 ```
@@ -150,14 +144,13 @@ skillhub publish ./my-skill
 ## skillhub 工作流
 
 ```
-login（认证） → search（发现） → install（安装） → list/doctor（管理） → update（更新）
+login（认证） → search（发现） → install（安装） → list（管理）
 ```
 
 - **`login`** 存储 registry token
 - **`search`** 在 registry 搜索技能包
 - **`install`** 下载并安装到指定 scope
 - **`list`** 列出本地已安装技能包
-- **`doctor`** 诊断安装问题（缺失文件、冲突等）
 
 ## skillhub Agent 集成要点
 
@@ -171,7 +164,7 @@ login（认证） → search（发现） → install（安装） → list/doctor
 skillhub login --token "$SKILLHUB_TOKEN"
 skillhub search code-review --json --limit 5
 skillhub install code-review --scope project --agent claude-code
-skillhub doctor --json
+skillhub list --json
 ```
 
 ## skillhub 配置参考

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
 ```
 
 - 会话结束后自动同步，无需手动操作
@@ -106,7 +106,6 @@ cd <本目录> && npm link
 
 AI 技能包管理器：搜索、安装、发布、管理 AI coding agent 技能包。
 
-- `skillhub version [--json]` → 输出版本号
 - `skillhub help [topic]` → 帮助信息（`topic` 为命令名）
 - `skillhub login --token <token> [--registry <url>]` → 登录 registry
 - `skillhub logout` → 清除本地凭证
@@ -115,9 +114,7 @@ AI 技能包管理器：搜索、安装、发布、管理 AI coding agent 技能
 - `skillhub install <slug> [--namespace <ns>] [--agent <profile>] [--scope user|project] [--max-file-size <size>] [--json]` → 安装技能包
 - `skillhub list [--scope user|project] [--json]` → 列出已安装技能包
 - `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.8",
   "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,9 +3385,6 @@ async function promptMultiselect(message, choices) {
 // === Version Info ===
 // ==================================================================
 
-const PKG_NAME = "@astron-team/skillhub";
-const PKG_VERSION = "0.1.8";
-
 // ==================================================================
 // === Source: shared/errors ===
 // ==================================================================
@@ -3416,8 +3403,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 +3599,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 +4104,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 +4161,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
     );
   }
@@ -4440,6 +4261,8 @@ async function installSkill(options) {
       try {
         await rename2(tempDir, skillDir);
       } catch (error) {
+        console.error("安装失败！请检查是否有执行中的" + target.agent);
+        console.error(error);
         if (!options.force && await pathExists(skillDir)) {
           throw new CliError(`skill already installed at ${skillDir}`, EXIT.filesystem, {
             path: skillDir,
@@ -4506,8 +4329,7 @@ async function removeLocalSkill(options) {
   for (const { item, target } of targetsToRemove) {
     if (!target.rootDir || !isPathUnder(target.installDir, target.rootDir)) {
       throw new CliError(`unsafe remove path: ${target.installDir} is not under ${target.rootDir ?? 'unknown root'}`, EXIT.filesystem, {
-        path: target.installDir,
-        next: 'verify inventory integrity with `skillhub doctor`'
+        path: target.installDir
       });
     }
 
@@ -4529,250 +4351,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 ===
-// ==================================================================
-
-import { lstat, readdir as readdir2, writeFile as writeFile6, readFile as readFile5 } from 'node:fs/promises';
-import { join as join4 } from 'node:path';
-
-async function runDoctor(cwd, home) {
-  const store = new InventoryStore(home);
-  const skipped = [];
-  const conflicts = [];
-
-  const entries = await scanMetadata(cwd, skipped);
-
-  const groups = new Map();
-  for (const entry of entries) {
-    const key = `${entry.metadata.registry}|${entry.metadata.namespace}|${entry.metadata.slug}`;
-    if (!groups.has(key)) groups.set(key, []);
-    groups.get(key).push(entry);
-  }
-
-  const scannedItems = [];
-  for (const [key, group] of groups) {
-    const versions = new Set(group.map(e => e.metadata.version));
-    if (versions.size > 1) {
-      conflicts.push({ key, versions: [...versions] });
-      continue;
-    }
-    const first = group[0];
-    const targets = group.map(e => ({
-      agent: e.metadata.agent,
-      rootDir: join4(e.installDir, '..'),
-      installDir: e.installDir,
-      installedAt: e.metadata.installedAt
-    }));
-    scannedItems.push({
-      registry: first.metadata.registry,
-      namespace: first.metadata.namespace,
-      slug: first.metadata.slug,
-      version: first.metadata.version,
-      targets
-    });
-  }
-
-  let oldInventory;
-  try {
-    oldInventory = await store.read();
-  } catch {
-    oldInventory = { items: [] };
-  }
-
-  const scannedInstallDirs = new Set();
-  for (const item of scannedItems) {
-    for (const target of item.targets) {
-      scannedInstallDirs.add(target.installDir);
-    }
-  }
-
-  const preservedItems = [];
-  for (const oldItem of oldInventory.items) {
-    const preservedTargets = oldItem.targets.filter(t => !scannedInstallDirs.has(t.installDir));
-    if (preservedTargets.length > 0) {
-      preservedItems.push({
-        ...oldItem,
-        targets: preservedTargets
-      });
-    }
-  }
-
-  const items = [...scannedItems, ...preservedItems];
-
-  let backupPath = null;
-  try {
-    const oldContent = await readFile5(store.path, 'utf-8');
-    backupPath = `${store.path}.bak`;
-    await writeFile6(backupPath, oldContent);
-  } catch {
-  }
-
-  const newInventory = { items };
-  await store.writeAtomic(newInventory);
-
-  return {
-    inventoryPath: store.path,
-    backupPath,
-    itemsScanned: scannedItems.length,
-    targetsScanned: scannedItems.reduce((sum, item) => sum + item.targets.length, 0),
-    itemsPreserved: preservedItems.length,
-    targetsPreserved: preservedItems.reduce((sum, item) => sum + item.targets.length, 0),
-    skipped,
-    conflicts
-  };
-}
-
-async function scanMetadata(cwd, skipped) {
-  const results = [];
-
-  let topEntries;
-  try {
-    topEntries = await readdir2(cwd);
-  } catch {
-    throw new CliError('cannot read project directory', EXIT.filesystem, { path: cwd });
-  }
-
-  for (const dirName of topEntries) {
-    if (!dirName.startsWith('.')) continue;
-    const agentDir = join4(cwd, dirName);
-    try {
-      const st = await lstat(agentDir);
-      if (st.isSymbolicLink() || !st.isDirectory()) {
-        skipped.push({ path: agentDir, reason: 'not a regular directory' });
-        continue;
-      }
-    } catch {
-      skipped.push({ path: agentDir, reason: 'cannot stat' });
-      continue;
-    }
-    const skillsDir = join4(agentDir, 'skills');
-    let slugDirs;
-    try {
-      slugDirs = await readdir2(skillsDir);
-    } catch {
-      continue;
-    }
-
-    for (const slug of slugDirs) {
-      const slugPath = join4(skillsDir, slug);
-      try {
-        const st = await lstat(slugPath);
-        if (st.isSymbolicLink() || !st.isDirectory()) {
-          skipped.push({ path: slugPath, reason: 'not a regular directory' });
-          continue;
-        }
-      } catch {
-        skipped.push({ path: slugPath, reason: 'cannot stat' });
-        continue;
-      }
-      const skillhubDir = join4(slugPath, '.skillhub');
-      try {
-        const skillhubSt = await lstat(skillhubDir);
-        if (skillhubSt.isSymbolicLink() || !skillhubSt.isDirectory()) {
-          skipped.push({ path: slugPath, reason: '.skillhub is not a regular directory' });
-          continue;
-        }
-      } catch {
-        skipped.push({ path: slugPath, reason: 'no .skillhub directory' });
-        continue;
-      }
-      const metadataPath = join4(skillhubDir, 'metadata.json');
-      try {
-        const content = await readFile5(metadataPath, 'utf-8');
-        const metadata = JSON.parse(content);
-        if (!metadata.registry || !metadata.namespace || !metadata.slug || !metadata.version || !metadata.agent || !metadata.installedAt) {
-          skipped.push({ path: slugPath, reason: 'incomplete metadata' });
-          continue;
-        }
-        results.push({ metadata, installDir: slugPath });
-      } catch {
-        skipped.push({ path: slugPath, reason: 'no .skillhub/metadata.json' });
-      }
-    }
-  }
-
-  return results;
-}
-
 // ==================================================================
 // === Source: agents/profiles/make-profile ===
 // ==================================================================
@@ -4819,6 +4397,7 @@ const traeProfile = makeProfile('trae', 'Trae', '.trae/skills', '.trae/skills');
 const traeCnProfile = makeProfile('trae-cn', 'Trae CN', '.trae-cn/skills', '.trae-cn/skills');
 const opencodeProfile = makeProfile('opencode', 'OpenCode', '.opencode/skills', '.opencode/skills');
 const kiloProfile = makeProfile('kilo', 'Kilo', '.kilo/skills', '.kilo/skills');
+const qoderProfile = makeProfile('qoder', 'qoder', '.qoder/skills', '.qoder/skills');
 const genericFallbackProfile = makeProfile('generic', 'Generic Fallback', '.agents/skills', '.agents/skills');
 
 // ==================================================================
@@ -4829,7 +4408,7 @@ const allProfiles = [
   claudeCodeProfile, codexProfile, cursorProfile, githubCopilotProfile,
   geminiCliProfile, openhandsProfile, windsurfProfile, openclawProfile,
   kiroCliProfile, rooProfile, traeProfile, traeCnProfile,
-  opencodeProfile, kiloProfile
+  opencodeProfile, kiloProfile, qoderProfile
 ];
 
 const profileMap = new Map(allProfiles.map(p => [p.id, p]));
@@ -4991,11 +4570,6 @@ const commands = {
     usage: 'skillhub help [command] [--json]',
     examples: ['skillhub help', 'skillhub help install', 'skillhub help --json']
   },
-  version: {
-    summary: 'Show installed CLI version',
-    usage: 'skillhub version [--json]',
-    examples: ['skillhub version', 'skillhub version --json']
-  },
   login: {
     summary: 'Save registry and token',
     usage: 'skillhub login [--token <token>] [--registry <url>] [--json]',
@@ -5035,20 +4609,10 @@ const commands = {
     usage: 'skillhub remove <slug> [--agent <profile>] [--all] [--remote] [--hard] [--namespace <slug>] [--json]',
     examples: ['skillhub remove pdf-parser', 'skillhub remove pdf-parser --remote --hard']
   },
-  doctor: {
-    summary: 'Scan project and merge into local inventory (preserves entries outside scan scope)',
-    usage: 'skillhub doctor [--json]',
-    examples: ['skillhub doctor', 'skillhub doctor --json']
-  },
   publish: {
     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']
   }
 };
 
@@ -5081,15 +4645,6 @@ async function helpCommand(args) {
   return formatCommandList();
 }
 
-// ==================================================================
-// === Source: commands/version ===
-// ==================================================================
-
-async function versionCommand(args) {
-  const json = args.includes('--json');
-  return printResult(json ? { ok: true, version: CLI_VERSION } : `SkillHub CLI ${CLI_VERSION}`, json);
-}
-
 // ==================================================================
 // === Source: commands/login ===
 // ==================================================================
@@ -5343,38 +4898,6 @@ async function removeCommand(skillNameArg, options) {
   ).join('\n');
 }
 
-// ==================================================================
-// === Source: commands/doctor ===
-// ==================================================================
-
-async function doctorCommand(options) {
-  const result = await runDoctor(process.cwd());
-  if (options.json) {
-    return JSON.stringify({
-      ok: true,
-      inventoryPath: result.inventoryPath,
-      backupPath: result.backupPath,
-      itemsScanned: result.itemsScanned,
-      targetsScanned: result.targetsScanned,
-      itemsPreserved: result.itemsPreserved,
-      targetsPreserved: result.targetsPreserved,
-      skipped: result.skipped,
-      conflicts: result.conflicts
-    });
-  }
-  const lines = [
-    `Inventory: ${result.inventoryPath}`,
-    result.backupPath ? `Backup: ${result.backupPath}` : null,
-    `Scanned: ${result.itemsScanned} items, ${result.targetsScanned} targets`,
-    result.itemsPreserved > 0
-      ? `Preserved (outside scan): ${result.itemsPreserved} items, ${result.targetsPreserved} targets`
-      : null,
-    result.skipped.length > 0 ? `Skipped: ${result.skipped.length} directories` : null,
-    result.conflicts.length > 0 ? `Conflicts: ${result.conflicts.length} groups` : null
-  ].filter(Boolean);
-  return lines.join('\n');
-}
-
 // ==================================================================
 // === Source: commands/publish ===
 // ==================================================================
@@ -5483,58 +5006,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) ===
 // ==================================================================
@@ -5682,13 +5153,6 @@ function readUnknownCommand(argv) {
 cli.command('help [command]', 'Show help')
   .option('--json', 'Output JSON');
 
-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')
@@ -5737,9 +5201,6 @@ cli.command('remove <slug>', 'Remove local or remote skill')
   .option('--token <token>', 'API token')
   .option('--json', 'Output JSON');
 
-cli.command('doctor', 'Scan project and merge into local inventory')
-  .option('--json', 'Output JSON');
-
 cli.command('publish <path>', 'Publish a local skill package')
   .option('--namespace <slug>', 'Namespace')
   .option('--visibility <v>', 'Visibility (public|namespace-only|private)')
@@ -5754,10 +5215,6 @@ async function dispatchCommand(commandName, args, options) {
   switch (commandName) {
     case 'help':
       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':
@@ -5772,8 +5229,6 @@ async function dispatchCommand(commandName, args, options) {
       return listCommand({ ...options, agent: toArray(options.agent) });
     case 'remove':
       return removeCommand(args[0], { ...options, agent: toArray(options.agent) });
-    case 'doctor':
-      return doctorCommand(options);
     case 'publish':
       return publishCommand(args[0], options);
     default:

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