不期而至🎁 惊喜礼盒
🎁 Surprise · 不定期 · 随缘更新



用 Kimi Code CLI 做截图验证时,很容易撞上同一出戏:Read 一批 PNG 失败后,界面反复刷 “Read 4 files · failed”,参数纹丝不动,直到你手动 Esc。这不是偶发,换到 Claude Code 挂同一模型也会复现——根子不在宿主兼容,而在工具失败后的策略。
相关阅读:对话与回路:Harness / Loop 笔记。同站还有一篇 Claude → OpenCode / Kimi 迁移笔记(claude-migration-opencode-kimi,目前仍是草稿,链接后补)。
典型触发是截图验证:
temp\…\*.png 做视觉核对同类变体还有:同一批文件反复 grep/sed;auto-compact 后「忘了」失败,又从头循环;长会话里默认循环上限太高,死循环能跑很久。
对照 GitHub Issues(如 #2557、#2142、#1950、#640)和实操观察:
官方 changelog 里有过「重复无效工具调用后停轮」一类修复,但模型侧的重复倾向并未消失。
默认循环控制偏宽:
| 项 | 大致默认 | 体感 |
|---|---|---|
max_steps_per_turn | 已抬到约 1000 | 死循环能拖很久 |
max_retries_per_step | 约 3 | 单步还能再撞几次 |
截图 + temp\ 路径会放大问题:文件可能已不存在、路径/权限失败、图片字节预算踩线后无限重试;Ralph 循环(--max-ralph-iterations)若没停条件,会再放大一轮。
在 ~/.kimi-code/config.toml(或项目级配置)写明:
1[loop_control]2max_steps_per_turn = 40 # 建议 30–60,默认 1000 太高3max_retries_per_step = 2 # 建议 1–24max_ralph_iterations = 0 # 不需要 Ralph 就关掉命令行临时覆盖:
1kimi --max-steps-per-turn 40 --max-retries-per-step 2或环境变量:
1KIMI_LOOP_MAX_STEPS_PER_TURN=402KIMI_LOOP_MAX_RETRIES_PER_STEP=2改完 /reload 或重开会话。
任务描述或 /goal 里直接写死:
Do not retry identical tool calls with the same arguments after failure.官方也建议用 /goal 给多步任务一条清晰 finish line;很多人反馈,加上「失败即停」后循环明显少。
ls / dir 确认存在,再 Readtemp\ 寿命/compact 或开新会话,减轻压缩后遗忘| 场景 | 操作 | 优先级 |
|---|---|---|
| 日常配置 | 收紧 max_steps_per_turn / max_retries_per_step | 高 |
| 任务提示 | 写入「失败即停」 | 高 |
| 撞上循环 | 立刻 Esc,告诉模型跳过 | 高 |
| 图片验证 | 先确认文件存在再 Read | 中 |
| 临时文件 | 用稳定路径 | 中 |
| 长会话 | /compact 或新会话 | 中 |
| 版本 | 升级 CLI 吃官方修复 | 低 |
这不是「Kimi 和 Claude 工具不兼容」的单一锅。同一模型挂到别的宿主也会转圈,说明要模型侧继续改策略 + 用户侧主动拧上限。步数和重试压下来,再配退出指令与操作习惯,频率会明显下降。
| 项 | 说明 |
|---|---|
| 素材 | Knowledge「Kimi-Code-CLI-死循环问题」(仓外留档) |
| 配图 | 素材 assets/ 当时未随目录落地;封面为本站生成,小节示意图从缺 |
| 非目标 | 不替代官方文档;具体默认值以你本机 CLI 版本为准 |
复制链接或生成海报,发给感兴趣的人。

顺手让 Kimi Code CLI 维护一下 agentic-workbench,结果它自己把 17 个主题的资产工作台、玻璃拟态主题、SaaS 成品页全给整利索了。99 元的套餐,干出了「你按模板攒的」的完成度,盘点一下它交付了什么。
2026-08-08部分内容可能已过时
分享你的想法,与大家交流讨论
像发消息一样写就好:点工具栏插入表情 / 图片,表情会直接显示。插图 ≤5MB。
🎁 Surprise · 不定期 · 随缘更新
🎁 SURPRISE
谢谢你停在这里。愿你被温柔以待,也愿你带着一点勇气继续往前——这是我留给访客的小小礼物 🎀✨。
— threetwoa
有什么想了解的?
我基于博客内容回答