Spark 节点速览 juliankang4/dsh-spark-scope

dsh-spark-scope

一个 DeepSeek Harness 插件，把 Spark Scope 迷你窗口的 Glance 视图放进左侧边栏，这样你工作时就能随时盯着 DGX Spark 节点和它们的模型服务。浏览器（dsh web）和 Desktop 应用里都能用。

安装

dsh plugin --profile web add dsh-spark-scope

在 Desktop 应用里，打开 Plugins，选择 Add plugin，输入 dsh-spark-scope 并安装。

你还需要一个正在运行的 Spark Scope 服务端。参见它的安装指南。

设置

打开 Settings 里的 Spark Scope 标签页，输入 Spark Scope 仪表盘的地址，按回车。局域网地址（如 http://spark-scope.local:8787）和 tailnet 地址（如 https://spark-scope.example.ts.net）都可以。如果不写 scheme，会自动补上 http://。清空输入框即可隐藏卡片。地址只能在运行 dsh 的电脑上修改；从另一台电脑打开的页面会显示输入框，但无法保存。

数据由 dsh 拉取，而不是你的浏览器，所以地址必须能从运行 dsh 的电脑访问。Spark Scope 只响应发往 localhost、IP 地址或它自己主机名的请求。要用其他名字，比如反向代理的域名，得把它加到 Spark Scope 服务端的 SPARK_SCOPE_ALLOWED_HOSTS 里。

卡片

卡片位于侧边栏底部，在其他页脚项（比如 dsh-cost-meter 的余额）上方。卡片顶部显示模型名称、有多少节点在响应，以及 decode 和 prefill 速率，附带五分钟 sparkline。下面是运行中和排队中的请求、KV cache 使用率、最近五分钟的 TTFT 和 TPOT p95、前缀缓存命中率，再往下每个节点一行，显示 GPU 温度、功耗、负载和内存占用。如果你跑了多个模型服务，卡片会显示它们合计的速率和请求数，就像 Spark Scope 的「All at once」视图。

模型名称旁边的圆点，在 Spark Scope 报告集群健康时是绿色，其他状态是橙色。如果 Spark Scope 停止响应，或它的数据超过 20 秒没更新，圆点变红。破折号（—）表示 Spark Scope 对该值没有读数。

右上角的按钮把卡片折叠成一行，只显示模型名称和 decode 速率，浏览器会记住这个设置。侧边栏折叠时卡片隐藏。它跟随 dsh 的主题和语言（英语、中文，配合 dsh-locale-ko 还有韩语），并随 dsh-ui-scale 缩放。

它如何读取 Spark Scope

插件给 dsh web 服务器加了一条路由 /plugins/dsh-spark-scope/state。页面可见时，卡片每 2 秒请求一次，dsh 会去取 /api/state，超时 5 秒。插件只读数据，绝不改动 Spark Scope 或节点上的任何东西。这条路由沿用 dsh 自身 API 的登录校验和 Host 校验，所以只有已登录的 dsh 页面才能读取。Spark Scope 返回的响应超过 2 MB，dsh 会忽略。想安全运行 dsh，请看 dsh 的 SAFETY.md。

配置

| 字段 | 默认值 | 说明 |
| url | 空 | Spark Scope 地址（http 或 https）。留空则隐藏卡片。 |

设置里的 Spark Scope 标签页会保存这个值。你也可以在配置档的 cordis.patch.yml 里设置：

- id: spark-scope
name: dsh-spark-scope
config:
url: http://spark-scope.local:8787

已在 dsh 0.2.0-rc.2（Chrome 和 macOS 桌面应用）与 Spark Scope 0.1.3 上测试通过。