dsh-wsl-hostsvc

dsh-wsl-hostsvc

Install set: part of dsh-wsl-kit. Prefer KIT_SET=daily | llm | github | full (see kit README). Fault tree: TROUBLESHOOTING.md.

DeepSeek Harness plugin: from WSL, probe Windows-host OpenAI-compatible LLM servers and suggest a reachable baseURL.

中文说明 → README.zh.md

Where it sits

From WSL, probes Windows-side Ollama, LM Studio, vLLM, and llama-server. TCP open is not the same as API ready.

flowchart LR
  agent["dsh agent"] --> tool["host_reach"] --> win["Windows local LLM ports"]

Suite diagram and version snapshot: dsh-wsl-kit. This plugin is 0.4.3 (llm; also in full). Do not copy that matrix into this README.

Compatibility

Field	Value
Plugin	dsh-wsl-hostsvc 0.4.3
Minimum dsh	≥ 0.1.2 (web UI one-shot ?token= on Windows relay :3081)
Latest verified	See dsh-wsl-kit Compatibility (currently 0.1.5-rc.1) — single source of truth for the suite
Kit set	llm / full (some also useful alone)
Cloud Flash	Use model id deepseek-flash (V4.1 Flash) in ~/.dsh/settings.yaml / llm-deepseek — not configured by this plugin
Agent Teams	Upstream experimental; not required here

Suite floor versions: kit check-plugin-versions.sh. Fault tree: TROUBLESHOOTING.md.

Scope: local OpenAI-compatible servers on the Windows host (host_reach). Does not configure cloud DeepSeek; for V4.1 Flash set model id deepseek-flash in settings.

What it does

Tool host_reach (default profile=all) probes:

id	Port	Typical server
ollama	11434	Ollama
lmstudio	1234	LM Studio local server
vllm	8000	vLLM OpenAI server
llama	8080	llama-server / Unsloth Desktop

Hosts tried: 127.0.0.1, localhost, host.docker.internal, and the Windows IP from /etc/resolv.conf.

Outputs worth pasting

• suggestedBaseURL / per-service URLs → llm-pi-ai.providers.*.baseURL (keep /v1)
• providerSnippets.yaml → paste under llm-pi-ai.providers in ~/.dsh/settings.yaml
• ollamaModels → exact ids from ollama list / /api/tags
• connectivityPlaybook → ordered tools when HTTPS/DNS also fail
• hints → Ollama n_ctx vs settings contextWindow, Unsloth Desktop vs Studio, VRAM

Template: examples/local-llm-providers.settings.yaml.

Ollama context (common 400)

Plugin-heavy dsh prompts often need >8k tokens even for a short chat turn. This is independent of cloud deepseek-flash (V4.1 Flash), which you configure under official llm-deepseek / default model — not via host_reach.

1. Set Ollama PARAMETER num_ctx 32768 (Modelfile / recreate model), or OLLAMA_NUM_CTX on Windows before starting Ollama.
2. Match contextWindow in settings to that num_ctx (not the model's theoretical max like 131072 unless Ollama actually runs it).
3. Keep maxTokens smaller than contextWindow (e.g. 4096) so the prompt still fits.

Mismatch examples:

• settings 131072 + Ollama n_ctx=8192 → API errors
• settings/Ollama both 8192 + fat system/tools prompt (~10k) → CONTEXT_WINDOW_EXCEEDED

Unsloth / Flash-Next

• Unsloth Desktop (winget) ≠ Unsloth Studio (~/.unsloth/studio). Desktop often exposes OpenAI /v1 on 8080 (llama profile).
• Multi-shard Flash-Next GGUF may need Desktop or a patched llama.cpp; plain Ollama cannot load every shard layout.
• Do not co-load Ollama + vLLM + llama-server on one 16GB GPU without headroom.

Install

# Recommended with the LLM set:
curl -fsSL https://raw.githubusercontent.com/173787247/dsh-wsl-kit/master/install.sh | KIT_SET=llm bash

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

Restart dsh web and open a new session.

WSL UI from Windows browser: use kit scripts/restart-dsh-web.sh and open http://127.0.0.1:3081/ (relay; dsh itself binds 127.0.0.1:3080 only).

Usage

Ask the agent to run host_reach (profile: ollama|lmstudio|vllm|llama|all, optional port, includeProviders).

If nothing opens: on Windows bind beyond loopback (e.g. OLLAMA_HOST=0.0.0.0:11434) or enable WSL mirrored networking, then re-probe.

License

MIT