登录Cookie清理 M0Yun/dsh-cookie-guard

dsh-cookie-guard

DeepSeek Harness 桌面端（Windows）每次启动都会往 Cookie 库里多留一条登录 Cookie，从不清理。攒到约 70 条时 Cookie 请求头超过 16 KB，本地 Host 直接回 431，桌面端报 Web authentication failed——表现就是 DSH 再也打不开。

这个插件不给快捷方式加壳、不改启动方式：它在 DSH 启动时挂一个后台清理器，等 DSH 退出、Cookie 库解锁后，删掉上一轮及更早的 dsh-auth-。下一次启动就是干净的。

English · 原理 · 怎么工作 · 用法 · 局限

原理

桌面端启动 Host 后，用一个一次性 launch token 换浏览器登录 Cookie。Cookie 名来自 @deepseek-ai/dsh-client-connection：

const COOKIE_PREFIX = "dsh-auth-";
function cookieName(authority) {
return COOKIE_PREFIX + encodeBase64Url(createHash("sha256").update(authority).digest());
}
// authority = "127.0.0.1:<随机端口>"

Host 每次启动都换随机端口，所以每次启动的 Cookie 名都不一样；Max-Age 几十天，Chromium 不会主动清，DSH 里也没有任何删除旧 Cookie 的代码。

| 启动次数 | 沉积的 dsh-auth- | Cookie 请求头 |
| 1 | 1 条 | ~0.2 KB |
| 30 | 30 条 | ~6 KB |
| 70 | 70 条 | > 16 KB → 431 |

Node 的 HTTP 服务默认 maxHeaderSize 是 16 KB，超了直接 431；桌面端拿不到登录态，整个应用起不来。

怎么工作

1. 插件加载时（Host 启动）detach 一个独立清理进程 lib/cleaner.mjs，父进程退出它也不受影响。
2. 清理器每 15 秒探测一次 Cookies 库能否独占打开。
- 打不开 = DSH 还在跑（Chromium 独占该文件），继续等；
- 打得开 = DSH 已退出，立刻 delete from cookies where name like 'dsh-auth-%' + VACUUM，然后自己退出。
3. 下次启动时库里只剩本次要写的那一条，请求头稳定在几百字节。

清理只用 node:sqlite（Node 22.5+ 内置），没有第三方依赖，也不需要 Python/PowerShell。

用法

直接从仓库装（推荐）
dsh plugin add github:M0Yun/dsh-cookie-guard

或者装本地目录
dsh plugin add D:\path\to\dsh-cookie-guard

⚠️ npm 上的 dsh-cookie-guard 不是这个仓库（那是别人的同名包，0.1.1），别用 dsh plugin add dsh-cookie-guard。

重启 Harness 后插件开始工作，之后正常开关 DSH 即可，不用改任何习惯。

agent 侧有一个工具：

| action | 作用 |
| status | Cookie 库体积、dsh-auth- 条数（库未被占用时）、清理器是否在跑、上次清理记录 |
| clean | 库已被占用则把清理排到 DSH 退出后；库空着则立刻清一次 |

状态日志：%APPDATA%\@deepseek-ai\dsh-desktop\Network.guard.log，一行一次清理，形如 2026-11-04T16:17:24.467Z pruned 60 cookie(s); 62 -> 2。

局限

- 只清 dsh-auth-，其他 Cookie（包括平台登录）一条不动。
- 清理发生在 DSH 退出后：当前这一轮启动期间，库里仍然是上一轮积累的量；第一次装完后要退出一次 DSH 才会初见效果。
- 如果 DSH 长时间不退出，清理器就一直等（默认最多 24 小时，可用 config.maxHours 调整）。
- 只支持 Windows 桌面端；Web/headless 不受影响。

回滚

dsh plugin remove dsh-cookie-guard

插件只会在 %APPDATA%\@deepseek-ai\dsh-desktop\Network\ 下写 Cookies.guard.pid 和 Network.guard.log，删掉即可。

目录

lib/index.js cordis 插件：注册 cookie_guard 工具 + 启动清理器 lib/cleaner.mjs 后台清理器：等锁释放 → 删 dsh-auth-* → 退出 cordis.patch.yml bundle 注册行

License

MIT © M0Yun

DeepSeek Harness Desktop on Windows writes a fresh dsh-auth- cookie on every launch (the name hashes 127.0.0.1:<random port>), never removes the old ones, and after ~70 launches the Cookie request header crosses Node's 16 KB limit — the local host answers 431, the desktop reports Web authentication failed, and the app cannot start. 无需启动器，也无需改写快捷方式：Host 启动时，这个 bundle 会分离出一个小的清理进程。它轮询 Chromium 的 cookie 数据库（独占锁 = 应用仍在运行），一旦应用退出，就删除所有 dsh-auth- 行，执行 vacuum，然后退出。下次启动就是干净状态。

零依赖 —— 只用 node:sqlite（Node ≥ 22.5）。cookie_guard 工具提供 status 和 clean。

注意：清理发生在当前会话结束之后，所以首次安装要等 DSH 完整退出一次后才见效。