dsh-file-ref 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；基本兼容但装前注意：未发布到 npm registry，仅可从源码安装

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

基本兼容但装前注意：未发布到 npm registry，仅可从源码安装

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

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

dsh-file-ref 还在维护吗？

GitHub 2 星。最近一次上游提交在 2026/8/20。

文件路径引用 auroralab-art/dsh-file-ref

DeepSeek Harness

auroralab-art76 天前有提交已提供中文文档扫描：含敏感能力

在 GitHub 查看 ↗

拖入任意文件，自动插入路径引用供 agent 读取

28.8/100

综合分

GitHub 星标

—

npm 周下载

—/5

用户评分

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

自动兼容检查有告警：未发布到 npm registry，仅可从源码安装。

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

dsh plugin --profile web add auroralab-art/dsh-file-ref

该包不可直接 npm 安装，改从 GitHub 源安装（明细见下方安装检查）

状态速览

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

信任档位：已验证

是什么[目录]—

dsh 原生插件 · other

暂无时间戳·判据 →

装得上吗[实装验证]✓

本站已真实安装成功

非静态推断

L4 · 真实安装等级说明 →

数据截至 2026/09/25·判据 →

安全吗[自动扫描]—

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

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

数据截至 2026/11/04·判据 →

还在维护吗[仓库]—

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

暂无时间戳·判据 →

图例：✓ 通过! 需注意— 未判定 / 无数据· 「未判定」= 本站尚无数据，不代表插件有问题

档位由哪些信号合成

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

验证判据与等级说明 →

可信度证据

安装兼容性检查⚠ 装前注意

未发布到 npm registry，仅可从源码安装

展开查看检查明细 ↓

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

✗npm 包dsh-file-ref（未发布到 npm，仅可源码安装）

✓Node 引擎未声明 engines.node

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

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

验证方式：npm registry 存在性 + package.json 静态校验 · 最后检查 2026/9/24 04:23:38

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

v2.7.0

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

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

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

读写/删除本地文件发起外部网络请求

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

