dsh-at-file 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；自动检查通过：npm 包已发布且 engines 声明满足基线；该结论来自程序自动检查，未经人工实机验证。

dsh-at-file 兼容性怎么样？

自动检查通过：npm 包已发布且 engines 声明满足基线；该结论来自程序自动检查，未经人工实机验证。

dsh-at-file 有中文文档吗？

已提供中文翻译 README（由 DeepSeek 最新模型翻译生成），本站可切换中英文对照阅读。

dsh-at-file 还在维护吗？

GitHub 547 星。最近一次上游提交在 2026/9/1。

工作区路径引用 FSMargoo/dsh-at-file

Q: dsh-at-file 是什么插件？

为 DeepSeek Harness 加上 Codex 风格的 @文件 提及：在输入框里搜索工作区文件，把路径附到提示词中。

DeepSeek Harnessv0.6.3

FSMargoo63 天前有提交已提供中文文档扫描：含敏感能力code

在 GitHub 查看 ↗

最新版官方 DeepSeek Harness 已经内置 @file 和 @session…

67.1/100

综合分

547

GitHub 星标

37,652

npm 周下载

—/5

用户评分

数据截至 2026/9/2 · 周下载取自 npm 全网（含 CI / 镜像），非本站安装数；综合分由星标、活跃度与兼容性检查合成。

安装命令 · 需先装 dsh CLI 引擎

dsh plugin --profile web add dsh-at-file

npm 源 · dsh-at-file 的发布者账号已校验与本仓库一致

状态速览

判定依据：实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态

信任档位：需留意

是什么

dsh 原生插件 · market

装得上吗

实装验证未通过（runtime_smoke_failed），装前请到仓库确认最近更新与 issue

L4 · 真实安装等级说明 →

安全吗

本站尚未对该插件做风险分级

暂未覆盖，不等同于无风险

还在维护吗

更新放缓：最近一次提交在 63 天前

档位由哪些信号合成

本站实装验证（真实安装 L4 覆盖全站；L5 为运行时冒烟或实机截图，覆盖范围小于 L4） · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。

验证判据与等级说明 →

⚠︎ 实装验证未通过（runtime_smoke_failed · 2026/10/29） ——可能是验证环境差异，装前建议到 GitHub 仓库确认最近更新与 issue。

社区实装还没有人打卡 · 装过的第一个就是你

安装兼容性检查✓ 自动检查通过

展开查看检查明细 ↓

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。

✓npm 包dsh-at-file @ 0.6.3

✓Node 引擎未声明 engines.node

✓dsh CLI 依赖未声明 dsh 版本约束

✓入口文件main/exports/bin 已声明

验证方式：npm registry 存在性 + package.json 静态校验 · 最后检查 2026/10/29 01:41:26

安全扫描自动 · 静态分析源码

v2.7.0

🔵 扫描：含敏感能力尚无人工评估

展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力：执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量（至少其一）。这是能力清单，不是危险判定——具体能力项与证据见下方，安装前请自行判断是否需要。

读写/删除本地文件

查看扫描证据（共 2 处，展示前 2 条）

读取本地文件
lib/index.js:1076
handle = await raceAbort(opendir(dir), signal);
读取本地文件
lib/index.js:15885
const info = await stat(absolute).catch(() => void 0);

扫描于 2026/11/3（0 天前） · 范围入口闭包 + 全包扫描 · 来源 npm 发布包

静态扫描只反映源码中出现的调用，不构成安全背书；人工评估与自动扫描相互独立、互不覆盖。

依赖的 DSH / Cordis 模块

@deepseek-ai/cordis@deepseek-ai/dsh-agent@deepseek-ai/dsh-typert-protocol@deepseek-ai/dsh-invariants@deepseek-ai/schemastery@deepseek-ai/dsh-client-store@deepseek-ai/dsh-api-remotes@deepseek-ai/dsh-client-ui-input-trigger@deepseek-ai/dsh-client-ui-slots@deepseek-ai/dsh-client-ui-conversation@deepseek-ai/dsh-client-locale@deepseek-ai/dsh-client-connection

给这个插件打分还没有人投票↓

用户评分

还没有人投票，来当第一个

广告精选好物

飞利浦 TAH6519 主动降噪耳机 ¥299

头戴式无线 anc 主动降噪，蓝牙连接，久戴舒适向。

