dsh-file-changes
A DeepSeek Harness Web plugin that shows a file-change panel at the end of every answer. When a turn creates or modifies files, the panel lists each one under the closing message with three actions:
- Open — click the file name to open it with the OS default application;
- View diff — a modal renders the turn's actual applied changes (whole-file
content for new files) using the harness DiffBlock primitive;
- Reveal — locate and select the file in the OS file manager
(macOS open -R, Windows explorer /select,, desktop Linux opens the containing directory). The action appears only on loopback access with a native opener available.
The panel complements the built-in "Produced" row: it adds created/modified badges, per-file diffs, and per-file filesystem reveal.
Install
# from GitHub
dsh plugin --profile web add git+https://github.com/mixin-ai/dsh-file-changes
# from a local checkout
dsh plugin --profile web add link:/path/to/dsh-file-changesRestart dsh web, then refresh the browser page.
How it works
- Native mode — the client half registers a conversation definition (like
@deepseek-ai/dsh-client-ui-deliverables) that accumulates successful mutation tool calls from their presentation views (card: 'diff' hunks, or generic kind: 'edit' locations) into turn-scoped data published under the fileChanges key, and renders it through the chat view's conversation.chat.turnTail slot chain.
- Code Mode (
run_code) — nested dispatches carry no presentation views
on the wire, so the host half listens to tools/execute / tools/result for executions with a parent (Code Mode sub-calls), rebuilds change records from the write / edit / str_replace_editor arguments, and serves them over /api/file-changes/changes. The panel merges both sources, deduplicated by path.
- Reveal —
POST /api/file-changes/revealvalidates a JSON payload,
loopback origin, and an absolute existing path before handing it to the platform opener.
Structure
| File | Role |
|---|---|
lib/index.js | Host half: nested-dispatch tap + the two HTTP routes |
lib/client.js | Browser bundle: turn accumulator + panel/diff/reveal UI |
cordis.patch.yml | Bundle patch mounting the dual-half row |
smoke.test.mjs / client.test.mjs | Host and client logic tests |
Run the tests with:
node smoke.test.mjs && node client.test.mjsLimitations
- Files created indirectly by terminal commands (e.g.
bash) are not
detected — the same vocabulary limit as the official produced-files row.
- Host-side Code Mode records live in memory (2-hour / 2000-per-session ring);
a server restart clears them.
- The reveal endpoint trusts loopback same-origin JSON requests only.
License
MIT