前言¶
给 DeepSeek Harness（DSH）代理接浏览器能力时，常见路线是 Playwright：无头环境、独立的自动化 profile，登录态和 cookies 与用户日常浏览器完全分离，安装时还要先跑一遍 npx playwright install。如果任务需要复用已登录的站点，这条路要额外做很多事。
dsh-jiey-browser 换了一种做法：它通过 MCP 把真实的 Jiey Chromium（也就是用户自己的浏览器）交给代理使用，而不是另起一个无头环境。下面介绍这个插件能做什么、怎么装、怎么用。
这是什么¶
dsh-jiey-browser 是由 jiewaigongxing 维护的 DSH 插件，定位一句话：通过 MCP 为 DSH 代理提供真实的 Jiey Browser 工具。当前版本 0.1.4，MIT 许可证，依赖 @modelcontextprotocol/sdk ^1.30.0 与 @deepseek-ai/schemastery ^3.18.1，@deepseek-ai/cordis（>=4.0.1 <5）为可选 peer 依赖。
需要注意的背景：DSH 目前处于 developer preview，本插件面向 Cordis / tools + systemPrompt 接口，DSH 破坏 API 时插件可能需要随之更新。
核心功能¶
插件提供 7 个工具，各自映射到 Jiey MCP 的对应接口：
| 工具 | 对应 Jiey MCP | 作用 |
|---|---|---|
browser_open |
tabs 新建 + snapshot |
打开页面 |
browser_navigate |
navigate |
页面跳转 |
browser_snapshot |
snapshot |
生成供 browser_act 使用的 refs |
browser_read |
read |
抓取 Markdown / 纯文本 |
browser_act |
act |
click / fill / press 等操作 |
browser_screenshot |
screenshot |
返回内联图片，不写临时文件 |
browser_tabs |
tabs list/close |
列出 / 关闭标签页 |
除工具本身，还有几个值得说明的设计：
1、自动发现 Jiey MCP 服务，顺序为：插件 serverUrl → BROWSEROS_URL / JIEY_URL → ~/.browseros/server.json → http://127.0.0.1:9100。
2、健康检查：GET /system/health 须返回 { status: "ok" }。
3、通过 scopeId 请求头实现标签页隔离，Cordis dispose 时会关闭插件自己打开的标签页。
4、Jiey 缺失或离线时，工具会失败并附官方下载页链接，而不是静默回退到其他浏览器。
安装与启用¶
先确认三件事：Node.js 版本满足 ^22.19 || >=24；已有一个 DSH profile；已安装并打开 Jiey Browser，使其 MCP 服务可用（默认 http://127.0.0.1:9100）。Jiey 只能从官网下载：https://www.gongxingglobal.com/browser，macOS / Windows / Linux 安装包在官网列出，仓库本身不提供 CDN 链接。
从 npm 安装：
dsh plugin --profile web add dsh-jiey-browser
# 或
npm install dsh-jiey-browser
如果是本地 checkout，先构建再安装：
dsh plugin --profile web add /absolute/path/to/packages/dsh-jiey-browser
然后在 profile 的 cordis.patch.yml（或 DSH 设置界面）里配置：
- id: jiey-browser
config:
serverUrl: "" # 留空 = 自动发现
scopeId: dsh-jiey-browser # 标签页隔离请求头
allowCookies: false # 默认不复用登录态
downloadUrl: https://www.gongxingglobal.com/browser
maxSnapshotChars: 40000
serverUrl 留空即走上面的自动发现链路；allowCookies 默认 false，不要复用登录态和用户标签页，只有用户明确要求代理使用已登录站点时才打开。
典型用法¶
不装 DSH 也能本地验证插件与 Jiey 的链路。先启动 Jiey，再执行：
npm install
npm run build
npm run smoke
Jiey 运行时，冒烟测试会打开 https://example.com、做一次快照，然后关闭标签页。
实际给代理用时，典型流程是：browser_open 打开页面 → browser_snapshot 拿到 refs → browser_act 执行点击、填表等操作；需要文本内容用 browser_read，需要确认页面状态用 browser_screenshot。
适用场景与注意¶
适合的场景：需要代理在真实浏览器里打开、读取、操作网页；希望隔离各自的标签页、结束时自动清理；在用户明确同意的前提下复用已登录站点。
使用时注意：
1、安全上，allowCookies 默认 false，仅在用户明确要求代理使用已登录站点时开启。
2、Jiey 离线时工具会失败并附官方下载页链接（默认 https://www.gongxingglobal.com/browser），不会静默换浏览器。
3、插件以当前 dsh 进程的权限运行，安装前建议先检查源码与许可证（本项目为 MIT）。
4、DSH 处于 developer preview，插件面向 Cordis / tools + systemPrompt 接口，后续 DSH 破坏 API 时可能需要更新插件。
结尾¶
dsh-jiey-browser 做的事情很集中：把用户真实的 Jiey 浏览器以 7 个 MCP 工具的形式接进 DSH，登录态、标签页隔离、清理策略都有明确默认值。如果你在给 DSH 代理配联网能力，可以看看：
- 社区目录页（独立站点，与 DeepSeek / 幻方无官方从属关系）：
https://www.skillhub.cn/plugins/jiewaigongxing/dsh-jiey-browser - GitHub 仓库：
https://github.com/jiewaigongxing/dsh-jiey-browser
