agent-resource-management 1.4.0 → 1.5.0

package/dist/main.js

@@ -230,6 +230,72 @@ class ApiClient {
     }
     return res.arrayBuffer();
   }
+  async createAgent(data) {
+    const res = await this.request("/agents", {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+    if (!res.ok) {
+      throw new Error(res.msg);
+    }
+    return res.data;
+  }
+  async updateAgent(id, data) {
+    const res = await this.request(`/agents/${id}`, {
+      method: "PUT",
+      body: JSON.stringify(data)
+    });
+    if (!res.ok) {
+      throw new Error(res.msg);
+    }
+    return res.data;
+  }
+  async deleteAgent(id) {
+    const res = await this.request(`/agents/${id}`, {
+      method: "DELETE"
+    });
+    if (!res.ok) {
+      throw new Error(res.msg);
+    }
+  }
+  async bindSkillToAgent(agentId, skillId, config) {
+    const res = await this.request(`/agents/${agentId}/skills`, {
+      method: "POST",
+      body: JSON.stringify({ skillId, config })
+    });
+    if (!res.ok) {
+      throw new Error(res.msg);
+    }
+  }
+  async unbindSkillFromAgent(agentId, skillId) {
+    const res = await this.request(`/agents/${agentId}/skills?skillId=${skillId}`, {
+      method: "DELETE"
+    });
+    if (!res.ok) {
+      throw new Error(res.msg);
+    }
+  }
+  async bindKnowledgeToAgent(agentId, knowledgeId, retrievalConfig) {
+    const res = await this.request(`/agents/${agentId}/knowledges`, {
+      method: "POST",
+      body: JSON.stringify({ knowledgeId, retrievalConfig })
+    });
+    if (!res.ok) {
+      throw new Error(res.msg);
+    }
+  }
+  async unbindKnowledgeFromAgent(agentId, knowledgeId) {
+    const res = await this.request(`/agents/${agentId}/knowledges?knowledgeId=${knowledgeId}`, {
+      method: "DELETE"
+    });
+    if (!res.ok) {
+      throw new Error(res.msg);
+    }
+  }
+  async getAgentByName(name) {
+    const result = await this.listAgents(name, 1, 1);
+    return result.agents.find((a) => a.name === name) || null;
+  }
 }
 
 // src/lib/storage.ts
@@ -438,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";
@@ -618,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;
@@ -636,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);
   }
@@ -643,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;
@@ -661,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);
   }
@@ -668,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);
   }
@@ -683,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);
   }
@@ -701,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);
   }
@@ -724,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 {
@@ -738,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;
@@ -756,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);
   }
@@ -763,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);
   }
