界面与主题 · v0.8.3
dsh-browser-service
给 DSH 一个能跑在无 root、无 GUI 容器里的浏览器。 一个包、一条 dsh plugin add 装完即用:单例 CDP 守护进程(用户态 chrome-headless-shell,只绑回环、带 Bearer token 门)+ 完整的 33 个 browser_ 工具面 + ctx.browser 接缝的 cdp-daemon provider + 一个网页浮动窗口(实时画面可点可打字)+ 两份随包全局技能。
作者原文(英文)
一个包把 DSH 接上自建的无头浏览器:单例 CDP 守护进程 + 33 个 browser_* 工具面 + ctx.browser provider(cdp-daemon),另带网页面板(实时画面/日志/窗口外观/可拖动胶囊)与两份随包全局技能(browser、browser-runtime)—— 一条 dsh plugin add 装完即用
简介取自插件自己的 README 原文。
安装命令
dsh plugin --profile web add dsh-browser-service@0.8.3
已试装 · 层已挂载
已在一个隔离的 profile 里真装过:包能装上,并且插件层挂载成功。这一条是实测结果,不是作者的声明。
检测报告
能力清单
- 可执行外部程序
spawns-processes高关注9 处命中plugin/lib/index.js:7import { exec } from 'node:child_process';bin/browsersvc.mjs:12import { spawn } from 'node:child_process';src/daemon.mjs:6import { spawn } from 'node:child_process';scripts/lib/host-peers.mjs:12import { spawnSync } from 'node:child_process';- 看它调用哪些程序。调用本机已有的工具是常见做法。
- 以 shell 执行命令
shell-exec高关注2 处命中scripts/verify-data.mjs:101const stdout = execFileSync(process.execPath, [CLI, ...args, `--root=${root}`, `--port=${PORT}`], { encoding: 'utf8' });scripts/verify-data.mjs:167const opsLines = execFileSync(process.execPath, [CLI, 'ops', `--root=${root}`, `--port=${PORT}`], { encoding: 'utf8' });- 看命令字符串是拼出来的还是写死的。拼接用户输入才是真正的风险。
- 写入文件
writes-files需留意50 处命中tools/seam-probe/index.js:16appendFileSync('/tmp/m2-seam-probe.log', `${new Date().toISOString()} pid=${process.pid} ${line}\n`);plugin/lib/provider.js:46* 第一次写入时由 `mkdir(…, {recursive:true})` 建出来。plugin/lib/provider.js:435mkdirSync(dir, { recursive: true, mode: 0o700 });plugin/lib/provider.js:439rmSync(join(dir, name), { force: true });- 看写入位置。写自己的配置目录是正常的,写系统目录不是。
- 发起网络请求
network需留意34 处命中plugin/client.js:874const res = await fetch(path, {plugin/client.js:1483const res = await fetch(url, { cache: 'no-store' });plugin/client.js:1523const res = await fetch(LIVE_STATE_PATH, { cache: 'no-store' });plugin/client.js:1546void fetch(LIVE_INPUT_PATH, { method: 'DELETE' }).catch(() => {});- 看请求发往哪些域名。发往作者自己的后端是常见做法。
- 可终止进程
kills-processes需留意6 处命中bin/browsersvc.mjs:164process.kill(pid, sig);src/daemon.mjs:31process.kill(pid, 0);scripts/verify-daemon.mjs:281process.kill(before.browserPid, 'SIGKILL');scripts/verify-daemon.mjs:372process.kill(kernelPid, 0);- 看它终止的是自己启动的进程,还是按名字匹配到的任意进程。
- 启动伪终端
spawns-pty需留意2 处命中scripts/lib/host-peers.mjs:19const which = spawnSync('sh', ['-c', `command -v ${dshBin}`], { encoding: 'utf8' }).stdout.trim();scripts/verify-matrix.mjs:49const which = spawnSync('sh', ['-c', `command -v ${bin}`], { encoding: 'utf8' }).stdout.trim();- 伪终端等于给了一个完整 shell。确认这是插件的核心功能。
- 动态执行代码
dynamic-code需留意1 处命中plugin/lib/provider.js:874const expression = `(function(){ return eval(${JSON.stringify(script)}); }).apply(null, ${JSON.stringify(args)})`;- 看 eval / new Function 的入参来自哪里。常量字符串和用户输入是两回事。
- 读取文件
reads-files一般117 处命中plugin/lib/panel.js:30return JSON.parse(readFileSync(new URL('../../package.json', import.meta.url), 'utf8')).version ?? '';plugin/lib/provider.js:32if (!existsSync(bin)) return undefined;plugin/lib/provider.js:51if (typeof xdg === 'string' && xdg !== '' && existsSync(xdg)) return xdg;plugin/lib/provider.js:54if (existsSync(candidate)) return candidate;- 读文件是绝大多数插件的正常工作方式,本身不构成顾虑。
- 读取环境变量
reads-env一般49 处命中tools/seam-probe/index.js:13const TARGET_URL = process.env.M2_PROBE_URL || 'http://127.0.0.1:9413/';tools/seam-probe/index.js:54if (process.env.M2_PROBE_HOLD) setInterval(() => {}, 60000);plugin/lib/provider.js:50const xdg = process.env.XDG_DOWNLOAD_DIR;README.md:140TOKEN=$(node -p 'JSON.parse(require("fs").readFileSync(process.env.DSH_HOME+"/browser-service/service.json","utf8")).tok…- 环境变量里常混有密钥。看它是否把整个 env 都读走。
- 动态加载模块
dynamic-import一般25 处命中plugin/lib/compat.js:69return require(`${spec}/package.json`).version ?? undefined;plugin/lib/index.js:164seamBrowser = await import(`${SEAM_PACKAGE}/browser`);plugin/lib/index.js:165seamTools = await import(`${SEAM_PACKAGE}/tool-browser`);plugin/lib/index.js:190({ chromium } = await import('playwright-core'));- 动态导入本身无害,但会让依赖关系难以静态审阅。
- 文中出现远程脚本地址
remote-url-reference一般3 处命中README.md:282- 取帧走 [`plugin/lib/liveview.mjs`](https://github.com/lyp88997/dsh-browser-service/blob/main/plugin/lib/liveview.mjs):`Pa…README.md:321宿主半边 [`plugin/lib/panel.js`](https://github.com/lyp88997/dsh-browser-service/blob/main/plugin/lib/panel.js) 在 `ctx.webSe…README.md:334客户端半边 [`plugin/client.js`](https://github.com/lyp88997/dsh-browser-service/blob/main/plugin/client.js) 手写、零构建,走 DSH 的 `w…- 只是文本里出现了远程脚本地址,没有看到加载它的调用。多半是文档或注释;若确实可疑,搜一下这个地址在包里的其他出现位置。
逐条扫描明细
| 能力 | 标识 | 关注度 | 命中次数 |
|---|---|---|---|
| 可执行外部程序 | spawns-processes | 高关注 | 9 |
| 以 shell 执行命令 | shell-exec | 高关注 | 2 |
| 写入文件 | writes-files | 需留意 | 50 |
| 发起网络请求 | network | 需留意 | 34 |
| 可终止进程 | kills-processes | 需留意 | 6 |
| 启动伪终端 | spawns-pty | 需留意 | 2 |
| 动态执行代码 | dynamic-code | 需留意 | 1 |
| 读取文件 | reads-files | 一般 | 117 |
| 读取环境变量 | reads-env | 一般 | 49 |
| 动态加载模块 | dynamic-import | 一般 | 25 |
| 文中出现远程脚本地址 | remote-url-reference | 一般 | 3 |
这份报告的口径
扫描读的是包里的源码,全程不执行第三方代码。 本次读了 41 个文件,扫描于 2026-10-15。 命中次数只说明源码里出现过这类调用,不说明行为好坏——一个插件读写文件 500 次和 1 次 都会被记为「读取文件」。这是能力清单,不是信任评分,也不是安全结论: 没扫出来的能力可能只是写法没被规则覆盖。
可信度
- -5cordis entry id「browser」被 5 个包共用,同时安装会互相替换warn:@anweat/dsh-browser、dsh-agent-browser、dsh-plugin-browser、dsh-plugin-browser-use
认证等级 L0
- L0静态结构与契约✓sha512-z8QEUfPMFHq06d3c… 与本地 tarball 复算一致,补丁与入口齐备
- L1配置组合与依赖图—entry id browser 被 5 个包共用
- L2隔离沙箱冒烟✓隔离 profile 安装成功,3.4s,层已挂载;宿主带它启动(booted)(前一级未通过,本项不计入等级)前一级未通过,不计入等级
- L3运行时健康监控✓抽样会话内未观测到外部进程 / 越界写 / 外连(2 个事件)(前一级未通过,本项不计入等级)前一级未通过,不计入等级
评分口径与作者信息
从 100 分开始按规则扣减:fail −20 / major −10 / warn −5 / minor −2;star 数、下载量、LLM 输出都不参与评分
- 维护者
- xyphok
- 仓库
- https://github.com/lyp88997/dsh-browser-service
- 许可
- MIT
- 最后发布
- 2026-10-03
- 周下载
- 350
- star
- 0
扫描状态:已扫描。能力是事实,不是缺陷; 周下载与 star 只作参考,不参与评分。
认证等级只回答四件事:包本身是否完整可解析(L0)、能不能与别的插件组合(L1)、隔离环境里装不装得上并起得来(L2)、抽样运行时有没有异常(L3)。依赖漏洞、仓库存活、下载量都不参与评级,只作为独立信号标注。可信 ≠ 无漏洞,上架 ≠ 推荐。
| Node 要求 | >=22.19 |
|---|---|
| 第三方依赖 | 2 个 |
| bundle patch | ./plugin/cordis.patch.yml |
| 依赖安全公告 | 已查询全部依赖,没有匹配到已公开的安全公告(含 DSH 框架包在内的 @deepseek-ai/* 不作查询——那是运行时自己的问题,不是插件的。) |
元数据
| 主页 | https://github.com/lyp88997/dsh-browser-service#readme |
|---|---|
| 仓库最近提交 | 2026-10-03 |
| 仓库创建 | 2026-09-26 |
DSH