agent-resource-management 2.1.1 → 2.1.3

package/dist/main.js

@@ -577,7 +577,7 @@ function setOutputMode(mode) {
 }
 
 // src/lib/validate.ts
-import { readFileSync as readFileSync2, existsSync as existsSync2, statSync } from "fs";
+import { readFileSync as readFileSync2, existsSync as existsSync2, statSync as statSync2 } from "fs";
 import { execSync } from "child_process";
 import { join as join2, extname } from "path";
 import { mkdtempSync, rmSync } from "fs";
@@ -597,7 +597,7 @@ function validateZip(filePath) {
     result.errors.push("文件必须是 ZIP 格式");
     return result;
   }
-  const stats = statSync(filePath);
+  const stats = statSync2(filePath);
   if (stats.size === 0) {
     result.valid = false;
     result.errors.push("ZIP 文件为空");
@@ -747,9 +747,95 @@ function validateSkillDir(dirPath) {
   }
   return result;
 }
+function validateAgentDir(dirPath) {
+  const result = {
+    valid: true,
+    errors: [],
+    warnings: []
+  };
+  if (!existsSync2(dirPath)) {
+    result.valid = false;
+    result.errors.push(`目录不存在: ${dirPath}`);
+    return result;
+  }
+  const agentMdPath = join2(dirPath, "AGENT.md");
+  if (!existsSync2(agentMdPath)) {
+    result.valid = false;
+    result.errors.push("目录内缺少 AGENT.md 文件");
+    return result;
+  }
+  try {
+    const agentMdContent = readFileSync2(agentMdPath, "utf-8");
+    const frontmatterMatch = agentMdContent.match(/^---\n([\s\S]*?)\n---/);
+    if (frontmatterMatch) {
+      const frontmatter = frontmatterMatch[1];
+      result.metadata = {};
+      const nameMatch = frontmatter.match(/name:\s*(.+)/);
+      const versionMatch = frontmatter.match(/version:\s*(.+)/);
+      const descMatch = frontmatter.match(/description:\s*(.+)/);
+      const skillsMatch = frontmatter.match(/skills:\s*([\s\S]*?)(?=\n\w|---)/);
+      const knowledgesMatch = frontmatter.match(/knowledges:\s*([\s\S]*?)(?=\n\w|---)/);
+      if (nameMatch) {
+        result.metadata.name = nameMatch[1].trim();
+      } else {
+        result.valid = false;
+        result.errors.push("缺少 name 字段");
+      }
+      if (versionMatch) {
+        result.metadata.version = versionMatch[1].trim();
+      }
+      if (descMatch) {
+        result.metadata.description = descMatch[1].trim();
+      }
+      if (skillsMatch) {
+        const skillsLines = skillsMatch[1].split(`
+`).filter((l) => l.trim().startsWith("-"));
+        result.metadata.skills = skillsLines.map((l) => l.replace(/^\s*-\s*/, "").trim());
+      }
+      if (knowledgesMatch) {
+        const knowledgesLines = knowledgesMatch[1].split(`
+`).filter((l) => l.trim().startsWith("-"));
+        result.metadata.knowledges = knowledgesLines.map((l) => l.replace(/^\s*-\s*/, "").trim());
+      }
+      const contentAfterFrontmatter = agentMdContent.replace(/^---[\s\S]*?---\n/, "");
+      const promptMatch = contentAfterFrontmatter.match(/#\s*System\s*Prompt\n([\s\S]*?)$/);
+      if (promptMatch) {
+        result.metadata.prompt = promptMatch[1].trim();
+      } else if (contentAfterFrontmatter.trim()) {
+        result.metadata.prompt = contentAfterFrontmatter.trim();
+      }
+    } else {
+      result.valid = false;
+      result.errors.push("AGENT.md 缺少 frontmatter (--- 包裹的 YAML)");
+    }
+    const skillsDir = join2(dirPath, "skills");
+    if (existsSync2(skillsDir) && statSync2(skillsDir).isDirectory()) {
+      const skillDirs = execSync(`ls -1 "${skillsDir}"`, { encoding: "utf-8" }).split(`
+`).filter((l) => l.trim() && existsSync2(join2(skillsDir, l)) && statSync2(join2(skillsDir, l)).isDirectory());
+      for (const skillDir of skillDirs) {
+        const skillMdPath = join2(skillsDir, skillDir, "SKILL.md");
+        if (!existsSync2(skillMdPath)) {
+          result.warnings.push(`skills/${skillDir} 目录内缺少 SKILL.md 文件`);
+        }
+      }
+    }
+    const knowledgesDir = join2(dirPath, "knowledges");
+    if (existsSync2(knowledgesDir) && statSync2(knowledgesDir).isDirectory()) {
+      const mdFiles = execSync(`ls -1 "${knowledgesDir}"`, { encoding: "utf-8" }).split(`
+`).filter((l) => l.trim().endsWith(".md"));
+      if (mdFiles.length === 0) {
+        result.warnings.push("knowledges/ 目录内没有 .md 文件");
+      }
+    }
+  } catch (err) {
+    result.valid = false;
+    result.errors.push(`AGENT.md 读取失败: ${err instanceof Error ? err.message : "未知错误"}`);
+  }
+  return result;
+}
 
 // src/cmd/skill.ts
-import { writeFileSync as writeFileSync2, existsSync as existsSync3, statSync as statSync2 } from "fs";
+import { writeFileSync as writeFileSync2, existsSync as existsSync3, statSync as statSync3 } from "fs";
 import { join as join3, basename, dirname } from "path";
 import { execSync as execSync2 } from "child_process";
 import { mkdtempSync as mkdtempSync2, rmSync as rmSync2 } from "fs";
@@ -870,13 +956,33 @@ async function downloadSkill(name, outputDir) {
       info(`正在下载 ${name}...`);
     }
     const buffer = await client.downloadSkill(name);
-    const outputPath = join3(outputDir || ".", `${name}.zip`);
-    writeFileSync2(outputPath, Buffer.from(buffer));
+    const tempDir = mkdtempSync2("/tmp/skill-download-");
+    const zipPath = join3(tempDir, `${name}.zip`);
+    writeFileSync2(zipPath, Buffer.from(buffer));
+    execSync2(`unzip -q "${zipPath}" -d "${tempDir}"`, { stdio: "pipe" });
+    const targetDir = join3(outputDir || ".", name);
+    execSync2(`mkdir -p "${targetDir}"`, { stdio: "pipe" });
+    const entries = execSync2(`ls -1 "${tempDir}"`, { encoding: "utf-8" }).split(`
+`).filter((e) => e.trim());
+    const nonZipEntries = entries.filter((e) => e !== `${name}.zip`);
+    if (nonZipEntries.length === 1) {
+      const onlyEntry = join3(tempDir, nonZipEntries[0]);
+      if (statSync3(onlyEntry).isDirectory()) {
+        execSync2(`cp -r "${onlyEntry}"/* "${targetDir}/"`, { stdio: "pipe" });
+      } else {
+        execSync2(`cp -r "${onlyEntry}" "${targetDir}/"`, { stdio: "pipe" });
+      }
+    } else {
+      for (const entry of nonZipEntries) {
+        execSync2(`cp -r "${join3(tempDir, entry)}" "${targetDir}/"`, { stdio: "pipe" });
+      }
+    }
+    rmSync2(tempDir, { recursive: true, force: true });
     if (shouldOutputJson()) {
-      outputJson({ success: true, data: { path: outputPath } });
+      outputJson({ success: true, data: { path: targetDir } });
       return;
     }
-    success(`已下载到 ${outputPath}`);
+    success(`已下载到 ${targetDir}`);
   } catch (err) {
     if (shouldOutputJson()) {
       outputJson({ success: false, error: { code: "DOWNLOAD_FAILED", message: err instanceof Error ? err.message : "未知错误" } });
@@ -1010,7 +1116,7 @@ async function deleteSkill(name) {
   }
 }
 async function validateSkill(filePath) {
-  const isDir = existsSync3(filePath) && statSync2(filePath).isDirectory();
+  const isDir = existsSync3(filePath) && statSync3(filePath).isDirectory();
   const result = isDir ? validateSkillDir(filePath) : validateZip(filePath);
   if (shouldOutputJson()) {
     outputJson({
@@ -1462,10 +1568,153 @@ async function downloadAgent(name, outputDir) {
     process.exit(1);
   }
 }
+async function createAgentFromFolder(folderPath) {
+  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 (!existsSync4(folderPath)) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "FILE_NOT_FOUND", message: `目录不存在: ${folderPath}` } });
+      process.exit(1);
+    }
+    error(`目录不存在: ${folderPath}`);
+    process.exit(1);
+  }
+  const validation = validateAgentDir(folderPath);
+  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);
+  }
+  if (shouldOutputJson()) {
+    info("正在解析 Agent 文件夹...");
+  }
+  const metadata = validation.metadata;
+  const client = new ApiClient(config.serverUrl, config.token);
+  const uploadedSkills = [];
+  const uploadedKnowledges = [];
+  const skillsDir = join4(folderPath, "skills");
+  if (existsSync4(skillsDir) && statSync(skillsDir).isDirectory()) {
+    const skillDirs = execSync3(`ls -1 "${skillsDir}"`, { encoding: "utf-8" }).split(`
+`).filter((l) => l.trim() && existsSync4(join4(skillsDir, l)) && statSync(join4(skillsDir, l)).isDirectory());
+    for (const skillDir of skillDirs) {
+      const skillPath = join4(skillsDir, skillDir);
+      try {
+        const existingSkill = await client.getSkill(skillDir).catch(() => null);
+        if (existingSkill) {
+          if (shouldOutputJson()) {
+            info(`技能 ${skillDir} 已存在，将仅绑定`);
+          }
+          uploadedSkills.push({ name: skillDir, id: existingSkill.id });
+        } else {
+          if (shouldOutputJson()) {
+            info(`上传新技能: ${skillDir}`);
+          }
+          const skillTempDir = mkdtempSync3("/tmp/skill-upload-");
+          const zipPath = join4(skillTempDir, `${skillDir}.zip`);
+          execSync3(`cd "${skillPath}" && zip -r "${zipPath}" . -x ".*"`, { stdio: "pipe" });
+          const uploadedSkill = await client.uploadSkill(zipPath);
+          uploadedSkills.push({ name: skillDir, id: uploadedSkill.id });
+          rmSync3(skillTempDir, { recursive: true, force: true });
+        }
+      } catch (err) {
+        if (shouldOutputJson()) {
+          outputJson({ success: false, error: { code: "SKILL_UPLOAD_FAILED", message: `处理技能 ${skillDir} 失败: ${err instanceof Error ? err.message : "未知错误"}` } });
+          process.exit(1);
+        }
+        error(`处理技能 ${skillDir} 失败: ${err instanceof Error ? err.message : "未知错误"}`);
+        process.exit(1);
+      }
+    }
+  }
+  const knowledgesDir = join4(folderPath, "knowledges");
+  if (existsSync4(knowledgesDir) && statSync(knowledgesDir).isDirectory()) {
+    const mdFiles = execSync3(`ls -1 "${knowledgesDir}"`, { encoding: "utf-8" }).split(`
+`).filter((l) => l.trim().endsWith(".md"));
+    for (const mdFile of mdFiles) {
+      const mdPath = join4(knowledgesDir, mdFile);
+      const knowledgeName = mdFile.replace(".md", "");
+      try {
+        const existingKnowledge = await client.getKnowledge(knowledgeName).catch(() => null);
+        if (existingKnowledge) {
+          if (shouldOutputJson()) {
+            info(`知识 ${knowledgeName} 已存在，将仅绑定`);
+          }
+          uploadedKnowledges.push({ title: knowledgeName, id: existingKnowledge.id });
+        } else {
+          if (shouldOutputJson()) {
+            info(`上传新知识: ${knowledgeName}`);
+          }
+          const uploadedKnowledge = await client.uploadKnowledge(mdPath);
+          uploadedKnowledges.push({ title: knowledgeName, id: uploadedKnowledge.id });
+        }
+      } catch (err) {
+        if (shouldOutputJson()) {
+          outputJson({ success: false, error: { code: "KNOWLEDGE_UPLOAD_FAILED", message: `处理知识 ${knowledgeName} 失败: ${err instanceof Error ? err.message : "未知错误"}` } });
+          process.exit(1);
+        }
+        error(`处理知识 ${knowledgeName} 失败: ${err instanceof Error ? err.message : "未知错误"}`);
+        process.exit(1);
+      }
+    }
+  }
+  if (shouldOutputJson()) {
+    info(`创建 Agent: ${metadata.name}`);
+  }
+  try {
+    const agent = await client.createAgent({
+      name: metadata.name,
+      description: metadata.description,
+      prompt: metadata.prompt
+    });
+    for (const skill of uploadedSkills) {
+      if (shouldOutputJson()) {
+        info(`绑定技能: ${skill.name}`);
+      }
+      await client.bindSkillToAgent(agent.id, skill.id);
+    }
+    for (const knowledge of uploadedKnowledges) {
+      if (shouldOutputJson()) {
+        info(`绑定知识: ${knowledge.title}`);
+      }
+      await client.bindKnowledgeToAgent(agent.id, knowledge.id);
+    }
+    if (shouldOutputJson()) {
+      outputJson({
+        success: true,
+        data: {
+          id: agent.id,
+          name: agent.name,
+          skillsCount: uploadedSkills.length,
+          knowledgesCount: uploadedKnowledges.length
+        }
+      });
+      return;
+    }
+    success(`Agent "${metadata.name}" 创建成功 (ID: ${agent.id})`);
+    success(`已绑定 ${uploadedSkills.length} 个技能和 ${uploadedKnowledges.length} 个知识`);
+  } 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);
+  }
+}
 
 // src/cmd/knowledge.ts
