mirror of
https://github.com/aiclientproxy/proxycast.git
synced 2026-09-24 23:10:56 +08:00
feat: release v0.77.0 with full pending changes
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -91,6 +91,41 @@ server:
|
||||
|
||||
适用:对缓存命中与语义一致性有要求的自动化/API 调用场景。
|
||||
|
||||
## 示例 5:运行时诊断接口(高级)
|
||||
|
||||
目标:像 ClawRouter 一样快速查看网关健康、缓存与统计信息。
|
||||
|
||||
```bash
|
||||
# 基础健康检查(兼容旧行为)
|
||||
curl "http://127.0.0.1:8999/health"
|
||||
|
||||
# 扩展健康检查(包含完整诊断)
|
||||
curl "http://127.0.0.1:8999/health?full=true"
|
||||
|
||||
# 响应缓存配置与命中统计
|
||||
curl "http://127.0.0.1:8999/cache"
|
||||
|
||||
# 统计诊断(默认最近 7 天,可传 days=1~30)
|
||||
curl "http://127.0.0.1:8999/stats?days=7"
|
||||
|
||||
# 查看请求级调试头(缓存/去重/幂等等状态)
|
||||
curl -i "http://127.0.0.1:8999/v1/chat/completions" \
|
||||
-H "Authorization: Bearer your-api-key" \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{"model":"gpt-4o-mini","messages":[{"role":"user","content":"ping"}]}'
|
||||
```
|
||||
|
||||
适用:排查“为什么慢/为什么回退/是否命中缓存”等线上联调问题。
|
||||
|
||||
可观测调试头示例:
|
||||
- `x-proxycast-request-id`
|
||||
- `x-proxycast-cache`(`hit/store/skip-*`)
|
||||
- `x-proxycast-dedup`(`replay/wait-replay/new/removed-on-error`)
|
||||
- `x-proxycast-idempotency`(`replay/in-progress/new/removed-on-error`)
|
||||
- `x-proxycast-requested-provider` / `x-proxycast-effective-provider` / `x-proxycast-model`
|
||||
|
||||
补充:在「团队共享网关(内网)」页面的「网关 API 测试」结果展开区域,也会直接显示这些 `x-proxycast-*` 调试头。
|
||||
|
||||
## 调整顺序建议
|
||||
|
||||
1. 先确认导航与主题
|
||||
|
||||
Reference in New Issue
Block a user