dsh-file-mentions
DSH 回复中的可点击文件路径：从内联路径打开文件/目录（Codex 风格），并提供已提及文件的标签列表作为备用
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:a903067276-rgb/dsh-file-mentions#6b1c48b5f7d6f09a61f704e2376f1b567ca82ece
File Mentions 以 dsh-file-mentions 发布，当前版本为 1.0.14。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Clickable file paths in DSH replies — a DeepSeek Harness (DSH) web plugin with a Codex-style experience.
Unofficial project: independently developed and maintained by a community member, not an official DeepSeek product.
Inline paths wrapped in backticks (`~/...`, absolute, relative, or Chinese paths) become
click-to-open; each clickable path carries a small folder-icon button that reveals the file in your
file manager; a "📎 mentioned files" chip list at the turn tail covers the rest. URLs are
already auto-linked by the official renderer, so this plugin leaves them alone.
External-drive whitelist settings
The external-drive whitelist (Settings → Plugins → file-mentions): local files in your home
directory are clickable by default; only external drives / network volumes (e.g.
/Volumes/USB) need their root added here — one path per line. System-disk marker
directories (/System, /etc) are rejected automatically.
| Where | What | Effect |
|---|---|---|
| Inline path text | click | Open with default app / open directory |
| folder icon after inline path | click | Reveal in file manager |
| "📎 mentioned files" chip | click name | Preview content inside DSH |
| folder icon in the chip list | click | Reveal in file manager |
| Inline URL | click | Browser opens it (official autolink) |
Supports ~/ expansion, relative paths (resolved against the session cwd), and absolute
paths in macOS / Linux / Windows forms. Non-existent paths silently do nothing.
This repository is an official bundle plugin (dsh.bundle + dsh.client in the root
package.json), installed through the official profile manager:
dsh plugin --profile web add "github:a903067276-rgb/dsh-file-mentions#main"
Then restart dsh web (bundle layers are composed at startup; HMR does not apply).
Requires pnpm on PATH (dsh plugin forwards to pnpm).
Manual mount fallback: see docs/install.md.
Have the agent wrap paths in backticks (e.g. `~/docs/plan.md`) to make them clickable
inline. The tail chip list appears automatically — no configuration.
Local files inside your home directory (e.g. ~/Downloads, ~/Desktop) are clickable by
default — no configuration needed. For paths on an external drive / network volume (e.g.
/Volumes/USB), add that root to the external-drive whitelist in Settings → Plugins →
file-mentions (one path per line). Saving takes effect immediately — no restart required.
System-disk protection: whitelist roots containing system marker directories (/System,
/etc, or \Windows on Windows) are rejected automatically, so a full system disk mounted
externally can never be whitelisted by mistake.
| Platform | Status |
|---|---|
| macOS | ✅ Fully tested (incl. Chinese paths) |
| Linux | ⚠️ Not tested — expected to work (command branching and path parsing implemented) |
| Windows | ⚠️ Not tested — expected to work (command branching and path parsing implemented) |
npx @deepseek-ai/dsh web)key+id registration to satisfy both rc.6 (id) and rc.7+ (key); verified locally on rc.6/rc.8/0.1.1-rc.2/0.1.2-alpha.2/0.1.5-rc.1 (clickable paths + "mentioned files" panel), not guaranteed on every DSH version):
main (default)./api/file-mentions/check responds); UI interactions were not eyeballed item by item. ⚠️ 0.1.5 ships a narrow built-in "clickable inline-code paths in the closing reply" (only files written via write/edit/present in that turn — see dsh-client-ui-deliverables), which partially overlaps; plain-text/bare paths, cross-turn and historical messages are still handled only by this plugin.v1.0.8 (dsh plugin add github:a903067276-rgb/dsh-file-mentions#v1.0.8); DSH 0.1.0-rc.6 → frozen rc6-compat tag (no maintenance).@deepseek-ai/dsh-settings,
@deepseek-ai/schemastery) are provided by the hostlib/index.js): three routes — /api/file-mentions/check (existence check),
/api/file-mentions/open (system open, mode: open/reveal, per-platform command) and
/api/file-mentions/config (whitelist read/write for the settings page). All three routes
are same-origin guarded. Probe surface: absolute/~/ paths are checked only inside the session cwd or
user-declared whitelist roots (stored via the official settings service — immediate
effect, no restart); whitelist roots are protected against system disks and symlink
escapes. Pure Node stdlib; execFile avoids shell injection.lib/client.js): a conversationEvents collector extracts paths from each
reply → publishes them to turn data → the tail list filters non-existent paths before
rendering; inline clicks use a document-level click delegation (the official render
entry is occupied by the official "deliverables" plugin, so DOM delegation is the only
viable path); inline folder-icon buttons are inserted by a MutationObserver and restored
automatically after React re-renders; a settings card (sidebar section + plugin page)
edits the whitelist. Scanning/decoration is incremental: the observer callback only
handles newly-added nodes inside the official message area ([data-conversation-scroll]),
each new text is cheap-screened for path-like characters (no /, ~ or \ → skipped
with zero regex work and zero requests), and existence checks hit only the current
session — conversations without paths trigger no scanning at all; sidebars, hover cards,
menus and settings are never touched (v1.0.13).See docs/architecture.md.
~/.dsh/cordis.patch.yml; a double entry
applies the plugin twice and crashes on duplicate route registration.