HeathHe/dsh-worktree-panel

DSH Web GUI 的 Git worktree 管理面板——为侧边栏添加了项目 → worktree → 会话的维度。

Project Overview项目介绍

dsh-worktree-panel is a native plugin built exclusively for the DeepSeek Harness (DSH) Web GUI. It adds a dedicated Git worktree and branch management panel to DSH’s official workspace and session sidebar, while preserving all original workspace interaction functionality. To install the plugin, you can run the official DSH CLI command dsh plugin --profile web add dsh-worktree-panel, then restart your dsh web process to activate the new panel. If you need a specific version, you can append the version tag after the package name, like dsh-worktree-panel@0.1.6.

This plugin is designed for developers who manage multiple Git branches for the same project within DSH. It organizes your projects into a clear hierarchy of project group → main working tree → linked branch worktrees → individual sessions, so you can easily see the clean or modified status of each branch and worktree at a glance. You can perform common management actions directly from the panel, including starting a new session inside a worktree, removing an existing worktree, switching the main working tree branch, and creating a new worktree for an existing branch with one click. It also supports starting conversations directly for non-Git folders, for flexible workflow needs.

The plugin has been tested against DSH Desktop 2.0.3 and DeepSeek Harness 0.1.1-rc.2, and it requires a DSH version between >=0.1.1-rc.2 and <0.2.0 as a peer dependency. By default, it stores all worktrees in the <project>/.dsh/workspaces/ directory, but you can configure a custom global storage directory if you prefer. When you change your storage location, the plugin will automatically detect and migrate existing worktrees, skipping any worktrees that have uncommitted changes or active open sessions to keep your data safe. The entire project is released under the open-source MIT license.

这是一个专为DeepSeek Harness(DSH)Web图形界面开发的原生插件,作用是为DSH添加Git工作树和分支管理面板。它在DSH官方的工作区/会话侧边栏基础上进行扩展,新增了「项目→主工作树/分支工作树→会话」的层级结构,同时完全保留了原有的工作区交互逻辑。用户可以通过DSH官方的插件命令直接安装,安装后重启dsh web即可生效。

该插件面向需要同时管理多个功能分支的Git开发者,支持查看主工作树、当前分支和干净/修改状态,也能显示每个项目分组下关联的分支工作树。用户可以在工作树内部启动会话、移除工作树、切换主工作树分支,还支持一键为已有分支创建工作树,或者创建新分支同时生成对应工作树。它也支持对非Git文件夹直接启动会话,满足不同开发场景需求。

该插件经过测试兼容DSH Desktop 2.0.3和DeepSeek Harness 0.1.1-rc.2版本,对DSH的依赖版本范围是>=0.1.1-rc.2 <0.2.0。它默认将工作树存储在<project>/.dsh/workspaces/路径下,也支持用户配置自定义全局存储目录。本项目采用MIT许可证开源,迁移现有工作树时会跳过有未提交更改或活跃会话的工作树,保证迁移安全。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 8 stars - very few users, little community feedback星标只有 8,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add dsh-worktree-panel

把 HeathHe/dsh-worktree-panel 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-worktree-panel

npm version monthly downloads stars license platform

English | 简体中文

A Git worktree and branch-management panel for the DeepSeek Harness Web GUI. It extends the official workspace/session sidebar with a project → main working tree / branch worktree → session hierarchy while preserving the original workspace interactions.


Usage

Install

dsh plugin --profile web add dsh-worktree-panel

Restart dsh web after installation. The worktree hierarchy will then appear in the workspace sidebar.

Install a specific version:

dsh plugin --profile web add dsh-worktree-panel@0.1.6

Upgrade

dsh plugin --profile web add dsh-worktree-panel@<version>
# Restart dsh web afterwards.

Local development

dsh plugin --profile web add link:/absolute/path/to/dsh-worktree-panel

Features

  • Main working tree + branch worktrees — displays the main working tree, current branch, clean/modified state, and linked branch worktrees inside each project group.
  • Session management — starts sessions inside a worktree, removes worktrees, and switches the main working tree branch.
  • One-click creation — creates a worktree for an existing branch or creates a new branch and its worktree.
  • Session-first non-Git folders — the project-row plus button starts a conversation directly. “Initialize Git and enable worktrees” is available from the project actions menu.
  • Configurable storage — stores worktrees in <project>/.dsh/workspaces/ by default or in a custom global directory.
  • Safe migration — detects and migrates existing worktrees when the storage location changes, while skipping worktrees with uncommitted changes or active sessions.
  • Progressive enhancement — non-Git workspaces retain the default session workflow and only gain an optional Git/worktree initializer.

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-web-search-exa 下一个 Next dsh-spend →