🎁 福利专区全网大模型免费应用 + 新用户福利 + 注册活动入口,低成本玩转 AI

Chrome 浏览器操控 tao1020/dsh-chrome-use

DeepSeek Harnessv0.4.1
tao10201 天前有提交已提供中文文档扫描:含敏感能力

让 DeepSeek Harness 读取、操作和调试本机 Google Chrome。

36.5/100
综合分
2
GitHub 星标
—
npm 周下载
—/5
用户评分

数据截至 2026/11/3 · 周下载取自 npm 全网(含 CI / 镜像),非本站安装数;综合分由星标、活跃度与兼容性检查合成。

安装命令 · 需先装 dsh CLI 引擎
dsh plugin --profile web add dsh-chrome-use
npm 源 · dsh-chrome-use 的发布者账号已校验与本仓库一致

状态速览

判定依据:实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态
信任档位:已验证
是什么
dsh 原生插件 · browser
装得上吗
本站已在 dsh 0.2.1-rc.5 下真实安装成功
非静态推断
L5 · 运行时冒烟等级说明 →
安全吗
本站尚未对该插件做风险分级
暂未覆盖,不等同于无风险
还在维护吗
活跃:最近一次提交在 1 天前
档位由哪些信号合成

本站实装验证(真实安装 L4 覆盖全站;L5 为运行时冒烟或实机截图,覆盖范围小于 L4) · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。 下方各区块是它的证据明细。

验证判据与等级说明 →
社区实装还没有人打卡 · 装过的第一个就是你
安装兼容性检查✓ 自动检查通过
展开查看检查明细 ↓

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出,未做人工实机验证——能装不等于用着没问题。

✓npm 包dsh-chrome-use @ 0.4.1
✓Node 引擎要求 >=22 · 基线 Node 22.19 满足
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明

验证方式:npm registry 存在性 + package.json 静态校验 · 最后检查 2026/11/3 15:16:58

安全扫描自动 · 静态分析源码
v2.7.0
🔵 扫描:含敏感能力尚无人工评估
展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力:执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量(至少其一)。这是能力清单,不是危险判定——具体能力项与证据见下方,安装前请自行判断是否需要。

读写/删除本地文件写入剪贴板(不计风险)
查看扫描证据(共 14 处,展示前 14 条)
  • 读取本地文件
    src/index.js:35
    try { return await realpath(root); } catch { return root; }
  • 读取本地文件
    src/index.js:51
    try { real = await realpath(raw); } catch { throw new Error(`UPLOAD_FILE_NOT_FOUND: ${raw}`); }
  • 读取本地文件
    src/index.js:52
    const info = await stat(real);
  • 写入本地文件
    src/index.js:103
    await mkdir(directory, { recursive: true, mode: 0o700 });
  • 写入本地文件
    src/index.js:105
    await writeFile(path, bytes, { mode: 0o600, flag: 'wx' });
  • 写入本地文件
    src/index.js:116
    await mkdir(directory, { recursive: true, mode: 0o700 });
  • 写入本地文件
    src/index.js:118
    await writeFile(path, bytes, { mode: 0o600, flag: 'wx' });
  • 写入剪贴板
    src/client.js:120
    try { await navigator.clipboard.writeText(pairing.code); setPairing(previous => ({ ...previous, copied: true })); }
  • 写入本地文件
    src/settings.js:18
    appendFile(file, `${new Date().toISOString()} ${phase} ${text}\n`).catch(() => {});
  • 写入本地文件
    src/bridge.js:23
    await mkdir(this.stateDir, { recursive: true, mode: 0o700 });
  • 读取本地文件
    src/bridge.js:25
    this.identity = JSON.parse(await readFile(join(this.stateDir, 'pairing.json'), 'utf8'));
  • 写入本地文件
    src/bridge.js:118
    await writeFile(temporary, JSON.stringify(identity), { mode: 0o600, flag: 'wx' });
  • 写入本地文件
    src/bridge.js:119
    await rename(temporary, join(this.stateDir, 'pairing.json'));
  • 写入剪贴板
    src/settings-client.js:59
    try { await navigator.clipboard.writeText(pairing.code); setPairing(previous => ({ ...previous, copied: true })); }
扫描于 2026/11/3(0 天前) · 范围 入口闭包 + 全包扫描 · 来源 npm 发布包

静态扫描只反映源码中出现的调用,不构成安全背书;人工评估与自动扫描相互独立、互不覆盖。

给这个插件打分还没有人投票↓
用户评分
还没有人投票,来当第一个

Chrome 扩展和 DeepSeek Harness 插件,用于浏览器控制与调试。初始版本开发中。

