让 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-usenpm 源 · dsh-chrome-use 的发布者账号已校验与本仓库一致
状态速览
判定依据:实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态信任档位:已验证
是什么
dsh 原生插件 · browser
安全吗
本站尚未对该插件做风险分级
暂未覆盖,不等同于无风险
还在维护吗
活跃:最近一次提交在 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🔵 扫描:含敏感能力尚无人工评估展开查看扫描说明与证据 ↓
安全扫描自动 · 静态分析源码
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 插件,用于浏览器控制与调试。初始版本开发中。
最近更新
在 GitHub 查看全部 →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 包。预览分享卡片长什么样 ↓
分享 · DeepSeek Harness Hub
tao1020/dsh-chrome-use
让 DeepSeek Harness 读取、操作和调试本机 Google Chrome。
相关插件 · 浏览器
智能体插件框架deepseek-ai/deepseek-harness
DeepSeek Harnessdsh是由 DeepSeek AI 开发的开源 agent harness智能体框架。
★ 270,422已汉化DSH
71.9
多设备 Agent 看板YaoApp/yao
✨ 所有 Agent 和工作区集中管理,覆盖你的每一台设备。任务看板追踪进度,桌面端、移动端、浏览器、API…
★ 8,147已汉化DSH
71.2
可扩展侧边栏工作台omdsh-dev/DSH-better-sidebar
DSH 的双工作台:原生右侧栏 + 自绘底部面板,并把 ctx.betterSidebar 服务开放给所有插件
★ 4,761已汉化DSH
71.1
浏览器自动化桥Tencent/BrowserSkill
你的 Agent。你的浏览器。连接,就能协作。
★ 9,967已汉化DSH
71
AI 小说创作工作台EthanYoQ/AI-Novel-Writer
AI 小说作家 / AI Novel Writer
★ 1,591已汉化DSH
70.7
智能体浏览器引擎platonai/Browser4
DeepSeek Harness 集成
★ 1,175已汉化DSH
70.4
这是你的仓库?认领条目