@@ -778,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 {
@@ -821,15 +1019,240 @@ 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";
+async function createAgent(name, options = {}) {
+  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 = options.skills?.map((skillId, index) => ({
+      skillId,
+      config: options.skillConfigs?.[index] ? JSON.parse(options.skillConfigs[index]) : undefined
+    }));
+    const knowledges = options.knowledges?.map((knowledgeId, index) => ({
+      knowledgeId,
+      retrievalConfig: options.knowledgeConfigs?.[index] ? JSON.parse(options.knowledgeConfigs[index]) : undefined
+    }));
+    const result = await client.createAgent({
+      name,
+      description: options.description,
+      prompt: options.prompt,
+      avatar: options.avatar,
+      skills,
+      knowledges
+    });
+    if (shouldOutputJson()) {
+      outputJson({ success: true, data: result });
+      return;
+    }
+    success(`Agent "${name}" 创建成功 (ID: ${result.id})`);
+  } catch (err) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "CREATE_FAILED", message: err instanceof Error ? err.message : "未知错误" } });
+      process.exit(1);
+    }
+    error(`创建失败: ${err instanceof Error ? err.message : "未知错误"}`);
+    process.exit(1);
+  }
+}
+async function updateAgent(id, options = {}) {
+  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 updateData = {};
+    if (options.name !== undefined)
+      updateData.name = options.name;
+    if (options.description !== undefined)
+      updateData.description = options.description;
+    if (options.prompt !== undefined)
+      updateData.prompt = options.prompt;
+    if (options.avatar !== undefined)
+      updateData.avatar = options.avatar;
+    if (options.status !== undefined)
+      updateData.status = options.status;
+    const result = await client.updateAgent(id, updateData);
+    if (shouldOutputJson()) {
+      outputJson({ success: true, data: result });
+      return;
+    }
+    success(`Agent "${id}" 更新成功`);
+  } catch (err) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "UPDATE_FAILED", message: err instanceof Error ? err.message : "未知错误" } });
+      process.exit(1);
+    }
+    error(`更新失败: ${err instanceof Error ? err.message : "未知错误"}`);
+    process.exit(1);
+  }
+}
+async function deleteAgent(id) {
+  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.deleteAgent(id);
+    if (shouldOutputJson()) {
+      outputJson({ success: true, data: { id } });
+      return;
+    }
+    success(`Agent "${id}" 删除成功`);
+  } 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);
+  }
+}
+async function bindSkill(id, skillId, config) {
+  const configStore = loadConfig();
+  if (!configStore?.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(configStore.serverUrl, configStore.token);
+  try {
+    const parsedConfig = config ? JSON.parse(config) : undefined;
+    await client.bindSkillToAgent(id, skillId, parsedConfig);
+    if (shouldOutputJson()) {
+      outputJson({ success: true, data: { agentId: id, skillId, config: parsedConfig } });
+      return;
+    }
+    success(`Skill "${skillId}" 已绑定到 Agent "${id}"`);
+  } catch (err) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "BIND_FAILED", message: err instanceof Error ? err.message : "未知错误" } });
+      process.exit(1);
+    }
+    error(`绑定失败: ${err instanceof Error ? err.message : "未知错误"}`);
+    process.exit(1);
+  }
+}
+async function unbindSkill(id, skillId) {
+  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.unbindSkillFromAgent(id, skillId);
+    if (shouldOutputJson()) {
+      outputJson({ success: true, data: { agentId: id, skillId } });
+      return;
+    }
+    success(`Skill "${skillId}" 已从 Agent "${id}" 解绑`);
+  } catch (err) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "UNBIND_FAILED", message: err instanceof Error ? err.message : "未知错误" } });
+      process.exit(1);
+    }
+    error(`解绑失败: ${err instanceof Error ? err.message : "未知错误"}`);
+    process.exit(1);
+  }
+}
+async function bindKnowledge(id, knowledgeId, retrievalConfig) {
+  const configStore = loadConfig();
+  if (!configStore?.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(configStore.serverUrl, configStore.token);
+  try {
+    const parsedConfig = retrievalConfig ? JSON.parse(retrievalConfig) : undefined;
+    await client.bindKnowledgeToAgent(id, knowledgeId, parsedConfig);
+    if (shouldOutputJson()) {
+      outputJson({ success: true, data: { agentId: id, knowledgeId, retrievalConfig: parsedConfig } });
+      return;
+    }
+    success(`Knowledge "${knowledgeId}" 已绑定到 Agent "${id}"`);
+  } catch (err) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "BIND_FAILED", message: err instanceof Error ? err.message : "未知错误" } });
+      process.exit(1);
+    }
+    error(`绑定失败: ${err instanceof Error ? err.message : "未知错误"}`);
+    process.exit(1);
+  }
+}
+async function unbindKnowledge(id, knowledgeId) {
+  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.unbindKnowledgeFromAgent(id, knowledgeId);
+    if (shouldOutputJson()) {
+      outputJson({ success: true, data: { agentId: id, knowledgeId } });
+      return;
+    }
+    success(`Knowledge "${knowledgeId}" 已从 Agent "${id}" 解绑`);
+  } catch (err) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "UNBIND_FAILED", message: err instanceof Error ? err.message : "未知错误" } });
+      process.exit(1);
+    }
+    error(`解绑失败: ${err instanceof Error ? err.message : "未知错误"}`);
+    process.exit(1);
+  }
+}
 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;
