dsh-conn-check
Manifest validModel connectivity chips in the DSH session header: click one to send a single real request to that model (green reachable, red failed, hover for latency), and click its arrow to switch the current se
dsh-conn-check 
简体中文 · English
在 DSH 会话头部提供模型连通性检测:点击标签即向对应模型发起一次真实请求,连通显示绿色,失败显示红色。

界面截图,模型名称已作脱敏处理。
功能
| 元素 | 位置 | 作用 |
|---|---|---|
| 模型标签 | 会话头部 对话 / 轨迹 / 统计 右侧 | 点击后由宿主发起一次 max_tokens=1 请求,返回连通状态;悬停可查看耗时与失败原因 |
● 状态指示 | 标签内左侧 | 灰色表示未检测,蓝色表示检测中,绿色表示连通,红色表示失败 |
○ 连续检测 | 标签内右侧 | 仅对当前模型每 3 秒重复检测一次;多个标签可并行运行 |
→ 切换按钮 | 标签内右侧 | 将当前会话切换至该模型 |
⇄ | 标签行末端 | 依次检测所有已启用的模型。采用串行方式,避免触发服务商限流 |
F5 | 同上 | 刷新页面 |
⚙ | 同上 | 打开设置面板,选择启用哪些模型,选择即时保存 |
⟳ | 同上 | 连续点击两次确认后重启应用 |
悬停时可查看完整错误信息(例如 HTTP 503),而非笼统的失败提示。
重启功能的三重保护
- 需连续点击两次确认。首次点击进入待确认状态,3 秒后自动取消。
- 服务端返回 200 后进程退出,前端立即显示重启进度覆盖层;若 20 秒内未完成,将显示超时提示及日志路径。
- 在无法获取 Electron
app对象的环境(Web 模式、无头模式)下按钮置灰,避免出现点击后无响应的情况。
模型来源
模型与凭据均在运行时自动读取,无需手动配置:
| 内容 | 来源 |
|---|---|
| 候选模型列表 | ~/.dsh/profiles/<profile>/cordis.patch.yml → llm-pi-ai.providers |
| 当前默认模型 | 同上文件 → agent-default-model |
| 模型凭据 | ~/.dsh/.credentials.yaml → refs.<ENV_NAME> |
凭据仅在宿主进程内存中使用,不会下发至页面。源码中不含任何服务商名称、模型名称或密钥字面量。
更换服务商或新增模型后,重启一次即可生效,无需修改插件。
安装
在 DSH 中依次打开 设置 → 插件 → 添加插件,填入包名:
dsh-conn-check
或使用 npm 直接安装:
npm install dsh-conn-check
安装完成后重启一次 DSH。详细步骤见 INSTALL.md。
已知限制
- 仅支持「OpenAI 兼容」与「Anthropic Messages」两种接口形态,其它协议按 OpenAI 形态发送。
- 单次检测超时上限为 20 秒。
- 前端依赖 DOM 注入(挂载于
[role="tablist"]右侧)。DSH 前端大幅改版时可能需要调整选择器。 - 检测请求会产生极少量实际计费(
max_tokens=1)。 - 重启功能仅在 Windows 桌面版可用,Web 模式与无头模式下按钮自动置灰。
卸载
$dsh = "$env:LOCALAPPDATA\Programs\DeepSeekRuntime\resources\runtime\cli\bin\dsh.cmd"
& $dsh plugin --profile desktop remove dsh-conn-check
如需彻底清除,可一并删除插件目录与状态文件:
~/.dsh/local-plugins/dsh-conn-check
~/.dsh/dsh-conn-check.json
文档
- INSTALL.md:安装步骤与界面说明。
- docs/DETAIL.md:架构说明、接口定义、目录结构、自检与故障排查。
- docs/NOTES.md:实现过程中已确认的技术约束与已知问题。
许可
MIT
Comments
Loading…
Similar plugins
by SYXliuliuliu
Apply the current session's model to every other session in one click, from a control beside the composer's model picker.
★ 0
MIT
JavaScript
Oct 6, 2026
dsh plugin --profile web add dsh-apply-model-allby Willmylife
Adds a connection-test panel under Settings -> Models: reads the deployment's model catalog and probes each configured model with one minimal chat round-trip (a short "ping" with a small output cap) t
★ 1
MIT
JavaScript
Oct 30, 2026
dsh plugin --profile web add dsh-model-connection-testOne-click enable/disable switch for every model provider in DeepSeek Harness - disabled providers leave the model picker. DSH 模型提供商一键开关:在「设置 → 模型」每行「编辑」左侧放一个开关,关掉即从模型选择栏消失。
★ 0
MIT
JavaScript
dsh plugin --profile web add dsh-provider-toggleModel failover router that queues all connected DSH models, retries with continue text on failure, switches to next model, and quarantines failing models for the day.
★ 1
NOASSERTION
JavaScript
dsh plugin --profile web add dsh-model-failoverby CAI-MH
在大模型思考过程中,随时向当前会话注入纠偏/引导信息,或打断当前回合 — DSH bundle。
★ 0
MIT
JavaScript
Sep 10, 2026
dsh plugin --profile web add dsh-steerKeyboard-driven quick switching for DSH — model palette with colored provider tags, suffix tags and pins, a two-column session palette with per-question prompt preview and archived-session restore, re
★ 0
dsh plugin --profile web add dsh-shortcut-extensions