dsh-deepseek-web-login 0.7.3 → 0.7.5

package/CHANGELOG.md

@@ -2,6 +2,89 @@
 
 本项目大致遵循语义化版本；日期为本地时间。
 
+## 0.7.5 — 2026-10-10
+
+**修好 0.6.43 那个从未生效的修复：退出 DSH 会把持久化状态自己抹掉。**
+
+### 根因
+
+`disposeSessionReuse()` 是**卸载钩子**（`index.ts` 的 `ctx.effect(() => () => …）`），
+它`clear()` 内存之后**紧接着 `persistResumeState()`** ⇒ **把空态写回了文件**。
+
+⇒ **每次退出 DSH，`resume-state.json` 都被自己清空** ⇒ 下次启动 `restoreResumeState()` 读回空。
+**0.6.43/0.7.1 的"重启后仍能续上同一会话"在真实使用下等于没生效。**
+
+症状：同一对话线被迫建新会话 + 网页端出现「修改 / 重新生成」分叉（实测 27 万字符全量重发）。
+
+### 修法
+
+`persistResumeState(opts?: { persist?: boolean })` —— **退出 / 重置语义**的调用点传 `false`：
+
+- `disposeSessionReuse()`（卸载钩子，最要紧）
+- `resetSessionReuse()`
+- `resetContextChain()`
+
+其余 8 处调用点都是**真实增删改**（入栈、出栈、链更新、链删除、会话退役），**照旧落盘**。
+
+### 为什么之前一直是绿的
+
+- `check-resume-after-restart` 只测**「进程 → 进程」**，**不经过卸载钩子**；
+- `check-bundle` 守的是"落盘点存在"，**不守"落盘的内容对不对"**。
+
+⚠️ **加了持久化就必须测「退出 → 启动」这个生命周期边界。**
+
+### 新增守卫
+
+`tests/check-persist-lifecycle.mjs`（3 条）—— 先用 `writeResumeStateForTest` 造出**非空**落盘态，
+再调三个清空函数，断言**文件内容没被写空**。变异验证：三处改回 `persistResumeState()` ⇒ 三条一起红。
+
+`check-bundle` 新增一条守**卸载钩子那个调用点真的存在**（断"没被调用"）。
+
+⚠️ 这条守卫的首版**恒真**：`slice().includes('disposeSessionReuse()')` 命中了同一段里那行
+**注释**「① `disposeSessionReuse()` 把复用槽里的会话…」⇒ 删掉真实调用后仍为真。
+⇒ 改成**按行判**（`line.trim() === 'disposeSessionReuse()'`）才抓住。
+**这是「断言会被注释引用污染」的又一例，与 MEMORY纪律③同源。**
+
+### 验证
+
+`tsc` / build / 产物 / 新守卫 3 / 产物新增那条 / 外部审查 8 / `check-resume-after-restart` / 隔离 全过。
+
+## 0.7.4 — 2026-10-10
+
+**收窄 0.7.3 的 `--no-sandbox`：只给 headless 传输层，登录窗口保持 sandbox。**
+
+### 0.7.3 的问题
+
+`--no-sandbox` 被加进 `buildBrowserArgs()`，而那个函数**被两处共用**：
+
+| 调用点 | 用途 | 该不该关 sandbox |
+|---|---|---|
+| `browser-login.ts:538` | **登录窗口**（可见真实浏览器，用户在里面手动输密码） | ❌ 不该 |
+| `browser-transport.ts:193` | 请求代理（headless 后台，只请求 `about:blank`） | ✅ Linux/CI 需要 |
+
+⇒ 0.7.3 **连登录窗口的 sandbox 也关了**。sandbox 是浏览器跑第三方网页代码时的进程隔离，
+而登录窗口要加载 DeepSeek 真实页面 —— **那才是真正扩大攻击面**。
+（0.7.3 的 CHANGELOG 写"攻击面不因此变大"，**那句话不准确**，这里更正。）
+
+### 现在
+
+`--no-sandbox` 移到新函数 `transportExtraArgs()`，**只有 headless 传输层**调用它。
+传输层不加载任何第三方页面、只发 HTTP ⇒ 关 sandbox 的收益（Linux/CI 可用）大于代价。
+
+### 守卫
+
+三条，缺一不可：
+
+1. `transportExtraArgs()` 里**必须**有 `--no-sandbox`（否则 Linux/CI 起不来）；
+2. `buildBrowserArgs()` 里**必须没有**（登录窗口要用）；
+3. **传输层的 spawn 必须真的调用它** —— 前两条只断函数内容，断不了"调用点被删"。
+
+三条都做过变异验证（挪位置 / 拿掉内容 / 删调用行，各自打红）。
+
+### 验证
+
+`tsc` / build / 产物 / 17 项登录 / 8 项新守卫 / 隔离 / `check-browser-transport`（真启浏览器）/ **67/67** 全过。
+
 ## 0.7.3 — 2026-10-10
 
 **修好 Linux/CI 上浏览器起不来的问题**（0.7.2 只在 ubuntu-latest 上挂，macOS / Windows 同 commit 通过）。

package/lib/index.js

