DeepSeek Harness (DSH) 的设计理念强调插件化扩展。原生侧边栏文件树是基础组件，提供了核心的浏览能力，但在引用、元数据展示和交互细节上相对简陋。dsh-at-sider 插件接管了原生的 files 标签页，在不改变快捷键、入口和图标的前提下，补上了六项实用功能，将原生文件树转化为一个具备引用、元数据、搜索和 Git 状态感知的增强版树。
这是什么¶
- 插件名称：dsh-at-sider
- 维护者：aiyacharley
- 许可协议：MIT
- 核心价值：为 DSH web 的原生侧边栏文件树补充六件事：
@ 引用·文件大小·文件修改时间·排序·快速搜索定位·侧边栏底部 git commit 信息。
核心功能¶
-
行内引用按钮
每行紧跟文件名显示@文件按钮（目录显示为@文件夹）。点击可插入引用文本，按住 Alt/⌥ 点击可直接复制引用文本。输入框不可达时自动降级为复制文本。 -
文件元数据列
行尾显示文件大小和修改时间两列。宽度自适应，确保内容不被裁切。修改时间悬停可显示完整本地时间，大小列悬停可显示精确字节数。 -
全工作区快速搜索
页头提供全工作区递归搜索。搜索结果支持@引用和直接跳转，不局限于当前展开的层级。 -
排序功能
支持按名称、修改时间、大小、类型循环排序。排序偏好会通过本地存储记忆。目录始终优先显示。 -
Git 状态栏
侧边栏底部新增 Git 状态栏，显示当前分支、领先/落后情况以及最近提交摘要。点击状态栏可展开最近 20 条提交记录。支持多仓库工作区，状态栏会出现仓库下拉选择器。文件行名后会有状态色点（未跟踪、有未暂存修改、已暂存）。 -
运行时回退原生
无需卸载插件，通过右键「文件」页签菜单即可随时切回原生文件树。 -
快捷定位与引用
在文件预览页签的右键菜单中，提供「在文件树中定位」和「@文件」两个选项。前者会自动展开祖先目录并高亮该行，后者可直接插入当前预览文件的引用。 -
全键盘操作
支持方向键、Home/End、Tab 等全键盘操作，配合@键即可插入引用，符合无障碍语义。
安装与启用¶
安装前需满足以下前置条件：
* 已安装 DeepSeek Harness CLI。
* 环境中安装了 Node.js ≥ 20。
使用官方 CLI 一条命令安装：
dsh plugin --profile web add dsh-at-sider@latest
安装完成后，需要重启 DSH web 才能生效。
典型用法¶
- 打开文件树：按
Mod+P打开右侧栏的「文件」标签页。 - 插入引用：鼠标悬停在任意文件行上，点击出现的
@文件按钮，引用文本会自动插入到当前输入框中。 - 快速搜索：在页头搜索框输入关键词，插件会递归搜索整个工作区。
- Git 查看与切换：在侧边栏底部查看当前仓库状态。若工作区包含多个 Git 仓库，可在状态栏下拉选择器中切换查看目标仓库的提交记录。
- 从预览页签操作：打开一个文件预览页签，右键点击该页签，选择「在文件树中定位」，侧边栏会自动跳转并高亮对应文件。
注意事项¶
- 重启生效：安装或更新后必须重启 DSH web 进程，Host 半的路由注册才会生效。
- 数据缓存：Git 状态缓存时间为 30 秒。展开状态与滚动位置按页签记忆，但层级数据不缓存，刷新页面后会重新读取。
- 原生接管机制：插件加载期间原生树会被遮蔽（而非组合），通过右键菜单可以随时回退到原生模式。
