dsh-link-pulse 0.1.5 → 0.1.8

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## [0.1.8] - 2026-08-30
+
+### Fixed
+- **官方 DeepSeek V4 供应商误显为 CPA**：DSH 内置官方路由的运行时 provider id 为 `deepseek-official`（`dsh-llm-deepseek` 中 `PROVIDER` 常量），而插件兜底官方节点注册的 id 是 `deepseek`，导致客户端按当前会话 provider 查找落空后错误兜底到 provider 列表第一项（CPA）。兜底节点 id 修正为 `deepseek-official`，并同步注册 `KNOWN_PROVIDER_DEFAULTS` 映射。
+- **未识别 Provider 张冠李戴**：客户端在 providerMap 查找失败时不再冒名显示列表第一个供应商的名称与延迟，改为展示该 provider 的真实 id（大写），延迟显示为探测中。
+
+## [0.1.7] - 2026-08-29
+
+### Fixed & Refactored
+- **权威状态订阅重构**：彻底移除客户端定时器轮询与 DOM 抓取，接入 DSH 原生 `sessions` 与 `modelDirectories` 服务，实现模型切换时 0 毫秒即选即切，无需发消息触发。
+- **Provider 网关与同名模型隔离**：将各 Provider 独立隔离（官方 `deepseek` 对应 `https://api.deepseek.com`，`opencode-go` 对应 `https://opencode.ai`），解决 DeepSeek V4 系列在官方与 OpenCode GO 之间的命名空间冲突与错误归属问题。
+
+
+## [0.1.6] - 2026-08-25
+
+### Docs
+- 补充 README 中的 Keep-Alive 纯 1-RTT 测速原理与冷握手 vs 热长连接对比说明表。
+
 ## [0.1.5] - 2026-08-25
 
 ### Changed

package/README.md

@@ -7,11 +7,24 @@
 
 ## 核心特性
 
+- **Keep-Alive 纯 1-RTT 真实测速**：在底层 TLS 加密管道就绪后测量纯 HTTP 数据往返耗时，真实反映长连接日常对话下的网络脉搏。
 - **100% 动态 Provider 发现**：自动从 `~/.dsh/settings.yaml` 读取已配置的所有模型网关（CPA、OpenCode GO、DeepSeek 官方直连等），绝不硬编码。
-- **当前对话模型感知**：侧边栏常驻条目根据当前聊天选中的模型，动态显示对应供应商名称与实时延迟（如 `● CPA · Gemini 3.7  78ms`）。
-- **原生样式像素级对齐**：状态圆点尺寸（`7px`）、呼吸光环与色彩变量严格对齐 `dsh-cpa-status` 与 `dsh-opencode-status`。
-- **零 Token 消耗**：轻量级 TCP/TLS RTT 网络心跳探针，绝不消耗任何 API 配额。
-- **多通道看板**：点击侧边栏条目即可呼出全局浮层面板，查看所有已接入 Provider 的实时测速对比并支持一键手动测速。
+- **当前对话模型感知**：侧边栏常驻条目根据当前聊天选中的模型，动态显示对应供应商名称与实时延迟（如 `● CPA · Gemini 3.7 · 126ms`）。
+- **原生样式像素级对齐**：紧凑点号分段排版，状态圆点尺寸（`7px`）、呼吸光环与色彩变量严格对齐 `dsh-cpa-status` 与 `dsh-opencode-status`。
+- **悬停快速预览与去重对比**：鼠标悬停 220ms 弹出微型预览卡片；全屏看板与小卡片均在顶部重点呈现当前主力通道，下方列表聚焦对比「其它可用 Provider」测速。
+- **零 Token 消耗**：轻量级网络心跳探针，绝不消耗任何 API 配额。
+
+## 延迟测量原理（Keep-Alive 纯 1-RTT 测速）
+
+在 AI 流式交互与对话场景中，客户端与上游网关之间常驻 **HTTP/2 长连接（Keep-Alive 复用）**。
+
+| 测量维度 | 传统冷握手测速 (Cold Handshake) | LinkPulse Keep-Alive 纯 RTT 探针 (Warm) |
+| :--- | :--- | :--- |
+| **涵盖流程** | TCP 握手 + TLS 1.3 握手 + 数据传输 (累加 3~4 次往返) | **仅测量已就绪加密通道上的数据往返 (1 次 RTT)** |
+| **跨国节点耗时** | 约 $400\sim 550\text{ ms}$ (受多次物理往返累加影响) | **约 $120\sim 140\text{ ms}$ (直达物理光速极限)** |
+| **实际映射意义** | 仅代表首次冷启动建连耗时 | **精准反映每次发送 Prompt 到接收流式 Token 首包的真实物理网络时延** |
+
+探针在建立底层 TLS 安全通道后，直接发送轻量 `HEAD` 探针并测算首字节往返时间，避免了将冷建连多次握手耗时误判为网络卡顿。
 
 ## 安装与更新
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-link-pulse",
-  "version": "0.1.5",
+  "version": "0.1.8",
   "description": "Dynamic LLM provider gateway latency and health pulse probe for DeepSeek Harness",
   "type": "module",
   "license": "Apache-2.0",

