agent-resource-management 2.1.0 → 2.1.2

package/README.md

@@ -13,6 +13,7 @@ Agent Resource Management CLI 是一个用于管理 Skills、Knowledges 和 Agen
 - 上传/下载/删除
 - 本地验证
 - 多服务端支持
+- **JSON 输出模式** - 便于 AI Agent 集成
 
 ## 安装
 
@@ -96,10 +97,10 @@ arm agent download workspace-assistant ./agents
 ### 6. 上传
 
 ```bash
-# 上传本地 Skill 目录
+# 上传本地 Skill 目录或 ZIP 文件
 arm skill upload ./my-skills/pdf-tool
 
-# 上传本地 Knowledge 目录
+# 上传本地 Knowledge 文件或目录
 arm knowledge upload ./my-knowledges/api-doc
 ```
 
@@ -113,6 +114,39 @@ arm skill validate ./my-skills/pdf-tool
 arm skill validate ./my-skills/pdf-tool.zip
 ```
 
+### 8. JSON 输出模式
+
+CLI 默认输出 JSON 格式，便于 AI Agent 解析和集成：
+
+```bash
+# 查看当前输出模式
+arm output
+
+# 切换为文本模式（人类可读）
+arm output text
+
+# 切换为 JSON 模式（默认）
+arm output json
+
+# 所有命令都支持 --json 参数强制输出 JSON
+arm agent create my-agent --json
+arm skill ls --json
+```
+
+JSON 输出格式：
+
+```json
+{
+  "success": true,
+  "data": { ... }
+}
+// 或
+{
+  "success": false,
+  "error": { "code": "ERROR_CODE", "message": "错误信息" }
+}
+```
+
 ## 命令参考
 
 ### 认证命令
@@ -131,7 +165,7 @@ arm skill validate ./my-skills/pdf-tool.zip
 | `arm skill search <keyword>` | 搜索 Skills |
 | `arm skill info <name>` | 查看 Skill 详情 |
 | `arm skill download <name> [dir]` | 下载 Skill 到指定目录 |
-| `arm skill upload <path>` | 上传本地 Skill 目录 |
+| `arm skill upload <path>` | 上传本地 Skill 目录或 ZIP 文件 |
 | `arm skill my` | 查看我发布的 Skills |
 | `arm skill delete <name>` | 删除我发布的 Skill |
 | `arm skill validate <path>` | 验证 Skill 格式（支持目录和 ZIP） |
@@ -144,7 +178,7 @@ arm skill validate ./my-skills/pdf-tool.zip
 | `arm knowledge search <keyword>` | 搜索 Knowledges |
 | `arm knowledge info <name>` | 查看 Knowledge 详情 |
 | `arm knowledge download <name> [dir]` | 下载 Knowledge 到指定目录 |
-| `arm knowledge upload <path>` | 上传本地 Knowledge 目录 |
+| `arm knowledge upload <path>` | 上传本地 Knowledge 文件或目录 |
 | `arm knowledge my` | 查看我发布的 Knowledges |
 | `arm knowledge delete <name>` | 删除我发布的 Knowledge |
 
@@ -164,6 +198,26 @@ arm skill validate ./my-skills/pdf-tool.zip
 | `arm server` | 显示当前服务端 |
 | `arm server set <url>` | 设置默认服务端 |
 
+### 输出模式命令
+
+| 命令 | 说明 |
+|------|------|
+| `arm output` | 查看当前输出模式 |
+| `arm output json` | 设置为 JSON 模式（默认） |
+| `arm output text` | 设置为文本模式 |
+
+### 输出格式说明
+
+所有命令都支持 `--json` 或 `-j` 参数强制输出 JSON 格式。当默认模式为 `json` 时，所有命令直接返回 JSON。
+
+**Agent 命令（创建/更新/删除/绑定/解绑）** 始终支持 `--json`：
+```bash
+arm agent create my-agent --json
+arm agent update <id> --name=new-name --json
+arm agent delete <id> --json
+arm agent bind <id> --skill=<id> --json
+```
+
 ## Skill 格式规范
 
 上传的 Skill 目录必须包含 `SKILL.md` 文件，且 frontmatter 必须符合以下格式：
@@ -202,10 +256,13 @@ allowed-tools: tool1 tool2 # 可选，空格分隔
     "id": "user-id",
     "name": "username",
     "email": "user@example.com"
-  }
+  },
+  "outputMode": "json"
 }
 ```
 
