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]

安装

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

# 或从 GitHub 装（跟随 main，永远最新）
dsh plugin --profile web add github:ramwin/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