一、命令基础：什么是自定义命令？为什么需要自定义命令？
大家好，我是这次课程的主讲。咱们直接进入正题。
先问个问题：你平时用自动化工具的时候，有没有遇到过这种情况——明明一个操作要重复几十遍，但工具自带的命令就是差那么一点点？
嗯，这时候你就需要自定义命令了。
1.1 什么是自定义命令？
说白了，自定义命令就是你自己写的、能被自动化工具识别和执行的一段指令。
举个例子。你有个任务：每天把某个文件夹里的图片压缩一遍，然后重命名，再上传到服务器。工具自带的命令可能只能做其中一步。但你可以写一个自定义命令，把这三步串起来，一键搞定。
我个人习惯把自定义命令看作「自动化积木」。你搭好一块，后面就能反复用。
核心定义：自定义命令 = 用户编写的、可复用的自动化指令单元。
1.2 为什么需要自定义命令？
我刚开始做自动化的时候，也觉得工具自带的命令够用了。直到有一次，客户要求批量处理 2000 个文件，每个文件的处理逻辑都不一样。
工具自带的命令？根本搞不定。
那为什么需要自定义命令？我总结了三个最实际的原因：
- 弥补工具短板——任何工具都不可能覆盖所有场景。自定义命令就是用来填坑的。
- 提升效率——把重复操作封装成一条命令，下次直接调用。省时省力。
- 保持一致性——人操作容易出错，但命令不会。写好了，每次执行结果都一样。
我的经验：遇到重复操作超过 3 次，我就开始写自定义命令。别等到第 10 次才动手，那时候你已经浪费太多时间了。
1.3 命令的本质与工作原理
命令的本质是什么？
其实很简单：输入 → 处理 → 输出。
你给它一些数据，它按照你写好的逻辑处理一遍，然后给你结果。就这么回事。
但这里有个关键点——命令是怎么被执行的？
我画个图帮你理解：
你看，流程很清晰：
- 用户输入——你敲下命令，带上参数
- 命令解析器——工具先看看你写的对不对，语法有没有问题
- 执行引擎——没问题了，开始跑你的逻辑
- 输出结果——跑完了，给你反馈
我曾经遇到过一个坑：写自定义命令时，参数没做校验。结果用户传了个空值进去，整个流程直接崩了。从那以后，我每条命令都会加参数检查。
注意：命令解析阶段如果出错，执行引擎根本不会启动。所以写命令时，语法一定要严谨。
1.4 自定义命令的常见结构
写自定义命令，一般包含这几个部分：
| 组成部分 | 说明 | 示例 |
|---|---|---|
| 命令名称 | 唯一标识，用来调用 | compress_images |
| 参数列表 | 输入的数据或选项 | --input, --quality |
| 执行逻辑 | 核心处理代码 | 压缩、重命名、上传 |
| 返回值 | 执行结果反馈 | 成功/失败/数据 |
举个简单的代码示例：
# 一个简单的自定义命令示例
def compress_images(input_path, quality=80):
"""
压缩指定路径下的所有图片
:param input_path: 图片文件夹路径
:param quality: 压缩质量，默认80
:return: 处理结果列表
"""
# 参数校验
if not input_path:
raise ValueError("输入路径不能为空")
results = []
for file in get_images(input_path):
result = compress(file, quality)
results.append(result)
return results你看，结构很清晰。参数校验、核心逻辑、返回结果，一步不少。
1.5 什么时候该用自定义命令？
我总结了一个简单的判断标准：
- 工具自带的命令能搞定？——直接用，别折腾
- 需要组合多个自带命令？——写个自定义命令串起来
- 自带命令做不到？——必须写自定义命令
- 同一个操作要做 3 次以上？——写一个，一劳永逸
小建议：别一开始就追求完美。先写一个能跑的版本，后面再慢慢优化。我见过太多人想一步到位，结果写了三天还没跑通。
好了，这一章的内容就到这里。记住：自定义命令不是什么高深的技术，它就是帮你偷懒的工具。用好了，效率翻倍。
下一章，咱们聊聊怎么写第一个自定义命令。到时候我会拿一个实际项目中的例子来演示。