@freespace8/dsh-at-file
适用于 DeepSeek Harness Web GUI 的 Codex 风格 @ 路径引用：输入 @ 选择工作区文件或文件夹并引用其路径；主机在发送时进行验证并标记路径，不读取文件内容。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add @freespace8/dsh-at-file@0.2.3At File 以 @freespace8/dsh-at-file 发布，当前版本为 0.2.3。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Codex-style @ path mentions for the DeepSeek Harness Web GUI. Type @ in the composer to open a picker over the current workspace's files and folders; selecting one drops a readable @path token into the draft. Before sending, the host validates (at the agent/pre-step boundary) that the selected paths actually exist in the workspace and injects a presence-only reference for the model:
<workspace-reference path="docs/spec.pdf" kind="file" />
The plugin only passes paths — it never reads file contents and never expands directory descendants. Whether and how to inspect a reference is up to the agent's existing tools for the current session.
English · 简体中文
@-triggered picker with a directory-navigation model: the query is
split at the last / into "containing directory + filter keyword" — typing
plugins/d only lists the direct children of plugins whose names
contain d (no more whole-workspace fuzzy matching). Directories come
first, files after, each sorted alphabetically.@dir/) so you can keep
descending; Enter on a file runs the normal selection flow. Tab
confirms the selection immediately — for both files and directories it
inserts @path and finishes (a directory is never descended into), so
to pick a directory as-is (without entering it), highlight it and press
Tab. Mouse click selects directly (inserts @path ).@path; the pill is
only a decorative layer drawn after mirror-measurement — variable width,
no truncation, no overlap, with margin on all sides (not exceeding the
line). Selection acts on ordinary text.@path, directly adjacent to it, or on its trailing
separator space, a single Backspace/Delete removes the whole reference
(one press — no need to press twice), and the @ picker does not pop
up. Everywhere else, editing stays character-by-character. While the @
menu is still open (typing a filter, not yet confirmed), Backspace/Delete
is not intercepted and trims the filter character-by-character with the
menu refreshing live.The picker as it appears when you type @ in the composer:
dsh-at-file @ path reference picker preview
Published on npm — install with a single command (target profile web):
dsh plugin --profile web add @freespace8/dsh-at-file
After installing, restart dsh web (the host and the browser client load
together). To uninstall:
dsh plugin --profile web remove @freespace8/dsh-at-file
Type @ in a session composer: candidates render on a single line, the popup
width matches the composer, file names show in full (never truncated), and
the containing directory follows after (same-named files are distinguished by
directory). Directories come first, files after, each sorted
alphabetically.
The query is split at the last / into "directory + keyword": @plugins/d
shows only the direct children of plugins whose names contain d;
@plugins/ shows all direct children of plugins. While the menu is open,
Backspace/Delete edits the filter character-by-character.
Keyboard navigation: Enter on a directory enters it (the menu
refreshes to its children; keep descending, e.g.
@plugins/dsh-at-file/lib/); Enter on a file confirms the normal
selection flow. Tab confirms immediately — for both files and
directories it inserts @path and a directory is never descended into, so
to select a directory without entering it, highlight it and press Tab.
Mouse click selects the highlighted entry directly.
Selecting an entry turns it into a pill whose width hugs the full
@relative-path with at least 2 px of margin (and 2–3 px above/below, never
exceeding its line). Multiple pills are separated by natural spaces and never
overlap; long paths display in full without truncation. After a selection is
confirmed (menu closed), with the caret inside a pill, adjacent to it, or on
its separator space, a single Backspace/Delete removes the whole pill (the
@ list does not pop up); everywhere else editing stays
character-by-character.
Override any field in the profile's cordis.patch.yml by id (the config
block is replaced wholesale):
- id: dsh-at-file
config:
maxIndexedFiles: 10000 # per-workspace index entry cap (default 5000)
ignoreDirs: [] # directory basenames skipped during indexing (defaults in src/defaults.js)
The toggle and filter rules in 设置 → 文件提及 are persistent settings that take effect in real time — no restart needed.
plugins/dsh-at-file/
├── src/
│ ├── index.js # host entry: atFile Remote service, Typert manifest, settings namespace, pre-step boundary
│ ├── contract.js # zod wire contract + invocation descriptors (shared host/client)
│ ├── defaults.js # default ignored dirs/files + filter-rule normalization
│ ├── files.js # streaming workspace directory index (no symlinks, bounded truncation)
│ └── mention.js # @path scanning, validation, <workspace-reference> injection
├── lib/client.js # client half (zero-build bundle): @ trigger source, PillOverlay (mirror measurement + variable-width pills), settings section, locale
├── cordis.patch.yml # bundle patch line
└── tests/ # check.mjs artifact gate + unit.mjs pure-logic unit tests
zod (the Typert registry/gateway requires
zod-style schemas with .parse(), which schemastery lacks) and
@deepseek-ai/dsh-llm (for constructing user messages). Both resolve from
the harness root node_modules, so a local file: install needs no
pnpm install inside the plugin directory; on npm, dependencies.zod
is installed automatically.require can only hit platform seed
modules (react), so the wire contract, search, icons, and styles are all
inlined in lib/client.js (a minimal zod-compatible codec with only
.parse(), which is all ClientRemote needs).npm run check # artifact gate + pure-logic unit tests
The client side has been visually verified in the real GUI (dsh web,
installed into the web profile): root-level @ list (directories first,
files after), @plugins/d in-directory keyword filtering, Enter/Tab
directory navigation, file selection, mouse click, pills and whole-token
deletion all work. The host side (pre-step validation and
<workspace-reference> injection) has not been re-run in a real combination
(no host changes this cycle; covered by unit tests).
MIT — see LICENSE. This package is an independent implementation of
the @-mention concept from
dsh-at-file (MIT); the upstream
copyright notice is retained in LICENSE and the concept is credited here.