一、红框里的那句话,什么也没说

下午三点半,买家发来一张截图:

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”。它名义上叫”鉴权失败”,实际上只说明”本地服务没有正常回话”。

这就是这次排障的第一个教训:报错文本不可信,必须自己把状态码找出来。而这次,两个真凶恰好都在这个黑洞里。

先看症状能不能对上。他的机器上 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

分发过程本身就是一部踩坑史,记下来给以后要发给别人的人:

  1. irm <url> | iex 走不通——脚本被拦截、中文乱码,报的错和真实原因毫无关系。
  2. PowerShell 5.1 读没有 BOM 的 UTF-8 文件会按 GBK 解码。我写的脚本里有一句 $($files.Count) 个,那个”个”字被拆成非法 token,PowerShell 报 只允许将表达式作为管道的第一个元素——看起来像语法错误,其实是编码问题。给 Windows 的 .ps1,必须存 UTF-8 with BOM。
  3. 托管平台的坑:.ps1 后缀被拒收(只能 zip / txt),而且附件必须先被一条评论引用,对外才可读——上传完直接 GET 是 404,发评论后才 200。这些细节不写清楚,用户会以为链接坏了。

六、复盘:这次是两个 bug 打了一个掩护

把两件事拆开看,各自都不难:

  触发条件 表现 修法 是否复发
cookie 堆积 每次启动新端口 Web authentication failed(431) 删 dsh-auth-* 会,约 70 次后
时间戳漂移 某版本写坏了 JSON DomainError,插件全 pending 正则转 ISO 不会

难的地方在于:它们共用同一句用户可见的文案(”起不来”)。如果没有那份完整日志,我会一直在 cookie 这条路上打转——事实上我确实打转了一轮,把脚本又发了一遍。

所以如果要给官方提建议,我只会说三件小事:

  1. connectDesktopWelcome 失败时,把 status 和 url(token 打码)写进日志,别只写一句”authentication failed”;
  2. 启动时清理自己命名空间的过期 cookie,或者把 cookie 名改成固定名(authority 放进签名值里)——只要名字跟端口绑定,这个 bug 就是设计出来的;
  3. storages/*.json 读取侧对数字时间戳做兼容转换。现在一次格式漂移 = 用户彻底无法启动,代价太大。

至于我这边,两分钟的脚本能修好,但真正花时间的是那句”报错文本不可信”。下次再看到一句什么信息量都没有的报错,第一件事应该是去日志里找状态码,而不是照着文案猜原因。