titanwings/dsh-better-browser 预览 preview

titanwings/dsh-better-browser

DSH 真实浏览器插件:通过 Kimi WebBridge 让 Agent 操作用户已登录的浏览器,并提供 13 个 webbridge_* 工具。

Project Overview项目介绍

dsh-better-browser is a native plugin built exclusively for DeepSeek Harness (DSH). It adapts the local protocol of Kimi WebBridge to expose 13 browser automation tools that DSH agents can call directly. Unlike isolated headless browsers that require re-login or cookie injection to access authenticated sites, this plugin lets agents operate the user’s own locally running browser, reusing existing login sessions, open tabs, and browser state. To use the plugin, users must first install the Kimi WebBridge daemon and official browser extension available for both Google Chrome and Microsoft Edge via separate installation from Kimi’s official website.

All browser operations for a single task are grouped into a stable session with a dedicated tab group maintained by Kimi WebBridge. This keeps different tasks from interfering with one another, and lets the user inspect or take over the workflow at any point without losing progress. The plugin exposes tools for navigation, element selection, clicking, form filling, page snapshotting, network logging, screenshot capture, PDF export, file upload, and tab/session management. Install the plugin by running the DSH CLI command dsh plugin --profile web add github:titanwings/dsh-better-browser#v0.3.6 then restart your local DSH application.

The plugin enforces several security boundaries to keep the user’s system and browser safe. It blocks navigation to non-web URLs like local files or script protocols, restricts file uploads to the DSH agent’s working directory, and ensures browser operations run serially to avoid overlapping changes to shared tabs. The plugin is open source under the permissive BSD-3-Clause license, and it does not include any code from Kimi WebBridge, which is a separate product owned by Kimi (MoonDark). Before using the plugin, you must verify that Kimi WebBridge is connected to your browser by running kimi-webbridge status and confirming extension_connected returns true.

dsh-better-browser 是 DeepSeek Harness 的原生插件,通过适配 Kimi WebBridge 本地协议为 DSH 中的 Agent 提供 13 个浏览器自动化工具。它允许 Agent 操作用户本机正在运行的真实浏览器,复用已有的登录会话、打开标签页和浏览器状态,替代需要重新登录或注入Cookie的独立无头浏览器。

它支持 Agent 完成从页面导航、元素点击、表单填写到页面快照读取、网络活动检查、截图、保存PDF和上传文件的完整浏览器工作流。每个任务会被归到一个稳定会话对应的独立标签组,不同任务之间互不干扰,用户可以随时查看和接管整个操作过程。

本插件依赖独立安装的 Kimi WebBridge 本地守护进程和浏览器扩展,二者均由月之暗面(Kimi)开发维护。用户可通过 DSH 的 CLI 插件命令将本插件作为 Cordis 包安装,项目采用 BSD-3-Clause 许可证开源,需 Kimi WebBridge 成功连接浏览器扩展后才可正常工作。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 note1 项提示
  • 11 stars - an early-stage project星标 11,属于早期项目
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:titanwings/dsh-better-browser#v0.3.6

把 titanwings/dsh-better-browser 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

🌐 dsh-better-browser

让 Agent 使用你已经登录的真实浏览器。

DeepSeek Harness Version Node.js License GitHub stars


🔐  需要 Agent 操作已经登录的网站,又不想复制 Cookie 或重新登录?
🧭  需要导航、点击、填写、截图和网络检查组成一条完整工作流?
🧠  希望浏览器状态留在本机,而不是不断塞进模型上下文?

✨ dsh-better-browser 把用户真实浏览器变成 13 个 Agent 工具。

通过本机 Kimi WebBridge 复用登录态、已有标签页和活动会话;DSH 负责模型工具, 浏览器状态继续留在浏览器里。

真实浏览器 + 本地桥接 + 13 个工具 → Agent 可执行的完整浏览器工作流


为什么需要它 · 核心能力 · 安装 · 快速开始 · 工具 · 安全边界

English · 简体中文


dsh-better-browser:让 Agent 使用真实浏览器


🎯 为什么需要 dsh-better-browser

无头浏览器适合隔离测试,却无法自然复用你正在使用的登录态、Cookie、标签页和 站点会话。dsh-better-browser 连接 Kimi WebBridge 的本地守护进程,让 DSH 中的 Agent 操作用户自己的浏览器。

无头浏览器 dsh-better-browser
登录态 通常需要重新登录或注入凭据 复用用户浏览器现有状态
标签页 工具独立维护 使用真实标签页与标签组
浏览器状态 容易进入工具输出或模型上下文 保留在浏览器与本地守护进程
适合场景 隔离测试、抓取 登录后工作流、真实页面检查

本插件不包含浏览器驱动代码。真正的浏览器操作由 Kimi WebBridge 守护进程和 浏览器扩展完成;本插件只把它的本地协议适配为 DSH 模型工具。


✨ 核心能力

🌍 操作用户真实浏览器

导航页面、读取无障碍快照、点击、填写与执行 JavaScript,同时保留登录状态和 已经打开的标签页。

🔎 看见页面之外的证据

Agent 可以截图、检查网络活动、上传文件并保存 PDF,不必把整个浏览器状态放进 模型请求。

🗂️ 一个任务,一个标签组

稳定的 session 名把同一任务的标签页归到一起。不同任务互不混用,用户仍然 可以在自己的浏览器中看见并接管全过程。

🔌 零 DSH Core Patch

插件作为 Cordis bundle 安装,注册稳定的 webbridge 行与 13 个 webbridge_* 工具;卸载 bundle 即可移除能力。


⚡ 安装

1. 安装 Kimi WebBridge

Kimi WebBridge 是月之暗面的独立产品,本仓库不包含它的守护进程或浏览器扩展。 请先参考 Kimi 官方产品页与 帮助中心:

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-api-balance 下一个 Next DSHL →