filechecker
DSH 插件，为已交付文件卡片添加一键“打开位置”操作，在系统文件管理器中显示文件。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:nanfangtown/file-checker#db29c1d9f3a8a50d5feb3bf406e46c374105bf84Filechecker 以 filechecker 发布，当前版本为 1.0.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →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.
FileChecker adds a direct Open location button to a delivered-file card
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.
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 |
--dsw-alias-* tokens.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.
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.
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.
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.
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.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.
onAction returns revealError without a reason.
Missing files and unmapped paths look the same in the button; the Host route
owns the detailed status.MIT © nanfangtown