@@ -3991,10 +3991,32 @@ function buildBrowserArgs(profileDir, url) {
 		"--disable-sync",
 		"--no-service-autorun",
 		"--disable-background-mode",
-		"--no-sandbox",
 		url
 	];
 }
+/**
+* 只给 **headless 请求代理**追加的启动参数（0.7.3）。
+*
+* ## 为什么需要 `--no-sandbox`
+*
+* headless Chrome 在 Linux 上默认要 sandbox，而 Linux 上跑浏览器的人只有两种：
+* root（容器 / CI runner）或没有 user namespace 权限的普通用户 —— **两种都起不来**。
+* 症状伪装成「浏览器调试端口未就绪」（等满 25s 拿不到 `DevToolsActivePort`），
+* 看起来像超时、实际是启动失败 ⇒ **别去调大那个超时**，那只会掩盖真问题。
+*
+* ## 为什么只给传输层
+*
+* sandbox 是浏览器里跑第三方网页代码时的进程隔离。**登录窗口会加载 DeepSeek 的真实页面、
+* 用户还在里面手动输密码** —— 关掉它的 sandbox 才是真正扩大攻击面。
+* 传输层只请求 `about:blank` + 发 HTTP、**不加载任何第三方页面**，
+* 所以关掉它的 sandbox 换来的收益（Linux/CI 可用）大于代价。
+*
+* ⚠️ 若哪天登录窗口也要在 Linux 上跑，应在这里按 `headless` 判定，
+* **而不是把 flag 挪进 `buildBrowserArgs`**（那会连带关掉登录窗口的）。
+*/
+function transportExtraArgs() {
+	return ["--no-sandbox"];
+}
 /** 解析 `<profile>/DevToolsActivePort`：第一行是端口；容忍 CRLF 与附带内容。 */
 function parseDevToolsActivePort(text) {
 	const first = String(text ?? "").split(/\r?\n/)[0]?.trim();
@@ -4677,6 +4699,7 @@ async function launchBrowserTransport() {
 		}
 		const child = spawn(browser.path, [
 			...buildBrowserArgs(PROFILE_DIR, "about:blank"),
+			...transportExtraArgs(),
 			"--headless=new",
 			"--disable-gpu",
 			"--disable-dev-shm-usage",
@@ -6605,7 +6628,27 @@ function persistStatePath() {
 	return join(webLoginDir(), PERSIST_FILE);
 }
 /** 把当前内存状态写盘。**永不抛** —— 落盘失败不该让正常请求失败。 */
-function persistResumeState() {
+/**
+* 把当前内存状态写盘。**永不抛** —— 落盘失败不该让正常请求失败。
+*
+* 🔴 2026-10-10（0.7.5）`opts.persist: false`：**退出 / 重置语义**的调用点要用它。
+*
+* ## 为什么需要这个开关
+*
+* 0.6.43 给会话槽与链加了落盘，好让"重启后仍能续上同一会话"。但三个**清空**函数
+* （`resetContextChain` / `disposeSessionReuse` / `resetSessionReuse`）在 `clear()` 之后
+* **紧接着调persistResumeState()** ⇒ **把空态写回了文件**。
+*
+* 其中 `disposeSessionReuse()` 是**卸载钩子**（`index.ts` 的 `ctx.effect(() => () => …��`）
+* ⇒ **每次退出 DSH，持久化的状态都被自己抹掉** ⇒ 重启后 `restoreResumeState()` 读回空。
+* 症状：网页端同一对话线被迫建新会话 + 出现「修改 / 重新生成」分叉（实测 27 万字符全量重发）。
+*
+* 之所以长期没被发现：`check-resume-after-restart` 只测**「进程 → 进程」**，
+* **不经过卸载钩子**；`check-bundle` 守的是"落盘点存在"，**不守"落盘的内容对不对"**。
+* ⚠️ **加了持久化就必须测「退出 → 启动」这个生命周期边界。**
+*/
+function persistResumeState(opts) {
+	if (opts?.persist === false) return;
 	try {
 		const chains = [...contextChains.entries()].map(([key, s]) => ({
 			key,
@@ -6752,7 +6795,7 @@ function resetContextChain() {
 	contextChains.clear();
 	lastChainKey = void 0;
 	lastFeedReason = void 0;
-	persistResumeState();
+	persistResumeState({ persist: false });
 }
 /** 给状态页看：当前链式投喂是否真的在跑（没用链式就返回 undefined）。 */
 function contextChainInfo() {
@@ -6888,7 +6931,7 @@ function disposeSessionReuse() {
 	reuseSlots.clear();
 	contextChains.clear();
 	lastChainKey = void 0;
-	persistResumeState();
+	persistResumeState({ persist: false });
 	sentRefIdsBySession.clear();
 	if (slots.length === 0) return void 0;
 	for (const slot of slots) try {
@@ -10912,7 +10955,7 @@ async function checkForUpdate(current, fetchImpl) {
 * 兜底常量与 package.json 的一致性由 `tests/check-smoke.mjs` 守着，不会漂。
 */
 /** 与 package.json 保持一致的兜底版本（由测试保证不会漂）。 */
-const FALLBACK_VERSION = "0.7.3";
+const FALLBACK_VERSION = "0.7.5";
 let cached;
 /** 本插件版本（如 `0.1.26`）。 */
 function pluginVersion() {