-import { writeFileSync as writeFileSync4, existsSync as existsSync5, statSync as statSync3 } from "fs";
-import { join as join5, basename as basename2, dirname as dirname2 } from "path";
+import { writeFileSync as writeFileSync4, existsSync as existsSync5, statSync as statSync4 } from "fs";
+import { join as join5, basename as basename3, dirname as dirname2 } from "path";
 import { execSync as execSync4 } from "child_process";
 import { mkdtempSync as mkdtempSync4, rmSync as rmSync4 } from "fs";
 async function listKnowledge() {
@@ -1619,12 +1868,12 @@ async function uploadKnowledge(filePath) {
     error(`上传失败: 目录不存在: ${filePath}`);
     process.exit(1);
   }
-  const knowledgeName = basename2(filePath);
+  const knowledgeName = basename3(filePath);
   const tempDir = mkdtempSync4("/tmp/knowledge-upload-");
   const zipPath = join5(tempDir, `${knowledgeName}.zip`);
   try {
-    if (statSync3(filePath).isDirectory()) {
-      execSync4(`cd "${dirname2(filePath)}" && zip -r "${zipPath}" "${basename2(filePath)}" -x ".*"`, { stdio: "pipe" });
+    if (statSync4(filePath).isDirectory()) {
+      execSync4(`cd "${dirname2(filePath)}" && zip -r "${zipPath}" "${basename3(filePath)}" -x ".*"`, { stdio: "pipe" });
     } else {
       execSync4(`cp "${filePath}" "${zipPath}"`, { stdio: "pipe" });
     }
@@ -1928,7 +2177,7 @@ async function main() {
           break;
         case "create":
           if (!args[2]) {
-            console.error(`用法: arm agent create <name> [--description="..."] [--prompt="..."] [--avatar="..."] [--skill=id] [--knowledge=id] [--skill-config='{...}'] [--knowledge-config='{...}'] [--json]`);
+            console.error(`用法: arm agent create <name> [--description="..."] [--prompt="..."] [--avatar="..."] [--skill=id] [--knowledge=id] [--skill-config='{...}'] [--knowledge-config='{...}'] [--from=<folder-path>] [--json]`);
             process.exit(1);
           }
           {
@@ -1938,6 +2187,7 @@ async function main() {
             const knowledges = [];
             const skillConfigs = [];
             const knowledgeConfigs = [];
+            let fromFolder;
             for (let i = 3;i < args.length; i++) {
               const arg = args[i];
               if (arg.startsWith("--description=")) {
@@ -1954,17 +2204,23 @@ async function main() {
                 skillConfigs.push(arg.split("=").slice(1).join("="));
               } else if (arg.startsWith("--knowledge-config=")) {
                 knowledgeConfigs.push(arg.split("=").slice(1).join("="));
+              } else if (arg.startsWith("--from=")) {
+                fromFolder = arg.split("=").slice(1).join("=");
               }
             }
-            await createAgent(name, {
-              description: options.description,
-              prompt: options.prompt,
-              avatar: options.avatar,
-              skills,
-              knowledges,
-              skillConfigs,
-              knowledgeConfigs
-            });
+            if (fromFolder) {
+              await createAgentFromFolder(fromFolder);
+            } else {
+              await createAgent(name, {
+                description: options.description,
+                prompt: options.prompt,
+                avatar: options.avatar,
+                skills,
+                knowledges,
+                skillConfigs,
+                knowledgeConfigs
+              });
+            }
           }
           break;
         case "update":
@@ -2073,6 +2329,7 @@ async function main() {
   arm agent info <name>               查看 Agent 详情
   arm agent download <name> [dir]     下载 Agent
   arm agent create <name>             创建 Agent (--description, --prompt, --avatar, --skill, --knowledge)
+  arm agent create --from=<folder>    从本地文件夹创建 Agent
   arm agent update <id>               更新 Agent (--name, --description, --prompt, --avatar, --status)
   arm agent delete <id>                删除 Agent
   arm agent bind <id> --skill=<id>    绑定 Skill 到 Agent

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-resource-management",
-  "version": "2.1.1",
+  "version": "2.1.3",
   "type": "module",
   "bin": {
     "arm": "./dist/main.js"

package/src/cmd/agent.ts

@@ -2,8 +2,9 @@ import { ApiClient } from '../lib/client';
 import { loadConfig } from '../lib/storage';
 import { formatAgent, formatAgentDetail, success, error, info } from '../lib/formatter';
 import { shouldOutputJson, outputJson } from '../lib/output';
-import { writeFileSync, existsSync } from 'fs';
-import { join } from 'path';
+import { validateAgentDir } from '../lib/validate';
+import { writeFileSync, existsSync, readFileSync } from 'fs';
+import { join, basename } from 'path';
 import { execSync } from 'child_process';
 import { mkdtempSync, rmSync } from 'fs';
 
@@ -463,4 +464,164 @@ export async function downloadAgent(name: string, outputDir?: string): Promise<v
     error(`下载失败: ${err instanceof Error ? err.message : '未知错误'}`);
     process.exit(1);
   }
+}
+
+export async function createAgentFromFolder(folderPath: string): Promise<void> {
+  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 (!existsSync(folderPath)) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: 'FILE_NOT_FOUND', message: `目录不存在: ${folderPath}` } });
+      process.exit(1);
+    }
+    error(`目录不存在: ${folderPath}`);
+    process.exit(1);
+  }
+
+  const validation = validateAgentDir(folderPath);
+  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);
+  }
+
+  if (shouldOutputJson()) {
+    info('正在解析 Agent 文件夹...');
+  }
+
+  const metadata = validation.metadata!;
+  const client = new ApiClient(config.serverUrl, config.token);
+
+  const uploadedSkills: { name: string; id: string }[] = [];
+  const uploadedKnowledges: { title: string; id: string }[] = [];
+
+  const skillsDir = join(folderPath, 'skills');
+  if (existsSync(skillsDir) && statSync(skillsDir).isDirectory()) {
+    const skillDirs = execSync(`ls -1 "${skillsDir}"`, { encoding: 'utf-8' })
+      .split('\n')
+      .filter(l => l.trim() && existsSync(join(skillsDir, l)) && statSync(join(skillsDir, l)).isDirectory());
+
+    for (const skillDir of skillDirs) {
+      const skillPath = join(skillsDir, skillDir);
+      try {
+        const existingSkill = await client.getSkill(skillDir).catch(() => null);
+        if (existingSkill) {
+          if (shouldOutputJson()) {
+            info(`技能 ${skillDir} 已存在，将仅绑定`);
+          }
+          uploadedSkills.push({ name: skillDir, id: existingSkill.id });
+        } else {
+          if (shouldOutputJson()) {
+            info(`上传新技能: ${skillDir}`);
+          }
+          const skillTempDir = mkdtempSync('/tmp/skill-upload-');
+          const zipPath = join(skillTempDir, `${skillDir}.zip`);
+          execSync(`cd "${skillPath}" && zip -r "${zipPath}" . -x ".*"`, { stdio: 'pipe' });
+          const uploadedSkill = await client.uploadSkill(zipPath);
+          uploadedSkills.push({ name: skillDir, id: uploadedSkill.id });
+          rmSync(skillTempDir, { recursive: true, force: true });
+        }
+      } catch (err) {
+        if (shouldOutputJson()) {
+          outputJson({ success: false, error: { code: 'SKILL_UPLOAD_FAILED', message: `处理技能 ${skillDir} 失败: ${err instanceof Error ? err.message : '未知错误'}` } });
+          process.exit(1);
+        }
+        error(`处理技能 ${skillDir} 失败: ${err instanceof Error ? err.message : '未知错误'}`);
+        process.exit(1);
+      }
+    }
+  }
+
+  const knowledgesDir = join(folderPath, 'knowledges');
+  if (existsSync(knowledgesDir) && statSync(knowledgesDir).isDirectory()) {
+    const mdFiles = execSync(`ls -1 "${knowledgesDir}"`, { encoding: 'utf-8' })
+      .split('\n')
+      .filter(l => l.trim().endsWith('.md'));
+
+    for (const mdFile of mdFiles) {
+      const mdPath = join(knowledgesDir, mdFile);
+      const knowledgeName = mdFile.replace('.md', '');
+      try {
+        const existingKnowledge = await client.getKnowledge(knowledgeName).catch(() => null);
+        if (existingKnowledge) {
+          if (shouldOutputJson()) {
+            info(`知识 ${knowledgeName} 已存在，将仅绑定`);
+          }
+          uploadedKnowledges.push({ title: knowledgeName, id: existingKnowledge.id });
+        } else {
+          if (shouldOutputJson()) {
+            info(`上传新知识: ${knowledgeName}`);
+          }
+          const uploadedKnowledge = await client.uploadKnowledge(mdPath);
+          uploadedKnowledges.push({ title: knowledgeName, id: uploadedKnowledge.id });
+        }
+      } catch (err) {
+        if (shouldOutputJson()) {
+          outputJson({ success: false, error: { code: 'KNOWLEDGE_UPLOAD_FAILED', message: `处理知识 ${knowledgeName} 失败: ${err instanceof Error ? err.message : '未知错误'}` } });
+          process.exit(1);
+        }
+        error(`处理知识 ${knowledgeName} 失败: ${err instanceof Error ? err.message : '未知错误'}`);
+        process.exit(1);
+      }
+    }
+  }
+
+  if (shouldOutputJson()) {
+    info(`创建 Agent: ${metadata.name}`);
+  }
+
+  try {
+    const agent = await client.createAgent({
+      name: metadata.name!,
+      description: metadata.description,
+      prompt: metadata.prompt,
+    });
+
+    for (const skill of uploadedSkills) {
+      if (shouldOutputJson()) {
+        info(`绑定技能: ${skill.name}`);
+      }
+      await client.bindSkillToAgent(agent.id, skill.id);
+    }
+
+    for (const knowledge of uploadedKnowledges) {
+      if (shouldOutputJson()) {
+        info(`绑定知识: ${knowledge.title}`);
+      }
+      await client.bindKnowledgeToAgent(agent.id, knowledge.id);
+    }
+
+    if (shouldOutputJson()) {
+      outputJson({
+        success: true,
+        data: {
+          id: agent.id,
+          name: agent.name,
+          skillsCount: uploadedSkills.length,
+          knowledgesCount: uploadedKnowledges.length,
+        },
+      });
+      return;
+    }
+    success(`Agent "${metadata.name}" 创建成功 (ID: ${agent.id})`);
+    success(`已绑定 ${uploadedSkills.length} 个技能和 ${uploadedKnowledges.length} 个知识`);
+  } 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);
+  }
 }

