NOirBRight/dsh-llm-ollama 预览 preview

NOirBRight/dsh-llm-ollama

Plugin插件 Native原生 ⭐ 5 MIT Models & Routing模型与路由

DeepSeek Harness的原生Ollama云提供商及Web配置插件

Project Overview项目介绍

This is a native DeepSeek Harness plugin that enables Ollama Cloud integration within the DSH environment. It routes chat completions through Ollama’s OpenAI-compatible endpoint using a shared pi-ai-backed adapter, while keeping model discovery, web search and content fetching capabilities on native Ollama APIs. It implements the Cordis plugin contract and adds a dedicated Ollama Cloud configuration card under DSH’s Settings > LLM Providers menu. Installation is done directly via the DSH CLI by pulling the pre-built release artifact from GitHub, so no local build step is required for end users.

To use the plugin on DSH’s web interface, you first need to install the companion dsh-llm-providers-ui package, which owns the entire LLM Providers settings page and shared order store. After installing both packages via the DSH CLI, you can navigate to the LLM Providers section in DSH settings, locate the Ollama Cloud card, enter your endpoint and authentication details, and fetch your available model list. Headless DSH deployments can use the plugin without this companion package. It is intended for DSH users who run their own Ollama instances locally or remotely.

This plugin is released under the permissive MIT license, so it is free to use, modify, and redistribute for any purpose. It has been verified to work with DSH versions from 0.1.2-alpha.4 up to 0.1.5-rc.2, and unknown newer DSH versions will show a one-time warning but still load normally. Known limitations include lack of support for GenerateOptions.stop, rejection of unsaved models, and no exposed user configuration for structured output. Check the repository releases for SHA256 checksums if you want to verify artifact integrity.

这是一个为DeepSeek Harness开发的原生插件,用于为DSH添加Ollama Cloud集成支持。聊天请求通过共享的Pi-AI适配器走Ollama的OpenAI兼容聊天补全接口,模型发现、网页搜索和获取能力仍然使用原生Ollama API。它实现了Cordis插件契约,会在DSH的设置→LLM提供商页面下添加Ollama Cloud配置项。

典型使用流程是先通过DSH的CLI从GitHub发布页安装该插件,同时需要安装配套的dsh-llm-providers-ui包(网页端必须,无头模式可以省略)。安装完成后,打开DSH设置中的LLM提供商面板,找到Ollama Cloud卡片,配置端点和认证信息,拉取可用模型列表后就可以开始使用。该插件面向需要在DSH中调用本地或云端Ollama部署的大模型的用户。

该插件遵循MIT许可,完全免费使用。目前已知限制包括不支持GenerateOptions.stop配置,不在保存目录中的模型会被拒绝,结构化输出配置暂未开放。它已经在DSH 0.1.2-alpha.4到0.1.5-rc.2多个版本验证过兼容性,未知新版本DSH会发出警告但仍正常加载。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 5 stars - very few users, little community feedback星标只有 5,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:NOirBRight/dsh-llm-ollama

把 NOirBRight/dsh-llm-ollama 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-llm-ollama

English | 中文

Ollama Cloud integration for DeepSeek Harness. Chat uses Ollama's OpenAI-compatible Chat Completions endpoint through the shared pi-ai-backed adapter. Model discovery and the Web Search/Fetch providers remain on Ollama-native APIs because those independent capabilities are not part of the chat protocol.

The package root exposes the Cordis plugin contract and OllamaAdapter. The same artifact exports ./client, which contributes the Ollama Cloud card under Settings → LLM Providers. The protocol and capability split is recorded in ADR 0001.

Ollama real API checks remain SKIP-QUOTA when the account quota is exhausted.

Compatibility

Optional DSH host peers and development dependencies accept 0.1.7-alpha.2 and later releases. Cordis peers accept >=4.0.4 <5.0.0.

Verified Hosts in package.json#dsh.compatibility.dshReleases are evidence, not an allowlist. Unknown newer Hosts warn once and keep the normal mount path. Only a reproduced failure is blocklisted.

catalogId and the unresolved unknown account state are attached at runtime. Published dsh-llm-providers-ui 0.2.8 omits those fields and treats unknown as unconnected; they only take effect on a newer Owner.

LLM Providers UI ownership

The LLM Providers Settings page (settings.section id: providers with child settings.provider.item) and the shared llm-providers order store are owned solely by dsh-llm-providers-ui.

  • This plugin contributes only its keyed card (key: llm-ollama) and its Host llm route; it does not install the page or the shared llm-providers namespace. Load order with the owner does not matter.
  • Without the owner (Headless or Web without dsh-llm-providers-ui): the Host model route ollama-cloud still works; in Web the Providers page and this card are omitted and the browser console warns that the owner is missing. A Web release composition test rejects a bundle graph that ships provider cards without the owner.
  • The nav globe glyph is a temporary Alpha.4 DOM adapter owned only by dsh-llm-providers-ui (src/client/nav-icon.ts); this plugin does not ship that adapter.

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-mcp-apps 下一个 Next dsh-kit →