DeepSeek Harness Web Client 默认界面功能有限,无法直接在浏览器中执行 Git 操作、运行终端或管理后台任务。navid-kianfar/dsh-advanced-sidebar 通过一个可调整大小的侧边停靠栏和会话菜单,将这些能力补齐。它利用主机进程运行浏览器无法执行的操作,并提供了文件浏览、开发服务器预览等实用功能。
会话菜单¶
在任意会话的头部,点击 ⋯ 按钮。该菜单基于当前会话的工作目录或工作区路径进行操作。
- 面板操作:打开变更、终端、文件、预览或后台任务面板。再次点击已打开的条目可关闭停靠栏。
- Open in:在新窗口中打开 Web Client,或通过配置的编辑器打开当前会话,以及通过系统文件管理器(如 Finder、Explorer)打开文件。
- 会话管理:归档会话(保留日志)或删除会话(需确认)。
- 下载日志:该插件将原 harness 的「下载会话日志」按钮移至了独立菜单中。
停靠栏¶
面板在应用框架的右侧以列形式展开,左侧为可拖拽边缘。拖拽可调整宽度,最小宽度为 280px,最大为 960px。当窗口宽度过窄导致对话区域小于 400px 时,停靠栏会变为浮动层。
变更¶
该面板展示工作目录的 Git 状态,分为已暂存、未暂存、未跟踪和冲突组。操作包括:
* 暂存/取消暂存:针对单个文件或整组文件。
* 提交:记录暂存内容,支持修改上一次提交。
* 生成消息:利用当前 Composer 的模型为暂存区生成提交信息。
* 推送:推送到上游分支。
注意:当前面板没有「丢弃更改」的功能,如需丢弃,请使用终端面板。
终端¶
支持在会话工作目录中运行交互式 Shell,以选项卡形式管理。
* 保持运行:关闭停靠栏或切换面板时,Shell 进程不会终止。
* 控制:支持中断进程(Ctrl+C)、清屏和重启 Shell。
* 恢复:重新打开标签页会重现主机保留的输出记录。
* 限制:关闭标签页或归档/删除会话会结束 Shell。
文件¶
提供一个文件浏览器,展示当前工作目录。
* 预览:支持文本预览(限制字节数)和二进制文件大小显示。
* 操作:支持用默认应用打开文件,或在文件管理器中显示文件。
预览¶
提供四种模式,每种模式均包含视口选择器(Desktop, Tablet, Mobile, Custom)。
- Server:基于
.claude/launch.json(Claude Code 格式)或previews设置启动开发服务器。支持启动、停止、查看日志。 - File:展示工作区文件,根据类型渲染(HTML/SVG/Markdown/图片等)。文件变更时会自动重载。
- URL:加载任意 HTTP/HTTPS 地址。
localhost等地址通过主机代理加载,享有同源权限。 - Scratchpad:在本地存储中保存的 HTML 代码,可实时渲染。
后台任务¶
管理会话的后台作业列表。
使用示例¶
- 打开面板:在会话头部点击 ⋯,选择「Terminal」或「Changes」以展开停靠栏。
- 配置预览:在
.claude/launch.json中定义runtimeExecutable和port,然后在预览面板的 Server 模式下启动。 - 设备切换:在预览面板中,使用视口选择器切换查看设备尺寸。
注意事项¶
- 依赖缺失:如果主机上未安装 Git 或未找到编辑器命令,对应的菜单项会被禁用。
- Shell 行为:Shell 进程在 Dock 关闭时仍会运行,需手动关闭标签页或归档会话来终止。
- 日志下载:该插件隐藏了原 harness 的日志下载按钮,将其集成至自己的菜单中。