前言¶
DeepSeek Harness（DSH）自带了文件浏览器和文档预览，但缺少一个「把选中的东西拿去写草稿」的能力：你只能手动复制路径或行号，再粘贴到对话里。dsh-file-selector 插件补上了这一半：在文件树行、预览选区或标签页上右键，就能把路径或行范围追加进输入框草稿。
插件定位¶
- 名称：dsh-file-selector
- 维护者：chiqianyushao
- 版本：0.2.1
- 分类：客户端
- 定位：为 DSH 自带的文件树与文档预览添加右键选区功能，把路径或行范围追加到草稿，不发送、不读文件内容。
核心功能¶
-
文件树右键
- 在右侧栏文件树的某一行上右键
- 菜单提供「添加到对话」和「复制路径」两项
- 添加到对话会将该文件的相对路径追加到草稿，一行一条 -
预览选区右键
- 在文档预览里划选一段文字后右键
- 菜单提供「添加到对话（第 N-M 行）」和「复制路径」
- 追加的是行范围，如src/client/index.ts:5-7 -
标签页右键
- 在预览标签页本身右键（dockkit 的标签菜单）
- 末尾新增一行「添加到对话（第 N-M 行）」
- 行号来自最后一次落在该预览里的选区 -
草稿行为
- 只追加路径或行范围文本，不搬运文件内容
- 路径尽量缩成相对工作区的写法
- 二进制、超大文件、图片等都能引用
- 写入后回读确认，不匹配会在屏幕上提示
安装与启用¶
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。
典型用法¶
- 打开 DSH，在右侧栏文件树中定位到某个文件
- 右键该文件行，选择「添加到对话」
- 草稿中会追加该文件的相对路径，如
src/main.ts - 在文档预览里划选若干行，右键选区
- 选择「添加到对话（第 5-7 行）」
- 草稿中追加行范围，如
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
