dsh-git-branch：在对话框工具栏只读显示 Git 分支

前言¶

DeepSeek Harness（DSH）采用「一切皆插件」的架构。在智能体开发或交互过程中，开发者常需确认当前处于哪个 Git 分支。dsh-git-branch 插件将这一信息直接注入对话框工具行，避免因切换窗口而中断对话流。

这是什么¶

这是一个 DSH 客户端插件，用于在对话框工具行中只读显示当前项目的 Git 分支。当目录不是 Git 仓库时，该区域不会渲染任何内容，没有占位符或报错。

• 插件名称：hellohupc/dsh-git-branch
• 维护者：helloHupc
• 许可证：MIT

核心功能¶

1. 位置固定：渲染在对话框工具行，紧跟在权限选择框之后。
   • 布局示例：[+ 命令] [权限 ▾] [分支图标 + 分支名]
2. 只读显示：仅展示当前分支信息，不提供任何交互或选择功能。
3. 智能隐藏：当目录不是 Git 仓库、Git 未安装或探测超时（5秒）时，完全隐藏该组件。
4. 分支类型支持：
   • 正常分支：显示分支图标及分支名。
   • 游离 HEAD：显示分支图标及 HEAD 的短哈希值。
   • 未提交仓库：显示默认分支名。
5. 零轮询：不进行后台定时轮询。仅在会话工作目录变化、对话结束、标签页重新可见时触发读取。

安装与启用¶

插件以 DSH bundle 形式提供，安装后自动生效。

前置条件：
* DSH 版本需为 0.2.0-rc.2 或更新。
* Host 进程的 PATH 环境变量中需包含 git 可执行文件。

安装步骤：

1. 打开 DSH 的 Web 界面。
2. 进入 Settings → Plugins。
3. 点击 添加插件。
4. 在目标地址栏中填入：
   • 远程仓库地址：https://github.com/helloHupc/dsh-git-branch
   • 或本地 checkout 目录的路径。
5. 保存设置。DSH 会自动加载 bundle 并注册路由。

典型用法¶

安装完成后，在对话框工具行中即可看到当前项目的 Git 分支信息。该信息由 Host 进程通过路由探测获取，不涉及任何文件写入或凭据操作。

适用场景与注意¶

• 适用场景：需要快速核对当前工作分支的开发者；希望保持对话界面整洁，避免杂乱信息的用户。
• 安全说明：该插件通过本地 HTTP 载体暴露仓库信息。路由访问受 DSH 的 Host 防线限制，仅允许回环地址或受信任的 Host 访问，拒绝跨站请求。
• 依赖说明：插件不依赖复杂的构建步骤或运行时库，仅需系统环境中有 git。

结语¶

dsh-git-branch 提供了一种轻量级、低侵入的方式将版本控制信息集成到 DSH 的对话界面中。它通过 Host 路由探测实现数据获取，既保证了信息的实时性，又避免了轮询带来的资源消耗。

• GitHub 仓库
• 插件目录