Explorar o código

feat(core): 各 endpoint 加官网 URL 顶部注释 + 补 2026-04 新模型

每个 endpoint 文件顶部补 JSDoc 注释(官网 / 控制台 / API key / 文档 URL),
维护时一眼就能找到校验源。补充通过 live /models probe 校对到的 2026-04 新模型:

bailian / qwen:qwen3.6 系列 (27b/35b-a3b/flash/plus/max-preview)、
  kimi-k2.6、glm-5.1(代理)

moonshot:kimi-k2.6、moonshot-v1-auto

ppio:重写模型清单——lobe 冷启动留下的 llama-3.1 / yi-1.5 等过时条目替换为
  DeepSeek V3.2 / V3.1 / R1-0528、Kimi K2.5/K2.6/Thinking、MiniMax M2.*、
  GLM 4.5/4.6/4.7/5/5.1、Qwen3.5/3.6、ERNIE 4.5、MiMo v2 等当前 live 返回的模型

siliconcloud:补 Pro/moonshotai/Kimi-K2.6、Pro/zai-org/GLM-5、GLM-4.7、
  Qwen/Qwen3.6-27B、Qwen3.6-35B-A3B

providers-lookup.test.ts:随 ppio bank 调整更新测试 fixtures

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
fanghanjun hai 6 meses
pai
achega
68df4d5b60
Modificáronse 43 ficheiros con 426 adicións e 28 borrados
  1. 7 7
      packages/core/src/__tests__/providers-lookup.test.ts
  2. 7 0
      packages/core/src/llm/providers/endpoints/ai360.ts
  3. 9 0
      packages/core/src/llm/providers/endpoints/anthropic.ts
  4. 7 0
      packages/core/src/llm/providers/endpoints/baichuan.ts
  5. 21 0
      packages/core/src/llm/providers/endpoints/bailian.ts
  6. 7 0
      packages/core/src/llm/providers/endpoints/bailianCodingPlan.ts
  7. 6 0
      packages/core/src/llm/providers/endpoints/custom.ts
  8. 12 0
      packages/core/src/llm/providers/endpoints/deepseek.ts
  9. 7 0
      packages/core/src/llm/providers/endpoints/giteeai.ts
  10. 7 0
      packages/core/src/llm/providers/endpoints/githubCopilot.ts
  11. 6 0
      packages/core/src/llm/providers/endpoints/glmCodingPlan.ts
  12. 9 0
      packages/core/src/llm/providers/endpoints/google.ts
  13. 6 0
      packages/core/src/llm/providers/endpoints/higress.ts
  14. 7 0
      packages/core/src/llm/providers/endpoints/hunyuan.ts
  15. 7 0
      packages/core/src/llm/providers/endpoints/infiniai.ts
  16. 7 0
      packages/core/src/llm/providers/endpoints/internlm.ts
  17. 6 0
      packages/core/src/llm/providers/endpoints/kimiCodingPlan.ts
  18. 6 0
      packages/core/src/llm/providers/endpoints/longcat.ts
  19. 12 0
      packages/core/src/llm/providers/endpoints/minimax.ts
  20. 6 0
      packages/core/src/llm/providers/endpoints/minimaxCodingPlan.ts
  21. 8 0
      packages/core/src/llm/providers/endpoints/mistral.ts
  22. 7 0
      packages/core/src/llm/providers/endpoints/modelscope.ts
  23. 12 1
      packages/core/src/llm/providers/endpoints/moonshot.ts
  24. 6 0
      packages/core/src/llm/providers/endpoints/newapi.ts
  25. 9 0
      packages/core/src/llm/providers/endpoints/ollama.ts
  26. 9 0
      packages/core/src/llm/providers/endpoints/openai.ts
  27. 6 0
      packages/core/src/llm/providers/endpoints/opencodeCodingPlan.ts
  28. 12 0
      packages/core/src/llm/providers/endpoints/openrouter.ts
  29. 72 20
      packages/core/src/llm/providers/endpoints/ppio.ts
  30. 7 0
      packages/core/src/llm/providers/endpoints/qiniu.ts
  31. 20 0
      packages/core/src/llm/providers/endpoints/qwen.ts
  32. 7 0
      packages/core/src/llm/providers/endpoints/sensenova.ts
  33. 18 0
      packages/core/src/llm/providers/endpoints/siliconcloud.ts
  34. 7 0
      packages/core/src/llm/providers/endpoints/spark.ts
  35. 7 0
      packages/core/src/llm/providers/endpoints/stepfun.ts
  36. 7 0
      packages/core/src/llm/providers/endpoints/tencentcloud.ts
  37. 7 0
      packages/core/src/llm/providers/endpoints/volcengine.ts
  38. 6 0
      packages/core/src/llm/providers/endpoints/volcengineCodingPlan.ts
  39. 7 0
      packages/core/src/llm/providers/endpoints/wenxin.ts
  40. 8 0
      packages/core/src/llm/providers/endpoints/xai.ts
  41. 6 0
      packages/core/src/llm/providers/endpoints/xiaomimimo.ts
  42. 7 0
      packages/core/src/llm/providers/endpoints/zeroone.ts
  43. 9 0
      packages/core/src/llm/providers/endpoints/zhipu.ts

+ 7 - 7
packages/core/src/__tests__/providers-lookup.test.ts

