前言¶
在 DeepSeek Harness（DSH）里做智能体或插件开发时，会话往往绑定一个工作区目录。原生预览面板适合打开单个文件，但若要在目录之间来回切换、对照多个路径，缺少一个始终贴在预览区旁边的工作区树，操作会偏散：要么依赖外部编辑器，要么在对话里反复让模型列目录。
下面介绍社区客户端插件 File Tree（npm 包 @xiaotuchu/dsh-file-tree），由维护者 xiaotuchu 发布，分类为客户端。它在 DSH 右侧预览区域旁挂载文件树，点击即可在原生预览中打开文件，并支持筛选、刷新与键盘导航。插件当前 npm 版本为 0.1.1，许可 MIT；与 DSH >=0.2.1-rc.2 兼容，支持 web 与 desktop 两种 profile。
这是什么¶
File Tree 的定位是：为 DSH 的原生预览面板添加当前会话工作区的文件树，在右侧浏览目录，点击文件即在旁边的预览中打开。简介原文为：File Tree for DSH — a workspace file tree beside the native preview panel.
源码与说明见 GitHub：xiaotuchu/dsh-file-tree。社区目录页：skillhub.cn/plugins/xiaotuchu/dsh-file-tree（独立社区站点，与 DeepSeek / 幻方无官方从属关系）。
核心功能¶
以下能力均来自项目 README，安装后可在预览面板标题栏用文件夹按钮显示或隐藏文件树。
- 浏览目录：展示当前会话的工作区；点击文件夹展开或折叠子目录。
- 打开文件：点击文件，在相邻的原生预览面板中打开，文件树保持可见。
- 保留浏览位置：同一会话内切换预览标签时，保留目录展开状态与选中文件；切换会话时更新为对应工作区。
- 筛选文件：输入关键词筛选已加载的文件；不递归搜索尚未展开的目录。
- 刷新列表：工作区新增或删除文件后，点击刷新按钮更新目录内容。
- 调整宽度：拖动文件树左侧分隔线调整面板宽度。
- 键盘操作：上下方向键移动选中项，左右方向键展开与折叠，Home / End 跳转。
- 跟随主题：字体、配色与工具提示与 DSH 界面一致。
安装与启用¶
DSH 生态强调「一切皆插件」；安装方式以 README 为准，不要自行拼接未文档化的 github:owner/repo 安装串。
桌面版：打开 「添加插件」，安装源选 npm 官方源，填写包名并安装：
@xiaotuchu/dsh-file-tree
Web 版：在运行 DSH 的机器上执行：
dsh plugin --profile web add "@xiaotuchu/dsh-file-tree"
安装或更新后，桌面版需完全退出并重新打开 DSH；Web 版需重启 DSH 服务并刷新页面。进入会话、打开右侧预览面板后即可使用；标题栏文件夹按钮控制文件树显隐。
卸载
- 桌面版：在插件管理中找到 File Tree 并卸载。
- Web 版：
dsh plugin --profile web remove "@xiaotuchu/dsh-file-tree"
卸载后重启 DSH；Web 版同时刷新页面。
典型用法¶
- 安装并完成上述重启或刷新后，进入带工作区的会话。
- 打开右侧原生预览面板。
- 若未看到文件树，点击预览标题栏的文件夹按钮显示文件树。
- 在树中展开目录，点击目标文件，预览在旁侧打开；需要时在筛选框输入关键词缩小已加载节点列表；文件系统有变更时点刷新。
- 需要更宽树面板时，拖动文件树左侧分隔线；习惯键盘时可使用方向键与 Home / End 在树中移动。
README 未描述额外配置文件或环境变量；客户端通过 dsh.client 注入右侧边栏相关 UI 模块（见 package.json 中的 inject 字段），一般安装即用。
适用场景与注意¶
适合谁：经常在 DSH 会话里对照工作区目录、在预览面板中快速打开多个文件的用户；Web 与桌面 profile 均可使用。
运行与信任：插件以当前 DSH 进程权限运行，能访问会话绑定的工作区路径。安装前建议阅读 源码仓库 与 LICENSE，确认行为与许可符合你的环境要求。构建与发布要求 Node >=20（见 package.json engines）。
筛选限制：筛选仅作用于已加载（已展开路径下可见）的文件，不会对未展开子目录做全盘递归搜索——大仓库下若文件在未展开分支中，需先展开相应目录或配合刷新。
结尾¶
File Tree 把「当前会话工作区」贴到 DSH 原生预览旁边，用点击、筛选、刷新和键盘操作补齐目录浏览，而不替换预览本身。需要安装包名、卸载命令与功能列表时，以 GitHub README 为准；社区索引见 目录页 与 GitHub 仓库。
