fix(embedding): 回填错误透传 + Base URL 字面量化 + 提示文案

- Backfill 全军覆没（indexed=0 且 failed>0）时回传底层错误，消除
  "失败 N 条但 msg 为空" 的静默失败：前端能看到真实 404/鉴权原因
- base_url 按字面量透传给 go-openai（对齐 OpenAI 惯例，不再静默改写
  用户输入），改用 baseUrlHint 提示"填根地址、勿带 /embeddings"
- 新增 embeddingSetting.baseUrlHint（zh/en/ja/de），并清理 agentSetting
  .baseUrlHint 的孤儿键以恢复 i18n parity

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: lin-snow

internal/embedding/embedding.go

@@ -41,6 +41,8 @@ func Embed(
 
 	cfg := openai.DefaultConfig(setting.ApiKey)
 	if setting.BaseURL != "" {
+		// base_url 按字面量透传，由 go-openai 统一拼接 "/embeddings" 后缀
+		// （对齐 OpenAI / go-openai 惯例）。用户应填到 ".../v4"，不要带 /embeddings。
 		cfg.BaseURL = setting.BaseURL
 	}
 	client := openai.NewClientWithConfig(cfg)

internal/service/embedding/embedding.go

@@ -183,6 +183,7 @@ func (s *EmbeddingService) Backfill(ctx context.Context) (BackfillResult, error)
 
 	const pageSize = 100
 	page := 1
+	var lastErr error
 	for {
 		items, total := s.echoReader.GetEchosByPage(page, pageSize, "", true)
 		result.Total = int(total)
@@ -207,6 +208,7 @@ func (s *EmbeddingService) Backfill(ctx context.Context) (BackfillResult, error)
 			if embErr != nil {
 				logUtil.GetLogger().Error("backfill embed failed", zap.Error(embErr))
 				result.Failed += len(texts)
+				lastErr = embErr
 			} else {
 				for i, e := range picked {
 					if upErr := s.repo.Upsert(ctx, &model.EchoEmbedding{
@@ -232,5 +234,11 @@ func (s *EmbeddingService) Backfill(ctx context.Context) (BackfillResult, error)
 		page++
 	}
 
+	// 全军覆没（一条都没成功，且确有失败）：把底层错误回传，避免前端只看到
+	// "失败 N 条" 却拿不到真正原因（如 404 / 鉴权失败 / Base URL 配错）。
+	if result.Indexed == 0 && result.Failed > 0 && lastErr != nil {
+		return result, lastErr
+	}
+
 	return result, nil
 }

web/src/locales/messages/de-DE.json

@@ -672,7 +672,6 @@
     "apiKeyPlaceholder": "API Key eingeben",
     "baseUrl": "Base URL",
     "baseUrlPlaceholder": "Eigene Base URL eingeben",
-    "baseUrlHint": "Beim Protokoll „OpenAI-kompatibel“ hier die API-Adresse von Diensten wie DeepSeek oder Ollama eingeben",
     "prompt": "Prompt",
     "promptPlaceholder": "Eigenen Prompt eingeben",
     "promptHint": "Der eigene Prompt wirkt nur auf die „aktuelle Zusammenfassung“ und wird im Chat nicht verwendet.",
@@ -1004,6 +1003,7 @@
     "apiKeyPlaceholder": "API-Key eingeben (bei lokalen Diensten leer lassen)",
     "baseUrl": "Eigene API-URL",
     "baseUrlPlaceholder": "https://api.openai.com/v1",
+    "baseUrlHint": "Die API-Basis-URL des Dienstes eingeben; /embeddings wird automatisch angehängt – nicht selbst hinzufügen.",
     "reindex": "Index neu aufbauen",
     "reindexHint": "Vektoren für alle bisherigen Echos neu erzeugen. Einmal nach Modell- oder Dimensionswechsel ausführen.",
     "reindexAction": "Neuaufbau starten",

web/src/locales/messages/en-US.json

@@ -672,15 +672,14 @@
     "apiKeyPlaceholder": "Enter API Key",
     "baseUrl": "Base URL",
     "baseUrlPlaceholder": "Enter custom Base URL",
-    "baseUrlHint": "For the OpenAI Compatible protocol, enter the API endpoint of services like DeepSeek or Ollama here.",
     "prompt": "Prompt",
     "promptPlaceholder": "Enter custom prompt",
     "promptHint": "The custom prompt only applies to the recent summary; it is not used in chat conversations.",
     "multimodal": "Multimodal support",
     "multimodalHint": "When enabled, images from retrieved Echos are sent to the model so it can understand them (requires a vision-capable model).",
     "contextWindow": "Context window",
     "contextWindowPlaceholder": "e.g. 256k, 1m — empty defaults to 256k",
-    "contextWindowHint": "Budget for aggregating Echos by date range in year-end / monthly summaries: a larger window favors reading everything at once, a smaller one switches to month-by-month layered summarization sooner. Accepts k / m units (256k = 256000, 1m = 1000000); empty is treated as 256k."
+    "contextWindowHint": "A larger window favors reading everything at once; a smaller one switches to layered summarization sooner. Accepts k / m units (256k = 256000, 1m = 1000000); empty is treated as 256k."
   },
   "webhookSetting": {
     "title": "Webhook",
@@ -1004,6 +1003,7 @@
     "apiKeyPlaceholder": "Enter API Key (leave empty for local services)",
     "baseUrl": "Custom API URL",
     "baseUrlPlaceholder": "https://api.openai.com/v1",
+    "baseUrlHint": "Enter the service's API root URL; /embeddings is appended automatically — don't add it yourself.",
     "reindex": "Rebuild index",
     "reindexHint": "Regenerate vectors for all past echos. Run once after changing model or dimension.",
     "reindexAction": "Start rebuild",

web/src/locales/messages/ja-JP.json

@@ -672,7 +672,6 @@
     "apiKeyPlaceholder": "API Key を入力",
     "baseUrl": "Base URL",
     "baseUrlPlaceholder": "カスタム Base URL を入力",
-    "baseUrlHint": "「OpenAI 互換」プロトコルを選んだ場合、ここに DeepSeek や Ollama などのサービスのエンドポイントを入力します",
     "prompt": "Prompt",
     "promptPlaceholder": "カスタム Prompt を入力",
     "promptHint": "カスタム Prompt は「最近のまとめ」にのみ適用され、チャットでは使用されません",
@@ -1004,6 +1003,7 @@
     "apiKeyPlaceholder": "API Key を入力（ローカルサービスは空欄可）",
     "baseUrl": "カスタム API URL",
     "baseUrlPlaceholder": "https://api.openai.com/v1",
+    "baseUrlHint": "サービスの API ルート URL を入力してください。/embeddings は自動的に付加されるため、手動で追加しないでください。",
     "reindex": "インデックス再構築",
     "reindexHint": "すべての過去の Echo のベクトルを再生成します。モデルや次元の変更後に一度実行してください。",
     "reindexAction": "再構築を開始",

web/src/locales/messages/zh-CN.json

@@ -672,15 +672,14 @@
     "apiKeyPlaceholder": "输入 API Key",
     "baseUrl": "Base URL",
     "baseUrlPlaceholder": "输入自定义 Base URL",
-    "baseUrlHint": "选「OpenAI 兼容」协议时，在此填入 DeepSeek、Ollama 等服务的接口地址",
     "prompt": "Prompt",
     "promptPlaceholder": "输入自定义 Prompt",
     "promptHint": "自定义 Prompt 仅作用于「近期总结」，Chat 对话不会使用它",
     "multimodal": "多模态支持",
     "multimodalHint": "开启后，Chat 检索命中带图片的 Echo 时会把配图一并交给模型理解（需所配模型支持图片输入）",
     "contextWindow": "上下文窗口",
     "contextWindowPlaceholder": "如 256k、1m，留空默认 256k",
-    "contextWindowHint": "用于「年终 / 月度总结」按时间区间聚合 Echo 时的取数预算：窗口越大越倾向一次性读入全部内容，越小越早转为按月分层总结。支持 k / m 单位（256k=256000、1m=1000000），留空按 256k 处理。"
+    "contextWindowHint": "窗口越大越倾向一次性读入全部内容，越小越早转为分层总结。支持 k / m 单位（256k=256000、1m=1000000），留空按 256k 处理。"
   },
   "webhookSetting": {
     "title": "Webhook",
@@ -1004,6 +1003,7 @@
     "apiKeyPlaceholder": "请输入 API Key（本地服务可留空）",
     "baseUrl": "自定义 API 地址",
     "baseUrlPlaceholder": "https://api.openai.com/v1",
+    "baseUrlHint": "填写服务的 API 根地址即可，系统会自动补全 /embeddings，请勿手动添加。",
     "reindex": "重建索引",
     "reindexHint": "为全部历史 Echo 重新生成向量。更换模型或维度后需执行一次。",
     "reindexAction": "开始重建",

web/src/views/panel/modules/TheCopilot/TheAgentSetting.vue

@@ -62,7 +62,6 @@
           :placeholder="t('agentSetting.baseUrlPlaceholder')"
           class="w-full"
         />
-        <p class="text-xs opacity-70 mt-1">{{ t('agentSetting.baseUrlHint') }}</p>
       </template>
     </div>
 

web/src/views/panel/modules/TheCopilot/TheEmbeddingSetting.vue

@@ -70,6 +70,7 @@
         :placeholder="t('embeddingSetting.baseUrlPlaceholder')"
         class="w-full"
       />
+      <p v-if="editMode" class="text-xs opacity-70 mt-1">{{ t('embeddingSetting.baseUrlHint') }}</p>
     </div>
 
     <!-- 重建索引 -->