文件引用 · File mention
为 DeepSeek Harness 右侧目录树面板文件，以及文件里选中的内容，提供可一键引用到输入框的功能。
在线介绍页 · 安装 · 使用 · 兼容性 · 工作原理
这是什么
一个 DSH Web / Desktop 的界面插件，解决两件小事：
| 场景 | 操作 | 结果 |
|---|---|---|
| 想让模型看某个文件 | 右侧文件树里右键文件 → 添加到输入框 | 输入框插入原子引用 chip，点击可直接预览 |
| 想让模型看文件里的某段内容 | 文件预览里选中内容 → 点浮动的 引用到输入框 | 输入框插入一张引用卡片 |
引用走的是和 @ 文件选择器同一套语法：路径相对工作区根目录，含空格时写成 @"my file.md"。
> [!NOTE]
> 插入的是输入框的原子节点，不是逐字文本：光标移到 chip / 卡片旁边，退格一次就整块删除。
安装
前提：运行的是 DSH 的 Web / Desktop 界面（这是 Client 插件），profile 可写；Desktop 自带 pnpm。
界面安装（推荐）
- 把本仓库克隆或下载到本机（安装后不要移动/删除该目录，profile 里是指向它的
link:引用） - 左侧栏 → 插件（Plugins） → 添加插件
- 填仓库地址或本地绝对路径：
https://github.com/Tinxyoo/dsh-file-mention
或
/Users/you/Downloads/file-mention
- 安装 → 完成后点 Enable now（若提示需要重启，重启 DSH）
让 agent 安装
把目录放好后，对 agent 说「安装 <绝对路径> 这个插件」，它会调用 plugin_manager install_bundle。
使用
引用文件
- 打开右侧文件树（
files页，或文件预览旁的文件树） - 右键任意文件 → 添加到输入框
- 输入框出现一个文件 chip；点击可打开预览，退格一次整块删除
引用内容
- 在右侧文件预览（Markdown / 代码 / 纯文本）里选中一段内容
- 选区上方出现 引用到输入框，点击
- 输入框插入一张引用卡片，可以紧接着写你的问题
> [!TIP]
> 引用卡片本身就是一块内容；从末尾退格时，第一次会先删掉自动补的分隔空格，第二次整张卡片消失。
兼容性
| 项 | 说明 |
|---|---|
| DSH 版本 | 面向 0.2.2-rc.1 一代的 Web 组合开发 |
| 平台 | Web / Desktop（Client 插件，纯 CLI 会话看不到效果） |
| 内容引用范围 | Markdown、代码、纯文本预览；PDF / Office 文本层暂未接入 |
| 构建 | 无，client.js 直接作为浏览器端模块加载 |
| 依赖 | 无第三方运行时依赖 |
插件依赖以下宿主接缝；宿主升级后若这些接缝变化，可能需要小改 client.js：
slash/input-insert-reference：输入框原子引用 chip 的插入通道sidebar.right.tab.document.actions槽位：预览页上的选区监听挂载点shell.overlay槽位：浮动引用按钮- 预览内容区域标记
[data-textpreview-content]
工作原理
| 能力 | 实现 |
|---|---|
| 右键菜单 | ctx.contextMenus.register({ target: 'file' })，动作执行时向会话作用域派发 slash/input-insert-reference |
| 原子引用 | ReferenceChipNode（source: reference、appearance: file、clipboardText: @path），与 @ 选择器一致 |
| 选区监听 | 在预览工具栏挂一个只监听、不渲染的组件，限定在 [data-textpreview-content] 内 |
| 浮动按钮 | 注册到 shell.overlay，位置跟随选区，点击调用 inputActions.insertQuote() |
| 整块删除 | 引用 chip 与引用卡片都是输入框的原子节点，退格在边缘一次删除 |
项目结构
.
├── client.js # 全部界面行为：右键菜单、选区监听、浮动按钮、chip / 引用卡片插入
├── index.js # Host 半侧（空实现）
├── cordis.patch.yml # 向 profile 插入一行插件
├── package.json # bundle 清单：dsh.bundle.patch、dsh.client
├── icon.svg # 插件图标
├── locale/
│ ├── en.json # 插件管理页标题 / 描述
│ └── zh.json
├── docs/
│ └── index.html # GitHub Pages 介绍页
└── README.md
开发
没有构建步骤，改完 client.js 后：
- 若客户端 HMR 已开启，插件会自动重载
- 否则刷新页面；仍不生效时重启 DSH
调试时可以配合 cordis_inspect_query 查看槽位注册是否生效：
Slots.listSubTree → sidebar.right.tab.document.actions / shell.overlay
卸载
插件 页里关闭该 bundle，或移除它。关闭后插件对该 profile 下所有会话立即失效。
许可证
MIT © Tinxyoo
开放插件市场徽章
已知限制
- 内容引用只覆盖文本类预览；PDF / Office 需要另一套文本层选择机制
- 选区浮层依赖预览内容区域的 DOM 标记，宿主改版可能失效
- 本地目录安装是链接引用：源目录被删或移动，插件会失效
作者 Tinxyoo · Dremo@qq.com · 为 DeepSeek Harness 的 Web 界面而做
