@iasiv5/dsh-skip-browser-auth 0.1.0 → 0.1.2

package/README.md

@@ -1,193 +1,74 @@
 # @iasiv5/dsh-skip-browser-auth
 
-个人自用的 DSH Web 插件：在兼容版本上替换官方 Connection 提供方，跳过 DSH 官方
-BrowserAuth 浏览器身份层，同时完整保留请求信任栅栏（request trust fence）。
-不修改 DSH 本体，不创建任何新的监听服务或端口。
-
-## 这是什么
-
-DSH 官方的 BrowserAuth 在进程启动 token 与浏览器之间换取 authority 绑定的签名
-cookie，保护全部 Host API 与 Remote WebSocket。本插件安装后在任意 DSH 版本上都能
-被 `dsh plugin add` 接受；但只有当运行环境中
-`@deepseek-ai/dsh-client-connection` 的**精确版本为 `0.1.2-rc.1`** 时才激活：
-
-- 组合期（Loader 装配阶段）由 bundle patch（`cordis.patch.yml`）自门控：
-  - 第一行把官方 `connection` 行的 `disabled` 绑定到版本探针（`!!js` 表达式，
-    从 pnpm store 路径段提取精确版本并与白名单比对）；
-  - 第二行插入本插件的 `trusted-connection` 行，其 `disabled` 为行绑定表达式的
-    否定（自身探针为真 + 同组官方行存在、名字匹配、确被禁用）。
-- 激活后由本插件提供 trusted-network（可信网络）等效 Connection：复用官方导出的
-  `HostConnectionService`，以三方法 stub（trusted-network 语义）替代 BrowserAuth，
-  `/api` 路由、请求体上限、image capacity 断言照抄官方 apply 语义。
-- 任一门控条件不成立（探针为假、行不存在、名字漂移、官方行未禁用）→ 插件保持
-  dormant（休眠）：官方行为分毫不变，插件不注册路由、不提供服务、不加载浏览器
-  bundle。注意：在探针为假（非白名单版本）时，即使后续 patch 层把官方行强制设为
-  `disabled: true`，行绑定内嵌的版本探针仍会阻止 Replacement 激活。
-- `apply()` 内另有 backstop（最后防线）：读官方 manifest 比对白名单、校验行绑定
-  状态，任一不满足即 fail loud 拒绝运行；产品上下文中 loader / internal /
-  当前 entry 任一缺失（最后防线无法执行）同样 fail loud。
-
-本插件包含或移植 DeepSeek Harness 的 MIT 许可代码，详见 LICENSE。
-
-## 安全警告
-
-Replacement 激活时进程会输出以下固定警告（逐字）：
+[![npm](https://img.shields.io/npm/v/@iasiv5/dsh-skip-browser-auth?label=npm&color=cb3837)](https://www.npmjs.com/package/@iasiv5/dsh-skip-browser-auth)
+[![DSH Web](https://img.shields.io/badge/DSH_Web-0.1.2--rc.1_verified-blue)](#兼容版本)
+[![License](https://img.shields.io/github/license/iasiv5/dsh-skip-browser-auth?color=green)](./LICENSE)
 
-```
-@iasiv5/dsh-skip-browser-auth: BrowserAuth has been skipped. DSH Web is using the trusted-network behavior; this plugin does not verify any upstream proxy.
-```
+个人自用的 DSH Web 插件：在 **DSH 0.1.2-rc.1** 上自动跳过 BrowserAuth——打开 Web 地址即可直接使用，**不必每次把启动 URL 里那串随机 token 抄进浏览器**。
 
-trusted-network mode 的判据只有一个：**请求来源是否通过信任栅栏**
-（Host/Origin/Fetch Metadata/trustedHosts）。**网络可达即身份**——能通过栅栏的
-请求一律被接受，不存在身份层，本插件也不校验任何上游反代。仅在与外界隔离、或由
-可信网络层（如具备身份认证的反代）完全包住的网络中使用；`trustedHosts` 只声明
-「这些主机名解析到的请求被接受」，不构成认证。
+- **只在适配版本激活**：当前仅 `0.1.2-rc.1`。在 `0.1.1-rc.2` 及其它所有未测试版本上**自动休眠**，官方行为分毫不变。
+- **不修改 DSH 本体与任何机制**：仅通过 DSH 官方插件 patch 机制替换 Connection 行；卸载或禁用插件并重启，即完全恢复官方行为。
+- **提醒**：跳过认证后，Web 对本机/可信网络内的访问不再有身份层，请勿把 DSH 端口暴露给不可信网络。
 
-## 安装与卸载
+## 安装
 
-```sh
-# 从本地 checkout 安装（scope 是包名的一部分，不是目录路径）
-dsh plugin --profile web add /path/to/dsh-skip-browser-auth
+### 方式一：从插件市场一键安装（推荐）
+
+本插件已收录进我的 DSH 插件市场 **[dsh-m](https://github.com/iasiv5/dsh-m)**（收录 id：`dsh-skip-browser-auth`）。装好 dsh-m 后，在 Web 侧栏「插件市场」搜索 **Skip Browser Auth**，即可**一键安装 / 更新 / 卸载**；也可以直接对 agent 说：
 
-# 发布 npm 后，从 registry 安装
+> 从 dsh-m 插件市场安装 dsh-skip-browser-auth，装完重启 DSH Web。
+
+### 方式二：直接命令安装
+
+```sh
 dsh plugin --profile web add @iasiv5/dsh-skip-browser-auth
+sudo systemctl restart deepseek-harness.service   # 按你的部署方式重启 DSH Web
+```
 
-sudo systemctl restart deepseek-harness.service
+### 复制给 agent 的安装提示词
+
+把下面整段贴给你机器上的 agent，它就能完成安装与验证：
+
+```text
+请给我的 DSH Web 安装 @iasiv5/dsh-skip-browser-auth 插件（DSH 0.1.2-rc.1 专用：
+自动跳过 BrowserAuth，免每次在启动 URL 后输入随机 token；其它版本会自动休眠，
+不影响任何行为）。
+1. 先执行 dsh --version 告诉我当前 DSH 版本，然后照常安装：
+   dsh plugin --profile web add @iasiv5/dsh-skip-browser-auth
+2. 重启 DSH Web 并轮询 http://127.0.0.1:3080 直到恢复 200
+   （systemd 系统级部署：sudo systemctl restart deepseek-harness.service；
+   user 级部署：systemctl --user restart dsh-web.service；端口以实际部署为准）。
+3. 若版本是 0.1.2-rc.1：确认 journal/日志中出现固定警告
+   "BrowserAuth has been skipped"，且浏览器直接打开 Web 地址不再要求 token，
+   即激活成功。
+4. 若版本不是 0.1.2-rc.1：插件会自动休眠（官方行为不变），直接告诉我即可，
+   不要做任何强行处理。
+```
+
+## 卸载
 
-# 卸载（恢复官方行为；统一使用 manifest 包名）
+```sh
 dsh plugin --profile web remove @iasiv5/dsh-skip-browser-auth
 sudo systemctl restart deepseek-harness.service
 ```
 
-没有 `skipBrowserAuth` 之类的配置项——始终 skip；卸载或禁用插件并重启即恢复官方
-行为。激活状态由「行为 + 警告」共同证明（见下方升级清单），配置证据
-（dump-config 出现 `trusted-connection` 行）仅作安装证据。
+市场安装的用户在「插件市场 → 已装」里点卸载即可。卸载或禁用并重启后，官方 BrowserAuth 完全恢复。
 
-## 版本白名单与升级策略
+## 兼容版本
 
-- 唯一白名单版本：字符串精确值 `'0.1.2-rc.1'`。禁止 `>=`、范围、`latest` 判断；
-  探测失败一律 fail-closed 到 dormant。
-- 升级后 `@deepseek-ai/dsh-client-connection` 版本不在精确白名单内时，本插件
-  自动回到 dormant（官方行为分毫不变），不影响使用；升级到白名单版本
-  （`0.1.2-rc.1`）则会激活。
-- 新版本需要逐个测试验证后把精确版本加入白名单（`src/gate.ts` 的
-  `GATE_VERSION` 与白名单判断、`src/index.ts` backstop 的白名单文案）；
-  无法安全跟随时对插件做版本分叉。
+| DSH 版本 | 状态 |
+| --- | --- |
+| `0.1.2-rc.1` | ✅ 激活：跳过 BrowserAuth（pnpm 与 npm 扁平安装布局均可识别） |
+| `0.1.1-rc.2` 及其它未测试版本 | 😴 自动休眠：官方行为分毫不变 |
 
-## 行为矩阵
+新版本经实测验证后逐个加入白名单；版本探测失败一律自动休眠（fail-closed）。
 
-| 组合 | 官方 `connection` 行 | 本插件 `trusted-connection` 行 | 行为 |
-| --- | --- | --- | --- |
-| rc.1 + 探针真 + 绑定完好 | `disabled: true`（被 patch 禁用，无 fiber） | `disabled: false`（活跃 fiber） | Replacement 激活：trusted-network 行为 + 固定警告 |
-| rc.1 + 探针假（如 9.9.9 段） | 活跃 | dormant | 官方 BrowserAuth 照常（401/cookie 换取） |
-| rc.2（0.1.1-rc.2，真实产物） | 活跃（rc.2 无 BrowserAuth） | dormant | 官方 rc.2 基线：`GET /` 200、`/api` 无认证层 |
-| 官方行名字漂移 | 活跃（patch 被 name-guard 跳过） | dormant | 官方行为，无冲突 |
-| 非白名单版本 + 后续 patch 层强制禁用官方行 | `disabled: true`（探针仍为假） | dormant（行绑定内嵌探针拦截） | 无 Connection 服务（无身份层也无替代） |
-| 白名单 rc.1 + 后续 patch 层强制禁用官方行 | `disabled: true`（与本插件自身禁用一致） | 激活（行绑定要求的正是官方行已禁用） | Replacement 照常激活 |
-| 路径段真、manifest 版本漂移 | 禁用 | 进入 apply 后被 backstop 拒绝 | fail loud：whitelist 诊断，`loader.await()` reject |
+## 机制与安全（简述）
 
-## 测试说明
+- 组合期版本探针采用**双锚点**（宿主 runtime 本体 + 官方 connection 包）与**双分支**版本确认（pnpm 路径段 / manifest 读取，兼容两种安装布局），精确匹配白名单才激活；任何解析失败、版本漂移、结构漂移都保持休眠。
+- 激活后复用官方导出的 `HostConnectionService` 提供 trusted-network Connection：Host/Origin/trustedHosts 请求信任栅栏完整保留，仅移除身份层；激活时进程逐字输出固定警告 `@iasiv5/dsh-skip-browser-auth: BrowserAuth has been skipped. ...`。
+- 运行前 backstop 复核 manifest 白名单与行绑定状态，任何不满足即拒绝运行。
 
-```sh
-npm run test:all
-# 等价于：npm run test:rc2-fixture && npm run build && npm run typecheck && npm test
-```
+详细设计、行为矩阵与实机验证记录见 [docs/DESIGN.md](./docs/DESIGN.md)。
 
-- `test:rc2-fixture` 需要 npm 网络访问：以别名安装 rc.2 dormant 组合所需产物。
-  `--no-save` 会改动 `node_modules`（以及为满足 rc.2 peer 链所需的嵌套安装），
-  但不改 package manifest 与 lockfile（脚本内以 `git diff` 证明）。
-- 本机 npm 11.19 的 allow-scripts 策略与 project-scoped 安装存在三处适配
-  （`--ignore-scripts`、`--force` 取代 `--legacy-peer-deps`、仅剥离
-  `npm_config_allow_scripts` / `NPM_CONFIG_ALLOW_SCRIPTS` 两个确证冲突键），
-  详见 `scripts/install-rc2-fixture.mjs` 头注释。
-- 组合测试（`tests/composition/`）用真实 Loader + Include + 真实官方产物端到端
-  覆盖 active / gate-false / 真实 rc.2 dormant / gate 绑定负向四条路径；探针
-  fixture 是真实文件（临时目录内构造 pnpm 风格路径段 + manifest）。
-- 测试使用 Node 内置 test runner（无 vitest）。
-
-## 已知限制
-
-- npm 布局（`node_modules/@deepseek-ai/dsh-client-connection`，路径无版本段）下
-  探针无法确认版本 → 不激活（dormant）。pnpm 布局与真实部署（pnpm store 路径段）
-  可确认版本。
-- 组合测试的探针 fixture 是受控构造（真实文件但路径段版本可指定），真实布局的
-  版本提取由 Task 11 式实机验证与 Task 5 的 pnpm 真实路径断言兜底。
-- 完整浏览器组图 e2e（client-modules 组图、浏览器半区真实加载）未覆盖；
-  由 client bundle materialization 测试（单次注册、factory 可执行、external
-  全满足）与下方升级 active 清单兜底。
-- 激活要求 DSH 升级到 `0.1.2-rc.1` 后执行实机清单验证。
-
-## 实机 dormant 前后对照记录
-
-本机 DSH runtime 为 `0.1.1-rc.2`（2026-09-05 实测）。验证协议：安装前基线 →
-安装 + 重启 → 行为逐项对照 → 卸载 + 重启 → 复验基线；journal 检查统一使用
-安装前固化的时间锚；任何失败立即回滚（本次回滚未被触发）。
-
-| 检查项 | 安装前基线 | 安装后（dormant） | 卸载恢复后 |
-| --- | --- | --- | --- |
-| `GET /` | `200` `text/html; charset=utf-8` | `200` `text/html; charset=utf-8` | `200` `text/html; charset=utf-8` |
-| `POST /api/session.list`（未认证） | `200` `application/json` | `200` `application/json` | `200` `application/json` |
-| envelope `type` / `rpcId` / `resultOk` | `server-response` / `probe` / `true` | `server-response` / `probe` / `true` | `server-response` / `probe` / `true` |
-| 首页静态 shell marker（首个 `<script src=`） | 在 | 在 | 在 |
-| 首页认证文案 `dsh web authentication required` | 0 次出现 | 0 次出现 | 0 次出现 |
-
-三组行为文件逐字节 diff 均为空；安装后与卸载后 journal（同一时间锚窗口内）
-均无固定警告 `BrowserAuth has been skipped`、无 err 级日志。配置证据：安装后
-`dsh --profile web --dump-config` 出现 `trusted-connection` 行（仅作安装证据，
-不作为未激活证明）；卸载后该行消失、bundles 中无本插件。回滚未被触发。
-
-### scoped rename 后重新验证（2026-09-05，`@iasiv5/dsh-skip-browser-auth@0.1.0`）
-
-包名改为 scoped 后按同一协议重新执行（安装 `/home/ubuntu/workspace/dsh-skip-browser-auth`
-→ 重启 → 对照 → `dsh plugin --profile web remove @iasiv5/dsh-skip-browser-auth`
-→ 重启 → 复验）：安装证据为 bundles 出现 `@iasiv5/dsh-skip-browser-auth`、
-dump-config 第 612 行 `trusted-connection` 行（行名 `@iasiv5/dsh-skip-browser-auth`）；
-三组行为文件逐字节 diff 均为空（`root 200 text/html`、`api 200 application/json`、
-`type=server-response` / `rpcId=probe` / `resultOk=true`、authCount=0）；
-安装后与卸载后 journal 均无固定警告、无 err 级日志；scoped 卸载无残留；
-回滚未被触发。本节替代首次记录，作为 scoped 包身份的实机 dormant 结论。
-
-## 升级到 0.1.2-rc.1 后的 active 验证清单
-
-DSH 升级到 `0.1.2-rc.1` 并安装本插件、重启后，依次执行：
-
-1. 配置证据（仅安装证据，不证明激活）：
-
-   ```sh
-   dsh --profile web --dump-config | grep -n -A2 'id: trusted-connection'
-   # 预期：出现 trusted-connection 行
-   ```
-
-2. 行为验证（与固定警告共同证明激活）：
-
-   ```sh
-   # GET / 免 token → 200（无 401、无认证文案）
-   curl -s -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3080/
-   # 预期：200
-
-   # GET /?token=x → 303 location: /（token 清理）
-   curl -s -o /dev/null -w '%{http_code} %{redirect_url}\n' 'http://127.0.0.1:3080/?token=x'
-   # 预期：303 http://127.0.0.1:3080/
-
-   # 无 cookie POST /api → 非 401/403（无认证层；无 api-gateway 挂载时 404）
-   curl -s -o /dev/null -w '%{http_code}\n' -X POST \
-     -H 'content-type: application/json' \
-     -d '{"type":"client-request","rpcId":"probe","method":"session.list","payload":{}}' \
-     http://127.0.0.1:3080/api/session.list
-   # 预期：非 401/403
-   ```
-
-3. journal 固定警告：
-
-   ```sh
-   sudo journalctl -u deepseek-harness.service --since '<重启时间点>' \
-     | grep -F 'BrowserAuth has been skipped'
-   # 预期：出现固定警告文案
-   ```
-
-4. 回滚路径（任何时候行为异常）：
-
-   ```sh
-   dsh plugin --profile web remove @iasiv5/dsh-skip-browser-auth
-   sudo systemctl restart deepseek-harness.service
-   ```
+本插件包含或移植 DeepSeek Harness 的 MIT 许可代码，详见 [LICENSE](./LICENSE)。

package/cordis.patch.yml

@@ -1,13 +1,17 @@
 # 本文件由 scripts/write-patch.mjs 从 lib/gate.js 常量机械生成，请勿手改。
 # 自门控 bundle patch：第一行把官方 connection 行的 disabled 绑定到版本探针
-# （仅 @deepseek-ai/dsh-client-connection@0.1.2-rc.1 为真）；第二行插入本插件的
-# trusted-connection 行，其 disabled 为行绑定表达式的否定（行绑定内嵌同一探针）。
-# 任何门控条件不成立（探针为假、行不存在、名字漂移、官方行未禁用），
-# Replacement 一律保持 dormant（fail-closed）。探针为假时，即使后续 patch 层
-# 把官方行强制 disabled，行绑定内嵌探针仍保持 dormant。
+# （双锚点：宿主 runtime 本体 @deepseek-ai/dsh 与官方 connection 包的 pnpm
+# 路径段版本必须同为 0.1.2-rc.1；runtime 锚点只可能来自 runtime fallback，
+# 不会被插件自身依赖污染）；第二行插入本插件的 trusted-connection 行，其
+# disabled 为行绑定表达式的否定（行绑定内嵌同一探针）。
+# 任何门控条件不成立（锚点解析失败、版本漂移、行不存在、名字漂移、
+# 官方行未禁用），Replacement 一律保持 dormant（fail-closed）。探针为假时，
+# 即使后续 patch 层把官方行强制 disabled，行绑定内嵌探针仍保持 dormant。
 - id: connection
   name: '@deepseek-ai/dsh-client-connection'
-  disabled: !!js '(() => { try { const internal = ctx.loader && ctx.loader.internal; if (!internal || typeof internal.resolveSync !== ''function'') return false; let url; try { url = internal.version === ''v2'' ? internal.resolveSync(ctx.baseUrl, { specifier: ''@deepseek-ai/dsh-client-connection/package.json'', attributes: {} }).url : internal.resolveSync(''@deepseek-ai/dsh-client-connection/package.json'', ctx.baseUrl, {}).url; } catch (gateError) { return false; } if (typeof url !== ''string'') return false; const match = decodeURIComponent(url).match(/[+]dsh-client-connection@([^/_]+)[_/]/); return match !== null && match[1] === ''0.1.2-rc.1''; } catch (gateError) { return false; } })()'
+  disabled: !!js >-
+    (() => { try { const internal = ctx.loader && ctx.loader.internal; if (!internal || typeof internal.resolveSync !== 'function') return false; const versionOfUrl = (url, patternSource) => { if (typeof url !== 'string') return null; const decoded = decodeURIComponent(url); const segmented = decoded.match(new RegExp(patternSource)); if (segmented !== null) return segmented[1]; if (decoded.slice(0, 5) === 'file:') { const processRef = globalThis.process; if (processRef === null || typeof processRef !== 'object' || typeof processRef.getBuiltinModule !== 'function') return null; const fsModule = processRef.getBuiltinModule('node:fs'); const urlModule = processRef.getBuiltinModule('node:url'); if (!fsModule || typeof fsModule.readFileSync !== 'function' || !urlModule || typeof urlModule.fileURLToPath !== 'function') return null; const manifest = JSON.parse(fsModule.readFileSync(urlModule.fileURLToPath(url), 'utf8')); return manifest !== null && typeof manifest === 'object' && typeof
+    manifest.version === 'string' ? manifest.version : null; } return null; }; const anchors = [["@deepseek-ai/dsh","[+]dsh@([^/_]+)[_/]"],["@deepseek-ai/dsh-client-connection","[+]dsh-client-connection@([^/_]+)[_/]"]]; for (const [anchorPackage, patternSource] of anchors) { const specifier = anchorPackage + '/package.json'; let url; try { url = internal.version === 'v2' ? internal.resolveSync(ctx.baseUrl, { specifier, attributes: {} }).url : internal.resolveSync(specifier, ctx.baseUrl, {}).url; } catch (gateError) { return false; } let anchorVersion; try { anchorVersion = versionOfUrl(url, patternSource); } catch (gateError) { return false; } if (anchorVersion !== '0.1.2-rc.1') return false; } return true; } catch (gateError) { return false; } })()
 - insert:
     - id: trusted-connection
       name: '@iasiv5/dsh-skip-browser-auth'
@@ -16,5 +20,6 @@
       config:
         trustedHosts: !!js ctx.webRuntime.trustedHosts
       disabled: !!js >-
-        !((() => { try { const self = ctx[Symbol.for('cordis.entry')]; if (!self || !self.parent || !self.parent.tree) return false; const official = self.parent.tree.resolve('connection'); if (!official || official.parent !== self.parent) return false; if (official.options.id !== 'connection' || official.options.name !== '@deepseek-ai/dsh-client-connection') return false; const probeAllowed = ((() => { try { const internal = ctx.loader && ctx.loader.internal; if (!internal || typeof internal.resolveSync !== 'function') return false; let url; try { url = internal.version === 'v2' ? internal.resolveSync(ctx.baseUrl, { specifier: '@deepseek-ai/dsh-client-connection/package.json', attributes: {} }).url : internal.resolveSync('@deepseek-ai/dsh-client-connection/package.json', ctx.baseUrl, {}).url; } catch (gateError) { return false; } if (typeof url !== 'string') return false; const match = decodeURIComponent(url).match(/[+]dsh-client-connection@([^/_]+)[_/]/); return match !== null &&
-        match[1] === '0.1.2-rc.1'; } catch (gateError) { return false; } })()); if (probeAllowed !== true) return false; return official.disabled === true; } catch (gateError) { return false; } })())
+        !((() => { try { const self = ctx[Symbol.for('cordis.entry')]; if (!self || !self.parent || !self.parent.tree) return false; const official = self.parent.tree.resolve('connection'); if (!official || official.parent !== self.parent) return false; if (official.options.id !== 'connection' || official.options.name !== '@deepseek-ai/dsh-client-connection') return false; const probeAllowed = ((() => { try { const internal = ctx.loader && ctx.loader.internal; if (!internal || typeof internal.resolveSync !== 'function') return false; const versionOfUrl = (url, patternSource) => { if (typeof url !== 'string') return null; const decoded = decodeURIComponent(url); const segmented = decoded.match(new RegExp(patternSource)); if (segmented !== null) return segmented[1]; if (decoded.slice(0, 5) === 'file:') { const processRef = globalThis.process; if (processRef === null || typeof processRef !== 'object' || typeof processRef.getBuiltinModule !== 'function') return null; const fsModule =
+        processRef.getBuiltinModule('node:fs'); const urlModule = processRef.getBuiltinModule('node:url'); if (!fsModule || typeof fsModule.readFileSync !== 'function' || !urlModule || typeof urlModule.fileURLToPath !== 'function') return null; const manifest = JSON.parse(fsModule.readFileSync(urlModule.fileURLToPath(url), 'utf8')); return manifest !== null && typeof manifest === 'object' && typeof manifest.version === 'string' ? manifest.version : null; } return null; }; const anchors = [["@deepseek-ai/dsh","[+]dsh@([^/_]+)[_/]"],["@deepseek-ai/dsh-client-connection","[+]dsh-client-connection@([^/_]+)[_/]"]]; for (const [anchorPackage, patternSource] of anchors) { const specifier = anchorPackage + '/package.json'; let url; try { url = internal.version === 'v2' ? internal.resolveSync(ctx.baseUrl, { specifier, attributes: {} }).url : internal.resolveSync(specifier, ctx.baseUrl, {}).url; } catch (gateError) { return false; } let anchorVersion; try { anchorVersion = versionOfUrl(url,
+        patternSource); } catch (gateError) { return false; } if (anchorVersion !== '0.1.2-rc.1') return false; } return true; } catch (gateError) { return false; } })()); if (probeAllowed !== true) return false; return official.disabled === true; } catch (gateError) { return false; } })())

package/lib/gate.js

@@ -5,11 +5,55 @@
  * 见 vendor/loader/src/config/utils.ts），失败一律落入 dormant（fail-closed）。
  * sibling 解析走 Symbol.for('cordis.entry') 当前 entry 所属子树，
  * 不依赖根 Loader 的 resolve——业务行位于 Include 子树，根上看不到。
+ *
+ * 探针解析基准（2026-09-05 事故修正）：锚定宿主 runtime 本体，而不是
+ * connection 包自身。`ctx.baseUrl` 是 profile 目录，Node 解析自 profile
+ * 向上走 node_modules；旧版插件把 connection 包声明进 dependencies，发布
+ * 安装（profile `nodeLinker: hoisted`）把 0.1.2-rc.1 副本抬升进 profile
+ * node_modules，遮蔽 `~/.dsh/profiles/node_modules/` 下
+ * healProfilesModuleFallback 维护的 runtime fallback 符号链——探针随之
+ * 「自我满足」，在不兼容宿主上误激活（正是本次事故）。因此：
+ *  1. 第一锚点是 `@deepseek-ai/dsh/package.json`（runtime 应用包本体）。
+ *     它只可能来自 runtime fallback，不可能被任何 profile 插件的依赖
+ *     抬升污染；其版本即宿主 runtime 版本。
+ *  2. 第二锚点仍是官方 connection 包（被替换对象本体）；双锚点必须同时
+ *     命中白名单版本，任一解析失败或版本漂移一律 dormant。
+ * 配套必要条件：本插件的 dependencies 不得声明任何 `@deepseek-ai` 运行时
+ * 包（connection 仅作 devDependency 供编译期类型与构建锚点），由
+ * tests/manifest.test.mjs 作为不变量看护。
+ *
+ * 单锚点版本判定（2026-09-05 第二修正，npm 扁平布局）：
+ *  1. pnpm store 路径段（快路径）：URL 含 `+包名@版本[_/]` 段即取段值。
+ *     保留既有文档化行为——「段真、manifest 版本漂移」时探针仍放行，
+ *     由 apply 内 backstop 读 manifest 兜底 fail loud。
+ *  2. manifest 回退：URL 为 `file:` 且无版本段（npm 扁平布局，如 dshm
+ *     安装）时，经 `process.getBuiltinModule('node:fs'/'node:url')` 同步读
+ *     manifest 比对精确版本（Node ≥22.3，插件 engines 覆盖；`!!js` 求值
+ *     环境无 require/模块导入，这是唯一受支持的同步内建模块获取方式）。
+ * 两分支都拿不到精确版本 → dormant。任何异常一律 dormant（组合期绝不
+ * fail loud；最后防线在 apply 内 backstop）。
  */
 export const CONNECTION_PACKAGE = '@deepseek-ai/dsh-client-connection';
+/** 宿主 runtime 本体包：探针的第一锚点，版本即宿主 dsh 版本。 */
+export const GATE_RUNTIME_PACKAGE = '@deepseek-ai/dsh';
 export const GATE_VERSION = '0.1.2-rc.1';
+/** 探针锚点（顺序即求值顺序）：宿主 runtime 本体在前，被替换对象在后。 */
+export const GATE_ANCHOR_PACKAGES = [GATE_RUNTIME_PACKAGE, CONNECTION_PACKAGE];
+/**
+ * 从已解析 URL 提取 pnpm store 版本段的正则源（`+name@VER_` / `+name@VER/`）。
+ * 探针表达式内嵌的正则由此单一实现生成；仅匹配 pnpm 布局，非 pnpm 布局
+ * 落入 manifest 回退分支。
+ */
+export function versionSegmentPatternSource(pkg) {
+    const shortName = pkg.slice(pkg.indexOf('/') + 1).replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    return `[+]${shortName}@([^/_]+)[_/]`;
+}
+/** 探针内嵌的锚点表：`[包名, 版本段正则源]` 对，全部由上方常量派生。 */
+const GATE_ANCHOR_TABLE = GATE_ANCHOR_PACKAGES.map((pkg) => [pkg, versionSegmentPatternSource(pkg)]);
 // 版本探针：单行；生成 cordis.patch.yml 官方行 disabled（scripts/write-patch.mjs）。
-export const GATE_PROBE_EXPRESSION = `(() => { try { const internal = ctx.loader && ctx.loader.internal; if (!internal || typeof internal.resolveSync !== 'function') return false; let url; try { url = internal.version === 'v2' ? internal.resolveSync(ctx.baseUrl, { specifier: '${CONNECTION_PACKAGE}/package.json', attributes: {} }).url : internal.resolveSync('${CONNECTION_PACKAGE}/package.json', ctx.baseUrl, {}).url; } catch (gateError) { return false; } if (typeof url !== 'string') return false; const match = decodeURIComponent(url).match(/[+]dsh-client-connection@([^/_]+)[_/]/); return match !== null && match[1] === '${GATE_VERSION}'; } catch (gateError) { return false; } })()`;
+// 逐锚点解析 `锚点包/package.json`，版本（路径段快路径或 manifest 回退）全部
+// 精确等于 GATE_VERSION 才放行。
+export const GATE_PROBE_EXPRESSION = `(() => { try { const internal = ctx.loader && ctx.loader.internal; if (!internal || typeof internal.resolveSync !== 'function') return false; const versionOfUrl = (url, patternSource) => { if (typeof url !== 'string') return null; const decoded = decodeURIComponent(url); const segmented = decoded.match(new RegExp(patternSource)); if (segmented !== null) return segmented[1]; if (decoded.slice(0, 5) === 'file:') { const processRef = globalThis.process; if (processRef === null || typeof processRef !== 'object' || typeof processRef.getBuiltinModule !== 'function') return null; const fsModule = processRef.getBuiltinModule('node:fs'); const urlModule = processRef.getBuiltinModule('node:url'); if (!fsModule || typeof fsModule.readFileSync !== 'function' || !urlModule || typeof urlModule.fileURLToPath !== 'function') return null; const manifest = JSON.parse(fsModule.readFileSync(urlModule.fileURLToPath(url), 'utf8')); return manifest !== null && typeof manifest === 'object' && typeof manifest.version === 'string' ? manifest.version : null; } return null; }; const anchors = ${JSON.stringify(GATE_ANCHOR_TABLE)}; for (const [anchorPackage, patternSource] of anchors) { const specifier = anchorPackage + '/package.json'; let url; try { url = internal.version === 'v2' ? internal.resolveSync(ctx.baseUrl, { specifier, attributes: {} }).url : internal.resolveSync(specifier, ctx.baseUrl, {}).url; } catch (gateError) { return false; } let anchorVersion; try { anchorVersion = versionOfUrl(url, patternSource); } catch (gateError) { return false; } if (anchorVersion !== '${GATE_VERSION}') return false; } return true; } catch (gateError) { return false; } })()`;
 // 行绑定放行：自身探针为真 + 同组 sibling 存在且名字匹配且其 effective disabled 为真。
 // sibling 必须从当前 entry（Symbol.for('cordis.entry')）所属子树解析，
 // 根 Loader 的 resolve 看不到 Include 子树内的行。
@@ -17,7 +61,7 @@ export const GATE_ROW_ALLOWED_EXPRESSION = `(() => { try { const self = ctx[Symb
 /**
  * Evaluate the activation probe against a loader context scope.
  * @param ctx - the `!!js` evaluation scope (same object the Loader passes).
- * @returns true only when the resolved connection package is exactly the whitelisted version.
+ * @returns true only when every gate anchor resolves to exactly the whitelisted version.
  */
 export function evaluateGate(ctx) {
     // 与 vendor/loader/src/config/utils.ts 的 evaluate 同语义：with(ctx) + eval。

package/lib/host.js

@@ -5,9 +5,9 @@
  * isAuthenticated / authorizeIndex / authenticatedUrl 三个方法，由
  * trusted-auth 的 stub 提供），复刻官方 apply 的 /api 前缀路由、
  * 请求体上限与 image capacity 断言语义，并在启动时输出固定警告。
- * apply 内 backstop 是最后防线：版本白名单（读官方 manifest）与
- * 门控绑定状态（同组官方行确被禁用且无活跃 fiber）任一不满足即
- * fail loud 拒绝运行。
+ * apply 内 backstop 是最后防线：版本白名单（读全部门控锚点的 manifest，
+ * 与探针同源常量）与门控绑定状态（同组官方行确被禁用且无活跃 fiber）
+ * 任一不满足即 fail loud 拒绝运行。
  */
 import { readFileSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
@@ -16,7 +16,7 @@ import { HostConnectionService, API_PATH } from '@deepseek-ai/dsh-client-connect
 import { assertTrustedAuthority } from './trust-fence.js';
 import { createTrustedAuth } from './trusted-auth.js';
 import { bridge, DEFAULT_MAX_REQUEST_BODY_BYTES } from './bridge.js';
-import { CONNECTION_PACKAGE, GATE_VERSION } from './gate.js';
+import { CONNECTION_PACKAGE, GATE_ANCHOR_PACKAGES, GATE_VERSION } from './gate.js';
 /** Stable Cordis plugin name. */
 export const name = '@iasiv5/dsh-skip-browser-auth';
 /** Services required before providing the replacement Connection. */
@@ -36,10 +36,16 @@ function assertImageBodyCapacity(ctx, maxRequestBodyBytes) {
     }
 }
 /**
- * apply 内 backstop（最后防线，fail loud）：版本白名单断言读取官方 manifest
- * 本体（组合期探针只读 pnpm 路径段，会被「路径真、manifest 假」的漂移骗过）；
- * 绑定断言确认当前 entry 子树内的官方 connection 行确实被本插件禁用、
- * 同组同名且无活跃 fiber。
+ * apply 内 backstop（最后防线，fail loud）：版本白名单断言读取全部门控锚点
+ * （gate.ts 的 GATE_ANCHOR_PACKAGES：宿主 runtime 本体 + 官方 connection 包）
+ * 的 manifest 本体比对白名单（组合期探针只读 pnpm 路径段，会被
+ * 「路径真、manifest 假」的漂移骗过）；绑定断言确认当前 entry 子树内的
+ * 官方 connection 行确实被本插件禁用、同组同名且无活跃 fiber。
+ *
+ * 锚点解析与探针同基准（ctx.baseUrl，即 profile 根）：发布安装的插件不携带
+ * 任何 @deepseek-ai 运行时依赖（见 tests/manifest.test.mjs 不变量），解析只
+ * 可能命中 runtime fallback；探针基准污染的历史事故由此不变量 + 双锚点共同
+ * 封死。
  *
  * 跳过 seam 仅限「完全没有 Loader、也没有 Loader entry」的直接单元测试调用；
  * 产品组合中 loader / internal / current 任一缺失都意味着最后防线无法执行，
@@ -60,16 +66,23 @@ function assertGateBackstop(ctx) {
     if (current === undefined) {
         throw new Error('@iasiv5/dsh-skip-browser-auth: gate backstop unavailable: current loader entry is missing');
     }
-    // (a) 版本断言：与官方 row 同一解析锚点（loader.internal），读 manifest 比对白名单。
+    // (a) 版本断言：与探针同一解析锚点集合（loader.internal + ctx.baseUrl），
+    // 逐锚点读 manifest 比对白名单。
     const baseUrl = ctx.baseUrl ?? '';
-    const specifier = `${CONNECTION_PACKAGE}/package.json`;
     const internal = loader.internal;
-    const resolved = internal.version === 'v2'
-        ? internal.resolveSync(baseUrl, { specifier, attributes: {} })
-        : internal.resolveSync(specifier, baseUrl, {});
-    const manifest = JSON.parse(readFileSync(fileURLToPath(resolved?.url), 'utf8'));
-    if (manifest.version !== GATE_VERSION) {
-        throw new Error(`@iasiv5/dsh-skip-browser-auth: official connection manifest is ${String(manifest.version)}, whitelist is ['0.1.2-rc.1']; disable or uninstall the plugin`);
+    for (const anchorPackage of GATE_ANCHOR_PACKAGES) {
+        const specifier = `${anchorPackage}/package.json`;
+        const resolved = internal.version === 'v2'
+            ? internal.resolveSync(baseUrl, { specifier, attributes: {} })
+            : internal.resolveSync(specifier, baseUrl, {});
+        const manifestUrl = resolved?.url;
+        if (typeof manifestUrl !== 'string') {
+            throw new Error(`@iasiv5/dsh-skip-browser-auth: gate anchor ${anchorPackage} did not resolve; whitelist is ['${GATE_VERSION}']; disable or uninstall the plugin`);
+        }
+        const manifest = JSON.parse(readFileSync(fileURLToPath(manifestUrl), 'utf8'));
+        if (manifest.version !== GATE_VERSION) {
+            throw new Error(`@iasiv5/dsh-skip-browser-auth: gate anchor ${anchorPackage} manifest is ${String(manifest.version)}, whitelist is ['${GATE_VERSION}']; disable or uninstall the plugin`);
+        }
     }
     // (b) 绑定断言：官方行被禁用是 Replacement 放行的前提，且不得有活跃 fiber。
     const official = current.parent.tree.resolve('connection');

package/package.json

@@ -1,8 +1,18 @@
 {
   "name": "@iasiv5/dsh-skip-browser-auth",
-  "version": "0.1.0",
-  "description": "个人自用：在 DSH 0.1.2-rc.1 上跳过 BrowserAuth 的 trusted-network Connection 替换插件",
+  "version": "0.1.2",
+  "description": "DSH 0.1.2-rc.1 专用：自动跳过 BrowserAuth，免每次在启动 URL 后输入随机 token；其它版本（含 0.1.1-rc.2）自动休眠，不修改任何 DSH 本体与机制",
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "browserauth",
+    "cordis"
+  ],
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/iasiv5/dsh-skip-browser-auth.git"
+  },
   "type": "module",
   "main": "lib/host.js",
   "exports": {
@@ -42,9 +52,6 @@
       "immediately": true
     }
   },
-  "dependencies": {
-    "@deepseek-ai/dsh-client-connection": "0.1.2-rc.1"
-  },
   "peerDependencies": {
     "@deepseek-ai/cordis": "*",
     "@deepseek-ai/schemastery": "*"
@@ -53,6 +60,7 @@
     "@deepseek-ai/cordis": "4.0.2",
     "@deepseek-ai/cordis-plugin-include": "1.0.7",
     "@deepseek-ai/cordis-plugin-loader": "1.0.3",
+    "@deepseek-ai/dsh-client-connection": "0.1.2-rc.1",
     "@deepseek-ai/dsh-credentials": "0.1.2-rc.1",
     "@deepseek-ai/dsh-credentials-local": "0.1.2-rc.1",
     "@deepseek-ai/dsh-host-frontend-static": "0.1.2-rc.1",