【工具】DSH 启动崩溃一键修复（Windows）：HTTP 431 / Web authentication failed / 白屏 / 插件加载卡住 —— one-click repair, open source

[chuyu0629]

社区工具，不是官方项目，与 DeepSeek 官方无关。作者只在 Windows 11 + DSH 0.2.2-rc.1 上验证过。

一句话：DSH 起不来了（HTTP 431 / Web authentication failed / 白屏 / 卡在加载插件），双击一个 exe，它读日志、分类、按症处理，把界面拉回来。纯本地、不联网、开源、每次改动先备份。

30 秒上手

1. 下载：https://github.com/chuyu0629/dsh-relief/releases/latest   （DshRelief.exe）
2. 双击 → 点「开始修复」
3. 修完它自己启动 DSH；失败就点「导出诊断包」把日志发到本帖

不想跑没签名的 exe？exe 只是把 12 个纯文本脚本解包后调用，克隆仓库一样能用：

git clone https://github.com/chuyu0629/dsh-relief
powershell -NoProfile -ExecutionPolicy Bypass -File .\dsh-repair.ps1 -DryRun   # 先看它打算改什么
powershell -NoProfile -ExecutionPolicy Bypass -File .\dsh-repair.ps1           # 真跑

先确认是不是我这个工具管的范围

你的现象	归谁管
HTTP 431 / Web authentication failed / 401（启动几次、几十次后突然打不开）	是（cookie 库不重置，重装解决不了）
白屏、窗口出来但界面空、GPU process isn't usable	是
卡在「正在加载插件」、启动一半退出、某个插件装完就起不来	是（按日志点名摘插件，可 -Undo）
端口被占 / 界面连不上 / 残留进程	是
STATUS_BREAKPOINT、v8Snapshot、本体文件损坏	不是，直接告诉你重装本体，别修
驱动、运行库、磁盘满、权限、杀软拦截、账号与网络	不是，不是这个工具的事

它实际会处理的情况（都是真实踩过的）

症状	处理方式
Web authentication failed / 401 / 431	登录缓存目录改名备份 + 重置 cookie 库（注意：重装解决不了这个，%APPDATA% 里的 SQLite 不会被重装清掉）
白屏、窗口出来但界面空	清渲染缓存；必要时 --disable-gpu 启动
端口被占 / 界面连不上	结束残留进程；检测是否落在 Hyper-V 保留端口段
卡在「正在加载插件」、启动一半退出	二轮阶梯：按日志点名的插件精准摘除（改动前备份、可 -Undo）→ 仍不行进安全模式只留官方插件
GPU process isn't usable / Unable to move the cache: Access is denied	禁用 GPU 启动 / 缓存目录改名重建

分成 26 类，能对上就对症处理，对不上只做无害的清理 + 重启。所有改动前写备份，产出全部在 %LOCALAPPDATA%\DshRelief\，可一键回滚。

它修不了什么（别指望）

• 本体文件损坏、STATUS_BREAKPOINT / v8Snapshot 一类 —— 会直接停下来告诉你「别修了，重装本体」
• 系统级问题：驱动、运行库、磁盘满、权限、杀软拦截
• 数据目录被删且没备份
• 账号 / 网络类问题

English (short)

One-click repair tool for DeepSeek Harness desktop on Windows: it reads the last 8 crash logs, classifies the failure into 26 categories, and fixes the common ones — HTTP 431 / "Web authentication failed" cookie overflow, blank window, GPU/cache errors, stuck plugin loading, occupied port. Fully local, no network calls, every change backed up and reversible. Open source (MIT). Not affiliated with DeepSeek.

下载与源码

• 仓库：https://github.com/chuyu0629/dsh-relief （MIT）
• 下载：https://github.com/chuyu0629/dsh-relief/releases/latest

反馈

有没覆盖到的崩溃，把 diag classes: 那行和报错原文贴到本帖或仓库 issue，能加的会加进去。

免责声明

• 非官方项目：与 DeepSeek / DeepSeek Harness 官方无任何关系，未经官方认可或背书。
• 按现状提供（AS IS）：不保证在你的机器上一定能修好，也不保证不会引入新问题。
• 它会改动你的电脑：修改 DSH 的 profile 配置（package.json / cordis.patch.yml），可能改名 %APPDATA%\@deepseek-ai\dsh-desktop 与 cookie 库，清理渲染缓存。每次改动前都会备份，但请在使用前自行确认重要数据已有备份/同步。
• 不联网、不收集数据：除启动 DSH 本体外不发起网络请求，不上传日志、路径、凭据。
• 无代码签名：可能被 SmartScreen 或杀软拦截/误报。请核对 Release 里的 SHA256，或不用 exe、克隆仓库跑脚本。
• 责任：因使用本工具导致的配置丢失、会话丢失、时间损失等，作者不承担赔偿责任；许可条款见 MIT License。

继续使用即表示你已理解上述风险。