命令失败提示「可回复重试让模型换一种方式」:可自愈的失败应让模型自动重试
维护者通常 1 天内回复
还没有人认领这个 Issue。
评估
- 难度
- 4/5
- 预计耗时
- 3-5 天
- 新手友好度
- 48/100
- Issue 类型
- 功能
- 描述清晰度
- 基本清楚
- 活跃度
- 活跃
- 技术栈
- typescript
调研方向
Start by tracing how run_command non-zero exits become tool results and how the current UI ends the turn and displays the retry prompt. Compare the handling of self-healable command errors with permission, rate-limit, timeout, and network failures. Done means recoverable errors let the model continue automatically while non-recoverable cases stop with targeted guidance.
由索引模型根据 Issue 内容生成。
描述
What do you want to change?
run_command 等工具执行失败(非零退出)时,UI 会在错误下方提示:
↳ 可回复「重试」让模型换一种方式,或补充说明预期结果
即结束当前回合,等用户手动输入「重试」或补充说明后才继续。
复现截图(SyntaxError 修复信息已完整可见,仍要求用户回复「重试」):

Why?
截图场景是一次典型的模型可自愈失败:heredoc 写 Python 触发 SyntaxError: f-string: empty expression not allowed,exit code 1。错误原文已经完整回灌进上下文,模型自己就知道该换写法(改写临时 .py 文件、避开引号嵌套),根本不需要用户介入。让用户打两个字「重试」,信息增益为零,只多耗一个来回。
主流 agent(Claude Code、Codex CLI、Cursor 等)的默认行为就是:tool error 作为 tool result 直接回到上下文,模型在同一回合内自行修正后重试,用户不需要说任何话。
用户手动触发「重试 / 继续」只在少数模型无法自行恢复的场景才有价值:
- 用户刚 deny / 打断了某工具的审批(模型不知道是否已解禁)
- 限流(429)、5xx、超时、网络中断——模型原地重试只是烧配额
- 缺前提:服务没起、凭证未配置、目标文件被外部改动
另外这句提示同时兜底了两种语义——「让模型换一种方式」本该是模型的自动行为,「补充说明预期结果」本该是用户自然说话,都不需要一个专门咒语。兜底成万能 hook,两边都不趁手。
How? (optional)
- 命令失败时默认把 stderr / 错误摘要作为 tool result 回灌,让模型自动重试,不结束回合
- 仅当失败属于不可自愈类型(权限被拒、限流、外部故障)才停下,并给出针对性动作(如「是否允许本次命令写入目录 X?」「429,稍后可自动重试」),而不是万能「重试」
- 如果一定要保留入口,做成按钮(Enter 重试 / e 编辑上一条消息)而不是打字咒语,且重试时携带原始错误上下文
Version: 0.1.1
本 issue 由 Step-Code agent 在自身会话中遇到该交互后自行提交。
- 主要语言
- TypeScript
- 星标
- 654
- 派生
- 55
- 平均合并
- 18 小时 11 分钟
- 30 天内合并 PR
- 22
环境准备
- 没有 Dockerfile 或 Docker Compose 文件
- 没有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
stepfun-ai/Step-Code 的其他 Issue
-
难度 2/5 1-3 小时 新手友好度 85/100
stepfun-ai/Step-Code#218 ·
维护者通常 1 天内回复
-
area/build bug
难度 2/5 1-3 小时 新手友好度 75/100
stepfun-ai/Step-Code#190 · 2 条评论 ·
维护者通常 1 天内回复
-
area/tools bug
难度 2/5 1-3 小时 新手友好度 75/100
stepfun-ai/Step-Code#186 · 1 条评论 ·
维护者通常 1 天内回复
-
area/tools bug
难度 2/5 1-3 小时 新手友好度 75/100
stepfun-ai/Step-Code#185 · 1 条评论 ·
维护者通常 1 天内回复
-
area/tools bug
难度 2/5 1-3 小时 新手友好度 75/100
stepfun-ai/Step-Code#184 · 1 条评论 ·
维护者通常 1 天内回复
查看 stepfun-ai/Step-Code 的全部 Issue
相似的 Issue
-
难度 2/5 1-3 小时 新手友好度 85/100
farbenmeer/tapi#531 ·
-
难度 2/5 1-3 小时 新手友好度 75/100
naver/egjs-flicking#971 ·
-
难度 1/5 1 小时以内 新手友好度 85/100
维护者通常 1 天内回复
-
Tenant
难度 2/5 1-3 小时 新手友好度 66/100
MTES-MCT/Dossier-Facile-Frontend#2061 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 85/100
backnotprop/plannotator#1784 ·
维护者通常 1 天内回复