dsh-link-pulse 0.1.4 → 0.1.6

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## [0.1.6] - 2026-08-25
+
+### Docs
+- 补充 README 中的 Keep-Alive 纯 1-RTT 测速原理与冷握手 vs 热长连接对比说明表。
+
+## [0.1.5] - 2026-08-25
+
+### Changed
+- 侧边栏常驻条目排版样式优化：将延迟数值（如 `126ms`）改为与 OpenCode / CPA 规范统一的紧凑分段格式（`● CPA · Gemini 3.7 · 126ms`），去除两端强行两极分散的 `space-between`，实现视觉规格 100% 像素级对齐。
+
 ## [0.1.4] - 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.4",
+  "version": "0.1.6",
   "description": "Dynamic LLM provider gateway latency and health pulse probe for DeepSeek Harness",
   "type": "module",
   "license": "Apache-2.0",

package/src/client.js

@@ -201,6 +201,12 @@ window.__ModuleLoader__.load({
 
       const otherProviders = (data?.providers || []).filter((p) => p.id !== activeProviderInfo?.id)
 
+      const segments = [
+        { text: providerDisplayName, color: T.label, bold: true },
+        { text: modelShortName, color: T.secondary },
+        { text: currentLatency > 0 ? `${currentLatency}ms` : '探测中', color: statusColor, bold: true },
+      ]
+
       const node = h(
         'button',
         {
@@ -222,44 +228,39 @@ window.__ModuleLoader__.load({
         }),
         wide &&
           h(
-            'div',
+            'span',
             {
               style: {
-                display: 'flex',
+                display: 'inline-flex',
                 alignItems: 'center',
-                justifyContent: 'space-between',
-                flex: 1,
-                overflow: 'hidden',
+                lineHeight: '18px',
                 whiteSpace: 'nowrap',
+                minWidth: 0,
+                overflow: 'hidden',
+                textOverflow: 'ellipsis',
               },
             },
-            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` : '探测中',
+            segments.flatMap((s, i) =>
+              i === 0
+                ? [h('span', { key: `s${i}`, style: { color: s.color, fontWeight: 500, flexShrink: 0 } }, s.text)]
+                : [
+                    h('span', { key: `sep${i}`, style: { color: T.secondary, margin: '0 5px', opacity: 0.7, flexShrink: 0 } }, '·'),
+                    h(
+                      'span',
+                      {
+                        key: `s${i}`,
+                        style: {
+                          color: s.color,
+                          fontWeight: s.bold ? 500 : undefined,
+                          fontVariantNumeric: 'tabular-nums',
+                          overflow: 'hidden',
+                          textOverflow: 'ellipsis',
+                          flexShrink: i === segments.length - 1 ? 0 : 1,
+                        },
+                      },
+                      s.text,
+                    ),
+                  ],
             ),
           ),
       )