dsh-link-pulse 0.1.1 → 0.1.4

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [0.1.4] - 2026-08-25
+
+### Changed
+- 升级探针算法为 Keep-Alive 纯 RTT 测量：在底层 TLS 加密隧道就绪后测量纯 HTTP 数据往返耗时（1-RTT），真实反映长连接对话场景下的网络脉搏延迟（CPA 德国直连由 ~450ms 降至真实物理往返 ~126ms）。
+
+## [0.1.3] - 2026-08-25
+
+### Fixed
+- 修复内外延迟显示不一致问题：引入全局单例状态存储与后端 25 秒探测缓存（支持 `?refresh=1` 强制刷新），确保侧栏按钮、Hover 悬浮小卡片与点击全屏大看板的延迟数据 100% 同步同源。
+
+## [0.1.2] - 2026-08-25
+
+### Changed
+- 去除 Provider 链路对比列表中的当前主力通道重复展示：当前主力已在顶部重点呈现，下方列表聚焦展示「其它可用 Provider」的测速对比（Hover 浮层与全屏看板同步生效）。
+
 ## [0.1.1] - 2026-08-25
 
 ### Fixed

package/package.json

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

package/src/client.js

@@ -62,11 +62,42 @@ window.__ModuleLoader__.load({
       whiteSpace: 'nowrap',
     }
 
-    let overlayOpen = false
-    const listeners = new Set()
-    function setOverlay(val) {
-      overlayOpen = val
-      listeners.forEach((fn) => fn(val))
+    // ---------- 全局单例共享状态（确保内外完全同源同步） ----------
+    const store = {
+      state: {
+        data: null,
+        loading: false,
+        open: false,
+      },
+      listeners: new Set(),
+      set(patch) {
+        store.state = { ...store.state, ...patch }
+        for (const fn of store.listeners) fn()
+      },
+      subscribe(fn) {
+        store.listeners.add(fn)
+        return () => store.listeners.delete(fn)
+      },
+    }
+
+    function useStore() {
+      return React.useSyncExternalStore(store.subscribe, () => store.state)
+    }
+
+    async function fetchStatus(force = false) {
+      if (store.state.loading && !force) return
+      try {
+        store.set({ loading: true })
+        const res = await fetch(`/api/link-pulse/status${force ? '?refresh=1' : ''}`)
+        if (res.ok) {
+          const json = await res.json()
+          store.set({ data: json, loading: false })
+        } else {
+          store.set({ loading: false })
+        }
+      } catch {
+        store.set({ loading: false })
+      }
     }
 
     function getQualityColor(quality, latencyMs) {
@@ -108,7 +139,7 @@ window.__ModuleLoader__.load({
             )
             if (modelButton && modelButton.textContent) {
               let text = modelButton.textContent.trim()
-              // 剥离开关/标签 UI 残留，如「default」「推理等级」「high」等
+              // 剥离「default」「推理等级」「模型」等 UI 标签
               text = text
                 .split(/[\n|·•]/)[0]
                 .replace(/\s*(default|推理等级|模型|model)\s*/gi, '')
@@ -132,36 +163,17 @@ window.__ModuleLoader__.load({
 
     function FooterEntry(props) {
       const { wide } = props
-      const [isOpen, setIsOpen] = useState(overlayOpen)
+      const state = useStore()
       const [hovering, setHovering] = useState(false)
-      const [data, setData] = useState(null)
-      const [loading, setLoading] = useState(false)
       const hoverTimerRef = React.useRef(null)
 
       useEffect(() => {
-        listeners.add(setIsOpen)
-        return () => listeners.delete(setIsOpen)
-      }, [])
-
-      const fetchData = useCallback(async () => {
-        try {
-          setLoading(true)
-          const res = await fetch('/api/link-pulse/status')
-          if (res.ok) {
-            const json = await res.json()
-            setData(json)
-          }
-        } catch {} finally {
-          setLoading(false)
-        }
-      }, [])
-
-      useEffect(() => {
-        fetchData()
-        const timer = setInterval(fetchData, 45_000)
+        fetchStatus(false)
+        const timer = setInterval(() => fetchStatus(false), 45_000)
         return () => clearInterval(timer)
-      }, [fetchData])
+      }, [])
 
+      const data = state.data
       const defaultModel = data?.defaultModelConfig?.model || 'gemini-3.7-flash-high'
       const activeModel = useActiveModel(defaultModel)
 
@@ -187,19 +199,21 @@ window.__ModuleLoader__.load({
         setHovering(false)
       }, [])
 
+      const otherProviders = (data?.providers || []).filter((p) => p.id !== activeProviderInfo?.id)
+
       const node = h(
         'button',
         {
           className: 'pulse-btn',
-          onClick: () => setOverlay(!isOpen),
+          onClick: () => store.set({ open: !state.open }),
           onMouseEnter: onMouseEnter,
           onMouseLeave: onMouseLeave,
           style: {
             ...btnBase,
             width: '100%',
             justifyContent: wide ? 'flex-start' : 'center',
-            borderColor: isOpen ? T.brand : T.border,
-            background: isOpen ? 'var(--dsw-alias-interactive-bg-hover, rgba(59,130,246,.12))' : 'transparent',
+            borderColor: state.open ? T.brand : T.border,
+            background: state.open ? 'var(--dsw-alias-interactive-bg-hover, rgba(59,130,246,.12))' : 'transparent',
           },
         },
         h('span', {
@@ -250,9 +264,8 @@ window.__ModuleLoader__.load({
           ),
       )
 
-      if (!hovering || isOpen) return node
+      if (!hovering || state.open) return node
 
-      const providers = data?.providers || []
       return h(
         'div',
         {
@@ -279,7 +292,7 @@ window.__ModuleLoader__.load({
               lineHeight: '17px',
               color: T.label,
               whiteSpace: 'pre',
-              z: 100,
+              zIndex: 100,
               fontFamily: 'system-ui, -apple-system, sans-serif',
             },
           },
@@ -292,23 +305,24 @@ window.__ModuleLoader__.load({
                 color: statusColor,
                 fontWeight: 600,
                 marginTop: 2,
-                marginBottom: 6,
+                marginBottom: otherProviders.length > 0 ? 6 : 0,
               },
             },
             `⚡ ${currentLatency > 0 ? currentLatency + ' ms' : '检测中'}`,
           ),
-          h(
-            'div',
-            {
-              style: {
-                borderTop: `1px dashed ${T.border}`,
-                paddingTop: 6,
-                color: T.secondary,
+          otherProviders.length > 0 &&
+            h(
+              'div',
+              {
+                style: {
+                  borderTop: `1px dashed ${T.border}`,
+                  paddingTop: 6,
+                  color: T.secondary,
+                },
               },
-            },
-            '🌐 Provider 链路一览',
-          ),
-          providers.map((p, i) =>
+              '🌐 其它 Provider 链路',
+            ),
+          otherProviders.map((p, i) =>
             h(
               'div',
               {
@@ -322,7 +336,13 @@ window.__ModuleLoader__.load({
               h(
                 'span',
                 { style: { display: 'flex', alignItems: 'center', gap: 4 } },
-                h('span', { style: { ...dotStyle(getQualityColor(p.probe?.quality, p.probe?.latencyMs)), width: 5, height: 5 } }),
+                h('span', {
+                  style: {
+                    ...dotStyle(getQualityColor(p.probe?.quality, p.probe?.latencyMs)),
+                    width: 5,
+                    height: 5,
+                  },
+                }),
                 p.name,
               ),
               h(
@@ -342,31 +362,10 @@ window.__ModuleLoader__.load({
     }
 
     function OverlayPanel() {
-      const [isOpen, setIsOpen] = useState(overlayOpen)
-      const [data, setData] = useState(null)
-      const [loading, setLoading] = useState(false)
-
-      useEffect(() => {
-        listeners.add(setIsOpen)
-        return () => listeners.delete(setIsOpen)
-      }, [])
-
-      const fetchData = useCallback(async () => {
-        try {
-          setLoading(true)
-          const res = await fetch('/api/link-pulse/status')
-          if (res.ok) {
-            const json = await res.json()
-            setData(json)
-          }
-        } catch {} finally {
-          setLoading(false)
-        }
-      }, [])
-
-      useEffect(() => {
-        if (isOpen) fetchData()
-      }, [isOpen, fetchData])
+      const state = useStore()
+      const isOpen = state.open
+      const data = state.data
+      const loading = state.loading
 
       const defaultModel = data?.defaultModelConfig?.model || 'gemini-3.7-flash-high'
       const activeModel = useActiveModel(defaultModel)
@@ -384,6 +383,7 @@ window.__ModuleLoader__.load({
       const currentLatency = activeProviderInfo?.probe?.latencyMs ?? -1
       const currentQuality = activeProviderInfo?.probe?.quality || 'offline'
       const statusColor = getQualityColor(currentQuality, currentLatency)
+      const otherProviders = providers.filter((p) => p.id !== activeProviderInfo?.id)
 
       return h(
         'div',
@@ -399,7 +399,7 @@ window.__ModuleLoader__.load({
             backdropFilter: 'blur(4px)',
           },
           onClick: (e) => {
-            if (e.target === e.currentTarget) setOverlay(false)
+            if (e.target === e.currentTarget) store.set({ open: false })
           },
         },
         h(
@@ -451,7 +451,7 @@ window.__ModuleLoader__.load({
                 'button',
                 {
                   className: 'pulse-btn',
-                  onClick: fetchData,
+                  onClick: () => fetchStatus(true),
                   disabled: loading,
                   style: {
                     display: 'flex',
@@ -473,7 +473,7 @@ window.__ModuleLoader__.load({
                 'button',
                 {
                   className: 'pulse-btn',
-                  onClick: () => setOverlay(false),
+                  onClick: () => store.set({ open: false }),
                   style: {
                     padding: '4px 8px',
                     borderRadius: '6px',
@@ -576,75 +576,79 @@ window.__ModuleLoader__.load({
                     marginBottom: '10px',
                   },
                 },
-                '🌐 已接入 Provider 链路测速对比',
+                '🌐 其它可用 Provider 链路测速',
               ),
-              h(
-                'div',
-                { style: { display: 'flex', flexDirection: 'column', gap: '8px' } },
-                providers.map((p, idx) => {
-                  const lat = p.probe?.latencyMs ?? -1
-                  const qual = p.probe?.quality || 'offline'
-                  const col = getQualityColor(qual, lat)
-                  const isCurrent = activeProviderInfo?.id === p.id
-
+              (() => {
+                if (otherProviders.length === 0) {
                   return h(
                     'div',
                     {
-                      key: idx,
                       style: {
-                        display: 'flex',
-                        justifyContent: 'space-between',
-                        alignItems: 'center',
-                        padding: '8px 10px',
-                        borderRadius: '8px',
-                        background: isCurrent ? 'rgba(59,130,246,.08)' : 'rgba(0,0,0,.03)',
-                        border: `1px solid ${isCurrent ? 'rgba(59,130,246,.3)' : 'transparent'}`,
+                        fontSize: '11px',
+                        color: T.secondary,
+                        textAlign: 'center',
+                        padding: '12px 0',
                       },
                     },
-                    h(
-                      'div',
-                      null,
-                      h(
-                        'div',
-                        { style: { display: 'flex', alignItems: 'center', gap: '6px' } },
-                        h('span', { style: dotStyle(col) }),
-                        h('span', { style: { fontWeight: 600, fontSize: '12px' } }, p.name),
-                        isCurrent &&
-                          h(
-                            'span',
-                            {
-                              style: {
-                                fontSize: '9px',
-                                color: T.brand,
-                                fontWeight: 600,
-                              },
-                            },
-                            '● 当前主力',
-                          ),
-                      ),
-                      h(
-                        'div',
-                        { style: { fontSize: '10px', color: T.secondary, marginTop: '2px' } },
-                        p.baseURL || '官方内置通道',
-                      ),
-                    ),
-                    h(
+                    '暂无其它已接入的 Provider',
+                  )
+                }
+
+                return h(
+                  'div',
+                  { style: { display: 'flex', flexDirection: 'column', gap: '8px' } },
+                  otherProviders.map((p, idx) => {
+                    const lat = p.probe?.latencyMs ?? -1
+                    const qual = p.probe?.quality || 'offline'
+                    const col = getQualityColor(qual, lat)
+
+                    return h(
                       'div',
-                      { style: { textAlign: 'right' } },
+                      {
+                        key: idx,
+                        style: {
+                          display: 'flex',
+                          justifyContent: 'space-between',
+                          alignItems: 'center',
+                          padding: '8px 10px',
+                          borderRadius: '8px',
+                          background: 'rgba(0,0,0,.03)',
+                          border: `1px solid transparent`,
+                        },
+                      },
                       h(
                         'div',
-                        { style: { fontWeight: 700, fontSize: '13px', color: col } },
-                        lat > 0 ? `${lat} ms` : '超时/离线',
+                        null,
+                        h(
+                          'div',
+                          { style: { display: 'flex', alignItems: 'center', gap: '6px' } },
+                          h('span', { style: dotStyle(col) }),
+                          h('span', { style: { fontWeight: 600, fontSize: '12px' } }, p.name),
+                        ),
+                        h(
+                          'div',
+                          { style: { fontSize: '10px', color: T.secondary, marginTop: '2px' } },
+                          p.baseURL || '官方内置通道',
+                        ),
                       ),
                       h(
                         'div',
-                        { style: { fontSize: '9px', color: T.secondary } },
-                        lat > 0 ? (lat < 200 ? '极佳' : '良好') : '不可达',
+                        { style: { textAlign: 'right' } },
+                        h(
+                          'div',
+                          { style: { fontWeight: 700, fontSize: '13px', color: col } },
+                          lat > 0 ? `${lat} ms` : '超时/离线',
+                        ),
+                        h(
+                          'div',
+                          { style: { fontSize: '9px', color: T.secondary } },
+                          lat > 0 ? (lat < 200 ? '极佳' : '良好') : '不可达',
+                        ),
                       ),
-                    ),
-                  )
-                }),
-              ),
+                    )
+                  }),
+                )
+              })(),
             ),
           ),
         ),

package/src/index.js

@@ -1,6 +1,8 @@
 import path from 'node:path'
 import os from 'node:os'
 import fs from 'node:fs'
+import tls from 'node:tls'
+import net from 'node:net'
 import jsYaml from 'js-yaml'
 
 export const name = 'link-pulse'
@@ -77,57 +79,111 @@ export function loadDynamicProviders() {
   }
 }
 
+/**
+ * 测量 Keep-Alive 状态下的真实单次 RTT 往返延迟
+ * (在已建立的加密 socket 上发送 HEAD 并测量首字节返回耗时)
+ */
 export async function probeLatency(url) {
   if (!url || !/^https?:\/\//i.test(url)) {
     return { latencyMs: -1, status: 'no_url', quality: 'offline', error: '无有效网络地址' }
   }
 
-  let probeUrl = url
-  try {
-    const parsed = new URL(url)
-    probeUrl = `${parsed.protocol}//${parsed.host}`
-  } catch {}
-
-  const start = performance.now()
-  const controller = new AbortController()
-  const timeoutId = setTimeout(() => controller.abort(), 3500)
-
-  try {
-    const res = await fetch(probeUrl, {
-      method: 'HEAD',
-      signal: controller.signal,
-      headers: { 'User-Agent': 'DSH-LinkPulse/1.0' },
-    }).catch(async () => {
-      return await fetch(probeUrl, {
-        method: 'GET',
-        signal: controller.signal,
-        headers: { 'User-Agent': 'DSH-LinkPulse/1.0' },
-      })
-    })
+  return new Promise((resolve) => {
+    let parsed
+    try {
+      parsed = new URL(url)
+    } catch {
+      return resolve({ latencyMs: -1, quality: 'error', reachable: false, error: 'URL 格式错误' })
+    }
 
-    clearTimeout(timeoutId)
-    const latencyMs = Math.round(performance.now() - start)
+    const host = parsed.hostname
+    const isHttps = parsed.protocol === 'https:'
+    const port = parseInt(parsed.port, 10) || (isHttps ? 443 : 80)
+    const timeout = 3500
 
-    let quality = 'excellent'
-    if (latencyMs > 600) quality = 'slow'
-    else if (latencyMs > 200) quality = 'good'
+    let timer = null
+    let socket = null
 
-    return {
-      latencyMs,
-      httpStatus: res.status,
-      quality,
-      reachable: true,
+    const cleanup = () => {
+      if (timer) clearTimeout(timer)
+      if (socket) {
+        socket.removeAllListeners()
+        socket.destroy()
+      }
     }
-  } catch (err) {
-    clearTimeout(timeoutId)
-    const isTimeout = err.name === 'AbortError'
-    return {
-      latencyMs: isTimeout ? 3500 : -1,
-      quality: isTimeout ? 'timeout' : 'error',
-      reachable: false,
-      error: isTimeout ? '请求超时 (>3.5s)' : (err.message || '连接失败'),
+
+    timer = setTimeout(() => {
+      cleanup()
+      resolve({ latencyMs: 3500, quality: 'timeout', reachable: false, error: '请求超时 (>3.5s)' })
+    }, timeout)
+
+    try {
+      const onEstablished = (sock) => {
+        const start = performance.now()
+        const path = parsed.pathname || '/'
+        sock.write(`HEAD ${path} HTTP/1.1\r\nHost: ${host}\r\nUser-Agent: DSH-LinkPulse/1.0\r\nConnection: close\r\n\r\n`)
+
+        sock.once('data', () => {
+          const latencyMs = Math.max(1, Math.round(performance.now() - start))
+          cleanup()
+
+          let quality = 'excellent'
+          if (latencyMs > 600) quality = 'slow'
+          else if (latencyMs > 200) quality = 'good'
+
+          resolve({
+            latencyMs,
+            quality,
+            reachable: true,
+          })
+        })
+      }
+
+      if (isHttps) {
+        socket = tls.connect({
+          host,
+          port,
+          servername: host,
+          rejectUnauthorized: false,
+          timeout,
+        }, () => onEstablished(socket))
+      } else {
+        socket = net.connect({
+          host,
+          port,
+          timeout,
+        }, () => onEstablished(socket))
+      }
+
+      socket.on('error', (err) => {
+        cleanup()
+        resolve({
+          latencyMs: -1,
+          quality: 'error',
+          reachable: false,
+          error: err.message || '连接失败',
+        })
+      })
+
+      socket.on('timeout', () => {
+        cleanup()
+        resolve({
+          latencyMs: 3500,
+          quality: 'timeout',
+          reachable: false,
+          error: '连接超时',
+        })
+      })
+    } catch (err) {
+      cleanup()
+      resolve({
+        latencyMs: -1,
+        quality: 'error',
+        reachable: false,
+        error: err.message || '连接异常',
+      })
     }
-  }
+  })
 }
 
 function sendJson(res, statusCode, data) {
@@ -137,6 +193,9 @@ function sendJson(res, statusCode, data) {
   res.end(JSON.stringify(data))
 }
 
+let cachedData = null
+let lastProbeAt = 0
+
 export function apply(ctx) {
   ctx.effect(() =>
     ctx.webServer.register({
@@ -148,6 +207,12 @@ export function apply(ctx) {
         }
 
         try {
+          const isForce = req.url && req.url.includes('refresh=1')
+          const now = Date.now()
+          if (!isForce && cachedData && now - lastProbeAt < 25_000) {
+            return sendJson(res, 200, cachedData)
+          }
+
           const { providers, defaultModelConfig, modelToProviderMap } = loadDynamicProviders()
 
           const probePromises = providers.map(async (p) => {
@@ -160,12 +225,15 @@ export function apply(ctx) {
 
           const probedProviders = await Promise.all(probePromises)
 
-          sendJson(res, 200, {
+          cachedData = {
             defaultModelConfig,
             modelToProviderMap,
             providers: probedProviders,
             timestamp: Date.now(),
-          })
+          }
+          lastProbeAt = Date.now()
+
+          sendJson(res, 200, cachedData)
         } catch (err) {
           sendJson(res, 500, { error: String(err && err.message ? err.message : err) })
         }