@@ -842,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);
   }
@@ -849,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;
@@ -867,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);
   }
@@ -874,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);
   }
@@ -882,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);
     }
@@ -897,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);
   }
@@ -906,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);
   }
@@ -914,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`);
@@ -932,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);
   }
@@ -947,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;
@@ -965,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);
   }
@@ -972,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;
@@ -990,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);
   }
@@ -997,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);
   }
@@ -1012,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);
   }
@@ -1030,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);
   }
@@ -1047,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 {
@@ -1060,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;
@@ -1078,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);
   }
@@ -1085,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);
   }
@@ -1257,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":
@@ -1283,6 +1857,145 @@ async function main() {
           }
           await downloadAgent(args[2], args[3]);
           break;
+        case "create":
+          if (!args[2]) {
+            console.error(`用法: arm agent create <name> [--description="..."] [--prompt="..."] [--avatar="..."] [--skill=id] [--knowledge=id] [--skill-config='{...}'] [--knowledge-config='{...}'] [--json]`);
+            process.exit(1);
+          }
+          {
+            const name = args[2];
+            const options = {};
+            const skills = [];
+            const knowledges = [];
+            const skillConfigs = [];
+            const knowledgeConfigs = [];
+            for (let i = 3;i < args.length; i++) {
+              const arg = args[i];
+              if (arg.startsWith("--description=")) {
+                options.description = arg.split("=").slice(1).join("=");
+              } else if (arg.startsWith("--prompt=")) {
+                options.prompt = arg.split("=").slice(1).join("=");
+              } else if (arg.startsWith("--avatar=")) {
+                options.avatar = arg.split("=").slice(1).join("=");
+              } else if (arg.startsWith("--skill=")) {
+                skills.push(arg.split("=").slice(1).join("="));
+              } else if (arg.startsWith("--knowledge=")) {
+                knowledges.push(arg.split("=").slice(1).join("="));
+              } else if (arg.startsWith("--skill-config=")) {
+                skillConfigs.push(arg.split("=").slice(1).join("="));
+              } else if (arg.startsWith("--knowledge-config=")) {
+                knowledgeConfigs.push(arg.split("=").slice(1).join("="));
+              }
+            }
+            await createAgent(name, {
+              description: options.description,
+              prompt: options.prompt,
+              avatar: options.avatar,
+              skills,
+              knowledges,
+              skillConfigs,
+              knowledgeConfigs
+            });
+          }
+          break;
+        case "update":
+          if (!args[2]) {
+            console.error('用法: arm agent update <id> [--name="..."] [--description="..."] [--prompt="..."] [--avatar="..."] [--status=active|draft] [--json]');
+            process.exit(1);
+          }
+          {
+            const id = args[2];
+            const options = {};
+            for (let i = 3;i < args.length; i++) {
+              const arg = args[i];
+              if (arg.startsWith("--name=")) {
+                options.name = arg.split("=").slice(1).join("=");
+              } else if (arg.startsWith("--description=")) {
+                options.description = arg.split("=").slice(1).join("=");
+              } else if (arg.startsWith("--prompt=")) {
+                options.prompt = arg.split("=").slice(1).join("=");
+              } else if (arg.startsWith("--avatar=")) {
+                options.avatar = arg.split("=").slice(1).join("=");
+              } else if (arg.startsWith("--status=")) {
+                options.status = arg.split("=").slice(1).join("=");
+              }
+            }
+            await updateAgent(id, {
+              name: options.name,
+              description: options.description,
+              prompt: options.prompt,
+              avatar: options.avatar,
+              status: options.status
+            });
+          }
+          break;
+        case "delete":
+          if (!args[2]) {
+            console.error("用法: arm agent delete <id> [--json]");
+            process.exit(1);
+          }
+          await deleteAgent(args[2]);
+          break;
+        case "bind":
+          if (!args[2]) {
+            console.error("用法: arm agent bind <id> --skill=<skillId> [--skill-config='{...}'] 或 arm agent bind <id> --knowledge=<knowledgeId> [--knowledge-config='{...}'] [--json]");
+            process.exit(1);
+          }
+          {
+            const id = args[2];
+            let skillId;
+            let knowledgeId;
+            let skillConfig;
+            let knowledgeConfig;
+            for (let i = 3;i < args.length; i++) {
+              const arg = args[i];
+              if (arg.startsWith("--skill=")) {
+                skillId = arg.split("=").slice(1).join("=");
+              } else if (arg.startsWith("--knowledge=")) {
+                knowledgeId = arg.split("=").slice(1).join("=");
+              } else if (arg.startsWith("--skill-config=")) {
+                skillConfig = arg.split("=").slice(1).join("=");
+              } else if (arg.startsWith("--knowledge-config=")) {
+                knowledgeConfig = arg.split("=").slice(1).join("=");
+              }
+            }
+            if (skillId) {
+              await bindSkill(id, skillId, skillConfig);
+            } else if (knowledgeId) {
+              await bindKnowledge(id, knowledgeId, knowledgeConfig);
+            } else {
+              console.error("用法: arm agent bind <id> --skill=<skillId> 或 --knowledge=<knowledgeId>");
+              process.exit(1);
+            }
+          }
+          break;
+        case "unbind":
+          if (!args[2]) {
+            console.error("用法: arm agent unbind <id> --skill=<skillId> 或 --knowledge=<knowledgeId> [--json]");
+            process.exit(1);
+          }
+          {
+            const id = args[2];
+            let skillId;
+            let knowledgeId;
+            for (let i = 3;i < args.length; i++) {
+              const arg = args[i];
+              if (arg.startsWith("--skill=")) {
+                skillId = arg.split("=").slice(1).join("=");
+              } else if (arg.startsWith("--knowledge=")) {
+                knowledgeId = arg.split("=").slice(1).join("=");
+              }
+            }
+            if (skillId) {
+              await unbindSkill(id, skillId);
+            } else if (knowledgeId) {
+              await unbindKnowledge(id, knowledgeId);
+            } else {
+              console.error("用法: arm agent unbind <id> --skill=<skillId> 或 --knowledge=<knowledgeId>");
+              process.exit(1);
+            }
+          }
+          break;
         default:
           console.log(`
 可用命令:
