@zshuangmu/agenthub 0.4.7 → 0.4.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zshuangmu/agenthub",
-  "version": "0.4.7",
+  "version": "0.4.9",
   "description": "AI Agent 打包与分发平台 - 一句话打包上传，一键下载获得能力",
   "type": "module",
   "main": "src/index.js",

package/src/cli.js

@@ -28,8 +28,10 @@ import {
   formatVersionsOutput,
   doctorCommand,
 } from "./index.js";
+import { uninstallCommand, formatUninstallOutput } from "./commands/uninstall.js";
 
 import { success, error, warning, info as infoColor, highlight, muted, symbols } from "./lib/colors.js";
+import { setVerbose, debug } from "./lib/debug.js";
 
 import { createRequire } from "node:module";
 const require = createRequire(import.meta.url);
@@ -65,6 +67,7 @@ AgentHub v${VERSION} - AI Agent 打包与分发平台
   search      搜索 Registry 中的 Agent
   info        查看 Agent 详情
   list        列出当前目录/指定目录的已安装 Agent
+  uninstall   卸载已安装的 Agent
   verify      校验已安装 Agent 是否完整可用
   versions    查看 Agent 版本历史
   update      更新已安装 Agent 到最新版
@@ -76,6 +79,7 @@ AgentHub v${VERSION} - AI Agent 打包与分发平台
 选项:
   --help, -h      显示帮助信息
   --version, -v   显示版本号
+  --verbose       显示详细日志信息
 
 详细帮助:
   agenthub <command> --help
@@ -181,6 +185,19 @@ agenthub list - 列出已安装 Agent
   agenthub list --target-workspace ./my-workspace
   agenthub list --json
   agenthub list --target-workspace ./my-workspace
+`,
+    uninstall: `
+agenthub uninstall - 卸载已安装 Agent
+
+用法:
+  agenthub uninstall <agent-slug> [--target-workspace <dir>]
+
+选项:
+  --target-workspace <dir>  指定工作区目录（可选）
+
+示例:
+  agenthub uninstall my-agent
+  agenthub uninstall my-agent --target-workspace ./my-workspace
 `,
     verify: `
 agenthub verify - 校验已安装 Agent
@@ -321,6 +338,12 @@ async function main() {
   const { positionals, options } = parseArgs(process.argv.slice(2));
   const [command, ...rest] = positionals;
 
+  // 设置 verbose 模式
+  if (options.verbose) {
+    setVerbose(true);
+    debug("Verbose mode enabled");
+  }
+
   // 全局选项 - only show version if --version/-v is a boolean flag, not a string value
   if (options.version === true) {
     console.log(`AgentHub v${VERSION}`);
@@ -419,6 +442,13 @@ async function main() {
         return;
       }
 
+      case "uninstall": {
+        if (!requireArg(rest[0], "错误: 需要指定 agent slug")) return;
+        const result = await uninstallCommand(rest[0], options);
+        console.log(formatUninstallOutput(result));
+        return;
+      }
+
       case "verify": {
         const result = await verifyCommand(rest[0], options);
         console.log(formatVerifyOutput(result));

package/src/commands/uninstall.js

@@ -0,0 +1,76 @@
+/**
+ * Uninstall Command
+ * 卸载已安装的 Agent
+ */
+
+import path from "node:path";
+import { pathExists, readJson, writeJson, removeDir } from "../lib/fs-utils.js";
+
+/**
+ * 卸载已安装的 Agent
+ * @param {string} agentSpec - Agent slug 或 slug@version
+ * @param {object} options - 选项
+ * @returns {Promise<object>} 卸载结果
+ */
+export async function uninstallCommand(agentSpec, options = {}) {
+  const { slug } = parseSpec(agentSpec);
+  const targetWorkspace = path.resolve(options.targetWorkspace || process.cwd());
+  const agenthubDir = path.join(targetWorkspace, ".agenthub");
+  const installRecordPath = path.join(agenthubDir, "install.json");
+
+  // 检查安装记录是否存在
+  if (!(await pathExists(installRecordPath))) {
+    throw new Error(`未找到安装记录: ${slug}\n  该 Agent 可能未安装或安装记录已损坏`);
+  }
+
+  // 读取安装记录
+  const installRecord = await readJson(installRecordPath);
+
+  // 检查是否是该 Agent
+  if (installRecord.slug !== slug) {
+    throw new Error(`当前工作区安装的是 ${installRecord.slug}，而非 ${slug}`);
+  }
+
+  // 保存卸载信息
+  const uninstallInfo = {
+    slug: installRecord.slug,
+    version: installRecord.version,
+    installedAt: installRecord.installedAt,
+    uninstalledAt: new Date().toISOString(),
+    location: targetWorkspace,
+  };
+
+  // 删除安装记录
+  await removeDir(agenthubDir);
+
+  return uninstallInfo;
+}
+
+/**
+ * 解析 agent spec
+ */
+function parseSpec(spec) {
+  const match = spec.match(/^([^@]+)(?:@(.+))?$/);
+  if (!match) {
+    throw new Error(`无效的 agent spec: ${spec}`);
+  }
+  return {
+    slug: match[1],
+    version: match[2] || null,
+  };
+}
+
+/**
+ * 格式化卸载输出
+ */
+export function formatUninstallOutput(info) {
+  const lines = [];
+  lines.push("\n🗑️  卸载成功\n");
+  lines.push("─".repeat(50));
+  lines.push(`  Agent:     ${info.slug}@${info.version}`);
+  lines.push(`  安装时间:   ${info.installedAt || "未知"}`);
+  lines.push(`  卸载时间:   ${info.uninstalledAt}`);
+  lines.push("─".repeat(50));
+  lines.push(`\n💡 重新安装: agenthub install ${info.slug}\n`);
+  return lines.join("\n");
+}

package/src/lib/debug.js

@@ -3,7 +3,27 @@
  * 性能日志工具，用于调试和性能分析
  */
 
-const DEBUG = process.env.AGENTHUB_DEBUG === "true" || process.env.AGENTHUB_DEBUG === "1";
+let verboseMode = false;
+
+/**
+ * 设置 verbose 模式
+ * @param {boolean} enabled - 是否启用
+ */
+export function setVerbose(enabled) {
+  verboseMode = enabled;
+  if (enabled) {
+    process.env.AGENTHUB_DEBUG = "true";
+  }
+}
+
+/**
+ * 获取是否处于 debug 模式
+ */
+export function isDebug() {
+  return verboseMode || process.env.AGENTHUB_DEBUG === "true" || process.env.AGENTHUB_DEBUG === "1";
+}
+
+const DEBUG = isDebug();
 
 /**
  * 计时器存储

package/src/lib/fs-utils.js

@@ -1,4 +1,4 @@
-import { cp, mkdir, readdir, readFile, stat, writeFile } from "node:fs/promises";
+import { cp, mkdir, readdir, readFile, rm, stat, writeFile } from "node:fs/promises";
 import path from "node:path";
 
 export async function ensureDir(dirPath) {
@@ -28,6 +28,10 @@ export async function pathExists(targetPath) {
   }
 }
 
+export async function removeDir(dirPath) {
+  await rm(dirPath, { recursive: true, force: true });
+}
+
 export async function countFiles(dirPath) {
   if (!(await pathExists(dirPath))) {
     return 0;