package/src/cmd/skill.ts

@@ -130,13 +130,40 @@ export async function downloadSkill(name: string, outputDir?: string): Promise<v
       info(`正在下载 ${name}...`);
     }
     const buffer = await client.downloadSkill(name);
-    const outputPath = join(outputDir || '.', `${name}.zip`);
-    writeFileSync(outputPath, Buffer.from(buffer));
+
+    const tempDir = mkdtempSync('/tmp/skill-download-');
+    const zipPath = join(tempDir, `${name}.zip`);
+    writeFileSync(zipPath, Buffer.from(buffer));
+
+    execSync(`unzip -q "${zipPath}" -d "${tempDir}"`, { stdio: 'pipe' });
+
+    const targetDir = join(outputDir || '.', name);
+    execSync(`mkdir -p "${targetDir}"`, { stdio: 'pipe' });
+
+    const entries = execSync(`ls -1 "${tempDir}"`, { encoding: 'utf-8' }).split('\n').filter(e => e.trim());
+
+    const nonZipEntries = entries.filter(e => e !== `${name}.zip`);
+
+    if (nonZipEntries.length === 1) {
+      const onlyEntry = join(tempDir, nonZipEntries[0]);
+      if (statSync(onlyEntry).isDirectory()) {
+        execSync(`cp -r "${onlyEntry}"/* "${targetDir}/"`, { stdio: 'pipe' });
+      } else {
+        execSync(`cp -r "${onlyEntry}" "${targetDir}/"`, { stdio: 'pipe' });
+      }
+    } else {
+      for (const entry of nonZipEntries) {
+        execSync(`cp -r "${join(tempDir, entry)}" "${targetDir}/"`, { stdio: 'pipe' });
+      }
+    }
+
+    rmSync(tempDir, { recursive: true, force: true });
+
     if (shouldOutputJson()) {
-      outputJson({ success: true, data: { path: outputPath } });
+      outputJson({ success: true, data: { path: targetDir } });
       return;
     }
