agent-resource-management 1.4.1 → 1.5.0

package/dist/main.js

@@ -504,6 +504,27 @@ async function getCurrentUser() {
   }
 }
 
+// src/lib/output.ts
+function outputJson(result) {
+  console.log(JSON.stringify(result, null, 2));
+}
+function shouldOutputJson() {
+  if (process.argv.includes("--json") || process.argv.includes("-j")) {
+    return true;
+  }
+  const config = loadConfig();
+  return config.outputMode !== "text";
+}
+function getOutputMode() {
+  const config = loadConfig();
+  return config.outputMode || "json";
+}
+function setOutputMode(mode) {
+  const config = loadConfig() || {};
+  config.outputMode = mode;
+  saveConfig(config);
+}
+
 // src/lib/validate.ts
 import { readFileSync as readFileSync2, existsSync as existsSync2, statSync } from "fs";
 import { execSync } from "child_process";
@@ -684,12 +705,20 @@ import { mkdtempSync as mkdtempSync2, rmSync as rmSync2 } from "fs";
 async function listSkills() {
   const config = loadConfig();
   if (!config?.token) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "NOT_LOGGED_IN", message: "未登录，请先运行 arm login" } });
+      process.exit(1);
+    }
     error("未登录，请先运行 arm login");
     process.exit(1);
   }
   const client = new ApiClient(config.serverUrl, config.token);
   try {
     const result = await client.listSkills();
+    if (shouldOutputJson()) {
+      outputJson({ success: true, data: result });
+      return;
+    }
     if (result.skills.length === 0) {
       info("暂无 Skill");
       return;
@@ -702,6 +731,10 @@ async function listSkills() {
       console.log("");
     }
   } catch (err) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "LIST_FAILED", message: err instanceof Error ? err.message : "未知错误" } });
+      process.exit(1);
+    }
     error(`获取列表失败: ${err instanceof Error ? err.message : "未知错误"}`);
     process.exit(1);
   }
@@ -709,12 +742,20 @@ async function listSkills() {
 async function searchSkills(keyword) {
   const config = loadConfig();
   if (!config?.token) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "NOT_LOGGED_IN", message: "未登录，请先运行 arm login" } });
+      process.exit(1);
+    }
     error("未登录，请先运行 arm login");
     process.exit(1);
   }
   const client = new ApiClient(config.serverUrl, config.token);
   try {
     const result = await client.listSkills(keyword);
+    if (shouldOutputJson()) {
+      outputJson({ success: true, data: result });
+      return;
+    }
     if (result.skills.length === 0) {
       info(`没有找到包含 "${keyword}" 的 Skill`);
       return;
@@ -727,6 +768,10 @@ async function searchSkills(keyword) {
       console.log("");
     }
   } catch (err) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "SEARCH_FAILED", message: err instanceof Error ? err.message : "未知错误" } });
+      process.exit(1);
+    }
     error(`搜索失败: ${err instanceof Error ? err.message : "未知错误"}`);
     process.exit(1);
   }
@@ -734,14 +779,26 @@ async function searchSkills(keyword) {
 async function infoSkill(name) {
   const config = loadConfig();
   if (!config?.token) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "NOT_LOGGED_IN", message: "未登录，请先运行 arm login" } });
+      process.exit(1);
+    }
     error("未登录，请先运行 arm login");
     process.exit(1);
   }
   const client = new ApiClient(config.serverUrl, config.token);
   try {
     const skill = await client.getSkill(name);
+    if (shouldOutputJson()) {
+      outputJson({ success: true, data: skill });
+      return;
+    }
     console.log(formatSkillDetail(skill));
   } catch (err) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "INFO_FAILED", message: err instanceof Error ? err.message : "未知错误" } });
+      process.exit(1);
+    }
     error(`获取详情失败: ${err instanceof Error ? err.message : "未知错误"}`);
     process.exit(1);
   }
@@ -749,17 +806,31 @@ async function infoSkill(name) {
 async function downloadSkill(name, outputDir) {
   const config = loadConfig();
   if (!config?.token) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "NOT_LOGGED_IN", message: "未登录，请先运行 arm login" } });
