故障排查

3080 端口被占用换 --port，git 插件被 allowBuilds 拦截改 pnpm-workspace.yaml，模型连不上查 Settings → Models 的 API Key；先 dsh --dump-config 看配置，再对症修。

本分类针对 DeepSeek Harness Plugin（DSH plugin）的常见问题给出可复现的排查步骤：3080 端口被占用时用 --port 换端口、git 托管插件被 allowBuilds 拦截时修改 pnpm-workspace.yaml、模型连不上时检查 Settings → Models 的 API Key、Web UI 打不开时改用 dsh --profile headless 跑一次性任务。每条都附官方来源，随 DeepSeek Harness 版本更新同步修订。

DSH-Plugin 教程列表

全部9概念与架构1安装与快速上手3配置与使用1更新与升级1卸载与清理1故障排查1插件开发1
故障排查2026-08-19

DSH 常见问题排查：端口 3080 占用、插件不加载、模型连不上、Web UI 空白怎么办

DSHDeepSeek HarnessDSH plugin常见问题排查

DSH 新手最容易遇到四类问题：端口 3080 被占用、插件装完不加载、模型连不上、Web UI 空白。本文给出每个问题的排查命令和解决步骤，附官方文档与配置排查工具，帮你快速跑通 DSH。

DSH 故障排查常见问题

DSH 启动时提示 3080 端口被占用怎么办？

DSH Web UI 默认监听 3080，被占用时用 dsh --profile web --port 8080 换一个端口启动即可；--port 是 web 应用的参数，写在 profile 之后。

装完 DSH plugin 却不生效，可能是什么原因？

先确认插件与当前 DSH 版本兼容；如果插件托管在 Git 上，可能被 pnpm 的 allowBuilds 安全策略拦截——在 profile 的 pnpm-workspace.yaml 里加上 allow 键后重新安装。

模型一直连不上，怎么排查？

在 设置 → 模型 里确认 API Key 已保存且选择正确，模型路由保存后即时生效；自定义端点使用 OpenAI 兼容配置，按官方文档核对 base URL 与模型名。

Web UI 打开是白屏/空白怎么办？

先检查浏览器控制台与终端日志定位阶段，再确认配置是否正确组合；如果界面无法恢复，直接用 dsh --profile headless "任务描述" 以命令行方式执行任务，绕过界面继续使用。

怎么快速确认 DSH 配置是否正确？

运行 dsh --dump-config 查看组合后的配置树，与 dsh --dump-default-config 的默认值对比；这两个命令只读不写，可以放心执行。