npx @deepseek-ai/dsh web 参数怎么用？DeepSeek Harness 启动命令、全局安装对比
npx @deepseek-ai/dsh web 是启动 DeepSeek Harness Web 界面的官方命令：npx 临时拉包、@deepseek-ai/dsh 是要跑的包、web 是要启动的子命令（来源）。 这篇把这条命令拆开讲清楚，再逐条过一遍 --port、--host、--no-open 等启动参数，最后对比它和全局安装后 dsh web 的差别。
DSH plugin 概览：npx @deepseek-ai/dsh web 这条命令由哪几段组成
npx @deepseek-ai/dsh web 可以拆成三段：执行器 npx + 包名 @deepseek-ai/dsh + 子命令 web。 拆开看每一段都承担一个明确职责：
| 片段 | 是什么 | 作用 |
|---|---|---|
npx | npm 自带的包执行器 | 临时拉包并执行，不做全局安装 |
@deepseek-ai/dsh | 官方 CLI 包名 | 要被拉取和运行的 DeepSeek Harness 命令行程序 |
web | 子命令 | 启动 Web profile，拉起 Web 界面服务 |
默认情况下，它会监听 127.0.0.1:3080，启动完成后自动打开浏览器（来源）。想改端口、换绑定地址或不让它自动开浏览器，靠的就是后面那串参数。
DSH plugin 常用启动参数逐条看：--port、--host 与 --no-open
Web 应用自带一组参数，写法是 dsh web --参数，它们会覆盖配置文件里的默认值。 关键点在于「谁解析谁」：启动器只解析自己的 flag，它认识的第一个参数之后，全部交给被启动的 web 应用解析（来源）。所以 --port 属于 web 应用，不属于启动器。
常用参数逐条如下：
--port <端口>改监听端口。 默认监听 3080，想让服务跑在别的端口就显式传，例如dsh --profile web --port 8080；传0表示交给操作系统挑一个空闲端口。预期：终端打印出来的地址端口随之变化。--host <地址>改绑定地址。 只接受本机某个具体网卡的 IPv4 / IPv6 字面量，通配地址会被拒绝。预期：服务只在你指定的那个地址上监听，而不是默认的127.0.0.1。--no-open不自动打开浏览器。 服务器起来了但不想弹出浏览器（远程机、脚本里启动）时用它。预期：终端照常打印地址，但浏览器不会被拉起。--public-url <url>对外广播的访问根。 反代或隧道场景下，让打印出来的地址、DSH_WEB_URL等都指向这个根，方便复制。预期：复制地址时拿到的是你对外暴露的那个域名。--trusted-host <authority>追加可信来源。/api的浏览器可信栅栏只接受白名单里的 authority，需要额外放行时重复传这个参数。预期：来自该来源的请求不再被栅栏拦下。-h, --help只看帮助。 运行dsh web --help打印的是 web 应用自己的参数说明，而不是启动器的帮助，也不会真的启动服务。
一条命令拆开看的一个最小例子：
# 换到 8080 端口，且不自动开浏览器，适合在远程机器上常驻
npx @deepseek-ai/dsh web --port 8080 --no-open
参数写错会怎样？解析器会在启动前拒绝非法值，进程打印错误并以非零码退出，不会带着错的配置跑起来（来源）。比如把端口传成字母，命令直接报错；想看全部可用参数，先跑 dsh web --help。
DSH plugin 与全局安装后 dsh web 的差别
npx 与全局安装读的是同一份数据，区别只在「要不要每次拉包」和启动速度。 对照表：
| 维度 | npx 方式 | 全局安装后 dsh web |
|---|---|---|
| 是否安装 | 不装，按需拉包 | npm install -g @deepseek-ai/dsh 装一次 |
| 版本 | 每次自动最新 | 需手动更新 |
| 启动速度 | 首次慢，之后走缓存 | 直接 dsh web，最快 |
| 常用命令 | 每条都要带 npx @deepseek-ai/dsh | 直接用 dsh plugin ... 等子命令 |
| 数据目录 | 同一个 | 同一个 |
选择很简单：偶尔用、想快速体验，走 npx；天天用、还要用 dsh plugin 反复管理插件，就全局装一次。装好之后，下一步是把它接进插件生态：
- 执行
dsh plugin --profile web add dsh-plugin，把 DSH Plugin Hub 装进 web profile； - 重启
dsh web，打开设置 → 插件市场； - 在市场里按分类浏览、一键安装社区插件。
与其每次手敲一长串 npx 命令、再自己记参数和端口，不如全局安装一次、把插件市场接进来，让 DSH插件（DeepSeek插件）的安装、卸载、更新都在可视化界面里点一下完成。
使用 DSH plugin 的注意事项
这几条是配置 DSH plugin 启动 Web 服务时最容易踩的坑。 逐条如下：
- 参数属于谁：
--port、--host、--no-open是 web 应用的参数；启动器自己的 flag 用dsh --help看，两者的帮助不是一个。 - 参数胜过配置：flag 的值一旦传入就覆盖配置文件里的默认值，且启动时只解析一次，不会被后续配置重载悄悄改回。
- 通配地址被拒：
--host只接受本机具体地址字面量，别指望用它做广泛监听。 - 别关终端：npx 启动的服务跟着终端进程走，关窗口即停；要常驻就全局安装并后台运行。
- 端口冲突先看默认：改端口前先确认 3080 没被别的进程占用，报错时优先核对
--port写法和占用情况。
来源：dsh CLI README、dsh-cmdline README、dshplugin/dsh-plugin-hub
常见问题
DeepSeek Harness 的这条启动命令三段各司其职：npx 负责临时拉包并执行，@deepseek-ai/dsh 是要运行的包名，web 是要启动的子命令。 npx 不去全局安装，每次按需从 npm 取包；web 子命令让 DeepSeek Harness 启动 Web profile。所以它本质是「不安装、直接跑最新版的 Web 界面」。
DeepSeek Harness 的 Web 应用参数可以直接覆盖默认值：--port 改监听端口，--no-open 不自动打开浏览器。 Web profile 默认监听 127.0.0.1:3080，例如 dsh --profile web --port 8080 会让服务跑在 8080；参数优先级高于配置文件里的默认值。
npx 每次都走一遍拉包流程，但第二次起命中 npm 本地缓存，所以第二次启动 DeepSeek Harness 明显更快。 想彻底省掉这一步，用 npm install -g @deepseek-ai/dsh 全局安装，之后直接运行 dsh web，启动最快，还能随时用 dsh 命令管理插件。
DeepSeek Harness 启动时，写错的参数会被参数解析器拒绝：进程打印错误并以非零码退出，不会带着错误配置启动。 比如把端口写成非数字，命令会报错退出；想先看有哪些可用参数，运行 dsh web --help 打印 web 应用自己的帮助，而不是启动服务。
共用的：两种方式读同一个数据目录，DSH plugin、密钥与会话完全互通。 无论走 npx 还是全局安装，profile、插件与配置都落在 DSH_HOME 下，切换启动方式不会丢数据；区别只在「要不要每次拉包」和启动速度。
相关术语
- npx
- npx 是 npm 附带的包执行器，用于临时下载并运行一个 npm 包而不做全局安装。它让 npx @deepseek-ai/dsh web 这类命令无需先装即可执行。— dsh CLI README
- dsh web（web 子命令）
- dsh web 是 DeepSeek Harness 启动 Web profile 的子命令，会拉起 Web 界面服务。它默认监听 127.0.0.1:3080，等价于 dsh --profile web。— dsh CLI README
- --port（监听端口）
- --port 是 Web 应用参数，用于指定服务监听端口，覆盖配置里的默认值 3080。传 0 时交给操作系统挑一个空闲端口。— dsh-cmdline README
- --no-open
- --no-open 是 Web 应用参数，作用是启动后不自动用默认浏览器打开 Web UI。适合在远程或脚本环境里启动服务。— dsh-cmdline README
来源
- dsh CLI README· deepseek-ai
- dsh-cmdline README（应用命令行参数如何覆盖配置）· deepseek-ai
- dshplugin/dsh-plugin-hub· dshplugin