@@ -1290,6 +2003,14 @@ async function main() {
   arm agent search <keyword>          搜索 Agent
   arm agent info <name>               查看 Agent 详情
   arm agent download <name> [dir]     下载 Agent
+  arm agent create <name>             创建 Agent (--description, --prompt, --avatar, --skill, --knowledge)
+  arm agent update <id>               更新 Agent (--name, --description, --prompt, --avatar, --status)
+  arm agent delete <id>                删除 Agent
+  arm agent bind <id> --skill=<id>    绑定 Skill 到 Agent
+  arm agent unbind <id> --skill=<id>  解绑 Skill
+  arm agent bind <id> --knowledge=<id> 绑定 Knowledge 到 Agent
+  arm agent unbind <id> --knowledge=<id> 解绑 Knowledge
+  所有命令支持 --json 参数获取机器可读输出
 `);
       }
       break;
@@ -1300,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 详情
@@ -1319,8 +2041,16 @@ Agent Resource Management (arm)
   arm agent search <keyword>          搜索 Agent
   arm agent info <name>               查看 Agent 详情
   arm agent download <name> [dir]     下载 Agent
+  arm agent create <name>             创建 Agent
+  arm agent update <id>               更新 Agent
+  arm agent delete <id>                删除 Agent
+  arm agent bind <id> --skill=<id>    绑定 Skill
+  arm agent unbind <id> --skill=<id>  解绑 Skill
+  arm agent bind <id> --knowledge=<id> 绑定 Knowledge
+  arm agent unbind <id> --knowledge=<id> 解绑 Knowledge
   arm server                          显示当前服务端
   arm server set <url>                设置服务端
+  使用 arm <entity> -h 查看详细帮助
 `);
   }
 }