+      process.exit(1);
+    }
     error("未登录，请先运行 arm login");
     process.exit(1);
   }
   const client = new ApiClient(config.serverUrl, config.token);
   try {
-    info(`正在下载 ${name}...`);
+    if (shouldOutputJson()) {
+      info(`正在下载 ${name}...`);
+    }
     const buffer = await client.downloadSkill(name);
     const outputPath = join3(outputDir || ".", `${name}.zip`);
     writeFileSync2(outputPath, Buffer.from(buffer));
+    if (shouldOutputJson()) {
+      outputJson({ success: true, data: { path: outputPath } });
+      return;
+    }
     success(`已下载到 ${outputPath}`);
   } catch (err) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "DOWNLOAD_FAILED", message: err instanceof Error ? err.message : "未知错误" } });
+      process.exit(1);
+    }
     error(`下载失败: ${err instanceof Error ? err.message : "未知错误"}`);
     process.exit(1);
   }
@@ -767,16 +838,28 @@ async function downloadSkill(name, outputDir) {
 async function uploadSkill(filePath) {
   const config = loadConfig();
   if (!config?.token) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "NOT_LOGGED_IN", message: "未登录，请先运行 arm login" } });
+      process.exit(1);
+    }
     error("未登录，请先运行 arm login");
     process.exit(1);
   }
   if (!existsSync3(filePath)) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "FILE_NOT_FOUND", message: `上传失败: 目录不存在: ${filePath}` } });
+      process.exit(1);
+    }
     error(`上传失败: 目录不存在: ${filePath}`);
     process.exit(1);
   }
   const isZip = filePath.toLowerCase().endsWith(".zip");
   const validation = isZip ? validateZip(filePath) : validateSkillDir(filePath);
   if (!validation.valid) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "VALIDATION_FAILED", message: validation.errors.join(", ") } });
+      process.exit(1);
+    }
     error(`上传失败: ${validation.errors.join(", ")}`);
     process.exit(1);
   }
@@ -790,11 +873,21 @@ async function uploadSkill(filePath) {
       execSync2(`cd "${dirname(filePath)}" && zip -r "${zipPath}" "${basename(filePath)}" -x ".*"`, { stdio: "pipe" });
     }
     const client = new ApiClient(config.serverUrl, config.token);
-    info(`正在上传 ${filePath}...`);
+    if (shouldOutputJson()) {
+      info(`正在上传 ${filePath}...`);
+    }
     const skill = await client.uploadSkill(zipPath);
+    if (shouldOutputJson()) {
+      outputJson({ success: true, data: skill });
+      return;
+    }
     success(`上传成功! Skill: ${skill.name}`);
   } catch (err) {
     console.error("DEBUG upload error:", err);
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "UPLOAD_FAILED", message: err instanceof Error ? err.message : "未知错误" } });
+      process.exit(1);
+    }
     error(`上传失败: ${err instanceof Error ? err.message : "未知错误"}`);
     process.exit(1);
   } finally {
@@ -804,12 +897,20 @@ async function uploadSkill(filePath) {
 async function mySkills() {
   const config = loadConfig();
   if (!config?.token) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "NOT_LOGGED_IN", message: "未登录，请先运行 arm login" } });
+      process.exit(1);
+    }
     error("未登录，请先运行 arm login");
     process.exit(1);
   }
   const client = new ApiClient(config.serverUrl, config.token);
   try {
     const skills = await client.getMySkills();
+    if (shouldOutputJson()) {
+      outputJson({ success: true, data: skills });
+      return;
+    }
     if (skills.length === 0) {
       info("您还没有发布任何 Skill");
       return;
@@ -822,6 +923,10 @@ async function mySkills() {
       console.log("");
     }
   } catch (err) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "LIST_FAILED", message: err instanceof Error ? err.message : "未知错误" } });
+      process.exit(1);
+    }
     error(`获取列表失败: ${err instanceof Error ? err.message : "未知错误"}`);
     process.exit(1);
   }