@@ -49,11 +49,11 @@ describe("lookupModel", () => {
 });
 });
 
 
 describe("Layer 2 优先级(B5:PPIO vs OpenRouter 同 id)", () => {
 describe("Layer 2 优先级(B5:PPIO vs OpenRouter 同 id)", () => {
-  it("deepseek/deepseek-r1 在 PPIO 和 OpenRouter 都有,按 PROVIDER_PRIORITY 取 ppio(第二梯队)而不是 openrouter(第三梯队)", () => {
-    const hit = lookupModel("custom", "deepseek/deepseek-r1");
+  it("deepseek/deepseek-r1-0528 在 PPIO 和 OpenRouter 都有,按 PROVIDER_PRIORITY 取 ppio(第二梯队)而不是 openrouter(第三梯队)", () => {
+    const hit = lookupModel("custom", "deepseek/deepseek-r1-0528");
     expect(hit).toBeDefined();
     expect(hit).toBeDefined();
-    // PPIO 的 contextWindow 是 64000,OpenRouter 的是 163840
-    expect(hit?.contextWindowTokens).toBe(64000);
+    // PPIO 的 maxOutput 是 65536(reasoner),OpenRouter 的是 4096
+    expect(hit?.maxOutput).toBe(65536);
   });
   });
 
 
   it("OpenRouter 专属带后缀 id(:free)命中 openrouter provider", () => {
   it("OpenRouter 专属带后缀 id(:free)命中 openrouter provider", () => {
@@ -63,9 +63,9 @@ describe("Layer 2 优先级(B5:PPIO vs OpenRouter 同 id)", () => {
   });
   });
 
 
   it("PPIO 专属带斜线 id 命中 ppio provider", () => {
   it("PPIO 专属带斜线 id 命中 ppio provider", () => {
-    const hit = lookupModel("ppio", "deepseek/deepseek-v3");
-    expect(hit?.maxOutput).toBe(4096);
-    expect(hit?.contextWindowTokens).toBe(64000);
+    const hit = lookupModel("ppio", "deepseek/deepseek-v3.2");
+    expect(hit?.maxOutput).toBe(8192);
+    expect(hit?.contextWindowTokens).toBe(131072);
   });
   });
 });
 });
 
 

+ 7 - 0
packages/core/src/llm/providers/endpoints/ai360.ts

@@ -1,3 +1,10 @@
+/**
+ * 360 智脑 (360 AI)
+ *
+ * - 官网:https://ai.360.com/
+ * - 控制台 / API key:https://ai.360.com/platform/keys
+ * - API 文档:https://ai.360.com/platform/docs
+ */
 import type { InkosEndpoint } from "../types.js";
 import type { InkosEndpoint } from "../types.js";
 
 
 export const AI360: InkosEndpoint = {
 export const AI360: InkosEndpoint = {

+ 9 - 0
packages/core/src/llm/providers/endpoints/anthropic.ts

@@ -1,3 +1,12 @@
+/**
+ * Anthropic (Claude)
+ *
+ * - 官网:https://www.anthropic.com/
+ * - 控制台:https://console.anthropic.com/
+ * - API key:https://console.anthropic.com/settings/keys
+ * - API 文档:https://docs.anthropic.com/en/api/
+ * - 模型列表:https://docs.anthropic.com/en/docs/about-claude/models/overview
+ */
 import type { InkosEndpoint } from "../types.js";
 import type { InkosEndpoint } from "../types.js";
 
 
 export const ANTHROPIC: InkosEndpoint = {
 export const ANTHROPIC: InkosEndpoint = {

+ 7 - 0
packages/core/src/llm/providers/endpoints/baichuan.ts

@@ -1,3 +1,10 @@
+/**
+ * 百川智能 (Baichuan AI)
+ *
+ * - 官网:https://www.baichuan-ai.com/
+ * - 控制台 / API key:https://platform.baichuan-ai.com/console/apikey
+ * - API 文档:https://platform.baichuan-ai.com/docs/api
+ */
 import type { InkosEndpoint } from "../types.js";
 import type { InkosEndpoint } from "../types.js";
 
 
 export const BAICHUAN: InkosEndpoint = {
 export const BAICHUAN: InkosEndpoint = {

+ 21 - 0
packages/core/src/llm/providers/endpoints/bailian.ts

@@ -1,3 +1,15 @@
+/**
+ * 阿里云百炼(DashScope)
+ *
+ * - 控制台:https://bailian.console.aliyun.com/
+ * - API key:https://bailian.console.aliyun.com/?tab=model#/api-key
+ * - 模型列表:https://help.aliyun.com/zh/model-studio/getting-started/models
+ * - Anthropic 兼容接入:https://help.aliyun.com/zh/model-studio/developer-reference/use-anthropic-sdk
+ * - OpenAI 兼容 /models:https://dashscope.aliyuncs.com/compatible-mode/v1/models
+ *
+ * inkos 选 anthropic-messages 接入是因为 agent 场景下工具调用在这条链路上更稳;
+ * 模型列表 probe 走 compatible-mode/v1(apps/anthropic 没有 /models 端点)。
+ */
 import type { InkosEndpoint } from "../types.js";
 import type { InkosEndpoint } from "../types.js";
 
 
 export const BAILIAN: InkosEndpoint = {
 export const BAILIAN: InkosEndpoint = {
@@ -11,7 +23,16 @@ export const BAILIAN: InkosEndpoint = {
   defaultTemperature: 0.7,
   defaultTemperature: 0.7,
   writingTemperature: 1,
   writingTemperature: 1,
   models: [
   models: [
+    // --- Qwen3.6 系列(2026-04 发布) ---
+    { id: "qwen3.6-max-preview", maxOutput: 65536, contextWindowTokens: 262144, enabled: true, releasedAt: "2026-04-21" },
+    { id: "qwen3.6-plus", maxOutput: 65536, contextWindowTokens: 1000000, enabled: true, releasedAt: "2026-04-09" },
+    { id: "qwen3.6-flash", maxOutput: 65536, contextWindowTokens: 1000000, enabled: true, releasedAt: "2026-04-17" },
+    { id: "qwen3.6-27b", maxOutput: 65536, contextWindowTokens: 262144, releasedAt: "2026-04-23" },
+    { id: "qwen3.6-35b-a3b", maxOutput: 65536, contextWindowTokens: 262144, releasedAt: "2026-04-17" },
+    // --- 第三方代理(百炼平台上的) ---
+    { id: "kimi-k2.6", maxOutput: 32768, contextWindowTokens: 262144, enabled: true, releasedAt: "2026-04-21" },
     { id: "kimi-k2.5", maxOutput: 32768, contextWindowTokens: 262144 },
     { id: "kimi-k2.5", maxOutput: 32768, contextWindowTokens: 262144 },
+    { id: "glm-5.1", maxOutput: 16384, contextWindowTokens: 202752, enabled: true, releasedAt: "2026-04-23" },
     { id: "MiniMax-M2.5", maxOutput: 32768, contextWindowTokens: 196608 },
     { id: "MiniMax-M2.5", maxOutput: 32768, contextWindowTokens: 196608 },
     { id: "MiniMax-M2.1", maxOutput: 32768, contextWindowTokens: 204800 },
     { id: "MiniMax-M2.1", maxOutput: 32768, contextWindowTokens: 204800 },
     { id: "qwen3-vl-plus", maxOutput: 32768, contextWindowTokens: 262144, releasedAt: "2025-09-23" },
     { id: "qwen3-vl-plus", maxOutput: 32768, contextWindowTokens: 262144, releasedAt: "2025-09-23" },

+ 7 - 0
packages/core/src/llm/providers/endpoints/bailianCodingPlan.ts

@@ -1,3 +1,10 @@
+/**
+ * 百炼 CodingPlan (通义灵码订阅)
+ *
+ * - 官网:https://tongyi.aliyun.com/lingma
+ * - 订阅套餐,非即用即付。具体模型取决于套餐权益。
+ * - 模型列表:https://help.aliyun.com/zh/model-studio/coding-plan
+ */
 import type { InkosEndpoint } from "../types.js";
 import type { InkosEndpoint } from "../types.js";
 
 
 export const BAILIAN_CODING_PLAN: InkosEndpoint = {
 export const BAILIAN_CODING_PLAN: InkosEndpoint = {

+ 6 - 0
packages/core/src/llm/providers/endpoints/custom.ts

@@ -1,3 +1,9 @@
+/**
+ * 自定义 OpenAI 兼容端点
+ *
+ * - 任意兼容 OpenAI /v1/chat/completions 协议的服务都可通过此 endpoint 接入。
+ * - 模型列表走 live /models probe,bank 不预置任何条目。
+ */
 import type { InkosEndpoint } from "../types.js";
 import type { InkosEndpoint } from "../types.js";
 
 
 /**
 /**

+ 12 - 0
packages/core/src/llm/providers/endpoints/deepseek.ts

@@ -1,3 +1,15 @@
+/**
+ * DeepSeek
+ *
+ * - 官网:https://www.deepseek.com/
+ * - 控制台:https://platform.deepseek.com/
+ * - API key:https://platform.deepseek.com/api_keys
+ * - API 文档:https://api-docs.deepseek.com/
+ * - 模型列表:https://api-docs.deepseek.com/quick_start/pricing
+ *
+ * 官方 API 仅 2 个 id:deepseek-chat (V3.2 non-thinking) / deepseek-reasoner (V3.2 thinking)。
+ * V4/R2 等新模型发布时会替换同 id 背后的底层模型(alias 模式),id 本身保持不变。
+ */
 import type { InkosEndpoint } from "../types.js";
 import type { InkosEndpoint } from "../types.js";
 
 
 export const DEEPSEEK: InkosEndpoint = {
 export const DEEPSEEK: InkosEndpoint = {

+ 7 - 0
packages/core/src/llm/providers/endpoints/giteeai.ts

@@ -1,3 +1,10 @@
+/**
+ * Gitee AI
+ *
+ * - 官网:https://ai.gitee.com/
+ * - 控制台 / API key:https://ai.gitee.com/dashboard/settings/tokens
+ * - API 文档:https://ai.gitee.com/docs/openapi/serverless
+ */
 import type { InkosEndpoint } from "../types.js";
 import type { InkosEndpoint } from "../types.js";
 
 
 export const GITEEAI: InkosEndpoint = {
 export const GITEEAI: InkosEndpoint = {

+ 7 - 0
packages/core/src/llm/providers/endpoints/githubCopilot.ts

@@ -1,3 +1,10 @@
+/**
+ * GitHub Copilot
+ *
+ * - 官网:https://github.com/features/copilot
+ * - 通过 GitHub OAuth 获取 token 后走 Copilot API,inkos 用它作为 LLM 入口需要用户已有 Copilot 订阅。
+ * - 接入细节:https://docs.github.com/en/copilot
+ */
 import type { InkosEndpoint } from "../types.js";
 import type { InkosEndpoint } from "../types.js";
 
 
 export const GITHUB_COPILOT: InkosEndpoint = {
 export const GITHUB_COPILOT: InkosEndpoint = {

+ 6 - 0
packages/core/src/llm/providers/endpoints/glmCodingPlan.ts

@@ -1,3 +1,9 @@
+/**
+ * 智谱 GLM CodingPlan
+ *
+ * - 官网:https://bigmodel.cn/coding-plan
+ * - 订阅套餐,针对编程场景优化过的 GLM 变体。
+ */
 import type { InkosEndpoint } from "../types.js";
 import type { InkosEndpoint } from "../types.js";
 
 
 export const GLM_CODING_PLAN: InkosEndpoint = {
 export const GLM_CODING_PLAN: InkosEndpoint = {

+ 9 - 0
packages/core/src/llm/providers/endpoints/google.ts

@@ -1,3 +1,12 @@
+/**
+ * Google Gemini
+ *
+ * - 官网:https://ai.google.dev/
+ * - 控制台 / API key:https://aistudio.google.com/app/apikey
+ * - API 文档:https://ai.google.dev/gemini-api/docs
+ * - 模型列表:https://ai.google.dev/gemini-api/docs/models
+ * - OpenAI 兼容接入:https://ai.google.dev/gemini-api/docs/openai
+ */
 import type { InkosEndpoint } from "../types.js";
 import type { InkosEndpoint } from "../types.js";
 
 
 export const GOOGLE: InkosEndpoint = {
 export const GOOGLE: InkosEndpoint = {

+ 6 - 0
packages/core/src/llm/providers/endpoints/higress.ts

@@ -1,3 +1,9 @@
+/**
+ * Higress AI Gateway
+ *
+ * - Higress:https://higress.cn/
+ * - 阿里云原生 AI 网关,代理模式 OpenAI 兼容,具体模型由用户在 Higress 侧配置。
+ */
 import type { InkosEndpoint } from "../types.js";
 import type { InkosEndpoint } from "../types.js";
 
 
 export const HIGRESS: InkosEndpoint = {
 export const HIGRESS: InkosEndpoint = {

+ 7 - 0
packages/core/src/llm/providers/endpoints/hunyuan.ts

@@ -1,3 +1,10 @@
+/**
+ * 腾讯混元 (Hunyuan)
+ *
+ * - 官网:https://cloud.tencent.com/product/hunyuan
+ * - 控制台 / API key:https://console.cloud.tencent.com/hunyuan/api-key
+ * - API 文档:https://cloud.tencent.com/document/product/1729
+ */
 import type { InkosEndpoint } from "../types.js";
 import type { InkosEndpoint } from "../types.js";
 
 
 export const HUNYUAN: InkosEndpoint = {
 export const HUNYUAN: InkosEndpoint = {

+ 7 - 0
packages/core/src/llm/providers/endpoints/infiniai.ts

@@ -1,3 +1,10 @@
+/**
+ * 无问芯穹 (Infini-AI / GenStudio)
+ *
+ * - 官网:https://cloud.infini-ai.com/
+ * - 控制台 / API key:https://cloud.infini-ai.com/iam/secret
+ * - API 文档:https://docs.infini-ai.com/
+ */
 import type { InkosEndpoint } from "../types.js";
 import type { InkosEndpoint } from "../types.js";
 
 
 export const INFINIAI: InkosEndpoint = {
 export const INFINIAI: InkosEndpoint = {

+ 7 - 0
packages/core/src/llm/providers/endpoints/internlm.ts

@@ -1,3 +1,10 @@
+/**
+ * 书生浦语 (InternLM)
+ *
+ * - 官网:https://internlm.intern-ai.org.cn/
+ * - 控制台 / API key:https://internlm.intern-ai.org.cn/api/document
+ * - 开源仓库:https://github.com/InternLM/InternLM
+ */
 import type { InkosEndpoint } from "../types.js";
 import type { InkosEndpoint } from "../types.js";
 
 
 export const INTERNLM: InkosEndpoint = {
 export const INTERNLM: InkosEndpoint = {

+ 6 - 0
packages/core/src/llm/providers/endpoints/kimiCodingPlan.ts

@@ -1,3 +1,9 @@
+/**
+ * Kimi CodingPlan
+ *
+ * - 官网:https://platform.moonshot.cn/
+ * - Moonshot 针对编程场景的订阅套餐。
+ */
 import type { InkosEndpoint } from "../types.js";
 import type { InkosEndpoint } from "../types.js";
 
 
 export const KIMI_CODING_PLAN: InkosEndpoint = {
 export const KIMI_CODING_PLAN: InkosEndpoint = {

+ 6 - 0
packages/core/src/llm/providers/endpoints/longcat.ts

@@ -1,3 +1,9 @@
+/**
+ * LongCat (美团)
+ *
+ * - 官网:https://longcat.chat/
+ * - API 文档:https://longcat.chat/platform/docs
+ */
 import type { InkosEndpoint } from "../types.js";
 import type { InkosEndpoint } from "../types.js";
 
 
 export const LONGCAT: InkosEndpoint = {
 export const LONGCAT: InkosEndpoint = {

+ 12 - 0
packages/core/src/llm/providers/endpoints/minimax.ts

@@ -1,3 +1,15 @@
+/**
+ * MiniMax
+ *
+ * - 官网:https://www.minimax.io/
+ * - 控制台 / API key:https://platform.minimaxi.com/user-center/basic-information/interface-key
+ * - API 文档:https://platform.minimaxi.com/document/platform%20introduction
+ * - 模型列表:https://platform.minimaxi.com/document/text
+ *
+ * inkos 用 Anthropic 兼容接入 (api.minimaxi.com/anthropic):agent 场景下
+ * OpenAI 兼容 (/v1) 的工具调用不稳定;这条链路上工具调用可靠。
+ * MiniMax 没有公开的 /models 端点,模型清单只能按官方文档手维护。
+ */
 import type { InkosEndpoint } from "../types.js";
 import type { InkosEndpoint } from "../types.js";
 
 
 export const MINIMAX: InkosEndpoint = {
 export const MINIMAX: InkosEndpoint = {

+ 6 - 0
packages/core/src/llm/providers/endpoints/minimaxCodingPlan.ts

@@ -1,3 +1,9 @@
+/**
+ * MiniMax CodingPlan
+ *
+ * - 官网:https://platform.minimaxi.com/
+ * - MiniMax 针对编程场景的订阅套餐。
+ */
 import type { InkosEndpoint } from "../types.js";
 import type { InkosEndpoint } from "../types.js";
 
 
 export const MINIMAX_CODING_PLAN: InkosEndpoint = {
 export const MINIMAX_CODING_PLAN: InkosEndpoint = {

+ 8 - 0
packages/core/src/llm/providers/endpoints/mistral.ts

@@ -1,3 +1,11 @@
+/**
+ * Mistral AI
+ *
+ * - 官网:https://mistral.ai/
+ * - 控制台 / API key:https://console.mistral.ai/api-keys/
+ * - API 文档:https://docs.mistral.ai/api/
+ * - 模型列表:https://docs.mistral.ai/getting-started/models/models_overview/
+ */
 import type { InkosEndpoint } from "../types.js";
 import type { InkosEndpoint } from "../types.js";
 
 
 export const MISTRAL: InkosEndpoint = {
 export const MISTRAL: InkosEndpoint = {

+ 7 - 0
packages/core/src/llm/providers/endpoints/modelscope.ts

@@ -1,3 +1,10 @@
+/**
+ * ModelScope (魔搭)
+ *
+ * - 官网:https://www.modelscope.cn/
+ * - 控制台 / API key:https://www.modelscope.cn/my/myaccesstoken
+ * - API 文档:https://www.modelscope.cn/docs/model-service/API-Inference/intro
+ */
 import type { InkosEndpoint } from "../types.js";
 import type { InkosEndpoint } from "../types.js";
 
 
 export const MODELSCOPE: InkosEndpoint = {
 export const MODELSCOPE: InkosEndpoint = {

+ 12 - 1
packages/core/src/llm/providers/endpoints/moonshot.ts

@@ -1,3 +1,12 @@
+/**
+ * Moonshot AI (Kimi)
+ *
+ * - 官网:https://www.moonshot.cn/
+ * - 控制台:https://platform.moonshot.cn/console/
+ * - API key:https://platform.moonshot.cn/console/api-keys
+ * - API 文档:https://platform.moonshot.cn/docs/api-reference
+ * - 模型列表:https://platform.moonshot.cn/docs/pricing/chat
+ */
 import type { InkosEndpoint } from "../types.js";
 import type { InkosEndpoint } from "../types.js";
 
 
 export const MOONSHOT: InkosEndpoint = {
 export const MOONSHOT: InkosEndpoint = {
@@ -9,14 +18,16 @@ export const MOONSHOT: InkosEndpoint = {
   temperatureRange: [0, 1],
   temperatureRange: [0, 1],
   defaultTemperature: 0.3,
   defaultTemperature: 0.3,
   writingTemperature: 1,
   writingTemperature: 1,
-  temperatureHint: "kimi-k2.5 推荐 temperature=1.0",
+  temperatureHint: "kimi-k2.5/k2.6 推荐 temperature=1.0",
   models: [
   models: [
+    { id: "kimi-k2.6", maxOutput: 32768, contextWindowTokens: 262144, enabled: true, releasedAt: "2026-04-21" },
     { id: "kimi-k2.5", maxOutput: 32768, contextWindowTokens: 262144, enabled: true, releasedAt: "2026-01-27" },
     { id: "kimi-k2.5", maxOutput: 32768, contextWindowTokens: 262144, enabled: true, releasedAt: "2026-01-27" },
     { id: "kimi-k2-thinking", maxOutput: 65536, contextWindowTokens: 262144, releasedAt: "2025-11-06" },
     { id: "kimi-k2-thinking", maxOutput: 65536, contextWindowTokens: 262144, releasedAt: "2025-11-06" },
     { id: "kimi-k2-thinking-turbo", maxOutput: 65536, contextWindowTokens: 262144, releasedAt: "2025-11-06" },
     { id: "kimi-k2-thinking-turbo", maxOutput: 65536, contextWindowTokens: 262144, releasedAt: "2025-11-06" },
     { id: "kimi-k2-0905-preview", maxOutput: 65536, contextWindowTokens: 262144, releasedAt: "2025-09-05" },
     { id: "kimi-k2-0905-preview", maxOutput: 65536, contextWindowTokens: 262144, releasedAt: "2025-09-05" },
     { id: "kimi-k2-0711-preview", maxOutput: 4096, contextWindowTokens: 131072, releasedAt: "2025-07-11" },
     { id: "kimi-k2-0711-preview", maxOutput: 4096, contextWindowTokens: 131072, releasedAt: "2025-07-11" },
     { id: "kimi-k2-turbo-preview", maxOutput: 4096, contextWindowTokens: 262144, enabled: true, releasedAt: "2025-09-05" },
     { id: "kimi-k2-turbo-preview", maxOutput: 4096, contextWindowTokens: 262144, enabled: true, releasedAt: "2025-09-05" },
+    { id: "moonshot-v1-auto", maxOutput: 4096, contextWindowTokens: 131072 },
     { id: "moonshot-v1-8k", maxOutput: 4096, contextWindowTokens: 8192 },
     { id: "moonshot-v1-8k", maxOutput: 4096, contextWindowTokens: 8192 },
     { id: "moonshot-v1-32k", maxOutput: 4096, contextWindowTokens: 32768 },
     { id: "moonshot-v1-32k", maxOutput: 4096, contextWindowTokens: 32768 },
     { id: "moonshot-v1-128k", maxOutput: 4096, contextWindowTokens: 131072 },
     { id: "moonshot-v1-128k", maxOutput: 4096, contextWindowTokens: 131072 },

+ 6 - 0
packages/core/src/llm/providers/endpoints/newapi.ts

@@ -1,3 +1,9 @@
+/**
+ * NewAPI (自建网关)
+ *
+ * - New API (one-api fork):https://github.com/Calcium-Ion/new-api
+ * - 自建 OpenAI 兼容网关,模型清单由部署方自定义,inkos 只提供协议对接。
+ */
 import type { InkosEndpoint } from "../types.js";
 import type { InkosEndpoint } from "../types.js";
 
 
 /**
 /**

+ 9 - 0
packages/core/src/llm/providers/endpoints/ollama.ts

@@ -1,3 +1,12 @@
+/**
+ * Ollama (本地)
+ *
+ * - 官网:https://ollama.com/
+ * - 模型广场:https://ollama.com/library
+ * - API 文档:https://github.com/ollama/ollama/blob/main/docs/api.md
+ *
+ * - 默认 baseUrl 指向本地 11434,inkos 通过 OpenAI 兼容模式 (/v1) 接入。
+ */
 import type { InkosEndpoint } from "../types.js";
 import type { InkosEndpoint } from "../types.js";
 
 
 export const OLLAMA: InkosEndpoint = {
 export const OLLAMA: InkosEndpoint = {

+ 9 - 0
packages/core/src/llm/providers/endpoints/openai.ts

@@ -1,3 +1,12 @@
+/**
+ * OpenAI
+ *
+ * - 官网:https://openai.com/
+ * - 控制台:https://platform.openai.com/
+ * - API key:https://platform.openai.com/api-keys
+ * - API 文档:https://platform.openai.com/docs/api-reference
+ * - 模型列表:https://platform.openai.com/docs/models
+ */
 import type { InkosEndpoint } from "../types.js";
 import type { InkosEndpoint } from "../types.js";
 
 
 export const OPENAI: InkosEndpoint = {
 export const OPENAI: InkosEndpoint = {

+ 6 - 0
packages/core/src/llm/providers/endpoints/opencodeCodingPlan.ts

@@ -1,3 +1,9 @@
+/**
+ * OpenCode CodingPlan
+ *
+ * - OpenCode 聚合的编码类套餐,具体后端随订阅变化。
+ * - 官网:https://opencode.ai/
+ */
 import type { InkosEndpoint } from "../types.js";
 import type { InkosEndpoint } from "../types.js";
 
 
 export const OPENCODE_CODING_PLAN: InkosEndpoint = {
 export const OPENCODE_CODING_PLAN: InkosEndpoint = {

+ 12 - 0
packages/core/src/llm/providers/endpoints/openrouter.ts

@@ -1,3 +1,15 @@
+/**
+ * OpenRouter
+ *
+ * - 官网:https://openrouter.ai/
+ * - 控制台 / API key:https://openrouter.ai/keys
+ * - 模型广场:https://openrouter.ai/models
+ * - API 文档:https://openrouter.ai/docs/api-reference/overview
+ * - 模型列表 JSON:https://openrouter.ai/api/v1/models
+ *
+ * 聚合所有主流家 (Anthropic / OpenAI / Google / xAI / Meta 等) 的统一入口。
+ * 350+ 模型,bank 只列最常用的;完整清单用户侧 live /models probe。
+ */
 import type { InkosEndpoint } from "../types.js";
 import type { InkosEndpoint } from "../types.js";
 
 
 export const OPENROUTER: InkosEndpoint = {
 export const OPENROUTER: InkosEndpoint = {

+ 72 - 20
packages/core/src/llm/providers/endpoints/ppio.ts

@@ -1,3 +1,15 @@
+/**
+ * PPIO (派欧云)
+ *
+ * - 官网:https://ppinfra.com/
+ * - 控制台 / API key:https://ppinfra.com/user/api-keys
+ * - 模型广场:https://ppinfra.com/model
+ * - API 文档:https://ppinfra.com/docs/model-api
+ *
+ * 聚合型推理平台,代理 DeepSeek / Qwen / Moonshot / MiniMax / GLM / 百度 ERNIE 等,
+ * 模型更新频繁(每周都有新 id),bank 只维护主流文本 chat 模型,
+ * 元数据以 live /models probe 为准。
+ */
 import type { InkosEndpoint } from "../types.js";
 import type { InkosEndpoint } from "../types.js";
 
 
 export const PPIO: InkosEndpoint = {
 export const PPIO: InkosEndpoint = {
@@ -5,29 +17,69 @@ export const PPIO: InkosEndpoint = {
   label: "PPIO",
   label: "PPIO",
   api: "openai-completions",
   api: "openai-completions",
   baseUrl: "https://api.ppinfra.com/v3/openai",
   baseUrl: "https://api.ppinfra.com/v3/openai",
-  checkModel: "deepseek/deepseek-v3",
+  checkModel: "deepseek/deepseek-v3.2",
   temperatureRange: [0, 2],
   temperatureRange: [0, 2],
   defaultTemperature: 0.7,
   defaultTemperature: 0.7,
   writingTemperature: 1,
   writingTemperature: 1,
   models: [
   models: [
-    { id: "deepseek/deepseek-r1/community", maxOutput: 4096, contextWindowTokens: 64000, enabled: true },
-    { id: "deepseek/deepseek-v3/community", maxOutput: 4096, contextWindowTokens: 64000, enabled: true },
-    { id: "deepseek/deepseek-r1", maxOutput: 4096, contextWindowTokens: 64000, enabled: true },
-    { id: "deepseek/deepseek-v3", maxOutput: 4096, contextWindowTokens: 64000, enabled: true },
-    { id: "deepseek/deepseek-r1-distill-llama-70b", maxOutput: 4096, contextWindowTokens: 32000, enabled: true },
-    { id: "deepseek/deepseek-r1-distill-qwen-32b", maxOutput: 4096, contextWindowTokens: 64000, enabled: true },
-    { id: "deepseek/deepseek-r1-distill-qwen-14b", maxOutput: 4096, contextWindowTokens: 64000, enabled: true },
-    { id: "deepseek/deepseek-r1-distill-llama-8b", maxOutput: 4096, contextWindowTokens: 32000, enabled: true },
-    { id: "qwen/qwen-2.5-72b-instruct", maxOutput: 4096, contextWindowTokens: 32768, enabled: true },
-    { id: "qwen/qwen-2-vl-72b-instruct", maxOutput: 4096, contextWindowTokens: 32768, enabled: true },
-    { id: "meta-llama/llama-3.2-3b-instruct", maxOutput: 4096, contextWindowTokens: 32768, enabled: true },
-    { id: "qwen/qwen2.5-32b-instruct", maxOutput: 4096, contextWindowTokens: 32000, enabled: true },
-    { id: "baichuan/baichuan2-13b-chat", maxOutput: 4096, contextWindowTokens: 14336, enabled: true },
-    { id: "meta-llama/llama-3.1-70b-instruct", maxOutput: 4096, contextWindowTokens: 32768, enabled: true },
-    { id: "meta-llama/llama-3.1-8b-instruct", maxOutput: 4096, contextWindowTokens: 32768, enabled: true },
-    { id: "01-ai/yi-1.5-34b-chat", maxOutput: 4096, contextWindowTokens: 16384, enabled: true },
-    { id: "01-ai/yi-1.5-9b-chat", maxOutput: 4096, contextWindowTokens: 16384, enabled: true },
-    { id: "thudm/glm-4-9b-chat", maxOutput: 4096, contextWindowTokens: 32768, enabled: true },
-    { id: "qwen/qwen-2-7b-instruct", maxOutput: 4096, contextWindowTokens: 32768, enabled: true },
+    // --- DeepSeek 系列 ---
+    { id: "deepseek/deepseek-v3.2", maxOutput: 8192, contextWindowTokens: 131072, enabled: true },
+    { id: "deepseek/deepseek-v3.2-exp", maxOutput: 8192, contextWindowTokens: 131072 },
+    { id: "deepseek/deepseek-v3.1-terminus", maxOutput: 8192, contextWindowTokens: 131072 },
+    { id: "deepseek/deepseek-v3.1", maxOutput: 8192, contextWindowTokens: 131072 },
+    { id: "deepseek/deepseek-v3-0324", maxOutput: 8192, contextWindowTokens: 65536 },
+    { id: "deepseek/deepseek-v3-turbo", maxOutput: 8192, contextWindowTokens: 131072 },
+    { id: "deepseek/deepseek-r1-0528", maxOutput: 65536, contextWindowTokens: 131072 },
+    { id: "deepseek/deepseek-r1-turbo", maxOutput: 65536, contextWindowTokens: 131072 },
+    { id: "deepseek/deepseek-prover-v2-671b", maxOutput: 32768, contextWindowTokens: 131072 },
+    // --- Moonshot Kimi 系列 ---
+    { id: "moonshotai/kimi-k2.6", maxOutput: 32768, contextWindowTokens: 262144, enabled: true, releasedAt: "2026-04-21" },
+    { id: "moonshotai/kimi-k2.5", maxOutput: 32768, contextWindowTokens: 262144, releasedAt: "2026-01-27" },
+    { id: "moonshotai/kimi-k2-thinking", maxOutput: 65536, contextWindowTokens: 262144 },
+    { id: "moonshotai/kimi-k2-0905", maxOutput: 8192, contextWindowTokens: 262144 },
+    { id: "moonshotai/kimi-k2-instruct", maxOutput: 8192, contextWindowTokens: 131072 },
+    // --- MiniMax ---
+    { id: "minimax/minimax-m2.7", maxOutput: 32768, contextWindowTokens: 204800, enabled: true },
+    { id: "minimax/minimax-m2.7-highspeed", maxOutput: 32768, contextWindowTokens: 204800 },
+    { id: "minimax/minimax-m2.5", maxOutput: 32768, contextWindowTokens: 196608 },
+    { id: "minimax/minimax-m2.5-highspeed", maxOutput: 32768, contextWindowTokens: 196608 },
+    { id: "minimax/minimax-m2.1", maxOutput: 32768, contextWindowTokens: 204800 },
+    { id: "minimax/minimax-m2", maxOutput: 32768, contextWindowTokens: 204800 },
+    // --- 智谱 GLM ---
+    { id: "zai-org/glm-5.1", maxOutput: 16384, contextWindowTokens: 202752, enabled: true, releasedAt: "2026-04-23" },
+    { id: "zai-org/glm-5", maxOutput: 16384, contextWindowTokens: 202752 },
+    { id: "zai-org/glm-5-turbo", maxOutput: 16384, contextWindowTokens: 131072 },
+    { id: "zai-org/glm-4.7", maxOutput: 16384, contextWindowTokens: 202752 },
+    { id: "zai-org/glm-4.7-flash", maxOutput: 16384, contextWindowTokens: 131072 },
+    { id: "zai-org/glm-4.6", maxOutput: 16384, contextWindowTokens: 202752 },
+    { id: "zai-org/glm-4.5", maxOutput: 16384, contextWindowTokens: 131072 },
+    { id: "zai-org/glm-4.5-air", maxOutput: 16384, contextWindowTokens: 131072 },
+    // --- Qwen 系列 ---
+    { id: "qwen/qwen3.6-27b", maxOutput: 65536, contextWindowTokens: 262144, enabled: true, releasedAt: "2026-04-23" },
+    { id: "qwen/qwen3.5-plus", maxOutput: 65536, contextWindowTokens: 1000000, enabled: true },
+    { id: "qwen/qwen3.5-397b-a17b", maxOutput: 65536, contextWindowTokens: 262144 },
+    { id: "qwen/qwen3.5-122b-a10b", maxOutput: 65536, contextWindowTokens: 262144 },
+    { id: "qwen/qwen3.5-35b-a3b", maxOutput: 65536, contextWindowTokens: 262144 },
+    { id: "qwen/qwen3.5-27b", maxOutput: 65536, contextWindowTokens: 262144 },
+    { id: "qwen/qwen3-coder-next", maxOutput: 65536, contextWindowTokens: 262144 },
+    { id: "qwen/qwen3-coder-480b-a35b-instruct", maxOutput: 65536, contextWindowTokens: 262144 },
+    { id: "qwen/qwen3-next-80b-a3b-instruct", maxOutput: 32768, contextWindowTokens: 131072 },
+    { id: "qwen/qwen3-next-80b-a3b-thinking", maxOutput: 32768, contextWindowTokens: 131072 },
+    { id: "qwen/qwen3-235b-a22b-instruct-2507", maxOutput: 32768, contextWindowTokens: 131072 },
+    { id: "qwen/qwen3-235b-a22b-thinking-2507", maxOutput: 32768, contextWindowTokens: 131072 },
+    { id: "qwen/qwen3-235b-a22b-fp8", maxOutput: 8192, contextWindowTokens: 131072 },
+    { id: "qwen/qwen3-32b-fp8", maxOutput: 8192, contextWindowTokens: 131072 },
+    { id: "qwen/qwen3-30b-a3b-fp8", maxOutput: 8192, contextWindowTokens: 131072 },
+    { id: "qwen/qwen-2.5-72b-instruct", maxOutput: 8192, contextWindowTokens: 32768 },
+    // --- 百度 ERNIE 4.5 ---
+    { id: "baidu/ernie-4.5-300b-a47b-paddle", maxOutput: 8192, contextWindowTokens: 131072 },
+    { id: "baidu/ernie-4.5-21B-a3b", maxOutput: 8192, contextWindowTokens: 131072 },
+    { id: "baidu/ernie-4.5-21b-a3b-thinking", maxOutput: 32768, contextWindowTokens: 131072 },
+    // --- 小米 MiMo ---
+    { id: "xiaomimimo/mimo-v2-pro", maxOutput: 16384, contextWindowTokens: 131072 },
+    { id: "xiaomimimo/mimo-v2-flash", maxOutput: 16384, contextWindowTokens: 131072 },
+    // --- PPIO 自研 ---
+    { id: "ppio-4b", maxOutput: 8192, contextWindowTokens: 32768 },
+    { id: "kat-coder", maxOutput: 32768, contextWindowTokens: 131072 },
   ],
   ],
 };
 };

+ 7 - 0
packages/core/src/llm/providers/endpoints/qiniu.ts

@@ -1,3 +1,10 @@
+/**
+ * 七牛云 AI 推理 (Qiniu)
+ *
+ * - 官网:https://www.qiniu.com/
+ * - 控制台 / API key:https://portal.qiniu.com/ai-inference/api-key
+ * - API 文档:https://developer.qiniu.com/aitokenapi
+ */
 import type { InkosEndpoint } from "../types.js";
 import type { InkosEndpoint } from "../types.js";
 
 
 export const QINIU: InkosEndpoint = {
 export const QINIU: InkosEndpoint = {

+ 20 - 0
packages/core/src/llm/providers/endpoints/qwen.ts

@@ -1,3 +1,14 @@
+/**
+ * 通义千问(百炼 OpenAI 兼容接入)
+ *
+ * - 控制台:https://bailian.console.aliyun.com/
+ * - 模型文档:https://help.aliyun.com/zh/model-studio/getting-started/models
+ * - OpenAI 兼容 API:https://help.aliyun.com/zh/model-studio/developer-reference/use-openai-sdk
+ *
+ * 和 bailian endpoint 同源(同一套百炼后端),区别在 api 协议:
+ * - qwen:openai-completions(/compatible-mode/v1)
+ * - bailian:anthropic-messages(/apps/anthropic)
+ */
 import type { InkosEndpoint } from "../types.js";
 import type { InkosEndpoint } from "../types.js";
 
 
 export const QWEN: InkosEndpoint = {
 export const QWEN: InkosEndpoint = {
@@ -10,7 +21,16 @@ export const QWEN: InkosEndpoint = {
   defaultTemperature: 0.7,
   defaultTemperature: 0.7,
   writingTemperature: 1,
   writingTemperature: 1,
   models: [
   models: [
+    // --- Qwen3.6 系列(2026-04 发布) ---
+    { id: "qwen3.6-max-preview", maxOutput: 65536, contextWindowTokens: 262144, enabled: true, releasedAt: "2026-04-21" },
+    { id: "qwen3.6-plus", maxOutput: 65536, contextWindowTokens: 1000000, enabled: true, releasedAt: "2026-04-09" },
+    { id: "qwen3.6-flash", maxOutput: 65536, contextWindowTokens: 1000000, enabled: true, releasedAt: "2026-04-17" },
+    { id: "qwen3.6-27b", maxOutput: 65536, contextWindowTokens: 262144, releasedAt: "2026-04-23" },
+    { id: "qwen3.6-35b-a3b", maxOutput: 65536, contextWindowTokens: 262144, releasedAt: "2026-04-17" },
+    // --- 第三方代理 ---
+    { id: "kimi-k2.6", maxOutput: 32768, contextWindowTokens: 262144, enabled: true, releasedAt: "2026-04-21" },
     { id: "kimi-k2.5", maxOutput: 32768, contextWindowTokens: 262144 },
     { id: "kimi-k2.5", maxOutput: 32768, contextWindowTokens: 262144 },
+    { id: "glm-5.1", maxOutput: 16384, contextWindowTokens: 202752, enabled: true, releasedAt: "2026-04-23" },
     { id: "MiniMax-M2.5", maxOutput: 32768, contextWindowTokens: 196608 },
     { id: "MiniMax-M2.5", maxOutput: 32768, contextWindowTokens: 196608 },
     { id: "MiniMax-M2.1", maxOutput: 32768, contextWindowTokens: 204800 },
     { id: "MiniMax-M2.1", maxOutput: 32768, contextWindowTokens: 204800 },
     { id: "qwen3-vl-plus", maxOutput: 32768, contextWindowTokens: 262144, releasedAt: "2025-09-23" },
     { id: "qwen3-vl-plus", maxOutput: 32768, contextWindowTokens: 262144, releasedAt: "2025-09-23" },

+ 7 - 0
packages/core/src/llm/providers/endpoints/sensenova.ts

@@ -1,3 +1,10 @@
+/**
+ * 商汤日日新 (SenseNova)
+ *
+ * - 官网:https://platform.sensenova.cn/
+ * - 控制台 / API key:https://console.sensecore.cn/aistudio/management/access-key
+ * - API 文档:https://platform.sensenova.cn/doc
+ */
 import type { InkosEndpoint } from "../types.js";
 import type { InkosEndpoint } from "../types.js";
 
 
 export const SENSENOVA: InkosEndpoint = {
 export const SENSENOVA: InkosEndpoint = {

+ 18 - 0
packages/core/src/llm/providers/endpoints/siliconcloud.ts

@@ -1,3 +1,14 @@
+/**
+ * 硅基流动 (SiliconCloud / SiliconFlow)
+ *
+ * - 官网:https://www.siliconflow.com/
+ * - 控制台 / API key:https://cloud.siliconflow.cn/account/ak
+ * - 模型广场:https://cloud.siliconflow.cn/models
+ * - API 文档:https://docs.siliconflow.cn/
+ *
+ * 聚合平台,代理 Qwen / DeepSeek / GLM / Kimi / 百川 / 昆仑万维等多家开源 + 托管模型,
+ * 新模型上架频繁,bank 只维护文本 chat 主流,元数据以 live /models probe 为准。
+ */
 import type { InkosEndpoint } from "../types.js";
 import type { InkosEndpoint } from "../types.js";
 
 
 export const SILICONCLOUD: InkosEndpoint = {
 export const SILICONCLOUD: InkosEndpoint = {
@@ -10,6 +21,13 @@ export const SILICONCLOUD: InkosEndpoint = {
   defaultTemperature: 0.7,
   defaultTemperature: 0.7,
   writingTemperature: 1,
   writingTemperature: 1,
   models: [
   models: [
+    // --- 2026-04 新上 ---
+    { id: "Pro/moonshotai/Kimi-K2.6", maxOutput: 4096, contextWindowTokens: 262144, enabled: true, releasedAt: "2026-04-21" },
+    { id: "Pro/zai-org/GLM-5", maxOutput: 4096, contextWindowTokens: 198000 },
+    { id: "Pro/zai-org/GLM-4.7", maxOutput: 4096, contextWindowTokens: 200000 },
+    { id: "Qwen/Qwen3.6-35B-A3B", maxOutput: 4096, contextWindowTokens: 262144, enabled: true, releasedAt: "2026-04-17" },
+    { id: "Qwen/Qwen3.6-27B", maxOutput: 4096, contextWindowTokens: 262144, enabled: true, releasedAt: "2026-04-23" },
+    // ---
     { id: "Qwen/Qwen3.5-397B-A17B", maxOutput: 4096, contextWindowTokens: 262144, releasedAt: "2026-02-16" },
     { id: "Qwen/Qwen3.5-397B-A17B", maxOutput: 4096, contextWindowTokens: 262144, releasedAt: "2026-02-16" },
     { id: "Qwen/Qwen3.5-122B-A10B", maxOutput: 4096, contextWindowTokens: 262144, releasedAt: "2026-02-26" },
     { id: "Qwen/Qwen3.5-122B-A10B", maxOutput: 4096, contextWindowTokens: 262144, releasedAt: "2026-02-26" },
     { id: "Qwen/Qwen3.5-35B-A3B", maxOutput: 4096, contextWindowTokens: 262144, releasedAt: "2026-02-25" },
     { id: "Qwen/Qwen3.5-35B-A3B", maxOutput: 4096, contextWindowTokens: 262144, releasedAt: "2026-02-25" },

+ 7 - 0
packages/core/src/llm/providers/endpoints/spark.ts

@@ -1,3 +1,10 @@
+/**
+ * 讯飞星火 (Spark)
+ *
+ * - 官网:https://xinghuo.xfyun.cn/
+ * - 控制台 / API key:https://console.xfyun.cn/services/cbm
+ * - API 文档:https://www.xfyun.cn/doc/spark/Web.html
+ */
 import type { InkosEndpoint } from "../types.js";
 import type { InkosEndpoint } from "../types.js";
 
 
 export const SPARK: InkosEndpoint = {
 export const SPARK: InkosEndpoint = {

+ 7 - 0
packages/core/src/llm/providers/endpoints/stepfun.ts

@@ -1,3 +1,10 @@
+/**
+ * 阶跃星辰 (StepFun)
+ *
+ * - 官网:https://www.stepfun.com/
+ * - 控制台 / API key:https://platform.stepfun.com/interface-key
+ * - API 文档:https://platform.stepfun.com/docs/overview/concept
+ */
 import type { InkosEndpoint } from "../types.js";
 import type { InkosEndpoint } from "../types.js";
 
 
 export const STEPFUN: InkosEndpoint = {
 export const STEPFUN: InkosEndpoint = {

+ 7 - 0
packages/core/src/llm/providers/endpoints/tencentcloud.ts

@@ -1,3 +1,10 @@
+/**
+ * 腾讯云 TI-ONE / LKE
+ *
+ * - 官网:https://cloud.tencent.com/product/lkeap
+ * - 控制台 / API key:https://console.cloud.tencent.com/lkeap/api
+ * - API 文档:https://cloud.tencent.com/document/product/1772
+ */
 import type { InkosEndpoint } from "../types.js";
 import type { InkosEndpoint } from "../types.js";
 
 
 export const TENCENTCLOUD: InkosEndpoint = {
 export const TENCENTCLOUD: InkosEndpoint = {

+ 7 - 0
packages/core/src/llm/providers/endpoints/volcengine.ts

@@ -1,3 +1,10 @@
+/**
+ * 火山方舟 (Volcengine Ark / Doubao)
+ *
+ * - 官网:https://www.volcengine.com/product/ark
+ * - 控制台 / API key:https://console.volcengine.com/ark/region:ark+cn-beijing/apiKey
+ * - API 文档:https://www.volcengine.com/docs/82379
+ */
 import type { InkosEndpoint } from "../types.js";
 import type { InkosEndpoint } from "../types.js";
 
 
 export const VOLCENGINE: InkosEndpoint = {
 export const VOLCENGINE: InkosEndpoint = {

+ 6 - 0
packages/core/src/llm/providers/endpoints/volcengineCodingPlan.ts

@@ -1,3 +1,9 @@
+/**
+ * 火山 CodingPlan (豆包 coding)
+ *
+ * - 官网:https://www.volcengine.com/product/ark
+ * - 火山方舟针对编程场景的 Doubao 模型套餐。
+ */
 import type { InkosEndpoint } from "../types.js";
 import type { InkosEndpoint } from "../types.js";
 
 
 export const VOLCENGINE_CODING_PLAN: InkosEndpoint = {
 export const VOLCENGINE_CODING_PLAN: InkosEndpoint = {

+ 7 - 0
packages/core/src/llm/providers/endpoints/wenxin.ts

@@ -1,3 +1,10 @@
+/**
+ * 百度文心 (ERNIE)
+ *
+ * - 官网:https://cloud.baidu.com/product/wenxinworkshop
+ * - 控制台 / API key:https://console.bce.baidu.com/qianfan/ais/console/applicationConsole/application/v2
+ * - API 文档:https://cloud.baidu.com/doc/WENXINWORKSHOP/index.html
+ */
 import type { InkosEndpoint } from "../types.js";
 import type { InkosEndpoint } from "../types.js";
 
 
 export const WENXIN: InkosEndpoint = {
 export const WENXIN: InkosEndpoint = {

+ 8 - 0
packages/core/src/llm/providers/endpoints/xai.ts

@@ -1,3 +1,11 @@
+/**
+ * xAI (Grok)
+ *
+ * - 官网:https://x.ai/
+ * - 控制台 / API key:https://console.x.ai/
+ * - API 文档:https://docs.x.ai/docs/overview
+ * - 模型列表:https://docs.x.ai/docs/models
+ */
 import type { InkosEndpoint } from "../types.js";
 import type { InkosEndpoint } from "../types.js";
 
 
 export const XAI: InkosEndpoint = {
 export const XAI: InkosEndpoint = {

+ 6 - 0
packages/core/src/llm/providers/endpoints/xiaomimimo.ts

@@ -1,3 +1,9 @@
+/**
+ * 小米 MiMo
+ *
+ * - MiMo 是小米自研模型系列,目前在 PPIO / 百炼等平台开放,小米官方暂无独立 API。
+ * - 模型卡 (HF):https://huggingface.co/XiaomiMiMo
+ */
 import type { InkosEndpoint } from "../types.js";
 import type { InkosEndpoint } from "../types.js";
 
 
 export const XIAOMI_MIMO: InkosEndpoint = {
 export const XIAOMI_MIMO: InkosEndpoint = {

+ 7 - 0
packages/core/src/llm/providers/endpoints/zeroone.ts

@@ -1,3 +1,10 @@
+/**
+ * 零一万物 (01.AI / Yi)
+ *
+ * - 官网:https://www.lingyiwanwu.com/
+ * - 控制台 / API key:https://platform.lingyiwanwu.com/apikeys
+ * - API 文档:https://platform.lingyiwanwu.com/docs
+ */
 import type { InkosEndpoint } from "../types.js";
 import type { InkosEndpoint } from "../types.js";
 
 
 export const ZEROONE: InkosEndpoint = {
 export const ZEROONE: InkosEndpoint = {

+ 9 - 0
packages/core/src/llm/providers/endpoints/zhipu.ts

@@ -1,3 +1,12 @@
+/**
+ * 智谱 GLM (Zhipu AI)
+ *
+ * - 官网:https://www.bigmodel.cn/
+ * - 控制台:https://open.bigmodel.cn/
+ * - API key:https://open.bigmodel.cn/usercenter/proj-mgmt/apikeys
+ * - API 文档:https://docs.bigmodel.cn/cn/api/normal-model/glm-4
+ * - 模型列表:https://open.bigmodel.cn/dev/howuse/model
+ */
 import type { InkosEndpoint } from "../types.js";
 import type { InkosEndpoint } from "../types.js";
 
 
 export const ZHIPU: InkosEndpoint = {
 export const ZHIPU: InkosEndpoint = {