前言¶

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 / 幻方無官方從屬關係。