前言¶

DeepSeek Harness (DSH) 采用「一切皆插件」的理念。在 WSL 环境下通过 DSH 调用本地 Ollama 时，通常面临网络连通性的问题。dsh-wsl-ollama 插件解决了这一痛点，它为 DSH 提供了本地 Ollama 的状态查询、模型列表、对话以及向量化能力。

插件定位¶

插件名称为 dsh-wsl-ollama，用于在 WSL 上为 DeepSeek Harness 提供 Ollama 相关功能。它是一个可选插件，不属于默认的 install.sh 流程。

安装¶

使用以下命令安装该插件：

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

安装后需重启 DSH 进程以生效。

核心能力¶

插件提供了以下四个主要工具：

• ollama_status：检查基址连通性、默认模型状态。
• ollama_list：列出本地已拉取的模型列表。
• ollama_chat：进行本地模型对话。
• ollama_embed：生成向量数据（适用于 vecmem 等场景）。

配置与用法¶

使用前需确保 Ollama 服务已在运行，默认基址为 http://127.0.0.1:11434。

网络连接问题¶

若 Ollama 运行在 Windows，而 DSH 运行在 WSL，直接使用 localhost 常会报 503 错误。解决方法有两种：

1. 让 Ollama 监听 0.0.0.0:11434。
2. 设置环境变量 DSH_OLLAMA_BASE=http://<Windows主机IP>:11434。

插件在 baseUrl 为空时，会尝试从 /etc/resolv.conf 推测主机地址。

配置项¶

在配置文件中可设置以下参数：

config:
  enabled: true
  baseUrl: ""              # 空值表示自动探测
  defaultModel: ""         # 或通过环境变量 DSH_OLLAMA_MODEL 指定
  timeoutMs: 120000
  maxPromptChars: 32000

环境变量¶

支持的环境变量包括 DSH_OLLAMA_BASE、OLLAMA_HOST 以及 DSH_OLLAMA_MODEL。

兼容性与注意事项¶

• 版本要求：插件版本为 0.2.0，依赖的 DSH 版本需 ≥ 0.1.2。
• 许可协议：遵循 MIT License。
• 生态背景：DSH 社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。