← 返回列表
未验证
在输入框工具行实时显示当前工作区 Git 分支
尚未跑自动兼容性验证，可查看页面内的依赖与入口分析。 · 最近上游提交 2026/8/16 · 已提供中文文档
综合分
27.7
GitHub 分
27.7
用户评分
—
★ Stars
1
周下载量
—
安装插件（需先安装 dsh CLI 引擎：npm install -g @deepseek-ai/dsh）
dsh plugin --profile web add hanyueqiang/dsh-git-branch该插件未发布到 npm，走 GitHub 源安装（pnpm 若拦截 prepare 脚本，按其提示在 pnpm-workspace.yaml 的 allowBuilds 中放行后重跑）
数据截至 2026/9/16（元数据每日更新 · 实装验证按队列轮转，单条结论的验证时间见上方）
依赖的 DSH / Cordis 模块
@deepseek-ai/cordis@deepseek-ai/dsh-commands@deepseek-ai/dsh-api-remotes@deepseek-ai/dsh-client-runtime@deepseek-ai/dsh-client-locale@deepseek-ai/dsh-client-ui-conversation用户评分
还没有人投票，来当第一个
订阅周报，不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
dsh-git-branch 在 DeepSeek Harness（DSH）Web 界面的输入框工具行中，紧跟在「模式」控件（访问模式 / Plan 模式）之后， 展示当前工作区的 git 分支。存在 git 仓库时才展示；切换分支后按事件驱动规则自动刷新。 效果位置 输入框工具行布局为：[+ 命令] [访问模式] [Plan] ← 分支 chip。本插件注册到 conversation.input.left 这个「位于常驻模式 chrome 之后」的插槽，因此分支 chip 恰好落在模式控件右侧。 - 分支：⎇ main - detached HEAD：⎇ detached @ a1b2c3d - 无 git：不渲染 - 点击 chip：立即刷新（title 有提示） 安装 插件是一个 DSH bundle（自带 cordis.patch.yml），因此 dsh plugin add 会同时完成两件事： 安装依赖 + 把它加入 profile 的 bundles 列表，无需手动改任何配置。一条命令 + 重启即可： 从 npm 安装（推荐） dsh plugin --profile web add dsh-git-branch 或本地目录（开发） dsh plugin --profile web add ./dsh-git-branch 然后重启（或重新进入）该 profile，刷新浏览器页面即可： 重启正在运行的 dsh web 后，刷新浏览器页面 原理：本包在 package.json 里声明了 dsh.bundle.patch = ./cordis.patch.yml，其中 - insert 一行 git-branch 插件行；dsh plugin add 检测到 dsh.bundle 后会自动把它加入 dsh.profile.bundles， 下次启动时该 patch 层生效，宿主加载 host 半并自动把 client 半下发到浏览器。 可选配置（host） 如需改命令名，在你的 profile 自己的 cordis.patch.yml 里做一次 id 覆盖（id 与 bundle 插入行一致）： - id: git-branch name: dsh-git-branch config: commandName: git-branch # 可选，默认即 git-branch 未知配置键会在加载时报错。 客户端刷新常量 见 src/client/index.tsx（或 lib/client.js）顶部： - POLL_INTERVAL_MS = 60000：慢速兜底轮询；<= 0 关闭。 工作原理 - host：lib/index.js 注册 /git-branch 命令；handler 从 session.header.cwd 向上查找最近的 .git（支持 worktree / submodule），解析 HEAD，把结果以 JSON 放进命令 text 返回。 - client：lib/client.js 注册 conversation.input.left chip，通过 ctx.remote.commands.execute 拉取分支；并注册 conversation.chat.commandview 的 git-branch 键位为 null，隐藏传输命令在对话流中的行。 刷新时机（详见 DESIGN.md）：挂载 / 会话或工作区切换 → 立即；窗口 focus → 立即； 标签页 visibilitychange→visible → 立即；点击 chip → 立即；60s 轮询 → 兜底。 目录结构 dsh-git-branch/ ├── package.json # dsh.bundle + dsh.client 装配 + peerDependencies ├── cordis.patch.yml # bundle patch：插入 git-branch 插件行 ├── LICENSE ├── src/ │ ├── index.ts # host 半（TS 源） │ └── client/index.tsx # client 半（TS 源） ├── lib/ │ ├── index.js # host 半（预构建） │ ├── index.d.ts │ ├── client.js # client 半（预构建，window.__ModuleLoader__ 格式） │ └── client.d.ts ├── DESIGN.md # git 分支刷新规则设计 ├── README.md # English（默认） └── README.zh.md # 中文（本文件） License MIT
扫码进群