@@ -829,14 +934,26 @@ async function mySkills() {
 async function deleteSkill(name) {
   const config = loadConfig();
   if (!config?.token) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "NOT_LOGGED_IN", message: "未登录，请先运行 arm login" } });
+      process.exit(1);
+    }
     error("未登录，请先运行 arm login");
     process.exit(1);
   }
   const client = new ApiClient(config.serverUrl, config.token);
   try {
     await client.deleteSkill(name);
+    if (shouldOutputJson()) {
+      outputJson({ success: true, data: { name } });
+      return;
+    }
     success(`已删除 ${name}`);
   } catch (err) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "DELETE_FAILED", message: err instanceof Error ? err.message : "未知错误" } });
+      process.exit(1);
+    }
     error(`删除失败: ${err instanceof Error ? err.message : "未知错误"}`);
     process.exit(1);
   }
@@ -844,6 +961,21 @@ async function deleteSkill(name) {
 async function validateSkill(filePath) {
   const isDir = existsSync3(filePath) && statSync2(filePath).isDirectory();
   const result = isDir ? validateSkillDir(filePath) : validateZip(filePath);
+  if (shouldOutputJson()) {
+    outputJson({
+      success: result.valid,
+      data: {
+        valid: result.valid,
+        errors: result.errors,
+        warnings: result.warnings,
+        metadata: result.metadata
+      }
+    });
+    if (!result.valid) {
+      process.exit(1);
+    }
+    return;
+  }
   if (result.valid) {
     success("验证通过!");
   } else {
@@ -887,16 +1019,10 @@ import { writeFileSync as writeFileSync3, existsSync as existsSync4 } from "fs";
 import { join as join4 } from "path";
 import { execSync as execSync3 } from "child_process";
 import { mkdtempSync as mkdtempSync3, rmSync as rmSync3 } from "fs";
-function outputJson(result) {
-  console.log(JSON.stringify(result, null, 2));
-}
-function getJsonFlag() {
-  return process.argv.includes("--json") || process.argv.includes("-j");
-}
 async function createAgent(name, options = {}) {
   const config = loadConfig();
   if (!config?.token) {
-    if (getJsonFlag()) {
+    if (shouldOutputJson()) {
       outputJson({ success: false, error: { code: "NOT_LOGGED_IN", message: "未登录，请先运行 arm login" } });
       process.exit(1);
     }
@@ -921,13 +1047,13 @@ async function createAgent(name, options = {}) {
       skills,
       knowledges
     });
-    if (getJsonFlag()) {
+    if (shouldOutputJson()) {
       outputJson({ success: true, data: result });
       return;
     }
     success(`Agent "${name}" 创建成功 (ID: ${result.id})`);
   } catch (err) {
-    if (getJsonFlag()) {
+    if (shouldOutputJson()) {
       outputJson({ success: false, error: { code: "CREATE_FAILED", message: err instanceof Error ? err.message : "未知错误" } });
       process.exit(1);
     }
@@ -938,7 +1064,7 @@ async function createAgent(name, options = {}) {
 async function updateAgent(id, options = {}) {
   const config = loadConfig();
   if (!config?.token) {
-    if (getJsonFlag()) {
+    if (shouldOutputJson()) {
       outputJson({ success: false, error: { code: "NOT_LOGGED_IN", message: "未登录，请先运行 arm login" } });
       process.exit(1);
     }
@@ -959,13 +1085,13 @@ async function updateAgent(id, options = {}) {
     if (options.status !== undefined)
       updateData.status = options.status;
     const result = await client.updateAgent(id, updateData);
-    if (getJsonFlag()) {
+    if (shouldOutputJson()) {
       outputJson({ success: true, data: result });
       return;
     }
     success(`Agent "${id}" 更新成功`);
   } catch (err) {
-    if (getJsonFlag()) {
+    if (shouldOutputJson()) {
       outputJson({ success: false, error: { code: "UPDATE_FAILED", message: err instanceof Error ? err.message : "未知错误" } });
       process.exit(1);
     }
@@ -976,7 +1102,7 @@ async function updateAgent(id, options = {}) {
 async function deleteAgent(id) {
   const config = loadConfig();
   if (!config?.token) {
-    if (getJsonFlag()) {
+    if (shouldOutputJson()) {
       outputJson({ success: false, error: { code: "NOT_LOGGED_IN", message: "未登录，请先运行 arm login" } });
       process.exit(1);
     }
@@ -986,13 +1112,13 @@ async function deleteAgent(id) {
   const client = new ApiClient(config.serverUrl, config.token);
   try {
     await client.deleteAgent(id);
-    if (getJsonFlag()) {
+    if (shouldOutputJson()) {
       outputJson({ success: true, data: { id } });
       return;
     }
     success(`Agent "${id}" 删除成功`);
   } catch (err) {
-    if (getJsonFlag()) {
+    if (shouldOutputJson()) {
       outputJson({ success: false, error: { code: "DELETE_FAILED", message: err instanceof Error ? err.message : "未知错误" } });
       process.exit(1);
     }
@@ -1003,7 +1129,7 @@ async function deleteAgent(id) {
 async function bindSkill(id, skillId, config) {
   const configStore = loadConfig();
   if (!configStore?.token) {
-    if (getJsonFlag()) {
+    if (shouldOutputJson()) {
       outputJson({ success: false, error: { code: "NOT_LOGGED_IN", message: "未登录，请先运行 arm login" } });
       process.exit(1);
     }
@@ -1014,13 +1140,13 @@ async function bindSkill(id, skillId, config) {
   try {
     const parsedConfig = config ? JSON.parse(config) : undefined;
     await client.bindSkillToAgent(id, skillId, parsedConfig);
-    if (getJsonFlag()) {
+    if (shouldOutputJson()) {
       outputJson({ success: true, data: { agentId: id, skillId, config: parsedConfig } });
       return;
     }
     success(`Skill "${skillId}" 已绑定到 Agent "${id}"`);
   } catch (err) {
-    if (getJsonFlag()) {
+    if (shouldOutputJson()) {
       outputJson({ success: false, error: { code: "BIND_FAILED", message: err instanceof Error ? err.message : "未知错误" } });
       process.exit(1);
     }
@@ -1031,7 +1157,7 @@ async function bindSkill(id, skillId, config) {
 async function unbindSkill(id, skillId) {
   const config = loadConfig();
   if (!config?.token) {
-    if (getJsonFlag()) {
+    if (shouldOutputJson()) {
       outputJson({ success: false, error: { code: "NOT_LOGGED_IN", message: "未登录，请先运行 arm login" } });
       process.exit(1);
     }
@@ -1041,13 +1167,13 @@ async function unbindSkill(id, skillId) {
   const client = new ApiClient(config.serverUrl, config.token);
   try {
     await client.unbindSkillFromAgent(id, skillId);
-    if (getJsonFlag()) {
+    if (shouldOutputJson()) {
       outputJson({ success: true, data: { agentId: id, skillId } });
       return;
     }
     success(`Skill "${skillId}" 已从 Agent "${id}" 解绑`);
   } catch (err) {
-    if (getJsonFlag()) {
+    if (shouldOutputJson()) {
       outputJson({ success: false, error: { code: "UNBIND_FAILED", message: err instanceof Error ? err.message : "未知错误" } });
       process.exit(1);
     }
@@ -1058,7 +1184,7 @@ async function unbindSkill(id, skillId) {
 async function bindKnowledge(id, knowledgeId, retrievalConfig) {
   const configStore = loadConfig();
   if (!configStore?.token) {
-    if (getJsonFlag()) {
+    if (shouldOutputJson()) {
       outputJson({ success: false, error: { code: "NOT_LOGGED_IN", message: "未登录，请先运行 arm login" } });
       process.exit(1);
     }
@@ -1069,13 +1195,13 @@ async function bindKnowledge(id, knowledgeId, retrievalConfig) {
   try {
     const parsedConfig = retrievalConfig ? JSON.parse(retrievalConfig) : undefined;
     await client.bindKnowledgeToAgent(id, knowledgeId, parsedConfig);
-    if (getJsonFlag()) {
+    if (shouldOutputJson()) {
       outputJson({ success: true, data: { agentId: id, knowledgeId, retrievalConfig: parsedConfig } });
       return;
     }
     success(`Knowledge "${knowledgeId}" 已绑定到 Agent "${id}"`);
   } catch (err) {
-    if (getJsonFlag()) {
+    if (shouldOutputJson()) {
       outputJson({ success: false, error: { code: "BIND_FAILED", message: err instanceof Error ? err.message : "未知错误" } });
       process.exit(1);
     }
@@ -1086,7 +1212,7 @@ async function bindKnowledge(id, knowledgeId, retrievalConfig) {
 async function unbindKnowledge(id, knowledgeId) {
   const config = loadConfig();
   if (!config?.token) {
-    if (getJsonFlag()) {
+    if (shouldOutputJson()) {
       outputJson({ success: false, error: { code: "NOT_LOGGED_IN", message: "未登录，请先运行 arm login" } });
       process.exit(1);
     }
@@ -1096,13 +1222,13 @@ async function unbindKnowledge(id, knowledgeId) {
   const client = new ApiClient(config.serverUrl, config.token);
   try {
     await client.unbindKnowledgeFromAgent(id, knowledgeId);
-    if (getJsonFlag()) {
+    if (shouldOutputJson()) {
       outputJson({ success: true, data: { agentId: id, knowledgeId } });
       return;
     }
     success(`Knowledge "${knowledgeId}" 已从 Agent "${id}" 解绑`);
   } catch (err) {
-    if (getJsonFlag()) {
+    if (shouldOutputJson()) {
       outputJson({ success: false, error: { code: "UNBIND_FAILED", message: err instanceof Error ? err.message : "未知错误" } });
       process.exit(1);
     }
@@ -1113,12 +1239,20 @@ async function unbindKnowledge(id, knowledgeId) {
 async function listAgents() {
   const config = loadConfig();
   if (!config?.token) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "NOT_LOGGED_IN", message: "未登录，请先运行 arm login" } });
+      process.exit(1);
+    }
     error("未登录，请先运行 arm login");
     process.exit(1);
   }
   const client = new ApiClient(config.serverUrl, config.token);
   try {
     const result = await client.listAgents();
+    if (shouldOutputJson()) {
+      outputJson({ success: true, data: result });
+      return;
+    }
     if (result.agents.length === 0) {
       info("暂无 Agent");
       return;
@@ -1131,6 +1265,10 @@ async function listAgents() {
       console.log("");
     }
   } catch (err) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "LIST_FAILED", message: err instanceof Error ? err.message : "未知错误" } });
+      process.exit(1);
+    }
     error(`获取列表失败: ${err instanceof Error ? err.message : "未知错误"}`);
     process.exit(1);
   }
@@ -1138,12 +1276,20 @@ async function listAgents() {
 async function searchAgents(keyword) {
   const config = loadConfig();
   if (!config?.token) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "NOT_LOGGED_IN", message: "未登录，请先运行 arm login" } });
+      process.exit(1);
+    }
     error("未登录，请先运行 arm login");
     process.exit(1);
   }
   const client = new ApiClient(config.serverUrl, config.token);
   try {
     const result = await client.listAgents(keyword);
+    if (shouldOutputJson()) {
+      outputJson({ success: true, data: result });
+      return;
+    }
     if (result.agents.length === 0) {
       info(`没有找到包含 "${keyword}" 的 Agent`);
       return;
@@ -1156,6 +1302,10 @@ async function searchAgents(keyword) {
       console.log("");
     }
   } catch (err) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "SEARCH_FAILED", message: err instanceof Error ? err.message : "未知错误" } });
+      process.exit(1);
+    }
     error(`搜索失败: ${err instanceof Error ? err.message : "未知错误"}`);
     process.exit(1);
   }
@@ -1163,6 +1313,10 @@ async function searchAgents(keyword) {
 async function infoAgent(name) {
   const config = loadConfig();
   if (!config?.token) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "NOT_LOGGED_IN", message: "未登录，请先运行 arm login" } });
+      process.exit(1);
+    }
     error("未登录，请先运行 arm login");
     process.exit(1);
   }
@@ -1171,6 +1325,10 @@ async function infoAgent(name) {
     const result = await client.listAgents(name);
     const agent = result.agents.find((a) => a.name === name);
     if (!agent) {
+      if (shouldOutputJson()) {
+        outputJson({ success: false, error: { code: "NOT_FOUND", message: `Agent "${name}" 不存在` } });
+        process.exit(1);
+      }
       error(`Agent "${name}" 不存在`);
       process.exit(1);
     }
@@ -1186,8 +1344,16 @@ async function infoAgent(name) {
       });
       fullAgent.knowledges = await Promise.all(knowledgeNamePromises);
     }
+    if (shouldOutputJson()) {
+      outputJson({ success: true, data: fullAgent });
+      return;
+    }
     console.log(formatAgentDetail(fullAgent));
   } catch (err) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "INFO_FAILED", message: err instanceof Error ? err.message : "未知错误" } });
+      process.exit(1);
+    }
     error(`获取详情失败: ${err instanceof Error ? err.message : "未知错误"}`);
     process.exit(1);
   }
@@ -1195,6 +1361,10 @@ async function infoAgent(name) {
 async function downloadAgent(name, outputDir) {
   const config = loadConfig();
   if (!config?.token) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "NOT_LOGGED_IN", message: "未登录，请先运行 arm login" } });
+      process.exit(1);
+    }
     error("未登录，请先运行 arm login");
     process.exit(1);
   }
@@ -1203,10 +1373,16 @@ async function downloadAgent(name, outputDir) {
     const result = await client.listAgents(name);
     const agent = result.agents.find((a) => a.name === name);
     if (!agent) {
+      if (shouldOutputJson()) {
+        outputJson({ success: false, error: { code: "NOT_FOUND", message: `Agent "${name}" 不存在` } });
+        process.exit(1);
+      }
       error(`Agent "${name}" 不存在`);
       process.exit(1);
     }
-    info(`正在下载 ${name}...`);
+    if (shouldOutputJson()) {
+      info(`正在下载 ${name}...`);
+    }
     const { buffer, version } = await client.downloadAgent(agent.id);
     const tempDir = mkdtempSync3("/tmp/agent-download-");
     const zipPath = join4(tempDir, `${name}.zip`);
@@ -1221,8 +1397,16 @@ async function downloadAgent(name, outputDir) {
       execSync3(`cp -r "${tempDir}"/* "${targetDir}/"`, { stdio: "pipe" });
     }
     rmSync3(tempDir, { recursive: true, force: true });
+    if (shouldOutputJson()) {
+      outputJson({ success: true, data: { path: targetDir, version } });
+      return;
+    }
     success(`已下载到 ${targetDir} (版本: ${version})`);
   } catch (err) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "DOWNLOAD_FAILED", message: err instanceof Error ? err.message : "未知错误" } });
+      process.exit(1);
+    }
     error(`下载失败: ${err instanceof Error ? err.message : "未知错误"}`);
     process.exit(1);
   }
@@ -1236,12 +1420,20 @@ import { mkdtempSync as mkdtempSync4, rmSync as rmSync4 } from "fs";
 async function listKnowledge() {
   const config = loadConfig();
   if (!config?.token) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "NOT_LOGGED_IN", message: "未登录，请先运行 arm login" } });
+      process.exit(1);
+    }
     error("未登录，请先运行 arm login");
     process.exit(1);
   }
   const client = new ApiClient(config.serverUrl, config.token);
   try {
     const result = await client.listKnowledge();
+    if (shouldOutputJson()) {
+      outputJson({ success: true, data: result });
+      return;
+    }
     if (result.knowledges.length === 0) {
       info("暂无 Knowledge");
       return;
@@ -1254,6 +1446,10 @@ async function listKnowledge() {
       console.log("");
     }
   } catch (err) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "LIST_FAILED", message: err instanceof Error ? err.message : "未知错误" } });
+      process.exit(1);
+    }
     error(`获取列表失败: ${err instanceof Error ? err.message : "未知错误"}`);
     process.exit(1);
   }
@@ -1261,12 +1457,20 @@ async function listKnowledge() {
 async function searchKnowledge(keyword) {
   const config = loadConfig();
   if (!config?.token) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "NOT_LOGGED_IN", message: "未登录，请先运行 arm login" } });
+      process.exit(1);
+    }
     error("未登录，请先运行 arm login");
     process.exit(1);
   }
   const client = new ApiClient(config.serverUrl, config.token);
   try {
     const result = await client.listKnowledge(keyword);
+    if (shouldOutputJson()) {
+      outputJson({ success: true, data: result });
+      return;
+    }
     if (result.knowledges.length === 0) {
       info(`没有找到包含 "${keyword}" 的 Knowledge`);
       return;
@@ -1279,6 +1483,10 @@ async function searchKnowledge(keyword) {
       console.log("");
     }
   } catch (err) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "SEARCH_FAILED", message: err instanceof Error ? err.message : "未知错误" } });
+      process.exit(1);
+    }
     error(`搜索失败: ${err instanceof Error ? err.message : "未知错误"}`);
     process.exit(1);
   }
@@ -1286,14 +1494,26 @@ async function searchKnowledge(keyword) {
 async function infoKnowledge(name) {
   const config = loadConfig();
   if (!config?.token) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "NOT_LOGGED_IN", message: "未登录，请先运行 arm login" } });
+      process.exit(1);
+    }
     error("未登录，请先运行 arm login");
     process.exit(1);
   }
   const client = new ApiClient(config.serverUrl, config.token);
   try {
     const knowledge = await client.getKnowledge(name);
+    if (shouldOutputJson()) {
+      outputJson({ success: true, data: knowledge });
+      return;
+    }
     console.log(formatKnowledgeDetail(knowledge));
   } catch (err) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "INFO_FAILED", message: err instanceof Error ? err.message : "未知错误" } });
+      process.exit(1);
+    }
     error(`获取详情失败: ${err instanceof Error ? err.message : "未知错误"}`);
     process.exit(1);
   }