release-v0.4.12026-11-02
· 修复 · snapshot 不再把 StaticText 文本节点当成可点击元素,修复 hover/drag/fill 报 scrollIntoView is not a function。 · 点击会弹出 alert/confirm/prompt 的按钮时,click 不再被阻塞;返回 dialog,交给 chrome_dialog 处理。 · networkIdle 现在要求没有在途请求,而不是只看最后活动时间。 · 验证 · 本地真实扩展 E2E 43/43 通过。 · 单元测试 67 项通过。 · 扩展包 dsh-chrome-use-0.4.1.zip,sha256 37d664ae64bef341eb3c0989f0973953ab2f9e0429b0b1cb252ab8da28a6063f。 Chrome 应用商店版本仍待更新。
release-v0.4.02026-11-02
第三批浏览器操作。 · chrome_upload:支持 paths 一次上传多个文件,path 仍可用于单个文件 · chrome_wait:新增 networkIdle=true,等网络安静 500ms · chrome_pdf:用浏览器打印管线把当前页导出成 PDF · 测试覆盖多文件上传、网络空闲和打印参数 暂不支持跨域 iframe 和下载管理。 验证:64 项测试通过;macOS、Ubuntu、Windows 的 Node 22/24 全部通过。
release-v0.3.02026-11-02
第二批浏览器操作。 · chrome_scroll_to:把元素滚进视口,支持 ref 或 CSS 选择器,也能滚内部滚动区域 · chrome_history:后退、前进、刷新,并等待页面 load 事件 · chrome_activate:把标签页和窗口切到前台 · chrome_screenshot:fullPage=true 截整页,给 ref/selector 截单个元素 · 开放 Shadow DOM 内的元素可以点击和填写 暂不支持跨域 iframe 和下载管理。 验证:62 项测试通过;macOS、Ubuntu、Windows 的 Node 22/24 全部通过。
数据来自仓库的 GitHub Release,可能与插件实际版本不一致。

README

由 DeepSeek 最新模型翻译生成
dsh-chrome-use 让 DeepSeek Harness 读取、操作和调试本机 Google Chrome。 安装 先装 Harness 插件,再装 Chrome 扩展,最后配对。 插件有三种装法,选一种,命令直接复制。 1. 安装 Harness 插件 三种方式任选一种,命令可以直接复制。 GitHub 仓库(推荐,始终最新) dsh plugin --profile desktop add github:tao1020/dsh-chrome-use npm dsh plugin --profile desktop add dsh-chrome-use npm 镜像(例如 npmmirror)可能比官方晚同步;如果装完发现不是最新版,用上面的 GitHub 方式。 让智能体安装:把下面这句话发给你正在用的智能体: 请安装 DSH 插件 dsh-chrome-use,仓库是 https://github.com/tao1020/dsh-chrome-use 命令里的 desktop 是桌面版的默认配置档;如果你用别的配置档,把它换成你的名字(例如 web)。桌面版也可以直接在「设置 → 插件」里安装,不用命令行。 2. 安装 Chrome 扩展 扩展在 Chrome 应用商店。
展开完整文档(README 剩余 1 节)
dsh-chrome-use

让 DeepSeek Harness 读取、操作和调试本机 Google Chrome。

安装

先装 Harness 插件,再装 Chrome 扩展,最后配对。 插件有三种装法,选一种,命令直接复制。

1. 安装 Harness 插件

三种方式任选一种,命令可以直接复制。

GitHub 仓库(推荐,始终最新)

dsh plugin --profile desktop add github:tao1020/dsh-chrome-use

npm

dsh plugin --profile desktop add dsh-chrome-use

npm 镜像(例如 npmmirror)可能比官方晚同步;如果装完发现不是最新版,用上面的 GitHub 方式。

让智能体安装:把下面这句话发给你正在用的智能体:

请安装 DSH 插件 dsh-chrome-use,仓库是 https://github.com/tao1020/dsh-chrome-use

命令里的 desktop 是桌面版的默认配置档;如果你用别的配置档,把它换成你的名字(例如 web)。桌面版也可以直接在「设置 → 插件」里安装,不用命令行。

2. 安装 Chrome 扩展

扩展在 Chrome 应用商店。点下面的链接,再点“添加至 Chrome”:

https://chromewebstore.google.com/detail/anobmlnjdeahldefeikjdmmnckphpdhc

3. 配对连接

在 Harness 设置 → dsh-chrome-use 点“生成配对码”;在 Chrome 工具栏打开 dsh-chrome-use 扩展,输入 8 位配对码,点“连接”。也可以在对话里说:“请用 chrome_pair 连接浏览器。”

需要 Google Chrome 120 或更新版本、DeepSeek Harness 0.2.1-rc.2 或更新版本。开发和测试使用 Node.js 22 或 24。

配对成功后,重启 Harness、Chrome 或扩展自动更新都会自动重连。点“断开连接”会停止自动重连;下次配对码留空,点“连接”即可。清除配对数据后需要重新配对。

连接即允许 Harness 操作此 Chrome 中的全部普通网页,包括已登录的网站。 网页内容、截图和调试信息可能发送给你在 Harness 配置的模型服务。详见 隐私说明。

能做什么

