dsh-file-reference 使用指南

本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

提供文件引用发现契约和浏览器安全的 @file 语法，host-backed 界面可通过 ctx.fileReferences.list 获取路径候选，远程调用 fileReferences/list 供浏览器使用，仅返回路径不读取内容，需配合 read 工具才能访问文件实际内容

— 源: plugins.ai_summary

安装与验证

dsh plugin --profile web add npm:@deepseek-ai/dsh-file-reference

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• No file-content reference object — selected files remain ordinary prompt text and require an explicit model tool call before their contents become model-visible.

— 源: plugin_wiki.readme_zh (fallback readme_raw)

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则