npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

dsh-plugin-mobile-link

v0.8.1

Published

Put your PC's DeepSeek Harness in your pocket: dials a relay over WSS so the native iOS client reaches this machine even without a public IP.

Readme

dsh-plugin-mobile-link

DSH plugin listed in awesome-deepseek-harness npm License: MIT

面向:使用者与实现者 · 状态:stable · 最近核对:2026-09-20

The computer half of DSH Mobile: it dials a relay over WSS, so the native iOS client reaches this DSH instance even though the computer has no public IP.

iPhone App ──WSS──▶ Relay(公网,只鉴权与转发)──WSS──▶ this plugin ──HTTP+WS──▶ 127.0.0.1:<port>

The connector always talks to the local DSH as 127.0.0.1:<port>, so the host's authority and its trust fence are unaffected: no --trusted-host, no rewritten Host, no new listening port on this machine.

plugins/mobile-link/
├── package.json          # type: module, dsh.bundle.patch, bin: dsh-mobile-link
├── cordis.patch.yml      # bundle patch: the loader row + config reference
├── lib/
│   ├── index.js          # cordis plugin: starts the agent, registers 5 routes
│   ├── link.js           # the DLP agent transport: identity, socket, heartbeat, reconnect
│   ├── router.js         # frames ⇄ local DSH mux streams, per-device `$events`
│   ├── dlp.js            # DLP v1 frame codec (shared with the relay)
│   ├── files.js          # phone → computer file transfers (`_link/file*` methods)
│   ├── enroll.js         # open enrollment (no invite code), writes ~/.dsh/mobile-link/agent.json
│   ├── journal.js        # lifecycle journal: why a relay link was dropped, after the fact
│   ├── routes.js         # status, enroll, pair-code, pair-code/regenerate, devices/revoke
│   ├── qr.js             # dependency-free QR SVG
│   └── cli.js            # dsh-mobile-link: enroll / mint-pair-code
└── test/                 # node --test, 100+ tests (no DSH, no network)

Install

The connector runs in whichever host runs your DSH. There are two supported hosts today — the official desktop app and the command-line web host — and each keeps its own profile, so you install the plugin into the one you actually use. The connector discovers the local DSH by itself in both (the host hands it the authenticated loopback address); you never type an address or a token.

Command-line web host

dsh plugin --profile web add dsh-plugin-mobile-link

Official desktop app — install through the app's own plugin page, or with the CLI that the app ships (…/Resources/runtime/cli/bin/dsh, installable from its settings). The npm dsh refuses this profile on purpose (profile "desktop" is managed exclusively by the Electron application). Two prerequisites matter in practice: let the app start once so it initializes its profile, and quit it completely before installing — otherwise the profile is locked.

# quoting the app's bundled CLI; see docs/ONBOARDING.md for the section titles
"<DeepSeek Harness.app>/Contents/Resources/runtime/cli/bin/dsh" \
  plugin --profile desktop add dsh-plugin-mobile-link

Then restart the host (or reload the profile). From a checkout the same command takes a path — the leading ./ matters, because DSH anchors a relative spec against your current directory instead of resolving it inside the profile:

dsh plugin --profile web add ./plugins/mobile-link

Use

  1. Register this computer with a relay (once). Open the 移动端连接 panel at the bottom of the DSH sidebar: the relay address is prefilled (editable) from the installation default; click 登记. The connector derives the computer name automatically, writes ~/.dsh/mobile-link/agent.json and reconnects in place — no terminal and no DSH restart. Open enrollment is the default; the relay rate-limits by source. If an installation has no panel (headless, CI), the CLI still works:

    dsh-mobile-link enroll --relay wss://<你的站点>/dsh-link

    …or register it on the relay host with dsh-relay admin agent-register --write-config ~/.dsh/mobile-link/agent.json.

  2. The same panel shows the pairing code and its QR once the relay link is up. The CLI can still mint one directly:

    dsh-mobile-link --mint-pair-code        # prints JSON: code + relay + agentId

    The code is persistent: it stays valid until you click 重新生成. Each paired device has a quiet 撤销 action; revoking one device leaves the code and other devices alone.

  3. Scan it in the iOS app. The code can be claimed again for another phone, a reinstall or a new device; only 重新生成 revokes it (already-paired devices stay connected). After that the phone reconnects on its own — nothing else has to be run by hand.

GET /mobile-link/status reports whether the link is up, which devices are attached, and whether this computer is registered yet. Its enroll block also carries panel (this connector can enroll from the DSH panel), relayPrefill and relayLocked (the address to prefill and whether it came from config). POST /mobile-link/enroll performs that enrollment (open enrollment; no invite code); it returns the agent id and name, never agentSecret, and is behind the same DSH request fence as pairing. GET /mobile-link/devices lists the full paired roster (including offline) for the panel, and POST /mobile-link/devices/revoke revokes one paired device by deviceId through the relay; both are behind the fence and authenticated with the agent secret. Its journal block carries the current process's newest lifecycle events (link opened/closed with the reason, device attached/detached); the counters in it reset when the plugin hot-reloads, so the full history — across restarts — is the JSONL file at journal.path.

Configuration

All optional; the defaults are what a stock deployment needs. Set them in the plugin's config block (cordis.patch.yml), not by editing this file.

| Key | Default | Meaning | | --- | --- | --- | | enabled | true | false stops the outbound link without uninstalling | | relayUrl | from agent.json | Relay base URL; a bare deployment dials <relay>/link/agent. Pinning a real value here outranks the enrolled identity and makes the panel field read-only | | defaultRelayUrl | empty | Form-only default: prefills the panel's relay input, but never outranks the enrolled identity. Official installs set this so users can still edit it | | agentId / agentSecret | from agent.json | Override the enrolled identity | | stateFile | ~/.dsh/mobile-link/agent.json | Where the identity lives | | journalFile | ~/.dsh/mobile-link/link-events.jsonl | Lifecycle journal (rotated once at 256 KiB); false keeps it in memory only | | slowRequestMs | 2000 | A slower single request gets its own request.slow entry; 0 disables those (per-attach device.summary is still written) | | diagnostics | true | false refuses the phone's phase uploads; the phone ignores the refusal and stays connected | | dshUrl | discovery | Explicit local DSH base URL (usually unnecessary — the host hands the connector its own address) | | heartbeatMs | 20000 | DLP ping interval |

The connector does not read an endpoint handoff file any more: discovery happens inside the host process (ctx.inject(['webServer','connection'])), which is what makes one npm package work on both the desktop app and the command-line host. It writes one instead — $DSH_HOME/mobile-link/endpoint.json, mode 0600 — for tools that run outside the host (our dev/test scripts and the iOS integration helpers).

Address resolution order: this config block, then DSH_RELAY_URL (or DSH_MOBILE_LINK_RELAY), then the enrolled identity file, then the repository placeholder wss://relay.example.com/dsh-link — the placeholder being the "nothing configured yet" sentinel rather than a real address.

Design notes

  • No required services. inject is empty and the routes are attached through ctx.inject([...]), so a future DSH that renames or drops webServer / connection cannot make the tunnel fatal on boot.
  • Protocol-transparent. Nothing outside lib/ is imported and no DSH business API is touched: the connector forwards frames, it does not interpret sessions. The relay has the same property.
  • Disable by removing the row from the profile's cordis.patch.yml, or by setting enabled: false.

Test

cd plugins/mobile-link && npm test    # zero dependencies

The wire protocol is specified in docs/RELAY-PROTOCOL.md.

MIT.