agent-Specialization/utils/api_client.py
JOJO b8a51c1c63 refactor(config): 移除硬编码模型残留,部署级配置外置到 ~/.agents
## 模型逻辑清理
早期把模型 API 端点/密钥/模型 ID 硬编码的残留(AGENT_API_* / THINKING_* /
TITLE_* 三件套)已彻底移除。模型配置统一由 config/custom_models.json
(经 model_profiles 解析为档案)描述,运行时通过 apply_profile 注入;
没有任何可用模型时按既定行为报错。

- config/api.py: 删 9 个三件套符号,仅保留 DEFAULT_RESPONSE_MAX_TOKENS
- utils/api_client.py: client 改为空配置起步,移除三件套 import
- server/chat_flow_helpers.py: 删死 import(TITLE_* 符号)

## 部署级配置外置(按"决策权归谁"分类)
config/*.json 不再一概锚定源码树:
- 程序能力(docker_risk_markers / skill_hints)留源码树,随版本演进
- 部署者自定义(custom_models / host_workspaces / auto_approval /
  goal_review / forbidden_commands / host_sandbox_policy)外置到
  ~/.agents/<mode>/config/

新增统一解析机制(config/paths.py):
- DEPLOY_CONFIG_DIR(默认 ~/.agents/<mode>/config,可用环境变量覆盖)
- resolve_deploy_config():只读,回退链 部署目录→源码树.json→源码树.example
  (开发环境不必先跑 setup 也能用源码树种子)
- deploy_config_path():写回用,稳定指向部署目录

6 个加载点改用上述解析;顺带修复 approval_agent / goal_review_agent 的
DEBUG_TRANSCRIPT_DIR 仍指旧源码树 logs/ 的漏迁问题。

## 安全与运维
- 含密钥/机器特定的 5 个文件停止 git 追踪(git rm --cached,本地保留)
  并加入 .gitignore,仓库仅留 .example 种子;forbidden_commands 保留
  追踪作默认黑名单
- scripts/setup.py: 模型配置写到部署目录(用与 paths 一致的独立推导,
  不 import config 以免过早锁定路径)
- scripts/migrate_runtime_data.py: 新增 config/*.json → 部署目录迁移
  (备份 + 不覆盖已存在)

## 关联:P1 配置收敛 + P2 首启向导
- config/server.py: Web 端口/监听地址/debug/NODE_BIN/PYTHON_BIN 单一事实源
- 消灭 8091 多处重复定义(state.py 死代码、app_legacy、main.py 各读各的)
- 修复 sub_agent_manager 命令数组硬编码 "node" → NODE_BIN(便携包内置
  Node 的前提)
- scripts/setup.py: 终端首启向导(模式/端口/管理员/密钥/模型)

## 测试
test_config_paths_resolution 更新以反映新行为(host_workspaces 锚定部署
目录、新增 DEPLOY_CONFIG_DIR 用例);全部离线用例通过。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-01 16:59:34 +08:00

1286 lines
56 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# ========== api_client.py ==========
# utils/api_client.py - OpenAI-compatible API 客户端支持Web模式
import httpx
import json
import asyncio
import base64
import mimetypes
import os
from typing import List, Dict, Optional, AsyncGenerator, Any
from pathlib import Path
from datetime import datetime
from pathlib import Path
from typing import Tuple
try:
from config import (
OUTPUT_FORMATS,
DEFAULT_RESPONSE_MAX_TOKENS,
LOGS_DIR,
)
except ImportError:
import sys
from pathlib import Path
project_root = Path(__file__).resolve().parents[1]
if str(project_root) not in sys.path:
sys.path.insert(0, str(project_root))
from config import (
OUTPUT_FORMATS,
DEFAULT_RESPONSE_MAX_TOKENS,
LOGS_DIR,
)
from utils.log_rotation import append_line, prune_dir
def _api_dump_enabled() -> bool:
"""API 请求体落盘开关,默认关闭。"""
return str(os.environ.get("AGENT_API_DUMP_ENABLED", "")).strip().lower() in {"1", "true", "yes", "on"}
class DeepSeekClient: # legacy name; generic OpenAI-compatible client
def __init__(self, thinking_mode: bool = True, web_mode: bool = False):
# 模型 API 配置(端点 / 密钥 / 模型 ID由 apply_profile 从 custom_models 注入;
# 这里仅初始化为空,未应用任何模型档案前不可直接发请求。
self.fast_api_config = {
"base_url": "",
"api_key": "",
"model_id": ""
}
self.thinking_api_config = {
"base_url": "",
"api_key": "",
"model_id": ""
}
self.fast_max_tokens = None
self.thinking_max_tokens = None
self.fast_extra_params: Dict = {}
self.thinking_extra_params: Dict = {}
# 上下文预算(由上层在每次请求前设置)
self.current_context_tokens: int = 0
self.max_context_tokens: Optional[int] = None
self.default_context_window: Optional[int] = None
self.thinking_mode = thinking_mode # True=智能思考模式, False=快速模式
self.deep_thinking_mode = False # 深度思考模式:整轮都使用思考模型
self.deep_thinking_session = False # 当前任务是否处于深度思考会话
self.web_mode = web_mode # Web模式标志用于禁用print输出
# 兼容旧代码路径
self.api_base_url = self.fast_api_config["base_url"]
self.api_key = self.fast_api_config["api_key"]
self.model_id = self.fast_api_config["model_id"]
self.model_key = None # 由宿主终端注入,便于做模型兼容处理
self.model_multimodal = "none" # 由模型 profile 注入model_key 不可用时用于能力兜底
self.project_path: Optional[str] = None
# 每个任务的独立状态
self.current_task_first_call = True # 当前任务是否是第一次调用
self.current_task_thinking = "" # 当前任务的思考内容
self.force_thinking_next_call = False # 单次强制思考
self.skip_thinking_next_call = False # 单次强制快速
self.last_call_used_thinking = False # 最近一次调用是否使用思考模型
# 最近一次API错误详情
self.last_error_info: Optional[Dict[str, Any]] = None
# 请求体落盘目录(跟随 LOGS_DIR默认 ~/.agents/<mode>/logs/api_requests
self.request_dump_dir = Path(LOGS_DIR) / "api_requests"
self.debug_log_path = Path(LOGS_DIR) / "api_debug.log"
def _debug_log(self, payload: Dict[str, Any]) -> None:
if not _api_dump_enabled():
return
try:
entry = {
"ts": datetime.now().isoformat(),
**payload
}
append_line(self.debug_log_path, json.dumps(entry, ensure_ascii=False))
except Exception:
pass
def _resolve_env_value(self, name: str) -> Optional[str]:
value = os.environ.get(name)
if value is None:
env_path = Path(__file__).resolve().parents[1] / ".env"
if env_path.exists():
try:
for raw_line in env_path.read_text(encoding="utf-8").splitlines():
line = raw_line.strip()
if not line or line.startswith("#") or "=" not in line:
continue
key, val = line.split("=", 1)
if key.strip() == name:
value = val.strip().strip('"').strip("'")
break
except Exception:
value = None
if value is None:
return None
value = value.strip()
return value or None
def _print(self, message: str, end: str = "\n", flush: bool = False):
"""安全的打印函数在Web模式下不输出"""
if not self.web_mode:
print(message, end=end, flush=flush)
def _format_read_file_result(self, data: Dict) -> str:
"""根据读取模式格式化 read_file 工具结果。"""
if not isinstance(data, dict):
return json.dumps(data, ensure_ascii=False)
if not data.get("success"):
return json.dumps(data, ensure_ascii=False)
read_type = data.get("type", "read")
truncated_note = "(内容已截断)" if data.get("truncated") else ""
path = data.get("path", "未知路径")
max_chars = data.get("max_chars")
max_note = f"(max_chars={max_chars})" if max_chars else ""
if read_type == "read":
line_start = data.get("line_start")
line_end = data.get("line_end")
char_count = data.get("char_count", len(data.get("content", "") or ""))
header = f"读取 {path}{line_start}~{line_end},返回 {char_count} 字符 {max_note}{truncated_note}".strip()
content = data.get("content", "")
return f"{header}\n```\n{content}\n```"
if read_type == "search":
query = data.get("query", "")
actual = data.get("actual_matches", 0)
returned = data.get("returned_matches", 0)
case_hint = "区分大小写" if data.get("case_sensitive") else "不区分大小写"
header = (
f"{path} 中搜索 \"{query}\",返回 {returned}/{actual} 条结果({case_hint}"
f" {max_note}{truncated_note}"
).strip()
match_texts = []
for idx, match in enumerate(data.get("matches", []), 1):
match_note = "(片段截断)" if match.get("truncated") else ""
hits = match.get("hits") or []
hit_text = ", ".join(str(h) for h in hits) if hits else ""
label = match.get("id") or f"match_{idx}"
snippet = match.get("snippet", "")
match_texts.append(
f"[{label}] 行 {match.get('line_start')}~{match.get('line_end')} 命中行: {hit_text}{match_note}\n```\n{snippet}\n```"
)
if not match_texts:
match_texts.append("未找到匹配内容。")
return "\n".join([header] + match_texts)
def _build_content_with_images(self, text: str, images: List[str], videos: Optional[List[Any]] = None) -> Any:
"""将文本与图片/视频路径拼成多模态 content用于 tool 消息)。"""
videos = videos or []
if not images and not videos:
return text
parts: List[Dict[str, Any]] = []
extra_videos: List[Any] = []
if text:
parts.append({"type": "text", "text": text})
base_path = Path(self.project_path or ".")
for path in images:
try:
abs_path = (base_path / path).resolve()
if not abs_path.exists() or not abs_path.is_file():
continue
mime, _ = mimetypes.guess_type(abs_path.name)
if mime and mime.startswith("video/"):
extra_videos.append(path)
continue
if mime and not mime.startswith("image/"):
continue
if not mime:
mime = "image/png"
data = abs_path.read_bytes()
b64 = base64.b64encode(data).decode("utf-8")
parts.append({"type": "image_url", "image_url": {"url": f"data:{mime};base64,{b64}"}})
except Exception:
continue
for item in [*videos, *extra_videos]:
try:
if isinstance(item, dict):
path = item.get("path") or ""
else:
path = item
if not path:
continue
abs_path = (base_path / path).resolve()
if not abs_path.exists() or not abs_path.is_file():
continue
mime, _ = mimetypes.guess_type(abs_path.name)
if not mime:
mime = "video/mp4"
data = abs_path.read_bytes()
b64 = base64.b64encode(data).decode("utf-8")
payload: Dict[str, Any] = {
"type": "video_url",
"video_url": {"url": f"data:{mime};base64,{b64}"}
}
if isinstance(item, dict) and item.get("fps") is not None:
payload["fps"] = item.get("fps")
parts.append(payload)
except Exception:
continue
return parts if parts else text
if read_type == "extract":
segments = data.get("segments", [])
header = (
f"{path} 抽取 {len(segments)} 个片段 {max_note}{truncated_note}"
).strip()
seg_texts = []
for idx, segment in enumerate(segments, 1):
seg_note = "(片段截断)" if segment.get("truncated") else ""
label = segment.get("label") or f"segment_{idx}"
snippet = segment.get("content", "")
seg_texts.append(
f"[{label}] 行 {segment.get('line_start')}~{segment.get('line_end')}{seg_note}\n```\n{snippet}\n```"
)
if not seg_texts:
seg_texts.append("未提供可抽取的片段。")
return "\n".join([header] + seg_texts)
return json.dumps(data, ensure_ascii=False)
def _extract_reasoning_delta(self, delta: Dict[str, Any]) -> str:
"""统一提取思考内容,兼容 reasoning_content / reasoning_details。"""
if not isinstance(delta, dict):
return ""
if "reasoning_content" in delta:
return delta.get("reasoning_content") or ""
details = delta.get("reasoning_details")
if isinstance(details, list):
parts: List[str] = []
for item in details:
if isinstance(item, dict):
text = item.get("text")
if text:
parts.append(text)
if parts:
return "".join(parts)
return ""
def _merge_system_messages(self, messages: List[Dict]) -> List[Dict]:
"""
仅合并最开头连续的 system 消息(系统提示),后续插入的 system 消息保持原样。
"""
if not messages:
return messages
merged_contents: List[str] = []
idx = 0
while idx < len(messages) and messages[idx].get("role") == "system":
content = messages[idx].get("content", "")
if isinstance(content, str):
merged_contents.append(content)
else:
merged_contents.append(json.dumps(content, ensure_ascii=False))
idx += 1
if not merged_contents:
return messages
merged = {
"role": "system",
"content": "\n\n".join(c for c in merged_contents if c)
}
return [merged] + messages[idx:]
@staticmethod
def _normalize_multimodal_capability(value: Any) -> str:
text = str(value or "none").strip().lower()
if text == "video,image":
return "image,video"
if text in {"none", "image", "video", "image,video"}:
return text
return "none"
@staticmethod
def _sanitize_content_for_capability(
content: Any,
*,
supports_image: bool,
supports_video: bool,
) -> Any:
"""根据模型多模态能力裁剪 content避免向纯文本模型发送 image_url/video_url。"""
if not isinstance(content, list):
return content
kept_parts: List[Dict[str, Any]] = []
text_segments: List[str] = []
dropped_media = False
unsupported_media_notice = "当前模型无查看图片/视频能力,无法返回结果"
for part in content:
if not isinstance(part, dict):
text = str(part).strip()
if text:
text_segments.append(text)
continue
ctype = str(part.get("type") or "").strip().lower()
if ctype == "text":
text = str(part.get("text") or "")
if text:
text_segments.append(text)
kept_parts.append({"type": "text", "text": text})
continue
if ctype == "image_url":
if supports_image:
kept_parts.append(part)
else:
dropped_media = True
continue
if ctype == "video_url":
if supports_video:
kept_parts.append(part)
else:
dropped_media = True
continue
# 其他未知/暂不支持类型统一忽略(纯文本模型下只保留 text
continue
# 纯文本模型:统一回退为字符串,规避供应商对 content part 类型的严格校验
if not supports_image and not supports_video:
text_payload = "\n".join(seg for seg in text_segments if seg).strip()
if dropped_media:
if text_payload:
if unsupported_media_notice in text_payload:
return text_payload
return f"{text_payload}\n\n{unsupported_media_notice}"
return unsupported_media_notice
return text_payload
# 半多模态模型(例如只支持图片):尽量保留可支持的 part
if kept_parts:
if len(kept_parts) == 1 and kept_parts[0].get("type") == "text":
return kept_parts[0].get("text", "")
return kept_parts
return "\n".join(seg for seg in text_segments if seg).strip()
def _sanitize_messages_for_model_capability(self, messages: List[Dict]) -> List[Dict]:
model_key = str(self.model_key or "").strip()
supports_image = False
supports_video = False
capability_source = "profile_fallback"
if model_key:
try:
from config.model_profiles import get_model_capabilities
caps = get_model_capabilities(model_key)
supports_image = bool(caps.get("supports_image"))
supports_video = bool(caps.get("supports_video"))
capability_source = "model_key"
except Exception:
capability_source = "profile_fallback"
if capability_source != "model_key":
multimodal = self._normalize_multimodal_capability(self.model_multimodal)
supports_image = multimodal in {"image", "image,video"}
supports_video = multimodal in {"video", "image,video"}
if supports_image and supports_video:
return messages
changed = 0
sanitized: List[Dict[str, Any]] = []
for message in messages or []:
if not isinstance(message, dict):
continue
msg_copy = dict(message)
original_content = msg_copy.get("content")
new_content = self._sanitize_content_for_capability(
original_content,
supports_image=supports_image,
supports_video=supports_video,
)
if new_content != original_content:
changed += 1
msg_copy["content"] = new_content
sanitized.append(msg_copy)
if changed:
self._debug_log(
{
"event": "sanitize_messages_for_model_capability",
"model_key": model_key,
"capability_source": capability_source,
"supports_image": supports_image,
"supports_video": supports_video,
"changed_messages": changed,
}
)
return sanitized
def _sanitize_message_fields_for_api(self, messages: List[Dict]) -> List[Dict]:
"""移除只供本地 UI/持久化使用、OpenAI-compatible API 不接受的消息字段。"""
sanitized: List[Dict[str, Any]] = []
stripped_fields: Dict[str, int] = {}
allowed_common = {"role", "content", "name"}
allowed_by_role = {
"assistant": allowed_common | {"tool_calls", "reasoning_content"},
"tool": allowed_common | {"tool_call_id"},
"user": allowed_common,
"system": allowed_common,
}
for message in messages or []:
if not isinstance(message, dict):
continue
role = str(message.get("role") or "").strip()
allowed = allowed_by_role.get(role, allowed_common)
clean: Dict[str, Any] = {}
for key, value in message.items():
if key not in allowed:
stripped_fields[key] = stripped_fields.get(key, 0) + 1
continue
if key == "tool_calls" and not value:
stripped_fields[key] = stripped_fields.get(key, 0) + 1
continue
clean[key] = value
sanitized.append(clean)
if stripped_fields:
self._debug_log(
{
"event": "sanitize_message_fields_for_api",
"stripped_fields": stripped_fields,
}
)
return sanitized
def set_deep_thinking_mode(self, enabled: bool):
"""配置深度思考模式(持续使用思考模型)。"""
self.deep_thinking_mode = bool(enabled)
if not enabled:
self.deep_thinking_session = False
def start_new_task(self, force_deep: bool = False):
"""开始新任务(重置任务级别的状态)"""
self.current_task_first_call = True
self.current_task_thinking = ""
self.force_thinking_next_call = False
self.skip_thinking_next_call = False
self.last_call_used_thinking = False
self.deep_thinking_session = bool(force_deep) or bool(self.deep_thinking_mode)
def _build_headers(self, api_key: str) -> Dict[str, str]:
return {
"Authorization": f"Bearer {api_key}",
"Content-Type": "application/json"
}
def _select_api_config(self, use_thinking: bool) -> Dict[str, str]:
"""
根据当前模式选择API配置确保缺失字段回退到默认模型。
"""
config = self.thinking_api_config if use_thinking else self.fast_api_config
fallback = self.fast_api_config
return {
"base_url": config.get("base_url") or fallback["base_url"],
"api_key": config.get("api_key") or fallback["api_key"],
"model_id": config.get("model_id") or fallback["model_id"]
}
def _dump_request_payload(self, payload: Dict, api_config: Dict, headers: Dict) -> Optional[Path]:
"""
将本次请求的payload、headers、配置落盘便于排查400等错误。
返回写入的文件路径;落盘开关关闭(默认)时返回 None。
"""
if not _api_dump_enabled():
return None
timestamp = datetime.now().strftime("%Y%m%d_%H%M%S_%f")
filename = f"req_{timestamp}.json"
path = self.request_dump_dir / filename
try:
self.request_dump_dir.mkdir(parents=True, exist_ok=True)
headers_sanitized = {}
for k, v in headers.items():
headers_sanitized[k] = "***" if k.lower() == "authorization" else v
data = {
"timestamp": datetime.now().isoformat(),
"api_config": {k: api_config.get(k) for k in ["base_url", "model_id"]},
"headers": headers_sanitized,
"payload": payload
}
path.write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")
# 按份保留:只留最近 N 个请求落盘文件
prune_dir(self.request_dump_dir, pattern="req_*.json")
except Exception as exc:
self._print(f"{OUTPUT_FORMATS['warning']} 请求体落盘失败: {exc}")
return path
def _mark_request_error(self, dump_path: Path, status_code: int = None, error_text: str = None):
"""
在已有请求文件中追加错误标记,便于快速定位。
"""
if not dump_path or not dump_path.exists():
return
try:
data = json.loads(dump_path.read_text(encoding="utf-8"))
data["error"] = {
"status_code": status_code,
"message": error_text,
"marked_at": datetime.now().isoformat()
}
dump_path.write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")
except Exception as exc:
self._print(f"{OUTPUT_FORMATS['warning']} 标记请求错误失败: {exc}")
def apply_profile(self, profile: Dict):
"""
动态应用模型配置
profile 示例:
{
"fast": {"base_url": "...", "api_key": "...", "model_id": "...", "max_tokens": 8192},
"thinking": {...} 或 None,
"supports_thinking": True/False,
"fast_only": True/False
}
"""
if not profile or "fast" not in profile:
raise ValueError("无效的模型配置")
fast = profile["fast"] or {}
thinking = profile.get("thinking") or fast
self.fast_api_config = {
"base_url": fast.get("base_url") or self.fast_api_config.get("base_url"),
"api_key": fast.get("api_key") or self.fast_api_config.get("api_key"),
"model_id": fast.get("model_id") or self.fast_api_config.get("model_id")
}
self.thinking_api_config = {
"base_url": thinking.get("base_url") or self.thinking_api_config.get("base_url"),
"api_key": thinking.get("api_key") or self.thinking_api_config.get("api_key"),
"model_id": thinking.get("model_id") or self.thinking_api_config.get("model_id")
}
self.fast_max_tokens = fast.get("max_tokens")
self.thinking_max_tokens = thinking.get("max_tokens")
self.fast_extra_params = fast.get("extra_params") or {}
self.thinking_extra_params = thinking.get("extra_params") or {}
self.model_multimodal = self._normalize_multimodal_capability(profile.get("multimodal"))
self.default_context_window = profile.get("context_window") or fast.get("context_window")
# 同步旧字段
self.api_base_url = self.fast_api_config["base_url"]
self.api_key = self.fast_api_config["api_key"]
self.model_id = self.fast_api_config["model_id"]
try:
self._debug_log({
"event": "apply_profile",
"model_key": self.model_key,
"fast_model_id": self.fast_api_config.get("model_id"),
"thinking_model_id": self.thinking_api_config.get("model_id"),
"fast_max_tokens": self.fast_max_tokens,
"thinking_max_tokens": self.thinking_max_tokens,
"fast_extra_params": self.fast_extra_params,
"thinking_extra_params": self.thinking_extra_params,
"default_context_window": self.default_context_window,
})
except Exception:
pass
def update_context_budget(self, current_tokens: int, max_tokens: Optional[int]):
"""
由上层在每次调用前告知当前对话占用的token数和模型最大上下文。
"""
try:
self.current_context_tokens = max(0, int(current_tokens))
except (TypeError, ValueError):
self.current_context_tokens = 0
try:
self.max_context_tokens = int(max_tokens) if max_tokens is not None else None
except (TypeError, ValueError):
self.max_context_tokens = None
def get_current_thinking_mode(self) -> bool:
"""获取当前应该使用的思考模式"""
if self.deep_thinking_session:
return True
if not self.thinking_mode:
return False
if self.force_thinking_next_call:
return True
if self.skip_thinking_next_call:
return False
return self.current_task_first_call
def _validate_json_string(self, json_str: str) -> tuple:
"""
验证JSON字符串的完整性
Returns:
(is_valid: bool, error_message: str, parsed_data: dict or None)
"""
if not json_str or not json_str.strip():
return True, "", {}
# 检查基本的JSON结构标记
stripped = json_str.strip()
if not stripped.startswith('{') or not stripped.endswith('}'):
return False, "JSON字符串格式不完整缺少开始或结束大括号", None
# 检查引号配对
in_string = False
escape_next = False
quote_count = 0
for char in stripped:
if escape_next:
escape_next = False
continue
if char == '\\':
escape_next = True
continue
if char == '"':
quote_count += 1
in_string = not in_string
if in_string:
return False, "JSON字符串中存在未闭合的引号", None
# 尝试解析JSON
try:
parsed_data = json.loads(stripped)
return True, "", parsed_data
except json.JSONDecodeError as e:
return False, f"JSON解析错误: {str(e)}", None
def _safe_tool_arguments_parse(self, arguments_str: str, tool_name: str) -> tuple:
"""
安全地解析工具参数,保持失败即时返回
Returns:
(success: bool, arguments: dict, error_message: str)
"""
if not arguments_str or not arguments_str.strip():
return True, {}, ""
# 长度检查
max_length = 999999999 # 50KB限制
if len(arguments_str) > max_length:
return False, {}, f"参数过长({len(arguments_str)}字符),超过{max_length}字符限制"
# 尝试直接解析JSON
try:
parsed_data = json.loads(arguments_str)
return True, parsed_data, ""
except json.JSONDecodeError as e:
preview_length = 200
stripped = arguments_str.strip()
preview = stripped[:preview_length] + "..." if len(stripped) > preview_length else stripped
return False, {}, f"JSON解析失败: {str(e)}\n参数预览: {preview}"
async def chat(
self,
messages: List[Dict],
tools: Optional[List[Dict]] = None,
stream: bool = True
) -> AsyncGenerator[Dict, None]:
"""
异步调用 OpenAI-compatible API
Args:
messages: 消息列表
tools: 工具定义列表
stream: 是否流式输出
Yields:
响应内容块
"""
# 检查API密钥
if not self.api_key or self.api_key.startswith("your-"):
self._print(f"{OUTPUT_FORMATS['error']} API密钥未配置请检查模型配置")
return
# 决定是否使用思考模式
current_thinking_mode = self.get_current_thinking_mode()
api_config = self._select_api_config(current_thinking_mode)
headers = self._build_headers(api_config["api_key"])
# 如果当前为快速模式但已有思考内容,提示沿用
if self.thinking_mode and not current_thinking_mode and self.current_task_thinking:
self._print(f"{OUTPUT_FORMATS['info']} [任务内快速模式] 使用本次任务的思考继续处理...")
# 记录本次调用的模式
self.last_call_used_thinking = current_thinking_mode
if current_thinking_mode and self.force_thinking_next_call:
self.force_thinking_next_call = False
if not current_thinking_mode and self.skip_thinking_next_call:
self.skip_thinking_next_call = False
try:
override_max = self.thinking_max_tokens if current_thinking_mode else self.fast_max_tokens
if override_max is not None:
max_tokens = int(override_max)
else:
max_tokens = int(DEFAULT_RESPONSE_MAX_TOKENS)
if max_tokens <= 0:
raise ValueError("max_tokens must be positive")
except (TypeError, ValueError):
max_tokens = 4096
# 动态收缩 max_tokens避免超过模型上下文窗口
budget_max_context = self.max_context_tokens or self.default_context_window
if budget_max_context and budget_max_context > 0:
used_tokens = max(0, int(self.current_context_tokens or 0))
available = budget_max_context - used_tokens
if available <= 0:
# 兜底让上游错误处理这里至少给1防止API报参数错误
max_tokens = 1
else:
max_tokens = min(max_tokens, available)
final_messages = self._merge_system_messages(messages)
final_messages = self._sanitize_messages_for_model_capability(final_messages)
final_messages = self._sanitize_message_fields_for_api(final_messages)
payload = {
"model": api_config["model_id"],
"messages": final_messages,
"stream": stream,
}
payload["max_tokens"] = max_tokens
# 注入模型配置中的额外参数
extra_params = self.thinking_extra_params if current_thinking_mode else self.fast_extra_params
if extra_params:
payload.update(extra_params)
if tools:
payload["tools"] = tools
payload["tool_choice"] = "auto"
# 将本次请求落盘,便于出错时快速定位
try:
self._debug_log({
"event": "request_prepare",
"model_key": self.model_key,
"thinking_mode_flag": bool(self.thinking_mode),
"deep_thinking_mode": bool(self.deep_thinking_mode),
"deep_thinking_session": bool(self.deep_thinking_session),
"current_call_use_thinking": bool(current_thinking_mode),
"api_base_url": api_config.get("base_url"),
"api_model_id": api_config.get("model_id"),
"payload_model": payload.get("model"),
"payload_has_thinking": "thinking" in payload,
"payload_thinking": payload.get("thinking"),
"payload_enable_thinking": payload.get("enable_thinking"),
"payload_max_tokens": payload.get("max_tokens"),
"payload_max_completion_tokens": payload.get("max_completion_tokens"),
})
except Exception:
pass
dump_path = self._dump_request_payload(payload, api_config, headers)
try:
async with httpx.AsyncClient(http2=True, timeout=300) as client:
if stream:
async with client.stream(
"POST",
f"{api_config['base_url']}/chat/completions",
json=payload,
headers=headers
) as response:
# 检查响应状态
if response.status_code != 200:
error_bytes = await response.aread()
error_text = error_bytes.decode('utf-8', errors='ignore') if hasattr(error_bytes, 'decode') else str(error_bytes)
self.last_error_info = {
"status_code": response.status_code,
"error_text": error_text,
"error_type": None,
"error_message": None,
"request_dump": (str(dump_path) if dump_path else None),
"base_url": api_config.get("base_url"),
"model_id": api_config.get("model_id"),
"model_key": self.model_key
}
try:
parsed = json.loads(error_text)
err = parsed.get("error") if isinstance(parsed, dict) else {}
if isinstance(err, dict):
self.last_error_info["error_type"] = err.get("type")
self.last_error_info["error_message"] = err.get("message")
except Exception:
pass
self._debug_log({
"event": "http_error_stream",
"status_code": response.status_code,
"error_text": error_text,
"base_url": api_config.get("base_url"),
"model_id": api_config.get("model_id"),
"model_key": self.model_key,
"request_dump": (str(dump_path) if dump_path else None)
})
self._print(
f"{OUTPUT_FORMATS['error']} API请求失败 ({response.status_code}): {error_text} "
f"(base_url={api_config.get('base_url')}, model_id={api_config.get('model_id')})"
)
self._mark_request_error(dump_path, response.status_code, error_text)
yield {"error": self.last_error_info}
return
async for line in response.aiter_lines():
if line.startswith("data:"):
json_str = line[5:].strip()
if json_str == "[DONE]":
break
try:
data = json.loads(json_str)
yield data
except json.JSONDecodeError:
continue
else:
response = await client.post(
f"{api_config['base_url']}/chat/completions",
json=payload,
headers=headers
)
if response.status_code != 200:
error_text = response.text
self.last_error_info = {
"status_code": response.status_code,
"error_text": error_text,
"error_type": None,
"error_message": None,
"request_dump": (str(dump_path) if dump_path else None),
"base_url": api_config.get("base_url"),
"model_id": api_config.get("model_id"),
"model_key": self.model_key
}
try:
parsed = response.json()
err = parsed.get("error") if isinstance(parsed, dict) else {}
if isinstance(err, dict):
self.last_error_info["error_type"] = err.get("type")
self.last_error_info["error_message"] = err.get("message")
except Exception:
pass
self._debug_log({
"event": "http_error",
"status_code": response.status_code,
"error_text": error_text,
"base_url": api_config.get("base_url"),
"model_id": api_config.get("model_id"),
"model_key": self.model_key,
"request_dump": (str(dump_path) if dump_path else None)
})
self._print(
f"{OUTPUT_FORMATS['error']} API请求失败 ({response.status_code}): {error_text} "
f"(base_url={api_config.get('base_url')}, model_id={api_config.get('model_id')})"
)
self._mark_request_error(dump_path, response.status_code, error_text)
yield {"error": self.last_error_info}
return
# 成功则清空错误状态
self.last_error_info = None
yield response.json()
except httpx.ConnectError as e:
connect_detail = str(e).strip() or repr(e)
self._print(
f"{OUTPUT_FORMATS['error']} 无法连接到API服务器请检查网络连接"
f"{connect_detail}"
)
self.last_error_info = {
"status_code": None,
"error_text": "connect_error",
"error_type": "connection_error",
"error_message": f"无法连接到API服务器: {connect_detail}",
"error_detail": connect_detail,
"request_dump": (str(dump_path) if dump_path else None),
"base_url": api_config.get("base_url"),
"model_id": api_config.get("model_id"),
"model_key": self.model_key
}
self._debug_log({
"event": "connect_error",
"status_code": None,
"error_text": "connect_error",
"error_detail": connect_detail,
"base_url": api_config.get("base_url"),
"model_id": api_config.get("model_id"),
"model_key": self.model_key,
"request_dump": (str(dump_path) if dump_path else None)
})
self._mark_request_error(dump_path, error_text=f"connect_error: {connect_detail}")
yield {"error": self.last_error_info}
except httpx.TimeoutException:
self._print(f"{OUTPUT_FORMATS['error']} API请求超时")
self.last_error_info = {
"status_code": None,
"error_text": "timeout",
"error_type": "timeout",
"error_message": "API请求超时",
"request_dump": (str(dump_path) if dump_path else None),
"base_url": api_config.get("base_url"),
"model_id": api_config.get("model_id"),
"model_key": self.model_key
}
self._debug_log({
"event": "timeout",
"status_code": None,
"error_text": "timeout",
"base_url": api_config.get("base_url"),
"model_id": api_config.get("model_id"),
"model_key": self.model_key,
"request_dump": (str(dump_path) if dump_path else None)
})
self._mark_request_error(dump_path, error_text="timeout")
yield {"error": self.last_error_info}
except Exception as e:
error_text = str(e).strip() or repr(e)
self._print(f"{OUTPUT_FORMATS['error']} API调用异常: {error_text}")
self.last_error_info = {
"status_code": None,
"error_text": error_text,
"error_type": "exception",
"error_message": error_text,
"request_dump": (str(dump_path) if dump_path else None),
"base_url": api_config.get("base_url"),
"model_id": api_config.get("model_id"),
"model_key": self.model_key
}
self._debug_log({
"event": "exception",
"status_code": None,
"error_text": error_text,
"base_url": api_config.get("base_url"),
"model_id": api_config.get("model_id"),
"model_key": self.model_key,
"request_dump": (str(dump_path) if dump_path else None)
})
self._mark_request_error(dump_path, error_text=error_text)
yield {"error": self.last_error_info}
async def chat_with_tools(
self,
messages: List[Dict],
tools: List[Dict],
tool_handler: callable
) -> str:
"""
带工具调用的对话(支持多轮)
Args:
messages: 消息列表
tools: 工具定义
tool_handler: 工具处理函数
Returns:
最终回答
"""
final_response = ""
max_iterations = 200 # 最大迭代次数
iteration = 0
all_tool_results = [] # 记录所有工具调用结果
while iteration < max_iterations:
iteration += 1
# 调用API始终提供工具定义
full_response = ""
tool_calls = []
current_thinking = ""
# 状态标志
in_thinking = False
thinking_printed = False
async for chunk in self.chat(messages, tools, stream=True):
if chunk.get("error"):
# 直接返回错误,让上层处理
err = chunk["error"]
self.last_error_info = err
err_msg = err.get("error_message") or err.get("error_text") or "API调用失败"
status = err.get("status_code")
self._print(f"{OUTPUT_FORMATS['error']} 模型API错误{f'({status})' if status is not None else ''}: {err_msg}")
return ""
if "choices" not in chunk:
continue
delta = chunk["choices"][0].get("delta", {})
# 处理思考内容
reasoning_content = self._extract_reasoning_delta(delta)
if reasoning_content:
if not in_thinking:
self._print("💭 [正在思考]\n", end="", flush=True)
in_thinking = True
thinking_printed = True
current_thinking += reasoning_content
self._print(reasoning_content, end="", flush=True)
# 处理正常内容 - 独立的if不是elif
if "content" in delta:
content = delta["content"]
if content: # 只处理非空内容
# 如果之前在输出思考,先结束思考输出
if in_thinking:
self._print("\n\n💭 [思考结束]\n\n", end="", flush=True)
in_thinking = False
full_response += content
self._print(content, end="", flush=True)
# 收集工具调用 - 改进的拼接逻辑
# 收集工具调用 - 修复JSON分片问题
if "tool_calls" in delta:
for tool_call in delta["tool_calls"]:
tool_index = tool_call.get("index", 0)
# 查找或创建对应索引的工具调用
existing_call = None
for existing in tool_calls:
if existing.get("index") == tool_index:
existing_call = existing
break
if not existing_call and tool_call.get("id"):
# 创建新的工具调用
new_call = {
"id": tool_call.get("id"),
"index": tool_index,
"type": tool_call.get("type", "function"),
"function": {
"name": tool_call.get("function", {}).get("name", ""),
"arguments": ""
}
}
tool_calls.append(new_call)
existing_call = new_call
# 安全地拼接arguments - 简单字符串拼接不尝试JSON验证
if existing_call and "function" in tool_call and "arguments" in tool_call["function"]:
new_args = tool_call["function"]["arguments"]
if new_args: # 只拼接非空内容
existing_call["function"]["arguments"] += new_args
self._print("") # 最终换行
# 如果思考还没结束(只调用工具没有文本),手动结束
if in_thinking:
self._print("\n💭 [思考结束]\n")
# 记录思考内容并更新调用状态
if self.last_call_used_thinking and current_thinking:
self.current_task_thinking = current_thinking
if self.current_task_first_call:
self.current_task_first_call = False # 标记当前任务的第一次调用已完成
# 如果没有工具调用,说明完成了
if not tool_calls:
if full_response: # 有正常回复,任务完成
final_response = full_response
break
elif iteration == 1: # 第一次就没有工具调用也没有内容,可能有问题
self._print(f"{OUTPUT_FORMATS['warning']} 模型未返回内容")
break
# 构建助手消息 - 始终包含所有收集到的内容
assistant_content_parts = []
# 添加正式回复内容(如果有)
if full_response:
assistant_content_parts.append(full_response)
# 添加工具调用说明
if tool_calls:
tool_names = [tc['function']['name'] for tc in tool_calls]
assistant_content_parts.append(f"执行工具: {', '.join(tool_names)}")
# 合并所有内容
assistant_content = "\n".join(assistant_content_parts) if assistant_content_parts else "执行工具调用"
assistant_message = {
"role": "assistant",
"content": assistant_content,
"tool_calls": tool_calls
}
if current_thinking:
assistant_message["reasoning_content"] = current_thinking
messages.append(assistant_message)
# 执行所有工具调用 - 使用鲁棒的参数解析
for tool_call in tool_calls:
function_name = tool_call["function"]["name"]
arguments_str = tool_call["function"]["arguments"]
# 使用改进的参数解析方法增强JSON修复能力
success, arguments, error_msg = self._safe_tool_arguments_parse(arguments_str, function_name)
if not success:
self._print(f"{OUTPUT_FORMATS['error']} 工具参数解析失败: {error_msg}")
self._print(f" 工具名称: {function_name}")
self._print(f" 参数长度: {len(arguments_str)} 字符")
# 返回详细的错误信息给模型
error_response = {
"success": False,
"error": error_msg,
"tool_name": function_name,
"arguments_length": len(arguments_str),
"suggestion": "请检查参数格式或减少参数长度后重试"
}
# 如果参数过长,提供分块建议
if len(arguments_str) > 10000:
error_response["suggestion"] = "参数过长,建议分块处理或使用更简洁的内容"
messages.append({
"role": "tool",
"tool_call_id": tool_call["id"],
"name": function_name,
"content": json.dumps(error_response, ensure_ascii=False)
})
# 记录失败的调用,防止死循环检测失效
all_tool_results.append({
"tool": function_name,
"args": {"parse_error": error_msg, "length": len(arguments_str)},
"result": f"参数解析失败: {error_msg}"
})
continue
self._print(f"\n{OUTPUT_FORMATS['action']} 调用工具: {function_name}")
tool_result = await tool_handler(function_name, arguments)
# 解析工具结果,提取关键信息
result_data = None
try:
result_data = json.loads(tool_result)
if function_name == "read_file":
tool_result_msg = self._format_read_file_result(result_data)
else:
tool_result_msg = tool_result
except Exception:
tool_result_msg = tool_result
tool_message_content = tool_result_msg
if (
isinstance(result_data, dict)
and result_data.get("success") is not False
):
if function_name == "view_image":
img_path = result_data.get("path")
if img_path:
text_part = tool_result_msg if isinstance(tool_result_msg, str) else ""
tool_message_content = self._build_content_with_images(text_part, [img_path])
elif function_name == "view_video":
video_path = result_data.get("path")
if video_path:
text_part = tool_result_msg if isinstance(tool_result_msg, str) else ""
tool_message_content = self._build_content_with_images(text_part, [], [video_path])
messages.append({
"role": "tool",
"tool_call_id": tool_call["id"],
"name": function_name,
"content": tool_message_content
})
# 记录工具结果
all_tool_results.append({
"tool": function_name,
"args": arguments,
"result": tool_result_msg
})
# 如果连续多次调用同样的工具,可能陷入循环
if len(all_tool_results) >= 8:
recent_tools = [r["tool"] for r in all_tool_results[-8:]]
if len(set(recent_tools)) == 1: # 最近8次都是同一个工具
self._print(f"\n{OUTPUT_FORMATS['warning']} 检测到重复操作,停止执行")
break
if iteration >= max_iterations:
self._print(f"\n{OUTPUT_FORMATS['warning']} 达到最大迭代次数限制")
return final_response
async def simple_chat(self, messages: List[Dict]) -> tuple:
"""
简单对话(无工具调用)
Args:
messages: 消息列表
Returns:
(模型回答, 思考内容)
"""
full_response = ""
thinking_content = ""
in_thinking = False
# 如果思考模式且已有本任务的思考内容,补充到上下文,确保多次调用时思考不割裂
if (
self.thinking_mode
and not self.current_task_first_call
and self.current_task_thinking
):
thinking_context = (
"\n=== 📋 本次任务的思考 ===\n"
f"{self.current_task_thinking}\n"
"=== 思考结束 ===\n"
"提示:以上是本轮任务先前的思考,请在此基础上继续。"
)
messages.append({
"role": "system",
"content": thinking_context
})
thinking_context_injected = True
try:
async for chunk in self.chat(messages, tools=None, stream=True):
if chunk.get("error"):
err = chunk["error"]
self.last_error_info = err
err_msg = err.get("error_message") or err.get("error_text") or "API调用失败"
status = err.get("status_code")
self._print(f"{OUTPUT_FORMATS['error']} 模型API错误{f'({status})' if status is not None else ''}: {err_msg}")
return "", ""
if "choices" not in chunk:
continue
delta = chunk["choices"][0].get("delta", {})
# 处理思考内容
reasoning_content = self._extract_reasoning_delta(delta)
if reasoning_content:
if not in_thinking:
self._print("💭 [正在思考]\n", end="", flush=True)
in_thinking = True
thinking_content += reasoning_content
self._print(reasoning_content, end="", flush=True)
# 处理正常内容 - 独立的if而不是elif
if "content" in delta:
content = delta["content"]
if content: # 只处理非空内容
if in_thinking:
self._print("\n\n💭 [思考结束]\n\n", end="", flush=True)
in_thinking = False
full_response += content
self._print(content, end="", flush=True)
self._print("") # 最终换行
# 如果思考还没结束(极少情况),手动结束
if in_thinking:
self._print("\n💭 [思考结束]\n")
if self.last_call_used_thinking and thinking_content:
self.current_task_thinking = thinking_content
if self.current_task_first_call:
self.current_task_first_call = False
# 如果没有收到任何响应
if not full_response and not thinking_content:
self._print(f"{OUTPUT_FORMATS['error']} API未返回任何内容请检查API密钥和模型ID")
return "", ""
except Exception as e:
self._print(f"{OUTPUT_FORMATS['error']} API调用失败: {e}")
return "", ""
return full_response, thinking_content