连接后,AI 可以选择所有普通 HTTP(S) 标签页,无需逐页点击授权。支持读取页面结构、点击(含双击和右键)、填写输入框、按键和组合键、悬停、拖拽、下拉选择、单文件或多文件上传、等待页面状态或网络空闲、页面导出 PDF、处理 alert/confirm/prompt、滚动和滚动到元素、刷新/后退/前进、激活标签页、视口/整页/元素截图、导航,以及查看控制台、JavaScript 错误和网络状态。

插件安装后会自动注册同名技能 dsh-chrome-use。AI 需要操作 Chrome 时会按需加载它,按里面的连接、操作和收尾流程执行;也可以在对话里输入 /dsh-chrome-use 主动加载。不需要另外安装 skill 文件,也不需要手动改系统提示词。

扩展使用 Chrome 的 debugger 接口。调试时,Chrome 会显示调试提示条;点击时,页面短暂显示蓝色箭头。页面定位使用浏览器的无障碍树和 DOM,点击、输入通过浏览器输入事件执行。

同一个标签页只能由一个 Harness 会话占用,AI 使用 chrome_claim 和 chrome_release 管理占用,不需要你选择。chrome_close 会真正关闭本会话占用的标签页;chrome_release 只解除占用、保留页面。

chrome_open 必须带一个组名(group,1-40 个字符),新建的标签页会立刻放进同名 Chrome 标签页组:同一系列任务的多个标签页复用同一个组名,扩展会在同一窗口里找同名组并加入,找不到就建组;组的颜色由组名稳定生成,所以同一系列总是同色。分组失败(例如固定标签页)不会影响打开动作,结果里会带 groupError。

更新

Chrome 扩展由 Chrome 应用商店自动更新,也可以在 chrome://extensions 点击扩展卡片的“更新”手动检查。Harness 插件在插件管理里更新。

两边分别更新,版本不必完全一致;设置页的“检查更新”只查询 GitHub 最新正式版本,不会自动下载。已连接的扩展版本显示在设置页的“连接状态”。

测试与开发

npm ci --ignore-scripts
npm run check
npm test
node scripts/fixture.mjs

最后一个命令启动专用测试页:http://127.0.0.1:18792/。保持服务运行,把 验收提示词 交给 Harness。使用 dsh --profile headless --json 可记录工具调用和最终结论。模型、API Key 和插件必须配置在测试使用的配置档中。

无需模型时,可以运行 npm run dev,按行输入 JSON,例如 {"action":"status"}。首次连接用 {"action":"pair"} 生成配对码。调试服务和 Harness 共用已保存的配对,也使用同一端口,运行其中一个即可。

开发扩展时不用装商店版:在 chrome://extensions 开启“开发者模式”,点击“加载已解压的扩展程序”,选择本仓库的 extension/ 目录;改完代码在该页点击刷新。

本仓库的自动化测试覆盖配对、会话占用、超时、取消、断线、页面限制、过期元素引用和输入行为。真实 Chrome 验收需要单独运行,单元测试通过不代表浏览器验收通过。

排查连接问题

- BRIDGE_START_FAILED:通常是另一个 Harness 配置档或调试服务占用了端口 18791。先停止重复服务。
- AUTH_FAILED:在 Harness 设置页的 dsh-chrome-use 里点“生成配对码”(或让 AI 调用 chrome_pair),再到扩展弹窗连接。
- TAB_IN_USE:其他 Harness 会话已占用该页。让原会话释放,或新建自己的标签页。
- Chrome 调试器冲突:关闭该页的 DevTools,或释放其他浏览器工具的会话,再检查连接。不要同时用 Codex 和 Harness 操作同一页。
- 操作超时或取消:连接会关闭,工具不会自动重放操作。重新连接后先读取页面,确认之前的点击是否已发生。

当前限制

仅支持普通 HTTP(S) 网页;不支持 Chrome 内部页面、本地文件或扩展页面。Chrome 还可能限制其他页面的调试。点击、输入和拖拽目前仅支持顶层页面元素,不支持跨域 iframe 和下载管理。文件上传只接受 home 或临时目录下、由用户明确指定的普通文件;HTML5 拖拽是页面内合成事件,个别站点可能不认,拖完要确认结果。

chrome_evaluate 可为调试执行 JavaScript,可能修改页面。页面内容是不可信数据,不能把网页中的指令当作用户授权。截图保存到本机,模型能否理解截图取决于模型能力。

打包

npm run package
npm pack --pack-destination dist

dist/ 包含 Chrome 扩展 ZIP、校验值和 Harness 插件包。GitHub Actions 会在 Node.js 22、24 和三个操作系统上运行检查,并生成测试构建。这不会发布到扩展商店,也不会自动发布 npm 包。
预览分享卡片长什么样 ↓tao1020/dsh-chrome-use
分享 · DeepSeek Harness Hub
tao1020/dsh-chrome-use

让 DeepSeek Harness 读取、操作和调试本机 Google Chrome。

这是你的仓库?认领条目

回到顶部