一句“登录失败”背后藏着两个真凶:DSH 桌面端的 cookie 堆积与时间戳漂移
一、红框里的那句话,什么也没说
下午三点半,买家发来一张截图:
DeepSeek Harness is unavailable
The application could not start or stopped unexpectedly.
desktop welcome: Web authentication failed
三天前我刚给他清过一次 cookie,那次就好了。所以第一反应是”又来一次”,把脚本再发一遍——还是失败。
我请他把崩溃日志整份发过来。日志里除了堆栈,什么都没有:
Error: desktop welcome: Web authentication failed
at connectDesktopWelcome (file:///E:/DeepSeek/resources/app.asar/lib/main.js:8886:31)
at async Object.start (file:///E:/DeepSeek/resources/app.asar/lib/main.js:12195:22)
于是我去解包那个 app.asar,想看看 connectDesktopWelcome 到底在检查什么。看完就明白了:这条报错是一条”万能垃圾桶”。
const authenticated = await send(authenticatedUrl, { credentials: "include" });
if (!authenticated.ok) throw new Error("desktop welcome: Web authentication failed");
!response.ok——只要状态码不是 2xx,无论 401、403、404、431 还是 500,用户看到的都是同一句”Web authentication failed”。它名义上叫”鉴权失败”,实际上只说明”本地服务没有正常回话”。
这就是这次排障的第一个教训:报错文本不可信,必须自己把状态码找出来。而这次,两个真凶恰好都在这个黑洞里。
二、真凶一:随机端口 × host-only cookie = 431
先看症状能不能对上。他的机器上 cookie 库是存在的,那就先看它。
lib/types/browser-auth.js 里有这么几行:
const COOKIE_PREFIX = "dsh-auth-";
function cookieName(authority) {
return COOKIE_PREFIX + encodeBase64Url(createHash("sha256").update(authority).digest());
}
cookie 的名字是 dsh-auth- 加上 authority 的哈希,而 authority 里带端口。桌面端启动时用随机端口(等价于 --port 0),于是:
- 第一次启动,
127.0.0.1:51234→ 种下dsh-auth-AbCd... - 第二次启动,
127.0.0.1:58371→ 种下另一个dsh-auth-XyZ... - 老的不会过期(有效期按天数算),也不改名、不覆盖
而这些 cookie 都是 127.0.0.1 上的 Host-only cookie。Chromium 匹配 cookie 时忽略端口——所以之后每一次请求,所有这些 dsh-auth-* 会被一并塞进 Cookie: 头。
Node 的 HTTP 解析器默认请求头上限是 16 KB(--max-http-header-size=16384)。超了,服务端直接回 431 Request Header Fields Too Large,welcome 窗口拿到 !ok → “Web authentication failed”。
我按 Chromium 的口径估了一下他库里的大小:
dsh-auth-* cookie:72 条(全部 127.0.0.1)
估算请求头占用:16128 / 16384 字节 = 98.4%
98.4%。也就是说,哪怕这次侥幸过了,再开几次也一定撞墙。这个 bug 的特征是:清一次就好,但一定会复发,而且复发周期随着使用次数线性缩短。
修法很土但有效——只删自己命名空间里的行,别的 cookie 一条都不动:
const { DatabaseSync } = require('node:sqlite');
const db = new DatabaseSync(jar); // 独占锁,必须先退出 DSH
db.exec("DELETE FROM cookies WHERE name LIKE 'dsh-auth-%'");
db.exec('VACUUM');
用 DSH 自带的 Electron 当 node 跑(ELECTRON_RUN_AS_NODE=1),不需要用户装 Python 或 Node。
三、真凶二:时间戳从”字符串”变成了”数字”
清完 cookie,我以为结束了。结果他另开一个终端跑 CLI,又冒出一串完全不同的错:
workspace: DomainError: domain 'workspace': stored record '05692f71-…'
in table 'workspaces' does not match its schema
ZodError: expected string at path ["updatedAt"], received number
workspace-controller … pending (waiting for service: workspaceRegistry)
ui-deliverables … pending (waiting for service: sessionController)
这是另一条独立的故障链:跟网络、跟 cookie 都没关系。
DSH 的持久化不是数据库,是 ~/.dsh/storages/*.json 里的纯 JSON:
{
"unit": { "name": "workspace", "version": 2 },
"tables": {
"workspaces": {
"05692f71-…": {
"path": "…",
"createdAt": "2026-10-07T14:22:06.910Z",
"updatedAt": "2026-10-07T14:22:06.950Z"
}
}
}
}
updatedAt 本该是 ISO 字符串。但某个版本(或某次异常退出)把它写成了毫秒数字 1792412821111。而读取侧是无条件校验的:
throw new DomainError("invalid-record",
`domain '${domain}': stored ${...} does not match its schema`, { detail: { table, key }, cause: error });
一条记录的字段类型不对 → 整个 table 加载失败 → workspaceRegistry 永远 pending → sessionController 跟着 pending → 插件树全线挂起。用户看到的就是”程序起不来”,一个字都进不去。
修法同样是文本级的,但有个关键约束:不要 ConvertFrom-Json | ConvertTo-Json 全量重写。后者会重排字段顺序、改缩进、顺手”规范化”别的键,属于高风险操作。正确做法是正则只替换这两个键的值:
"updatedAt": 1792412821111 → "updatedAt": "2026-10-19T12:27:01.111Z"
改前备份、改后 ConvertFrom-Json 校验、失败自动回滚。实测 8 处,一次性通过。
四、为什么”重装”和”清浏览器缓存”都没用
顺手记两条容易踩的坑:
- 重装不管用:cookie 库和
storages/*.json都在%USERPROFILE%\.dsh和 user-data-dir 里,卸载程序不删它们。重装 = 用同一个坏数据再启动一次。 - 清浏览器缓存不管用:这些 cookie 在 Electron 自己的 user-data-dir 里,跟系统浏览器一点关系都没有。
- 库不止一个:除了
<user-data-dir>\Network\Cookies,还有Partitions\<hash>\Network\Cookies。只清第一个,第二个里的照样发出去。 - DSH 运行时库是独占锁,连读都读不了。所以脚本必须先从进程
CommandLine里解析真实的--user-data-dir(绿色版可能装在E:\DeepSeek\data),结束进程,再统计、再清理。
五、给非技术用户的那一条命令
排障可以很硬核,交付必须很轻。最后给买家的是一条命令:
$z="$env:TEMP\d.zip";iwr "<url>" -OutFile $z;Expand-Archive $z "$env:TEMP\d" -Force;
powershell -NoProfile -EP Bypass -File "$env:TEMP\d\dsh-udd-scan.ps1" -Fix
分发过程本身就是一部踩坑史,记下来给以后要发给别人的人:
irm <url> | iex走不通——脚本被拦截、中文乱码,报的错和真实原因毫无关系。- PowerShell 5.1 读没有 BOM 的 UTF-8 文件会按 GBK 解码。我写的脚本里有一句
$($files.Count) 个,那个”个”字被拆成非法 token,PowerShell 报只允许将表达式作为管道的第一个元素——看起来像语法错误,其实是编码问题。给 Windows 的 .ps1,必须存 UTF-8 with BOM。 - 托管平台的坑:
.ps1后缀被拒收(只能 zip / txt),而且附件必须先被一条评论引用,对外才可读——上传完直接 GET 是 404,发评论后才 200。这些细节不写清楚,用户会以为链接坏了。
六、复盘:这次是两个 bug 打了一个掩护
把两件事拆开看,各自都不难:
| 触发条件 | 表现 | 修法 | 是否复发 | |
|---|---|---|---|---|
| cookie 堆积 | 每次启动新端口 | Web authentication failed(431) | 删 dsh-auth-* |
会,约 70 次后 |
| 时间戳漂移 | 某版本写坏了 JSON | DomainError,插件全 pending | 正则转 ISO | 不会 |
难的地方在于:它们共用同一句用户可见的文案(”起不来”)。如果没有那份完整日志,我会一直在 cookie 这条路上打转——事实上我确实打转了一轮,把脚本又发了一遍。
所以如果要给官方提建议,我只会说三件小事:
connectDesktopWelcome失败时,把status和url(token 打码)写进日志,别只写一句”authentication failed”;- 启动时清理自己命名空间的过期 cookie,或者把 cookie 名改成固定名(authority 放进签名值里)——只要名字跟端口绑定,这个 bug 就是设计出来的;
storages/*.json读取侧对数字时间戳做兼容转换。现在一次格式漂移 = 用户彻底无法启动,代价太大。
至于我这边,两分钟的脚本能修好,但真正花时间的是那句”报错文本不可信”。下次再看到一句什么信息量都没有的报错,第一件事应该是去日志里找状态码,而不是照着文案猜原因。