前言¶
DeepSeek Harness (DSH) 采用插件化架构，允许用户扩展功能。在开发或调试过程中，频繁切换 Git 分支是常见操作。通常这需要离开 DSH 界面，回到终端执行命令。dsh-git-branch-manage 插件解决了这一割裂问题，它将 Git 状态直接集成到会话界面，并提供菜单化的分支管理入口，减少工具切换的频率。
插件概览¶
这是一个 DeepSeek Harness (DSH) 插件包，由维护者 LongSir0419 开发。它主要实现了一个“Git 分支徽章”，在会话头部和新会话欢迎页显示当前分支名称，并支持通过点击和右键菜单进行分支的切换、创建、拉取、推送和删除操作。
核心功能¶
插件提供了一整套 Git 分支交互能力，具体如下：
- 分支展示
当前 Git 分支会显示在会话头部（Session Header）以及新会话的欢迎页上。 - 左键菜单
点击徽章可打开分支列表菜单。- 菜单支持显示本地分支和远程分支。
- 列表采用 IDEA 风格的目录树结构。
- 本地分支列表仅展示最近 7 天内活跃的分支。
- 右键菜单
在分支徽章上点击右键，可快速执行以下操作：切换分支、拉取、获取和推送。 - 创建分支
在菜单中选择创建分支时，插件会先拉取当前分支，随后创建并切换到新分支。创建过程中会提供前缀建议。 - 删除分支
- 仅支持删除本地分支。
- 使用安全删除模式（
-d），不会强制删除远程分支。 - 系统会拒绝删除当前所在的分支以及远程分支。
- 交互反馈
- 切换分支前会弹出确认对话框。
- 操作执行期间（如拉取、推送）显示点状加载动画。
安装与启用¶
在终端中执行以下命令安装插件：
dsh plugin --profile web add @wanghailong0419/dsh-git-branch-manage
安装完成后，重新打开 DSH Web 客户端，插件会自动生效。
典型用法¶
安装成功后，在 DSH 的会话界面中，你可以在顶部栏看到当前分支的徽章。
* 查看分支：左键点击徽章查看分支列表。
* 切换分支：在列表中点击目标分支。
* 执行操作：右键点击徽章，选择 Pull、Push 或 Switch。
适用场景与注意¶
该插件适合需要在 DSH 界面内直接管理 Git 分支的开发者。使用前请注意：
* 插件通过 DSH 进程权限运行，操作具有终端命令的效力。
* 删除分支功能仅限本地分支，且拒绝删除当前分支，请确认操作目标。
* 使用前建议查阅源码与许可证（MIT）。
总结¶
dsh-git-branch-manage 通过将 Git 分支信息可视化并集成到 DSH 交互流中，简化了分支管理的流程。如果你在 DSH 中频繁处理代码，这个插件可以作为一个轻量级的辅助工具。