+其中 `outputMode` 可选值为 `json`（默认）或 `text`。
+
 ## 开发
 
 ```bash

package/dist/main.js

@@ -40,6 +40,16 @@ class ApiClient {
     }
     return res.data;
   }
+  async register(email, password, name) {
+    const res = await this.request("/auth/register", {
+      method: "POST",
+      body: JSON.stringify({ email, password, name })
+    });
+    if (!res.ok) {
+      throw new Error(res.msg);
+    }
+    return res.data;
+  }
   async me() {
     const res = await this.request("/auth/me");
     if (!res.ok) {
@@ -462,6 +472,47 @@ function formatKnowledgeDetail(knowledge) {
 }
 
 // src/cmd/auth.ts
+async function register(name, email, password) {
+  const { readline } = await import("readline");
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  const ask = (question) => new Promise((resolve) => rl.question(question, resolve));
+  let finalEmail = email;
+  let finalPassword = password;
+  let finalName = name;
+  if (!finalEmail) {
+    finalEmail = await ask("请输入邮箱: ");
+  }
+  if (!finalPassword) {
+    finalPassword = await ask("请输入密码: ");
+  }
+  if (!finalName) {
+    finalName = await ask("请输入用户名: ");
+  }
+  rl.close();
+  if (!finalEmail || !finalPassword || !finalName) {
+    error("邮箱、密码和用户名都不能为空");
+    process.exit(1);
+  }
+  if (finalPassword.length < 8) {
+    error("密码至少需要 8 个字符");
+    process.exit(1);
+  }
+  const config = loadConfig();
+  const serverUrl = config?.serverUrl || "http://localhost:3000";
+  const client = new ApiClient(serverUrl);
+  try {
+    const result = await client.register(finalEmail, finalPassword, finalName);
+    saveConfig({
+      serverUrl,
+      token: result.token,
+      user: result.user
+    });
+    success(`注册成功! 欢迎, ${result.user.name}`);
+  } catch (err) {
+    error(`注册失败: ${err instanceof Error ? err.message : "未知错误"}`);
+    process.exit(1);
+  }
+}
 async function login(serverUrl, apiKey) {
   try {
     const client = new ApiClient(serverUrl);
@@ -526,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";
@@ -546,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 文件为空");
@@ -696,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";
@@ -959,7 +1096,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({
@@ -1411,10 +1548,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() {
@@ -1568,12 +1848,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" });
     }
@@ -1587,6 +1867,9 @@ async function uploadKnowledge(filePath) {
       return;
     }
     success(`上传成功! Knowledge: ${knowledge.name}`);
+    if (knowledge.shareUrl) {
+      info(`分享链接: ${knowledge.shareUrl}`);
+    }
   } catch (err) {
     if (shouldOutputJson()) {
       outputJson({ success: false, error: { code: "UPLOAD_FAILED", message: err instanceof Error ? err.message : "未知错误" } });
@@ -1678,6 +1961,21 @@ var command = args[0];
 var subCommand = args[1];
 async function main() {
   switch (command) {
+    case "register":
+      if (args[1] && args[1].startsWith("--")) {
+        const options = {};
+        for (let i = 1;i < args.length; i++) {
+          const arg = args[i];
+          if (arg.startsWith("--")) {
+            const [key, value] = arg.slice(2).split("=");
+            options[key] = value;
+          }
+        }
+        await register(options.name, options.email, options.password);
+      } else {
+        await register(args[1], args[2], args[3]);
+      }
+      break;
     case "login":
       if (!args[1] || !args[2]) {
         console.error("用法: arm login <server-url> <api-key>");
@@ -1859,7 +2157,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);
           }
           {
@@ -1869,6 +2167,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=")) {
@@ -1885,17 +2184,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":
@@ -2004,6 +2309,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
@@ -2019,6 +2325,7 @@ async function main() {
 Agent Resource Management (arm)
 
 用法:
+  arm register [--name=<name>] [--email=<email>] [--password=<password>]  注册 (交互式或参数)
   arm login <server-url> <api-key>   登录
   arm logout                          登出
   arm output [json|text]              设置/查看输出模式 (默认json)

package/dist/test.md

@@ -0,0 +1,3 @@
+# test
+- hi
+- huw

package/dist/test2.md

@@ -0,0 +1,3 @@
+# test
+- hi
+- huw

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-resource-management",
-  "version": "2.1.0",
+  "version": "2.1.2",
   "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/auth.ts

@@ -2,6 +2,56 @@ import { ApiClient } from '../lib/client';
 import { loadConfig, saveConfig } from '../lib/storage';
 import { success, error, info } from '../lib/formatter';
 
+export async function register(name?: string, email?: string, password?: string): Promise<void> {
+  const { readline } = await import('readline');
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+
+  const ask = (question: string): Promise<string> =>
+    new Promise((resolve) => rl.question(question, resolve));
+
+  let finalEmail = email;
+  let finalPassword = password;
+  let finalName = name;
+
+  if (!finalEmail) {
+    finalEmail = await ask('请输入邮箱: ');
+  }
+  if (!finalPassword) {
+    finalPassword = await ask('请输入密码: ');
+  }
+  if (!finalName) {
+    finalName = await ask('请输入用户名: ');
+  }
+  rl.close();
+
+  if (!finalEmail || !finalPassword || !finalName) {
+    error('邮箱、密码和用户名都不能为空');
+    process.exit(1);
+  }
+
+  if (finalPassword.length < 8) {
+    error('密码至少需要 8 个字符');
+    process.exit(1);
+  }
+
+  const config = loadConfig();
+  const serverUrl = config?.serverUrl || 'http://localhost:3000';
+  const client = new ApiClient(serverUrl);
+
+  try {
+    const result = await client.register(finalEmail, finalPassword, finalName);
+    saveConfig({
+      serverUrl,
+      token: result.token,
+      user: result.user,
+    });
+    success(`注册成功! 欢迎, ${result.user.name}`);
+  } catch (err) {
+    error(`注册失败: ${err instanceof Error ? err.message : '未知错误'}`);
+    process.exit(1);
+  }
+}
+
 export async function login(serverUrl: string, apiKey: string): Promise<void> {
   try {
     const client = new ApiClient(serverUrl);

package/src/cmd/knowledge.ts

@@ -185,6 +185,9 @@ export async function uploadKnowledge(filePath: string): Promise<void> {
       return;
     }
     success(`上传成功! Knowledge: ${knowledge.name}`);
+    if (knowledge.shareUrl) {
+      info(`分享链接: ${knowledge.shareUrl}`);
+    }
   } catch (err) {
     if (shouldOutputJson()) {
       outputJson({ success: false, error: { code: 'UPLOAD_FAILED', message: err instanceof Error ? err.message : '未知错误' } });

package/src/lib/client.ts

@@ -1,4 +1,4 @@
-import type { User, Skill, SkillListResponse, ApiResponse, LoginResponse, Agent, AgentListResponse } from '@pkg/types/skill';
+import type { User, Skill, SkillListResponse, ApiResponse, LoginResponse, RegisterResponse, Agent, AgentListResponse } from '@pkg/types/skill';
 
 export class ApiClient {
   private token: string | null = null;
@@ -49,6 +49,17 @@ export class ApiClient {
     return res.data;
   }
 
+  async register(email: string, password: string, name: string): Promise<RegisterResponse> {
+    const res = await this.request<RegisterResponse>('/auth/register', {
+      method: 'POST',
+      body: JSON.stringify({ email, password, name }),
+    });
+    if (!res.ok) {
+      throw new Error(res.msg);
+    }
+    return res.data;
+  }
+
   async me(): Promise<User> {
     const res = await this.request<User>('/auth/me');
     if (!res.ok) {

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 } from './cmd/auth';
+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';
@@ -11,6 +11,22 @@ const subCommand = args[1];
 
 async function main() {
   switch (command) {
+    case 'register':
+      if (args[1] && args[1].startsWith('--')) {
+        const options: Record<string, string | undefined> = {};
+        for (let i = 1; i < args.length; i++) {
+          const arg = args[i];
+          if (arg.startsWith('--')) {
+            const [key, value] = arg.slice(2).split('=');
+            options[key] = value;
+          }
+        }
+        await register(options.name, options.email, options.password);
+      } else {
+        await register(args[1], args[2], args[3]);
+      }
+      break;
+
     case 'login':
       if (!args[1] || !args[2]) {
         console.error('用法: arm login <server-url> <api-key>');
@@ -199,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);
           }
           {
@@ -209,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];
@@ -226,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':
@@ -352,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
@@ -368,6 +392,7 @@ async function main() {
 Agent Resource Management (arm)
 
 用法:
+  arm register [--name=<name>] [--email=<email>] [--password=<password>]  注册 (交互式或参数)
   arm login <server-url> <api-key>   登录
   arm logout                          登出
   arm output [json|text]              设置/查看输出模式 (默认json)