Back to directory

omdsh-dev/dsh-at-file

Curated pick

omdsh-dev/dsh-at-file

在 Web 输入框用 @file 提及工作区文件/目录并把内容注入提示词

View on GitHub
$ dsh plugin --profile web add https://github.com/omdsh-dev/dsh-at-file/archive/refs/tags/v0.6.7.tar.gz

MIT-licensed plugin for the DeepSeek Harness web UI that adds @-mention workspace file and directory references to the composer; installed into the `web` profile via `dsh plugin --profile web add`.

DSH integration

Compatible

Author-claimed

Safety audit

Unaudited

Last verified

2026-08-21

License

MIT

01What can it help you accomplish?

  • Reference workspace files and directories directly in DeepSeek Harness prompts

    Codex-style @ picker results inserted into the draft, verified against the active workspace and attached as `<workspace-reference path=... kind=... />` markers before each agent step

    Developers running `dsh web` who want @file mentions instead of typing or pasting paths by hand

  • Keep the @ picker relevant in large repositories

    Filename and path-segment search with directory drill-down, plus global and per-workspace Exact/Regex file filters saved in the DSH web profile

    Teams working in large or monorepo workspaces who need to exclude version-control folders, dependency trees and build output from file mentions

02How to install into DeepSeek Harness

Prerequisites

  • DeepSeek Harness with the `dsh` CLI and the `web` profile — the plugin runs inside `dsh web`

Installation steps

  1. 01

    Run `dsh plugin --profile web add https://github.com/omdsh-dev/dsh-at-file/archive/refs/tags/v0.6.7.tar.gz`

    $ dsh plugin --profile web add https://github.com/omdsh-dev/dsh-at-file/archive/refs/tags/v0.6.7.tar.gz

  2. 02

    Restart `dsh web` so the Host and browser client load version 0.6.7 (the same command also updates an existing installation)

    $ dsh web

Verify the integration

Not specified by the author

03DSH integration and capability boundaries

DSH integrationCompatible

Plugin for the DSH web interface (`dsh web`), installed with the official `dsh plugin` CLI; adds @-mention workspace path references to the composer

  • @ path picker in the composer

    typing `@` followed by a query in the dsh web composerranked file/directory candidates — exact names, prefixes and compact matches first; `/` queries match path segments in order; ArrowRight drills into directories

  • Workspace-reference injection

    selected or typed @path tokenspath existence check inside the active workspace plus a `<workspace-reference>` marker carrying the workspace-relative path and its kind

  • File-name filters (Settings -> File mentions)

    Exact or Regex rules per basename, with optional case sensitivityglobal rules shared by every workspace plus per-workspace rule lists applied to the picker index

    Settings are saved in the DSH web profile through the plugin's own Host connection; changing rules clears the affected index cache
  • Picker index configuration

    the profile's `cordis.patch.yml``maxIndexedFiles` cap and a custom `ignoreDirs` exclusion list for the picker index

    Configuration is written to the selected profile's `cordis.patch.yml` (usually `~/.dsh/profiles/web/cordis.patch.yml`)

04Who is it for? When not to use it?

Good for

  • Developers running `dsh web` who want @file mentions instead of typing or pasting paths by hand
  • Teams working in large or monorepo workspaces who need to exclude version-control folders, dependency trees and build output from file mentions

Not for

  • The plugin only attaches paths — reading content is up to the agent's session tools (DSH provides `read` for UTF-8 text and `read_image` for supported images; PDF support depends on the tools available in the session).

05Compatibility, maintenance and safety notes

  • The plugin only attaches paths — reading content is up to the agent's session tools (DSH provides `read` for UTF-8 text and `read_image` for supported images; PDF support depends on the tools available in the session).
  • Since v0.3.0, pasted @ tokens are ignored by default — an @path copied from another application does not open the picker or create reference markers unless 'Ignore @ mentions in pasted text' is turned off; earlier releases read file content during submission and enforced file-size limits.
  • Picker results are capped by `maxIndexedFiles`, and the index is cached per session for 30 seconds, so newly created files can take up to half a minute to appear.
2026-08-132026-08-19v0.6.7

MIT · actively maintained (latest release v0.6.7, 2026-08-20)

06Frequently asked questions

How does dsh-at-file integrate with DeepSeek Harness?

It is a plugin for the DSH web interface: install it with `dsh plugin --profile web add <release tarball URL>` and restart `dsh web`. It is not an MCP server — the @ picker and reference bar live directly in the composer.

What exactly happens when I @-mention a file?

The plugin confirms the path exists inside the active workspace, then adds a short `<workspace-reference path="..." kind="file" />` message before the agent starts a step. It does not open the file or read its content; the agent inspects the path with its own session tools when the task requires it.

Why doesn't a pasted @path open the picker?

Since version 0.3.0, pasted text is treated as ordinary text by default. Turn off **Ignore @ mentions in pasted text** in **Settings -> File mentions** if you need the older behavior.

How do I control which files show up in the @ picker?

In **Settings -> File mentions**, add Exact or Regex rules per basename (case sensitivity optional), managed as global and per-workspace lists. For index tuning, set `maxIndexedFiles` or override `ignoreDirs` in the profile's `cordis.patch.yml` (usually `~/.dsh/profiles/web/cordis.patch.yml`).

08Data and sources

  • Author-claimedgithub.comc57849b27e37…

    Workspace path references for the DeepSeek Harness web interface. Type `@` in the composer to search the current workspa…

  • Author-claimedgithub.comc57849b27e37…

    Use the same command to update an existing installation. Restart `dsh web` after installation so the Host and browser cl…

This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-08-21. Found an error? Submit a correction.

🏆

Best DeepSeek Harness Plugins

Twelve plugins worth installing first — picked from the whole catalog, across every category.

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.