@@ -1301,17 +1521,31 @@ async function infoKnowledge(name) {
 async function downloadKnowledge(name, outputDir) {
   const config = loadConfig();
   if (!config?.token) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "NOT_LOGGED_IN", message: "未登录，请先运行 arm login" } });
+      process.exit(1);
+    }
     error("未登录，请先运行 arm login");
     process.exit(1);
   }
   const client = new ApiClient(config.serverUrl, config.token);
   try {
-    info(`正在下载 ${name}...`);
+    if (shouldOutputJson()) {
+      info(`正在下载 ${name}...`);
+    }
     const buffer = await client.downloadKnowledge(name);
     const outputPath = join5(outputDir || ".", `${name}.zip`);
     writeFileSync4(outputPath, Buffer.from(buffer));
+    if (shouldOutputJson()) {
+      outputJson({ success: true, data: { path: outputPath } });
+      return;
+    }
     success(`已下载到 ${outputPath}`);
   } catch (err) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "DOWNLOAD_FAILED", message: err instanceof Error ? err.message : "未知错误" } });
+      process.exit(1);
+    }
     error(`下载失败: ${err instanceof Error ? err.message : "未知错误"}`);
     process.exit(1);
   }
@@ -1319,10 +1553,18 @@ async function downloadKnowledge(name, outputDir) {
 async function uploadKnowledge(filePath) {
   const config = loadConfig();
   if (!config?.token) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "NOT_LOGGED_IN", message: "未登录，请先运行 arm login" } });