·anc 主动降噪 · 头戴式无线
·价格与库存以商品页实时为准

去淘宝看看→

广告MCP 兼容手册

装完插件，给 AI 接上 MCP

Cursor、Claude Code、VS Code 逐个核对：能不能装、配置怎么写、装不上是什么原因。

·按客户端逐格核对
·结论标注依据与风险等级

查 MCP 兼容性→

界面预览

3 张 · 点击查看大图

功能亮点

搜索工作区文件
路径附入提示词

为 DeepSeek Harness 加上 Codex 风格的 @文件提及：在输入框里搜索工作区文件，把路径附到提示词中。

README

由 DeepSeek 最新模型翻译生成

dsh-at-file [!IMPORTANT] 最新版官方 DeepSeek Harness 已经内置 @file 和 @session 引用功能。新安装请优先使用官方实现；本插件继续供现有环境使用，后续随缘维护。 DeepSeek Harness Web 界面的工作区路径引用插件。在输入框输入 @，可以搜索当前工作区并插入文件或目录路径。 @ 路径选择器输入框中的文件引用使用方式从 @ 菜单选择结果后，路径会保留在输入内容中。输入框上方的引用栏可以打开路径或移除引用。请检查 @docs/spec.pdf 每次 agent 开始处理前，插件会确认该路径位于当前工作区且仍然存在。确认成功后，插件会补充一条简短的引用消息： <workspace-reference path="docs/spec.pdf" kind="file" /> 引用消息仅包含工作区相对路径和路径类型。插件不会打开引用文件，也不会列出引用目录中的内容。任务需要读取时，由 agent 使用当前会话中可用的工具处理该路径。默认情况下，粘贴的文字会保持普通文本。用户从其他应用复制的 @路径不会打开选择器、出现在引用栏中，也不会生成工作区引用标记。在设置 -> 文件提及中关闭忽略粘贴文本中的 @，即可恢复旧行为。文件格式和文件大小不会改变处理流程。

展开完整文档（README 剩余 1 节）

dsh-at-file

[!IMPORTANT]
最新版官方 DeepSeek Harness 已经内置 @file 和 @session 引用功能。新安装请优先使用官方实现；本插件继续供现有环境使用，后续随缘维护。

DeepSeek Harness Web 界面的工作区路径引用插件。在输入框输入 @，可以搜索当前工作区并插入文件或目录路径。

@ 路径选择器

输入框中的文件引用

使用方式

从 @ 菜单选择结果后，路径会保留在输入内容中。输入框上方的引用栏可以打开路径或移除引用。

请检查 @docs/spec.pdf

每次 agent 开始处理前，插件会确认该路径位于当前工作区且仍然存在。确认成功后，插件会补充一条简短的引用消息：

<workspace-reference path="docs/spec.pdf" kind="file" />

引用消息仅包含工作区相对路径和路径类型。插件不会打开引用文件，也不会列出引用目录中的内容。任务需要读取时，由 agent 使用当前会话中可用的工具处理该路径。

默认情况下，粘贴的文字会保持普通文本。用户从其他应用复制的 @路径 不会打开选择器、出现在引用栏中，也不会生成工作区引用标记。在 设置 -> 文件提及 中关闭 忽略粘贴文本中的 @，即可恢复旧行为。

文件格式和文件大小不会改变处理流程。PDF 与其他工作区文件使用相同的路径引用机制。

以上机制适用于 0.3.0 及后续版本。早期版本会在提交时读取文件内容，并受文件大小限制。

路径选择器

普通关键词只匹配文件名。完整名称、前缀和紧凑匹配会排在前面，长目录路径中分散的字符不会产生无关结果。

未输入关键词时，浅层路径会排在深层条目前面，同一层级中目录排在文件前面。可滚动菜单最多提供 50 个候选项，根目录文件不会再被深层目录挤出列表。

关键词中包含 / 时，选择器会依次匹配路径片段。例如，src/view 可以找到 src/client/view.ts。输入 src/ 也可以搜索该路径下的条目。

高亮目录候选后，按右方向键可以进入该目录。输入内容会推进到 @路径/，末尾不添加空格，候选菜单会继续显示。按回车或使用鼠标选择目录时，仍会完成该目录引用。