-    success(`已下载到 ${outputPath}`);
+    success(`已下载到 ${targetDir}`);
   } catch (err) {
     if (shouldOutputJson()) {
       outputJson({ success: false, error: { code: 'DOWNLOAD_FAILED', message: err instanceof Error ? err.message : '未知错误' } });

package/src/lib/validate.ts

@@ -203,7 +203,124 @@ export function validateSkillDir(dirPath: string): ValidationResult {
       result.errors.push('SKILL.md 缺少 frontmatter (--- 包裹的 YAML)');
     }
   } catch (err) {
-    result.warnings.push(`SKILL.md 读取失败: ${err instanceof Error ? err.message : '未知错误'}`);
+      result.warnings.push(`SKILL.md 读取失败: ${err instanceof Error ? err.message : '未知错误'}`);
+    }
+
+  return result;
+}
+
+export interface AgentValidationResult {
+  valid: boolean;
+  errors: string[];
+  warnings: string[];
+  metadata?: {
+    name?: string;
+    version?: string;
+    description?: string;
+    prompt?: string;
+    skills?: string[];
+    knowledges?: string[];
+  };
+}
+
+export function validateAgentDir(dirPath: string): AgentValidationResult {
+  const result: AgentValidationResult = {
+    valid: true,
+    errors: [],
+    warnings: [],
+  };
+
+  if (!existsSync(dirPath)) {
+    result.valid = false;
+    result.errors.push(`目录不存在: ${dirPath}`);
+    return result;
+  }
+
+  const agentMdPath = join(dirPath, 'AGENT.md');
+  if (!existsSync(agentMdPath)) {
+    result.valid = false;
+    result.errors.push('目录内缺少 AGENT.md 文件');
+    return result;
+  }
+
+  try {
+    const agentMdContent = readFileSync(agentMdPath, 'utf-8');
+    const frontmatterMatch = agentMdContent.match(/^---\n([\s\S]*?)\n---/);
+
+    if (frontmatterMatch) {
+      const frontmatter = frontmatterMatch[1];
+      result.metadata = {};
+
+      const nameMatch = frontmatter.match(/name:\s*(.+)/);
+      const versionMatch = frontmatter.match(/version:\s*(.+)/);
+      const descMatch = frontmatter.match(/description:\s*(.+)/);
+      const skillsMatch = frontmatter.match(/skills:\s*([\s\S]*?)(?=\n\w|---)/);
+      const knowledgesMatch = frontmatter.match(/knowledges:\s*([\s\S]*?)(?=\n\w|---)/);
+
+      if (nameMatch) {
+        result.metadata.name = nameMatch[1].trim();
+      } else {
+        result.valid = false;
+        result.errors.push('缺少 name 字段');
+      }
+
+      if (versionMatch) {
+        result.metadata.version = versionMatch[1].trim();
+      }
+
+      if (descMatch) {
+        result.metadata.description = descMatch[1].trim();
+      }
+
+      if (skillsMatch) {
+        const skillsLines = skillsMatch[1].split('\n').filter(l => l.trim().startsWith('-'));
+        result.metadata.skills = skillsLines.map(l => l.replace(/^\s*-\s*/, '').trim());
+      }
+
+      if (knowledgesMatch) {
+        const knowledgesLines = knowledgesMatch[1].split('\n').filter(l => l.trim().startsWith('-'));
+        result.metadata.knowledges = knowledgesLines.map(l => l.replace(/^\s*-\s*/, '').trim());
+      }
+
+      const contentAfterFrontmatter = agentMdContent.replace(/^---[\s\S]*?---\n/, '');
+      const promptMatch = contentAfterFrontmatter.match(/#\s*System\s*Prompt\n([\s\S]*?)$/);
+      if (promptMatch) {
+        result.metadata.prompt = promptMatch[1].trim();
+      } else if (contentAfterFrontmatter.trim()) {
+        result.metadata.prompt = contentAfterFrontmatter.trim();
+      }
+    } else {
+      result.valid = false;
+      result.errors.push('AGENT.md 缺少 frontmatter (--- 包裹的 YAML)');
+    }
+
+    const skillsDir = join(dirPath, 'skills');
+    if (existsSync(skillsDir) && statSync(skillsDir).isDirectory()) {
+      const skillDirs = execSync(`ls -1 "${skillsDir}"`, { encoding: 'utf-8' })
+        .split('\n')
+        .filter(l => l.trim() && existsSync(join(skillsDir, l)) && statSync(join(skillsDir, l)).isDirectory());
+
+      for (const skillDir of skillDirs) {
+        const skillMdPath = join(skillsDir, skillDir, 'SKILL.md');
+        if (!existsSync(skillMdPath)) {
+          result.warnings.push(`skills/${skillDir} 目录内缺少 SKILL.md 文件`);
+        }
+      }
+    }
+
+    const knowledgesDir = join(dirPath, 'knowledges');
+    if (existsSync(knowledgesDir) && statSync(knowledgesDir).isDirectory()) {
+      const mdFiles = execSync(`ls -1 "${knowledgesDir}"`, { encoding: 'utf-8' })
+        .split('\n')
+        .filter(l => l.trim().endsWith('.md'));
+
+      if (mdFiles.length === 0) {
+        result.warnings.push('knowledges/ 目录内没有 .md 文件');
+      }
+    }
+  } catch (err) {
+    result.valid = false;
+    result.errors.push(`AGENT.md 读取失败: ${err instanceof Error ? err.message : '未知错误'}`);
   }
 
   return result;

package/src/main.ts

@@ -1,6 +1,6 @@
 import { login, logout, getCurrentUser, register } from './cmd/auth';
 import { listSkills, searchSkills, infoSkill, downloadSkill, uploadSkill, mySkills, deleteSkill, validateSkill } from './cmd/skill';
-import { listAgents, searchAgents, infoAgent, downloadAgent, createAgent, updateAgent, deleteAgent, bindSkill, unbindSkill, bindKnowledge, unbindKnowledge } from './cmd/agent';
+import { listAgents, searchAgents, infoAgent, downloadAgent, createAgent, updateAgent, deleteAgent, bindSkill, unbindSkill, bindKnowledge, unbindKnowledge, createAgentFromFolder } from './cmd/agent';
 import { listKnowledge, searchKnowledge, infoKnowledge, downloadKnowledge, uploadKnowledge, myKnowledge, deleteKnowledge } from './cmd/knowledge';
 import { showServer, setServer } from './cmd/server';
 import { getOutputMode, setOutputMode } from './lib/output';
@@ -215,7 +215,7 @@ async function main() {
           break;
         case 'create':
           if (!args[2]) {
-            console.error('用法: arm agent create <name> [--description="..."] [--prompt="..."] [--avatar="..."] [--skill=id] [--knowledge=id] [--skill-config=\'{...}\'] [--knowledge-config=\'{...}\'] [--json]');
+            console.error('用法: arm agent create <name> [--description="..."] [--prompt="..."] [--avatar="..."] [--skill=id] [--knowledge=id] [--skill-config=\'{...}\'] [--knowledge-config=\'{...}\'] [--from=<folder-path>] [--json]');
             process.exit(1);
           }
           {
@@ -225,6 +225,7 @@ async function main() {
             const knowledges: string[] = [];
             const skillConfigs: string[] = [];
             const knowledgeConfigs: string[] = [];
+            let fromFolder: string | undefined;
 
             for (let i = 3; i < args.length; i++) {
               const arg = args[i];
@@ -242,18 +243,24 @@ async function main() {
                 skillConfigs.push(arg.split('=').slice(1).join('='));
               } else if (arg.startsWith('--knowledge-config=')) {
                 knowledgeConfigs.push(arg.split('=').slice(1).join('='));
+              } else if (arg.startsWith('--from=')) {
+                fromFolder = arg.split('=').slice(1).join('=');
               }
             }
 
-            await createAgent(name, {
-              description: options.description,
-              prompt: options.prompt,
-              avatar: options.avatar,
-              skills,
-              knowledges,
-              skillConfigs,
-              knowledgeConfigs,
-            });
+            if (fromFolder) {
+              await createAgentFromFolder(fromFolder);
+            } else {
+              await createAgent(name, {
+                description: options.description,
+                prompt: options.prompt,
+                avatar: options.avatar,
+                skills,
+                knowledges,
+                skillConfigs,
+                knowledgeConfigs,
+              });
+            }
           }
           break;
         case 'update':
@@ -368,6 +375,7 @@ async function main() {
   arm agent info <name>               查看 Agent 详情
   arm agent download <name> [dir]     下载 Agent
   arm agent create <name>             创建 Agent (--description, --prompt, --avatar, --skill, --knowledge)
+  arm agent create --from=<folder>    从本地文件夹创建 Agent
   arm agent update <id>               更新 Agent (--name, --description, --prompt, --avatar, --status)
   arm agent delete <id>                删除 Agent
   arm agent bind <id> --skill=<id>    绑定 Skill 到 Agent