前言¶
DeepSeek Harness (DSH) 通过插件机制扩展 Web 界面功能。在智能体开发或调试场景中，如果需要访问当前工作区之外的文件（如桌面、下载目录或其他项目），手动输入路径既繁琐又容易出错。DSH File Picker 插件解决了这一痛点，它通过注入一个便携式 Web GUI bundle，让用户可以直接在浏览器中浏览本地文件系统，并将选中的路径作为上下文提供给当前对话。
核心功能¶
该插件主要提供以下能力：
- 文件与目录搜索：在本地 DSH 主机的任意目录中搜索文件或目录。
- 过滤机制：支持非递归、不区分大小写的名称过滤，仅作用于当前打开的目录，不会遍历子目录。
- 路径选择：允许在单次操作中混合选择文件和目录（最多 32 个路径），点击“Apply”后将替换当前会话的路径选择。
安装与启用¶
安装过程通过 npx 执行，无需编写配置脚本。推荐使用固定版本标签安装：
npx --yes github:shaomingbo/dsh-file-picker#v0.2.3
该命令会自动编辑目标 profile（默认为 web）的 package.json 中的 dependencies.dsh-file-picker 和 dsh.profile.bundles，以原子方式写入清单，并运行 pnpm install --ignore-scripts。安装期间 DSH 不会停止或重启。
如需指定不同 profile 或使用本地代码：
npx --yes github:shaomingbo/dsh-file-picker#v0.2.3 --profile lab
npx --yes github:shaomingbo/dsh-file-picker#v0.2.3 --source link:/path/to/dsh-file-picker
使用方法¶
启用插件后，按以下步骤操作：
- 打开一个正常的 DSH Web 对话。
- 在 composer 工具栏中点击 📁 图标。
- 在弹出的文件浏览器中浏览主机文件系统，或使用搜索字段过滤当前目录。
- 使用复选框选择文件和目录。点击目录名称可进入下一级，点击路径栏的“Select this folder”可直接选中当前目录。
- 点击 Apply，然后发送下一个提示。模型将在对话上下文中收到包含
<selected_paths>的路径信息，并可通过read、glob或grep等命令使用这些路径。
适用场景与注意事项¶
- 适用场景：适合需要在 Web 界面中访问本地任意目录文件的智能体开发场景。
- 安全与隐私：插件仅返回路径和条目类型，绝不读取或上传文件内容，也不递归扫描目录。RPC 连接限制为 localhost，防止远程浏览器访问。
- 限制：仅支持常规文件和目录，设备文件和套接字无法被选中。每次应用新选择会替换旧选择，且选择仅在当前 DSH 进程中有效，重启进程后失效。
短结尾¶
DSH File Picker 为 Web 界面提供了安全的本地文件访问能力。通过标准的 npx 安装流程和直观的文件选择器，它简化了智能体与本地文件系统的交互方式。更多详情与源码，请参考 GitHub 仓库 或 DSH 插件目录。
