命令失败提示「可回复重试让模型换一种方式」:可自愈的失败应让模型自动重试
メンテナーはふだん 1 日以内に返信
まだ誰も着手していません。
評価
- 難易度
- 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
- 平均マージ
- 2日 3時間
- マージ済み PR(30日)
- 28
環境構築
- Dockerfile・Docker Compose ファイルなし
- プルリクエストのテンプレートなし
- コントリビューションガイドを読む
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- 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
-
難易度 1/5 1時間未満 初心者へのやさしさ 85/100
lukilabs/beautiful-mermaid#160 ·
-
難易度 2/5 1〜3時間 初心者へのやさしさ 66/100
rescript-lang/rescript-lang.org#1420 ·
メンテナーはふだん 2 日以内に返信
-
bug
難易度 2/5 1〜3時間 初心者へのやさしさ 82/100
chthollyphile/folia-major#520 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 82/100
databuddy-analytics/Databuddy#1106 ·
メンテナーはふだん 1 日以内に返信