Usage

Open http://127.0.0.1:3080/onebox-bridge in dsh web (adjust the port to your deployment)
In the OneBox app, open DSH Client → My Computers and scan the QR code matching your app channel (one per gateway: mainland China / international)
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

onebox-dsh-bridge

インストール

ドキュメント

Usage

Configuration