ble.sh 中实现错误退出时显示耗时标记的方法

在终端环境定制工具 ble.sh 中，用户可以通过配置实现在命令执行失败时显示耗时标记的功能。这一功能对于开发者调试和性能分析非常有用，能够直观地看到失败命令的执行时长。

内置解决方案

ble.sh 的贡献配置中已经提供了两种实现方式：

1. 基础执行标记功能
   该配置会在每个命令执行后显示执行状态标记（成功/失败），但默认不包含耗时信息。用户可以通过修改配置来扩展这一功能。

2. 专门针对错误退出的耗时标记
   这是一个专门为错误退出场景设计的配置，会在命令执行失败时显示精确的执行耗时。该功能通过以下方式实现：

   • 捕获命令执行前的时间戳
   • 计算命令执行后的时间差
   • 仅在退出状态非零时显示耗时信息

自定义配置方法

用户可以根据需要自定义耗时标记的显示格式和行为：

1. 修改标记内容
   通过设置 bleopt github483_elapsed_mark 变量可以自定义标记的显示内容，支持包含时间差变量的格式化字符串。

2. 调整触发条件
   可以修改判断逻辑，使其在特定退出状态或特定条件下才显示耗时信息。

3. 扩展显示信息
   除了耗时外，还可以添加其他有用信息，如退出状态码、命令名称等。

实现原理

该功能的实现主要依赖以下技术点：

• 使用 ble.sh 的 hook 机制捕获命令执行前后的事件
• 通过 $EPOCHREALTIME 获取高精度时间戳
• 利用算术运算计算精确的时间差
• 条件判断控制信息的显示

这种实现方式既保持了终端响应的流畅性，又能提供有价值的调试信息，是 shell 环境定制的一个实用案例。

对于希望深入定制终端行为的开发者来说，ble.sh 提供的这种可扩展架构使得添加各种增强功能变得简单而灵活。