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-browserFrom a local checkout after npm run build:
dsh plugin --profile web add /absolute/path/to/packages/dsh-jiey-browserSource: 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 page: https://www.gongxingglobal.com/browser - macOS Intel (x64) DMG: https://cdn.gongxingglobal.com/releases/browseros/0.49.6.4/Jiey_v0.49.6.4_x64.dmg (Apple Silicon / Windows / Linux installers: coming soon on the same page.) 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 download URL (default Gongxing site) 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: 40000Security: 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 smokeWith Jiey running, smoke opens https://example.com, snapshots, and closes the tab.
License
MIT