发起网络请求
src/client/stage.ts:15
const response = await fetch(FILE_REF_STAGE_ROUTE, {
写入本地文件
src/inbox.ts:45
await mkdir(inbox, { recursive: true })
写入本地文件
src/inbox.ts:47
await writeFile(absolutePath, data)
读取本地文件
src/inbox.ts:67
await stat(path)
读取本地文件
src/mention.ts:44
const info = await stat(absolute).catch(() => undefined)

扫描于 2026/11/4（0 天前） · 范围全包扫描（包内未声明入口） · 来源 GitHub 仓库

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

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

用户评分

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

广告精选好物

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

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

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

去淘宝看看→

广告MCP 兼容手册

装完插件，给 AI 接上 MCP

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

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

查 MCP 兼容性→

功能亮点

拖入文件插入路径
支持工作区路径
支持绝对路径

DeepSeek Harness 插件：粘贴或拖入文件，插入 @workspace 路径或绝对路径。

README

由 DeepSeek 最新模型翻译生成

dsh-file-ref 为 DeepSeek Harness 添加文件附件能力。版本许可 DSH 把本地文件拖入或粘贴到 DSH 对话栏 — PDF、CSV、代码、文档均可。插件解析文件系统路径，插入一条 @workspace 引用，agent 用现有工具打开即可。不上传字节，不增加模型上下文。为什么需要这个插件？没有本插件时，DSH 对话栏只接受 PNG、JPEG、WebP、GIF。其它文件会被当作「不支持的图片格式」拒绝。 dsh-file-ref 为任意文件补上路径引用： - 浏览器或 Host 能解析到原路径时，引用原件。 - 否则在工作区 inbox 落一份副本，再 @ 这条路径。 - 在模型步进前给 @相对路径打存在性标记，agent 用会话里已有的 read、shell 等工具打开。不新增上传接口，不新增模型侧文件工具。agent 用当前会话已有的访问模式读取文件。快速开始需要本机已安装 dsh CLI，并使用 web profile。 dsh plugin --profile web add https://github.com/auroralab-art/dsh-file-ref/releases/download/v0.1.0/dsh-file-ref-0.1.0.tgz 重启 dsh web 并硬刷新浏览器，完成。

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

dsh-file-ref

为 DeepSeek Harness 添加文件附件能力。

版本许可 DSH

把本地文件拖入或粘贴到 DSH 对话栏 — PDF、CSV、代码、文档均可。插件解析文件系统路径，插入一条 @workspace 引用，agent 用现有工具打开即可。不上传字节，不增加模型上下文。

为什么需要这个插件？

没有本插件时，DSH 对话栏只接受 PNG、JPEG、WebP、GIF。其它文件会被当作「不支持的图片格式」拒绝。

dsh-file-ref 为任意文件补上路径引用：

- 浏览器或 Host 能解析到原路径时，引用原件。
- 否则在工作区 inbox 落一份副本，再 @ 这条路径。
- 在模型步进前给 @相对路径 打存在性标记，agent 用会话里已有的 read、shell 等工具打开。

不新增上传接口，不新增模型侧文件工具。agent 用当前会话已有的访问模式读取文件。

快速开始

需要本机已安装 dsh CLI，并使用 web profile。

dsh plugin --profile web add https://github.com/auroralab-art/dsh-file-ref/releases/download/v0.1.0/dsh-file-ref-0.1.0.tgz

重启 dsh web 并硬刷新浏览器，完成。

卸载：

dsh plugin --profile web remove dsh-file-ref

工作原理

| 文件位置 | 插入到草稿的文本 |
| 当前工作区内 | @docs/spec.pdf |
| 工作区外原路径 | /Users/you/Downloads/spec.pdf |
| 浏览器藏了路径 | @.dsh-inbox/spec.pdf（副本写入工作区） |
| PNG / JPEG / WebP / GIF | 官方图片轨，不改 |

发送前，Host 确认每个 @相对路径 仍在工作区内，并注入：

工作区外的绝对路径保持原文。插件不打开文件，也不上传字节。agent 按当前会话的工具和访问模式去读取。

路径解析规则

- PNG、JPEG、WebP、GIF 的粘贴和拖放仍走官方图片轨。
- 工作区内路径插入为 @相对路径。工作区外路径插入为绝对路径原文。
- 浏览器不给出文件系统路径时，Host 在 inboxDir 下写入副本，草稿再 @ 该相对路径。
- 只有仍位于工作区内的 @相对路径 会生成引用标记。
- 绝对路径保持原文，插件不会改写成 mention。
- 文件格式不改变这条路径。inbox 副本受 maxStageBytes 限制。
- DSH 的 read 打开 UTF-8 文本。其它格式走会话中的 shell 或其它工具。

配置

可选配置写在 ~/.dsh/profiles/web/cordis.patch.yml。后一层会整段替换 config，改一项时请把要用的键都写上。

- id: dsh-file-ref
config:
inboxDir: .dsh-inbox
maxStageBytes: 20971520

| 配置项 | 默认值 | 说明 |
| inboxDir | .dsh-inbox | 浏览器藏了原路径时，副本落到工作区的相对目录 |
| maxStageBytes | 20971520（20 MiB） | 单份副本大小上限 |

常见问题

这个插件会把文件上传给模型吗？

不会。插件只在草稿文本中插入一条 路径。agent 用会话已有的工具（read、shell 等）打开文件。文件字节不会通过本插件发送到 LLM 上下文。

支持哪些文件格式？

除 PNG、JPEG、WebP、GIF（走内置图片轨）外的所有格式。常见用途包括 PDF、CSV、JSON、YAML、源代码、Markdown 和任何文本文档。

能在 headless 模式下使用吗？

不能。本插件仅面向 web profile，依赖浏览器粘贴/拖放事件和对话栏 UI。

大文件怎么处理？

写入 inbox 的副本受 maxStageBytes（默认 20 MiB）限制。agent 读取文件时还受会话自身工具的限制。

需要哪个版本的 DSH？

在 DeepSeek Harness v0.1.0-rc.1 及更新版本上测试通过。DSH 预览版的插件契约可能变动 — 建议锁定你测试使用的版本。

兼容性

| 依赖 | 版本 |
| DeepSeek Harness | v0.1.0-rc.1+ |
| Node.js | ^22.19.0 或 >=24.0.0 |
| Profile | web |

Aurora Lab

本插件由 Aurora Lab 发布。我们构建 DeepSeek Harness 增强插件。

Aurora Lab 其他插件：

- dsh-access — 远程访问网关，角色令牌 + 单设备绑定
- dsh-msg-revise — agent 停止后编辑并重新发送消息

许可

不是 MIT。全文见 LICENSE（中文）。

允许为个人、非商业目的自由下载和安装。任何修改或二创须事先联系所有者。商业使用须获得所有者书面同意。请通过 auroralab-art 联系。

开发

pnpm install
pnpm test
pnpm run build
dsh plugin --profile web add "$PWD"

add "$PWD" 把当前检出链进 profile，目录必须留着。这是开发方式，不是给其它机器的安装命令。

构建需要 DeepSeek Harness 检出：默认 ../../deepseek-harness，或设置 DSH_CHECKOUT。