agent-resource-management 2.1.4 → 2.1.6

package/dist/main.js

@@ -268,34 +268,42 @@ class ApiClient {
       throw new Error(res.msg);
     }
   }
-  async bindSkillToAgent(agentId, skillId, config) {
+  async bindSkillToAgent(agentId, skillId, version, config) {
     const res = await this.request(`/agents/${agentId}/skills`, {
       method: "POST",
-      body: JSON.stringify({ skillId, config })
+      body: JSON.stringify({ skillId, version, config })
     });
     if (!res.ok) {
       throw new Error(res.msg);
     }
   }
-  async unbindSkillFromAgent(agentId, skillId) {
-    const res = await this.request(`/agents/${agentId}/skills?skillId=${skillId}`, {
+  async unbindSkillFromAgent(agentId, skillId, version) {
+    let path = `/agents/${agentId}/skills?skillId=${skillId}`;
+    if (version) {
+      path += `&version=${version}`;
+    }
+    const res = await this.request(path, {
       method: "DELETE"
     });
     if (!res.ok) {
       throw new Error(res.msg);
     }
   }
-  async bindKnowledgeToAgent(agentId, knowledgeId, retrievalConfig) {
+  async bindKnowledgeToAgent(agentId, knowledgeId, version, retrievalConfig) {
     const res = await this.request(`/agents/${agentId}/knowledges`, {
       method: "POST",
-      body: JSON.stringify({ knowledgeId, retrievalConfig })
+      body: JSON.stringify({ knowledgeId, version, retrievalConfig })
     });
     if (!res.ok) {
       throw new Error(res.msg);
     }
   }
-  async unbindKnowledgeFromAgent(agentId, knowledgeId) {
-    const res = await this.request(`/agents/${agentId}/knowledges?knowledgeId=${knowledgeId}`, {
+  async unbindKnowledgeFromAgent(agentId, knowledgeId, version) {
+    let path = `/agents/${agentId}/knowledges?knowledgeId=${knowledgeId}`;
+    if (version) {
+      path += `&version=${version}`;
+    }
+    const res = await this.request(path, {
       method: "DELETE"
     });
     if (!res.ok) {
@@ -306,6 +314,13 @@ class ApiClient {
     const result = await this.listAgents(name, 1, 1);
     return result.agents.find((a) => a.name === name) || null;
   }
+  async getAgentBindingsHistory(agentId) {
+    const res = await this.request(`/agents/${agentId}/bindings/history`);
+    if (!res.ok) {
+      throw new Error(res.msg);
+    }
+    return res.data;
+  }
 }
 
 // src/lib/storage.ts
@@ -577,7 +592,7 @@ function setOutputMode(mode) {
 }
 
 // src/lib/validate.ts
-import { readFileSync as readFileSync2, existsSync as existsSync2, statSync as statSync2 } from "fs";
+import { readFileSync as readFileSync2, existsSync as existsSync2, statSync } from "fs";
 import { execSync } from "child_process";
 import { join as join2, extname } from "path";
 import { mkdtempSync, rmSync } from "fs";
@@ -597,7 +612,7 @@ function validateZip(filePath) {
     result.errors.push("文件必须是 ZIP 格式");
     return result;
   }
-  const stats = statSync2(filePath);
+  const stats = statSync(filePath);
   if (stats.size === 0) {
     result.valid = false;
     result.errors.push("ZIP 文件为空");
@@ -809,9 +824,9 @@ function validateAgentDir(dirPath) {
       result.errors.push("AGENT.md 缺少 frontmatter (--- 包裹的 YAML)");
     }
     const skillsDir = join2(dirPath, "skills");
-    if (existsSync2(skillsDir) && statSync2(skillsDir).isDirectory()) {
+    if (existsSync2(skillsDir) && statSync(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());
+`).filter((l) => l.trim() && existsSync2(join2(skillsDir, l)) && statSync(join2(skillsDir, l)).isDirectory());
       for (const skillDir of skillDirs) {
         const skillMdPath = join2(skillsDir, skillDir, "SKILL.md");
         if (!existsSync2(skillMdPath)) {
@@ -820,7 +835,7 @@ function validateAgentDir(dirPath) {
       }
     }
     const knowledgesDir = join2(dirPath, "knowledges");
-    if (existsSync2(knowledgesDir) && statSync2(knowledgesDir).isDirectory()) {
+    if (existsSync2(knowledgesDir) && statSync(knowledgesDir).isDirectory()) {
       const mdFiles = execSync(`ls -1 "${knowledgesDir}"`, { encoding: "utf-8" }).split(`
 `).filter((l) => l.trim().endsWith(".md"));
       if (mdFiles.length === 0) {
@@ -835,7 +850,7 @@ function validateAgentDir(dirPath) {
 }
 
 // src/cmd/skill.ts
-import { writeFileSync as writeFileSync2, existsSync as existsSync3, statSync as statSync3 } from "fs";
+import { writeFileSync as writeFileSync2, existsSync as existsSync3, statSync as statSync2 } 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";
@@ -967,7 +982,7 @@ async function downloadSkill(name, outputDir) {
     const nonZipEntries = entries.filter((e) => e !== `${name}.zip`);
     if (nonZipEntries.length === 1) {
       const onlyEntry = join3(tempDir, nonZipEntries[0]);
-      if (statSync3(onlyEntry).isDirectory()) {
+      if (statSync2(onlyEntry).isDirectory()) {
         execSync2(`cp -r "${onlyEntry}"/* "${targetDir}/"`, { stdio: "pipe" });
       } else {
         execSync2(`cp -r "${onlyEntry}" "${targetDir}/"`, { stdio: "pipe" });
@@ -1116,7 +1131,7 @@ async function deleteSkill(name) {
   }
 }
 async function validateSkill(filePath) {
-  const isDir = existsSync3(filePath) && statSync3(filePath).isDirectory();
+  const isDir = existsSync3(filePath) && statSync2(filePath).isDirectory();
   const result = isDir ? validateSkillDir(filePath) : validateZip(filePath);
   if (shouldOutputJson()) {
     outputJson({
@@ -1172,7 +1187,7 @@ async function validateSkill(filePath) {
 }
 
 // src/cmd/agent.ts
-import { writeFileSync as writeFileSync3, existsSync as existsSync4 } from "fs";
+import { writeFileSync as writeFileSync3, existsSync as existsSync4, readFileSync as readFileSync3, statSync as statSync3 } from "fs";
 import { join as join4 } from "path";
 import { execSync as execSync3 } from "child_process";
 import { mkdtempSync as mkdtempSync3, rmSync as rmSync3 } from "fs";
@@ -1283,7 +1298,7 @@ async function deleteAgent(id) {
     process.exit(1);
   }
 }
-async function bindSkill(id, skillId, config) {
+async function bindSkill(id, skillId, version = "1.0.0", config) {
   const configStore = loadConfig();
   if (!configStore?.token) {
     if (shouldOutputJson()) {
@@ -1296,12 +1311,12 @@ async function bindSkill(id, skillId, config) {
   const client = new ApiClient(configStore.serverUrl, configStore.token);
   try {
     const parsedConfig = config ? JSON.parse(config) : undefined;
-    await client.bindSkillToAgent(id, skillId, parsedConfig);
+    await client.bindSkillToAgent(id, skillId, version, parsedConfig);
     if (shouldOutputJson()) {
-      outputJson({ success: true, data: { agentId: id, skillId, config: parsedConfig } });
+      outputJson({ success: true, data: { agentId: id, skillId, version, config: parsedConfig } });
       return;
     }
-    success(`Skill "${skillId}" 已绑定到 Agent "${id}"`);
+    success(`Skill "${skillId}@${version}" 已绑定到 Agent "${id}"`);
   } catch (err) {
     if (shouldOutputJson()) {
       outputJson({ success: false, error: { code: "BIND_FAILED", message: err instanceof Error ? err.message : "未知错误" } });
@@ -1311,7 +1326,7 @@ async function bindSkill(id, skillId, config) {
     process.exit(1);
   }
 }
-async function unbindSkill(id, skillId) {
+async function unbindSkill(id, skillId, version) {
   const config = loadConfig();
   if (!config?.token) {
     if (shouldOutputJson()) {
@@ -1323,12 +1338,12 @@ async function unbindSkill(id, skillId) {
   }
   const client = new ApiClient(config.serverUrl, config.token);
   try {
-    await client.unbindSkillFromAgent(id, skillId);
+    await client.unbindSkillFromAgent(id, skillId, version);
     if (shouldOutputJson()) {
-      outputJson({ success: true, data: { agentId: id, skillId } });
+      outputJson({ success: true, data: { agentId: id, skillId, version } });
       return;
     }
-    success(`Skill "${skillId}" 已从 Agent "${id}" 解绑`);
+    success(`Skill "${skillId}${version ? "@" + version : ""}" 已从 Agent "${id}" 解绑`);
   } catch (err) {
     if (shouldOutputJson()) {
       outputJson({ success: false, error: { code: "UNBIND_FAILED", message: err instanceof Error ? err.message : "未知错误" } });
@@ -1338,7 +1353,7 @@ async function unbindSkill(id, skillId) {
     process.exit(1);
   }
 }
-async function bindKnowledge(id, knowledgeId, retrievalConfig) {
+async function bindKnowledge(id, knowledgeId, version = "1.0.0", retrievalConfig) {
   const configStore = loadConfig();
   if (!configStore?.token) {
     if (shouldOutputJson()) {
@@ -1351,12 +1366,12 @@ async function bindKnowledge(id, knowledgeId, retrievalConfig) {
   const client = new ApiClient(configStore.serverUrl, configStore.token);
   try {
     const parsedConfig = retrievalConfig ? JSON.parse(retrievalConfig) : undefined;
-    await client.bindKnowledgeToAgent(id, knowledgeId, parsedConfig);
+    await client.bindKnowledgeToAgent(id, knowledgeId, version, parsedConfig);
     if (shouldOutputJson()) {
-      outputJson({ success: true, data: { agentId: id, knowledgeId, retrievalConfig: parsedConfig } });
+      outputJson({ success: true, data: { agentId: id, knowledgeId, version, retrievalConfig: parsedConfig } });
       return;
     }
-    success(`Knowledge "${knowledgeId}" 已绑定到 Agent "${id}"`);
+    success(`Knowledge "${knowledgeId}@${version}" 已绑定到 Agent "${id}"`);
   } catch (err) {
     if (shouldOutputJson()) {
       outputJson({ success: false, error: { code: "BIND_FAILED", message: err instanceof Error ? err.message : "未知错误" } });
@@ -1366,7 +1381,7 @@ async function bindKnowledge(id, knowledgeId, retrievalConfig) {
     process.exit(1);
   }
 }
-async function unbindKnowledge(id, knowledgeId) {
+async function unbindKnowledge(id, knowledgeId, version) {
   const config = loadConfig();
   if (!config?.token) {
     if (shouldOutputJson()) {
@@ -1378,12 +1393,12 @@ async function unbindKnowledge(id, knowledgeId) {
   }
   const client = new ApiClient(config.serverUrl, config.token);
   try {
-    await client.unbindKnowledgeFromAgent(id, knowledgeId);
+    await client.unbindKnowledgeFromAgent(id, knowledgeId, version);
     if (shouldOutputJson()) {
-      outputJson({ success: true, data: { agentId: id, knowledgeId } });
+      outputJson({ success: true, data: { agentId: id, knowledgeId, version } });
       return;
     }
-    success(`Knowledge "${knowledgeId}" 已从 Agent "${id}" 解绑`);
+    success(`Knowledge "${knowledgeId}${version ? "@" + version : ""}" 已从 Agent "${id}" 解绑`);
   } catch (err) {
     if (shouldOutputJson()) {
       outputJson({ success: false, error: { code: "UNBIND_FAILED", message: err instanceof Error ? err.message : "未知错误" } });
@@ -1603,9 +1618,9 @@ async function createAgentFromFolder(folderPath) {
   const uploadedSkills = [];
   const uploadedKnowledges = [];
   const skillsDir = join4(folderPath, "skills");
-  if (existsSync4(skillsDir) && statSync(skillsDir).isDirectory()) {
+  if (existsSync4(skillsDir) && statSync3(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());
+`).filter((l) => l.trim() && existsSync4(join4(skillsDir, l)) && statSync3(join4(skillsDir, l)).isDirectory());
     for (const skillDir of skillDirs) {
       const skillPath = join4(skillsDir, skillDir);
       try {
@@ -1637,7 +1652,7 @@ async function createAgentFromFolder(folderPath) {
     }
   }
   const knowledgesDir = join4(folderPath, "knowledges");
-  if (existsSync4(knowledgesDir) && statSync(knowledgesDir).isDirectory()) {
+  if (existsSync4(knowledgesDir) && statSync3(knowledgesDir).isDirectory()) {
     const mdFiles = execSync3(`ls -1 "${knowledgesDir}"`, { encoding: "utf-8" }).split(`
 `).filter((l) => l.trim().endsWith(".md"));
     for (const mdFile of mdFiles) {
@@ -1680,13 +1695,13 @@ async function createAgentFromFolder(folderPath) {
       if (shouldOutputJson()) {
         info(`绑定技能: ${skill.name}`);
       }
-      await client.bindSkillToAgent(agent.id, skill.id);
+      await client.bindSkillToAgent(agent.id, skill.id, undefined);
     }
     for (const knowledge of uploadedKnowledges) {
       if (shouldOutputJson()) {
         info(`绑定知识: ${knowledge.title}`);
       }
-      await client.bindKnowledgeToAgent(agent.id, knowledge.id);
+      await client.bindKnowledgeToAgent(agent.id, knowledge.id, undefined);
     }
     if (shouldOutputJson()) {
       outputJson({
@@ -1711,6 +1726,244 @@ async function createAgentFromFolder(folderPath) {
     process.exit(1);
   }
 }
+async function syncAgent(folderPath, 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);
+  }
+  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);
+  }
+  const metadata = validation.metadata;
+  const agentName = metadata.name;
+  const client = new ApiClient(config.serverUrl, config.token);
+  if (shouldOutputJson()) {
+    info(`正在同步 Agent: ${agentName}...`);
+  }
+  try {
+    const result = await client.listAgents(agentName, 1, 1);
+    const existingAgent = result.agents.find((a) => a.name === agentName);
+    if (!existingAgent) {
+      if (shouldOutputJson()) {
+        outputJson({ success: false, error: { code: "NOT_FOUND", message: `Agent "${agentName}" 不存在，请先使用 arm agent create --from 创建` } });
+        process.exit(1);
+      }
+      error(`Agent "${agentName}" 不存在，请先使用 arm agent create --from 创建`);
+      process.exit(1);
+    }
+    const cloudAgent = await client.getAgent(existingAgent.id);
+    const localSkills = await parseLocalSkills(folderPath);
+    const localKnowledges = await parseLocalKnowledges(folderPath);
+    const cloudSkillBindings = cloudAgent.skills || [];
+    const cloudKnowledgeBindings = cloudAgent.knowledges || [];
+    const changes = {
+      metadataChanged: false,
+      newSkills: [],
+      removedSkills: [],
+      newKnowledges: [],
+      removedKnowledges: []
+    };
+    if (cloudAgent.prompt !== metadata.prompt || cloudAgent.description !== metadata.description) {
+      changes.metadataChanged = true;
+    }
+    const cloudSkillNames = new Set(cloudSkillBindings.map((s) => s.skill?.name).filter(Boolean));
+    for (const localSkill of localSkills) {
+      const existingBinding = cloudSkillBindings.find((sb) => sb.skill?.name === localSkill.name && sb.version === localSkill.version);
+      if (!existingBinding) {
+        changes.newSkills.push(localSkill);
+      }
+    }
+    const localSkillNames = new Set(localSkills.map((s) => s.name));
+    for (const cloudBinding of cloudSkillBindings) {
+      if (cloudBinding.skill?.name && !localSkillNames.has(cloudBinding.skill.name)) {
+        changes.removedSkills.push(cloudBinding.skill.name);
+      }
+    }
+    const cloudKnowledgeNames = new Set(cloudKnowledgeBindings.map((k) => k.knowledge?.name).filter(Boolean));
+    for (const localKnowledge of localKnowledges) {
+      const existingBinding = cloudKnowledgeBindings.find((kb) => kb.knowledge?.name === localKnowledge.name && kb.version === localKnowledge.version);
+      if (!existingBinding) {
+        changes.newKnowledges.push(localKnowledge);
+      }
+    }
+    const localKnowledgeNames = new Set(localKnowledges.map((k) => k.name));
+    for (const cloudBinding of cloudKnowledgeBindings) {
+      if (cloudBinding.knowledge?.name && !localKnowledgeNames.has(cloudBinding.knowledge.name)) {
+        changes.removedKnowledges.push(cloudBinding.knowledge.name);
+      }
+    }
+    if (options.dryRun) {
+      if (shouldOutputJson()) {
+        outputJson({
+          success: true,
+          data: {
+            agentName,
+            agentId: existingAgent.id,
+            changes,
+            dryRun: true
+          }
+        });
+        return;
+      }
+      console.log(`
+[DRY-RUN] 预览 ${agentName} 的变更:
+`);
+      if (changes.metadataChanged) {
+        console.log("  元信息: 将更新 (prompt/description 变更)");
+      }
+      if (changes.newSkills.length > 0) {
+        console.log(`  新增 Skills: ${changes.newSkills.map((s) => `${s.name}@${s.version}`).join(", ")}`);
+      }
+      if (changes.removedSkills.length > 0) {
+        console.log(`  移除 Skills: ${changes.removedSkills.join(", ")}`);
+      }
+      if (changes.newKnowledges.length > 0) {
+        console.log(`  新增 Knowledges: ${changes.newKnowledges.map((k) => `${k.name}@${k.version}`).join(", ")}`);
+      }
+      if (changes.removedKnowledges.length > 0) {
+        console.log(`  移除 Knowledges: ${changes.removedKnowledges.join(", ")}`);
+      }
+      if (!changes.metadataChanged && changes.newSkills.length === 0 && changes.removedSkills.length === 0 && changes.newKnowledges.length === 0 && changes.removedKnowledges.length === 0) {
+        console.log("  无变更");
+      }
+      return;
+    }
+    if (changes.metadataChanged) {
+      if (shouldOutputJson()) {
+        info("更新 Agent 元信息...");
+      }
+      await client.updateAgent(existingAgent.id, {
+        prompt: metadata.prompt,
+        description: metadata.description
+      });
+    }
+    for (const skill of changes.newSkills) {
+      if (shouldOutputJson()) {
+        info(`上传并绑定新技能: ${skill.name} (版本自动分配)`);
+      }
+      const skillTempDir = mkdtempSync3("/tmp/skill-sync-");
+      const zipPath = join4(skillTempDir, `${skill.name}.zip`);
+      execSync3(`cd "${skill.path}" && zip -r "${zipPath}" . -x ".*"`, { stdio: "pipe" });
+      try {
+        const uploadedSkill = await client.uploadSkill(zipPath);
+        await client.bindSkillToAgent(existingAgent.id, uploadedSkill.id, undefined);
+      } finally {
+        rmSync3(skillTempDir, { recursive: true, force: true });
+      }
+    }
+    for (const skillName of changes.removedSkills) {
+      const binding = cloudSkillBindings.find((sb) => sb.skill?.name === skillName);
+      if (binding) {
+        if (shouldOutputJson()) {
+          info(`解绑技能: ${skillName}`);
+        }
+        await client.unbindSkillFromAgent(existingAgent.id, binding.skillId, binding.version);
+      }
+    }
+    for (const knowledge of changes.newKnowledges) {
+      if (shouldOutputJson()) {
+        info(`上传并绑定新知识: ${knowledge.name} (版本自动分配)`);
+      }
+      const uploadedKnowledge = await client.uploadKnowledge(knowledge.path);
+      await client.bindKnowledgeToAgent(existingAgent.id, uploadedKnowledge.id, undefined);
+    }
+    for (const knowledgeName of changes.removedKnowledges) {
+      const binding = cloudKnowledgeBindings.find((kb) => kb.knowledge?.name === knowledgeName);
+      if (binding) {
+        if (shouldOutputJson()) {
+          info(`解绑知识: ${knowledgeName}`);
+        }
+        await client.unbindKnowledgeFromAgent(existingAgent.id, binding.knowledgeId, binding.version);
+      }
+    }
+    if (shouldOutputJson()) {
+      outputJson({
+        success: true,
+        data: {
+          agentName,
+          agentId: existingAgent.id,
+          changes
+        }
+      });
+      return;
+    }
+    success(`Agent "${agentName}" 同步完成`);
+    const changeCount = (changes.metadataChanged ? 1 : 0) + changes.newSkills.length + changes.removedSkills.length + changes.newKnowledges.length + changes.removedKnowledges.length;
+    if (changeCount === 0) {
+      info("无变更");
+    } else {
+      console.log(`  更新了 ${changeCount} 项`);
+    }
+  } catch (err) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: "SYNC_FAILED", message: err instanceof Error ? err.message : "未知错误" } });
+      process.exit(1);
+    }
+    error(`同步失败: ${err instanceof Error ? err.message : "未知错误"}`);
+    process.exit(1);
+  }
+}
+async function parseLocalSkills(folderPath) {
+  const skills = [];
+  const skillsDir = join4(folderPath, "skills");
+  if (!existsSync4(skillsDir) || !statSync3(skillsDir).isDirectory()) {
+    return skills;
+  }
+  try {
+    const skillDirs = execSync3(`ls -1 "${skillsDir}"`, { encoding: "utf-8" }).split(`
+`).filter((l) => l.trim() && existsSync4(join4(skillsDir, l)) && statSync3(join4(skillsDir, l)).isDirectory());
+    for (const skillDir of skillDirs) {
+      const skillPath = join4(skillsDir, skillDir);
+      const skillMdPath = join4(skillPath, "SKILL.md");
+      if (existsSync4(skillMdPath)) {
+        const content = readFileSync3(skillMdPath, "utf-8");
+        const versionMatch = content.match(/^---\n[\s\S]*?version:\s*(.+)\n/);
+        const version = versionMatch ? versionMatch[1].trim() : "1.0.0";
+        skills.push({ name: skillDir, path: skillPath, version });
+      }
+    }
+  } catch {}
+  return skills;
+}
+async function parseLocalKnowledges(folderPath) {
+  const knowledges = [];
+  const knowledgesDir = join4(folderPath, "knowledges");
+  if (!existsSync4(knowledgesDir) || !statSync3(knowledgesDir).isDirectory()) {
+    return knowledges;
+  }
+  try {
+    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 name = mdFile.replace(".md", "");
+      const content = readFileSync3(mdPath, "utf-8");
+      const versionMatch = content.match(/^---\n[\s\S]*?version:\s*(.+)\n/);
+      const version = versionMatch ? versionMatch[1].trim() : "1.0.0";
+      knowledges.push({ name, path: mdPath, version });
+    }
+  } catch {}
+  return knowledges;
+}
 
 // src/cmd/knowledge.ts
 import { writeFileSync as writeFileSync4, existsSync as existsSync5, statSync as statSync4 } from "fs";
@@ -2272,6 +2525,7 @@ async function main() {
         case "bind":
           if (!args[2]) {
             console.error("用法: arm agent bind <id> --skill=<skillId> [--skill-config='{...}'] 或 arm agent bind <id> --knowledge=<knowledgeId> [--knowledge-config='{...}'] [--json]");
+            console.error("注意: version 缺省时自动绑定新版本");
             process.exit(1);
           }
           {
@@ -2293,9 +2547,9 @@ async function main() {
               }
             }
             if (skillId) {
-              await bindSkill(id, skillId, skillConfig);
+              await bindSkill(id, skillId, undefined, skillConfig);
             } else if (knowledgeId) {
-              await bindKnowledge(id, knowledgeId, knowledgeConfig);
+              await bindKnowledge(id, knowledgeId, undefined, knowledgeConfig);
             } else {
               console.error("用法: arm agent bind <id> --skill=<skillId> 或 --knowledge=<knowledgeId>");
               process.exit(1);
@@ -2304,31 +2558,67 @@ async function main() {
           break;
         case "unbind":
           if (!args[2]) {
-            console.error("用法: arm agent unbind <id> --skill=<skillId> 或 --knowledge=<knowledgeId> [--json]");
+            console.error("用法: arm agent unbind <id> --skill=<skillId> [--version=<ver>] 或 --knowledge=<knowledgeId> [--version=<ver>] [--json]");
             process.exit(1);
           }
           {
             const id = args[2];
             let skillId;
             let knowledgeId;
+            let skillVersion;
+            let knowledgeVersion;
             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("--version=")) {
+                const ver = arg.split("=").slice(1).join("=");
+                if (skillId)
+                  skillVersion = ver;
+                if (knowledgeId)
+                  knowledgeVersion = ver;
               }
             }
             if (skillId) {
-              await unbindSkill(id, skillId);
+              await unbindSkill(id, skillId, skillVersion);
             } else if (knowledgeId) {
-              await unbindKnowledge(id, knowledgeId);
+              await unbindKnowledge(id, knowledgeId, knowledgeVersion);
             } else {
               console.error("用法: arm agent unbind <id> --skill=<skillId> 或 --knowledge=<knowledgeId>");
               process.exit(1);
             }
           }
           break;
+        case "sync":
+          if (!args[2]) {
+            console.error("用法: arm agent sync <folder> [--dry-run] [--force] [--json]");
+            process.exit(1);
+          }
+          {
+            const folder = args[2];
+            const syncOptions = {};
+            for (let i = 3;i < args.length; i++) {
+              const arg = args[i];
+              if (arg === "--dry-run") {
+                syncOptions.dryRun = true;
+              } else if (arg === "--force") {
+                syncOptions.force = true;
+              }
+            }
+            await syncAgent(folder, syncOptions);
+          }
+          break;
+        case "bindings":
+          if (!args[2]) {
+            console.error("用法: arm agent bindings <name> [--history] [--json]");
+            process.exit(1);
+          }
+          if (subCommand === "history") {
+            console.log("bindings history 需要通过 info 命令查看");
+          }
+          break;
         default:
           console.log(`
 可用命令:
@@ -2340,10 +2630,11 @@ async function main() {
   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
-  arm agent unbind <id> --skill=<id>  解绑 Skill
-  arm agent bind <id> --knowledge=<id> 绑定 Knowledge 到 Agent
-  arm agent unbind <id> --knowledge=<id> 解绑 Knowledge
+  arm agent bind <id> --skill=<id> [--version=<ver>]  绑定 Skill 到 Agent
+  arm agent unbind <id> --skill=<id> [--version=<ver>]  解绑 Skill
+  arm agent bind <id> --knowledge=<id> [--version=<ver>]  绑定 Knowledge 到 Agent
+  arm agent unbind <id> --knowledge=<id> [--version=<ver>] 解绑 Knowledge
+  arm agent sync <folder> [--dry-run]  同步本地文件夹到云端 Agent
   所有命令支持 --json 参数获取机器可读输出
 `);
       }
@@ -2377,12 +2668,14 @@ Agent Resource Management (arm)
   arm agent info <name>               查看 Agent 详情
   arm agent download <name> [dir]     下载 Agent
   arm agent create <name>             创建 Agent
+  arm agent create --from=<folder>    从本地文件夹创建 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 agent bind <id> --skill=<id> [--version=<ver>]  绑定 Skill
+  arm agent unbind <id> --skill=<id> [--version=<ver>]  解绑 Skill
+  arm agent bind <id> --knowledge=<id> [--version=<ver>] 绑定 Knowledge
+  arm agent unbind <id> --knowledge=<id> [--version=<ver>] 解绑 Knowledge
+  arm agent sync <folder> [--dry-run]  同步本地文件夹到云端 Agent
   arm server                          显示当前服务端
   arm server set <url>                设置服务端
   使用 arm <entity> -h 查看详细帮助

package/package.json

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

package/src/cmd/agent.ts

@@ -3,7 +3,7 @@ import { loadConfig } from '../lib/storage';
 import { formatAgent, formatAgentDetail, success, error, info } from '../lib/formatter';
 import { shouldOutputJson, outputJson } from '../lib/output';
 import { validateAgentDir } from '../lib/validate';
-import { writeFileSync, existsSync, readFileSync } from 'fs';
+import { writeFileSync, existsSync, readFileSync, statSync } from 'fs';
 import { join, basename } from 'path';
 import { execSync } from 'child_process';
 import { mkdtempSync, rmSync } from 'fs';
@@ -156,7 +156,7 @@ export async function deleteAgent(id: string): Promise<void> {
   }
 }
 
-export async function bindSkill(id: string, skillId: string, config?: string): Promise<void> {
+export async function bindSkill(id: string, skillId: string, version: string = '1.0.0', config?: string): Promise<void> {
   const configStore = loadConfig();
   if (!configStore?.token) {
     if (shouldOutputJson()) {
@@ -170,13 +170,13 @@ export async function bindSkill(id: string, skillId: string, config?: string): P
   const client = new ApiClient(configStore.serverUrl, configStore.token);
   try {
     const parsedConfig = config ? JSON.parse(config) : undefined;
-    await client.bindSkillToAgent(id, skillId, parsedConfig);
+    await client.bindSkillToAgent(id, skillId, version, parsedConfig);
 
     if (shouldOutputJson()) {
-      outputJson({ success: true, data: { agentId: id, skillId, config: parsedConfig } });
+      outputJson({ success: true, data: { agentId: id, skillId, version, config: parsedConfig } });
       return;
     }
-    success(`Skill "${skillId}" 已绑定到 Agent "${id}"`);
+    success(`Skill "${skillId}@${version}" 已绑定到 Agent "${id}"`);
   } catch (err) {
     if (shouldOutputJson()) {
       outputJson({ success: false, error: { code: 'BIND_FAILED', message: err instanceof Error ? err.message : '未知错误' } });
@@ -187,7 +187,7 @@ export async function bindSkill(id: string, skillId: string, config?: string): P
   }
 }
 
-export async function unbindSkill(id: string, skillId: string): Promise<void> {
+export async function unbindSkill(id: string, skillId: string, version?: string): Promise<void> {
   const config = loadConfig();
   if (!config?.token) {
     if (shouldOutputJson()) {
@@ -200,13 +200,13 @@ export async function unbindSkill(id: string, skillId: string): Promise<void> {
 
   const client = new ApiClient(config.serverUrl, config.token);
   try {
-    await client.unbindSkillFromAgent(id, skillId);
+    await client.unbindSkillFromAgent(id, skillId, version);
 
     if (shouldOutputJson()) {
-      outputJson({ success: true, data: { agentId: id, skillId } });
+      outputJson({ success: true, data: { agentId: id, skillId, version } });
       return;
     }
-    success(`Skill "${skillId}" 已从 Agent "${id}" 解绑`);
+    success(`Skill "${skillId}${version ? '@' + version : ''}" 已从 Agent "${id}" 解绑`);
   } catch (err) {
     if (shouldOutputJson()) {
       outputJson({ success: false, error: { code: 'UNBIND_FAILED', message: err instanceof Error ? err.message : '未知错误' } });
@@ -217,7 +217,7 @@ export async function unbindSkill(id: string, skillId: string): Promise<void> {
   }
 }
 
-export async function bindKnowledge(id: string, knowledgeId: string, retrievalConfig?: string): Promise<void> {
+export async function bindKnowledge(id: string, knowledgeId: string, version: string = '1.0.0', retrievalConfig?: string): Promise<void> {
   const configStore = loadConfig();
   if (!configStore?.token) {
     if (shouldOutputJson()) {
@@ -231,13 +231,13 @@ export async function bindKnowledge(id: string, knowledgeId: string, retrievalCo
   const client = new ApiClient(configStore.serverUrl, configStore.token);
   try {
     const parsedConfig = retrievalConfig ? JSON.parse(retrievalConfig) : undefined;
-    await client.bindKnowledgeToAgent(id, knowledgeId, parsedConfig);
+    await client.bindKnowledgeToAgent(id, knowledgeId, version, parsedConfig);
 
     if (shouldOutputJson()) {
-      outputJson({ success: true, data: { agentId: id, knowledgeId, retrievalConfig: parsedConfig } });
+      outputJson({ success: true, data: { agentId: id, knowledgeId, version, retrievalConfig: parsedConfig } });
       return;
     }
-    success(`Knowledge "${knowledgeId}" 已绑定到 Agent "${id}"`);
+    success(`Knowledge "${knowledgeId}@${version}" 已绑定到 Agent "${id}"`);
   } catch (err) {
     if (shouldOutputJson()) {
       outputJson({ success: false, error: { code: 'BIND_FAILED', message: err instanceof Error ? err.message : '未知错误' } });
@@ -248,7 +248,7 @@ export async function bindKnowledge(id: string, knowledgeId: string, retrievalCo
   }
 }
 
-export async function unbindKnowledge(id: string, knowledgeId: string): Promise<void> {
+export async function unbindKnowledge(id: string, knowledgeId: string, version?: string): Promise<void> {
   const config = loadConfig();
   if (!config?.token) {
     if (shouldOutputJson()) {
@@ -261,13 +261,13 @@ export async function unbindKnowledge(id: string, knowledgeId: string): Promise<
 
   const client = new ApiClient(config.serverUrl, config.token);
   try {
-    await client.unbindKnowledgeFromAgent(id, knowledgeId);
+    await client.unbindKnowledgeFromAgent(id, knowledgeId, version);
 
     if (shouldOutputJson()) {
-      outputJson({ success: true, data: { agentId: id, knowledgeId } });
+      outputJson({ success: true, data: { agentId: id, knowledgeId, version } });
       return;
     }
-    success(`Knowledge "${knowledgeId}" 已从 Agent "${id}" 解绑`);
+    success(`Knowledge "${knowledgeId}${version ? '@' + version : ''}" 已从 Agent "${id}" 解绑`);
   } catch (err) {
     if (shouldOutputJson()) {
       outputJson({ success: false, error: { code: 'UNBIND_FAILED', message: err instanceof Error ? err.message : '未知错误' } });
@@ -592,14 +592,14 @@ export async function createAgentFromFolder(folderPath: string): Promise<void> {
       if (shouldOutputJson()) {
         info(`绑定技能: ${skill.name}`);
       }
-      await client.bindSkillToAgent(agent.id, skill.id);
+      await client.bindSkillToAgent(agent.id, skill.id, undefined);
     }
 
     for (const knowledge of uploadedKnowledges) {
       if (shouldOutputJson()) {
         info(`绑定知识: ${knowledge.title}`);
       }
-      await client.bindKnowledgeToAgent(agent.id, knowledge.id);
+      await client.bindKnowledgeToAgent(agent.id, knowledge.id, undefined);
     }
 
     if (shouldOutputJson()) {
@@ -624,4 +624,305 @@ export async function createAgentFromFolder(folderPath: string): Promise<void> {
     error(`创建失败: ${err instanceof Error ? err.message : '未知错误'}`);
     process.exit(1);
   }
+}
+
+export interface SyncOptions {
+  dryRun?: boolean;
+  force?: boolean;
+}
+
+interface LocalSkill {
+  name: string;
+  path: string;
+  version: string;
+}
+
+interface LocalKnowledge {
+  name: string;
+  path: string;
+  version: string;
+}
+
+export async function syncAgent(folderPath: string, options: SyncOptions = {}): 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);
+  }
+
+  const metadata = validation.metadata!;
+  const agentName = metadata.name!;
+  const client = new ApiClient(config.serverUrl, config.token);
+
+  if (shouldOutputJson()) {
+    info(`正在同步 Agent: ${agentName}...`);
+  }
+
+  try {
+    const result = await client.listAgents(agentName, 1, 1);
+    const existingAgent = result.agents.find(a => a.name === agentName);
+
+    if (!existingAgent) {
+      if (shouldOutputJson()) {
+        outputJson({ success: false, error: { code: 'NOT_FOUND', message: `Agent "${agentName}" 不存在，请先使用 arm agent create --from 创建` } });
+        process.exit(1);
+      }
+      error(`Agent "${agentName}" 不存在，请先使用 arm agent create --from 创建`);
+      process.exit(1);
+    }
+
+    const cloudAgent = await client.getAgent(existingAgent.id);
+
+    const localSkills = await parseLocalSkills(folderPath);
+    const localKnowledges = await parseLocalKnowledges(folderPath);
+
+    const cloudSkillBindings = cloudAgent.skills || [];
+    const cloudKnowledgeBindings = cloudAgent.knowledges || [];
+
+    const changes: {
+      metadataChanged: boolean;
+      newSkills: LocalSkill[];
+      removedSkills: string[];
+      newKnowledges: LocalKnowledge[];
+      removedKnowledges: string[];
+    } = {
+      metadataChanged: false,
+      newSkills: [],
+      removedSkills: [],
+      newKnowledges: [],
+      removedKnowledges: [],
+    };
+
+    if (cloudAgent.prompt !== metadata.prompt || cloudAgent.description !== metadata.description) {
+      changes.metadataChanged = true;
+    }
+
+    const cloudSkillNames = new Set(cloudSkillBindings.map(s => s.skill?.name).filter(Boolean));
+    for (const localSkill of localSkills) {
+      const existingBinding = cloudSkillBindings.find(
+        sb => sb.skill?.name === localSkill.name && sb.version === localSkill.version
+      );
+      if (!existingBinding) {
+        changes.newSkills.push(localSkill);
+      }
+    }
+    const localSkillNames = new Set(localSkills.map(s => s.name));
+    for (const cloudBinding of cloudSkillBindings) {
+      if (cloudBinding.skill?.name && !localSkillNames.has(cloudBinding.skill.name)) {
+        changes.removedSkills.push(cloudBinding.skill.name);
+      }
+    }
+
+    const cloudKnowledgeNames = new Set(cloudKnowledgeBindings.map(k => k.knowledge?.name).filter(Boolean));
+    for (const localKnowledge of localKnowledges) {
+      const existingBinding = cloudKnowledgeBindings.find(
+        kb => kb.knowledge?.name === localKnowledge.name && kb.version === localKnowledge.version
+      );
+      if (!existingBinding) {
+        changes.newKnowledges.push(localKnowledge);
+      }
+    }
+    const localKnowledgeNames = new Set(localKnowledges.map(k => k.name));
+    for (const cloudBinding of cloudKnowledgeBindings) {
+      if (cloudBinding.knowledge?.name && !localKnowledgeNames.has(cloudBinding.knowledge.name)) {
+        changes.removedKnowledges.push(cloudBinding.knowledge.name);
+      }
+    }
+
+    if (options.dryRun) {
+      if (shouldOutputJson()) {
+        outputJson({
+          success: true,
+          data: {
+            agentName,
+            agentId: existingAgent.id,
+            changes,
+            dryRun: true,
+          },
+        });
+        return;
+      }
+      console.log(`\n[DRY-RUN] 预览 ${agentName} 的变更:\n`);
+      if (changes.metadataChanged) {
+        console.log('  元信息: 将更新 (prompt/description 变更)');
+      }
+      if (changes.newSkills.length > 0) {
+        console.log(`  新增 Skills: ${changes.newSkills.map(s => `${s.name}@${s.version}`).join(', ')}`);
+      }
+      if (changes.removedSkills.length > 0) {
+        console.log(`  移除 Skills: ${changes.removedSkills.join(', ')}`);
+      }
+      if (changes.newKnowledges.length > 0) {
+        console.log(`  新增 Knowledges: ${changes.newKnowledges.map(k => `${k.name}@${k.version}`).join(', ')}`);
+      }
+      if (changes.removedKnowledges.length > 0) {
+        console.log(`  移除 Knowledges: ${changes.removedKnowledges.join(', ')}`);
+      }
+      if (!changes.metadataChanged && changes.newSkills.length === 0 && changes.removedSkills.length === 0 &&
+          changes.newKnowledges.length === 0 && changes.removedKnowledges.length === 0) {
+        console.log('  无变更');
+      }
+      return;
+    }
+
+    if (changes.metadataChanged) {
+      if (shouldOutputJson()) {
+        info('更新 Agent 元信息...');
+      }
+      await client.updateAgent(existingAgent.id, {
+        prompt: metadata.prompt,
+        description: metadata.description,
+      });
+    }
+
+    for (const skill of changes.newSkills) {
+      if (shouldOutputJson()) {
+        info(`上传并绑定新技能: ${skill.name} (版本自动分配)`);
+      }
+      const skillTempDir = mkdtempSync('/tmp/skill-sync-');
+      const zipPath = join(skillTempDir, `${skill.name}.zip`);
+      execSync(`cd "${skill.path}" && zip -r "${zipPath}" . -x ".*"`, { stdio: 'pipe' });
+      try {
+        const uploadedSkill = await client.uploadSkill(zipPath);
+        await client.bindSkillToAgent(existingAgent.id, uploadedSkill.id, undefined);
+      } finally {
+        rmSync(skillTempDir, { recursive: true, force: true });
+      }
+    }
+
+    for (const skillName of changes.removedSkills) {
+      const binding = cloudSkillBindings.find(sb => sb.skill?.name === skillName);
+      if (binding) {
+        if (shouldOutputJson()) {
+          info(`解绑技能: ${skillName}`);
+        }
+        await client.unbindSkillFromAgent(existingAgent.id, binding.skillId, binding.version);
+      }
+    }
+
+    for (const knowledge of changes.newKnowledges) {
+      if (shouldOutputJson()) {
+        info(`上传并绑定新知识: ${knowledge.name} (版本自动分配)`);
+      }
+      const uploadedKnowledge = await client.uploadKnowledge(knowledge.path);
+      await client.bindKnowledgeToAgent(existingAgent.id, uploadedKnowledge.id, undefined);
+    }
+
+    for (const knowledgeName of changes.removedKnowledges) {
+      const binding = cloudKnowledgeBindings.find(kb => kb.knowledge?.name === knowledgeName);
+      if (binding) {
+        if (shouldOutputJson()) {
+          info(`解绑知识: ${knowledgeName}`);
+        }
+        await client.unbindKnowledgeFromAgent(existingAgent.id, binding.knowledgeId, binding.version);
+      }
+    }
+
+    if (shouldOutputJson()) {
+      outputJson({
+        success: true,
+        data: {
+          agentName,
+          agentId: existingAgent.id,
+          changes,
+        },
+      });
+      return;
+    }
+    success(`Agent "${agentName}" 同步完成`);
+    const changeCount = (changes.metadataChanged ? 1 : 0) + changes.newSkills.length +
+      changes.removedSkills.length + changes.newKnowledges.length + changes.removedKnowledges.length;
+    if (changeCount === 0) {
+      info('无变更');
+    } else {
+      console.log(`  更新了 ${changeCount} 项`);
+    }
+  } catch (err) {
+    if (shouldOutputJson()) {
+      outputJson({ success: false, error: { code: 'SYNC_FAILED', message: err instanceof Error ? err.message : '未知错误' } });
+      process.exit(1);
+    }
+    error(`同步失败: ${err instanceof Error ? err.message : '未知错误'}`);
+    process.exit(1);
+  }
+}
+
+async function parseLocalSkills(folderPath: string): Promise<LocalSkill[]> {
+  const skills: LocalSkill[] = [];
+  const skillsDir = join(folderPath, 'skills');
+
+  if (!existsSync(skillsDir) || !statSync(skillsDir).isDirectory()) {
+    return skills;
+  }
+
+  try {
+    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);
+      const skillMdPath = join(skillPath, 'SKILL.md');
+
+      if (existsSync(skillMdPath)) {
+        const content = readFileSync(skillMdPath, 'utf-8');
+        const versionMatch = content.match(/^---\n[\s\S]*?version:\s*(.+)\n/);
+        const version = versionMatch ? versionMatch[1].trim() : '1.0.0';
+        skills.push({ name: skillDir, path: skillPath, version });
+      }
+    }
+  } catch {
+  }
+
+  return skills;
+}
+
+async function parseLocalKnowledges(folderPath: string): Promise<LocalKnowledge[]> {
+  const knowledges: LocalKnowledge[] = [];
+  const knowledgesDir = join(folderPath, 'knowledges');
+
+  if (!existsSync(knowledgesDir) || !statSync(knowledgesDir).isDirectory()) {
+    return knowledges;
+  }
+
+  try {
+    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 name = mdFile.replace('.md', '');
+      const content = readFileSync(mdPath, 'utf-8');
+      const versionMatch = content.match(/^---\n[\s\S]*?version:\s*(.+)\n/);
+      const version = versionMatch ? versionMatch[1].trim() : '1.0.0';
+      knowledges.push({ name, path: mdPath, version });
+    }
+  } catch {
+  }
+
+  return knowledges;
 }

package/src/lib/client.ts

@@ -327,18 +327,22 @@ export class ApiClient {
     }
   }
 
-  async bindSkillToAgent(agentId: string, skillId: string, config?: Record<string, unknown>): Promise<void> {
+  async bindSkillToAgent(agentId: string, skillId: string, version: string, config?: Record<string, unknown>): Promise<void> {
     const res = await this.request<null>(`/agents/${agentId}/skills`, {
       method: 'POST',
-      body: JSON.stringify({ skillId, config }),
+      body: JSON.stringify({ skillId, version, config }),
     });
     if (!res.ok) {
       throw new Error(res.msg);
     }
   }
 
-  async unbindSkillFromAgent(agentId: string, skillId: string): Promise<void> {
-    const res = await this.request<null>(`/agents/${agentId}/skills?skillId=${skillId}`, {
+  async unbindSkillFromAgent(agentId: string, skillId: string, version?: string): Promise<void> {
+    let path = `/agents/${agentId}/skills?skillId=${skillId}`;
+    if (version) {
+      path += `&version=${version}`;
+    }
+    const res = await this.request<null>(path, {
       method: 'DELETE',
     });
     if (!res.ok) {
@@ -346,18 +350,22 @@ export class ApiClient {
     }
   }
 
-  async bindKnowledgeToAgent(agentId: string, knowledgeId: string, retrievalConfig?: { topK?: number; similarityThreshold?: number }): Promise<void> {
+  async bindKnowledgeToAgent(agentId: string, knowledgeId: string, version: string, retrievalConfig?: { topK?: number; similarityThreshold?: number }): Promise<void> {
     const res = await this.request<null>(`/agents/${agentId}/knowledges`, {
       method: 'POST',
-      body: JSON.stringify({ knowledgeId, retrievalConfig }),
+      body: JSON.stringify({ knowledgeId, version, retrievalConfig }),
     });
     if (!res.ok) {
       throw new Error(res.msg);
     }
   }
 
-  async unbindKnowledgeFromAgent(agentId: string, knowledgeId: string): Promise<void> {
-    const res = await this.request<null>(`/agents/${agentId}/knowledges?knowledgeId=${knowledgeId}`, {
+  async unbindKnowledgeFromAgent(agentId: string, knowledgeId: string, version?: string): Promise<void> {
+    let path = `/agents/${agentId}/knowledges?knowledgeId=${knowledgeId}`;
+    if (version) {
+      path += `&version=${version}`;
+    }
+    const res = await this.request<null>(path, {
       method: 'DELETE',
     });
     if (!res.ok) {
@@ -369,4 +377,31 @@ export class ApiClient {
     const result = await this.listAgents(name, 1, 1);
     return result.agents.find(a => a.name === name) || null;
   }
+
+  async getAgentBindingsHistory(agentId: string): Promise<{
+    skillBindings: Array<{
+      id: string;
+      skillId: string;
+      skillName: string;
+      version: string;
+      config: Record<string, unknown> | null;
+      createdAt: string;
+      deletedAt: string | null;
+    }>;
+    knowledgeBindings: Array<{
+      id: string;
+      knowledgeId: string;
+      knowledgeName: string;
+      version: string;
+      retrievalConfig: Record<string, unknown> | null;
+      createdAt: string;
+      deletedAt: string | null;
+    }>;
+  }> {
+    const res = await this.request<any>(`/agents/${agentId}/bindings/history`);
+    if (!res.ok) {
+      throw new Error(res.msg);
+    }
+    return res.data;
+  }
 }

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, createAgentFromFolder } from './cmd/agent';
+import { listAgents, searchAgents, infoAgent, downloadAgent, createAgent, updateAgent, deleteAgent, bindSkill, unbindSkill, bindKnowledge, unbindKnowledge, createAgentFromFolder, syncAgent } 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';
@@ -316,6 +316,7 @@ async function main() {
         case 'bind':
           if (!args[2]) {
             console.error('用法: arm agent bind <id> --skill=<skillId> [--skill-config=\'{...}\'] 或 arm agent bind <id> --knowledge=<knowledgeId> [--knowledge-config=\'{...}\'] [--json]');
+            console.error('注意: version 缺省时自动绑定新版本');
             process.exit(1);
           }
           {
@@ -339,9 +340,9 @@ async function main() {
             }
 
             if (skillId) {
-              await bindSkill(id, skillId, skillConfig);
+              await bindSkill(id, skillId, undefined, skillConfig);
             } else if (knowledgeId) {
-              await bindKnowledge(id, knowledgeId, knowledgeConfig);
+              await bindKnowledge(id, knowledgeId, undefined, knowledgeConfig);
             } else {
               console.error('用法: arm agent bind <id> --skill=<skillId> 或 --knowledge=<knowledgeId>');
               process.exit(1);
@@ -350,13 +351,15 @@ async function main() {
           break;
         case 'unbind':
           if (!args[2]) {
-            console.error('用法: arm agent unbind <id> --skill=<skillId> 或 --knowledge=<knowledgeId> [--json]');
+            console.error('用法: arm agent unbind <id> --skill=<skillId> [--version=<ver>] 或 --knowledge=<knowledgeId> [--version=<ver>] [--json]');
             process.exit(1);
           }
           {
             const id = args[2];
             let skillId: string | undefined;
             let knowledgeId: string | undefined;
+            let skillVersion: string | undefined;
+            let knowledgeVersion: string | undefined;
 
             for (let i = 3; i < args.length; i++) {
               const arg = args[i];
@@ -364,19 +367,53 @@ async function main() {
                 skillId = arg.split('=').slice(1).join('=');
               } else if (arg.startsWith('--knowledge=')) {
                 knowledgeId = arg.split('=').slice(1).join('=');
+              } else if (arg.startsWith('--version=')) {
+                const ver = arg.split('=').slice(1).join('=');
+                if (skillId) skillVersion = ver;
+                if (knowledgeId) knowledgeVersion = ver;
               }
             }
 
             if (skillId) {
-              await unbindSkill(id, skillId);
+              await unbindSkill(id, skillId, skillVersion);
             } else if (knowledgeId) {
-              await unbindKnowledge(id, knowledgeId);
+              await unbindKnowledge(id, knowledgeId, knowledgeVersion);
             } else {
               console.error('用法: arm agent unbind <id> --skill=<skillId> 或 --knowledge=<knowledgeId>');
               process.exit(1);
             }
           }
           break;
+        case 'sync':
+          if (!args[2]) {
+            console.error('用法: arm agent sync <folder> [--dry-run] [--force] [--json]');
+            process.exit(1);
+          }
+          {
+            const folder = args[2];
+            const syncOptions: { dryRun?: boolean; force?: boolean } = {};
+
+            for (let i = 3; i < args.length; i++) {
+              const arg = args[i];
+              if (arg === '--dry-run') {
+                syncOptions.dryRun = true;
+              } else if (arg === '--force') {
+                syncOptions.force = true;
+              }
+            }
+
+            await syncAgent(folder, syncOptions);
+          }
+          break;
+        case 'bindings':
+          if (!args[2]) {
+            console.error('用法: arm agent bindings <name> [--history] [--json]');
+            process.exit(1);
+          }
+          if (subCommand === 'history') {
+            console.log('bindings history 需要通过 info 命令查看');
+          }
+          break;
         default:
           console.log(`
 可用命令:
@@ -388,10 +425,11 @@ async function main() {
   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
-  arm agent unbind <id> --skill=<id>  解绑 Skill
-  arm agent bind <id> --knowledge=<id> 绑定 Knowledge 到 Agent
-  arm agent unbind <id> --knowledge=<id> 解绑 Knowledge
+  arm agent bind <id> --skill=<id> [--version=<ver>]  绑定 Skill 到 Agent
+  arm agent unbind <id> --skill=<id> [--version=<ver>]  解绑 Skill
+  arm agent bind <id> --knowledge=<id> [--version=<ver>]  绑定 Knowledge 到 Agent
+  arm agent unbind <id> --knowledge=<id> [--version=<ver>] 解绑 Knowledge
+  arm agent sync <folder> [--dry-run]  同步本地文件夹到云端 Agent
   所有命令支持 --json 参数获取机器可读输出
 `);
       }
@@ -426,12 +464,14 @@ Agent Resource Management (arm)
   arm agent info <name>               查看 Agent 详情
   arm agent download <name> [dir]     下载 Agent
   arm agent create <name>             创建 Agent
+  arm agent create --from=<folder>    从本地文件夹创建 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 agent bind <id> --skill=<id> [--version=<ver>]  绑定 Skill
+  arm agent unbind <id> --skill=<id> [--version=<ver>]  解绑 Skill
+  arm agent bind <id> --knowledge=<id> [--version=<ver>] 绑定 Knowledge
+  arm agent unbind <id> --knowledge=<id> [--version=<ver>] 解绑 Knowledge
+  arm agent sync <folder> [--dry-run]  同步本地文件夹到云端 Agent
   arm server                          显示当前服务端
   arm server set <url>                设置服务端
   使用 arm <entity> -h 查看详细帮助