在 DeepSeek Harness Desktop 中，开发者通常需要快速了解当前会话工作区的分支状态。手动执行 git status 或在终端切换分支会打断对话流。dsh-git-branch 插件通过对话栏的胶囊形式，提供了一种直观的分支查看与切换方式。
这是一个面向 DeepSeek Harness Desktop 的对话栏插件。它能在 Composer 左侧显示当前工作区的分支状态，点击后展开本地与远程分支列表，并在确认后进行切换。插件由 Rock-ql 维护，采用 MIT 许可证。
核心功能¶
- 对话栏胶囊：在 Composer 左侧显示当前分支名称、游离 HEAD 状态、工作区是否有未提交改动（dirty 圆点），以及相对上游的领先/落后标记（↑ / ↓）。
- 分支列表交互：点击胶囊展开本地与远程分支列表，支持关键词过滤，支持键盘上下键选择、Enter 确认、Esc 取消。
- 分支切换：支持切换本地分支；对于远程没有本地跟踪的分支，执行
checkout -t创建跟踪分支。 - 新建分支：可以从当前 HEAD 快速新建分支并切换过去。
- Fetch 选项：切换前可确认是否执行 Fetch 操作。
- 错误处理：切换失败（包含未提交改动冲突等）时直接展示 Git 的原始错误信息，不会使用
--force强制覆盖。
安装与启用¶
- 使用官方仓库安装：
dsh plugin --profile desktop add github:Rock-ql/dsh-git-branch
- 安装后重启 DSH Desktop。
- 如需本地开发或调试，可使用本地路径安装：
dsh plugin --profile desktop add /Users/rockcoder/Documents/project/dsh-git-branch
*注：Web profile 只需将 `desktop` 替换为对应的 profile 名称即可。*
典型用法¶
- 打开 DSH Desktop，进入任意 Git 仓库目录。
- 在 Composer 左侧查看分支胶囊，确认当前状态（如 dirty 圆点）。
- 点击胶囊，在弹出的列表中通过键盘导航或搜索过滤查找目标分支。
- 按 Enter 确认切换。
适用场景与注意¶
- 适用场景：需要在对话式界面中快速确认并切换 Git 分支的开发者。
- 注意：
- 非非 git 仓库目录下，插件不会渲染。
- 插件不给模型注册任何 git 工具，不会自动执行 fetch、pull 或 push 操作。
- 插件以当前 DSH 进程的权限运行，安装前建议检查源码与许可证（MIT）。
结语¶
通过在对话栏集成 Git 状态与切换能力，该插件降低了上下文切换的认知负担。更多插件详情与源码，请访问 插件目录 或 GitHub 仓库。
