DSH Web GUI 右侧边栏:VS Code 风格文件浏览器加源代码管理(git 状态、暂存/取消暂存/放弃变更、提交、差异、提交图形、抓取/拉取/推送同步、分支与远程管理、Git 初始化、多仓库切换、文件状态着色、文件类型图标),并提供打开会话/文件树/源代码管理里任一文件的编辑器视图(Markdown/HTML/PDF/图片预览、15 种语言语法高亮、逐块差异编辑、Ctrl+S 保存)、文件操作(新建/移动/复制/删除、在文件管理器中显示)、可折叠图标窄条、多标签底部终端(ConPTY),以及由宿主已配置模型基于暂存差异生成提交信息。
安装
# npm 包(预构建)
dsh plugin --profile web add dsh-solution-explorer
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:xiaoksio/dsh-solution-explorer
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
🗂️ Solution Explorer for DSH
DSH Web GUI 右侧边栏的完美平替 —— VS Code 风格文件浏览器、带就地预览的多标签编辑器,以及完整源代码管理。

功能
- 接管官方侧边栏 — 从会话、侧边栏文件列表或源代码管理打开的每个文件都落进本插件的编辑器视图:只要本插件能读,官方预览面板就不会接手。
- 文件浏览器 — 以目录树浏览当前会话工作区,支持展开/收起;文件与文件夹带 VS Code 风格类型图标(TS/JS/Vue/JSON/图片/压缩包/脚本等 30+ 扩展名);文件带 VS Code 风格 git 状态标记(M/A/D/R/?)且名称与标记同步着色(未跟踪绿色、已修改黄色、已排除灰色),被
.gitignore排除的文件/目录灰显,目录有"已修改"指示。 - 源代码管理 — 暂存/未暂存/未跟踪变更清单,支持逐个或全部暂存、取消暂存、放弃变更,带提交信息的提交与分支信息。AI 提交描述:在设置中选择宿主已配置的模型后,点提交框旁的 ✨ 图标,即可基于暂存 diff 生成 Conventional Commits 规范的中文提交信息(可选注入仓库 AGENTS.md 风格)。差异视图:全文左右对照,右侧可逐行编辑(回车插行/合并行、NBSP 占位)、中间 gutter 支持逐块暂存(⤒)与还原(↩)、Ctrl+S 保存。提交图形(Commit Graph):SVG 分支线/合并线历史视图,点击提交在行下方展开变更文件列表(带文件类型图标与状态字母 M/A/D/R),悬浮显示完整提交信息、变更统计与 GitHub 链接;支持 Checkout。仓库同步:抓取/拉取/推送/同步(拉取+推送),显示 ahead/behind 计数,远程写操作均二次确认。分支管理:切换/新建/重命名/删除/合并/发布。远程仓库:添加/删除/修改地址。Git 初始化:普通目录一键初始化。合并冲突:pull/merge 冲突(UU/AA/DD…)自动检测并列出,手动解决。多仓库支持:自动发现工作区下多个 git 仓库,可点击切换,SCM 面板跟随选中仓库。上下分栏:更改区与存储库区可拖拽调整占比,历史列表填满底部。批量操作位于分区头,放弃所有需二次确认。
- 语法高亮 — 编辑器与差异视图均支持 15 种语言(TS/JS/Python/JSON/Markdown/…)的语法着色(GitHub Dark 主题),编辑器输入实时高亮,性能轻量。
- 文件搜索 — 按文件名实时搜索整个工作区。
- 文件编辑器 — 会话视图「编辑器」页签下的多标签编辑器:打开任意文本文件、编辑并保存(按钮或 Ctrl+S);图片以缩放/平移预览打开;
.md/.markdown与.html以渲染预览打开,可在预览/源码间切换;.pdf就地渲染;其余二进制文件会被识别并拒绝打开,避免损坏。 - 折叠窄条(rail) — 整个面板可收起为一条窄图标栏(展开面板、文件浏览器、搜索、源代码管理、终端);源代码管理图标带实时变更计数徽标,点击任一图标即在对应页签重新展开面板,视觉与原生侧边栏一致。
- 多标签终端 — 从折叠窄条上的终端图标展开底部终端面板(DSH 原生 ConPTY,默认 pwsh/cmd),支持多标签页;可拖拽调整高度,关闭标签或断线时自动清理进程。
- 文件操作 — 右键菜单支持新建文件/文件夹、删除(确认对话框)、复制/剪切/粘贴、复制相对/绝对路径;支持树内拖拽移动、从系统拖入文件、多选批量操作。
- 国际化 — 中英双语,跟随浏览器语言。
- 深色主题 — 与 DSH Web UI 主题 token 一致。
截图
| 文件浏览器 | 源代码管理 | 变更对比 |
|---|---|---|
![]() |
![]() |
![]() |
安装
[!WARNING] 这是第三方社区插件。安装后,其代码将以你自己的权限在你的机器上运行。它可以在会话工作区内读取、修改、删除文件,并执行 git 操作(包括"放弃变更""删除"等破坏性操作)。使用前请审阅源代码,并先备份重要内容。插件对你仓库所做的一切,责任由你自行承担。
从 dsh-market 安装(GUI)
在 DSH Web UI 中打开插件市场,搜索"solution-explorer",点击安装。
从 npm 安装
dsh plugin --profile web add dsh-solution-explorer
本地目录安装
dsh plugin --profile web add /path/to/dsh-solution-explorer
安装后刷新 Web UI。会话打开工作区后,资源管理器面板会作为独立右列出现。
兼容性
- DSH 0.1.x / 0.2.x —— peer 声明范围为
>=0.1.0-rc.1 <0.3.0-0(实测自0.1.5-rc.1起,含0.2.0-rc.2)。 - 新 DSH 需要的最低插件版本:
- DSH ≥ 0.1.7:1.0.1 —— 0.1.7 起会话列表快照不再有
current字段(主视图会话改由retainedBy.mainView标记),旧版插件会因此把整个右列隐藏(#2)。 - DSH ≥ 0.2.0:1.0.2 —— 0.2 把官方图标的导出名从
IconXxx16/IconXxx14改成IconXxxRegular/IconXxxMedium,旧版插件引用到undefined,React 抛 #130 后整个面板渲染为空(#3)。
- DSH ≥ 0.1.7:1.0.1 —— 0.1.7 起会话列表快照不再有
- DSH 会在安装/激活前校验 peer 版本范围,因此"插件版本早于所装 DSH"表现为安装被拒,而不是运行时才报错。升级 DSH 后若右侧栏没出现,先在设置页的插件列表里核对本插件的版本。
配置
插件接受 bundle 行(cordis.patch.yml)中的可选 config:
| 字段 | 类型 | 默认值 | 说明 |
|---|---|---|---|
defaultWidth |
number |
280 |
面板宽度(px),限制在 264–560。 |
autoOpen |
boolean |
true |
会话激活时自动打开面板。 |
filterPatterns |
string[] |
[] |
从文件树中隐藏的名称模式。 |
showHidden |
boolean |
false |
在文件树中显示点前缀(隐藏)文件。 |
开发
pnpm install
pnpm build # tsc 产类型 + tsdown 打包(lib/index.js、lib/client.js)
pnpm watch # 改动自动重建
开发约定见 CONTRIBUTING.md。
pnpm install 也会执行 prepare 脚本,因此基于 git 的安装(dsh plugin add github:xiaoksio/dsh-solution-explorer)会在目标机器上自动构建 lib/,无需手动步骤。
工作原理
插件是单个 npm 包,两个半区都声明在 package.json 的 dsh 键下:
- Host 半区(
src/index.ts,导出.→lib/index.js):运行在 dsh 宿主进程中,通过/solution-explorer/*下的 HTTP 路由提供工作区受限的文件系统与 git API(tree、read、write、delete、search、git-repos、git-status、git-diff、git-log、git-stage、git-unstage、git-discard、git-commit、paste、move、upload、create)。所有路由都把路径严格限制在会话工作区根目录内。它还会在系统提示词中宣告自身,让 agent 知道面板能做什么。 - 浏览器半区(
src/client/index.ts,导出./client→lib/client.js):由 Web GUI 的__ModuleLoader__以闭包工厂 bundle 形式加载。它向框架网格追加资源管理器列([data-dsh-frame]),跟随当前会话的cwd,并把文件编辑器挂载到conversation.view槽位。同时向sidebarRightTabs注册认领全部dsh-resource://file/**地址,因此 GUI 中任何位置打开的文件都会交给该编辑器视图,而不是官方预览面板。
许可证
MIT
链接
同类插件
zhu1090093659/dsh-web#packages/dsh-git-graph★ 10562
输入框上方提供 Git 分支选择器,并把分支泳道与提交历史画成图谱,沿着时间线找到任意变更。作者已将其退役并改用官方 workspace-changes 插件;已发布的 npm 包仍可安装,但不再开发。
Akimiya-z/codex-guard#dsh★ 131
在 DeepSeek Harness 内做提交前的 Pull Request 卫生检查:扫描当前改动中的 TODO 残留、硬编码密钥与非规范提交信息。
xbzbing/dsh-git-panel★ 59
DSH Web GUI 里的 IDE 风格 Git 面板:常驻标签页含三栏总览(分支/标签列表、可搜索的提交历史图、含变更文件树与提交信息的提交详情)与变更记录页(统计条、带逐文件暂存/取消/丢弃的未提交列表、含 amend 的提交框);并排差异带懒加载 highlight.js 语法高亮、块间上下文按需展开与词级行内高亮,图片文件以变更前/后双图对照;另在输入框提供 zsh 风格分支标记。所有 git 命令以 argv 数组经宿主 subprocess 执行、cwd 锁定仓库根。
Cerbur/clutch-dsh#clutch-dsh-worktree★ 47
为 DSH Web UI 增加按 Git Worktree 组织 Session 的视角,同时继续由 DSH 管理原始 Project 和 Session 数据。
Lenonss/DSH_VsCodeMode★ 35
为 DeepSeek Harness 提供类 VSCode 编码体验:基于 Monaco 的中央文件编辑器(文件页签、Ctrl+P 快速打开、状态栏),并对 Agent 的 edit/write 结果进行交互式差异审查(逐处采纳/拒绝、回滚、归档),状态跨重启持久化。
DamonKoy/dsh-web-ui#dsh-git-graph★ 34
dsh web GUI 会话头部栏的 Git 分支选择器与提交图。



社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。