dsh-provider-hub 0.1.0 → 0.1.1

package/README.md

@@ -4,7 +4,7 @@
 
 为 DSH 扩大可用的服务商：**选一个服务商，粘贴 API Key，点启用**——插件把官方 `llm-pi-ai` 路由与凭据一次性写好，立即生效、无需重启、无需手改 `settings.yaml`。
 
-内置 20 家预设（OpenAI 兼容协议 + Anthropic Messages 协议），另有「自定义服务商」入口可接入任意 OpenAI 兼容端点。
+内置 23 家预设（OpenAI 兼容协议 + Anthropic Messages 协议），另有「自定义服务商」入口可接入任意 OpenAI 兼容端点；DSH 已内置的服务商默认折叠、不重复展示。
 
 ## 安装
 
@@ -42,7 +42,9 @@ dsh plugin --profile web add link:/path/to/dsh-provider-hub
 
 ## 预设清单
 
-OpenAI、OpenRouter、Anthropic、Google Gemini（OpenAI 兼容）、xAI Grok、Mistral、Groq、Together、Fireworks、DeepInfra、Novita、硅基流动、月之暗面 Kimi（国内/国际）、智谱 GLM（国内）、Z.ai GLM（国际）、MiniMax、阿里云百炼 Qwen、百度千帆、腾讯混元、火山方舟（豆包）。内置 DeepSeek 官方与 StepFun 已有官方适配器，本插件不重复提供。
+OpenAI、OpenRouter、Anthropic、Google Gemini（OpenAI 兼容）、xAI Grok、Mistral、Groq、Together、Fireworks、DeepInfra、Novita、硅基流动、月之暗面 Kimi（国内/国际）、智谱 GLM（国内）、Z.ai GLM（国际）、MiniMax、阿里云百炼 Qwen、百度千帆、腾讯混元、火山方舟（豆包）、**StepFun Step Plan（国内/国际）**。
+
+关于内置：DSH 自带 DeepSeek 官方适配器（`llm-deepseek`），其目录里的 `stepfun` 指向普通付费端点 `api.stepfun.com/v1`——**Step Plan 订阅端点（`step_plan/v1`）没有内置条目，因此本插件提供该预设**；其余与本插件重合的服务商（openai、openrouter 等 13 个）由 DSH 原生目录覆盖，默认折叠在「显示 DSH 已内置」开关后。已配置过的 Key（包括来自环境变量的）会被识别，留空输入框即可直接启用。
 
 ## 注意
 
@@ -56,7 +58,7 @@ OpenAI、OpenRouter、Anthropic、Google Gemini（OpenAI 兼容）、xAI Grok、
 
 Expand the providers DSH can use: **pick a provider, paste the API key, press Enable**. The plugin writes the official `llm-pi-ai` route and its credential in one step - effective immediately, no restart, no hand-editing `settings.yaml`.
 
-20 built-in presets (OpenAI-compatible and Anthropic Messages protocols) plus a custom-endpoint form for any OpenAI-compatible gateway.
+23 built-in presets (OpenAI-compatible and Anthropic Messages protocols) plus a custom-endpoint form for any OpenAI-compatible gateway. Presets your target app already ships natively are collapsed by default, never deleted.
 
 ### Install
 

package/core/providers.js

@@ -325,6 +325,39 @@ export const PRESETS = [
       { id: 'doubao-seed-1-6-thinking-250715', name: '豆包 Seed 1.6 Thinking', contextWindow: 262144, maxTokens: 32768, input: textImage },
     ],
   },
