DeepSeek Harness 插件

173787247/dsh-wsl-hostsvc

Star 数 ★ 1 分类 WSL 与 Windows 互操作 收录于 2026-08-31

从 WSL 探测 Windows 上的 Ollama、LM Studio、vLLM 与 llama-server,比对 ctx,并报告 /v1/models 的 apiReady 与 TCP 是否打通。

安装

# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)

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

装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。

README

套件安装: 见 dsh-wsl-kit。推荐 KIT_SET=daily | llm | github | full。故障树:TROUBLESHOOTING.zh.md。

DeepSeek Harness 插件:在 WSL 里探测 Windows 主机上的 OpenAI 兼容本地 LLM,并给出可达的 baseURL。

English → README.md

在套件里的位置

从 WSL 探测 Windows 上的 Ollama、LM Studio、vLLM、llama-server。TCP 通了不等于 API 就绪。

flowchart LR
  agent["dsh agent"] --> tool["host_reach"] --> win["Windows 本机模型端口"]

整套关系图和版本快照:dsh-wsl-kit 中文说明。本插件是 0.4.3(llm,也在 full)。不要把那份总表抄进本 README。

兼容性

项 值
插件 dsh-wsl-hostsvc 0.4.3
最低 dsh ≥ 0.1.2(Windows 中继 :3081 一次性 ?token=)
最新验证 以 dsh-wsl-kit 兼容性 为准(当前 0.2.0-rc.2)— 套件唯一真源
套件档位 llm / full(也可单独装)
云端 Flash settings / llm-deepseek 使用 deepseek-flash(V4.1 Flash);本插件不配置模型 id
Agent Teams 上游实验包;本插件不依赖

套件版本地板:check-plugin-versions.sh。故障树:TROUBLESHOOTING.zh.md。

范围: 探测 Windows 主机上的本地 OpenAI 兼容服务(host_reach)。不管云端 DeepSeek;V4.1 Flash 请在 settings 使用模型 id deepseek-flash。

做什么

工具 host_reach(默认 profile=all)会扫:

id 端口 常见服务
ollama 11434 Ollama
lmstudio 1234 LM Studio
vllm 8000 vLLM
llama 8080 llama-server / Unsloth Desktop

探测主机:127.0.0.1、localhost、host.docker.internal,以及 /etc/resolv.conf 里的 Windows IP。

值得粘贴的字段

  • suggestedBaseURL → settings.yaml 的 baseURL(保留 /v1)
  • providerSnippets.yaml → 整段贴进 llm-pi-ai.providers
  • ollamaModels → 与 ollama list 一致的模型名
  • connectivityPlaybook → HTTPS/DNS 也坏时的工具顺序
  • hints → Ollama n_ctx、Unsloth Desktop≠Studio、显存

模板:examples/local-llm-providers.settings.yaml。

Ollama 上下文(常见 400)

插件多时,系统提示 + 工具 schema 很容易 >8k tokens。这与云端 deepseek-flash(V4.1 Flash)无关——后者在官方 llm-deepseek / 默认模型里配,不经 host_reach。

  1. Ollama 设 PARAMETER num_ctx 32768(或 Windows 启动前 OLLAMA_NUM_CTX)
  2. settings 的 contextWindow 对齐 实际 n_ctx(不要写 131072 而 Ollama 仍是 8192)
  3. maxTokens 小于窗口(如 4096),给 prompt 留空

Unsloth / Flash-Next

  • Desktop(winget)≠ Studio;Desktop 常在 :8080 提供 /v1
  • Flash-Next 多分片 GGUF:优先 Desktop / 带补丁的 llama.cpp;普通 Ollama 不一定能加载
  • 同一张 16GB 卡上不要同时硬开 Ollama + vLLM + llama-server

安装

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,开新会话。

Windows 浏览器访问 WSL 里的 UI:跑 kit 的 scripts/restart-dsh-web.sh,打开 http://127.0.0.1:3081/(中继;dsh 只绑 127.0.0.1:3080)。

用法

让 agent 跑 host_reach;可用 profile / port / includeProviders。

全 closed:Windows 侧 OLLAMA_HOST=0.0.0.0:11434 或开 mirrored networking 后再测。

许可

MIT

内容来自项目 README(GitHub)↗

链接

同类插件

查看整个分类 →

社区评论

评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。