dsh-file-selector：给 DSH 文件浏览与预览加一层「选择」

前言¶

DeepSeek Harness（DSH）自带了文件浏览器和文档预览，但缺少一个「把选中的东西拿去写草稿」的能力：你只能手动复制路径或行号，再粘贴到对话里。dsh-file-selector 插件补上了这一半：在文件树行、预览选区或标签页上右键，就能把路径或行范围追加进输入框草稿。

插件定位¶

• 名称：dsh-file-selector
• 维护者：chiqianyushao
• 版本：0.2.1
• 分类：客户端
• 定位：为 DSH 自带的文件树与文档预览添加右键选区功能，把路径或行范围追加到草稿，不发送、不读文件内容。

核心功能¶

1. 文件树右键
   - 在右侧栏文件树的某一行上右键
   - 菜单提供「添加到对话」和「复制路径」两项
   - 添加到对话会将该文件的相对路径追加到草稿，一行一条

2. 预览选区右键
   - 在文档预览里划选一段文字后右键
   - 菜单提供「添加到对话（第 N-M 行）」和「复制路径」
   - 追加的是行范围，如 src/client/index.ts:5-7

3. 标签页右键
   - 在预览标签页本身右键（dockkit 的标签菜单）
   - 末尾新增一行「添加到对话（第 N-M 行）」
   - 行号来自最后一次落在该预览里的选区

4. 草稿行为
   - 只追加路径或行范围文本，不搬运文件内容
   - 路径尽量缩成相对工作区的写法
   - 二进制、超大文件、图片等都能引用
   - 写入后回读确认，不匹配会在屏幕上提示

安装与启用¶

CLI 安装¶

dsh plugin add chiqianyushao/dsh-file-selector

使用 Release tarball 安装¶

dsh plugin add https://github.com/chiqianyushao/dsh-file-selector/releases/latest/download/dsh-file-selector.tgz

DSH Desktop 安装¶

Desktop 的应用市场只能装已发布的包，本地/未发布的包需走终端 CLI，且必须把 DSH_HOME 指向 Desktop 的 harness：

$env:DSH_HOME = "$env:APPDATA\dsh-desktop\harness"
dsh plugin --profile web add link:E:\dsh-plugin

安装完成后，profile 的 dependencies 里会出现 dsh-file-selector: link:E:/dsh-plugin，dsh.profile.bundles 里会出现对应的 bundle 条目。

验证安装¶

dsh plugin list

应能在列表中看到 dsh-file-selector 及其版本号 0.2.1。

典型用法¶

1. 打开 DSH，在右侧栏文件树中定位到某个文件
2. 右键该文件行，选择「添加到对话」
3. 草稿中会追加该文件的相对路径，如 src/main.ts
4. 在文档预览里划选若干行，右键选区
5. 选择「添加到对话（第 5-7 行）」
6. 草稿中追加行范围，如 README.md:12

适用场景与注意¶

• 适合需要频繁引用文件路径或代码片段的场景，如代码审查、文档编写、调试记录
• 插件以当前 DSH 进程的权限运行，安装前应检查源码与许可证（MIT）
• 插件不发送任何请求，不会自动提交对话

生态背景¶

DSH 的插件化设计允许用户按需扩展能力。本插件遵循 DSH 的客户端 bundle 模式，无运行时依赖，仅依赖 React 与官方 cordis 接口。

参考资料¶

• 插件目录页：https://www.skillhub.cn/plugins/chiqianyushao/dsh-file-selector
• GitHub：https://github.com/chiqianyushao/dsh-file-selector