前言¶
在 DeepSeek Harness（DSH）Web GUI 中，输入框已经支持 @ 触发引用。若只引用技能或子代理，原生能力已经够用；但如果在消息里引用当前工作目录下的文件，就会缺少一个直接的选择入口。
AFAP/dsh-input-file-ref 是一个 DSH 输入框文件引用插件：输入 @ 后打开可搜索、可逐级下钻的文件选择面板，选中文件后把 @相对路径 回填到输入框，模型再按路径读取文件内容。
需要先说明：这个项目已归档，不再维护、不再更新。DeepSeek Harness 0.1.2-alpha.3 起已原生支持 @ 选取文件、文件夹与会话。README 明确建议不要再安装本插件，直接升级到最新的 DeepSeek Harness 即可。
这是什么¶
这是一个面向 DSH Web GUI 输入框的文件引用插件，由 AFAP 维护，许可证为 MIT。
它做的事情比较单一：
- 在输入框输入
@时弹出文件选择面板； - 支持搜索当前工作目录下的文件；
- 支持进入子目录浏览；
- 选中文件后把
@相对路径作为普通文本回填到输入框； - 发送消息后，由模型按相对路径读取文件内容。
它的适用前提也很明确：会话需要已经选择工作目录。没有工作目录时，面板会显示提示，不会崩溃。
核心功能¶
下面介绍插件的主要能力。
- 输入
@时，弹出与输入框同宽的文件选择面板，顶部带搜索栏。 - 支持关键字即时递归搜索文件，匹配规则为大小写不敏感子串匹配。
- 支持逐级下钻文件夹，可以进入
.git、node_modules、target等目录。 - 搜索模式默认排除
.git、node_modules、target等忽略目录；浏览模式下仍可逐级进入这些目录。 - 文件行显示相对全路径，路径过长时中间用
…省略。 - 默认展示 50 条结果；继续输入关键字后，可逐步放宽到 100 / 200 / 500 条。
- 支持键盘选择：
↑、↓、Enter、Esc，也支持鼠标选择。 - 选中文件后保留
@，并回填文件相对全路径，末尾保留一个空格。 - 支持连续引用多个文件。
- 插件只读、零外部依赖，并具备浏览器信任围栏（防 DNS 重绑定 / 跨站）。
- 界面文案支持中英双语，跟随界面语言。
这个插件不内联文件内容到消息，不做文件预览 / 语法高亮，也不支持多选批量。它只负责把文件路径以文本形式放入输入框。
安装与启用¶
由于项目已归档，新环境不建议安装本插件。若要查看旧实现或验证等价安装，可使用 README 给出的安装命令：
dsh plugin --profile web add github:AFAP/dsh-input-file-ref
安装后需要重启 dsh web 生效。
插件会随 DSH Web 端加载并运行，安装前建议检查源码与 MIT 许可证，确认它符合你的使用环境和安全要求。
典型用法¶
下面是一组可复现的使用步骤。
1、打开一个已选择工作目录的 DSH 会话。
2、在输入框中输入 @，打开文件选择面板。
3、面板顶层展示当前目录内容。可以直接点击文件夹，逐级进入子目录。
4、在顶部搜索栏中输入关键字，或在 @ 后继续输入关键字，进行递归搜索。
5、搜索结果默认显示 50 条。继续输入关键字后，可显示更多结果。
6、进入某个子目录后，可通过“↑ 上级目录”或 Backspace 返回上级目录。
7、选中文件后，输入框会回填类似下面的文本：
@src/main.ts
注意末尾有一个空格。这个空格会让 @ 停止再次触发选择，方便继续输入或编辑。
8、发送消息后，消息中包含相对路径文本。模型可以使用 fs 工具按该路径读取文件内容。
如果需要引用多个文件，可以再次输入空格和 @，重新打开选择面板。回填内容是普通文本，可以直接编辑或删除。
适用场景与注意¶
这个插件适合用于了解旧版 DSH 输入框的文件引用实现，也适合作为文件选择面板的参考实现。但作为生产使用，当前更推荐直接升级 DeepSeek Harness，使用原生 @ 选取文件、文件夹与会话的能力。
需要注意几点：
- 项目已归档，不再维护、不再更新。
- README 建议不要再安装本插件，直接升级到最新的 DeepSeek Harness。
- 会话需要已选择工作目录；未选择工作目录时，面板会显示提示。
- 搜索结果默认排除
.git、node_modules、target等忽略目录；如需选择这些目录中的文件，应使用浏览模式逐级进入。 - 插件只读，不修改、不删除任何文件。
- 宿主只读取会话日志头部与文件系统元信息，不读取文件内容。
- 浏览器信任围栏要求 loopback 或
trustedHosts同源请求，拒绝跨站请求。 - MVP 暂不支持内联文件内容、文件预览 / 语法高亮和多选批量。
结尾¶
AFAP/dsh-input-file-ref 的价值在于给出一个比较克制、边界清晰的 DSH 输入框文件引用实现：搜索、浏览、路径回填和模型读取被拆分成清楚的步骤，同时保持只读、零外部依赖和浏览器侧的安全限制。
当前更推荐直接使用最新 DeepSeek Harness 的原生 @ 文件选择能力。下面链接可用于查看源码和目录信息。
GitHub：
https://github.com/AFAP/dsh-input-file-ref
目录页：
https://www.skillhub.cn/plugins/AFAP/dsh-input-file-ref
