JiayuuWang/dsh-files-panel

dsh-files-panel

布局概览

为 DeepSeek Harness Web GUI（dsh web）提供的交互式终端、工作区文件浏览器和 tmux 风格分屏窗格。

此插件为 DeepSeek Harness 浏览器界面扩展了三项功能：

| 功能 | 你将获得 |
|---|---|
| 终端 | 位于 Chat/Trajectory 旁边的真正交互式终端标签页。每个窗格独立的 PTY，带 shell 选择器（Windows：pwsh / cmd；Linux/macOS：bash / zsh / sh）。 |
| 文件浏览器 | 工作区文件树，带按类型区分的图标和语法高亮编辑（保存时检测冲突，Vim/Emacs 键位映射，可拖拽调整树/编辑器分栏大小）。 |
| 分屏窗格 | tmux 风格窗格：递归向右/向下拆分、每窗格全屏、可拖拽分隔条、尺寸随窗口变化。拆分 Chat 窗格会在旁边启动一个新会话，并且每个聊天窗格都有自己的输入框，大小随窗格调整。 |

安装

此插件是 deepseek-harness monorepo 内的一组包。它会修改核心包，因此安装方式是将累积补丁应用到干净的检出上，并随应用一起构建——有三种方式，从最简单到最手动：

1. npm（推荐）——无需克隆此仓库（包：@jiayuw/dsh-files-panel）：

npx @jiayuw/dsh-files-panel

npm 包附带补丁和一个安装器 bin：它会验证检出，应用 patch/dsh-files-panel.patch（已应用时跳过），然后运行 pnpm install 和 pnpm run build。（--apply-only 会跳过构建，用于干跑检查。）

2. 安装脚本，从此检出运行：

Windows PowerShell:  .\install.ps1
Linux/macOS/Git Bash: ./install.sh

3. 手动——在基于提交 47f943859b 的 deepseek-harness 检出中：

git apply path/to/dsh-files-panel.patch
pnpm install
pnpm run build
pnpm dsh --profile web   # do NOT use npx @deepseek-ai/dsh web

打开打印出的 URL（默认 http://127.0.0.1:3080）并强制刷新（Ctrl+F5）。

用法

- 打开一个会话 → Terminal 标签页会打开一个实时 shell；工具栏可让你选择 shell 并重启它。
- 会话标题栏中的文件夹图标会打开工作区文件浏览器。
- 每个窗格的细工具栏有 ⫞ 向右拆分、⫟ 向下拆分、⛶ 全屏、✕ 关闭。聚焦一个窗格，然后点击顶部标签页切换其视图（Chat / Trajectory / Terminal）。拆分出的聊天窗格有自己的输入框；关闭一个窗格后，其余窗格会重新排布以填满网格。

完整用法：docs/USAGE.md · docs/USAGE.zh.md（中文）

仓库布局

patch/dsh-files-panel.patch   the single cumulative patch (everything above)
package.json, bin/            npm package (@jiayuw/dsh-files-panel) — the npx installer
install.ps1 / install.sh      一键安装器（应用 + pnpm install + 构建）
src/packages/                 插件源码，镜像 monorepo 的 packages/ 布局
assets/layout.png             上方展示的布局截图

src/packages/ 镜像了 harness monorepo 的路径，因此每个文件的位置都表明了它应归属何处：

- host/web-terminal、host/web-terminal-local — 终端能力接缝 + 本地提供者
- host/workspace-files、host/workspace-files-fs — 工作区文件接缝 + 提供者
- host/apiproxy/src/api/{terminal,files}. + fetch/ — terminal. / files. 通信域
- client/ui-terminal、client/ui-files — 浏览器终端和文件面板视图
- client/ui-conversation — 分屏网格、窗格存储和跨会话窗格
- client/ui-slots、client/web-react、client/runtime — 框架新增内容（SessionBoundary、provideInfoOf）
- client/tsdown.client.ts、bundle/web-app — 构建 + 注册

限制

- 终端输出为轮询方式（约 60 毫秒），而非流式传输；固定尺寸，TERM=dumb（尚不支持颜色 / 全屏程序）。
- 分屏网格会在同一会话的各个窗格之间共享该会话的聊天状态。
- 文件树和终端仅面向人类；其内容不会提供给模型。

许可证

MIT