+      process.exit(1);
+    }
     error("未登录，请先运行 arm login");
     process.exit(1);
   }
   if (!existsSync5(filePath)) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "FILE_NOT_FOUND", message: `上传失败: 目录不存在: ${filePath}` } });
+      process.exit(1);
+    }
     error(`上传失败: 目录不存在: ${filePath}`);
     process.exit(1);
   }
@@ -1336,10 +1578,20 @@ async function uploadKnowledge(filePath) {
       execSync4(`cp "${filePath}" "${zipPath}"`, { stdio: "pipe" });
     }
     const client = new ApiClient(config.serverUrl, config.token);
-    info(`正在上传 ${filePath}...`);
+    if (shouldOutputJson()) {
+      info(`正在上传 ${filePath}...`);
+    }
     const knowledge = await client.uploadKnowledge(zipPath);
+    if (shouldOutputJson()) {
+      outputJson({ success: true, data: knowledge });
+      return;
+    }
     success(`上传成功! Knowledge: ${knowledge.name}`);
   } catch (err) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "UPLOAD_FAILED", message: err instanceof Error ? err.message : "未知错误" } });
+      process.exit(1);
+    }
     error(`上传失败: ${err instanceof Error ? err.message : "未知错误"}`);
     process.exit(1);
   } finally {
@@ -1349,12 +1601,20 @@ async function uploadKnowledge(filePath) {
 async function myKnowledge() {
   const config = loadConfig();
   if (!config?.token) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "NOT_LOGGED_IN", message: "未登录，请先运行 arm login" } });
