AgentScope Platform CLI (asp)

AgentScope Platform 命令行工具。默认对接：https://platform-pre.agentscope.io。

| Platform URL | | --- | | https://platform-pre.agentscope.io |

如需指向其他地址，可通过 ASP_PLATFORM_URL 或 --platform-url 覆盖。

安装

npm install -g @lsddream/platform-cli

环境变量

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

全局选项

asp --token <token>
asp --verbose
asp --json
asp --version
asp --help

鉴权

| 命令 | 说明 | | --- | --- | | asp auth login | 登录 | | asp auth status | 查看状态 | | asp auth refresh | 刷新 token | | asp auth logout | 退出 | | asp auth logs | 查看 CLI 请求留痕 |

登录方式

支持两种登录方式（与后端 /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

# 浏览器授权登录（类似 gh auth login --web）
asp auth login --browser

# 账号密码登录
asp auth login --password
asp auth login --password --account [email protected] --pass 'your-password'

典型工作流

asp auth login
asp auth status

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

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

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