Replaces the DSH Web connection provider to skip BrowserAuth entirely so the Web UI opens directly without pasting the random startup token, gated to nine verified DSH version pairs with strict host/client matching that sleeps automatically on unknown or mixed versions, and reverts fully on uninstall; web profiles only.
Install
# from npm (prebuilt)
dsh plugin --profile web add @iasiv5/dsh-skip-browser-auth
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:iasiv5/dsh-skip-browser-auth
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
README
This plugin publishes its README in Chinese only.
个人自用的 DSH Web 插件:在已验证的 DSH compatibility profile 上自动跳过 BrowserAuth,打开 Web 地址即可直接使用,不必每次把启动 URL 里那串随机 token 抄进浏览器。
- 精确 profile 门控:当前支持
0.1.2-rc.1、0.1.5-rc.1、0.1.5-rc.2、0.1.7-rc.1、0.1.7-rc.2、0.2.0-rc.1、0.2.0-rc.2、0.2.1-rc.1、0.2.1-rc.2、0.2.1-rc.3、0.2.1-rc.4、0.2.1-rc.5与0.2.2-rc.1,按 host/client 兼容代际分组;不是把所有版本塞进同一个实现。 - 严格成对匹配:runtime
@deepseek-ai/dsh与@deepseek-ai/dsh-client-connection必须组成已知版本对。混合版本、未知版本、profile 未实现或解析失败都会自动休眠。 - 分代适配:
0.1.2-rc.1使用legacy-web-v1;0.1.5-rc.1与0.1.5-rc.2使用carrier-neutral-v2,包含 request body mode、RPC carrier 和对应浏览器 client variant 适配;0.1.7-rc.1、0.1.7-rc.2、0.2.0-rc.1与0.2.0-rc.2使用carrier-neutral-v3,覆盖 0.1.7 引入、0.2.0 沿用的admit()/OperatorPeer 准入、connection/requestwaterfall 与 mount-preserving BrowserAuth;0.2.1-rc.1、0.2.1-rc.2、0.2.1-rc.3、0.2.1-rc.4、0.2.1-rc.5与0.2.2-rc.1使用carrier-neutral-v4,覆盖 0.2.1 的 Peer/principal 准入重构、admission.peer透传 bridge、新/connect交换通道与webStartup信任来源(0.2.1 是真实契约变化,独立代际;rc.2/rc.3/rc.4/rc.5 为契约面等价重发布,0.2.2-rc.1 经逐维替换面审计收编,见 docs/COMPATIBILITY.md §5.8/§5.9/§5.10/§5.11/§5.12/§5.13/§5.14)。 - 不修改 DSH 本体与任何机制:仅通过 DSH 官方插件 patch 机制替换 Connection 行;卸载或禁用插件并重启,即完全恢复官方行为。
- 安全提醒:跳过认证后,Web 对本机/可信网络内的访问不再有身份层,请勿把 DSH 端口暴露给不可信网络。
0.1.5 的官方 Connection 在 carrier-neutral 重构后出现过
connection.rpc.handle()返回 HTTP 405 的回归。本插件对 0.1.5 使用独立 adapter,并通过真实 npm fixture 覆盖 dedicated RPC 与 exact Fetch route;GitHub 审计与根因见 docs/COMPATIBILITY.md。
安装
方式一:从插件市场一键安装(推荐)
本插件已收录进我的 DSH 插件市场 dsh-m(收录 id:dsh-skip-browser-auth)。装好 dsh-m 后,在 Web 侧栏「插件市场」搜索 Skip Browser Auth,即可一键安装 / 更新 / 卸载;也可以直接对 agent 说:
从 dsh-m 插件市场安装 dsh-skip-browser-auth,装完重启 DSH Web。
方式二:直接命令安装
dsh plugin --profile web add @iasiv5/dsh-skip-browser-auth
sudo systemctl restart deepseek-harness.service # 按你的部署方式重启 DSH Web
复制给 agent 的安装提示词
请给我的 DSH Web 安装 @iasiv5/dsh-skip-browser-auth 插件。
它支持的精确 compatibility profile:
- DSH 0.1.2-rc.1:legacy-web-v1
- DSH 0.1.5-rc.1 / 0.1.5-rc.2:carrier-neutral-v2
- DSH 0.1.7-rc.1 / 0.1.7-rc.2 / 0.2.0-rc.1 / 0.2.0-rc.2:carrier-neutral-v3
- DSH 0.2.1-rc.1 / 0.2.1-rc.2 / 0.2.1-rc.3 / 0.2.1-rc.4 / 0.2.1-rc.5 / 0.2.2-rc.1:carrier-neutral-v4
其它版本或 runtime/connection 混合版本会自动休眠,不要强行处理。
desktop 宿主一律自动休眠(多进程树判别:安装槽位/启动器 argv/宿主二进制,0.3.9 起生效),这是设计行为,不要强行处理或改代码绕过;desktop 用户请直接使用 0.3.11+(0.3.6-0.3.10 在 desktop 有已知缺陷,见 docs/COMPATIBILITY.md §7.4)。
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、0.1.5-rc.1、0.1.5-rc.2、0.1.7-rc.1、0.1.7-rc.2、0.2.0-rc.1、0.2.0-rc.2、0.2.1-rc.1、0.2.1-rc.2、0.2.1-rc.3、0.2.1-rc.4、0.2.1-rc.5 或 0.2.2-rc.1:
确认 journal/日志中出现固定警告
"BrowserAuth has been skipped",并验证浏览器直接打开 Web 地址不再要求 token。
4. 若版本不是精确白名单版本,或 profile/依赖契约不匹配:插件应自动休眠,
保持官方行为,不要修改 DSH 本体或强行覆盖版本检测。
卸载
dsh plugin --profile web remove @iasiv5/dsh-skip-browser-auth
sudo systemctl restart deepseek-harness.service
市场安装的用户在「插件市场 → 已装」里点卸载即可。卸载或禁用并重启后,官方 BrowserAuth 完全恢复。
兼容版本与 profile
宿主最低版本声明为 DSH >=0.1.2-rc.1;插件只在下表的精确 runtime/connection 版本对上激活,其他版本或混合版本对自动休眠。
| DSH runtime / connection 版本对 | Profile | Host/client 适配 | 状态 |
|---|---|---|---|
0.1.2-rc.1 + 0.1.2-rc.1 |
legacy-web-v1 |
legacy /api prefix + 0.1.2 client |
✅ active |
0.1.5-rc.1 + 0.1.5-rc.1 |
carrier-neutral-v2 |
carrier-neutral HostConnectionService + 0.1.5 client | ✅ active(代码/真实 npm fixture 已验证;真实部署仍需按清单确认) |
0.1.5-rc.2 + 0.1.5-rc.2 |
carrier-neutral-v2 |
同上(rc.2 为 rc.1 的重发布:代码逐字节一致) | ✅ active(npm diff 审计 + 真实 rc.2 npm fixture 组合测试已验证;真实部署仍需按清单确认) |
0.1.7-rc.1 + 0.1.7-rc.1 |
carrier-neutral-v3 |
carrier-neutral-017:admit()/OperatorPeer + connection/request waterfall + mount-preserving BrowserAuth + 0.1.7 client |
✅ active(npm diff 审计:插件契约面与 rc.2 逐字节一致 + 真实 rc.1 npm fixture 组合测试,见 docs/COMPATIBILITY.md §5.5;真实部署仍需按清单确认) |
0.1.7-rc.2 + 0.1.7-rc.2 |
carrier-neutral-v3 |
同上 | ✅ active(真实 npm fixture 组合测试 + 2026-09-26 实机 checklist 与回滚演练,见 docs/DESIGN.md) |
0.2.0-rc.1 + 0.2.0-rc.1 |
carrier-neutral-v3 |
同上(0.2.0-rc.1 为依赖对齐重发布:插件契约面代码逐字节一致) | ✅ active(npm diff 审计 + 真实 0.2.0-rc.1 npm fixture 组合测试,见 docs/COMPATIBILITY.md §5.6;2026-09-29 实机 checklist 已确认) |
0.2.0-rc.2 + 0.2.0-rc.2 |
carrier-neutral-v3 |
同上(0.2.0-rc.2 为依赖对齐重发布 + 无关 Desktop CLI 演进:插件契约面代码逐字节一致) | ✅ active(npm diff 审计 + 真实 0.2.0-rc.2 npm fixture 组合测试,见 docs/COMPATIBILITY.md §5.7;实机 checklist 见当日升级记录) |
0.2.1-rc.1 + 0.2.1-rc.1 |
carrier-neutral-v4 |
carrier-neutral-021:Peer/principal 准入 + admission.peer 透传 bridge + /connect 交换通道 + webStartup 信任来源 + 0.2.1 browser client |
✅ active(§5.8 契约审计定谳新代际 + 真实 0.2.1-rc.1 npm fixture 组合测试,见 docs/COMPATIBILITY.md §5.9;实机 checklist 待宿主升级后回填) |
0.2.1-rc.2 + 0.2.1-rc.2 |
carrier-neutral-v4 |
同上(0.2.1-rc.2 为契约面等价重发布:web-app patch 仅新增非 connection 行,connection 行逐字段一致) | ✅ active(npm diff 审计 + 真实 0.2.1-rc.2 npm fixture 组合测试,见 docs/COMPATIBILITY.md §5.10;实机 checklist 待宿主升级后回填) |
0.2.1-rc.3 + 0.2.1-rc.3 |
carrier-neutral-v4 |
同上(0.2.1-rc.3 为契约面等价重发布:web-app patch 仅新增非 connection 行,connection 行逐字段一致) | ✅ active(npm diff 审计 + 真实 rc.3 fixture 测试,见 docs/COMPATIBILITY.md §5.11;2026-10-25 Web 实测:BrowserAuth 横幅出现、无 token GET / 返回 200) |
0.2.1-rc.4 + 0.2.1-rc.4 |
carrier-neutral-v4 |
同上(0.2.1-rc.4 为契约面等价重发布:首个 web-app patch 零 diff 的收编轮,connection 行逐字段一致) | ✅ active(npm diff 审计 + 真实 rc.4 fixture 测试,见 docs/COMPATIBILITY.md §5.12;实机 checklist 待宿主升级 rc.4 后回填) |
0.2.1-rc.5 + 0.2.1-rc.5 |
carrier-neutral-v4 |
同上(0.2.1-rc.5 为契约面等价重发布:web-app patch 连续第二轮零 diff,connection 行逐字段一致) | ✅ active(npm diff 审计 + 真实 rc.5 fixture 测试,见 docs/COMPATIBILITY.md §5.13;2026-10-30 Web 实测:BrowserAuth 横幅出现、无 token GET / 返回 200) |
0.2.2-rc.1 + 0.2.2-rc.1 |
carrier-neutral-v4 |
同上(0.2.2-rc.1 机械判级 CONTRACT-CHANGED,逐维审计定性替换面未变后收编:connection lib 与 client bundle 逐字节一致、官方 patch connection 行逐字段一致、webserver/frontend-static/app-boot/runtime 差异均为非替换面演进) | ✅ active(逐维 npm diff 审计 + 真实 0.2.2-rc.1 fixture 测试,见 docs/COMPATIBILITY.md §5.14;实机 checklist 待宿主升级 0.2.2 后回填) |
| desktop profile(存在 dsh-desktop-host 的环境,任意版本对) | — | 😴 dormant-by-design:desktop 一律休眠 | dormant |
| 其它版本或混合版本对 | — | 😴 自动休眠:官方行为分毫不变 | dormant |
白名单匹配的是完整版本对,不是两个独立的 includes():
runtime=0.1.2-rc.1 + connection=0.1.5-rc.1 → dormant
runtime=0.1.5-rc.1 + connection=0.1.5-rc.1 → carrier-neutral-v2
runtime=0.1.5-rc.1 + connection=0.1.5-rc.2 → dormant(同代际跨 patch 混合同样是事故形态)
runtime=0.1.5-rc.2 + connection=0.1.5-rc.2 → carrier-neutral-v2
runtime=0.1.7-rc.1 + connection=0.1.7-rc.1 → carrier-neutral-v3
runtime=0.1.7-rc.1 + connection=0.1.7-rc.2 → dormant(同代际跨 patch 混合同样是事故形态)
runtime=0.1.7-rc.2 + connection=0.1.7-rc.1 → dormant
runtime=0.1.7-rc.2 + connection=0.1.7-rc.2 → carrier-neutral-v3
runtime=0.1.7-rc.2 + connection=0.2.0-rc.1 → dormant(同代际跨 minor 混合同样是事故形态)
runtime=0.2.0-rc.1 + connection=0.1.7-rc.2 → dormant
runtime=0.2.0-rc.1 + connection=0.2.0-rc.1 → carrier-neutral-v3
runtime=0.2.0-rc.1 + connection=0.2.0-rc.2 → dormant(同代际跨 patch 混合同样是事故形态)
runtime=0.2.0-rc.2 + connection=0.2.0-rc.1 → dormant
runtime=0.2.0-rc.2 + connection=0.2.0-rc.2 → carrier-neutral-v3
runtime=0.2.0-rc.2 + connection=0.2.1-rc.1 → dormant(跨代际混合:0.2.1 是真实契约变化)
runtime=0.2.1-rc.1 + connection=0.2.0-rc.2 → dormant
runtime=0.2.1-rc.1 + connection=0.2.1-rc.1 → carrier-neutral-v4
runtime=0.2.1-rc.1 + connection=0.2.1-rc.2 → dormant(同代际跨 patch 混合同样是事故形态)
runtime=0.2.1-rc.2 + connection=0.2.1-rc.1 → dormant
runtime=0.2.1-rc.2 + connection=0.2.1-rc.2 → carrier-neutral-v4
runtime=0.2.1-rc.2 + connection=0.2.1-rc.3 → dormant(同代际跨 patch 混合同样是事故形态)
runtime=0.2.1-rc.3 + connection=0.2.1-rc.2 → dormant
runtime=0.2.1-rc.3 + connection=0.2.1-rc.3 → carrier-neutral-v4
runtime=0.2.1-rc.3 + connection=0.2.1-rc.4 → dormant(同代际跨 patch 混合同样是事故形态)
runtime=0.2.1-rc.4 + connection=0.2.1-rc.3 → dormant
runtime=0.2.1-rc.4 + connection=0.2.1-rc.4 → carrier-neutral-v4
runtime=0.2.1-rc.4 + connection=0.2.1-rc.5 → dormant(同代际跨 patch 混合同样是事故形态)
runtime=0.2.1-rc.5 + connection=0.2.1-rc.4 → dormant
runtime=0.2.1-rc.5 + connection=0.2.1-rc.5 → carrier-neutral-v4
runtime=0.2.1-rc.5 + connection=0.2.2-rc.1 → dormant(同代际跨 minor 混合同样是事故形态)
runtime=0.2.2-rc.1 + connection=0.2.1-rc.5 → dormant
runtime=0.2.2-rc.1 + connection=0.2.2-rc.1 → carrier-neutral-v4
runtime=0.1.7-rc.2 + connection=0.1.5-rc.2 → dormant(跨代际混合)
未来的新版本如果保持同一契约,可以加入对应 profile 的精确版本对;如果发生 API、DI、route、body 或 client bundle 契约变化,必须新增 profile、host adapter 和 client variant,不能 fallback 到旧代际。详细流程见 docs/COMPATIBILITY.md。
机制与安全
- 组合期版本探针使用 runtime 本体与官方 connection 包双锚点,并返回 profile id;路径段和 npm flat manifest 两种布局均支持。任何异常都 fail-closed 到 dormant。
apply()backstop 再读取两个 manifest,验证 active profile、patch 传入的 profile id、官方 connection sibling 行的 id/name/disabled/fiber 状态;不满足时在创建服务、注册 route、输出 warning 前 fail loud。- 宿主 profile 门控(default-deny):激活需要正向 web 证明——宿主二进制为 node/node.exe;desktop 否决双信号 = 宿主 argv 含 dsh-desktop-host(官方 isPackagedDesktopArgv 同款 launcher fact)∨ @deepseek-ai/dsh-desktop-host 可解析。任一不满足即整体安静休眠(desktop 上 Electron 自带 token,插件无收益;0.3.6 的 desktop 判别缺陷已在 0.3.8 修复,见 docs/COMPATIBILITY.md §7)。
legacy-web-v1保留 0.1.2 的/apiprefix 与 buffered bridge。carrier-neutral-v2使用 runtime loader 取得当前 0.1.5 connection module,支持requestBodyMode、exact Fetch route 和 streaming body,并将 genericconnection.rpc.handle()绑定到拥有 Web carrier 的 replacement context,避免 0.1.5 的 405 回归。carrier-neutral-v3在 v2 契约之上复刻 0.1.7 的三处新语义:/api准入改走admit()(OperatorPeer 作为 RPC handler 第 4 参传入)、共享通道请求经connection/requestwaterfall(监听插件继续可见)、BrowserAuth stub 使用 mount-preserving URL 语义(token 清理 303./、启动 URL 保留 mount)。- client bundle 是显式 profile dispatcher:host 通过
webserver/index-inject注入 profile id,0.1.2/0.1.5/0.1.7 代际使用各自官方 factory(0.2.0-rc.1/0.2.0-rc.2与0.1.7契约逐字节一致,共用 0.1.7 factory);0.2.1-rc.1使用 rc21 variant(锚定官方 browser 入口lib/client.browser.js);profile 缺失或未知时不猜测、不加载错误 variant。 - 激活时进程逐字输出固定警告:
@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.
trusted-network mode 的判据只有一个:请求来源是否通过信任栅栏(Host/Origin/Fetch Metadata/trustedHosts)。能通过栅栏的请求一律被接受,不存在身份层,本插件也不校验任何上游反代。
测试与验证
# 安装真实 rc.2 + rc.15 fixture,并运行 build/typecheck/全部 Node tests
npm run test:all
# 单独重建与加载 host
rm -rf lib
npm run build
node --input-type=module -e "await import('./lib/host.js')"
# 确认 patch 生成幂等
npm run build
git diff --exit-code cordis.patch.yml
测试矩阵覆盖:
- 全部 active profile pair、同代际跨 patch/跨 minor 混合、跨代际混合、未知版本和 manifest/path drift
- pnpm 路径段与 npm flat manifest fallback
- legacy buffered bridge 与 carrier-neutral streaming bridge
- 真实 0.1.5 dedicated
connection.rpc.handle()、exact Fetch route 和 405 回归 - 真实 0.1.7
admit()/OperatorPeer、connection/requestwaterfall、mount-preserving token 清理、同代际跨 patch 混合 dormant(rc.1 ↔ rc.2)与跨代际混合 dormant - 真实 0.2.0-rc.1
admit()/OperatorPeer、waterfall、mount-preserving token 清理、跨 minor 混合 dormant(0.1.7 ↔ 0.2.0 双向)与 npm flat 布局 - 真实 0.2.0-rc.2
admit()/OperatorPeer、waterfall、mount-preserving token 清理、同代际跨 patch 混合 dormant(0.2.0-rc.1 ↔ 0.2.0-rc.2 双向)与 npm flat 布局 - 三个官方 client factory 的 materialization、profile dispatcher 和未知 profile fail-closed
- rc.2 dormant 基线、dispose/unload、Host/Origin/Fetch Metadata trust fence
- desktop 宿主 fixture:@deepseek-ai/dsh-desktop-host 桩包在场 + 白名单版本对仍整体休眠(官方行活跃、无插件路由、无横幅)
- desktop 启动器 argv:宿主进程 argv 含 dsh-desktop-host(app.asar 内信号包不可达的 desktop 形态,0.3.6 事故修复)仍整体休眠;web 宿主 argv 不触发
- web 证明:宿主二进制非 node(如 Electron run-as-node 的改名启动器)一律休眠;node/node.exe 正常激活
完整的 GitHub API 审计、profile 数据模型、adapter seam、client 变体和未来新增代际 checklist 见 docs/COMPATIBILITY.md;机制详版见 docs/DESIGN.md。
本插件以 MIT License 发布;包含或移植的 DeepSeek Harness(MIT)代码,其版权与许可声明见 NOTICE。
Links
More in this category
kenryu42/cc-safety-net★ 1900
Pre-execution guard that blocks destructive Git and filesystem commands and access to secrets such as SSH keys and .env files before a tool call runs.
ADWMC/helm-d#helmd★ 984
Security-analysis plugin for DeepSeek Harness: 33 tools spanning six security domains, evidence/reporting and toolbox, plus the case lifecycle, routing and tool ledger; a session-bound case workflow with an evidence chain, E-id validation and reproducible findings; 362 on-demand references; three hot-swappable persona profiles; and a four-tab workbench (armor / case / intercept / about) with case-state recovery after context compaction.
toby-bridges/api-relay-audit★ 904
Runs local security audits of AI API relays and LLM proxies from DeepSeek Harness, producing Markdown reports for prompt injection, model substitution signals, tool-call rewriting, error leakage, stream integrity, and profile-gated Web3 risks.
SeaOf0/dsh-redteam-model★ 807
Authorized-security DSH collection: nine work modes (redteam coordinator, pentest, code audit, binary analysis, attack-defense, AV evasion, incident response, cloud security, CTF solving) and fifteen runtime plugins, managed from a settings page with one-click deploy, install, update and uninstall.
howmp/dsh-pentest★ 616
Authorized pentest mode for DeepSeek Harness — exploration chain, assets and findings with a Web view.
PerryLink/dsh-auto-review★ 244
Second-model auto-review on the approval answerer chain: a read-only reviewer subagent returns structured allow/deny verdicts with reasons, fail-closed by default.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.