DeepSeek Harness 地址打不开？127.0.0.1:3080 变体与 DSH plugin 端口排查

复制出来的 DeepSeek Harness 地址打不开，八成不是服务坏了，而是地址本身被抄错了：中文全角冒号、丢了 http://、混入空格换行，或把终端的 dsh web: 前缀也一起复制（来源）。 这篇先按「地址被抄错」这一支把问题解决，再给出地址无误时的排查顺序。

DSH plugin 概览：先分清「地址错」还是「服务没起来」

地址打不开只有两大类原因：要么地址字符串本身不合法，要么地址合法但服务/端口有问题。 两者的现象不同、处理顺序也不同：

一句话：先花十秒核对地址，比反复重启服务有效得多。

DSH plugin 为什么复制出来的地址打不开：四种常见的抄错方式

这段地址里每个字符都要精确，任何一个字符错位都会让浏览器解析失败。 逐条对照四种抄错方式：

1. 中文全角冒号。地址被写成 127.0.0.1：3080（冒号是全角 ：）而不是 127.0.0.1:3080（半角 :）。预期：把全角冒号换成半角后能正常打开。中文输入法下冒号默认是全角，手动输入时最容易中招。
2. 丢了协议头 http://。只写了 127.0.0.1:3080。预期：多数浏览器能自动补全成 http，但补全行为不可靠，可能被当成搜索词或用 https 去连而失败；稳妥起见显式写全。
3. 混入空格或换行。从聊天窗口、文档里复制时，地址中间夹了空格，或末尾带了换行。预期：地址栏里出现空格即意味着地址非法，删掉多余空白。
4. 把终端前缀一起复制。终端的提示是 dsh web: http://127.0.0.1:3080，整行粘贴时前面那段 dsh web: 也被带进去了。预期：只保留 http:// 之后的部分即可。dsh web: 只是提示前缀，不属于地址。

四种错误的共同点是：地址字符串不合法或多了内容，浏览器压根没机会去连服务，所以怎么重启服务都没用。

DSH plugin 正确地址长什么样、怎么核对

正确地址的规范写法是 http://127.0.0.1:3080——协议头 + 回环地址 + 半角冒号 + 默认端口。 按下面四步核对：

1. 看协议头：地址应以 http:// 开头。预期：协议头齐全，不是直接以数字开头。
2. 看冒号：127.0.0.1 与 3080 之间必须是半角 :。预期：冒号窄、居中；全角的 ： 更宽、偏左，一眼能分辨。
3. 看有没有多余字符：确认没有空格、换行，也没有 dsh web: 之类的前缀。预期：整串地址在地址栏里连续、无空白。
4. 看端口号对不对：默认是 3080；如果你启动时改过端口（--port），这里要跟着换成新端口。预期：地址里的端口与启动日志里打印的端口一致。

对照表（错误写法 → 正确写法）：

DSH plugin 地址对但仍打不开：按序排查

如果地址写法没问题却依然打不开，说明问题在「服务与端口」这一侧，按顺序往下查。 四步排查：

1. 确认进程还在运行。回到启动 dsh web 的那个终端窗口，看服务是否还活着。预期：终端仍显示运行日志；如果窗口被关或进程退出，重新执行 npx @deepseek-ai/dsh web 或 dsh web。
2. 确认端口没被占用。端口被别的程序占了，服务可能起不来或换了端口。macOS / Linux 用 lsof -i :3080，Windows 用 netstat -ano | findstr :3080。预期：占用者不是当前服务时，先释放它，或改用 dsh web --port 8080 换端口并同步改地址。
3. 看是不是认证提示。如果页面能连上却显示 authentication required，那属于浏览器会话失效，不是地址问题。预期：重启进程、用新打印的带令牌地址重新打开一次即可恢复，机制见《dsh web 认证与端口》。
4. 排除代理与浏览器干扰。全局代理把 127.0.0.1 也转发出去会拦截本地地址；个别浏览器缓存也会挡。预期：把本机地址加入直连规则，或用无痕窗口重试；端口与连接被拒的完整排查见《127.0.0.1:3080 打不开》。

确认地址能用之后，下一步是把它接进插件生态：用 DSH Plugin Hub 在市场里浏览、一键安装与管理 DeepSeek Harness 插件，比手动敲命令省心。

使用 DSH plugin 的注意事项

这几条是排查 DSH插件（DeepSeek插件）地址问题时的常见注意点。 逐条如下：

1. 复制后先扫一眼冒号：全角 ： 是最高频的抄错，中文输入环境下尤其要注意。
2. 地址带前缀就等于带垃圾：dsh web: 只是提示标签，粘贴前删掉。
3. 协议头写全：别依赖浏览器自动补全，显式 http:// 最稳。
4. 改过端口就改地址：--port 换过端口后，地址里的端口要跟着变，否则连的是空端口。
5. 认证与连接被拒要分开：一个是会话失效，一个是没人在监听，处理方式完全不同。

来源：dsh CLI README、dsh-cmdline README、dshplugin/dsh-plugin-hub