dsh-auto-reconnect
面向 DSH Web 客户端的仅客户端自动重连：在可见性、焦点、交互事件以及终止断开时唤醒连接控制器——弥补 @deepseek-ai/dsh-client-connection 的盲点
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:tqcq/dsh-auto-reconnect#1e50f9918d447fd8775e44f00588596d18f6d4a8Auto Reconnect 以 dsh-auto-reconnect 发布，当前版本为 0.2.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 中文
Auto-reconnect for the DeepSeek Harness (DSH) web client. The official connection controller has backoff reconnect built in, but it sleeps through two real-world scenarios — this plugin wakes it. Client-only, zero build, no official package touched.
dsh plugin --profile web add github:tqcq/dsh-auto-reconnect
Then restart dsh-web — adding or removing plugins always needs a restart; a browser refresh alone is not enough.
Upgrade (re-running add won't move the resolved commit; update re-resolves):
dsh plugin --profile web update dsh-auto-reconnect
Uninstall:
dsh plugin --profile web remove dsh-auto-reconnect
Runtime tweak, no reinstall needed (then reload the page):
localStorage["dsh-auto-reconnect"] = JSON.stringify({ minIntervalMs: 3000, retryDelayMs: 3000, maxAutoRetries: 20, log: true });
Audited against the actually-served @deepseek-ai/dsh-client-connection 0.1.2-rc.1:
disconnected sleeps forever. Once the official 500ms→10s backoff tops out, the controller enters a terminal state and only wakes on the browser online event or a manual tap. Phone sleep/wake keeps navigator.onLine === true the whole time, so online never fires — every wake-up needs a manual tap.connected. The official client has no visibilitychange / focus listener and no heartbeat. A silently dropped TCP leaves the WebSocket in OPEN while the state still reports connected.Listens to visibilitychange(→visible), focus, pointerdown, keydown, pageshow(persisted), and subscribes to the connection state store:
connection.reconnect() only when state ≠ connected (resets backoff, retries immediately) — never interrupts a healthy connection.persisted): sockets are dead by definition, reconnect unconditionally.disconnected: delayed auto-retry (default 3s), budgeted to 20 consecutive attempts, reset on connected. Covers "page already visible and focused, no browser event will ever fire again" (2026-09-11 field report: a hard refresh after a host restart landed in terminal state, still needed a manual tap).Every trigger logs with a [dsh-auto-reconnect] prefix (DevTools console forensics), throttled to 3s by default.
@deepseek-ai/dsh 0.1.5-rc.2 (boot activation assertions all green).dsh-client-connection 0.1.2-rc.1 source.ctx.connection → warn and stay idle, never breaks the page: graceful degradation on API drift.The general form of zombie connected (background tab NAT-dropped, no OS sleep) cannot be detected client-side: the RPC unary channel is separate HTTP, so a successful probe does not prove the WebSocket is alive. The real fix is a host-side heartbeat + dead-connection sweep (prior art: the deprecated enterhalf/dsh-web-network-optimizer) — a separate plugin if ever needed.
node tests/client_test.js # 14 groups, vm-sandboxed DOM/connection stubs, no browser
cordis.patch.yml must stay []: a comment-only YAML file parses to null and kills profile boot.License: MIT (see LICENSE).