agent-resource-management 1.3.0 → 1.4.0

package/README.md

@@ -1,16 +1,17 @@
-# Agent Development Kit (ADK) - CLI
+# Agent Resource Management (ARM) - CLI
 
-Agent Skill CLI 是一个用于管理 Agent Skills 的命令行工具，支持技能的浏览、搜索、上传、下载、验证等功能。
+Agent Resource Management CLI 是一个用于管理 Skills、Knowledges 和 Agents 的命令行工具，支持浏览、搜索、上传、下载、验证等功能。
 
-**注意**: 本 CLI 需要配合 [Agent Skill Backend](https://github.com/your-repo/agent-skill-backend) 后端管理系统一起使用。请先确保后端服务已启动。
+**注意**: 本 CLI 需要配合 ARM Backend 后端管理系统一起使用。请先确保后端服务已启动。
 
 ## 功能特性
 
 - 认证管理 (登录/登出)
-- 技能浏览与搜索
-- 技能详情查看
-- 技能上传/下载/删除
-- 技能本地验证
+- Skill 浏览与搜索
+- Knowledge 浏览与搜索
+- Agent 浏览与搜索
+- 上传/下载/删除
+- 本地验证
 - 多服务端支持
 
 ## 安装
@@ -28,7 +29,7 @@ npm run build
 npm link
 
 # 验证安装
-adk --help
+arm --help
 ```
 
 ### 或使用 Bun 直接运行
@@ -43,47 +44,73 @@ bun run src/main.ts --help
 ### 1. 登录
 
 ```bash
-adk login http://localhost:3000 <your-api-key>
+arm login http://localhost:3000 <your-api-key>
 ```
 
-### 2. 浏览技能
+### 2. 浏览 Skills
 
 ```bash
-# 列出所有技能
-adk skill ls
+# 列出所有 Skills
+arm skill ls
 
-# 搜索技能
-adk skill search pdf
+# 搜索 Skills
+arm skill search pdf
 
-# 查看技能详情
-adk skill info pdf-tool
+# 查看 Skill 详情
+arm skill info pdf-tool
 ```
 
-### 3. 下载技能
+### 3. 浏览 Knowledges
 
 ```bash
-# 下载到当前目录
-adk skill download pdf-tool
+# 列出所有 Knowledges
+arm knowledge ls
 
-# 下载到指定目录
-adk skill download pdf-tool ./my-skills
+# 搜索 Knowledges
+arm knowledge search api-doc
 ```
 
-### 4. 上传技能
+### 4. 浏览 Agents
 
 ```bash
-# 上传本地技能目录
-adk skill upload ./my-skills/pdf-tool
+# 列出所有 Agents
+arm agent ls
+
+# 搜索 Agents
+arm agent search assistant
+```
+
+### 5. 下载
+
+```bash
+# 下载 Skill 到当前目录
+arm skill download pdf-tool
+
+# 下载 Knowledge 到指定目录
+arm knowledge download api-doc ./my-knowledges
+
+# 下载 Agent 到指定目录
+arm agent download workspace-assistant ./agents
+```
+
+### 6. 上传
+
+```bash
+# 上传本地 Skill 目录
+arm skill upload ./my-skills/pdf-tool
+
+# 上传本地 Knowledge 目录
+arm knowledge upload ./my-knowledges/api-doc
 ```
 
-### 5. 验证技能格式
+### 7. 验证格式
 
 ```bash
-# 验证本地技能目录
-adk skill validate ./my-skills/pdf-tool
+# 验证 Skill 目录
+arm skill validate ./my-skills/pdf-tool
 
-# 验证 ZIP 文件
-adk skill validate ./my-skills/pdf-tool.zip
+# 验证 Skill ZIP 文件
+arm skill validate ./my-skills/pdf-tool.zip
 ```
 
 ## 命令参考
@@ -92,38 +119,54 @@ adk skill validate ./my-skills/pdf-tool.zip
 
 | 命令 | 说明 |
 |------|------|
-| `adk login <server-url> <api-key>` | 登录到指定服务端 |
-| `adk logout` | 登出当前用户 |
-| `adk me` | 显示当前用户信息 |
+| `arm login <server-url> <api-key>` | 登录到指定服务端 |
+| `arm logout` | 登出当前用户 |
+| `arm me` | 显示当前用户信息 |
+
+### Skill 命令
+
+| 命令 | 说明 |
+|------|------|
+| `arm skill ls` | 列出所有公开 Skills |
+| `arm skill search <keyword>` | 搜索 Skills |
+| `arm skill info <name>` | 查看 Skill 详情 |
+| `arm skill download <name> [dir]` | 下载 Skill 到指定目录 |
+| `arm skill upload <path>` | 上传本地 Skill 目录 |
+| `arm skill my` | 查看我发布的 Skills |
+| `arm skill delete <name>` | 删除我发布的 Skill |
+| `arm skill validate <path>` | 验证 Skill 格式（支持目录和 ZIP） |
 
-### 技能浏览命令
+### Knowledge 命令
 
 | 命令 | 说明 |
 |------|------|
-| `adk skill ls` | 列出所有公开技能 |
-| `adk skill search <keyword>` | 搜索技能 |
-| `adk skill info <name>` | 查看技能详情 |
+| `arm knowledge ls` | 列出所有公开 Knowledges |
+| `arm knowledge search <keyword>` | 搜索 Knowledges |
+| `arm knowledge info <name>` | 查看 Knowledge 详情 |
+| `arm knowledge download <name> [dir]` | 下载 Knowledge 到指定目录 |
+| `arm knowledge upload <path>` | 上传本地 Knowledge 目录 |
+| `arm knowledge my` | 查看我发布的 Knowledges |
+| `arm knowledge delete <name>` | 删除我发布的 Knowledge |
 
-### 技能管理命令
+### Agent 命令
 
 | 命令 | 说明 |
 |------|------|
-| `adk skill download <name> [dir]` | 下载技能到指定目录 |
-| `adk skill upload <path>` | 上传本地技能目录 |
-| `adk skill my` | 查看我发布的技能 |
-| `adk skill delete <name>` | 删除我发布的技能 |
-| `adk skill validate <path>` | 验证技能格式（支持目录和 ZIP） |
+| `arm agent ls` | 列出所有公开 Agents |
+| `arm agent search <keyword>` | 搜索 Agents |
+| `arm agent info <name>` | 查看 Agent 详情 |
+| `arm agent download <name> [dir]` | 下载 Agent 到指定目录 |
 
 ### 服务端命令
 
 | 命令 | 说明 |
 |------|------|
-| `adk server` | 显示当前服务端 |
-| `adk server set <url>` | 设置默认服务端 |
+| `arm server` | 显示当前服务端 |
+| `arm server set <url>` | 设置默认服务端 |
 
-## 技能格式规范
+## Skill 格式规范
 
-上传的技能目录必须包含 `SKILL.md` 文件，且 frontmatter 必须符合以下格式：
+上传的 Skill 目录必须包含 `SKILL.md` 文件，且 frontmatter 必须符合以下格式：
 
 ```yaml
 ---
@@ -134,9 +177,9 @@ compatibility: 兼容性信息 # 可选
 allowed-tools: tool1 tool2 # 可选，空格分隔
 ---
 
-# 技能说明
+# Skill 说明
 
-这里是技能的详细说明文档...
+这里是 Skill 的详细说明文档...
 ```
 
 ### 验证规则
@@ -149,7 +192,7 @@ allowed-tools: tool1 tool2 # 可选，空格分隔
 
 ## 配置文件
 
-登录后配置保存在 `~/.adk/config.json`:
+登录后配置保存在 `~/.arm/config.json`:
 
 ```json
 {
@@ -181,7 +224,7 @@ npm run build
 
 ## 后端配合
 
-本 CLI 需要配合 Agent Skill Backend 使用。启动后端服务：
+本 CLI 需要配合 ARM Backend 使用。启动后端服务：
 
 ```bash
 cd backend

package/data/skills/arm-tool/SKILL.md

@@ -0,0 +1,102 @@
+---
+name: arm-tool
+description: Agent Resource Management CLI - Manage Skills, Knowledges, and Agents across the platform. Upload, search, download, and share reusable capabilities.
+license: MIT
+compatibility: Works with any ARM backend API v1
+allowed-tools: arm-cli
+---
+
+# ARM Tool
+
+Agent Resource Management (arm) CLI for managing Skills, Knowledges, and Agents.
+
+## Commands
+
+### Authentication
+
+- `arm login <server-url> <api-key>` - Login to the platform
+- `arm logout` - Logout from the platform
+- `arm me` - Show current user info
+
+### Skill Management
+
+- `arm skill ls` - List all available Skills
+- `arm skill search <keyword>` - Search Skills by keyword
+- `arm skill info <name>` - Show detailed info of a Skill
+- `arm skill download <name> [dir]` - Download a Skill as zip
+- `arm skill upload <path>` - Upload a Skill (dir or zip)
+- `arm skill my` - List Skills you've published
+- `arm skill delete <name>` - Delete your published Skill
+- `arm skill validate <path>` - Validate a Skill package
+
+### Knowledge Management
+
+- `arm knowledge ls` - List all available Knowledges
+- `arm knowledge search <keyword>` - Search Knowledges by keyword
+- `arm knowledge info <name>` - Show detailed info of a Knowledge
+- `arm knowledge download <name> [dir]` - Download a Knowledge as zip
+- `arm knowledge upload <path>` - Upload a Knowledge (dir or zip)
+- `arm knowledge my` - List Knowledges you've published
+- `arm knowledge delete <name>` - Delete your published Knowledge
+
+### Agent Management
+
+- `arm agent ls` - List all available Agents
+- `arm agent search <keyword>` - Search Agents by keyword
+- `arm agent info <name>` - Show detailed info of an Agent
+- `arm agent download <name> [dir]` - Download an Agent to local directory
+
+### Server Configuration
+
+- `arm server` - Show current server URL
+- `arm server set <url>` - Set server URL
+
+## Usage Examples
+
+### Login and Explore
+
+```bash
+# Login to the platform
+arm login https://api.example.com <your-api-key>
+
+# List all available Skills
+arm skill ls
+
+# Search for a specific Skill
+arm skill search pdf
+```
+
+### Download and Use
+
+```bash
+# Download a Skill to local
+arm skill download pdf-tool ./my-skills
+
+# Download an Agent
+arm agent download workspace-assistant ./agents
+```
+
+### Publish Your Work
+
+```bash
+# Validate before uploading
+arm skill validate ./my-custom-skill
+
+# Upload your Skill
+arm skill upload ./my-custom-skill
+
+# Check your published items
+arm skill my
+```
+
+## Concepts
+
+- **Skill**: A reusable capability package with tools and instructions
+- **Knowledge**: Document/data packages for RAG retrieval
+- **Agent**: Configured agent combining Skills, Knowledges, and prompts
+
+## Notes
+
+- All commands requiring authentication need prior login
+- Server URL is persisted locally after `arm server set`
+- Skills must contain a valid SKILL.md file to upload

package/dist/main.js

@@ -235,7 +235,7 @@ class ApiClient {
 // src/lib/storage.ts
 import { writeFileSync, readFileSync, existsSync, mkdirSync } from "fs";
 import { join } from "path";
-var CONFIG_DIR = join(process.env.HOME || "/root", ".adk");
+var CONFIG_DIR = join(process.env.HOME || "/root", ".arm");
 var CONFIG_FILE = join(CONFIG_DIR, "config.json");
 function ensureConfigDir() {
   if (!existsSync(CONFIG_DIR)) {

package/package.json

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

package/src/lib/storage.ts

@@ -1,7 +1,7 @@
 import { writeFileSync, readFileSync, existsSync, mkdirSync } from 'fs';
 import { join } from 'path';
 
-const CONFIG_DIR = join(process.env.HOME || '/root', '.adk');
+const CONFIG_DIR = join(process.env.HOME || '/root', '.arm');
 const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
 
 interface Config {

package/test-regression.sh

@@ -4,7 +4,7 @@ CLI_DIR="/Users/lk/Documents/Dev/aims/xuanwu/xuanwu-agents/agent-sdk/agent-skill
 DATA_DIR="$CLI_DIR/data/skills"
 SERVER_URL="http://localhost:3000"
 API_KEY="4567c9e607564e91b3898c46d89cb68dc4e40ec4a52b456699b695cf800fd446"
-ADK="/Users/lk/.bun/bin/bun run $CLI_DIR/src/main.ts"
+ARM="/Users/lk/.bun/bin/bun run $CLI_DIR/src/main.ts"
 
 RED='\033[0;31m'
 GREEN='\033[0;32m'
@@ -34,7 +34,7 @@ cleanup() {
     log "Cleaning up..."
     rm -rf "$DATA_DIR/pdf-tool-downloaded"
     rm -f "$DATA_DIR/test-skill.zip"
-    $ADK logout 2>/dev/null || true
+    $ARM logout 2>/dev/null || true
 }
 
 check_output() {
@@ -65,8 +65,8 @@ log "========== Regression Test Suite =========="
 cleanup
 
 echo ""
-log "=== TC-CLI-001: adk login 成功登录 ==="
-output=$($ADK login $SERVER_URL $API_KEY 2>&1)
+log "=== TC-CLI-001: arm login 成功登录 ==="
+output=$($ARM login $SERVER_URL $API_KEY 2>&1)
 if echo "$output" | grep -q "登录成功"; then
     pass "TC-CLI-001: Login successful"
 else
@@ -75,13 +75,13 @@ fi
 
 echo ""
 log "=== Setup: Upload test skills ==="
-$ADK skill upload $DATA_DIR/pdf-tool > /dev/null 2>&1
-$ADK skill upload $DATA_DIR/github-tool > /dev/null 2>&1
+$ARM skill upload $DATA_DIR/pdf-tool > /dev/null 2>&1
+$ARM skill upload $DATA_DIR/github-tool > /dev/null 2>&1
 
 echo ""
-log "=== TC-CLI-002: adk login 失败 (无效 API Key) ==="
-$ADK logout > /dev/null 2>&1
-output=$($ADK login $SERVER_URL invalid-api-key 2>&1)
+log "=== TC-CLI-002: arm login 失败 (无效 API Key) ==="
+$ARM logout > /dev/null 2>&1
+output=$($ARM login $SERVER_URL invalid-api-key 2>&1)
 if echo "$output" | grep -q "登录失败"; then
     pass "TC-CLI-002: Login with invalid key fails"
 else
@@ -89,8 +89,8 @@ else
 fi
 
 echo ""
-log "=== TC-CLI-003: adk login 失败 (无效 Server URL) ==="
-output=$($ADK login http://invalid:9999 $API_KEY 2>&1)
+log "=== TC-CLI-003: arm login 失败 (无效 Server URL) ==="
+output=$($ARM login http://invalid:9999 $API_KEY 2>&1)
 if echo "$output" | grep -q "登录失败"; then
     pass "TC-CLI-003: Login with invalid server fails"
 else
@@ -98,9 +98,9 @@ else
 fi
 
 echo ""
-log "=== TC-CLI-004: adk logout 登出 ==="
-$ADK login $SERVER_URL $API_KEY > /dev/null 2>&1
-output=$($ADK logout 2>&1)
+log "=== TC-CLI-004: arm logout 登出 ==="
+$ARM login $SERVER_URL $API_KEY > /dev/null 2>&1
+output=$($ARM logout 2>&1)
 if echo "$output" | grep -q "已退出登录"; then
     pass "TC-CLI-004: Logout successful"
 else
@@ -108,9 +108,9 @@ else
 fi
 
 echo ""
-log "=== TC-CLI-005: adk logout 未登录时 ==="
-$ADK logout > /dev/null 2>&1
-output=$($ADK logout 2>&1)
+log "=== TC-CLI-005: arm logout 未登录时 ==="
+$ARM logout > /dev/null 2>&1
+output=$($ARM logout 2>&1)
 if echo "$output" | grep -q "未登录"; then
     pass "TC-CLI-005: Logout when not logged in"
 else
@@ -118,9 +118,9 @@ else
 fi
 
 echo ""
-log "=== TC-CLI-006: adk skill ls 列出所有 Skills ==="
-$ADK login $SERVER_URL $API_KEY > /dev/null 2>&1
-output=$($ADK skill ls 2>&1)
+log "=== TC-CLI-006: arm skill ls 列出所有 Skills ==="
+$ARM login $SERVER_URL $API_KEY > /dev/null 2>&1
+output=$($ARM skill ls 2>&1)
 if echo "$output" | grep -qE "(Skill|暂无)"; then
     pass "TC-CLI-006: List skills successful"
 else
@@ -128,9 +128,9 @@ else
 fi
 
 echo ""
-log "=== TC-CLI-007: adk skill ls 未登录时 ==="
-$ADK logout > /dev/null 2>&1
-output=$($ADK skill ls 2>&1)
+log "=== TC-CLI-007: arm skill ls 未登录时 ==="
+$ARM logout > /dev/null 2>&1
+output=$($ARM skill ls 2>&1)
 if echo "$output" | grep -qE "未登录|Please login"; then
     pass "TC-CLI-007: List skills without login fails"
 else
@@ -138,9 +138,9 @@ else
 fi
 
 echo ""
-log "=== TC-CLI-008: adk skill search 搜索 Skills ==="
-$ADK login $SERVER_URL $API_KEY > /dev/null 2>&1
-output=$($ADK skill search pdf 2>&1)
+log "=== TC-CLI-008: arm skill search 搜索 Skills ==="
+$ARM login $SERVER_URL $API_KEY > /dev/null 2>&1
+output=$($ARM skill search pdf 2>&1)
 if echo "$output" | grep -qE "(找到|暂无)"; then
     pass "TC-CLI-008: Search skills successful"
 else
@@ -148,9 +148,9 @@ else
 fi
 
 echo ""
-log "=== TC-CLI-009: adk skill info 查看 Skill 详情 ==="
-$ADK login $SERVER_URL $API_KEY > /dev/null 2>&1
-output=$($ADK skill info pdf-tool 2>&1)
+log "=== TC-CLI-009: arm skill info 查看 Skill 详情 ==="
+$ARM login $SERVER_URL $API_KEY > /dev/null 2>&1
+output=$($ARM skill info pdf-tool 2>&1)
 if echo "$output" | grep -qE "(pdf-tool|Name:)"; then
     pass "TC-CLI-009: Skill info successful"
 else
@@ -158,8 +158,8 @@ else
 fi
 
 echo ""
-log "=== TC-CLI-010: adk skill info Skill 不存在 ==="
-output=$($ADK skill info non-existent-skill-xyz 2>&1)
+log "=== TC-CLI-010: arm skill info Skill 不存在 ==="
+output=$($ARM skill info non-existent-skill-xyz 2>&1)
 if echo "$output" | grep -qE "(未找到|不存在|not found)"; then
     pass "TC-CLI-010: Info for non-existent skill"
 else
@@ -167,8 +167,8 @@ else
 fi
 
 echo ""
-log "=== TC-CLI-014: adk skill upload 上传 Skill ==="
-output=$($ADK skill upload $DATA_DIR/pdf-tool 2>&1)
+log "=== TC-CLI-014: arm skill upload 上传 Skill ==="
+output=$($ARM skill upload $DATA_DIR/pdf-tool 2>&1)
 if echo "$output" | grep -qE "(上传成功|Published)"; then
     pass "TC-CLI-014: Upload skill successful"
 else
@@ -176,8 +176,8 @@ else
 fi
 
 echo ""
-log "=== TC-CLI-015: adk skill upload 目录不存在 ==="
-output=$($ADK skill upload $DATA_DIR/non-existent-dir-xyz 2>&1)
+log "=== TC-CLI-015: arm skill upload 目录不存在 ==="
+output=$($ARM skill upload $DATA_DIR/non-existent-dir-xyz 2>&1)
 if echo "$output" | grep -qE "(目录不存在|不存在)"; then
     pass "TC-CLI-015: Upload non-existent directory"
 else
@@ -185,8 +185,8 @@ else
 fi
 
 echo ""
-log "=== TC-CLI-016: adk skill upload SKILL.md 缺失 ==="
-output=$($ADK skill upload $DATA_DIR/invalid-skill 2>&1)
+log "=== TC-CLI-016: arm skill upload SKILL.md 缺失 ==="
+output=$($ARM skill upload $DATA_DIR/invalid-skill 2>&1)
 if echo "$output" | grep -qE "(缺少|无效|SKILL.md)"; then
     pass "TC-CLI-016: Upload invalid skill without SKILL.md"
 else
@@ -194,8 +194,8 @@ else
 fi
 
 echo ""
-log "=== TC-CLI-017: adk skill my 查看我的发布 ==="
-output=$($ADK skill my 2>&1)
+log "=== TC-CLI-017: arm skill my 查看我的发布 ==="
+output=$($ARM skill my 2>&1)
 if echo "$output" | grep -qE "(发布|Skill|暂无)"; then
     pass "TC-CLI-017: My skills listed"
 else
@@ -203,8 +203,8 @@ else
 fi
 
 echo ""
-log "=== TC-CLI-020: adk skill validate 验证有效 Skill ==="
-output=$($ADK skill validate $DATA_DIR/pdf-tool 2>&1)
+log "=== TC-CLI-020: arm skill validate 验证有效 Skill ==="
+output=$($ARM skill validate $DATA_DIR/pdf-tool 2>&1)
 if echo "$output" | grep -qE "(通过|Valid)"; then
     pass "TC-CLI-020: Validate valid skill"
 else
@@ -212,8 +212,8 @@ else
 fi
 
 echo ""
-log "=== TC-CLI-021: adk skill validate 验证无效 Skill ==="
-output=$($ADK skill validate $DATA_DIR/invalid-skill 2>&1)
+log "=== TC-CLI-021: arm skill validate 验证无效 Skill ==="
+output=$($ARM skill validate $DATA_DIR/invalid-skill 2>&1)
 if echo "$output" | grep -qE "(失败|Invalid|错误)"; then
     pass "TC-CLI-021: Validate invalid skill"
 else
@@ -221,8 +221,8 @@ else
 fi
 
 echo ""
-log "=== TC-CLI-011: adk skill download 下载 Skill ==="
-output=$($ADK skill download pdf-tool $DATA_DIR 2>&1)
+log "=== TC-CLI-011: arm skill download 下载 Skill ==="
+output=$($ARM skill download pdf-tool $DATA_DIR 2>&1)
 if echo "$output" | grep -qE "(已下载)"; then
     if [ -f "$DATA_DIR/pdf-tool.zip" ]; then
         pass "TC-CLI-011: Download skill successful"
@@ -234,8 +234,8 @@ else
 fi
 
 echo ""
-log "=== TC-CLI-013: adk skill download Skill 不存在 ==="
-output=$($ADK skill download non-existent-skill-xyz 2>&1)
+log "=== TC-CLI-013: arm skill download Skill 不存在 ==="
+output=$($ARM skill download non-existent-skill-xyz 2>&1)
 if echo "$output" | grep -qE "(未找到|不存在|not found)"; then
     pass "TC-CLI-013: Download non-existent skill"
 else
@@ -243,8 +243,8 @@ else
 fi
 
 echo ""
-log "=== TC-CLI-019: adk skill delete 无权限 (先上传自己的skill再删除) ==="
-output=$($ADK skill upload $DATA_DIR/github-tool 2>&1)
+log "=== TC-CLI-019: arm skill delete 无权限 (先上传自己的skill再删除) ==="
+output=$($ARM skill upload $DATA_DIR/github-tool 2>&1)
 if echo "$output" | grep -qE "(上传成功|Published)"; then
     uploaded=true
 else
@@ -252,7 +252,7 @@ else
 fi
 
 if [ "$uploaded" = true ]; then
-    output=$($ADK skill delete github-tool 2>&1)
+    output=$($ARM skill delete github-tool 2>&1)
     if echo "$output" | grep -qE "(已删除|删除成功|Deleted)"; then
         pass "TC-CLI-019: Delete own skill"
     else