中文 | English

dsh-at-mention

A DSH profile bundle that adds @-file mentions to the composer, with an
interaction model similar to Claude Code / Codex Desktop. Typing @ in the
input box opens a prioritized fuzzy search over files and directories in the
current session workspace.

Features

• Per-session workspace scope: @ only surfaces files/directories of the
  session's own workspace (header.cwd); switching workspaces switches the
  index automatically (LRU cache for up to 3 workspaces, no rescanning).
• Prioritized fuzzy search: exact name > name prefix > name substring >
  path prefix > path substring > fuzzy subsequence; shallower directories and
  shorter paths rank higher, matches at path-segment boundaries get a bonus.
• Keyboard: ↑/↓ to move, Tab / Enter to pick, Esc to close
  (Tab is consumed even with no matches, so focus never jumps away).
• Space-separated consecutive mentions: @a @b is two mentions, @a@b
  is a single token (mirrors the built-in trigger rules).
• Plain-text mentions: picking inserts @relative/path (configurable:
  absolute path, trailing space on/off). The inserted text can be copied or
  edited later and remains a valid mention.
• Hover a candidate to see its full path (absolute + relative) in the
  tooltip when the row text is truncated.
• Durable settings in Settings → @ 提及: enable, max results, insert
  path style, fuzzy / case-sensitive / directories / trailing space,
  excluded directories, index file cap, auto-refresh interval, and a
  manual rebuild index button with live index status.
• Cross-platform indexing: find fast path on Linux/WSL/macOS, with a
  pure readdir fallback anywhere find is missing (e.g. native Windows).
  Default exclusions: .git, .godot, .import, node_modules,
  .codegraph, .kimi-code (editable).

Installation

Prerequisites: a working DSH installation (dsh web) and pnpm on PATH
(dsh plugin forwards to pnpm).

# 1. Unzip, e.g. to D:\plugins\dsh-at-mention

# 2. Install into the web profile
dsh plugin --profile web add file:D:/plugins/dsh-at-mention

# or from the parent directory of the unzipped folder:
dsh plugin --profile web add ./dsh-at-mention

dsh plugin add runs pnpm in the profile directory and appends the bundle's
cordis.patch.yml to the profile patch stack. Restart the web app afterwards
(the client bundle and routes are wired at boot).

Removal:

dsh plugin --profile web remove @dsh-external/dsh-at-mention

API routes (same-origin, for reference)

POST routes reject cross-site requests.

Notes

• The mention text itself is plain text (@relative/path), so the model in
  the session resolves it against the session workspace; relative paths are
  portable across Linux and Windows.
• While the mention menu is open, the built-in trigger menu is hidden (it
  shares the @ trigger); the / command menu is unaffected.