dsh-video-player

A floating, draggable, resizable video player for DeepSeek Harness (DSH).
It mounts a small window over the web UI that plays scene-per-MP4 clips from a
Stash-style scene server — propping a video feed beside your chat and paging
through clips while you work. The window moves and resizes in real time, like a
real PiP video. Stash is the star; other sources are best-effort.

Install

npm install -g pnpm@11                     # the container image ships no pnpm
dsh plugin --profile web add /path/to/dsh-video-player
# restart the web profile (bundle changes apply at boot only):
sh ~/.dsh/dsh-guard/restart-web.sh

Linked installs need an import bridge. dsh plugin add <dir> installs the
plugin as a link: symlink, and Node resolves the host module's imports from
its realpath (/path/to/dsh-video-player), which sits outside the profile's
node_modules. Before installing from a local dir, give it a bridge:

mkdir -p /path/to/dsh-video-player/node_modules/@deepseek-ai
ln -s ~/.dsh/profiles/node_modules/@deepseek-ai/dsh-settings /path/to/dsh-video-player/node_modules/@deepseek-ai/dsh-settings
ln -s ~/.dsh/profiles/web/node_modules/schemastery /path/to/dsh-video-player/node_modules/schemastery

Features

• Floating, resizable window — drag the title bar to move it, drag the
  bottom-right corner to resize live (min 200×140). Native <video> player with
  controls (play/pause, scrub, fullscreen, volume). Inputs and buttons in the
  title bar are excluded from the drag handler, so they stay clickable/typable.
• Stash scene navigation (the star) — ◀ / ▶ step scenes, a number
  field + Go / Enter jumps anywhere, and a status line shows the exact stream
  URL. The default server is http://host.docker.internal:9999 with
  /scene/{no}/stream per clip; it supports Range requests (verified
  206 Partial Content), so seeking works.
• Channel dropdown (custom widget) — Stash / Custom link / YouTube / Twitch
  / Jellyfin. Built as buttons, not a native <select> (which was unreliable in
  DSH's dark UI). Picking a channel switches the source immediately.
• Link field with auto-detect — paste a YouTube / Twitch / Jellyfin /
  direct-file link and it auto-picks the channel and plays it (never appends a
  /scene/N/stream suffix). Enter or the ▶ button plays; paste auto-plays.
• Gear panel (⚙) = window + Stash config only — width, height, opacity, and
  the Stash base URL (scene server root). Source/channel config deliberately
  does NOT live here.
• Persisted geometry — position, size, and opacity survive reloads
  (localStorage).
• Coexists with the pet & themes — it's a separate fixed overlay alongside
  the DSH pet and dream-skin wallpaper.

Architecture

• Host half (lib/index.js) — registers the dsh-video-player settings
  namespace (schema: base, channel, url, scene) and serves
  GET/POST /api/dsh-video-player/config. The POST handler writes through the
  DSH settings service, so the source config persists in the real settings
  store (not localStorage).
• Client half (lib/client.js) — self-contained (plain DOM, inject: [],
  activates immediately). It polls GET /api/dsh-video-player/config (~2.5s)
  and pushes title-bar changes back with POST, so the floating window and the
  settings store stay in sync.

Bugs we hit and fixed (the lessons)

1. Host export default drops inject. DSH's bundle loader unwraps a
   module's default export to the bare function, silently discarding
   inject/name — services then throw cannot get property "webServer" without inject at boot and take the whole app down. Fix: use named
   exports only (export function apply, export const inject, export const name), exactly like the dsh-pet host bundle.
2. A client that declares an inject it never uses hangs. The client once
   declared inject: ["@deepseek-ai/dsh-client-runtime"] without requiring it,
   and sat forever in pending (waiting for service: …). Fix: keep the client
   self-contained with inject: [].
3. Host imports don't resolve for link: installs. See the bridge note
   above.

Roadmap

• Layer control — put the window in front of chat (default), behind it /
  tuck into the sidebar, or "minimize to sidebar".
• Transparency — window opacity (done: 0.3–1.0 in the gear panel) plus a
  click-through toggle for when you want to watch but not interact.
• Alarm / "someone walked in" button — one click plays a sound (TBA).
• Scene thumbnail rail — thumbnails for the current scene ± a few, for
  faster paging.
• Settings-menu card — the dsh-video-player settings namespace is
  registered; if the generic settings surface doesn't render it as its own
  section, add a client settings card (like the pet's) so channel/link are
  editable from Settings → dsh-video-player.
• Stash scene list — probe the server for valid scene numbers and page
  within the real set instead of ±1.