Files
proxycast/docs/content/02.user-guide/5.resilience.md
T
coso 7851c34bed release: v0.68.0
## Features
- 版本升级至 0.68.0

## Fixes
- 修复 EmptyState 组件标题排版问题
- 修复"开始生成"按钮文字换行问题
- 修复加载历史对话失败问题
  - 修复 parse_message_content 保留 ContentPart 结构
  - 修复 convert_agent_message 添加 reasoning_content 处理
  - 修复 WorkspaceType::from_str 命名冲突,重命名为 parse

## Code Quality
- 修复所有 clippy 警告
  - 修复 manual_flatten 警告
  - 修复 ptr_arg 警告(使用 &Path 替代 &PathBuf)
  - 修复 manual_clamp 警告
  - 修复 match_single_binding 警告
- 所有测试通过 (174 passed)
2026-02-16 20:58:55 +08:00

1.2 KiB

title, description, navigation
title description navigation
稳定性与容错 在高强度创作下保持调用稳定(进阶)
icon
i-heroicons-shield-check

稳定性与容错

::alert{type="info"} 这是进阶能力。只有在你频繁遇到超时、失败、波动时才需要细调。 ::

稳定性配置的核心目标是:

  • 少失败
  • 失败后可恢复
  • 出错时可定位

三个关键参数

重试

用于处理偶发失败。

建议:

  • 最大重试次数:2 到 3 次
  • 首次重试延迟:1 秒左右
  • 使用递增退避,避免短时间反复打满请求

超时

用于避免单次请求长时间卡住。

建议:

  • 普通文本任务:较短超时
  • 长文或复杂任务:适当放宽
  • 图片任务:通常需要更长超时

故障回退

主连接失败后自动走备用连接,减少中断。

推荐调参顺序

  1. 先调超时
  2. 再调重试
  3. 最后配置回退策略

诊断建议

连续失败

优先检查:

  1. 连接状态是否可用
  2. 当前模型是否可调用
  3. 是否触发限流

偶发失败

通常先提高重试效果更明显。

高峰波动

建议拆分任务批次,避免同一时刻大量并发。