list.md•4.54 kB
# preset list
以格式化表格显示所有可用的预设。
有关预设管理的完整概述,请参阅 **[预设命令概述](./index)**。
## 概要
```bash
npx -y @1mcp/agent preset list
```
## 全局选项
此命令支持所有全局选项:
- **`--config, -c <path>`** - 指定配置文件路径
- **`--config-dir, -d <path>`** - 配置目录路径
## 描述
`preset list` 命令以紧凑、有组织的表格格式显示所有配置的预设。这提供了预设配置的快速概览,包括名称、策略、查询摘要和使用信息。
### 输出格式
命令显示:
- **标题**:找到的预设总数
- **表格**:包含预设信息的组织列
- **快速参考**:预设管理的可用命令
### 表格列
- **名称**:预设标识符(如果超过 16 个字符则截断)
- **策略**:过滤方法(OR 逻辑、AND 逻辑、Advanced)
- **查询**:标签查询摘要(如果超过 33 个字符则截断)
## 示例
### 基本用法
```bash
# 列出所有预设
npx -y @1mcp/agent preset list
```
### 示例输出
```
┌─────────────── Preset Manager ──────────────┐
│ 📋 Available Presets │
│ Found 3 presets in your configuration │
└─────────────────────────────────────────────┘
┌─────────────────────────────────────────────┐
│ Name Strategy Query │
│ ──────────────── ───────── ────────────────────────────────── │
│ dev OR logic {"$or":[... │
│ production Advanced {"$and":[... │
│ staging OR logic {"tag":"staging"} │
└─────────────────────────────────────────────────────────────────────────────┘
┌──────────── Quick Reference ─────────────┐
│ Available Commands: │
│ │
│ • preset show <name> Show details │
│ • preset url <name> Generate URL │
│ • preset test <name> Test preset │
│ • preset delete <name> Delete preset │
└──────────────────────────────────────────┘
```
## 理解输出
### 空配置
如果不存在预设,命令会显示有用的指导:
```
┌──── No Presets Available ─────┐
│ ⚠️ No presets found │
└───────────────────────────────┘
Create your first preset with:
preset create <name> --filter "web,api"
1mcp preset
```
### 策略类型
- **OR 逻辑**:匹配具有任何选定标签的服务器
- **AND 逻辑**:匹配具有所有选定标签的服务器
- **Advanced**:使用自定义 JSON 查询进行复杂过滤
### 查询截断
长查询会截断为 "..." 以保持表格格式。使用 `preset show <name>` 查看完整查询。
## 工作流程集成
list 命令与其他预设命令配合良好:
```bash
# 1. 列出所有预设以查看可用的选项
npx -y @1mcp/agent preset list
# 2. 显示特定预设的详细信息
npx -y @1mcp/agent preset show production
# 3. 测试预设以查看匹配的服务器
npx -y @1mcp/agent preset test production
# 4. 为客户端配置生成 URL
npx -y @1mcp/agent preset url production
```
## 使用技巧
- **定期审查**:使用 `preset list` 定期审查您的预设配置
- **清理旧预设**:查找不需要的预设
- **快速扫描**:表格格式使比较策略和识别预设变得容易
- **跟进详细信息**:需要完整信息时使用 `preset show <name>`
## 另请参阅
- **[preset show](./show)** - 显示详细的预设信息(完整查询、匹配服务器)
- **[preset create](./create)** - 从命令行创建新预设
- **[智能交互模式](./)** - 使用交互式 TUI 创建预设
- **[preset delete](./delete)** - 删除未使用的预设