dsh-at-file：为 DeepSeek Harness 提供 Codex 风格的 @ 文件引用

dsh-at-file 是 DeepSeek Harness（DSH）的插件（DSH plugin），为 Web 界面提供 Codex 风格的 @ 文件引用功能。它解决在 composer 中快速查找并引用工作区文件的问题，避免手动输入完整路径。核心能力包括路径选择器、文件过滤规则、以及提交时的工作区路径校验。该插件由 omdsh-dev 维护，采用 MIT 协议，最近更新于 2026-08。

dsh-at-file 这个 DSH plugin 的 @ 路径选择器如何使用？

在 composer 中输入 @ 即可触发路径选择器，搜索当前工作区的文件和目录。普通查询按文件名匹配，精确名称、前缀和紧凑匹配优先；包含 / 的查询按路径段顺序匹配，例如 src/view 可找到 src/client/view.ts。选中目录后按 ArrowRight 可进入该目录，草稿会更新为 @path/ 并保持候选菜单打开。每个结果展示文件名和父目录，内置 SVG 图标区分文件夹、源文件、文本、PDF、图片等类型。默认索引会跳过常见版本控制目录、IDE 元数据、依赖树、缓存和构建输出。

dsh-at-file 怎么安装和更新？

安装或更新 dsh-at-file 使用以下命令，安装后需重启 dsh web 以加载新版本：

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

dsh-at-file 的文件过滤规则如何配置？

在 Settings -> File mentions 中可管理文件名过滤规则。Global 规则适用于所有工作区，Workspace 规则仅适用于当前工作区。每条规则支持 Exact（精确匹配完整文件名）或 Regex（JavaScript 正则表达式）模式，并可独立启用大小写敏感。无效正则会在保存前提示并被 Host 拒绝。Restore defaults 重置全局列表，Clear workspace rules 仅清除当前工作区的规则。设置通过插件自身的 Host 连接保存到 DSH web profile 中。

dsh-at-file 如何处理引用路径？

在 agent 开始执行步骤前，插件会确认路径存在于活动工作区内，并添加一条简短的引用消息，例如 <workspace-reference path="docs/spec.pdf" kind="file" />。插件不会打开引用文件或列出目录内容，agent 可在需要时使用当前会话中的工具检查路径。文件格式和大小不影响此行为，PDF 与普通文件遵循相同的路径引用流程。此机制适用于 0.3.0 及更高版本，早期版本会在提交时读取文件内容并强制文件大小限制。

dsh-at-file 的兼容性和许可证如何？

该插件是 DeepSeek Harness 生态的一部分，依赖多个官方包，如 @deepseek-ai/dsh-agent、@deepseek-ai/dsh-client-runtime 等，确保与 DSH 的深度集成。项目采用 MIT 许可证，由 omdsh-dev 维护，当前 Stars 245，Forks 9，最近更新于 2026-08-14。

查看更多 DSH 插件，访问 dsh-plugin.org