FileChecker

English | 中文

A DSH plugin that puts a visible Open location button on every delivered-file card. One click reveals the file in the system file manager.

Why

A delivered-file card in DeepSeek Harness can preview the file, but revealing its folder is buried inside the native-open menu. FileChecker promotes that gesture to a labelled button that is always visible, so a delivered report, image, video, or Office document is one click away from Explorer, Finder, or the Linux file manager.

What you get

Every present delivery card gets an action button with four states:

State	Label	Notes
Idle	Open location	Calls the card's authenticated reveal gesture
Pending	Opening…	The Host desktop is handling the request
Success	Located	Returns to idle after 2 seconds
Failure	Failed	Returns to idle after 5 seconds; hover shows a retry hint

• Hidden when the Host reports no usable native desktop, so there is no dead button on remote or headless deployments.
• Clicking the button does not trigger the card's preview overlay.
• Follows the DSH light/dark theme through --dsw-alias-* tokens.
• Ships Simplified Chinese and English dictionaries.

Install

From npm

The package is prepared for npm as filechecker; until the first publish, use the local checkout below.

dsh plugin add filechecker

Or open Plugins → Add plugin in the DSH Web UI, enter filechecker, and install the bundle. Enable it if the dialog offers Enable now.

From a local checkout

git clone https://github.com/nanfangtown/file-checker.git
dsh plugin add /absolute/path/to/file-checker

The same local path can be entered in Plugins → Add plugin. Profiles with HMR pick up the new bundle without a restart; a profile without HMR asks for a restart.

Verify

Open any session that contains a delivered-file card (a present call from this or a previous turn). The Open location button appears to the right of the file name. Clicking it should open the containing folder and select the file.

How it works

The browser half registers one entry in the deliverables.file.actions child slot declared by @deepseek-ai/dsh-client-ui-deliverables:

ctx.slots.inject('deliverables.file.actions', () =>
  ctx.slots.register({ name: 'deliverables.file.actions', id: 'filechecker' }, RevealAction)
)

The click calls the slot's own onAction('reveal'), which posts to the already-authorized delivery route:

POST /api/present.open?sessionId=…&seq=…&index=…&action=reveal

That route re-validates the Session, the delivery event, the file coordinates, and the Host path mapping. FileChecker does not add a Host route, copy a file path into the page, or increase file access authority. The Host half of the package is an empty apply(); it exists only so the bundle mounts and the client manifest can discover ./client.

Compatibility

• Tested with DSH 0.2.1-rc.2 on Windows 11.
• The reveal itself is cross-platform: it uses the Host's native file-manager integration. The plugin UI is browser-side and theme-driven.
• Requires a managed DSH profile. Without a reported native desktop, the action hides instead of failing.
• deliverables.file.actions is an internal contract of ui-deliverables. If a future DSH renames or removes that slot, FileChecker needs a matching update; the button would disappear rather than throw.

Development

No dependencies are required:

git clone https://github.com/nanfangtown/file-checker.git
cd file-checker
node --test
node --check client.js
node --check index.js

The offline suite covers the manifest and patch, slot registration, dictionary parity, unavailable-desktop hiding, pending state, the reveal gesture, style disposal, and display metadata. See CONTRIBUTING.md for the local-install workflow and pull-request expectations.

Limitations

• Delivery cards only. The changed-files review and the right-sidebar document header keep their built-in native controls.
• The built-in control remains. FileChecker adds a direct, labelled button beside it; it does not replace DSH's native open menu.
• Generic failure text. onAction returns revealError without a reason. Missing files and unmapped paths look the same in the button; the Host route owns the detailed status.
• No file contents. The plugin never reads or copies the delivered file.

License

MIT © nanfangtown