前言¶
在 DeepSeek Harness（DSH）里做智能体或项目开发时，右侧栏往往同时承担工作区文件树和预览。默认布局下，点开文件容易占满整块区域，树被挡住，来回切换成本高。若你习惯 VS Code / Codex 那套「树在右、预览在左、单击预览 / 双击固定」的交互，原生侧栏不一定能对上。
dsh-file-pane 是社区维护的客户端插件，把 DSH 右侧栏拆成「左侧预览 + 右侧文件树」，并补上预览标签、右键开终端、Copy to Chat 等能力。下面介绍它是什么、怎么装、怎么用，以及使用时要注意的限制。
这是什么¶
- 名称：dsh-file-pane（npm 包名同插件 id）
- 维护者：sinvacn
- 分类：客户端（通过 Cordis patch 注入
@deepseek-ai/dsh-client-ui-sidebar-right） - 许可证：MIT
- 目录页：https://www.skillhub.cn/plugins/sinvacn/dsh-file-pane
- 源码：https://github.com/sinvacn/dsh-file-pane
一句话定位：在 DSH 右侧栏实现 VS Code / Codex 风格的文件窗格——文件树保持在右侧可见，打开的文件落在树左侧；支持预览 / 固定标签、在树中右键开终端、从预览把选区引用进对话输入框。
README 标明在 DSH 0.2.1-rc.5 上做过测试；插件 package.json 版本为 0.1.0。SkillHub 目录与 GitHub 仓库由社区维护，与 DeepSeek / 幻方无官方从属关系；安装前建议自行查看源码与许可证。
核心功能¶
四格布局：预览与文件树并排¶
原先右侧一栏会被拆成两列：左侧为文件 / 终端预览，右侧仍为 Workspace 文件树。整体从「三栏感」变为更易对照代码与目录的并排布局（仓库 README 提供 docs/layout-4-pane.png 示意）。
默认左右比例约为 70% / 30%（预览在左、树在右）。若 DSH 无法完成 split 或移动标签，会回退到内置行为。
预览标签（VS Code 风格）¶
- 单击文件：打开或替换唯一的预览标签。
- 双击文件或标签：固定（pin） 该标签；预览标签以斜体显示，固定状态按会话保持。
Open Terminal¶
在文件树中 右键 文件（在该文件所在目录打开）、文件夹或空白处，可在对应路径打开终端。终端以文件窗格内的 同级标签 出现，不会盖住文件树。
终端启动后会 cd 到目标目录，因此 cd 会留在 shell 历史与回滚输出中（README limitations 中已说明）。
Copy / Copy to Chat¶
在文件预览中选中文本后右键：
- Copy：保持浏览器原生复制。
- Copy to Chat：向对话 composer 插入
@file #Lx-Ly引用和选中内容的 fenced 代码块，不会自动发送。
示例插入内容形态：
@src/app.ts #L12-L14
```ts
export const b = 2
```
行号来自代码与普通文本预览；Markdown / PDF 预览会插入文件引用与选中文本，但 不带行号。若没有挂载 composer，payload 会 复制到剪贴板。
安装与启用¶
官方安装命令（README 原文）：
dsh plugin --profile desktop add github:sinvacn/dsh-file-pane
也可以在对话里让智能体执行上述命令（需 shell 权限并在提示时批准）。无论哪种方式，插件会加入当前 profile，侧栏行会自动注册。若插件处于关闭状态，在 Settings → Plugins 中启用。
安装后 刷新页面 一次；若侧栏未更新，可重启 desktop 应用。
卸载：在 Settings → Plugins 移除 dsh-file-pane，或执行：
dsh plugin --profile desktop remove dsh-file-pane
然后刷新页面。
典型用法¶
- 安装并启用插件，刷新 DSH 页面。
- 在右侧 Workspace 文件树中 单击 某文件，在左侧预览窗格查看；需要长期保留时 双击 固定标签。
- 在树上 右键 目标目录或文件，选择打开终端，在同一窗格区域以标签形式使用终端。
- 在预览里选中代码，右键 Copy to Chat，到 composer 中核对
@路径 #行号与代码块后再自行发送。
调整默认分栏比例（对新 split 生效；已有 split 保持实际比例，可拖拽分隔条）：
在页面控制台执行：
localStorage.setItem('dsh.file-pane.share', '0.7')
取值会被限制在 0.2–0.8 之间；默认即为 0.7。
适用场景与注意¶
适合谁
- 长期在 DSH desktop profile 里读代码、改文件，希望文件树始终可见的开发者。
- 需要把预览选区以
@file+ 行号形式贴进对话、减少手工敲路径的人。
限制（来自 README）
- 右侧栏总宽度上限不变；已有分栏比例不会因改 localStorage 而全部重算。
- 若你自行把树放在左侧，文件与终端会在 右侧 兄弟窗格打开，而不是对调左右。
- Copy to Chat 只写入 composer，不代发消息。
安全与权限
插件在 当前 DSH 进程与页面上下文 中运行，会参与侧栏 UI 与终端等行为。安装前请阅读 仓库源码 与 MIT 许可证，确认符合你的环境与合规要求。
结尾¶
dsh-file-pane 把 DSH 右侧栏改成更接近 VS Code 的文件 + 树并排体验，并补齐预览标签、目录内开终端和 Copy to Chat，适合在 Harness 里高频对照目录与代码的场景。更多信息见 SkillHub 目录页与 GitHub README：
- https://www.skillhub.cn/plugins/sinvacn/dsh-file-pane
- https://github.com/sinvacn/dsh-file-pane
