dsh-link-pulse 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,9 @@
+# Changelog
+
+## [0.1.0] - 2026-08-25
+
+### Added
+- 初始版本发布：支持从 `settings.yaml` 动态读取 Providers。
+- 侧边栏常驻条目与当前会话模型动态感知。
+- 多通道实时测速浮层看板。
+- 遵循 Cordis@4 扁平依赖注入规范。

package/LICENSE

@@ -0,0 +1,176 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS

package/README.md

@@ -0,0 +1,53 @@
+# dsh-link-pulse
+
+[![npm](https://img.shields.io/npm/v/dsh-link-pulse?color=blue)](https://www.npmjs.com/package/dsh-link-pulse)
+[![License](https://img.shields.io/badge/license-Apache--2.0-green.svg)](./LICENSE)
+
+专为 **DeepSeek Harness (DSH) Web GUI** 打造的**模型链路与上游网关延迟感知插件**。解决日常使用 AI 时的“黑盒卡顿焦虑”，帮助用户一眼分清当前是本地网络拥堵、代理网关排队还是大模型自身在进行长思考（CoT）。
+
+## 核心特性
+
+- **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 的实时测速对比并支持一键手动测速。
+
+## 安装与更新
+
+### 方式一：官方 npm 安装（推荐）
+
+```sh
+dsh plugin --profile web add dsh-link-pulse
+```
+
+### 方式二：GitHub 仓库直接安装
+
+```sh
+dsh plugin --profile web add github:j2st1n/dsh-link-pulse
+```
+
+> **说明**：
+> - 纯原生 JS 零构建（Zero-build）架构，安装后重启 `dsh web` 即可立即生效。
+
+### 卸载
+
+```sh
+dsh plugin --profile web remove dsh-link-pulse
+```
+
+## 延迟状态等级
+
+| 延迟区间 | 状态颜色 | 质量评级 |
+| :--- | :---: | :--- |
+| $\le$ 200ms | 🟢 绿色 | 极佳（Excellent） |
+| 200ms $\sim$ 600ms | 🟡 黄色 | 良好（Good） |
+| > 600ms / 超时 | 🔴 红色 | 缓慢 / 离线（Slow / Timeout） |
+
+## 安全声明
+
+- 详见 [SECURITY.md](./SECURITY.md)。
+
+## License
+
+[Apache-2.0](./LICENSE)

package/SECURITY.md

@@ -0,0 +1,7 @@
+# Security Policy
+
+## 零 Token 消耗与安全声明
+
+1. **零 Token 消耗**：本插件探针采用 HTTP `HEAD` / `GET` 轻量级连接测试，仅测试网络往返延迟（RTT），绝不调用 `/chat/completions` 等模型推理接口，不消耗任何 Token 配额。
+2. **本地配置只读**：插件后端仅以只读方式解析 `settings.yaml`，不写入或篡改任何系统配置与密钥。
+3. **无敏感数据外泄**：所有探测数据仅供本地 DSH Web 界面消费，不向任何第三方上报遥测数据。

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+# dsh-link-pulse bundle patch: one insert adding the host row.
+- insert:
+    - id: link-pulse
+      name: dsh-link-pulse

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "dsh-link-pulse",
+  "version": "0.1.0",
+  "description": "Dynamic LLM provider gateway latency and health pulse probe for DeepSeek Harness",
+  "type": "module",
+  "license": "Apache-2.0",
+  "keywords": [
+    "deepseek-harness",
+    "dsh",
+    "dsh-plugin",
+    "latency",
+    "probe",
+    "pulse",
+    "status-panel"
+  ],
+  "exports": {
+    ".": "./src/index.js",
+    "./client": "./src/client.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "cordis.patch.yml",
+    "SECURITY.md",
+    "CHANGELOG.md",
+    "README.md"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": []
+    }
+  },
+  "dependencies": {
+    "js-yaml": "^4.1.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/j2st1n/dsh-link-pulse.git"
+  },
+  "homepage": "https://github.com/j2st1n/dsh-link-pulse#readme",
+  "bugs": "https://github.com/j2st1n/dsh-link-pulse/issues",
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "test": "node --test"
+  }
+}

package/src/client.js

@@ -0,0 +1,593 @@
+window.__ModuleLoader__.load({
+  id: 'dsh-link-pulse',
+  factory: (require) => {
+    const module = { exports: {} }
+    const exports = module.exports
+    const React = require('react')
+    const h = React.createElement
+    const { useEffect, useState, useCallback, useMemo } = React
+
+    const T = {
+      bg: 'var(--dsw-alias-bg-layer-2, #ffffff)',
+      layer: 'var(--dsw-alias-bg-layer-2, #ffffff)',
+      layer1: 'var(--dsw-alias-bg-layer-1, #f4f4f5)',
+      border: 'var(--dsw-alias-border-l1, rgba(0,0,0,.1))',
+      border2: 'var(--dsw-alias-border-l2, rgba(0,0,0,.15))',
+      label: 'var(--dsw-alias-label-primary, #18181b)',
+      secondary: 'var(--dsw-alias-label-secondary, #71717a)',
+      brand: 'var(--dsw-alias-brand-primary, #3b82f6)',
+      ok: 'var(--dsw-alias-state-success-primary, #22c55e)',
+      warn: 'var(--dsw-alias-state-warn-primary, #f59e0b)',
+      err: 'var(--dsw-alias-state-error-primary, #ef4444)',
+    }
+
+    const CSS = `
+      @keyframes pulseFadeSlideUp { from { opacity: 0; transform: translateY(10px) scale(.98) } to { opacity: 1; transform: translateY(0) scale(1) } }
+      @keyframes pulseFadeIn { from { opacity: 0; transform: translateY(4px) } to { opacity: 1; transform: translateY(0) } }
+      @keyframes pulseSpin { to { transform: rotate(360deg) } }
+      @keyframes pulseGlow { 0% { box-shadow: 0 0 0 0 rgba(34,197,94,.45) } 70% { box-shadow: 0 0 0 5px rgba(34,197,94,0) } 100% { box-shadow: 0 0 0 0 rgba(34,197,94,0) } }
+      
+      .pulse-panel-enter { animation: pulseFadeSlideUp .2s cubic-bezier(.2,.9,.3,1.2) both }
+      .pulse-btn { min-width: 0; transition: background .15s ease, border-color .15s ease, color .15s ease, transform .1s ease, opacity .15s ease }
+      .pulse-btn:hover:not(:disabled) { background: var(--dsw-alias-interactive-bg-hover, var(--dsw-alias-bg-layer-1)); border-color: var(--dsw-alias-border-l2) }
+      .pulse-btn:active:not(:disabled) { transform: scale(.97) }
+      .pulse-dot-live { animation: pulseGlow 2.4s ease-out infinite }
+      .pulse-spin { display: inline-block; animation: pulseSpin .8s linear infinite }
+    `
+
+    const dotStyle = (color) => ({
+      display: 'inline-block',
+      width: 7,
+      height: 7,
+      borderRadius: '50%',
+      background: color,
+      flexShrink: 0,
+      verticalAlign: 'middle',
+    })
+
+    const btnBase = {
+      display: 'flex',
+      alignItems: 'center',
+      gap: 6,
+      padding: '4px 8px',
+      border: `1px solid ${T.border}`,
+      borderRadius: 6,
+      background: 'transparent',
+      color: T.label,
+      fontSize: 12,
+      lineHeight: '18px',
+      height: 28,
+      boxSizing: 'border-box',
+      cursor: 'pointer',
+      whiteSpace: 'nowrap',
+    }
+
+    let overlayOpen = false
+    const listeners = new Set()
+    function setOverlay(val) {
+      overlayOpen = val
+      listeners.forEach((fn) => fn(val))
+    }
+
+    function getQualityColor(quality, latencyMs) {
+      if (quality === 'excellent' || (latencyMs > 0 && latencyMs <= 200)) return T.ok
+      if (quality === 'good' || (latencyMs > 200 && latencyMs <= 600)) return T.warn
+      return T.err
+    }
+
+    function formatModelShortName(modelId) {
+      if (!modelId) return 'Auto'
+      const m = modelId.toLowerCase()
+      if (m.includes('gemini-3.7') || m.includes('gemini-3-7')) return 'Gemini 3.7'
+      if (m.includes('gemini-2.5') || m.includes('gemini-2-5')) return 'Gemini 2.5'
+      if (m.includes('deepseek-v4-flash') || m.includes('v4-flash')) return 'V4 Flash'
+      if (m.includes('deepseek-v4-pro') || m.includes('v4-pro')) return 'V4 Pro'
+      if (m.includes('deepseek-chat')) return 'Chat'
+      if (m.includes('deepseek-reasoner')) return 'Reasoner'
+      if (m.includes('claude-3-7') || m.includes('claude-3.7')) return 'Claude 3.7'
+      if (m.includes('claude-3-5') || m.includes('claude-3.5')) return 'Claude 3.5'
+      if (m.includes('gpt-5')) return 'GPT-5.6'
+      if (m.includes('gpt-4o')) return 'GPT-4o'
+      if (m.includes('qwen3.7') || m.includes('qwen-3.7')) return 'Qwen 3.7'
+      if (m.includes('kimi-k3')) return 'Kimi K3'
+      if (m.includes('kimi-k2.7')) return 'Kimi K2.7'
+      if (m.includes('kimi')) return 'Kimi'
+      if (m.includes('minimax-m3')) return 'MiniMax M3'
+      if (m.includes('glm-5')) return 'GLM-5'
+      return modelId.split(/[-_]/)[0] || modelId
+    }
+
+    function useActiveModel(defaultModel) {
+      const [activeModel, setActiveModel] = useState(defaultModel || 'gemini-3.7-flash-high')
+
+      useEffect(() => {
+        const detectModel = () => {
+          try {
+            const modelButton = document.querySelector(
+              '[data-slot="conversation.input.model"], button[class*="modelSelect"], div[class*="modelSelector"]',
+            )
+            if (modelButton && modelButton.textContent) {
+              const text = modelButton.textContent.trim()
+              if (text && text.length < 30) {
+                setActiveModel(text)
+                return
+              }
+            }
+          } catch {}
+          if (defaultModel) setActiveModel(defaultModel)
+        }
+
+        detectModel()
+        const timer = setInterval(detectModel, 3000)
+        return () => clearInterval(timer)
+      }, [defaultModel])
+
+      return activeModel
+    }
+
+    function FooterEntry(props) {
+      const { wide } = props
+      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(() => {
+        fetchData()
+        const timer = setInterval(fetchData, 45_000)
+        return () => clearInterval(timer)
+      }, [fetchData])
+
+      const defaultModel = data?.defaultModelConfig?.model || 'gemini-3.7-flash-high'
+      const activeModel = useActiveModel(defaultModel)
+
+      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])
+
+      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 tooltipText = useMemo(() => {
+        if (!data?.providers) return '链路测速中...'
+        const lines = [`🎯 当前对话模型: ${activeModel}`]
+        lines.push(`🏢 归属供应商: ${providerDisplayName}`)
+        lines.push(`⚡ 实时往返延迟: ${currentLatency > 0 ? currentLatency + ' ms' : '检测中'}`)
+        lines.push('────────────────────────')
+        lines.push('🌐 已接入 Provider 链路一览:')
+        for (const p of data.providers) {
+          const lat = p.probe?.latencyMs > 0 ? `${p.probe.latencyMs}ms` : '离线'
+          lines.push(`• ${p.name}: ${lat}`)
+        }
+        return lines.join('\n')
+      }, [data, activeModel, providerDisplayName, currentLatency])
+
+      return h(
+        'button',
+        {
+          className: 'pulse-btn',
+          onClick: () => setOverlay(!isOpen),
+          title: tooltipText,
+          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',
+          },
+        },
+        h('span', {
+          className: statusColor === T.ok ? 'pulse-dot-live' : undefined,
+          style: dotStyle(statusColor),
+        }),
+        wide &&
+          h(
+            'div',
+            {
+              style: {
+                display: 'flex',
+                alignItems: 'center',
+                justifyContent: 'space-between',
+                flex: 1,
+                overflow: 'hidden',
+                whiteSpace: 'nowrap',
+              },
+            },
+            h(
+              'div',
+              {
+                style: {
+                  display: 'flex',
+                  alignItems: 'center',
+                  gap: 3,
+                  overflow: 'hidden',
+                  textOverflow: 'ellipsis',
+                },
+              },
+              h('span', { style: { fontWeight: 500, color: T.label } }, providerDisplayName),
+              h('span', { style: { color: T.secondary } }, '·'),
+              h('span', { style: { color: T.secondary, overflow: 'hidden', textOverflow: 'ellipsis' } }, modelShortName),
+            ),
+            h(
+              'span',
+              {
+                style: {
+                  fontSize: 11,
+                  fontWeight: 600,
+                  color: statusColor,
+                  marginLeft: 6,
+                  flexShrink: 0,
+                },
+              },
+              currentLatency > 0 ? `${currentLatency}ms` : '探测中',
+            ),
+          ),
+      )
+    }
+
+    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 defaultModel = data?.defaultModelConfig?.model || 'gemini-3.7-flash-high'
+      const activeModel = useActiveModel(defaultModel)
+
+      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 (!isOpen) return null
+
+      const providers = data?.providers || []
+      const currentLatency = activeProviderInfo?.probe?.latencyMs ?? -1
+      const currentQuality = activeProviderInfo?.probe?.quality || 'offline'
+      const statusColor = getQualityColor(currentQuality, currentLatency)
+
+      return h(
+        'div',
+        {
+          style: {
+            position: 'fixed',
+            inset: 0,
+            zIndex: 9999,
+            display: 'flex',
+            alignItems: 'center',
+            justifyContent: 'center',
+            background: 'rgba(0,0,0,.45)',
+            backdropFilter: 'blur(4px)',
+          },
+          onClick: (e) => {
+            if (e.target === e.currentTarget) setOverlay(false)
+          },
+        },
+        h(
+          'div',
+          {
+            className: 'pulse-panel-enter',
+            style: {
+              width: '92%',
+              maxWidth: '540px',
+              background: T.bg,
+              border: `1px solid ${T.border2}`,
+              borderRadius: '16px',
+              boxShadow: '0 20px 40px rgba(0,0,0,.25)',
+              color: T.label,
+              overflow: 'hidden',
+              fontFamily: 'system-ui, -apple-system, sans-serif',
+            },
+          },
+          h(
+            'div',
+            {
+              style: {
+                display: 'flex',
+                alignItems: 'center',
+                justifyContent: 'space-between',
+                padding: '16px 20px',
+                borderBottom: `1px solid ${T.border}`,
+              },
+            },
+            h(
+              'div',
+              { style: { display: 'flex', alignItems: 'center', gap: '10px' } },
+              h('span', { style: { fontSize: '20px' } }, '📡'),
+              h(
+                'div',
+                null,
+                h('div', { style: { fontSize: '15px', fontWeight: 600 } }, '模型链路与上游延迟脉搏'),
+                h(
+                  'div',
+                  { style: { fontSize: '11px', color: T.secondary } },
+                  '仅探测本机实际接入的 LLM Provider 网关',
+                ),
+              ),
+            ),
+            h(
+              'div',
+              { style: { display: 'flex', alignItems: 'center', gap: '8px' } },
+              h(
+                'button',
+                {
+                  className: 'pulse-btn',
+                  onClick: fetchData,
+                  disabled: loading,
+                  style: {
+                    display: 'flex',
+                    alignItems: 'center',
+                    gap: '4px',
+                    padding: '5px 12px',
+                    borderRadius: '6px',
+                    border: `1px solid ${T.border}`,
+                    background: 'transparent',
+                    color: T.label,
+                    fontSize: '12px',
+                    fontWeight: 500,
+                    cursor: 'pointer',
+                  },
+                },
+                loading ? h('span', { className: 'pulse-spin' }, '⚡') : '⚡ 立即测速',
+              ),
+              h(
+                'button',
+                {
+                  className: 'pulse-btn',
+                  onClick: () => setOverlay(false),
+                  style: {
+                    padding: '4px 8px',
+                    borderRadius: '6px',
+                    border: `1px solid ${T.border}`,
+                    background: 'transparent',
+                    color: T.secondary,
+                    fontSize: '14px',
+                    cursor: 'pointer',
+                  },
+                },
+                '✕',
+              ),
+            ),
+          ),
+          h(
+            'div',
+            {
+              style: {
+                padding: '20px',
+                display: 'flex',
+                flexDirection: 'column',
+                gap: '14px',
+              },
+            },
+            h(
+              'div',
+              {
+                style: {
+                  background: T.layer1,
+                  border: `1px solid ${T.border}`,
+                  borderRadius: '12px',
+                  padding: '14px 16px',
+                },
+              },
+              h(
+                'div',
+                {
+                  style: {
+                    display: 'flex',
+                    justifyContent: 'space-between',
+                    alignItems: 'center',
+                    marginBottom: '8px',
+                  },
+                },
+                h(
+                  'div',
+                  { style: { display: 'flex', alignItems: 'center', gap: '8px' } },
+                  h('span', { style: dotStyle(statusColor) }),
+                  h('span', { style: { fontWeight: 600, fontSize: '14px' } }, activeModel),
+                  h(
+                    'span',
+                    {
+                      style: {
+                        fontSize: '10px',
+                        padding: '2px 6px',
+                        borderRadius: '4px',
+                        background: 'rgba(59,130,246,.15)',
+                        color: T.brand,
+                        fontWeight: 600,
+                      },
+                    },
+                    `供应商: ${activeProviderInfo?.name || 'CPA'}`,
+                  ),
+                ),
+                h(
+                  'span',
+                  {
+                    style: {
+                      fontSize: '16px',
+                      fontWeight: 700,
+                      color: statusColor,
+                    },
+                  },
+                  currentLatency > 0 ? `${currentLatency} ms` : '检测中',
+                ),
+              ),
+              h(
+                'div',
+                { style: { fontSize: '11px', color: T.secondary, wordBreak: 'break-all' } },
+                `网关端点: ${activeProviderInfo?.baseURL || '系统内置直连通道'}`,
+              ),
+            ),
+            h(
+              'div',
+              {
+                style: {
+                  background: T.layer1,
+                  border: `1px solid ${T.border}`,
+                  borderRadius: '12px',
+                  padding: '14px 16px',
+                },
+              },
+              h(
+                'div',
+                {
+                  style: {
+                    fontSize: '12px',
+                    fontWeight: 600,
+                    color: T.secondary,
+                    marginBottom: '10px',
+                  },
+                },
+                '🌐 已接入 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
+
+                  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'}`,
+                      },
+                    },
+                    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(
+                      'div',
+                      { 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 ? '极佳' : '良好') : '不可达',
+                      ),
+                    ),
+                  )
+                }),
+              ),
+            ),
+          ),
+        ),
+      )
+    }
+
+    function apply(ctx) {
+      ctx.effect(() => {
+        const el = document.createElement('style')
+        el.id = 'dsh-link-pulse-styles'
+        el.textContent = CSS
+        document.head.appendChild(el)
+        return () => el.remove()
+      })
+
+      ctx.effect(() =>
+        ctx.slots.inject('sidebar.footer.action', () =>
+          ctx.slots.register(
+            { name: 'sidebar.footer.action', id: 'link-pulse', order: -10 },
+            (props) => h(FooterEntry, props),
+          ),
+        ),
+      )
+
+      ctx.effect(() =>
+        ctx.slots.inject('shell.overlay', () =>
+          ctx.slots.register(
+            { name: 'shell.overlay', id: 'link-pulse-panel', order: 5 },
+            () => h(OverlayPanel),
+          ),
+        ),
+      )
+    }
+
+    exports.apply = apply
+    exports.inject = ['slots']
+    return module.exports
+  },
+})

