docs/function-calling.md

# 函数调用模式

本项目支持 OpenAI 风格 `tools/tool_calls`，并提供三种模式：

- `auto`：优先 native，失败自动回退 emulated（推荐）
- `native`：完全依赖 AI Studio 原生函数调用 UI
- `emulated`：文本注入方式，兼容旧流程

## 关键配置

- `FUNCTION_CALLING_MODE`
- `FUNCTION_CALLING_NATIVE_FALLBACK`
- `FUNCTION_CALLING_UI_TIMEOUT`
- `FUNCTION_CALLING_NATIVE_RETRY_COUNT`
- `FUNCTION_CALLING_CLEAR_BETWEEN_REQUESTS`

## 缓存与调试

- `FUNCTION_CALLING_CACHE_ENABLED`
- `FUNCTION_CALLING_CACHE_TTL`
- `FUNCTION_CALLING_DEBUG`
- `FC_DEBUG_*`（模块级日志）

## 兼容增强

- `FUNCTION_CALLING_THOUGHT_SIGNATURE`
- `FUNCTION_CALLING_UPPERCASE_TYPES`

> 建议默认保持 `THOUGHT_SIGNATURE=true`、`UPPERCASE_TYPES=false`，除非你已验证目标 UI 行为。