package/src/client.js

@@ -7,6 +7,8 @@ window.__ModuleLoader__.load({
     const h = React.createElement
     const { useEffect, useState, useCallback, useMemo } = React
 
+    let globalCtx = null
+
     const T = {
       bg: 'var(--dsw-alias-bg-layer-2, #ffffff)',
       layer: 'var(--dsw-alias-bg-layer-2, #ffffff)',
@@ -62,7 +64,7 @@ window.__ModuleLoader__.load({
       whiteSpace: 'nowrap',
     }
 
-    // ---------- 全局单例共享状态（确保内外完全同源同步） ----------
+    // ---------- 全局单例共享状态（网络延迟数据） ----------
     const store = {
       state: {
         data: null,
@@ -128,37 +130,65 @@ window.__ModuleLoader__.load({
       return modelId.split(/[-_]/)[0] || modelId
     }
 
-    function useActiveModel(defaultModel) {
-      const [activeModel, setActiveModel] = useState(defaultModel || 'gemini-3.7-flash-high')
+    /**
+     * 权威实时抓取：直接从 DSH 官方 sessions 与 modelDirectories 服务订阅当前正在对话的模型与供应商
+     */
+    function useCurrentActiveModel(defaultConfig) {
+      const [selection, setSelection] = useState(() => ({
+        provider: defaultConfig?.provider || 'cpa',
+        model: defaultConfig?.model || 'gemini-3.7-flash-high',
+      }))
 
       useEffect(() => {
-        const detectModel = () => {
+        if (!globalCtx) return
+
+        const getSessions = () => (globalCtx.get ? globalCtx.get('sessions') : globalCtx.sessions)
+        const getModelDirs = () => (globalCtx.get ? globalCtx.get('modelDirectories') : globalCtx.modelDirectories)
+
+        let dirUnsub = null
+
+        const sync = () => {
           try {
-            const modelButton = document.querySelector(
-              '[data-slot="conversation.input.model"], button[class*="modelSelect"], div[class*="modelSelector"]',
-            )
-            if (modelButton && modelButton.textContent) {
-              let text = modelButton.textContent.trim()
-              // 剥离「default」「推理等级」「模型」等 UI 标签
-              text = text
-                .split(/[\n|·•]/)[0]
-                .replace(/\s*(default|推理等级|模型|model)\s*/gi, '')
-                .trim()
-              if (text && text.length < 30 && /[a-zA-Z0-9\-_.]/.test(text)) {
-                setActiveModel(text)
-                return
+            const sessions = getSessions()
+            const modelDirs = getModelDirs()
+            if (!sessions || !modelDirs) return
+
+            const curSessionId = sessions.list?.getSnapshot?.()?.current
+            if (!curSessionId) return
+
+            const dir = modelDirs.directoryFor?.(curSessionId)
+            if (!dir) return
+
+            if (dirUnsub) dirUnsub()
+            dirUnsub = dir.store?.subscribe ? dir.store.subscribe(applyDirectorySnapshot) : null
+
+            function applyDirectorySnapshot() {
+              const snap = dir.store?.getSnapshot?.()
+              if (snap?.current?.provider && snap?.current?.model) {
+                setSelection({
+                  provider: snap.current.provider,
+                  model: snap.current.model,
+                  reasoningEffort: snap.current.reasoningEffort,
+                })
               }
             }
+
+            applyDirectorySnapshot()
           } catch {}
-          if (defaultModel) setActiveModel(defaultModel)
         }
 
-        detectModel()
-        const timer = setInterval(detectModel, 3000)
-        return () => clearInterval(timer)
-      }, [defaultModel])
+        sync()
+
+        const sessions = getSessions()
+        const unsubSessions = sessions?.list?.subscribe ? sessions.list.subscribe(sync) : null
 
-      return activeModel
+        return () => {
+          if (unsubSessions) unsubSessions()
+          if (dirUnsub) dirUnsub()
+        }
+      }, [defaultConfig])
+
+      return selection
     }
 
     function FooterEntry(props) {
@@ -174,21 +204,28 @@ window.__ModuleLoader__.load({
       }, [])
 
       const data = state.data
-      const defaultModel = data?.defaultModelConfig?.model || 'gemini-3.7-flash-high'
-      const activeModel = useActiveModel(defaultModel)
+      const defaultModelConfig = data?.defaultModelConfig
+      const activeSelection = useCurrentActiveModel(defaultModelConfig)
 
       const activeProviderInfo = useMemo(() => {
-        if (!data || !data.providers) return null
-        const map = data.modelToProviderMap || {}
-        const pId = map[activeModel.toLowerCase()] || data.defaultModelConfig?.provider || 'cpa'
-        return data.providers.find((p) => p.id === pId) || data.providers[0] || null
-      }, [data, activeModel])
+        if (!data) return null
+        const pId = activeSelection.provider || data.defaultModelConfig?.provider || 'cpa'
+        if (data.providerMap && data.providerMap[pId]) {
+          return data.providerMap[pId]
+        }
+        if (data.providers) {
+          const found = data.providers.find((p) => p.id === pId)
+          if (found) return found
+        }
+        // 未识别的 provider：展示其真实 id，绝不冒名顶替列表中的第一个供应商
+        return { id: pId, name: String(pId).toUpperCase(), baseURL: '', probe: null }
+      }, [data, activeSelection.provider])
 
       const currentLatency = activeProviderInfo?.probe?.latencyMs ?? -1
       const currentQuality = activeProviderInfo?.probe?.quality || 'offline'
       const statusColor = getQualityColor(currentQuality, currentLatency)
-      const providerDisplayName = activeProviderInfo?.name || 'CPA'
-      const modelShortName = formatModelShortName(activeModel)
+      const providerDisplayName = activeProviderInfo?.name || activeSelection.provider.toUpperCase()
+      const modelShortName = formatModelShortName(activeSelection.model)
 
       const onMouseEnter = useCallback(() => {
         clearTimeout(hoverTimerRef.current)
@@ -297,7 +334,7 @@ window.__ModuleLoader__.load({
               fontFamily: 'system-ui, -apple-system, sans-serif',
             },
           },
-          h('div', { style: { fontWeight: 600, fontSize: '12px', marginBottom: 4 } }, `🎯 ${activeModel}`),
+          h('div', { style: { fontWeight: 600, fontSize: '12px', marginBottom: 4 } }, `🎯 ${activeSelection.model}`),
           h('div', { style: { color: T.secondary } }, `🏢 ${providerDisplayName}`),
           h(
             'div',
@@ -368,15 +405,22 @@ window.__ModuleLoader__.load({
       const data = state.data
       const loading = state.loading
 
-      const defaultModel = data?.defaultModelConfig?.model || 'gemini-3.7-flash-high'
-      const activeModel = useActiveModel(defaultModel)
+      const defaultModelConfig = data?.defaultModelConfig
+      const activeSelection = useCurrentActiveModel(defaultModelConfig)
 
       const activeProviderInfo = useMemo(() => {
-        if (!data || !data.providers) return null
-        const map = data.modelToProviderMap || {}
-        const pId = map[activeModel.toLowerCase()] || data.defaultModelConfig?.provider || 'cpa'
-        return data.providers.find((p) => p.id === pId) || data.providers[0] || null
-      }, [data, activeModel])
+        if (!data) return null
+        const pId = activeSelection.provider || data.defaultModelConfig?.provider || 'cpa'
+        if (data.providerMap && data.providerMap[pId]) {
+          return data.providerMap[pId]
+        }
+        if (data.providers) {
+          const found = data.providers.find((p) => p.id === pId)
+          if (found) return found
+        }
+        // 未识别的 provider：展示其真实 id，绝不冒名顶替列表中的第一个供应商
+        return { id: pId, name: String(pId).toUpperCase(), baseURL: '', probe: null }
+      }, [data, activeSelection.provider])
 
       if (!isOpen) return null
 
@@ -385,6 +429,7 @@ window.__ModuleLoader__.load({
       const currentQuality = activeProviderInfo?.probe?.quality || 'offline'
       const statusColor = getQualityColor(currentQuality, currentLatency)
       const otherProviders = providers.filter((p) => p.id !== activeProviderInfo?.id)
+      const providerDisplayName = activeProviderInfo?.name || activeSelection.provider.toUpperCase()
 
       return h(
         'div',
@@ -441,7 +486,7 @@ window.__ModuleLoader__.load({
                 h(
                   'div',
                   { style: { fontSize: '11px', color: T.secondary } },
-                  '仅探测本机实际接入的 LLM Provider 网关',
+                  '实时订阅当前对话供应商与模型状态',
                 ),
               ),
             ),
@@ -523,7 +568,7 @@ window.__ModuleLoader__.load({
                   'div',
                   { style: { display: 'flex', alignItems: 'center', gap: '8px' } },
                   h('span', { style: dotStyle(statusColor) }),
-                  h('span', { style: { fontWeight: 600, fontSize: '14px' } }, activeModel),
+                  h('span', { style: { fontWeight: 600, fontSize: '14px' } }, activeSelection.model),
                   h(
                     'span',
                     {
@@ -536,7 +581,7 @@ window.__ModuleLoader__.load({
                         fontWeight: 600,
                       },
                     },
-                    `供应商: ${activeProviderInfo?.name || 'CPA'}`,
+                    `供应商: ${providerDisplayName}`,
                   ),
                 ),
                 h(
@@ -657,6 +702,8 @@ window.__ModuleLoader__.load({
     }
 
     function apply(ctx) {
+      globalCtx = ctx
+
       ctx.effect(() => {
         const el = document.createElement('style')
         el.id = 'dsh-link-pulse-styles'

package/src/index.js

@@ -8,6 +8,37 @@ import jsYaml from 'js-yaml'
 export const name = 'link-pulse'
 export const inject = ['webServer']
 
+const KNOWN_PROVIDER_DEFAULTS = {
+  deepseek: {
+    name: 'DeepSeek 官方',
+    baseURL: 'https://api.deepseek.com',
+  },
+  'deepseek-official': {
+    name: 'DeepSeek 官方',
+    baseURL: 'https://api.deepseek.com',
+  },
+  'opencode-go': {
+    name: 'OpenCode GO',
+    baseURL: 'https://opencode.ai',
+  },
+  openai: {
+    name: 'OpenAI 官方',
+    baseURL: 'https://api.openai.com',
+  },
+  anthropic: {
+    name: 'Anthropic 官方',
+    baseURL: 'https://api.anthropic.com',
+  },
+  google: {
+    name: 'Google Gemini',
+    baseURL: 'https://generativelanguage.googleapis.com',
+  },
+  openrouter: {
+    name: 'OpenRouter',
+    baseURL: 'https://openrouter.ai',
+  },
+}
+
 function getSettingsPath() {
   const dshHome = process.env.DSH_HOME || path.join(os.homedir(), '.dsh')
   return path.join(dshHome, 'settings.yaml')
@@ -30,52 +61,47 @@ export function loadDynamicProviders() {
   }
 
   const providers = []
-  const modelToProviderMap = {}
+  const providerMap = {}
 
   for (const [providerId, pConfig] of Object.entries(providersConfig)) {
     const rawModels = pConfig.models || []
     const modelList = rawModels.map((m) => (typeof m === 'string' ? m : m.id || m.name)).filter(Boolean)
     
-    for (const m of modelList) {
-      modelToProviderMap[m.toLowerCase()] = providerId
-    }
+    const known = KNOWN_PROVIDER_DEFAULTS[providerId] || {}
+    const targetBaseUrl = pConfig.baseURL || known.baseURL || ''
+    const displayName = pConfig.name || known.name || providerId.toUpperCase()
 
-    let targetBaseUrl = pConfig.baseURL || ''
-    if (!targetBaseUrl && providerId === 'opencode-go') {
-      targetBaseUrl = 'https://api.deepseek.com'
-    }
-
-    providers.push({
+    const item = {
       id: providerId,
-      name: providerId.toUpperCase(),
+      name: displayName,
       baseURL: targetBaseUrl,
       api: pConfig.api || 'openai-responses',
       models: modelList,
       isDefault: defaultModelConfig.provider === providerId,
-    })
+    }
+
+    providers.push(item)
+    providerMap[providerId] = item
   }
 
-  if (!providers.some((p) => p.id === 'deepseek' || p.id === 'deepseek-official')) {
-    const dsModels = ['deepseek-chat', 'deepseek-reasoner', 'deepseek-v3', 'deepseek-r1']
-    for (const m of dsModels) {
-      if (!modelToProviderMap[m]) {
-        modelToProviderMap[m] = 'deepseek'
-      }
-    }
-    providers.push({
-      id: 'deepseek',
+  // 如果未配置官方 deepseek（DSH 内置官方路由的 provider id 为 deepseek-official），补充作为独立官方探测节点
+  if (!providerMap['deepseek-official']) {
+    const dsItem = {
+      id: 'deepseek-official',
       name: 'DeepSeek 官方',
       baseURL: 'https://api.deepseek.com',
       api: 'deepseek-native',
-      models: dsModels,
-      isDefault: defaultModelConfig.provider === 'deepseek',
-    })
+      models: ['deepseek-v4-flash', 'deepseek-v4-pro'],
+      isDefault: defaultModelConfig.provider === 'deepseek-official',
+    }
+    providers.push(dsItem)
+    providerMap['deepseek-official'] = dsItem
   }
 
   return {
     providers,
+    providerMap,
     defaultModelConfig,
-    modelToProviderMap,
   }
 }
 
@@ -213,7 +239,7 @@ export function apply(ctx) {
             return sendJson(res, 200, cachedData)
           }
 
-          const { providers, defaultModelConfig, modelToProviderMap } = loadDynamicProviders()
+          const { providers, providerMap, defaultModelConfig } = loadDynamicProviders()
 
           const probePromises = providers.map(async (p) => {
             const probeResult = await probeLatency(p.baseURL)
@@ -224,11 +250,15 @@ export function apply(ctx) {
           })
 
           const probedProviders = await Promise.all(probePromises)
+          const probedMap = {}
+          for (const item of probedProviders) {
+            probedMap[item.id] = item
+          }
 
           cachedData = {
             defaultModelConfig,
-            modelToProviderMap,
             providers: probedProviders,
+            providerMap: probedMap,
             timestamp: Date.now(),
           }
           lastProbeAt = Date.now()