dsh-cookie-guard-mac

dsh-cookie-guard-mac

修 DeepSeek Harness 桌面端「用着用着突然打不开、报 Web authentication failed (431)」。 macOS 版；Windows 路径也兼容。

症状

桌面端启动几次、十几次之后，某次打开就白屏/报错：

HTTP ERROR 431
Web authentication failed

重启无效，换端口无效，清缓存也无效。

原因

桌面端每次启动都会用随机端口做登录鉴权（http://127.0.0.1:<端口>），每次都新写一条 Cookie：

name = "dsh-auth-" + base64url(sha256("127.0.0.1:" + 端口))

端口变了名字就变，而这条 Cookie 的过期时间是几十天后（expires_utc ≈ 2095）。DSH 里没有任何清理逻辑，于是每启动一次就永久多一条。

攒到 约 70 条 时，请求里的 Cookie: 头超过 Node 默认的 16 KB 请求头上限，本地 Host 直接回 431，桌面端就报 Web authentication failed，从此再也进不去。

这台机器上的实测：Cookies 库里正好 71 条 dsh-auth-*，总大小约 16 KB —— 和 431 的临界点完全对得上。

它做什么

不改 app.asar、不加启动器、不动快捷方式，只做一件事：

• DSH 启动时，插件 detach 一个后台清理器（lib/cleaner.mjs）；
• 清理器等 DSH 退出、Cookie 库真正解锁之后，删掉所有 dsh-auth-*，VACUUM 收尾，然后自己退出；
• 其他 Cookie、登录态、Local Storage 一概不碰。

下次启动就是干净的。清理器独立进程运行，所以 DSH 正常退出、崩溃、被 kill 掉了它都还能干活。

macOS 的库在哪

平台	路径
macOS	~/Library/Application Support/@deepseek-ai/dsh-desktop/Cookies
Windows	%APPDATA%\@deepseek-ai\dsh-desktop\Network\Cookies

macOS 上主库就在 profile 根目录，没有 Network/ 这一层；另外 Partitions/<hash>/Cookies 也会一起扫（通常是空的）。

为什么不用「试着重开数据库」

Windows 上 Cookie 库是强制锁，open(db, 'r+') 失败基本等于「DSH 还开着」。macOS 是 POSIX 建议锁，DSH 开着的时候别的进程一样能打开，判断会误杀。所以这里改成三条同时满足才动手：

1. 拉起清理器时记下的 Host pid / ppid 都已退出；
2. pgrep -f --user-data-dir=<profile> 没有残留进程（覆盖 Host 重启、pid 变化）；
3. Cookie 库的 mtime 已经稳定一段时间（没人在写）。

安装

dsh plugin --profile desktop add /path/to/dsh-cookie-guard-mac
# 或装打包好的 tgz
dsh plugin --profile desktop add file:/path/to/dsh-cookie-guard-mac-0.2.2.tgz

装完重启一次 DSH，插件才会加载、清理器才会挂上。

用法

插件注册了一个工具 cookie_guard：

• cookie_guard(action: "status") —— 看 Cookie 库在哪、有几条 dsh-auth-*、离 16 KB 还有多远、清理器在不在跑；
• cookie_guard(action: "clean") —— DSH 正在跑就排到退出后清；已经退出就立刻清；
• cookie_guard(action: "report") —— 生成一份可视化 HTML 报告并自动打开。

也可以完全不管它：启动时挂上、退出时清理，是自动的。

可视化报告

report 会在 profile 目录生成 cookie-guard-report.html：当前 dsh-auth-* 条数、16 KB 请求头用掉多少、离 431 还差几条、每个 Cookie 库的明细，以及从 cookie-guard.log 解析出的清理时间线（谁在什么时候删了几条）。

单文件、无外部资源、无网络请求，双击就能看，也能直接发出去当证据。报告只读库和日志，不写数据。

左侧栏看板

装好之后 DSH 左侧栏会多一个「Cookie 清理」图标，点开就是同款看板：状态、四个数字、16 KB 预算条、每个库的明细、清理时间线。数据来自 Host 注册的 GET /api/cookie-guard/snapshot（owner-only，只有本机的 DSH 页面拿得到），页面每 15 秒刷新一次，也能手动刷新。

• 每次启动自动打开：默认开启，页脚有开关（存在浏览器 localStorage，关掉后只保留左侧栏入口）；
• 返回对话：看板右上角，或直接点左侧栏里的会话；
• 看板只读 Cookie 库和日志，不改任何数据；HTML 报告（report)仍然保留，适合截图、存档、发给别人。

这是插件的浏览器半侧（lib/client.js，导出 ./client），需要 0.2.0 及以上版本。

日志与 pid 文件：

<Cookies>.guard.log    # 清理器的记录
<Cookies>.guard.pid    # 运行中的 pid，超 90 秒没刷新视为残留

配置

cordis.patch.yml 里 config 可以填：

- id: dsh-cookie-guard-mac
  name: dsh-cookie-guard-mac
  config:
    maxHours: 0   # 0 = 不限，DSH 开多久等多久；正数则按小时封顶

风险与取舍

• 删的是本机的登录 Cookie，下一次启动会重新登录/重新发一条，不影响账号本身；但如果你正开着 DSH 手动删库，会掉登录态（这也是为什么清理排在退出之后）。
• 只匹配 name like 'dsh-auth-%'，其他站点的 Cookie 不动。
• 依赖 Node 22.5+ 的 node:sqlite（DSH 桌面端自带 Node 24，满足）。
• 如果 Host 在清理器跑之前就重启了，多个清理器可能短暂并存——它们只会多清一次 0 条，无害。

卸载

dsh plugin --profile desktop remove dsh-cookie-guard-mac

然后删掉 <Cookies>.guard.log、<Cookies>.guard.pid 即可。已经清掉的 Cookie 不会回来（本来也是垃圾）。

License

MIT