xunzhi-ai-runtime

name	xunzhi-ai-runtime
description	AI 运行时横切 Skill。当需求涉及限流/429、AI 调用超时与解析防御、分布式 single-flight、分布式锁、心跳/租约、asyncio 并发模型，或要查配置字段语义（xunzhi_agent_* 环境变量）时使用。

xunzhi-ai-runtime

外部 AI 调用的运行时防护层：限流、锁、single-flight、并发模型、配置语义。

使用顺序

• 查配置字段语义，看 references/generated-config-index.md（从 app/core/config.py 生成）。
• 改限流行为，看 references/flow-limit.md。
• 改 single-flight/结果信封，看 references/ai-singleflight.md。
• 改 AI 调用超时/输出解析防御，看 references/ai-guard.md。
• 理解并发/后台任务模型，看 references/async-model.md。
• 对象归属看 references/object-dictionary.md，踩坑先看 references/gotchas.md。

关键入口

• app/core/rate_limit.py（用户流量风控中间件 + 固定窗口 Lua）
• app/core/locks.py（SimpleRedisLock：owner token + Lua 释放）
• app/interview/flight/（single-flight：acquireOrJoin 原子脚本 + 结果信封）
• app/core/config.py（Settings，33 字段）

必守约束

• 限流 fail-closed：风控组件自身故障时放行请求（返回 429 的是正常限流，不是故障）。
• 锁释放必须校验 owner token（Lua），不能裸 DEL。
• 配置默认值改了必须重新生成 generated-config-index.md。

参考资料

• references/ai-guard.md
• references/ai-singleflight.md
• references/flow-limit.md
• references/async-model.md
• references/agent-binding.md
• references/generated-config-index.md
• references/object-dictionary.md
• references/gotchas.md
• scripts/extract_config_index.py（生成 references/generated-config-index.md）