dsh web 怎么打开？DeepSeek Harness Web 界面使用教程：功能区导览与安装插件、配置模型操作

dsh web 是 DeepSeek Harness 的 Web 操作界面：启动服务后浏览器访问 http://127.0.0.1:3080 即可使用。本文讲三种打开方式、界面功能区导览（设置、会话、插件中心、日志），以及安装插件、配置模型等常用操作流程，最后附常见问题排查表。

概览：dsh web 是什么

dsh web 是本地运行的 Web 应用，浏览器访问即用，不需要装桌面客户端。 启动后你会在一个界面里完成所有操作（来源）。四个核心功能区一览：

打开 dsh web 的三种方式

命令启动、服务常驻、直接访问，三选一即可。 三种方式：

方式一：npx 命令启动（免安装）

1. 前置条件：本机有 Node.js，终端执行 node -v 能输出版本号；
2. 打开终端，执行：

npx @deepseek-ai/dsh web

3. 首次运行自动下载并初始化 web profile，等待「服务已启动」提示；
4. 浏览器自动打开 http://127.0.0.1:3080，完成首次设置。

方式二：全局安装后直接启动

1. 前置条件：已执行过 npm install -g @deepseek-ai/dsh；
2. 终端执行 dsh web；
3. 浏览器打开 http://127.0.0.1:3080，进入界面。

方式三：服务已在运行时直接访问

1. 前置条件：dsh web 服务正在某终端运行（无论哪种方式启动）；
2. 在任意浏览器地址栏输入 http://127.0.0.1:3080，回车即可。

失败兜底：提示 dsh: command not found 说明未全局安装，改用方式一；浏览器打不开地址，先确认终端服务还在运行（关闭终端窗口会停止服务）。

功能区导览：设置、会话、插件中心、日志

按「配置 → 使用 → 扩展 → 排查」的顺序认识界面。 导览：

1. 设置页：配置模型提供方与接口密钥，是首次使用必去的地方，改端口、代理等选项也在这里；
2. 会话窗口：与模型对话、管理历史会话，是日常使用的主战场；
3. 插件中心：装好 DSH Plugin Hub 并重启后出现，浏览、安装、更新、卸载插件都在这；
4. 系统日志与诊断：查看安装、更新、卸载记录与运行诊断，排查问题看这里。

dsh-plugin-hub · 已安装

常用操作：配置模型、安装插件、查看日志

三个高频操作，一次学会。 操作步骤：

操作一：配置模型（改设置）

1. 打开设置 → 模型配置；
2. 选择提供方，填写接口地址与密钥（如 OpenAI 兼容接口）；
3. 点保存，界面提示保存成功；
4. 回到会话窗口，选择刚配置的模型开始对话。

操作二：安装插件

1. 命令行装好市场入口：dsh plugin --profile web add dsh-plugin；
2. 重启 dsh web 并刷新页面；
3. 打开设置 → 插件中心，搜索或分类找到目标插件；
4. 点卡片上的安装，在确认弹窗核对插件名与来源，点确认；
5. 实时进度完成后刷新页面，插件生效。

操作三：查看日志

1. 打开设置 → 系统日志；
2. 按分类（安装、更新、卸载、运行）与级别筛选；
3. 定位到相关记录，复制完整报错信息用于排查。

常见问题与解决

打不开、不生效、报错，先按下面的表定位。 常见问题清单：

总结速查

一句话：dsh web 界面即入口，设置里配模型、插件中心装插件、日志里查问题，打不开先确认服务在跑。 四个提醒：

1. 首次先配模型：不配置模型提供方，会话窗口无法正常使用；
2. 装插件后重启刷新：安装或卸载插件后重启 dsh web 并刷新页面，确保生效；
3. 日志留痕：任何安装、更新、卸载操作都会写进系统日志，出问题先看日志；
4. 终端别关：dsh web 服务跟随终端运行，关闭终端窗口即停止服务。

来源：DeepSeek Harness 官方文档 - Quickstart、dsh CLI README、dshplugin/dsh-plugin-hub