docs/advanced_configuration.md

高级配置与实验性功能 (Advanced Configuration)

Antigravity v3.3.35 引入了 ExperimentalConfig，这是一组默认开启的实验性功能开关，旨在提升系统的鲁棒性与兼容性。这些配置位于 src-tauri/src/proxy/config.rs 中，目前暂未暴露到 UI 界面。

功能列表

1. 双层签名缓存 (Signature Cache)

• 配置项: enable_signature_cache
• 默认值: true
• 说明: 启用后，系统会缓存 ToolUse ID 与 Thought Signature 的映射关系。
• 作用: 解决部分客户端（如 Claude Desktop CLI, Cherry Studio）在多轮对话中可能丢失历史 Tool Call 签名的问题。当上游 API 报错 "Missing signature" 时，系统可从缓存中自动恢复，避免对话中断。

2. 工具循环自动恢复 (Tool Loop Recovery)

• 配置项: enable_tool_loop_recovery
• 默认值: true
• 说明: 启用后，系统会实时监控对话状态，检测“死循环”模式。
• 触发条件: 检测到连续的 ToolUse -> ToolResult 循环，且 Assistant 消息中缺少 Thinking 块（通常因签名校验失败被 stripping）。
• 行为: 自动注入合成消息（Assistant: Tool execution completed. -> User: Proceed.）来打破死循环，强制模型进入下一轮思考。

3. 跨模型兼容性检查 (Cross-Model Checks)

• 配置项: enable_cross_model_checks
• 默认值: true
• 说明: 防止在同一会话中切换不同系列模型（如 Claude -> Gemini）时引发的签名错误。
• 作用: 当检测到历史消息中的签名属于不兼容的模型家族（如 claude-3-5 vs gemini-2.0）时，系统会自动丢弃旧签名，防止 API 拒绝请求。

自定义配置

目前这些配置项可通过修改 src-tauri/src/proxy/config.rs 中的 default_true 默认值来调整，或者等待未来版本集成到 "Settings -> Advanced" 界面。

// src-tauri/src/proxy/config.rs

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ExperimentalConfig {
    #[serde(default = "default_true")]
    pub enable_signature_cache: bool,
    // ...
}