退出码¶

基于当前实现行为的 clinvk 退出码参考。

概述¶

clinvk 使用进程退出码来表示执行结果，便于脚本与自动化处理。

代码	名称	描述
0	成功	命令成功完成
1	一般错误	校验 / 配置 / 运行时错误，或聚合子命令失败
6	超时	命令超过 `unified_flags.command_timeout_secs` 且超时错误冒泡到顶层
2+	后端退出码	在 `prompt` / `resume` 路径透传后端 CLI 退出码

代码	含义
0	所有单元执行成功
1	一个或多个单元失败（包含单元内超时）

代码	含义
0	命令成功
1	命令失败

当 unified_flags.command_timeout_secs 配置为正数时：

示例：

# config.yaml
unified_flags:
  command_timeout_secs: 5

clinvk "长时间任务"
echo $?  # 在顶层 prompt/resume 路径超时时为 6

clinvk "任务"
code=$?

case $code in
  0)
    echo "成功"
    ;;
  6)
    echo "超时"
    ;;
  *)
    echo "失败，退出码: $code"
    ;;
esac

set -e

clinvk "步骤 1"
clinvk "步骤 2"