dsh-wsl-hostsvc：从 WSL 探测 Windows 主机本地 LLM 服务

在本地部署 LLM 环境时，从 WSL 访问 Windows 主机上的服务通常需要手动配置网络与端口。dsh-wsl-hostsvc 插件解决了这个问题。它从 WSL 端探测 Windows 主机上运行的 OpenAI 兼容 LLM 服务器，并直接提供可访问的 baseURL 和配置片段。

核心功能¶

该插件使用工具 host_reach（默认 profile=all）探测本地服务。支持的配置文件包括：

• ollama：探测 Ollama 默认端口（11434）
• lmstudio：探测 LM Studio 本地服务器（通常为 1234）
• vllm：探测 vLLM OpenAI 服务器（通常为 8000）
• llama：探测 llama-server / Unsloth Desktop（通常为 8080）

探测时会尝试连接 127.0.0.1、localhost、host.docker.internal 以及从 /etc/resolv.conf 获取的 Windows IP。

插件会输出以下内容：

• suggestedBaseURL / 每个服务的 URL
• providerSnippets.yaml：可直接粘贴到 ~/.dsh/settings.yaml 的 llm-pi-ai.providers 下
• ollamaModels：从 ollama list 获取的精确模型 ID
• connectivityPlaybook：当 HTTPS/DNS 也失败时按顺序尝试的工具
• hints：包含 Ollama n_ctx 与设置 contextWindow 的匹配建议、VRAM 等提示

安装与启用¶

通过 kit 安装：

curl -fsSL https://raw.githubusercontent.com/173787247/dsh-wsl-kit/master/install.sh | KIT_SET=llm bash

或者单独安装：

dsh plugin --profile web add github:173787247/dsh-wsl-hostsvc

安装完成后，重启 dsh web 并打开一个新会话。

典型用法¶

在对话中要求代理执行 host_reach，指定配置文件：

• profile: ollama
• profile: lmstudio
• profile: vllm
• profile: llama
• profile: all

如果探测不到服务，请检查 Windows 端是否绑定在回环地址之外（例如 OLLAMA_HOST=0.0.0.0:11434），或者启用 WSL 镜像网络模式后重新探测。

注意事项¶

• 依赖版本：需要 dsh >= 0.1.2（插件版本 0.4.3）。
• 探测范围：仅探测 Windows 主机上的本地 OpenAI 兼容服务器（host_reach）。它不配置云端 DeepSeek；对于 V4.1 Flash，请在设置中使用模型 ID deepseek-flash。
• API 就绪：TCP 端口开放不等于 API 就绪。
• Ollama 上下文问题：如果 num_ctx 与设置中的 contextWindow 不匹配，可能会遇到 400 错误。建议设置 Ollama 的 num_ctx（例如 32768）并在设置中匹配该值。
• Unsloth 区别：注意 Unsloth Desktop（通过 winget 安装）与 Unsloth Studio（目录 ~/.unsloth/studio）的区别。Desktop 通常在 8080 端口暴露 OpenAI /v1。