dsh-branch-cleaner

dsh plugin --profile web add dsh-branch-cleaner

dsh-branch-cleaner

清理 已经落地到主线 的 git 分支：默认只报告，删前自动备份。

A DeepSeek Harness plugin that finds branches whose work already landed in the mainline — merged, squash-merged, patch-equivalent (rebase/cherry-pick), upstream-gone, or PR-merged — then deletes them safely.


为什么需要它

git branch --merged 只认祖先合并。用 squash merge 或者 rebase 落地的分支，它永远认不出来，

于是本地几十个、远程上百个分支越积越多。这个插件把几种「其实已经落地」的情况都判出来：

落地方式 · --merged 认得出吗 · 插件用的判定

merge / fast-forward · 认 · git merge-base --is-ancestor

squash merge · 不认 · git merge-tree --write-tree：把分支合回主线，主线内容一点不变 → 已落地

rebase / cherry-pick · 不认 · git cherry：没有 + 开头的行 → 补丁全在主线

PR 已合并 · 看落地方式 · gh pr list --head <branch> --state merged（可选）

上游分支已删 · 不认 · %(upstream:track) 里的 [gone]

安装

# 从 GitHub 装（推荐，跟随 main）
dsh plugin --profile web add github:ramwin/dsh-branch-cleaner

# npm（等 package 发布后）
dsh plugin --profile web add dsh-branch-cleaner

# 本地开发
dsh plugin --profile web add /path/to/dsh-branch-cleaner

装完重开 dsh web（或刷新页面），模型就多了 git_clean_branches 工具。

用法

直接在对话里说：

看看这个仓有哪些分支已经合过了，能删的列出来

把已经合并的分支删掉，保留 develop 和 release/*

模型会先 mode=report 列一遍，你确认后才用 mode=delete。也可以明确要求一步到位。

工具参数

参数 · 类型 · 说明

mode · report / delete · 默认 report，只列出不删除；只有 delete 才真删

repo · string · 仓库路径，默认当前会话工作目录，相对路径按它解析

base · string · 对比基线，默认 origin/HEAD → main/master → 当前分支

squash · boolean · 识别 squash 合并

patches · boolean · 识别 rebase / cherry-pick 落地

gone · boolean · 识别上游已删除的分支

pr · boolean · 用 gh 识别已合并的 PR

all · boolean · = squash + patches + gone + prune（不含 remote）

remote · boolean · 连 origin 上的已合并远程分支一起清（要单独加，all 不含它）

prune · boolean · 先 git fetch --prune 刷新 [gone]

age · integer · 只处理 tip 提交早于 N 天的分支

keep · string[] · 额外保护的 glob，如 wip/（默认已保护 main/master/develop/release/ 等）

recurseSubmodules · boolean · 对每个已初始化子模块各跑一遍（只做本地清理，不带 prune/remote）

timeoutMs · integer · 协作式超时，默认 180000

安全性

• 默认只报告：mode=report 一个分支都不动，连 git checkout 都不执行。
• 绝不 rebase、绝不切分支、绝不碰工作区：只跑只读的判定命令 + git branch -d/-D。
• 永不动的分支：基线本身、当前检出的、任何 worktree 里检出的、命中保留规则（main master develop trunk release/ hotfix/ gh-pages backup/ dependabot/）的。
• 删前备份：每个被删分支的 SHA 记到 refs/backup/branch-cleaner/<时间戳>/<分支名>，恢复：

  git for-each-ref refs/backup/branch-cleaner/     # 看备份
  git branch feat/x $(git rev-parse refs/backup/branch-cleaner/20260101-120000/feat/x)

• squash 判定不会误杀：它问的是「把这个分支合回去，主线会不会变」——会变就不删。

输出

branches / remoteBranches 里每行都带 repo 字段（. 表示顶层仓库，其余是相对路径），

deleted / failed 是整棵子模块树的合计。递归时只列可删分支，未合并的会折成一句

「其余 N 个已略过」。

和脚本的关系

插件的 assets/delete_redundant_branch.sh 是

linux-reference 里同一份脚本的副本（唯一事实来源在那边，

判定逻辑、回归测试都在那儿）。插件只负责：把参数翻译成 argv → 在会话工作目录跑脚本 → 解析 JSON → 渲染给模型。

同步：

scripts/sync-from-linux-reference.sh

开发

node --test test/             # 10 个用例：参数翻译 / JSON 解析 / 真实仓库 report 与 delete
node scripts/mount-check.mjs  # 挂进真 ToolRuntime, 跑一次 report + delete

mount-check 依赖上层目录里已安装的 @deepseek-ai/*（也就是本机装了 dsh 才行）。

License

MIT © Xiang Wang