agent-resource-management 2.1.0 → 2.1.1

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);
@@ -1587,6 +1638,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 +1732,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>");
@@ -2019,6 +2088,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.1",
   "type": "module",
   "bin": {
     "arm": "./dist/main.js"

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/main.ts

@@ -1,4 +1,4 @@
-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 { listKnowledge, searchKnowledge, infoKnowledge, downloadKnowledge, uploadKnowledge, myKnowledge, deleteKnowledge } from './cmd/knowledge';
@@ -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>');
@@ -368,6 +384,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)