dsh-at-file

不用贴全文、不用手打路径：输入框里敲 @ 搜工作区、插入路径，让 agent 按需去读。

解决什么问题

给 agent 指文件，要么贴整段全文、要么手打路径——前者浪费上下文、后者容易错。这个插件为 DSH Web 带来 Codex 风格的 @ 文件引用：在输入框里输入 @ 搜索当前工作区，选择文件或目录后，路径留在草稿里、可随时从引用栏打开或移除。

关键在”只引路径、不灌内容”：agent 开始执行步骤前，插件确认路径确实存在于活动工作区，然后注入一条简短引用消息 <workspace-reference path="docs/spec.pdf" kind="file" />，而不是把文件内容塞进提示——需要时 agent 再用手头的工具去查看。PDF、图片等不宜整段灌入的类型，走的是和其他文件完全一样的引用流程。

核心功能

• @ 路径选择器：纯文件名查询按精确 / 前缀 / 紧凑匹配排序；含 / 的查询按路径分段匹配；目录上按方向键可逐级进入
• 引用栏草稿：选中的路径留在草稿里，可打开或移除；Enter 与点击保持原有行为并完成目录引用
• 不灌全文：只注入 <workspace-reference> 标记，插件不打开文件、不罗列目录内容，由 agent 按需读取
• 粘贴默认当普通文本：从别处复制的 @path 不触发选择器、不进引用栏；可在「设置 → File mentions」关闭该保护
• 智能跳过索引：默认跳过版本控制目录、IDE 元数据、依赖树、缓存与构建产物，以及 desktop.ini / .DS_Store 等系统文件
• 文件过滤规则：全局与工作区两级，Exact / Regex 匹配、可单独开启大小写敏感，非法正则保存前即提示
• 配置可调：maxIndexedFiles 与 ignoreDirs 写入 cordis.patch.yml

快速上手

安装：

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

装完重启 dsh web。然后在输入框里敲 @ 搜索并选择文件，例如：

Review @docs/spec.pdf

文件过滤器在「设置 → File mentions」管理；要调整索引上限或排除目录，可在 profile 的 cordis.patch.yml 里加：

- id: dsh-at-file
  config:
    maxIndexedFiles: 10000

适合谁

• 频繁让 agent 处理指定文件的开发者（尤其 PDF、图片等不宜整段灌入的类型）
• 想让上下文更干净、引用更精确的 DSH 重度用户
• 讨厌手打长路径、又不想污染提示词的人