DeepSeek Harness 装完怎么验收:端口、会话、插件与模型四张十分钟验收单分别怎么过
DeepSeek Harness 装完的标准不是「命令没报错」,而是四张验收单全部通过:端口可用、会话落盘、插件能装能卸、模型调用成功。 任何一张没测,故障都会在你以为装好的时候才出现。
DeepSeek Harness 装完为什么必须验收
安装命令的退出码只说明流程走完,不说明组件协同正常;验收的作用是把「整体感觉」拆成四个可判定的点。 端口可能被占用、插件可能装进别的 profile、模型可能没配,每个点都有明确的失败信号,出问题时不用重新猜。
四张单有依赖顺序,先看清每张的判据再动手。 对照如下:
| 验收单 | 一句话标准 | 失败信号 |
|---|---|---|
| 端口 | 3080 可访问且重启后仍在 | 打不开、重启后失效 |
| 会话 | 发消息后 DSH_HOME 有新文件 | 界面有、磁盘没有 |
| 插件 | 能装、有入口、能卸载干净 | 列表有但无入口、卸不干净 |
| 模型 | 一次调用成功且错误可读 | 一直转圈、401/404 |
顺序的意义:后一张依赖前一张。 端口不通时测模型没有意义,会话不落盘时测插件也看不出问题。
第一步:dsh web 端口验收
端口验收要包含一次重启,只看当前次不算。 操作步骤:
- 启动
dsh web,记下日志里的地址,默认是127.0.0.1:3080; - 浏览器打开,确认不是错误页或空白页;
- 执行
lsof -i :3080,确认监听进程只有一个; - 停止服务,重新启动,再次访问;
- 记录启动耗时,超过预期时留作后续对比基线。
重启后失效是最常见的假通过。 有些环境第一次能起,是因为端口恰好空闲;重启后旧进程没退干净,就会冲突。
第二步:dsh 会话落盘验收
会话验收看磁盘,不看列表。 步骤:
- 在界面发一条短消息,等回答完成;
- 打开 DSH_HOME(默认
~/.dsh)下的 sessions 目录; - 按修改时间排序,确认出现新文件;
- 打开文件,确认有本轮对话记录;
- 重启服务,确认会话仍在列表里。
界面有、磁盘没有,说明数据没落盘。 这时继续装插件、配模型都是白费,先修数据目录权限或 DSH_HOME 指向。
第三步:dsh plugin 插件验收
插件验收要包含卸载,装得上不算完整。 步骤:
- 选一个轻量插件,记录包名与 owner;
- 执行
dsh plugin --profile web add <包名>,确认无报错; - 重启后确认界面出现入口,列表里能看到;
- 卸载并重启,确认入口消失、列表不再显示;
- 检查插件目录,确认没有残留半装文件。
装得上但没入口,多半是 profile 不对或没重启。 这两类在日志里的表现不同,先看列表再判断。
第四步:dsh 模型调用验收
模型验收要覆盖一次成功和一次可读的失败。 步骤:
- 配好一个提供方,发一条最小消息,确认有输出;
- 记录首 token 时间,作为后续性能对比基线;
- 故意用错误 Key 或错误模型名发一次,确认错误信息能读懂;
- 切回正确配置,确认恢复;
- 把错误码与含义记进团队文档。
能成功但报错不可读,也算没验收完。 真正出故障时,可读的错误信息比一次成功更有价值。
dsh 验收失败怎么归类与十分钟复测清单
四张单测完,再把现象按归属分类,不要交叉猜。 对照处理:
| 现象 | 归属 | 先查 |
|---|---|---|
| 页面打不开 | 端口 | 进程、监听地址、占用 |
| 能打开但无历史 | 会话 | DSH_HOME、写权限 |
| 插件无入口 | 插件 | profile、重启、日志 |
| 消息转圈 | 模型 | Key、模型名、网络 |
| 报错看不懂 | 模型 | 日志里的上游错误 |
先定归属,再查原因。 归属错了,方法再对也解决不了。
最后用一份十分钟清单把四张单串起来复测,按下面顺序走一遍就够。 清单:
- 第 1 分钟:启动并打开 3080;
- 第 2 分钟:停止、重启、再打开;
- 第 3 分钟:发一条消息;
- 第 4 分钟:到 sessions 目录确认新文件;
- 第 5 分钟:装一个轻量插件并重启;
- 第 6 分钟:确认入口,卸载并重启;
- 第 7 分钟:配置模型并成功调用一次;
- 第 8 分钟:制造一次可读失败;
- 第 9 分钟:恢复配置并复测;
- 第 10 分钟:记录版本、耗时与错误码。
这份清单可以重复执行。 升级、换机器、换 profile 之后,用同一套标准复测,结果才可比较。
验收通过再进入日常使用。 想看安装方式怎么选,读 DeepSeek Harness 四条安装路;想看第一次安装步骤,读 第一次安装;想看插件命令,读 dsh plugin add 怎么用;想看端口与认证,读 dsh web 认证与端口。
常见问题
不算装好:DeepSeek Harness 的页面能打开只证明 web 服务起来了,消息转圈说明模型调用没通。验收要拆成端口、会话、插件、模型四张单,页面属于端口单,消息属于模型单。
插件装上没有入口,先确认装进了当前使用的 profile,再确认是否完整重启。列表里有、日志无报错、界面无入口,通常就是没重启;列表里没有,则是装错了 profile。
确认会话落盘要看 DSH_HOME 下的会话目录是否新增文件,而不是看界面列表。发一条消息后到 sessions 目录按时间排序,能看到新文件才算真正写入。
四张验收单建议按端口、会话、插件、模型的顺序做,因为后一项依赖前一项。只测模型调用会把端口与会话问题掩盖掉,真出故障时反而更难定位。
相关术语
- 验收单
- 验收单是安装完成后逐项确认可用性的清单,每一项都包含操作、预期结果与失败判据,用来替代「看起来能打开」。— DeepSeek Harness 官方文档
- profile
- profile 是 DeepSeek Harness 的具名组装环境,web、headless、desktop 各自维护独立依赖,插件装错 profile 就不会生效。— dsh CLI README
- DSH_HOME
- DSH_HOME 是 DeepSeek Harness 的数据根目录,默认 ~/.dsh,保存配置、会话、插件与凭据。— DeepSeek Harness 官方文档
- 首 token 时间
- 首 token 时间是请求发出到收到第一个输出片段的时间,用于区分模型慢、网络慢与本地处理慢。— DeepSeek Harness 官方文档
来源
- DeepSeek Harness 官方文档· deepseek-harness
- dsh CLI README· deepseek-ai
- deepseek-harness 仓库· deepseek-ai