dsh-jiey-browser

DeepSeek Harness plugin that gives the agent real Jiey Browser tools over MCP.

Let DeepSeek Harness go online — one plugin, powered by Jiey.

DSH is in developer preview; this plugin targets the Cordis / tools + systemPrompt surface and may need updates as DSH breaks APIs.

Why Jiey (not Playwright)

	Playwright plugins	dsh-jiey-browser
Runtime	Headless / automation profile	Real Jiey Chromium (user browser)
Install funnel	npx playwright install	Missing Jiey → download guide
Cookies / login	Separate profile	Default off; opt-in to reuse sessions
Cleanup	Controller close	Cordis dispose closes owned tabs

Install

Requires Node.js ^22.19 || >=24 and a DSH profile.

# from npm (public)
dsh plugin --profile web add dsh-jiey-browser
# or
npm install dsh-jiey-browser

From a local checkout after npm run build:

dsh plugin --profile web add /absolute/path/to/packages/dsh-jiey-browser

Source: https://github.com/jiewaigongxing/dsh-jiey-browser
npm: https://www.npmjs.com/package/dsh-jiey-browser
Topics: dsh-plugin, deepseek-harness, dsh.

Prerequisites

Full guide: Use with DeepSeek Harness

1. Install and open Jiey Browser so its MCP server is up (default http://127.0.0.1:9100).
   • Download only from the official site: https://www.gongxingglobal.com/browser
     (macOS / Windows / Linux installers are listed there — this repo does not ship CDN links.)
2. Discovery order: plugin serverUrl → BROWSEROS_URL / JIEY_URL → ~/.browseros/server.json → http://127.0.0.1:9100.
3. Health check: GET /system/health must return { status: "ok" }.

If Jiey is offline, tools fail with a link to the official download page (default https://www.gongxingglobal.com/browser) instead of silently falling back to another browser.

Configure

In the profile cordis.patch.yml (or DSH settings UI):

- id: jiey-browser
  config:
    serverUrl: ""              # empty = auto-discover
    scopeId: dsh-jiey-browser  # tab isolation header
    allowCookies: false        # DEFAULT: do not reuse login / user tabs
    downloadUrl: https://www.gongxingglobal.com/browser
    maxSnapshotChars: 40000

Security: allowCookies defaults to false. Turn it on only when the user explicitly wants the agent to use existing logged-in sites.

Tools

Tool	Maps to Jiey MCP	Role
browser_open	tabs new + snapshot	Open
browser_navigate	navigate	Navigate
browser_snapshot	snapshot	Refs for act
browser_read	read	Markdown / text scrape
browser_act	act	click / fill / press / …
browser_screenshot	screenshot	Inline image (no temp file)
browser_tabs	tabs list/close	List / dispose

Local smoke (no DSH)

npm install
npm run build
npm run smoke

With Jiey running, smoke opens https://example.com, snapshots, and closes the tab.

License

MIT