行为、错误与重试规则

uyghur-ai BEHAVIOR-RULES.md

行为、错误与重试规则

  • 只上传完成请求所需的内容;文件或敏感长文本上传前取得同意。
  • 同一逻辑请求复用 Idempotency-Key,内容改变时使用新值。
  • 不回显密钥、完整原始响应或无关内部诊断。
  • 翻译读取 data.tgtText,对话读取 choices[0].message.content;缺失则失败关闭。
  • validation_failed(验证失败):修正字段、语言代码或长度。
  • insufficient_balance(余额不足):提示充值,不自动重发。
  • rate_limited(受到速率限制):遵循 Retry-After 或有限指数退避。
  • upstream_unavailable(上游服务不可用):短暂退避并复用原幂等键,限制重试次数。
  • idempotency_in_progress(幂等请求处理中):等待原请求,不换密钥并发提交。
  • idempotency_key_reused(幂等键已被重复使用):仅请求内容确实不同才换新密钥。
  • idempotency_indeterminate(幂等结果不确定):停止自动重试,先核对原请求和账单。
  • document_extraction_failed(文档提取失败):更换可解析文件或改用纯文本。

普通文本翻译、对话和 Word 请求的幂等重放返回首次响应与首次计费头。统一计费头为 X-AI-Skills-Billing-CurrencyX-AI-Skills-Billing-ChargedX-AI-Skills-Billing-Balance

图片和 PDF 翻译是隐私例外:客户端必须在收到时保留首次完整响应。成功重放只返回带 replayed=truecontent_retained=false 的无内容摘要,不包含 srcTexttgtTextpages, 且不会再次调用上游或扣费。