DeepSeek Harness 快速入门发出去没反应:模型、工作区、审批与进程四类分诊顺序
DeepSeek Harness 发出去没反应,最怕的不是问题本身,而是一上来就翻日志。 日志信息多、层级深,第一次使用时很难从里面判断方向;界面状态反而更直接:输入框能不能输入、消息有没有发出去、有没有弹窗、进程还在不在。这四个观察点能把问题缩到一类,再决定看哪里。
DeepSeek Harness 先看界面状态,不要先看日志
界面状态是分诊的第一层证据,日志是第二层。 原因很简单:四类停住在界面上的表现不同,而在日志里可能都只是「没有新记录」。先看界面,能用几秒钟排除掉大部分方向。(来源)
具体看四个点:
- 输入框 — 能不能聚焦、能不能敲字;
- 发送动作 — 消息有没有真的发出去,还是点了没反应;
- 弹窗 — 有没有待处理的审批或提问;
- 进程 — 启动终端还在不在,最后一行是什么。
这四个点对应四种状态,下面逐类展开。先不要打开日志,也不要在页面里连续重试;重试会覆盖当前状态,让你更难判断第一次失败发生在哪。
日志会骗人,是因为它记录的是「发生了什么」,不记录「用户看到什么」。同一段没有新日志的时间,可能是模型在思考、审批在等待、进程已经退出,也可能是请求根本没发出去。界面状态能补上「用户看到什么」这一层,两者结合才有意义。
DeepSeek Harness 四象限:四种停住的表面差异
把「能不能输入」和「有没有发出」交叉,就能得到一张四象限表。 这张表是本篇的主干(来源):
| 现象 | 最可能的原因 | 一个最小验证动作 | 下一步 |
|---|---|---|---|
| 输入框灰、敲不进字 | 工作区未选或默认模型悬空 | 看选择工作区与模型选择器 | 回到输入框状态排查 |
| 能输入、发出去无返回 | 模型、凭据、端点或网络 | 看错误码,换最短任务 | 按模型错误排查 |
| 能输入、任务停在弹窗 | 审批或用户提问在等待 | 看弹窗内容并处理 | 按审批分支处理 |
| 页面在、进程已退出 | 进程崩溃或被关闭 | 看启动终端最后几行 | 重新启动并查退出原因 |
这张表的价值是「一类一个动作」。不要用同一个动作对付四行:刷新页面可能对缓存有效,但解决不了工作区未选、审批等待或进程退出;重启进程可能对崩溃有效,但会把审批等待和模型错误的状态一起丢掉。
还有一种不在表里的情况:任务正常但很慢。判断它是不是「慢」而不是「停」,看有没有持续的信号变化,例如计划更新、命令输出、文件变更。如果完全没有任何变化,不要用「再等等」安慰自己,回到四象限分类;如果有变化,先给它时间,同时盯着下一次信号。
先分类,再动手。分类花十秒,能省掉后面半小时的瞎试。
DeepSeek Harness 输入框不可用:回到工作区与模型
输入框不能输入,先看两件事:有没有选中工作区,默认模型是不是悬空。 官方说明:全新的 Web UI 不会选中任何工作区,选中前会话输入框不可用;如果已保存的默认值指向已删除的提供商,输入框会显示「选择模型」并阻止输入(来源)。
这两个原因的表现略有不同:工作区未选时,输入框整体不可用;默认模型悬空时,输入框位置会提示选择模型。两者都属于「真阻止」,处理方式也简单:先选工作区,再选一个可用模型。
如果你已经选过工作区、也选过模型,输入框仍然不可用,再看两个小范围可能:当前页面是不是连着一个已失效的旧会话;目录是不是被移动或权限变化。具体状态识别见《DeepSeek Harness 会话输入框不可用怎么办》。
这一类不要去看日志。日志里通常没有「输入框为什么灰」的直接答案,界面状态才是证据。
DeepSeek Harness 可输入无返回:先验模型与凭据
能输入、消息也发出去了,但没有返回,问题在请求链路,不在输入框。 官方排错里最常见的两类是 MISSING_CREDENTIAL 和 UNKNOWN_MODEL:前者表示没有可用凭据,后者表示选择的模型不在已配置列表里(来源)。
最小验证动作有三步:
- 看错误码 — 有明确错误码就按错误码查,不要凭现象猜;
- 换最短任务 — 用一句话任务排除任务本身太长或太复杂;
- 换模型 — 换一个已配置模型能成功,问题就在原模型的凭据或端点上。
还要区分「配置问题」和「网络问题」:MISSING_CREDENTIAL、UNKNOWN_MODEL、401 更偏配置;连接超时、端点不可达、证书错误更偏网络。两类排查方向不同,不要混在一起。
最短任务可以直接用一句「用一句话说明当前目录是什么项目」。它足够短,不会因为任务复杂而超时;又足够具体,能看出模型有没有真正读到工作区。如果这句话也失败,问题基本不在任务描述。
具体错误对照见《DeepSeek Harness 模型报错怎么排查》。如果是页面根本打不开、白屏或连接失败,那属于访问问题,见《DeepSeek Harness Web UI 打不开、白屏排查》。
DeepSeek Harness 弹窗等待与进程退出:两种完全不同的停
弹窗等待和进程退出看起来都是「不动」,但一个在等用户,一个已经没有执行者。 这两种最容易误判,因为界面都可能看起来正常。(来源)
弹窗等待的特征是:界面上有一个明确的询问,任务没有继续,但进程还在、页面还能操作。这不是卡死,而是审批或用户提问在等你的决定。处理方式是读询问、做选择,而不是杀进程。审批的四种结果见《DeepSeek Harness 第一次弹审批怎么选》。
进程退出的特征是:页面可能还开着,但发送没有反应,终端里进程已经不在了。这时页面展示的是旧状态,任何重试都不会真正发出请求。正确动作是回到启动终端,看最后几行输出和退出原因,再重新启动。启动到首条消息的完整路径见《dsh web 第一次打开的五分钟》。
两者的分界是「有没有执行者」:进程在,问题在等待或配置;进程不在,问题在启动或崩溃。先确认进程,再谈其他。
DeepSeek Harness 什么时候该看日志、什么时候该重启
日志和重启都不是第一步,它们有明确的使用时机。 给出三条判断(来源):
- 界面状态已经分类,但同类内无法继续缩小 — 这时看日志,带着「哪一类」去看,而不是漫无目的地翻;
- 进程已经退出或反复退出 — 先看终端输出,再决定是否重启;重启前尽量保留最后一段输出;
- 同一操作稳定复现,且换会话、换模型都无效 — 可以考虑重启,但要先记录复现步骤,避免重启后丢失现场。
不建议的做法是:一没反应就重启、一没反应就清缓存、一没反应就连点发送。这三个动作都会改变状态,让你失去第一次失败时的证据。
分诊的目标不是「马上修好」,而是「知道下一步查哪里」。四类里先定一类,再按那一类的最小验证动作走,通常比盲目试错快得多。四道门的整体判据可以对照《DeepSeek Harness 快速入门四道门》。
如果一类里试了两个动作仍无进展,记录「现象 + 已试动作 + 结果」再往下走。下一次遇到同样现象时,这份记录比重新猜更快。
常见问题
DeepSeek Harness 里,先看界面状态,不要先翻日志。DeepSeek Harness 的没反应分为输入框不可用、可输入无返回、审批等待、进程已退出四类,界面状态能直接把范围缩到一类。
DeepSeek Harness 里两者都可能。先看错误码:MISSING_CREDENTIAL 或 UNKNOWN_MODEL 指向配置,连接失败或超时更像网络或端点;换一个已配置模型能成功,则问题在原模型的凭据或模型 ID。
DeepSeek Harness 里不是这样。DeepSeek Harness 的审批等待是任务在等你决定,不是进程卡死。先处理弹窗里的批准、拒绝或取消,再判断任务是否继续。
DeepSeek Harness 里,回到启动终端看输出和退出原因,再重新启动。DeepSeek Harness 的页面可能还停留在旧状态,但请求已经发不出去;不要在页面里反复重试,先确认进程是否活着。
相关术语
- 四类分诊
- 四类分诊是把 DeepSeek Harness 的没反应分成输入框不可用、可输入无返回、审批等待和进程已退出四种状态,每类对应不同的最小验证动作。— DeepSeek Harness 官方文档 - 使用 Web UI
- 可输入无返回
- 可输入无返回是输入框正常、消息也能发送,但请求没有完成的状态,问题通常在模型、凭据、端点或网络。— DeepSeek Harness 官方文档 - 配置模型
- 审批等待
- 审批等待是 DeepSeek Harness 任务停在审批询问上的状态,表示 agent 在等用户批准、拒绝或取消,不是进程卡死。— DeepSeek Harness 官方文档 - 审批
- 进程退出
- 进程退出是 dsh 进程已经结束、页面可能仍在但请求无法完成的状态;应先看启动终端输出,再重新启动。— DeepSeek Harness 官方文档 - 使用 Web UI
来源
- DeepSeek Harness 官方文档 - 使用 Web UI· deepseek-harness
- DeepSeek Harness 官方文档 - 配置模型· deepseek-harness
- DeepSeek Harness 官方文档 - 审批· deepseek-ai