dsh-file-mentions 怎么安装？

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

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

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

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

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

dsh-file-mentions 还在维护吗？

GitHub 15 星。最近一次上游提交在 2026/10/17。

文件提及 a903067276-rgb/dsh-file-mentions

DeepSeek Harness

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

在 GitHub 查看 ↗

DSH 回复里的文件路径可点击：Codex 风格行内打开、📂 在文件管理器中显示、提及文件以 chip 列表呈现。DSH web 插件（零依赖）。

44.3/100

综合分

GitHub 星标

—

npm 周下载

—/5

用户评分

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

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

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

dsh plugin --profile web add a903067276-rgb/dsh-file-mentions

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

状态速览

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

信任档位：已验证

是什么

dsh 原生插件 · market

装得上吗

本站已真实安装成功

非静态推断

L4 · 真实安装等级说明 →

安全吗

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

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

还在维护吗

活跃：最近一次提交在 17 天前

档位由哪些信号合成

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

验证判据与等级说明 →

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

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

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

展开查看检查明细 ↓

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

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

✓Node 引擎要求 >=22.19 · 基线 Node 22.19 满足

✓dsh CLI 依赖要求 ^0.1.7-rc.1 || ^0.2.0-rc.1 · 最新 0.2.1-rc.5 兼容

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

验证方式：npm registry 存在性 + package.json 静态校验 · 最后检查 2026/11/2 17:41:05

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

v2.7.0

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

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

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

可执行外部命令读写/删除本地文件发起外部网络请求

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

