onebox-dsh-bridge

Usage

1. Open http://127.0.0.1:3080/onebox-bridge in dsh web (adjust the port to your deployment)
2. In the OneBox app, open DSH Client → My Computers and scan the QR code matching your app channel (one per gateway: mainland China / international)
3. Once the page shows Online, pick the device in the app and start chatting with your agent

Page buttons: Regenerate QR code (invalidates the old session and creates a new pairing session; codes expire after 10 minutes and are rebuilt automatically) and Unbind & re-pair (deletes the local token, back to waiting-for-scan).

Configuration

All optional. Priority: environment variable > plugin config > default.

Key	Env var	Default	Description
gateways	ONEBOX_DSH_GATEWAYS (comma-separated)	https://api.wanbaohe.com + https://api.oneboxable.com	OneBox gateways. Both deployments are paired at once by default — the page shows one QR per gateway, labeled by app channel, and the first one scanned wins. The app JWT is only valid on its own deployment, so dual pairing saves users from configuring anything
gateway	ONEBOX_DSH_GATEWAY	—	Single-gateway override (equivalent to a one-element gateways list)
upstream	ONEBOX_DSH_UPSTREAM	127.0.0.1:3080	Local dsh address (host:port)
deviceName	—	system hostname	Device name reported to the app during pairing
dataDir	ONEBOX_DSH_DATA_DIR	~/.dsh/profiles/web/onebox-dsh-bridge	Token storage directory (token.json, mode 0600; old tokens are invalidated automatically when their gateway leaves the configured list)

To change config, override the whole row in the profile's ~/.dsh/profiles/web/cordis.patch.yml (a patch replaces the entire config value — list every key):

- id: onebox-dsh-bridge
  name: 'onebox-dsh-bridge'
  config:
    gateways:
      - https://api.wanbaohe.com
      - https://api.oneboxable.com
    upstream: 127.0.0.1:3080
    deviceName: My Mac