ani-cli 下载工具中指定剧集参数的注意事项

ani-cli 是一个基于命令行的动画下载工具，在使用过程中，用户可能会遇到指定剧集参数时出现下载失败的情况。本文将从技术角度分析该问题的原因，并提供正确的参数传递方式。

问题现象

当用户尝试使用以下命令下载特定剧集时：

anicli 'Ore wa Subete wo' -d -e11-12

工具会返回"未找到结果"的错误提示。而直接使用-d参数不加剧集号时却能正常工作。

技术分析

参数解析机制

ani-cli 采用了自定义的参数解析逻辑而非传统的getopts方式。这种设计选择带来了以下特点：

1. 参数分隔要求：对于带有值的参数(如-e)，需要在参数和值之间保留空格
2. 多值传递：剧集参数支持同时指定多个剧集，但需要特殊处理

正确的参数格式

经过项目维护者的确认，正确的参数传递方式应为：

anicli 'Ore wa Subete wo' -d -e "11 12"

这种格式的优点是：

• 引号将多个剧集编号作为一个整体参数传递
• 工具内部会进行字符串分割处理
• 保持了命令行的清晰可读性

深入探讨

为什么不使用getopts？

虽然getopts是传统的参数解析方案，但ani-cli项目出于以下考虑选择了自定义实现：

1. 长参数支持限制：原生getopts不支持长参数(如--episode)
2. 灵活性需求：自定义实现可以更灵活地处理特殊参数格式
3. 兼容性考虑：确保在不同shell环境中的一致行为

用户建议的替代方案

有用户建议采用getopts实现，并提供了示例代码模板。该模板展示了如何：

• 同时支持短参数和长参数
• 处理带值和不带值的参数
• 提供错误处理和帮助信息

然而，项目维护者认为当前方案已经足够满足需求，且已在帮助文档中明确说明了参数使用方式。

最佳实践建议

1. 始终在参数和值之间加空格：-e 11而非-e11
2. 多剧集使用引号包裹：-e "1 2 3"
3. 查看帮助文档：使用-h参数了解最新用法
4. 测试简单命令：先尝试基本下载，再添加复杂参数

通过遵循这些实践，用户可以避免大多数参数相关的使用问题，充分发挥ani-cli的功能。