feat(asr): 本地语音转写接入为一级路由 + 并行工作流合并提交
按用户指示做**一包提交**,不按工作流拆分。本提交刻意混合了多条并行线:
· 本地 ASR 接管:audio 成为与 chat/embed/image/video 同等的路由类别
(IsLocalRoute 单一判据、audio 健康探测、default_audio_route、
auto 占位、GET /api/ai/routes/audio、回退云端时界面明示「音频已出网」)
· LLM 调用层:ctx 贯穿、ToolCall/ToolSchema、EmptyCompletionError /
TransientUpstreamError(按错误类型而非文案判重试)
· 编排 Agent:general_assistant orchestrate/persistence/spec_driver
· 联网搜索:internal/search(playwright)
· 网盘:backend + 前端
· 前端 UI:导航/路由/工作台若干页
· 交付文档:DELIVERY.md / AR04 / 部署文档的「无 Python」表述据实改写,
新增 eai_agentplatform-asr.service、asr.env、clonezilla-cleanup 清 ~/asr-poc
不分拆的原因:dev 早期,粒度不该打断工作节奏。且实测过——这些改动
**在编译上是同一个单元**(llm.go 的 ctx 签名变更牵动 12 个调用点,
chat_message.go 的 ctx 改动又与编排重写同处一个 hunk),拆出来的中间态编不过。
详见 TOP_CODING_RULES.md G14.5 与 bugs_and_errors.md E09。
Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,125 @@
|
||||
package search
|
||||
|
||||
import (
|
||||
"encoding/json"
|
||||
"fmt"
|
||||
"io"
|
||||
"net/http"
|
||||
"net/url"
|
||||
"os"
|
||||
"strings"
|
||||
"time"
|
||||
)
|
||||
|
||||
// SerpApiClient 调用付费的 SerpApi(https://serpapi.com)获取搜索结果。
|
||||
//
|
||||
// 背景:SearXNG / 搜狗 HTTP / 真实浏览器都会被百度和搜狗对数据中心 IP 的反爬拦截,
|
||||
// 无法稳定取得按关键词匹配的真实结果。SerpApi 是商业搜索 API,服务端负责抓取
|
||||
// (本机只连 serpapi.com,连通性好),返回结构化 JSON,无验证码,是「通用可搜」
|
||||
// 闭环的稳定主源。
|
||||
//
|
||||
// 配置:API key 从环境变量 SERPAPI_API_KEY 读取。未配置 key 时 Search 返回
|
||||
// (nil, errSkipSerp) 让上层回退到既有的 SearXNG→搜狗→浏览器链,保证无 key 也能跑。
|
||||
//
|
||||
// 设计说明:engine 用 google(SerpApi 默认),检索在 SerpApi 服务端完成,不受本机
|
||||
// 出口 IP 反爬影响;hl=zh-cn 让中文结果更相关。
|
||||
type SerpApiClient struct {
|
||||
apiKey string
|
||||
maxResults int
|
||||
timeout time.Duration
|
||||
hc *http.Client
|
||||
}
|
||||
|
||||
// errSkipSerp 表示未配置 SerpApi key,调用方应跳过本源继续回退。
|
||||
type skipSerpError struct{}
|
||||
|
||||
func (skipSerpError) Error() string { return "SerpApi 未配置 API key,跳过该源" }
|
||||
|
||||
// NewSerpApiClient 创建 SerpApi 客户端;key 从指定环境变量读取(空串时默认 SERPAPI_API_KEY)。
|
||||
func NewSerpApiClient(apiKeyEnv ...string) *SerpApiClient {
|
||||
envName := "SERPAPI_API_KEY"
|
||||
if len(apiKeyEnv) > 0 && apiKeyEnv[0] != "" {
|
||||
envName = apiKeyEnv[0]
|
||||
}
|
||||
c := &SerpApiClient{
|
||||
apiKey: strings.TrimSpace(os.Getenv(envName)),
|
||||
maxResults: 8,
|
||||
timeout: 15 * time.Second,
|
||||
}
|
||||
c.hc = &http.Client{Timeout: c.timeout}
|
||||
return c
|
||||
}
|
||||
|
||||
// serpAPIURL SerpApi 搜索端点。
|
||||
const serpAPIURL = "https://serpapi.com/search.json"
|
||||
|
||||
// serpAPIResponse SerpApi /search.json 的有机结果片段。
|
||||
type serpAPIResponse struct {
|
||||
OrganicResults []struct {
|
||||
Title string `json:"title"`
|
||||
Link string `json:"link"`
|
||||
Snippet string `json:"snippet"`
|
||||
} `json:"organic_results"`
|
||||
Error string `json:"error"`
|
||||
}
|
||||
|
||||
// Search 调用 SerpApi 搜索。未配置 key 时返回 skipSerpError。
|
||||
func (c *SerpApiClient) Search(query string) ([]Result, error) {
|
||||
if c.apiKey == "" {
|
||||
return nil, skipSerpError{}
|
||||
}
|
||||
|
||||
params := url.Values{}
|
||||
params.Set("q", query)
|
||||
params.Set("engine", "google")
|
||||
params.Set("hl", "zh-cn")
|
||||
params.Set("num", fmt.Sprintf("%d", c.maxResults))
|
||||
params.Set("api_key", c.apiKey)
|
||||
|
||||
req, err := http.NewRequest(http.MethodGet, serpAPIURL+"?"+params.Encode(), nil)
|
||||
if err != nil {
|
||||
return nil, fmt.Errorf("构建 SerpApi 请求失败: %w", err)
|
||||
}
|
||||
req.Header.Set("Accept", "application/json")
|
||||
|
||||
resp, err := c.hc.Do(req)
|
||||
if err != nil {
|
||||
return nil, fmt.Errorf("SerpApi 不可达: %w", err)
|
||||
}
|
||||
defer resp.Body.Close()
|
||||
|
||||
body, err := io.ReadAll(resp.Body)
|
||||
if err != nil {
|
||||
return nil, fmt.Errorf("读取 SerpApi 响应失败: %w", err)
|
||||
}
|
||||
if resp.StatusCode != http.StatusOK {
|
||||
return nil, fmt.Errorf("SerpApi 返回 %d: %s", resp.StatusCode, truncate(string(body), 200))
|
||||
}
|
||||
|
||||
var out serpAPIResponse
|
||||
if err := json.Unmarshal(body, &out); err != nil {
|
||||
return nil, fmt.Errorf("SerpApi 响应解析失败: %w", err)
|
||||
}
|
||||
if out.Error != "" {
|
||||
return nil, fmt.Errorf("SerpApi 业务错误: %s", out.Error)
|
||||
}
|
||||
|
||||
var res []Result
|
||||
for _, r := range out.OrganicResults {
|
||||
title := strings.TrimSpace(r.Title)
|
||||
link := strings.TrimSpace(r.Link)
|
||||
if title == "" || link == "" {
|
||||
continue
|
||||
}
|
||||
res = append(res, Result{
|
||||
Title: title,
|
||||
URL: link,
|
||||
Content: strings.TrimSpace(r.Snippet),
|
||||
Engine: "serpapi_google",
|
||||
})
|
||||
if len(res) >= c.maxResults {
|
||||
break
|
||||
}
|
||||
}
|
||||
return res, nil
|
||||
}
|
||||
Reference in New Issue
Block a user