dsh-pathlink

Pathlink

在 DeepSeek Harness 聊天中按住 Ctrl 并点击文件路径和链接：路径会在操作系统文件管理器中打开其所在文件夹，链接会在新的浏览器标签页中打开。

目标 Profile

插件会安装到这里；不确定时保持 web。

npx -y @deepseek-ai/dsh plugin --profile web add dsh-pathlink@0.1.4

兼容性与来源证明

Pathlink 以 dsh-pathlink 发布，当前版本为 0.1.4。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。

DSH 兼容范围: *
运行环境: web
发布来源: npm
Registry 更新时间: 2026/9/21

版本

0.1.4stable

2026/9/8

0.1.3stable

2026/8/15

0.1.2stable

2026/8/15

查看其余 2 个版本收起版本

0.1.1stable

2026/8/15

0.1.0stable

2026/8/15

README

dsh-pathlink

English · 中文

Ctrl+click file paths and links in DeepSeek Harness chat.

Recognizes file paths and URLs in rendered chat messages (assistant replies, user bubbles, code blocks, tool cards), marks them with a subtle dotted underline, and opens them with Ctrl+click (⌘ on macOS):

Path → containing folder — the file's folder opens in the OS file manager with the file selected (Windows explorer /select, macOS open -R, Linux xdg-open on the parent directory). A path that names a directory opens the directory itself.
Link → new browser tab — covers bare URLs the renderer did not linkify (e.g. in user bubbles); markdown links already open in new tabs natively.

Plain clicks stay inert, so text selection and copy are never disturbed. When a path does not exist, a small toast explains why instead of failing silently.

ctrl+click tooltip

recognized path in chat

① Hovering a path shows the Ctrl+click hint — Ctrl+click opens the containing folder with the file selected · ② The recognized path in a real conversation (dotted underline).

Install

dsh plugin --profile web add dsh-pathlink

or via GitHub:

dsh plugin --profile web add github:penguin-oo/dsh-pathlink

Restart the web GUI afterwards. Requires the web profile (a browser is the only surface that can receive the click).

Usage

Wait for a settled message that mentions a path or a link — recognized tokens get a dotted underline.
Hold Ctrl (or ⌘ on macOS) and click.
- Path → folder opens in Explorer/Finder with the file selected.
- Link → opens in a new browser tab.
Relative paths resolve against the session's workspace directory first, then the harness working directory; missing paths show a toast.

Config

Key	Default	Meaning
`maxPathChars`	`1024`	Longest accepted path text, in characters

How it works

Client half (dsh.client, platform web): a MutationObserver-driven scanner watches the rendered conversation containers (data-chat-flow / data-conversation-scroll), recognizes paths and URLs in text nodes, wraps matches in inert inline spans, and handles one delegated capture-phase click listener. The official chatFileMentions seam is deliberately not used so the plugin never conflicts with the built-in deliverables provider and covers every surface uniformly.
Host half (pathlink Remote service): one read-only open method that resolves relative paths against the addressed session's working directory, verifies existence, and launches the platform file manager. No durable state; it never creates or resumes an Agent or Session.

Development

npm install
npm run build   # bundle src/client → lib/client.js
npm run smoke   # Remote markers + Typert manifest validation
node scripts/e2e-synthetic.mjs   # browser E2E against http://127.0.0.1:3738

docs/demo.html is built with node scripts/build-demo.mjs (reuses the production recognizer) and screenshotted by node scripts/e2e-screenshot.mjs.

Limitations

Web GUI only (the click surface is a browser); the host opener covers Windows / macOS / Linux.
Path recognition is heuristic: CJK directory names survive, but a path whose final segment is a bare English word (no extension) followed directly by prose may occasionally be over-matched — the existence check then shows the not-found toast instead of opening anything wrong.

License

MIT

Acknowledgements

Built for the DeepSeek Harness plugin ecosystem — thanks to the community on LINUX DO for feedback and testing.

README

dsh-pathlink

English · 中文

Ctrl+click file paths and links in DeepSeek Harness chat.

Path → containing folder — the file's folder opens in the OS file manager with the file selected (Windows explorer /select, macOS open -R, Linux xdg-open on the parent directory). A path that names a directory opens the directory itself.
Link → new browser tab — covers bare URLs the renderer did not linkify (e.g. in user bubbles); markdown links already open in new tabs natively.

Plain clicks stay inert, so text selection and copy are never disturbed. When a path does not exist, a small toast explains why instead of failing silently.

ctrl+click tooltip

recognized path in chat

① Hovering a path shows the Ctrl+click hint — Ctrl+click opens the containing folder with the file selected · ② The recognized path in a real conversation (dotted underline).

Install

dsh plugin --profile web add dsh-pathlink

or via GitHub:

dsh plugin --profile web add github:penguin-oo/dsh-pathlink

Restart the web GUI afterwards. Requires the web profile (a browser is the only surface that can receive the click).

Usage

Wait for a settled message that mentions a path or a link — recognized tokens get a dotted underline.
Hold Ctrl (or ⌘ on macOS) and click.
- Path → folder opens in Explorer/Finder with the file selected.
- Link → opens in a new browser tab.
Relative paths resolve against the session's workspace directory first, then the harness working directory; missing paths show a toast.

Config

Key	Default	Meaning
`maxPathChars`	`1024`	Longest accepted path text, in characters

How it works

Client half (dsh.client, platform web): a MutationObserver-driven scanner watches the rendered conversation containers (data-chat-flow / data-conversation-scroll), recognizes paths and URLs in text nodes, wraps matches in inert inline spans, and handles one delegated capture-phase click listener. The official chatFileMentions seam is deliberately not used so the plugin never conflicts with the built-in deliverables provider and covers every surface uniformly.
Host half (pathlink Remote service): one read-only open method that resolves relative paths against the addressed session's working directory, verifies existence, and launches the platform file manager. No durable state; it never creates or resumes an Agent or Session.

Development

npm install
npm run build   # bundle src/client → lib/client.js
npm run smoke   # Remote markers + Typert manifest validation
node scripts/e2e-synthetic.mjs   # browser E2E against http://127.0.0.1:3738

docs/demo.html is built with node scripts/build-demo.mjs (reuses the production recognizer) and screenshotted by node scripts/e2e-screenshot.mjs.

Limitations

Web GUI only (the click surface is a browser); the host opener covers Windows / macOS / Linux.
Path recognition is heuristic: CJK directory names survive, but a path whose final segment is a bare English word (no extension) followed directly by prose may occasionally be over-matched — the existence check then shows the not-found toast instead of opening anything wrong.

License

MIT

Acknowledgements

Built for the DeepSeek Harness plugin ecosystem — thanks to the community on LINUX DO for feedback and testing.