为 dsh Web 提供 Codex 风格 @file 引用的原生插件：在对话框输入 `@` 即可插入工作区相对的文件 / 目录路径引用，无需粘贴文件内容。
DSH 适配
原生运行时
作者声明
安全审计
未审计
最后核验
2026-08-22
许可证
MIT
01它能帮你完成什么？
在 DeepSeek Harness Web 对话框中通过路径引用工作区文件
输入 `@` 打开工作区路径选择器，检索当前工作区并插入工作区相对路径的文件 / 目录引用标记——Codex 风格的 @file 引用，无需粘贴文件内容
希望在 dsh Web 中按路径指向文件、而不是把完整内容贴进提示词的 DeepSeek Harness 用户
指向文件但把文件内容挡在提示词之外
插件只插入 `<workspace-reference path=… kind=… />` 标记；它不会打开文件，也不会列出目录内容，并且只解析位于当前工作区内部的路径
希望用轻量文件指针、同时让 Agent 的实际读取仍由自身会话工具控制的团队
02如何接入 DeepSeek Harness？
前置条件
- 已启用 Web 界面（`dsh web`）及 Web 配置的 DeepSeek Harness
- 在 dsh Web 客户端中已打开、需要使用 @file 引用的某个工作区
安装步骤
- 01
添加到 Web 配置（README 记载的是归档 URL；仓库现已在 `fsmargoo` 下发布）：`dsh plugin --profile web add https://github.com/omdsh-dev/dsh-at-file/archive/refs/tags/v0.6.7.tar.gz`
$ dsh plugin --profile web add https://github.com/omdsh-dev/dsh-at-file/archive/refs/tags/v0.6.7.tar.gz
- 02
重启 `dsh web`，使 Host 与浏览器客户端加载 `0.6.7` 版本
$ dsh web
- 03
（可选）通过 `~/.dsh/profiles/web/cordis.patch.yml` 配置选择器，例如 `maxIndexedFiles: 10000`，然后重新加载配置
验证接入成功
- 重启 `dsh web` 后，打开对话框并输入 `@`；应出现工作区路径选择器，可插入文件 / 目录引用
03DSH 适配与能力边界
原生 DeepSeek Harness（dsh）Web 插件。用 `dsh plugin --profile web add …` 安装到 Web 配置，之后在 dsh Web 对话框输入 `@` 即可打开工作区路径选择器并插入文件 / 目录引用。它接入 dsh Host（自身的 Host 连接），并从 `~/.dsh/profiles/web/cordis.patch.yml` 读取配置。
@ 路径选择器
在 dsh Web 对话框 `@` 之后输入的查询→排序后的工作区文件 / 目录结果（按文件名、按 `/` 段匹配、用 ArrowRight 进入目录），插入工作区相对路径
workspace-reference 标记
从选择器选中的文件或目录→在草稿中保留的 `<workspace-reference path=… kind=… />` 标记；任务需要时，Agent 可用自身会话工具检查该路径
不会打开被引用文件，也不会列出目录内容文件过滤器与选择器配置
设置 → 文件引用规则（全局 / 工作区、精确 / 正则、区分大小写）与 `cordis.patch.yml` 选项→通过 `maxIndexedFiles` 与 `ignoreDirs` 得到受限的选择器索引；改动会清空受影响范围的索引缓存，下一次 `@` 搜索即使用已保存规则
改动时清空受影响范围的索引缓存
04适合谁？何时不该用？
适合
- 希望在 dsh Web 中按路径指向文件、而不是把完整内容贴进提示词的 DeepSeek Harness 用户
- 希望用轻量文件指针、同时让 Agent 的实际读取仍由自身会话工具控制的团队
05兼容性、维护与安全提示
- 需要 DeepSeek Harness 的 Web 界面（`dsh web`）及 Web 配置；插件通过 `dsh plugin --profile web add …` 添加，且必须重启 `dsh web`，Host 与浏览器客户端才会加载新版本。
- 只接受工作区相对路径；绝对路径与逃逸出工作区的路径会被忽略。插件从不读取文件内容——它只插入纯路径引用，因此实际文件读取仍由 Agent 自身的会话工具完成。默认忽略粘贴的 `@` 标记。
- 路径引用机制适用于 0.3.0 及之后版本。更早的版本会在提交时读取文件内容并强制文件大小限制，因此旧安装的行为不同。
MIT · 活跃维护中（最新版本 v0.6.7，2026-08-20）
06常见问题
怎么把 dsh-at-file 安装进 DeepSeek Harness？
用 `dsh plugin --profile web add …` 添加到 Web 配置（README 记载的是 v0.6.7 归档 URL），再重启 `dsh web`，Host 与浏览器客户端便会加载新版本。`lib/` 下的构建产物已提交，因此无需构建步骤。
输入 `@` 会做什么？
它会在 dsh Web 对话框中打开工作区路径选择器。你可以按文件名搜索、用 `/` 匹配路径段（如 `src/view`）、用 ArrowRight 进入目录，并把文件或目录引用插入草稿。
插件会读取或暴露我的文件内容吗？
不会。它只插入工作区相对路径引用（`<workspace-reference path=… kind=… />`）。它不会打开文件，也不会列出目录内容；任务需要时，Agent 之后通过其自身会话工具读取该路径。
怎么控制选择器里出现哪些文件？
打开 设置 → 文件引用，添加全局与工作区规则（精确名称或正则，可任选区分大小写）。也可在 `~/.dsh/profiles/web/cordis.patch.yml` 中设置 `maxIndexedFiles` 与 `ignoreDirs`。
支持哪些 DeepSeek Harness 版本？
路径引用机制适用于 0.3.0 及之后版本。更早版本会在提交时读取文件内容并强制文件大小限制，因此旧安装的行为不同。
07相关的 DSH 工作流
petdex
作者 crafter-station
面向 Codex、Claude Code、DeepSeek Harness 等智能体的动效宠物公共图库。
dsh-deep-whale
作者 small-tailqwq
Whale Girl skin series for DeepSeek Harness. 适用于 DeepSeek Harness 的，鲸鱼娘系列皮肤。
awesome-dsh-plugin
作者 anil-matcha
DeepSeek Harness 插件生态精选列表，汇集优质插件、工具与资源。
working-activity
作者 ccch1mneyyy
为 pi CLI 与 DSH 打造的生动工作状态行扩展。
08数据与来源
Workspace path references for the DeepSeek Harness web interface. Type `@` in the composer to search the current workspa…
dsh plugin --profile web add https://github.com/omdsh-dev/dsh-at-file/archive/refs/tags/v0.6.7.tar.gz
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成；最后核验于 2026-08-22。发现错误？提交更正。