package/src/index.js

@@ -0,0 +1,175 @@
+import path from 'node:path'
+import os from 'node:os'
+import fs from 'node:fs'
+import jsYaml from 'js-yaml'
+
+export const name = 'link-pulse'
+export const inject = ['webServer']
+
+function getSettingsPath() {
+  const dshHome = process.env.DSH_HOME || path.join(os.homedir(), '.dsh')
+  return path.join(dshHome, 'settings.yaml')
+}
+
+export function loadDynamicProviders() {
+  const settingsPath = getSettingsPath()
+  let settings = {}
+  if (fs.existsSync(settingsPath)) {
+    try {
+      const raw = fs.readFileSync(settingsPath, 'utf8')
+      settings = jsYaml.load(raw) || {}
+    } catch {}
+  }
+
+  const providersConfig = settings['llm-pi-ai']?.providers || {}
+  const defaultModelConfig = settings['agent-default-model'] || {
+    provider: 'cpa',
+    model: 'gemini-3.7-flash-high',
+  }
+
+  const providers = []
+  const modelToProviderMap = {}
+
+  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
+    }
+
+    let targetBaseUrl = pConfig.baseURL || ''
+    if (!targetBaseUrl && providerId === 'opencode-go') {
+      targetBaseUrl = 'https://api.deepseek.com'
+    }
+
+    providers.push({
+      id: providerId,
+      name: providerId.toUpperCase(),
+      baseURL: targetBaseUrl,
+      api: pConfig.api || 'openai-responses',
+      models: modelList,
+      isDefault: defaultModelConfig.provider === providerId,
+    })
+  }
+
+  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',
+      name: 'DeepSeek 官方',
+      baseURL: 'https://api.deepseek.com',
+      api: 'deepseek-native',
+      models: dsModels,
+      isDefault: defaultModelConfig.provider === 'deepseek',
+    })
+  }
+
+  return {
+    providers,
+    defaultModelConfig,
+    modelToProviderMap,
+  }
+}
+
+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' },
+      })
+    })
+
+    clearTimeout(timeoutId)
+    const latencyMs = Math.round(performance.now() - start)
+
+    let quality = 'excellent'
+    if (latencyMs > 600) quality = 'slow'
+    else if (latencyMs > 200) quality = 'good'
+
+    return {
+      latencyMs,
+      httpStatus: res.status,
+      quality,
+      reachable: true,
+    }
+  } 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 || '连接失败'),
+    }
+  }
+}
+
+function sendJson(res, statusCode, data) {
+  res.statusCode = statusCode
+  res.setHeader('Content-Type', 'application/json; charset=utf-8')
+  res.setHeader('Cache-Control', 'no-store')
+  res.end(JSON.stringify(data))
+}
+
+export function apply(ctx) {
+  ctx.effect(() =>
+    ctx.webServer.register({
+      kind: 'exact',
+      path: '/api/link-pulse/status',
+      handler: async (req, res) => {
+        if (req.method !== 'GET') {
+          return sendJson(res, 405, { error: 'GET only' })
+        }
+
+        try {
+          const { providers, defaultModelConfig, modelToProviderMap } = loadDynamicProviders()
+
+          const probePromises = providers.map(async (p) => {
+            const probeResult = await probeLatency(p.baseURL)
+            return {
+              ...p,
+              probe: probeResult,
+            }
+          })
+
+          const probedProviders = await Promise.all(probePromises)
+
+          sendJson(res, 200, {
+            defaultModelConfig,
+            modelToProviderMap,
+            providers: probedProviders,
+            timestamp: Date.now(),
+          })
+        } catch (err) {
+          sendJson(res, 500, { error: String(err && err.message ? err.message : err) })
+        }
+      },
+    }),
+  )
+}