候选项优先完整显示文件名，下方显示父目录。有足够空间时，菜单会展开到 537px 的设计宽度；过长文件名会自动换行，不再省略。遇到重名文件时，父目录也会写入主标题。内置 SVG 图标可区分目录、源代码、文本、PDF、图片、数据与配置、压缩包以及其他文件。

默认索引会跳过常见的版本控制目录、IDE 元数据、依赖目录、缓存和构建产物。目前涵盖 VS Code、Visual Studio、JetBrains IDE、Fleet、Eclipse、Android 与 Gradle、Xcode、CMake、Flutter、.NET、Unity、Unreal，以及常见的 JavaScript 和 Python 输出目录。desktop.ini、Thumbs.db 和 .DS_Store 这类系统元数据文件也会默认排除。

安装或更新

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

已有安装也使用这条命令更新。安装完成后重启 dsh web，确保 Host 和浏览器客户端加载 0.7.0。

0.7.0 同时兼容 Harness 0.1.1 与 0.1.2 的客户端包结构；它也会为曾经保存过空旧配置的安装恢复默认文件忽略项。在 0.7.0 中再次清空列表仍会被视为用户的明确选择。

文件过滤

在 设置 -> 文件提及 中管理文件名过滤规则。

包含 Exact 和 Regex 规则的文件提及设置

- 全局 保存所有工作区共用的规则。
- 工作区 保存当前所选工作区路径的附加规则。每个工作区都有独立列表，面板中会同时显示该工作区继承的全局规则。

每条规则可以单独选择匹配方式和大小写设置：

- Exact 匹配一个完整文件名，不接受路径分隔符。
- Regex 使用 JavaScript 正则表达式匹配完整文件名。匹配内容不包含父目录或工作区路径。
- 区分大小写 可以用于任何 Exact 或 Regex 规则，默认关闭。

规则可以逐项添加和删除。无效正则会在保存前显示错误，Host 也会拒绝无效规则。恢复默认值 会重置全局列表，清空工作区规则 只会移除当前工作区的附加项。

设置通过插件自己的 Host 接口保存到 DSH web profile。已有的字符串规则会继续作为不区分大小写的 Exact 规则使用，包括全局列表和工作区列表。修改规则时会清除相关索引缓存，下一次输入 @ 即可使用新规则。

配置

当前配置只影响路径选择器的索引：

- maxIndexedFiles 设置工作区索引条目的数量上限。
- ignoreDirs 替换内置的忽略目录列表。设置为 [] 时会索引所有目录。

请把完整配置写入所选 profile 的 cordis.patch.yml。常用路径为 ~/.dsh/profiles/web/cordis.patch.yml。

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

省略 ignoreDirs 会继续使用内置列表。填写该字段时，请列出所有需要排除的目录名。

路径处理

- 选择器索引当前工作区中的常规文件、目录和符号链接。目录链接会通过其工作区内的相对别名继续遍历；若链接指回上级目录，则保留该链接但不再进入，以避免循环。
- Host 遍历工作区时会合并全局和当前工作区的文件名规则。被过滤的条目不会占用 maxIndexedFiles，也不会发送到浏览器。
- Host 接受工作区相对路径。绝对路径以及越出工作区的路径会被忽略。
- 手动输入的文本和选择器中的选择可以生成引用消息。默认设置开启时，粘贴文本中的 @ 会被忽略。
- 点击引用路径时会调用 Harness 的 host.openPath 端点。
- 每个会话的路径索引缓存 30 秒。
- 引用栏只渲染当前会话已完成索引且确实存在的路径；未知的 @文本 保持普通文本。
- @路径 不能包含空白字符或另一个 @ 字符。
- maxIndexedFiles 限制选择器显示的结果。手动输入的路径只要位于工作区且确实存在，仍然可以引用。

当前 agent 可能没有处理某种文件格式的工具。DSH 的 read 用于 UTF-8 文本，read_image 用于支持的图片格式。PDF 的处理能力取决于当前会话提供的工具。

开发

pnpm install
pnpm run check
pnpm run test
pnpm run build

开发环境默认官方 deepseek-ai/deepseek-harness 仓库位于 ../deepseek-harness，与该仓库的默认克隆目录一致。lib/ 中的构建产物会提交到仓库，因此 profile 安装过程无需运行包构建脚本。

License

MIT