+      process.exit(1);
+    }
     error("未登录，请先运行 arm login");
     process.exit(1);
   }
   const client = new ApiClient(config.serverUrl, config.token);
   try {
     const knowledges = await client.getMyKnowledge();
+    if (shouldOutputJson()) {
+      outputJson({ success: true, data: knowledges });
+      return;
+    }
     if (knowledges.length === 0) {
       info("您还没有发布任何 Knowledge");
       return;
@@ -1367,6 +1627,10 @@ async function myKnowledge() {
       console.log("");
     }
   } catch (err) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "LIST_FAILED", message: err instanceof Error ? err.message : "未知错误" } });
+      process.exit(1);
+    }
     error(`获取列表失败: ${err instanceof Error ? err.message : "未知错误"}`);
     process.exit(1);
   }
@@ -1374,14 +1638,26 @@ async function myKnowledge() {
 async function deleteKnowledge(name) {
   const config = loadConfig();
   if (!config?.token) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "NOT_LOGGED_IN", message: "未登录，请先运行 arm login" } });
+      process.exit(1);
+    }
     error("未登录，请先运行 arm login");
     process.exit(1);
   }
   const client = new ApiClient(config.serverUrl, config.token);
   try {
     await client.deleteKnowledge(name);
+    if (shouldOutputJson()) {
+      outputJson({ success: true, data: { name } });
+      return;
+    }
     success(`已删除 ${name}`);
   } catch (err) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "DELETE_FAILED", message: err instanceof Error ? err.message : "未知错误" } });
+      process.exit(1);
+    }
     error(`删除失败: ${err instanceof Error ? err.message : "未知错误"}`);
     process.exit(1);
   }
@@ -1546,6 +1822,15 @@ async function main() {
     case "me":
       await getCurrentUser();
       break;
+    case "output":
+      if (subCommand === "json" || subCommand === "text") {
+        setOutputMode(subCommand);
+        console.log(`输出模式已设置为: ${subCommand}`);
+      } else {
+        const mode = getOutputMode();
+        console.log(`当前输出模式: ${mode}`);
+      }
+      break;
     case "agent":
       switch (subCommand) {
         case "ls":
@@ -1736,6 +2021,7 @@ Agent Resource Management (arm)
 用法:
   arm login <server-url> <api-key>   登录
   arm logout                          登出
+  arm output [json|text]              设置/查看输出模式 (默认json)
   arm skill ls                        列出所有 Skill
   arm skill search <keyword>          搜索 Skill
   arm skill info <name>               查看 Skill 详情