ChatGPTClaudeGrok / X / CursorGemini

dsh web 第一次打开的五分钟:启动命令、带令牌的访问地址、模型配置与首条消息的完整路径

安装与快速上手发布于 2026-11-02作者: DeepSeek Plugin 插件市场
dsh web首次使用令牌DeepSeek Harness访问地址
第一次用 dsh web 不需要研究全部功能。本文按分钟给出五步路径:启动并读日志、拿到带令牌的地址、配置模型、发出第一条消息、确认能停止与再次启动。

第一次用 dsh web,五分钟只需要做五件事:启动并读日志、复制带令牌的地址、配一个模型、发一条消息、确认能停下来再启动。 功能可以以后再看,这五件没走通,后面每一步都会卡。

dsh web 第 0-1 分钟:启动并读日志

启动命令只有一条,关键是读它打印的三样东西。 操作:

  1. 在终端执行 npx @deepseek-ai/dsh web;
  2. 等待首次下载与初始化,看到服务启动提示;
  3. 在日志里找三项:访问地址、端口、带令牌的完整 URL;
  4. 不要关掉终端,服务跟着这个进程运行;
  5. 如果端口被占用,换端口后重新看日志里的新地址。

日志里的 URL 才是入口。 只记端口不记令牌,下一步一定被拒。

dsh web 第 1-2 分钟:打开带令牌的地址

认证失败几乎都是因为打开了根地址。 操作:

  1. 从终端完整复制 URL,从 http 开始到参数结束;
  2. 粘贴到新标签页打开,不要用旧标签刷新;
  3. 页面能进入,说明令牌有效;
  4. 需要长期使用时收藏,但要知道重启后可能失效;
  5. 仍然失败时,换无痕窗口排除缓存干扰。

「重新打开」不等于「刷新」。 旧标签可能仍持有过期令牌,刷新只是在重复失败(来源)。

dsh web 第 2-3 分钟:配一个能用的模型

先配一个最简提供方,别一上来调参数。 三条路径任选:

  1. 官方提供方:选官方、填 API Key、选模型,发一条测试消息;
  2. 第三方网关:填网关地址与 Key,确认协议与模型名;
  3. 本地模型:填 base URL 与模型名,先确认端口可达。

第一次只验证「能出字」。 温度、输出上限、系统提示都先保持默认,把变量降到最少。

Key 不要贴在聊天窗口里。 配置入口在设置中,贴到对话里会进入会话记录。

dsh web 第 3-5 分钟:发出第一条消息,停下来再启动

第一条消息要同时验证「能回答」和「能保存」。 操作:

  1. 发一句最短的问题,例如「用一句话说明你在哪个环境」;
  2. 确认有输出,记录首 token 大概耗时;
  3. 打开 DSH_HOME(默认 ~/.dsh)下的 sessions 目录;
  4. 按时间排序,确认出现新文件;
  5. 刷新页面,确认会话仍在列表里。

界面有、磁盘没有,说明数据没落盘。 这时先别装插件,先修目录权限或 DSH_HOME 指向。

发完消息还不算完,最后一步是把服务停掉,再完整启动一次。

能停能起,才算真正跑通。 操作:

  1. 在终端按 Ctrl+C 停止服务;
  2. 确认页面刷新后无法访问,说明服务确实停了;
  3. 重新执行启动命令;
  4. 重新复制新的带令牌 URL 打开;
  5. 确认上一次的会话还在列表里。

第二次启动是对第一次的验收。 第一次能开可能是运气,第二次仍能开才说明配置稳定。

dsh web 五分钟检查表与常见卡点

五项全过,再进入功能探索。 对照:

时间动作通过标准
0-1 分启动日志里有地址与令牌
1-2 分打开带令牌 URL 能进入
2-3 分配模型测试消息有输出
3-4 分发消息有回答且 sessions 有新文件
4-5 分重启停得掉、起得来、会话还在

任何一项没过,先解决它再往下走。 带着未通过项继续操作,后面出错时无法判断是哪一层的问题。

检查表里没过的项,多半就落在下面四个卡点里。

四个卡点覆盖大多数首次失败。

  1. 打开根地址:提示认证,改复制完整 URL;
  2. 端口被占用:换成别的端口,用日志里的新地址;
  3. 模型没配:页面能进但发不出消息,去设置里配提供方;
  4. 关掉终端:服务停止属于正常,重新启动并复制新令牌。

卡点都不需要重装。 重装只解决程序缺失,不解决地址、端口与配置问题。

dsh web 下一步

跑通之后再补功能与验收。 想看界面各区域做什么,读 dsh web 怎么用;想看令牌与认证细节,读 web authentication required;想看启动命令的参数,读 npx 启动命令;想做完整体检,读 装完十分钟验收。

来源:dsh CLI README、DeepSeek Harness 官方文档、DeepSeek 官方 API 文档

ChatGPTClaudeGrok / X / CursorGemini

常见问题

dsh web 启动后直接打开 127.0.0.1:3080 提示需要认证,正确地址在哪?

dsh web 启动时会在终端打印带令牌的完整 URL,认证要打开那条地址而不是根地址。令牌在 URL 参数里,复制时要从 http 开始整段复制,直接输域名会被拒绝。

第一次打开 dsh web 页面是空白或报错,应该先检查哪两处?

dsh web 页面空白或报错时,先检查服务是否真的在监听 3080,再检查打开的是不是带令牌的地址。进程在但页面空白,通常是地址不对或端口被别的程序占用,而不是安装失败。

dsh web 里配置模型必须用官方 API 吗,能不能接本地模型?

dsh web 里配置模型不限于官方 API,也可以接第三方网关或本地模型端点。选官方提供方最省事;接本地模型需要填 base URL 与模型名,并确认端口可达。

关掉终端后 dsh web 就打不开了,下次启动地址还是一样吗?

关掉终端后 dsh web 服务随之停止,这是正常行为,不是安装问题。下次启动要重新从终端复制新的带令牌地址,令牌可能随重启变化,旧书签通常会失效。

相关术语

dsh web
dsh web 是 DeepSeek Harness 的浏览器入口,通过本地端口提供服务,默认地址是 127.0.0.1:3080。— dsh CLI README
令牌
令牌是 dsh web 启动时生成并拼进访问 URL 的凭据,用于证明请求来自被授权的客户端,重启后可能变化。— DeepSeek Harness 官方文档
模型提供方
模型提供方是实际执行推理的服务,dsh web 通过配置接入官方 API、第三方网关或本地模型。— DeepSeek 官方 API 文档
会话落盘
会话落盘是对话记录写入 DSH_HOME 下会话目录的行为,重启后仍能恢复,与只存在浏览器内存不同。— DeepSeek Harness 官方文档

来源