dsh web 第一次打开的五分钟:启动命令、带令牌的访问地址、模型配置与首条消息的完整路径
第一次用 dsh web,五分钟只需要做五件事:启动并读日志、复制带令牌的地址、配一个模型、发一条消息、确认能停下来再启动。 功能可以以后再看,这五件没走通,后面每一步都会卡。
dsh web 第 0-1 分钟:启动并读日志
启动命令只有一条,关键是读它打印的三样东西。 操作:
- 在终端执行
npx @deepseek-ai/dsh web; - 等待首次下载与初始化,看到服务启动提示;
- 在日志里找三项:访问地址、端口、带令牌的完整 URL;
- 不要关掉终端,服务跟着这个进程运行;
- 如果端口被占用,换端口后重新看日志里的新地址。
日志里的 URL 才是入口。 只记端口不记令牌,下一步一定被拒。
dsh web 第 1-2 分钟:打开带令牌的地址
认证失败几乎都是因为打开了根地址。 操作:
- 从终端完整复制 URL,从
http开始到参数结束; - 粘贴到新标签页打开,不要用旧标签刷新;
- 页面能进入,说明令牌有效;
- 需要长期使用时收藏,但要知道重启后可能失效;
- 仍然失败时,换无痕窗口排除缓存干扰。
「重新打开」不等于「刷新」。 旧标签可能仍持有过期令牌,刷新只是在重复失败(来源)。
dsh web 第 2-3 分钟:配一个能用的模型
先配一个最简提供方,别一上来调参数。 三条路径任选:
- 官方提供方:选官方、填 API Key、选模型,发一条测试消息;
- 第三方网关:填网关地址与 Key,确认协议与模型名;
- 本地模型:填 base URL 与模型名,先确认端口可达。
第一次只验证「能出字」。 温度、输出上限、系统提示都先保持默认,把变量降到最少。
Key 不要贴在聊天窗口里。 配置入口在设置中,贴到对话里会进入会话记录。
dsh web 第 3-5 分钟:发出第一条消息,停下来再启动
第一条消息要同时验证「能回答」和「能保存」。 操作:
- 发一句最短的问题,例如「用一句话说明你在哪个环境」;
- 确认有输出,记录首 token 大概耗时;
- 打开 DSH_HOME(默认
~/.dsh)下的 sessions 目录; - 按时间排序,确认出现新文件;
- 刷新页面,确认会话仍在列表里。
界面有、磁盘没有,说明数据没落盘。 这时先别装插件,先修目录权限或 DSH_HOME 指向。
发完消息还不算完,最后一步是把服务停掉,再完整启动一次。
能停能起,才算真正跑通。 操作:
- 在终端按 Ctrl+C 停止服务;
- 确认页面刷新后无法访问,说明服务确实停了;
- 重新执行启动命令;
- 重新复制新的带令牌 URL 打开;
- 确认上一次的会话还在列表里。
第二次启动是对第一次的验收。 第一次能开可能是运气,第二次仍能开才说明配置稳定。
dsh web 五分钟检查表与常见卡点
五项全过,再进入功能探索。 对照:
| 时间 | 动作 | 通过标准 |
|---|---|---|
| 0-1 分 | 启动 | 日志里有地址与令牌 |
| 1-2 分 | 打开 | 带令牌 URL 能进入 |
| 2-3 分 | 配模型 | 测试消息有输出 |
| 3-4 分 | 发消息 | 有回答且 sessions 有新文件 |
| 4-5 分 | 重启 | 停得掉、起得来、会话还在 |
任何一项没过,先解决它再往下走。 带着未通过项继续操作,后面出错时无法判断是哪一层的问题。
检查表里没过的项,多半就落在下面四个卡点里。
四个卡点覆盖大多数首次失败。
- 打开根地址:提示认证,改复制完整 URL;
- 端口被占用:换成别的端口,用日志里的新地址;
- 模型没配:页面能进但发不出消息,去设置里配提供方;
- 关掉终端:服务停止属于正常,重新启动并复制新令牌。
卡点都不需要重装。 重装只解决程序缺失,不解决地址、端口与配置问题。
dsh web 下一步
跑通之后再补功能与验收。 想看界面各区域做什么,读 dsh web 怎么用;想看令牌与认证细节,读 web authentication required;想看启动命令的参数,读 npx 启动命令;想做完整体检,读 装完十分钟验收。
常见问题
dsh web 启动时会在终端打印带令牌的完整 URL,认证要打开那条地址而不是根地址。令牌在 URL 参数里,复制时要从 http 开始整段复制,直接输域名会被拒绝。
dsh web 页面空白或报错时,先检查服务是否真的在监听 3080,再检查打开的是不是带令牌的地址。进程在但页面空白,通常是地址不对或端口被别的程序占用,而不是安装失败。
dsh web 里配置模型不限于官方 API,也可以接第三方网关或本地模型端点。选官方提供方最省事;接本地模型需要填 base URL 与模型名,并确认端口可达。
关掉终端后 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 官方文档
来源
- dsh CLI README· deepseek-ai
- DeepSeek Harness 官方文档· deepseek-harness
- DeepSeek 官方 API 文档· DeepSeek