🖼️ feat: expose provider icons in providers index and NewAPI vendors

- Include `icon` and `lobeIcon` in provider index (written to `dist/api/providers.json`)
- Merge overrides before indexing, so icon fields reflect `data/overrides.json`
- NewAPI vendors: add `lobeicon` field; set `icon` to `provider.icon || provider.lobeIcon || ''`
- Update `buildIndexes(...)` to accept overrides and propagate icon fields

Notes:
- Backward compatible; existing consumers remain unaffected.
- New fields are additive and available after `npm run build`.

Author: t0ng7u

README.md

@@ -62,12 +62,39 @@ Config: `data/overrides.json`
 ```json
 {
   "providers": {
-    "deepseek": { "displayName": "DeepSeek (custom)" }
+    "openai": {
+      "name": "OpenAI (custom)",
+      "api": "https://api.openai.com",
+      "doc": "https://platform.openai.com/docs",
+      "icon": "https://example.com/icons/openai.svg",
+      "lobeIcon": "OpenAI.Color"
+    }
   },
   "models": {
-    "deepseek/deepseek-reasoner": { "tags": ["reasoning", "math"] }
+    "openai/gpt-4o": {
+      "description": "Optimized multimodal model with strong reasoning.",
+      "tags": ["vision", "tools"],
+      "limit": { "context": 131072, "output": 8192 },
+      "modalities": { "input": ["text", "image"], "output": ["text"] },
+      "reasoning": true,
+      "tool_call": true,
+      "attachment": false
+    }
   }
 }
 ```
 
 Deep-merge: original fields preserved unless explicitly overridden.
+
+- Provider-level overrides (e.g., `providers.deepseek.name`, `providers.deepseek.icon`, `providers.deepseek.lobeIcon`, `providers.deepseek.api`, `providers.deepseek.doc`)
+  - Affects:
+    - `dist/api/providers.json`
+    - `dist/api/providers/<provider>.json`
+    - `dist/api/all.json`
+    - `dist/api/newapi/vendors.json`
+
+- Model-level overrides (e.g., `models["deepseek/deepseek-reasoner"].description`, `tags`, `limit`, `modalities`, `cost`, `reasoning`, `tool_call`, `attachment`)
+  - Affects:
+    - `dist/api/all.json`
+    - `dist/api/models/<provider>/<model>.json`
+    - `dist/api/newapi/models.json`

README.zh-CN.md

@@ -62,12 +62,39 @@ npm run build
 ```json
 {
   "providers": {
-    "deepseek": { "displayName": "DeepSeek（自定义名称）" }
+    "openai": {
+      "name": "OpenAI（自定义）",
+      "api": "https://api.openai.com",
+      "doc": "https://platform.openai.com/docs",
+      "icon": "https://example.com/icons/openai.svg",
+      "lobeIcon": "OpenAI.Color"
+    }
   },
   "models": {
-    "deepseek/deepseek-reasoner": { "tags": ["reasoning", "math"] }
+    "openai/gpt-4o": {
+      "description": "面向多模态、具备较强推理能力的优化模型。",
+      "tags": ["vision", "tools"],
+      "limit": { "context": 131072, "output": 8192 },
+      "modalities": { "input": ["text", "image"], "output": ["text"] },
+      "reasoning": true,
+      "tool_call": true,
+      "attachment": false
+    }
   }
 }
 ```
 
 覆写采用“深度合并”，不移除原字段，仅覆盖同名字段或追加对象属性。
+
+- Provider 级覆写（例如：`providers.deepseek.name`、`providers.deepseek.icon`、`providers.deepseek.lobeIcon`、`providers.deepseek.api`、`providers.deepseek.doc`）
+  - 影响：
+    - `dist/api/providers.json`
+    - `dist/api/providers/<provider>.json`
+    - `dist/api/all.json`
+    - `dist/api/newapi/vendors.json`
+
+- Model 级覆写（例如：`models["deepseek/deepseek-reasoner"].description`、`tags`、`limit`、`modalities`、`cost`、`reasoning`、`tool_call`、`attachment`）
+  - 影响：
+    - `dist/api/all.json`
+    - `dist/api/models/<provider>/<model>.json`
+    - `dist/api/newapi/models.json`

scripts/build.js

@@ -169,16 +169,20 @@ function mapSourceToNormalized(source) {
   return { providers };
 }
 
-function buildIndexes(normalized) {
+function buildIndexes(normalized, overrides) {
   const providers = normalized.providers || {};
   const providerIndex = [];
   const modelIndex = [];
   for (const [pid, provider] of Object.entries(providers)) {
+    const pov = overrides?.providers?.[pid] || {};
+    const providerEffective = { ...provider, ...pov };
     const pInfo = {
       id: pid,
-      name: provider.name || pid,
-      api: provider.api || null,
-      doc: provider.doc || null,
+      name: providerEffective.name || pid,
+      api: providerEffective.api || null,
+      doc: providerEffective.doc || null,
+      icon: providerEffective.icon || null,
+      lobeIcon: providerEffective.lobeIcon || null,
       modelCount: 0,
     };
     const models = provider.models || {};
@@ -267,7 +271,7 @@ async function main() {
     }
   }
 
-  const { providerIndex, modelIndex } = buildIndexes(normalized);
+  const { providerIndex, modelIndex } = buildIndexes(normalized, overrides);
 
   const sourceHash = sha256OfObject(source);
   const overridesHash = sha256OfObject(overrides);
@@ -520,7 +524,8 @@ function buildNewApiSyncPayload(allModelsData) {
       // vendors table fields
       name: provider.name || providerId,
       description: provider.description || '',
-      icon: provider.icon || '',
+      icon: provider.icon || provider.lobeIcon || '',
+      lobeicon: provider.lobeIcon || '',
       status: 1
     });