参数与历史
本文介绍快速命令中自定义参数的使用方法和历史回填功能。
什么是自定义参数
自定义参数是用户定义的占位符，执行命令时需要手动输入值。与动态变量不同，自定义参数的值由用户决定，系统会自动记录历史输入，方便下次快速选择。
自定义参数的特点：
- 使用
${{参数名}}语法（参数名不能是动态变量名） - 执行时需要用户输入值
- 自动保存历史输入值
- 在参数填写窗口中以蓝色标签显示
参数语法
基本语法
${{参数名}}
参数名可以是任意英文字母、数字和下划线的组合，例如：
${{container}}${{database_name}}${{port}}
多参数命令
一条命令可以包含多个参数：
docker exec -it ${{container}} /bin/${{shell}}
执行时会依次提示输入每个参数的值。
使用示例
Docker 容器操作
# 进入容器
docker exec -it ${{container}} /bin/bash
# 查看容器日志
docker logs -f --tail ${{lines}} ${{container}}
# 复制文件到容器
docker cp ${{local_path}} ${{container}}:${{remote_path}}
服务管理
# 重启服务
systemctl restart ${{service}}
# 查看服务状态
systemctl status ${{service}}
文件操作
# 查看日志
tail -f ${{log_path}}
# 搜索文件内容
grep -r "${{keyword}}" ${{directory}}
数据库操作
# MySQL 连接
mysql -h ${{host}} -u ${{user}} -p${{password}} ${{database}}
# 数据库备份
mysqldump -u ${{user}} -p ${{database}} > ${{filename}}.sql
参数填写窗口
执行包含参数的命令时，会弹出参数填写窗口：
窗口组成：
| 区域 | 说明 |
|---|---|
| 命令名称 | 显示在标题栏右侧 |
| 参数输入框 | 每个参数一个输入框，蓝色标签显示参数名 |
| 历史值提示 | 输入框下方显示历史使用过的值 |
| 命令预览 | 底部 PREVIEW 区域显示替换后的完整命令 |
历史回填
系统会自动记录每个参数的历史输入值，方便快速选择。
查看历史值
在参数输入框下方，会显示该参数最近使用过的值，带有 "recent" 标签。
使用历史值
点击历史值即可自动填入输入框，无需重新输入。
历史值特点
- 按最近使用时间排序
- 每个参数独立记录
- 跨命令共享（相同参数名共享历史）
- 自动清理过旧的记录
混合使用
自定义参数可以与动态变量混合使用：
# 备份数据库，文件名包含日期
mysqldump -u ${{user}} -p ${{database}} > backup_${{database}}_${{date:YYYYMMDD}}.sql
执行时：
user和database需要手动输入（可选历史值）date:YYYYMMDD自动填充为当前日期
参数命名建议
| 场景 | 建议参数名 | 示例 |
|---|---|---|
| 容器名 | container | ${{container}} |
| 服务名 | service | ${{service}} |
| 主机地址 | host | ${{host}} |
| 端口号 | port | ${{port}} |
| 用户名 | user | ${{user}} |
| 数据库名 | database, db | ${{database}} |
| 文件路径 | path, file | ${{path}} |
| 搜索关键词 | keyword, search | ${{keyword}} |
使用有意义的参数名可以：
- 提高命令可读性
- 跨命令共享历史值
- 方便团队协作
实用技巧
设置默认值
如果某个参数经常使用相同的值，可以：
- 第一次输入并执行命令
- 之后执行时直接从历史值选择
参数复用
相同参数名会共享历史值。例如：
# 命令1：进入容器
docker exec -it ${{container}} bash
# 命令2：查看容器日志
docker logs -f ${{container}}
在命令1中输入的容器名，在命令2中可以直接从历史中选择。
只粘贴不执行
如果需要在执行前检查或修改命令：
- 右键点击命令
- 选择粘贴到终端
- 填写参数后，命令会粘贴到终端
- 手动检查并按回车执行