+  {
+    // DSH's built-in catalog ships `stepfun` pointed at the pay-as-you-go
+    // endpoint (api.stepfun.com/v1); Step Plan subscribers need the step_plan
+    // route instead, which no native entry provides.
+    id: 'stepfun-step-plan',
+    name: 'StepFun Step Plan（国内）',
+    docs: 'https://platform.stepfun.com/docs/zh/step-plan/quick-start',
+    keyUrl: 'https://platform.stepfun.com/account-overview',
+    env: 'STEPFUN_API_KEY',
+    baseURL: 'https://api.stepfun.com/step_plan/v1',
+    api: 'openai-completions',
+    models: [
+      { id: 'step-5-preview', name: 'Step 5 Preview', contextWindow: 1024000, maxTokens: 65536, input: textImage, reasoningEfforts: LOW_MEDIUM_HIGH },
+      { id: 'step-3.7-flash', name: 'Step 3.7 Flash', contextWindow: 256000, maxTokens: 256000, input: textImage, reasoningEfforts: LOW_MEDIUM_HIGH },
+      { id: 'step-3.5-flash', name: 'Step 3.5 Flash', contextWindow: 256000, maxTokens: 256000, input: text, reasoningEfforts: LOW_MEDIUM_HIGH },
+      { id: 'step-3.5-flash-2603', name: 'Step 3.5 Flash 2603', contextWindow: 256000, maxTokens: 256000, input: text, reasoningEfforts: LOW_MEDIUM_HIGH },
+    ],
+  },
+  {
+    id: 'stepfun-step-plan-global',
+    name: 'StepFun Step Plan（国际）',
+    docs: 'https://platform.stepfun.ai/docs/en/step-plan/quick-start',
+    keyUrl: 'https://platform.stepfun.ai/account-overview',
+    env: 'STEPFUN_GLOBAL_API_KEY',
+    baseURL: 'https://api.stepfun.ai/step_plan/v1',
+    api: 'openai-completions',
+    models: [
+      { id: 'step-5-preview', name: 'Step 5 Preview', contextWindow: 1024000, maxTokens: 65536, input: textImage, reasoningEfforts: LOW_MEDIUM_HIGH },
+      { id: 'step-3.7-flash', name: 'Step 3.7 Flash', contextWindow: 256000, maxTokens: 256000, input: textImage, reasoningEfforts: LOW_MEDIUM_HIGH },
+      { id: 'step-3.5-flash', name: 'Step 3.5 Flash', contextWindow: 256000, maxTokens: 256000, input: text, reasoningEfforts: LOW_MEDIUM_HIGH },
+      { id: 'step-3.5-flash-2603', name: 'Step 3.5 Flash 2603', contextWindow: 256000, maxTokens: 256000, input: text, reasoningEfforts: LOW_MEDIUM_HIGH },
+    ],
+  },
 ]
 
 /** Look one preset up by id. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-provider-hub",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "只填 Key 的服务商预设：为 DSH 一键写入官方 llm-pi-ai 路由与凭据，内置 20 家 OpenAI 兼容 / Anthropic Messages 预设与自定义端点。核心为纯 JS，可被桌面端等其它外壳复用。",
   "type": "module",
   "main": "src/index.js",

package/src/client.js

@@ -51,7 +51,8 @@ window.__ModuleLoader__.load({
       'status.stored': '已写入',
       'status.noKey': '缺 Key',
       'key.placeholder': '粘贴 {env}',
-      'key.savedHint': '凭据服务里已有 Key；留空则保留现有 Key。',
+      'key.savedHint': '凭据里已有 Key',
+      'key.placeholderKeep': '留空则用已有 Key',
       'action.enable': '启用',
       'action.remove': '移除',
       'remove.confirm': '移除 {route}？已保存的 Key 会保留在凭据服务里。',
@@ -84,7 +85,8 @@ window.__ModuleLoader__.load({
       'status.stored': 'written',
       'status.noKey': 'no key',
       'key.placeholder': 'Paste {env}',
-      'key.savedHint': 'A key already exists; leave empty to keep it.',
+      'key.savedHint': 'key already stored',
+      'key.placeholderKeep': 'Leave empty for the stored key',
       'action.enable': 'Enable',
       'action.remove': 'Remove',
       'remove.confirm': 'Remove {route}? The stored key stays in the credentials service.',
@@ -185,7 +187,7 @@ window.__ModuleLoader__.load({
 
       const enablePreset = async (preset) => {
         const key = String(keys[preset.id] || '').trim()
-        if (key === '') {
+        if (key === '' && preset.envConfigured !== true) {
           setError(tr('error.keyRequired'))
           return
         }
@@ -284,7 +286,7 @@ window.__ModuleLoader__.load({
               ' ',
               h('a', { style: S.link, href: preset.keyUrl, target: '_blank', rel: 'noreferrer' }, `[${tr('getKey')}]`),
             ),
-            h('span', { style: S.sub }, `${preset.env} · ${tr('models.count', { n: preset.models.length })} · ${preset.models.join(', ')}`),
+            h('span', { style: S.sub }, `${preset.env} · ${tr('models.count', { n: preset.models.length })} · ${preset.models.join(', ')}${preset.envConfigured === true ? ' · ' + tr('key.savedHint') : ''}`),
           ),
           preset.configured ? statusBadge(preset.id) : null,
           preset.configured
@@ -293,7 +295,7 @@ window.__ModuleLoader__.load({
                 style: S.input,
                 type: 'password',
                 autoComplete: 'off',
-                placeholder: tr('key.placeholder', { env: preset.env }),
+                placeholder: preset.envConfigured === true ? tr('key.placeholderKeep') : tr('key.placeholder', { env: preset.env }),
                 value: keys[preset.id] || '',
                 onChange: (event) => setKeys((current) => ({ ...current, [preset.id]: event.target.value })),
               }),

package/src/index.js

@@ -148,6 +148,24 @@ async function stateOf(ctx) {
   const coverage = coverageOf(PRESETS, nativeIds)
   const coveredBy = new Map(coverage.covered.map((entry) => [entry.id, entry.as]))
 
+  // One credential probe per referenced env; presets whose ref is already
+  // configured elsewhere (process env, credentials service, another route)
+  // can be enabled without pasting the key again.
+  const credentialConfigured = new Map()
+  if (credentials) {
+    const refs = new Set(PRESETS.map((preset) => preset.env))
+    for (const profile of Object.values(providers)) {
+      if (typeof profile?.apiKeyEnv === 'string') refs.add(profile.apiKeyEnv)
+    }
+    for (const ref of refs) {
+      try {
+        credentialConfigured.set(ref, (await credentials.describe(ref))?.configured === true)
+      } catch {
+        credentialConfigured.set(ref, false)
+      }
+    }
+  }
+
   const routes = {}
   for (const [route, profile] of Object.entries(providers)) {
     const env = profile && typeof profile.apiKeyEnv === 'string' ? profile.apiKeyEnv : undefined
@@ -187,6 +205,7 @@ async function stateOf(ctx) {
       models: preset.models.map((model) => model.id),
       configured: Object.hasOwn(providers, preset.id),
       keyConfigured: routes[preset.id]?.keyConfigured === true,
+      envConfigured: credentialConfigured.get(preset.env) === true,
       live: live.has(preset.id),
       covered: coveredBy.has(preset.id),
       coveredBy: coveredBy.get(preset.id),
@@ -200,7 +219,6 @@ async function enable(ctx, body) {
   const { settings, credentials } = services(ctx)
   if (!settings || !credentials) throw new HttpError(503, 'service-missing', 'DSH 设置或凭据服务不可用')
   const key = typeof body.key === 'string' ? body.key.trim() : ''
-  if (key === '') throw new HttpError(400, 'key-required', '请填写 API Key')
   let route
   let profile
   try {
@@ -212,7 +230,25 @@ async function enable(ctx, body) {
   const descriptor = piAiDescriptor(settings)
   if (!descriptor) throw new HttpError(503, 'namespace-missing', 'llm-pi-ai 设置命名空间未注册')
 
-  await credentials.set(profile.apiKeyEnv, key)
+  if (key === '') {
+    // An empty key is allowed when the referenced credential already resolves
+    // (process env, credentials service, another route): the profile then just
+    // references the existing ref.
+    const existing = await credentials.describe(profile.apiKeyEnv).catch(() => undefined)
+    if (existing?.configured !== true) {
+      throw new HttpError(400, 'key-required', `请填写 API Key（${profile.apiKeyEnv} 尚未配置）`)
+    }
+  } else {
+    try {
+      await credentials.set(profile.apiKeyEnv, key)
+    } catch (error) {
+      throw new HttpError(
+        409,
+        'credential-not-writable',
+        `无法写入凭据 ${profile.apiKeyEnv}：${String((error && error.message) || error)}。若该 Key 来自环境变量，请留空输入框、直接用已有 Key 启用。`,
+      )
+    }
+  }
   try {
     await settings.mutate(PI_AI_NS, [{ op: 'set', path: ['providers', route], value: profile }], descriptor.revision)
   } catch (error) {