preset edit

以可视化服务器选择交互式编辑现有预设。

有关预设管理的完整概述，请参阅 预设命令概述。

概要

npx -y @1mcp/agent preset edit <name> [选项]

参数

• <name>
  • 要编辑的预设名称。
  • 必需：是

选项

• --description, -d <description>
  • 更新预设的描述。
  • 必需：否

描述

preset edit 命令提供了一个交互式终端用户界面（TUI）用于修改现有预设。此命令加载现有预设并允许您可视化地修改服务器选择、策略和其他设置。

功能

• 可视化服务器选择，具有三态复选框（空/选中/未选中）
• 实时预览匹配的服务器，当您进行选择时
• 策略修改（OR/AND/Advanced），提供清晰的解释
• 返回导航和全面的错误处理
• 描述编辑 - 在编辑期间更新预设描述
• 加载现有配置 - 在允许修改时保留当前设置

交互流程

1. 预设加载：加载现有预设配置
2. 当前显示：显示预设名称、描述和当前设置
3. 策略选择：修改标签应该如何匹配：
   • OR 逻辑：具有任何选定标签的服务器
   • AND 逻辑：具有所有选定标签的服务器
   • Advanced：用于复杂过滤的自定义 JSON 查询
4. 标签选择：可视化选择界面，包括：
   • 三态选择（空/包含/排除）
   • 每个标签的服务器计数
   • 匹配服务器的实时预览
5. 描述更新：更新预设描述的选项
6. 保存和确认：自动保存回相同的预设名称

示例

基本预设编辑

# 编辑开发预设
npx -y @1mcp/agent preset edit development

# 编辑生产预设
npx -y @1mcp/agent preset edit production

使用描述更新进行编辑

# 编辑预设并更新描述
npx -y @1mcp/agent preset edit staging --description "更新的暂存环境，包含监控"

示例输出

npx -y @1mcp/agent preset edit development

📁 配置目录：/Users/user/.config/1mcp

📝 正在编辑预设：development
   描述：开发服务器

[交互式 TUI 打开，加载当前配置]

✅ 预设 'development' 更新成功！
🔗 URL：http://127.0.0.1:3050/?preset=development

交互模式详情

服务器选择界面

交互模式提供：

• 三态复选框：

  • [ ] - 未选择（服务器排除）
  • [✓] - 已选择（服务器包含）
  • [-] - 未选择（服务器排除）

• 实时预览：显示哪些服务器与您当前选择匹配

• 标签统计：显示每个标签的服务器计数

• 策略切换：即时切换过滤逻辑

策略选项

• OR 逻辑：包含具有任何选定标签的服务器
• AND 逻辑：包含具有所有选定标签的服务器
• Advanced：使用带括号的复杂布尔表达式

使用技巧

• 编辑前查看：使用 preset show <name> 查看当前配置
• 更改后测试：运行 preset test <name> 验证更新的预设是否正常工作
• 更新描述：更改预设行为时保持描述最新
• 使用实时预览：始终检查预览以确保您的更改符合预期

错误处理

预设未找到

npx -y @1mcp/agent preset edit nonexistent
# 错误：未找到预设 'nonexistent'

配置问题

如果预设配置损坏或无法访问：

npx -y @1mcp/agent preset edit broken-preset
# 错误：无法加载预设 'broken-preset'

工作流集成

开发工作流

# 1. 查看当前预设
npx -y @1mcp/agent preset show development

# 2. 编辑预设以添加新服务器
npx -y @1mcp/agent preset edit development

# 3. 测试更新的预设
npx -y @1mcp/agent preset test development

# 4. 为客户端获取更新的 URL
npx -y @1mcp/agent preset url development

团队环境管理

# 当服务器配置更改时更新团队预设
npx -y @1mcp/agent preset edit team-dev
npx -y @1mcp/agent preset edit team-prod
npx -y @1mcp/agent preset edit team-staging

与其他命令的比较

preset edit 与智能交互模式

• preset edit <name>：现有预设的直接编辑工作流
• 1mcp preset：智能模式，自动检测现有预设并提供编辑选项

preset edit 与 preset create

• preset edit：使用可视化界面修改现有预设
• preset create：从命令行过滤表达式创建新预设

高级用法

复杂配置更新

# 编辑预设以使用 AND 逻辑而不是 OR
npx -y @1mcp/agent preset edit production
# 在交互模式中：将策略从 OR 切换到 AND 逻辑

# 编辑预设以排除实验服务器
npx -y @1mcp/agent preset edit development
# 在交互模式中：选择 Advanced 策略并添加 NOT 条件

批量更新

# 使用类似更改更新多个预设
for preset in dev staging prod; do
  echo "正在编辑 $preset..."
  npx -y @1mcp/agent preset edit $preset
done

最佳实践

编辑前

1. 备份重要预设：使用 preset show <name> 记录当前状态
2. 测试当前预设：运行 preset test <name> 建立基线
3. 检查团队依赖项：确保没有团队成员正在使用该预设
4. 计划更改：知道您要添加或删除哪些服务器/标签

编辑期间

1. 使用实时预览：保存前始终验证匹配的服务器
2. 更新描述：更改行为时保持描述准确
3. 测试策略：尝试不同的过滤策略以找到最佳策略
4. 经常保存：交互模式在您退出时自动保存

编辑后

1. 测试预设：使用 preset test <name> 验证其按预期工作
2. 更新团队文档：将重大更改告知团队成员
3. 更新客户端配置：如需要共享新的 URL
4. 监控使用情况：在实践中检查更新的预设是否良好工作

另请参阅

• 智能交互模式 - 自动检测现有预设并提供编辑选项
• preset show - 编辑前显示详细预设信息
• preset test - 进行更改后测试预设
• preset create - 创建新预设
• preset list - 列出所有可用预设