前言¶
在本地部署 LLM(如 Ollama)并通过 DeepSeek Harness (DSH) 进行编排时,需要便捷的手段来监控服务状态、测试模型性能以及管理模型资源。dsh-plugin-ollama-monitor 插件通过将监控与评测功能集成到 DSH 生态中,避免了在终端与 Web 界面之间手动切换,为智能体开发提供了统一的工具链。
插件介绍¶
- 名称:dsh-plugin-ollama-monitor
- 核心价值:Ollama 监控与测评平台
- 维护者:LouisCanBe
- 许可证:MIT
- 分类:工作流
核心功能¶
该插件采用 Node 半侧与 Web 半侧结合的架构:
- Node 半侧(Agent 工具):向 DSH Agent 提供 DSH 工具,包括:
- 服务状态检查
- 模型测速
- 模型拉取与管理
- 编程评测
- Web 半侧(交互面板):在 DSH 的设置页面提供可视化的交互面板,用于直接操作和查看状态。
安装与启用¶
前提条件:本机已安装 dsh CLI。
执行以下命令安装插件:
dsh plugin --profile web add ollama-monitor
安装后必须重启该 profile。DSH 的 Bundle 增减需要重启,之后的 patch 改动支持热重载。
配置¶
插件的行 id 为 ollama-monitor,默认配置位于包内的 cordis.patch.yml。
默认配置项¶
host:http://127.0.0.1:11434(Ollama 服务地址)defaultModel:''(面板默认选中模型)defaultPrompt:用一句话解释什么是操作系统。(默认测速提示词)numPredict:128(默认最大生成 token 数)timeoutMs:300000(请求超时,单位毫秒;默认已放宽以应对大模型冷加载)
覆盖配置¶
覆盖配置需写入 ~/.dsh/cordis.patch.yml 或 profile 层。注意:patch 机制会替换整份 config,因此必须重述全部键。
- id: ollama-monitor
config:
host: 'http://127.0.0.1:11434'
defaultModel: ''
defaultPrompt: '用一句话解释什么是操作系统。'
numPredict: 128
timeoutMs: 300000
验证与卸载¶
验证配置是否生效:
dsh --profile web --dump-config
若需卸载:
dsh plugin --profile web remove ollama-monitor
注意事项¶
- Bundle 增减:安装或卸载插件后,必须重启 profile 才能生效。
- 构建依赖:若使用 Git 仓库直装,pnpm >=10 默认拒绝运行 git 依赖的
prepare构建脚本。该仓库已提交构建好的lib/,可直接使用。如需从源码重建,需在 profile 的pnpm-workspace.yaml中添加allowBuilds: ollama-monitor: true。 - 配置完整性:修改配置时,patch 文件必须重述配置对象内的所有键,否则可能导致配置丢失或冲突。
- 超时设置:大模型冷启动速度较慢,默认的
timeoutMs已调大,如遇超时可根据实际情况进一步调整。
参考链接¶
- 插件目录:https://www.skillhub.cn/plugins/LouisCanBe/dsh-plugin-ollama-monitor
- GitHub 仓库:https://github.com/LouisCanBe/dsh-plugin-ollama-monitor