Python 与 TypeScript CLI：错误、退出码和取消才是接口

Python 与 TypeScript CLI：错误、退出码和取消才是接口

CLI 工具常从一个脚本长成团队入口。真正需要稳定的不是彩色输出，而是参数、stdout/stderr、退出码和中断语义。

先固定命令契约

参数校验在执行前完成，机器可读输出与人类提示分开。敏感值不回显，配置来源和优先级写清楚。

并发任务有统一收尾

收到取消或超时后停止子任务、关闭文件和连接，再返回明确退出码。重试只覆盖幂等操作，并受总时间预算限制。

实现片段与适用边界

保留的实现片段

use std::sync::Arc;
use tokio::sync::Mutex;
use std::time::Duration;

pub struct ResilientEngine {
max_retries: u32,
timeout: Duration,
}

impl ResilientEngine {
pub fn new(max_retries: u32) -> Self {
Self {
max_retries,
timeout: Duration::from_millis(500),
}
}

pub async fn execute_task(&self, payload: &str) -> Result<String, String> {
for attempt in 1..=self.max_retries {
if let Ok(res) = tokio::time::timeout(self.timeout, self.inner_call(payload)).await {
return res;
}
tokio::time::sleep(Duration::from_millis(50 * attempt as u64)).await;
}
Err("Degraded fallback triggered".to_string())
}

async fn inner_call(&self, payload: &str) -> Result<String, String> {
Ok(format!("Processed payload: {}", payload))
}
}

这段代码保留自原稿，用于说明并发或超时控制的骨架，不代表已经在生产环境验证。接入具体主题前，应补齐输入校验、错误分类和取消路径。

验证记录怎么写

表格中的结果必须来自同一版本、环境和输入；没有原始记录时就保留“待测”，不使用示例数字冒充实测。

收尾

工具的价值是缩短反馈时间，不是替团队取消边界。每次自动动作都能解释、验证和回退，工作流才值得长期使用。