refactor: 大规模模块拆分与代码精简,新增 ai-pipeline/data-contracts 独立 crate

- 新增 aether-ai-pipeline 和 aether-data-contracts crate,将 pipeline 逻辑与数据契约从 gateway 中解耦
- 重构 admin handlers:拆分单体模块为 auth/billing/endpoint/features/model/observability/provider/system 等独立子模块
- 合并 chat/cli 重复代码路径:精简 conversion、finalize、planner 中的 sync/chat/cli 分支
- 重构 scheduler/executor/data 层,引入 facade 模式降低模块间耦合
- 移除冗余的 intent 模块,将 plan_fallback/policy/stream_path/sync_path 迁移至 executor
- 前端适配:调整 admin API 调用和 provider 模型测试对话框
This commit is contained in:
fawney19
2026-04-07 02:50:19 +08:00
parent 763ff03a7b
commit 5d96d6673b
732 changed files with 28593 additions and 20666 deletions

View File

@@ -0,0 +1,376 @@
use serde_json::Value;
use crate::conversion::request::{
convert_openai_chat_request_to_claude_request, convert_openai_chat_request_to_gemini_request,
convert_openai_chat_request_to_openai_cli_request,
normalize_claude_request_to_openai_chat_request,
normalize_gemini_request_to_openai_chat_request,
normalize_openai_cli_request_to_openai_chat_request,
};
pub fn build_standard_request_body(
body_json: &Value,
client_api_format: &str,
mapped_model: &str,
provider_api_format: &str,
request_path: &str,
upstream_is_stream: bool,
) -> Option<Value> {
let canonical_request = normalize_standard_request_to_openai_chat_request(
body_json,
client_api_format,
request_path,
)?;
build_standard_request_body_from_canonical(
&canonical_request,
mapped_model,
provider_api_format,
upstream_is_stream,
)
}
pub fn build_standard_request_body_from_canonical(
canonical_request: &Value,
mapped_model: &str,
provider_api_format: &str,
upstream_is_stream: bool,
) -> Option<Value> {
match provider_api_format.trim().to_ascii_lowercase().as_str() {
"openai:chat" => {
build_openai_chat_request_body(canonical_request, mapped_model, upstream_is_stream)
}
"openai:cli" => convert_openai_chat_request_to_openai_cli_request(
canonical_request,
mapped_model,
upstream_is_stream,
false,
),
"openai:compact" => convert_openai_chat_request_to_openai_cli_request(
canonical_request,
mapped_model,
false,
true,
),
"claude:chat" | "claude:cli" => convert_openai_chat_request_to_claude_request(
canonical_request,
mapped_model,
upstream_is_stream,
),
"gemini:chat" | "gemini:cli" => convert_openai_chat_request_to_gemini_request(
canonical_request,
mapped_model,
upstream_is_stream,
),
_ => None,
}
}
pub fn normalize_standard_request_to_openai_chat_request(
body_json: &Value,
client_api_format: &str,
request_path: &str,
) -> Option<Value> {
match client_api_format.trim().to_ascii_lowercase().as_str() {
"openai:chat" => Some(body_json.clone()),
"openai:cli" | "openai:compact" => {
normalize_openai_cli_request_to_openai_chat_request(body_json)
}
"claude:chat" | "claude:cli" => normalize_claude_request_to_openai_chat_request(body_json),
"gemini:chat" | "gemini:cli" => {
normalize_gemini_request_to_openai_chat_request(body_json, request_path)
}
_ => None,
}
}
fn build_openai_chat_request_body(
body_json: &Value,
mapped_model: &str,
upstream_is_stream: bool,
) -> Option<Value> {
let request_body_object = body_json.as_object()?;
let mut provider_request_body = serde_json::Map::from_iter(
request_body_object
.iter()
.map(|(key, value)| (key.clone(), value.clone())),
);
provider_request_body.insert("model".to_string(), Value::String(mapped_model.to_string()));
if upstream_is_stream {
provider_request_body.insert("stream".to_string(), Value::Bool(true));
}
Some(Value::Object(provider_request_body))
}
#[cfg(test)]
mod tests {
use super::build_standard_request_body;
use serde_json::json;
#[test]
fn builds_openai_chat_request_from_claude_chat_source() {
let request = json!({
"model": "claude-3-7-sonnet",
"system": "You are concise.",
"messages": [
{
"role": "user",
"content": [{"type": "text", "text": "Hello from Claude"}]
}
],
"max_tokens": 128
});
let converted = build_standard_request_body(
&request,
"claude:chat",
"gpt-5",
"openai:chat",
"/v1/messages",
false,
)
.expect("claude chat should convert to openai chat");
assert_eq!(converted["model"], "gpt-5");
assert_eq!(converted["messages"][0]["role"], "system");
assert_eq!(converted["messages"][0]["content"], "You are concise.");
assert_eq!(converted["messages"][1]["role"], "user");
assert_eq!(converted["messages"][1]["content"], "Hello from Claude");
}
#[test]
fn builds_claude_chat_request_from_gemini_chat_source() {
let request = json!({
"systemInstruction": {
"parts": [{"text": "Be brief."}]
},
"contents": [
{
"role": "user",
"parts": [{"text": "Hello from Gemini"}]
}
]
});
let converted = build_standard_request_body(
&request,
"gemini:chat",
"claude-sonnet-4-5",
"claude:chat",
"/v1beta/models/gemini-2.5-pro:generateContent",
false,
)
.expect("gemini chat should convert to claude chat");
assert_eq!(converted["model"], "claude-sonnet-4-5");
assert_eq!(converted["messages"][0]["role"], "user");
assert!(
converted["messages"]
.to_string()
.contains("Hello from Gemini"),
"converted claude payload should retain the gemini user text: {converted}"
);
}
#[test]
fn builds_gemini_cli_request_from_claude_cli_source() {
let request = json!({
"model": "claude-sonnet-4-5",
"messages": [
{
"role": "user",
"content": [{"type": "text", "text": "Need CLI output"}]
}
],
"max_tokens": 64
});
let converted = build_standard_request_body(
&request,
"claude:cli",
"gemini-2.5-pro",
"gemini:cli",
"/v1/messages",
false,
)
.expect("claude cli should convert to gemini cli");
assert_eq!(converted["contents"][0]["role"], "user");
assert_eq!(
converted["contents"][0]["parts"][0]["text"],
"Need CLI output"
);
}
#[test]
fn builds_openai_chat_request_from_openai_responses_source_with_chat_shape() {
let request = json!({
"model": "gpt-5",
"instructions": "You are concise.",
"input": [{
"type": "message",
"role": "user",
"content": [
{
"type": "input_image",
"image_url": "https://example.com/cat.png",
"detail": "high"
},
{
"type": "input_file",
"file_data": "data:application/pdf;base64,JVBERi0x",
"filename": "spec.pdf"
},
{"type": "input_text", "text": "Summarize this"}
]
}],
"reasoning": {"effort": "high"},
"text": {
"format": {
"type": "json_schema",
"json_schema": {
"name": "answer_schema",
"schema": {
"type": "object",
"properties": {"answer": {"type": "string"}}
}
}
}
}
});
let converted = build_standard_request_body(
&request,
"openai:cli",
"gpt-5",
"openai:chat",
"/v1/responses",
false,
)
.expect("responses request should convert to chat completions");
assert_eq!(converted["messages"][0]["role"], "system");
assert_eq!(converted["messages"][0]["content"], "You are concise.");
assert_eq!(converted["reasoning_effort"], "high");
assert_eq!(
converted["response_format"]["json_schema"]["name"],
"answer_schema"
);
assert_eq!(converted["messages"][1]["content"][0]["type"], "image_url");
assert_eq!(
converted["messages"][1]["content"][0]["image_url"]["url"],
"https://example.com/cat.png"
);
assert_eq!(
converted["messages"][1]["content"][0]["image_url"]["detail"],
"high"
);
assert_eq!(converted["messages"][1]["content"][1]["type"], "file");
assert_eq!(
converted["messages"][1]["content"][1]["file"]["filename"],
"spec.pdf"
);
}
#[test]
fn builds_gemini_request_from_openai_chat_with_structured_output_and_images() {
let request = json!({
"model": "gpt-5",
"messages": [{
"role": "user",
"content": [
{
"type": "image_url",
"image_url": {
"url": "data:image/png;base64,iVBORw0KGgo="
}
},
{"type": "text", "text": "Describe it"}
]
}],
"reasoning_effort": "medium",
"n": 2,
"response_format": {
"type": "json_schema",
"json_schema": {
"name": "answer_schema",
"schema": {
"type": "object",
"properties": {"answer": {"type": "string"}}
}
}
},
"web_search_options": {
"search_context_size": "high"
}
});
let converted = build_standard_request_body(
&request,
"openai:chat",
"gemini-2.5-pro",
"gemini:chat",
"/v1/chat/completions",
false,
)
.expect("openai chat should convert to gemini");
assert_eq!(
converted["generationConfig"]["thinkingConfig"]["thinkingBudget"],
2048
);
assert_eq!(converted["generationConfig"]["candidateCount"], 2);
assert_eq!(
converted["generationConfig"]["responseMimeType"],
"application/json"
);
assert_eq!(
converted["generationConfig"]["responseSchema"]["type"],
"object"
);
assert_eq!(
converted["contents"][0]["parts"][0]["inlineData"]["mimeType"],
"image/png"
);
assert_eq!(converted["tools"][0]["googleSearch"], json!({}));
}
#[test]
fn builds_claude_request_from_openai_chat_with_thinking_and_data_url_image() {
let request = json!({
"model": "gpt-5",
"messages": [{
"role": "user",
"content": [
{
"type": "image_url",
"image_url": {
"url": "data:image/jpeg;base64,/9j/4AAQSk"
}
},
{"type": "text", "text": "What is this?"}
]
}],
"reasoning_effort": "low"
});
let converted = build_standard_request_body(
&request,
"openai:chat",
"claude-sonnet-4-5",
"claude:chat",
"/v1/chat/completions",
false,
)
.expect("openai chat should convert to claude");
assert_eq!(converted["thinking"]["type"], "enabled");
assert_eq!(converted["thinking"]["budget_tokens"], 1280);
assert_eq!(
converted["messages"][0]["content"][0]["source"]["type"],
"base64"
);
assert_eq!(
converted["messages"][0]["content"][0]["source"]["media_type"],
"image/jpeg"
);
}
}