dsh-git-diff

Adds a Git changes tab to the right Sidebar of the DeepSeek Harness web UI (dsh web), next to the built-in Files and Terminal tabs.

• Open it from the Sidebar guide. The header shows the current branch and how many paths changed.
• Changed paths are listed with M / A / D / R / C / T / U (untracked) / ! (conflict) badges. Paths that are already staged are marked.
• Expand a path to compare it side by side (see Diff view). Use the arrow button to open the file in the Sidebar preview; deleted paths have no such button.
• The list refreshes when the tab becomes visible, when an agent turn finishes, and on the Sidebar refresh command or button.

Version 1.x drew its own Files and History panels. DSH now ships both natively: the Files tab, and turn navigation in the chat. 2.0 therefore keeps only the git view and rebuilds it on the right-Sidebar tab API.

Diff view

An expanded path shows two aligned columns: HEAD on the left, the working tree on the right.

• Each column has its own line numbers. Removed lines are red on the left, added lines are green on the right, and a changed line faces its replacement. A line with no counterpart leaves a blank cell on the other side.
• Three lines of context surround each change. Longer unchanged stretches fold into a single "N unchanged lines" row.
• A new or untracked file fills only the right column. A deleted file fills only the left column.
• Long lines wrap inside their column, so the view fits a narrow Sidebar.
• Binary files, and files where either side exceeds 512 KiB, show a note instead of a diff.

Requirements

• DeepSeek Harness >=0.2.1-rc.2 <0.3.0 with the web profile.
• git on PATH in the Session's execution environment.

Installation

The package is a DeepSeek Harness bundle. Its cordis.patch.yml registers one row, which loads both the Host half (lib/index.js) and the browser half (lib/client.js).

# from GitHub (pin a commit for reproducibility: ...#<commit-sha>)
dsh plugin --profile web add github:XYZ1024-alt/dsh-git-diff
# or from a local checkout, run in its parent directory
dsh plugin --profile web add ./dsh-git-diff

The built JavaScript in lib/ is committed, so installation does not run a build. Reload the page after installing. Remove the plugin with dsh plugin --profile web remove dsh-git-diff.

Security

The plugin registers two read-only GET routes, /api/dsh-git-diff/status and /api/dsh-git-diff/diff, as exact Fetch routes on DSH's shared /api channel. Before a request reaches them, DSH's Connection applies its Host/Origin trust checks and browser authentication, and only owner Peers get through.

• Each request names a Session. Git runs only in that Session's working directory.
• The diff route returns content only for paths that git status currently reports as changed, and only inside the repository root.

Development

pnpm install
pnpm check   # typecheck (Host and client separately), Biome, build lib/

Path	Role
src/contract.ts	Zod schemas for the wire responses, shared by both halves
src/routes.ts	Route paths
src/host/	Host plugin: Session to working directory, git through ctx.subprocess, file reads through ctx.fs
src/client/index.ts	Browser plugin entry: tab type, guide entry, tab body registration
src/client/GitChangesBody.tsx	Tab body: branch header, change list, per-path diff loading
src/client/split-diff.ts	Side-by-side row model: local patches from diff, paired old/new lines, folded gaps
src/client/SplitDiff.tsx	Two-column diff renderer
src/client/api.ts	Browser adapter over the Host routes, parsed with the shared contract
src/client/locales.ts	English and Chinese dictionaries
scripts/build.mjs	esbuild: ESM Host bundle and client bundle in the DSH module-loader envelope, with CSS-module styles injected

The client bundle imports only from the Web shell's platform modules (react, zod, @deepseek-ai/dsh-client-ui-primitives, and so on). Everything else, including swr and diff, is bundled. The build fails when the client imports any other @deepseek-ai/* package at runtime.

License

MIT