PROJECT TOPICS

项目标签

dsh-plugin

PROJECT README

README

@deepseek-ai/dsh-desktop-browser

Opens the dsh Web UI in a browser window with no address bar, giving it a native-app feel.

Features

Auto browser detection — finds Chrome, Edge, Chromium, or Safari on Windows/macOS/Linux
Address bar hidden — uses Chromium's --app=<url> flag
Auto URL resolution — reads host/port from the webserver
Window geometry — configurable size and position (auto-center supported)
Automatic cleanup — closes browser when dsh shuts down

Installation

dsh plugin --profile web add Mby159/dsh-desktop-browser

Then start dsh:

dsh web

The plugin's cordis.patch.yml is merged automatically — no manual configuration editing required.

Verifying the installation

After dsh plugin add completes, verify the plugin is active before starting dsh web:

dsh --profile web --dump-config | grep desktop-browser

If the plugin was successfully added to the bundles list, the output includes desktop-browser in the config tree.

If the grep finds nothing, the plugin package was installed but the bundles list was not updated. Fix it manually:

# Read the profile's package.json
# Add "@deepseek-ai/dsh-desktop-browser" to the dsh.profile.bundles array if it is missing
# Then re-verify:
dsh --profile web --dump-config | grep desktop-browser

When the browser doesn't open

If dsh web starts but no browser window appears:

Check the dsh startup logs for [desktopBrowser]. If you see:
```
[desktop-browser] bundle not found in profile bundles
```
→ The plugin is not in the bundles list. Apply the fix above.
If the logs show no desktop-browser entries at all, the plugin was not loaded. Verify with:
```
dsh --profile web --dump-config | grep desktop-browser
```

Requirements

A Chromium-based browser (Chrome, Edge, Chromium) or Safari
DeepSeek Harness web profile
pnpm ≥10: if installing from GitHub and pnpm reports a blocked prepare script, add the key it prints to ~/.dsh/profiles/web/pnpm-workspace.yaml under allowBuilds, then re-run the install command above

How it works

The plugin is a Cordis bundle. dsh plugin add installs the package and adds it to your profile's dsh.profile.bundles list, so the plugin's cordis.patch.yml is loaded automatically on every dsh web startup.

Configuration (optional)

The plugin works with zero config. To override defaults, create or edit ~/.dsh/profiles/web/cordis.patch.yml with your overrides:

- id: desktop-browser
  config:
    width: 1400
    height: 900
    positionX: auto
    positionY: auto
    disableExtensions: true
    openDelayMs: 500
    minimize: false

Field	Type	Default	Description
`url`	string	auto	Override the URL to open
`browser`	string	auto-detect	Explicit browser path
`width`	number	1400	Window width in pixels
`height`	number	900	Window height in pixels
`positionX`	number \| 'auto'	'auto'	Window X position
`positionY`	number \| 'auto'	'auto'	Window Y position
`disableExtensions`	boolean	true	Pass `--disable-extensions`
`openDelayMs`	number	500	Delay before opening after server start
`minimize`	boolean	false	Start browser minimized

API

The plugin registers ctx.desktopBrowser:

url — the resolved URL
running — whether the browser is open
open() — open the browser window
close() — close the browser window

CLASSIFICATION EVIDENCE

分类依据

项目类型待识别

功能分类其他

规则置信度低

系统优先读取 GitHub Topics，再与站内分类词典和词根规则比对。当前命中：无有效分类标签。