AgentScope Platform CLI (asp)

AgentScope Platform 命令行工具。默认对接生产环境：https://platform.agentscope.io。

安装

npm install -g @agentscope-ai/platform-cli

环境变量

| 变量 | 说明 | | --- | --- | | ASP_TOKEN | 访问令牌 | | ASP_PLATFORM_URL | 自定义 Platform 地址 | | ASP_CONFIG_DIR | 凭证目录，默认 ~/.asp |

全局选项

asp --token <token>
asp --platform-url <url>     # 高级：自定义 Platform 地址
asp --verbose
asp --json
asp --version
asp --help

登录方式

支持两种登录方式（与后端 /api/cli/v1 联调文档一致）：

| 方式 | 命令 | 说明 | | --- | --- | --- | | 浏览器授权（推荐） | asp auth login → 选 1 或 --browser | 打开 {platform_url}/cli/login，OAuth PKCE 授权后回调本机 | | 账号密码 | asp auth login → 选 2 或 --password | POST /auth/login |

使用方式

鉴权

asp auth login
asp auth login --browser
asp auth login --password
asp auth login --password --account [email protected] --pass 'your-password'

asp auth status
asp auth refresh
asp auth logout
asp auth logs

Plugin

# 搜索 / 查看
asp plugin search qwen
asp plugin info <plugin_id>
asp plugin versions <plugin_id>

# 安装（通过 qwenpaw）
asp plugin install <plugin_id>

# 发布：本地 zip（zip 模式下 artifact_id/version 由 complete 阶段从包内解析）
asp plugin publish ./my-plugin.zip

# 发布：URL（会优先从 URL 自动识别 category，识别不到再交互选择）
asp plugin publish --url "https://github.com/org/repo/releases/download/v1.0.0/plugin.zip" --category tool

# 查询发布进度 / 日志（支持 plugin_id；已发布插件会走 GET /plugins/{id}）
asp plugin publish status plugin_id --watch
asp plugin publish logs plugin_id

Skill

# 搜索 / 查看
asp skill search web
asp skill info <skill_id>
asp skill versions <skill_id>

# 安装（通过 qwenpaw）
asp skill install <skill_id>

# 发布：本地 zip（未传 --category 会交互选择）
asp skill publish ./my-skill.zip --category 'document office'

# 发布：URL（未传 --category 会交互选择）
asp skill publish --url "https://github.com/org/repo/releases/download/v1.0.0/skill.zip" --category 'document office'

# 查询发布进度 / 日志
asp skill publish status <skill_id> --watch
asp skill publish logs <skill_id>