dsh-diff-view
A DeepSeek Harness (DSH)
plugin: a reusable two-text diff viewer for client plugins. One engine, one
stylesheet, no coupling to any consumer: line-level LCS with intra-line word
highlights, true line numbers across context collapse, and a split/unified
toggle.
There is no UI of its own to visit. Plugins inject the client service
diffView:
// consumer client half, inject: ['diffView', …]
// 1. A self-contained component (scrolls its own body, own grid):
const Diff = ctx.diffView.diffRowsComponent({
title: 'File.txt', // optional, for interface symmetry
before: oldText, // required string
after: newText, // required string
initialMode: 'split', // 'split' (default) | 'unified'
showToggle: true, // false hides the Split/Unified pill
})
return React.createElement(Diff, {})
// 2. The raw engine, for custom layouts (inline diffs, lists of hunks):
const rows = ctx.diffView.engine.alignedEditRowsOf(beforeLines, afterLines)
// rows: [{ kind: 'same'|'replace'|'delete'|'insert', removedLine?, addedLine? }]
const spans = ctx.diffView.engine.wordSpansOfLinePair(beforeLine, afterLine)
// spans: { removedSpans, addedSpans }: arrays of { text, changed }
ctx.diffView.engine.wordSpanElements(spans.removedSpans, 'adf-w-del')
Contract
diffRowsComponent validates at the door: an options object and
before/after strings are required; anything else throws.- Line numbers are computed for every row BEFORE context collapse runs, so
numbers stay true across ellipsis bands. (The view this plugin extracts
numbered after collapse and drifted; that defect is why it exists.)
- View mode is per component instance: two diffs on screen toggle
independently.
- The
adf-* diff stylesheet is installed once by this plugin; consumers
render no CSS of their own for diff rows.
- No persistence; no approval coupling; the host half is a stub.
How to install
Requires a DeepSeek Harness checkout and a profile, here web. The plugin
has no dependencies:
mkdir -p ~/dsh-plugins && cd ~/dsh-plugins
git clone https://github.com/joao-paulo-santos/dsh-diff-view.git
# from the harness checkout
pnpm dsh plugin --profile web add ~/dsh-plugins/dsh-diff-view
# verify the profile still composes
pnpm dsh --profile web --dump-config
Restart the harness. Plugins that inject the diffView service can now
render diffs.
Dependencies
(none)
Plugins dependent on this
- dsh-approval-diff renders its review cards' hunks with the engine and shares the diff stylesheet
- dsh-scratchpad powers its
mode: 'diff' pads with diffRowsComponent (optional; degrades to plain text when absent)
- dsh-wo-github renders commit patches with word highlights and the diff grid stylesheet (optional; patches render without it)