读取本地文件
lib/index.js:136
if (isProbeable(abs, cwd, roots) && existsSync(abs)) {
读取本地文件
lib/index.js:187
const isDir = statSync(abs).isDirectory()
读取本地文件
lib/index.js:295
return existsSync(abs) ? abs : null
读取本地文件
lib/index.js:305
return existsSync(abs) ? abs : null
读取本地文件
lib/index.js:350
if (existsSync(join(root, marker))) {
执行外部命令来自配置/变量
lib/index.js:426
execFile(command, cleanArgs, { timeout: 10000 }, (error) => {
发起网络请求
lib/client.js:41
fetch("/api/file-mentions/config", { method: "GET", cache: "no-store" })
发起网络请求
lib/client.js:56
fetch("/api/file-mentions/config", {
发起网络请求
lib/client.js:209
const res = await fetch("/api/file-mentions/open", {
发起网络请求
lib/client.js:410
fetch("/api/file-mentions/check", {
发起网络请求
lib/client.js:705
fetch("/api/file-mentions/check", {

扫描于 2026/11/3（0 天前） · 范围入口闭包 + 发布文件清单 · 来源 GitHub 仓库

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

依赖的 DSH / Cordis 模块

@deepseek-ai/dsh@deepseek-ai/cordis@deepseek-ai/schemastery

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

用户评分

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

广告精选好物

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

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

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

去淘宝看看→

广告MCP 兼容手册

装完插件，给 AI 接上 MCP

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

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

查 MCP 兼容性→

界面预览

2 张 · 点击查看大图

功能亮点

文件路径可点击
行内打开文件
文件管理器显示

README

由 DeepSeek 最新模型翻译生成

dsh-file-mentions 📎 Awesome DSH Plugin 回复里提到的文件/路径，点一下就打开 —— DeepSeek Harness（DSH）web 插件，Codex 式体验。非官方项目：社区成员独立开发维护，非 DeepSeek 官方产品。截图 dsh-file-mentions 效果回复正文里反引号包着的路径（~/...、绝对路径、相对路径、中文路径）直接点击就能打开；每个可点路径后面自动带一个文件夹图标小按钮，进文件管理器定位；回复尾部还有"📎 提到的文件" 小圆钮兜底。URL 链接由官方渲染器自动可点，无需本插件处理。外置盘白名单设置外置盘白名单（设置 → 插件 → 文件提及）：本机目录（家目录内，如 ~/Downloads、~/Desktop）默认可显示并点击打开，无需配置；此处只登记外置盘/网络盘根目录（如 /Volumes/盘名），每行一个，登记后该盘内文件即可显示并点击打开。系统盘特征目录（/System、/etc）会被自动拒绝。

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

dsh-file-mentions 📎

Awesome DSH Plugin

回复里提到的文件/路径，点一下就打开 —— DeepSeek Harness（DSH）web 插件，Codex 式体验。

非官方项目：社区成员独立开发维护，非 DeepSeek 官方产品。

截图

dsh-file-mentions 效果

回复正文里反引号包着的路径（~/...、绝对路径、相对路径、中文路径）直接点击就能打开；每个可点路径后面自动带一个文件夹图标小按钮，进文件管理器定位；回复尾部还有"📎 提到的文件" 小圆钮兜底。URL 链接由官方渲染器自动可点，无需本插件处理。

外置盘白名单设置

外置盘白名单（设置 → 插件 → 文件提及）：本机目录（家目录内，如 ~/Downloads、~/Desktop）默认可显示并点击打开，无需配置；此处只登记外置盘/网络盘根目录（如 /Volumes/盘名），每行一个，登记后该盘内文件即可显示并点击打开。系统盘特征目录（/System、/etc）会被自动拒绝。

功能

| 位置 | 操作 | 效果 |
| 正文路径文字 | 点击 | 文件用系统默认应用打开 / 目录打开窗口 |
| 正文路径后的文件夹图标 | 点击 | 文件管理器定位选中 |
| 回复尾部"📎 提到的文件" | 点文件名 | DSH 内预览文件内容 |
| 回复尾部文件夹图标 | 点击 | 文件管理器定位选中 |
| 正文 URL | 点击 | 浏览器打开（官方 autolink） |

支持 ~/ 展开、相对路径（按会话目录解析）、macOS/Linux/Windows 三种绝对路径形态；不存在的路径点击后静默无反应（不报错、不弹窗）。

与官方能力的分工（2026-10-01 起）

DSH 0.2 官方已经自带这些"打开文件"的路子，本插件只补官方不做的那部分，不重复造：

| 场景 | 谁负责 |
| 输入框里 @ 补全文件/文件夹/会话 | 官方（dsh-file-reference + ui-reference） |
| 正文里的 Markdown 文件链接（x、带 #L24） | 官方（点开右侧栏预览）——本插件跳过 内的内容，不重复装饰 |
| 会话头"Open In…"打开工作区目录、侧栏预览里"默认应用打开/显示位置" | 官方（dsh-host-open-in-app） |
| 正文里反引号包着的裸路径（ ~/x/y.md ，官方不认） | 本插件：点击用系统默认应用打开 |
| 裸路径旁的文件夹图标（文件管理器定位）、回复尾部"📎 提到的文件" | 本插件（官方无对应物） |

安装

本仓库是官方 bundle 插件格式（根 package.json 的 dsh.bundle + dsh.client），经官方 profile 管理一行安装：

DSH 0.1.7 及以后：
dsh plugin --profile web add "github:a903067276-rgb/dsh-file-mentions#main"
DSH 0.1.5 及更早（本版需要 0.1.7+）：
dsh plugin --profile web add "github:a903067276-rgb/dsh-file-mentions#v1.0.14"

装完重启 dsh web（bundle 层在启动时合成，热更新无效）。需要 pnpm （dsh plugin 是 pnpm 转发器）。

手动挂载兜底：见 docs/install.md。

用法

agent 回复里用反引号包路径（如 ~/docs/计划.md ）即可触发正文点击。
尾部列表自动出现，无需配置。

会话目录之外的路径（外置盘等）

本机目录无需配置：家目录（~/Downloads、~/Desktop 等）内的路径默认可显示、可点击打开。外置盘/网络盘（如 /Volumes/U盘名）需要登记根目录： 外置盘白名单：设置 → 插件 → 文件提及（每行一个目录）。保存立即生效，无需重启。

系统盘保护：白名单根下若检测到系统特征目录（/System、/etc，Windows 为 \Windows），该根会被自动拒绝——误把整块系统盘加进白名单也开不了门。

平台支持

| 平台 | 状态 |
| macOS | ✅ 全功能实测（含中文路径） |
| Linux | ⚠️ 未实测；架构上预期可用（命令分流与路径解析已实现） |
| Windows | ⚠️ 未实测；架构上预期可用（命令分流与路径解析已实现） |

环境要求

- DSH web（≥ 0.1.0-rc.6）（npx @deepseek-ai/dsh web 启动）
- 版本兼容（尽力兼容——设置卡片用双字段 key+id 注册，同满足 rc.6（id 契约）与 rc.7+（key 契约）；已在本地实测 rc.6/rc.8/0.1.1-rc.2/0.1.2-alpha.2/0.1.5-rc.1（路径可点击 + "提到的文件"面板），不保证每个 DSH 版本）：
- DSH 0.1.0-rc.6 及以上（含 0.1.1-rc.1/rc.2 与 0.1.2）：装 main（默认）。
- DSH 0.1.5-rc.1：加载实测通过（插件已进客户端 bundle、/api/file-mentions/check 存活）；UI 交互未逐项肉眼复测。⚠️ 0.1.5 起官方自带窄口径的「收尾回复内联代码路径可点」（仅限本回合 write/edit/present 过的文件，见官方 dsh-client-ui-deliverables），与本插件部分重叠；纯文本/裸路径、跨回合与历史消息仍只有本插件处理。
- 保守回退（升级前的最后版本）：DSH 0.1.0-rc.7/rc.8 → v1.0.8（dsh plugin add github:a903067276-rgb/dsh-file-mentions#v1.0.8）；DSH 0.1.0-rc.6 → 冻结 rc6-compat（不再维护）。
- 纯 Node 标准库实现；peer 依赖（@deepseek-ai/dsh-settings、@deepseek-ai/schemastery）由宿主提供
- 打开文件调用系统默认应用 / 文件管理器（按平台分流命令）
- ✅ DSH 0.1.7 及以后——装本版（v1.2.2）：它声明了 peerDependencies: {"@deepseek-ai/dsh": "^0.1.7-rc.1 || ^0.2.0-rc.1"}，宿主不匹配会明确拒绝加载并说明原因，不再静默出错。配置迁到 0.1.7 的插件 Config（.volatile() 字段可即时生效），改完不用重启。
- ✅ DSH 0.2.0-rc.1——已验证兼容：peer 范围同时覆盖两条线（^0.1.7-rc.1 || ^0.2.0-rc.1），dsh.compatibility.dshReleases 矩阵新增 "0.2.0-rc.1": "compatible"——已在 0.2.0-rc.1 真机 + 影子实例验证。0.2 起宿主对 profile bundle 做 peer 门禁，范围不覆盖当前运行时会整个跳过加载，靠这个范围插件才会被加载。
- ⚠️ DSH 0.1.5 及更早——请装上一版 tag v1.0.14：那条线保持原行为，不含任何 0.1.7 专用 API。
- ⛔ 旧版本插件（≤ v1.0.14）在 0.1.7 上不受支持——外置盘白名单会静默变空（settings.get 已删除）。插件要跟宿主一起升。
- 维护策略：本插件将持续跟随 DSH 最新版本演进；对旧版 DSH 的兼容仅是尽力而为、不保证长期有效。

工作原理

- Host（lib/index.js）：三条路由 —— /api/file-mentions/check（存在性验证）、 /api/file-mentions/open（系统打开，mode: open/reveal，平台命令分流）、 /api/file-mentions/config（白名单读写，设置页用）。三条路由均有同源校验防 CSRF。
探测面：绝对/~/ 路径只在本会话 cwd 内或用户声明的白名单根内探测（白名单走官方 settings 服务，保存即生效、无需重启）；白名单根带系统盘保护与 symlink 防逃逸。
全部 Node 标准库，execFile 不经 shell 防注入。
- Client（lib/client.js）：conversationEvents 收集器提取每轮回复里的路径 → 发布到回合数据 → 尾部列表渲染前先过滤不存在的路径；正文可点用 document 点击委托 （官方渲染入口被官方"产物"插件占用，无法扩展，这是唯一可行路径）；正文文件夹图标按钮用 MutationObserver 动态补插，React 重渲染自动恢复；设置卡片（侧边栏分区 + 插件页）编辑白名单。扫描/装饰为增量式：observer 回调只处理官方消息滚动区
（[data-conversation-scroll]）内新增的节点，每条新文本先做廉价快筛（不含
/ ~ \ 直接跳过，零正则零请求），存在性预检只查当前会话——没提到路径的对话完全不扫描；侧栏/hover 卡/菜单/设置页一概不碰（v1.0.13）。

详见 docs/architecture.md。

注意事项

- bundle 安装与手动挂载二选一，不要同时用。
- 手动挂载时 ~/.dsh/cordis.patch.yml 只加单 entry；双 entry 会让插件应用两次、路由重复注册崩溃。

兼容性说明

- 正文可点依赖"反引号包裹的路径"（与 Codex 一致的 agent 输出惯例）；消息正文里的裸路径同样可点（CSS Highlight 装饰，零 DOM 变更；仅消息区——侧栏/hover 卡/菜单/设置页一概不碰，v1.0.13）。
- 官方"产物"列表与本插件互不打架：官方有产出时优先，无产出时本插件显示。
- Windows / Linux 欢迎实测后提交 issue/PR 补充验证。

许可证

MIT