Bites the DSH
English | 简体中文
Powered by Harmony
Read-only, scriptable session playback for the DeepSeek Harness WebUI.
https://github.com/user-attachments/assets/3c9dfdcf-a454-4750-9edf-76771ed5a9a6
The demo shows Bites the DSH together with dsh-turn-fold.
The plugin turns the native conversation into a replay view without opening a separate panel. A single native session-header control enters replay. While replay is active, the conversation is fully read-only: the native composer and session-changing interactions are blocked, while UI and scripts may move time without mutating the source session.
Current implementation
- Native session-header entry and compact playback controls.
- Pause, forward play, reverse play, event stepping, speed selection, adjustable idle-gap compression, and direct event/turn/time seeking.
- Optional simulated typing previews the next direct user message in the native read-only composer without touching its live draft.
- A per-session observable controller exposed as
ctx.sessionPlayback for time-only scripting.
- Historical projection through DSH's native
ChatView; the source session and live head continue independently.
- Historical timelines expose
playbackClock: { kind: 'historical', time: cursorTime } so projection consumers never treat an open historical turn as live wall-clock work.
- Native composer, model, stop, branch, and assistant write actions are disabled during replay; viewing controls remain interactive.
- English and Chinese labels using DSH theme tokens, without a separate panel.
The development baseline is DSH 0.1.5-rc.2; 0.1.6-alpha.2 and 0.1.7-rc.2 are also checked. This migration requires the new Conversation/Chat services. Harmony selector drift fails the automated test instead of silently changing the wrong component.
DSH 0.2.0-rc.2 is explicitly supported after checking its actual UI types, bundle selectors, browser startup, and combined loading with Turn Fold. The native assembler is resolved after Conversation activation, and decorators observe the shared playback controller even before slot hooks register. Replay behavior is covered by the bundle integration test; a real historical-session browser pass and macOS/Linux browser checks remain separate validation steps.
Install
dsh plugin --profile web add @ch4acko3/bites-the-dsh
dsh harmony status --profile web
All four Bites the DSH patches should report bound. Reload the WebUI, open a
session, then use Replay session in the native session header.
Script control
Other DSH plugins can use the same per-session clock through the provided
Cordis service:
const playback = ctx.sessionPlayback
playback.enter(sessionId)
playback.seekTime(sessionId, Date.parse('2026-08-20T12:00:00Z'))
playback.play(sessionId, 1)
playback.pause(sessionId)
playback.exit(sessionId)
Time values such as the argument to seekTime use Unix epoch milliseconds,
matching JavaScript Date values and recorded event timestamps.
The service also supports event and turn seeking, reverse playback, rate and
idle-gap settings, subscriptions, and position reads. It deliberately exposes
no operation that mutates the source session.
Development
Requires Node.js ^22.22.3 || >=24.11.1 and pnpm 11.
pnpm install
pnpm check
CI/CD
Every push to main and every pull request runs pnpm check and verifies the
npm package contents. Pushing a v<package.json version> tag runs the same
checks, creates the matching GitHub Release, and publishes the public package
to npm through Trusted Publishing (OIDC), with automatic provenance and no npm
token stored in GitHub.
License
MIT
Compatibility check (2026-09-28): 26 unit tests match the DSH 0.1.7-rc.2 compiled Conversation/Chat bundles, including all four Harmony selectors. Historical chat hooks read the projected node store; releasing a Session removes subscriptions, pending history state and read-only mode. Browser interaction and macOS/Linux validation remain separate from these Windows checks.
