
GitHub 总索引 · 功能说明 · 已冻结:10 月 31 日起项目不再维护。这项功能现在:改完的东西传没传到 GitHub,AI 收尾时当场就查得到。下面是冻结前的样子。
防止“当前分支已 push(推送)”掩盖另一个工作树的未提交修改、独有提交或没有进入 main(默认主分支)的 feature(功能分支)历史。
当前情况:已有查清各份工作副本、分支和默认主线差异的功能;发现独有修改时保留它,不自动删除或宣布已经交付。10 月 11 日 16:34 看总索引自己:唯一的 main 工作树没有未提交修改,但有 2 个提交还没进入远端 main,所以当时不算已交付。10 月 22 日 06:48 再只读数:本地相对本机缓存的远端 main 领先 0 个提交;没有拉取远端,所以只说明按缓存没有待推送的提交。
项目事实核对截至 2026-10-11 14:00(北京时间);14:00 后的现场读数单独注明时间;页面不实时探测运行状态。
项目源码:私有仓库,源码未公开;用法与技术说明可在下面阅读。


GitHub 总索引 · 功能说明 · 已冻结:10 月 31 日起项目不再维护。这项功能现在:改完的东西传没传到 GitHub,AI 收尾时当场就查得到。下面是冻结前的样子。
防止“当前分支已 push(推送)”掩盖另一个工作树的未提交修改、独有提交或没有进入 main(默认主分支)的 feature(功能分支)历史。
当前情况:已有查清各份工作副本、分支和默认主线差异的功能;发现独有修改时保留它,不自动删除或宣布已经交付。10 月 11 日 16:34 看总索引自己:唯一的 main 工作树没有未提交修改,但有 2 个提交还没进入远端 main,所以当时不算已交付。10 月 22 日 06:48 再只读数:本地相对本机缓存的远端 main 领先 0 个提交;没有拉取远端,所以只说明按缓存没有待推送的提交。
项目事实核对截至 2026-10-11 14:00(北京时间);14:00 后的现场读数单独注明时间;页面不实时探测运行状态。
项目源码:私有仓库,源码未公开;用法与技术说明可在下面阅读。

数字截至 2026 年 10 月 31 日

用途与实际影响
同一仓库可能在多个文件夹里同时有人工作;只看眼前文件夹干净,会漏掉其他目录没保存的修改和只存在那里的提交。
比如我问“这个功能分支已经推了,算完成吗?”它即使和自己的远端分支完全同步,目标提交也可能还没进入 origin/main。系统会直说“默认分支还缺这些提交”,而不会因为功能分支自己推成功了就冒充交付完成。
得到每个工作目录仍有什么未提交修改、哪些分支已进入远端主分支、哪些目录有唯一内容要保留。清理只是候选,系统不会自动删。

用途与实际影响
同一仓库可能在多个文件夹里同时有人工作;只看眼前文件夹干净,会漏掉其他目录没保存的修改和只存在那里的提交。
比如我问“这个功能分支已经推了,算完成吗?”它即使和自己的远端分支完全同步,目标提交也可能还没进入 origin/main。系统会直说“默认分支还缺这些提交”,而不会因为功能分支自己推成功了就冒充交付完成。
得到每个工作目录仍有什么未提交修改、哪些分支已进入远端主分支、哪些目录有唯一内容要保留。清理只是候选,系统不会自动删。

所有相关目录和远端主分支都查清时,说明哪些工作已合并、哪些仍在使用。
某处还有未保存修改、独有提交或未进入主分支时保留它,不宣布整仓已交付。
目录或远端暂时读不到时不猜同步状态,更不删除可能是唯一副本的文件。

所有相关目录和远端主分支都查清时,说明哪些工作已合并、哪些仍在使用。
某处还有未保存修改、独有提交或未进入主分支时保留它,不宣布整仓已交付。
目录或远端暂时读不到时不猜同步状态,更不删除可能是唯一副本的文件。

在 AI 项目对话中说明哪个分支或工作树想收口,要求检查默认分支是否真正收到修改。
- 仓库和目标提交或分支
- 保留中的其他工作树


在 AI 项目对话中说明哪个分支或工作树想收口,要求检查默认分支是否真正收到修改。
- 仓库和目标提交或分支
- 保留中的其他工作树


git add . 吞入其他任务。
git worktree list --porcelain枚举全部工作树;每个存在路径单独回读 HEAD、branch(分支)、upstream(上游分支)、ahead/behind(领先/落后提交数) 和 NUL-delimited(以空字符分隔) status。

git add . 吞入其他任务。
git worktree list --porcelain枚举全部工作树;每个存在路径单独回读 HEAD、branch(分支)、upstream(上游分支)、ahead/behind(领先/落后提交数) 和 NUL-delimited(以空字符分隔) status。

- dirty summary 分开计 staged、unstaged、untracked 和 conflicted,文件名含中文、空格或换行也不误解析。
- local_root 优先取 git rev-parse --show-toplevel 的真实根目录,精确 TargetWorktree 保持调用目标;从子目录进入不会把子目录误登记为根。失败 errors 保留 category/exit_code,并可附最多3行、512字符的诊断;含疑似凭据或控制字符的正文省略,但不吞掉原错误和阻断。
- fetch_attempts 明示0/1/2次;LiveMetadata(只读远端元数据)保持0次。只对已观察到的退出128与 TLS EOF 做一次同参数重试,不重试 push,不改代理、TLS、认证或凭据配置。
- 默认分支完成证据只接受
refs/;远端 ref 缺失就 unknown(未验证),不回退同名本地 branch(分支)。remotes/ origin/ <default>
- branch(分支) inventory 枚举无 worktree(Git 工作树) 的本地 refs 和 remote-tracking refs;用 ancestry 与
git cherry区分 unmerged、merged_ancestry 和 patch_equivalent。
- artifact governance 只对 exact repo/ref 生效;必要 retention 必须同时匹配 repo、绝对 path 与 HEAD,并带 Owner、用途、exit condition。当前登记 3 条专门治理项、1 个冻结历史仓库例外,必要保留项 0 个(10 月 22 日 06:48 数的登记项;10 月 11 日时必要保留项还是 1 个。只数了登记条目,不代表每项的使用方都已重新验收)。
- frozen_history 保留冻结仓库的非默认 refs 与独有提交,不回灌默认分支,也不把它们当普通清理候选。


- dirty summary 分开计 staged、unstaged、untracked 和 conflicted,文件名含中文、空格或换行也不误解析。
- local_root 优先取 git rev-parse --show-toplevel 的真实根目录,精确 TargetWorktree 保持调用目标;从子目录进入不会把子目录误登记为根。失败 errors 保留 category/exit_code,并可附最多3行、512字符的诊断;含疑似凭据或控制字符的正文省略,但不吞掉原错误和阻断。
- fetch_attempts 明示0/1/2次;LiveMetadata(只读远端元数据)保持0次。只对已观察到的退出128与 TLS EOF 做一次同参数重试,不重试 push,不改代理、TLS、认证或凭据配置。
- 默认分支完成证据只接受
refs/;远端 ref 缺失就 unknown(未验证),不回退同名本地 branch(分支)。remotes/ origin/ <default>
- branch(分支) inventory 枚举无 worktree(Git 工作树) 的本地 refs 和 remote-tracking refs;用 ancestry 与
git cherry区分 unmerged、merged_ancestry 和 patch_equivalent。
- artifact governance 只对 exact repo/ref 生效;必要 retention 必须同时匹配 repo、绝对 path 与 HEAD,并带 Owner、用途、exit condition。当前登记 3 条专门治理项、1 个冻结历史仓库例外,必要保留项 0 个(10 月 22 日 06:48 数的登记项;10 月 11 日时必要保留项还是 1 个。只数了登记条目,不代表每项的使用方都已重新验收)。
- frozen_history 保留冻结仓库的非默认 refs 与独有提交,不回灌默认分支,也不把它们当普通清理候选。

数字截至 2026 年 10 月 31 日




| 名词 | 意思 |
|---|---|
| sync_state(同步状态) | in_sync、ahead、behind、diverged(本地与远端双向分叉)、no_upstream 或 unknown(未验证),只描述 HEAD 与 upstream(上游分支)。 |
| integration_state(整合状态) | default、merged_ancestry、patch_equivalent、unmerged 或 unknown(未验证),描述 HEAD 相对远端默认分支。 |
| patch equivalent(补丁等价) | 提交哈希不同,但同一补丁已经以另一提交进入默认分支。 |
| prunable(可修剪记录) | Git 记录了一个已不存在或失效的 worktree(Git 工作树);它仍是异常证据,不自动视为 clean。 |
| necessary retention(必要保留) | 当前确有消费者的固定工作树例外;条件漂移后立即失效。 |

提交真正进入远端默认分支才叫交付;没查清是否有独有内容,就绝不删工作树。



提交真正进入远端默认分支才叫交付;没查清是否有独有内容,就绝不删工作树。

- retirement candidate 不等于删除授权,也不证明没有运行中消费者
- locked、prunable、dirty、ahead、普通 no-upstream 或证据矛盾不能被 snapshot 规则压掉
- 普通未来 branch(分支) 不因名称模式自动成为专门 Owner 或历史保留
- 未证明前不得 gc、prune 或删除内部 checkpoint(续作检查点) refs(检查点引用)与 unreachable objects(不可达对象)
- 项目业务决定 merge、rebase、PR 或 release 方式;总索引只提供 Git 事实
- 任一可达 worktree(Git 工作树) status 或 refs 检查失败: 该状态为 unknown(未验证),并阻止依赖它的收敛/删除结论。
- 远端默认分支 ref 不存在: 不退回本地 main;标记 default_branch_integration_unknown 并刷新/补证。

- retirement candidate 不等于删除授权,也不证明没有运行中消费者
- locked、prunable、dirty、ahead、普通 no-upstream 或证据矛盾不能被 snapshot 规则压掉
- 普通未来 branch(分支) 不因名称模式自动成为专门 Owner 或历史保留
- 未证明前不得 gc、prune 或删除内部 checkpoint(续作检查点) refs(检查点引用)与 unreachable objects(不可达对象)
- 项目业务决定 merge、rebase、PR 或 release 方式;总索引只提供 Git 事实
- 任一可达 worktree(Git 工作树) status 或 refs 检查失败: 该状态为 unknown(未验证),并阻止依赖它的收敛/删除结论。
- 远端默认分支 ref 不存在: 不退回本地 main;标记 default_branch_integration_unknown 并刷新/补证。

- branch(分支) ahead+behind: push_decision=block、strategy=reconcile_then_recheck。
- 已整合残留仍有 lock、dirty 或必要 retention: 保持 evidence 和警告,不列为自动清理。
- retention path 或 HEAD 改变: exact match 失效,恢复普通 dirty/sync/retirement 判断。

- branch(分支) ahead+behind: push_decision=block、strategy=reconcile_then_recheck。
- 已整合残留仍有 lock、dirty 或必要 retention: 保持 evidence 和警告,不列为自动清理。
- retention path 或 HEAD 改变: exact match 失效,恢复普通 dirty/sync/retirement 判断。

- 全部 worktree(Git 工作树)、默认分支完成与必要保留合同
- worktree(Git 工作树)/status/branch/default integration 实现
- exact governance、frozen history 与 retention schema(数据结构)
- 多 worktree(Git 工作树)、branch(分支) inventory 与 retention fixture
- 2026-08-29 完整 Admission(仓库准入检查) 回归 exit 0,覆盖本模块的 worktree(Git 工作树)、branch(分支)、default-ref、target 和 retention 路径。
- 测试 fixture 真实创建 primary、linked、detached(分离提交状态)、prunable、ahead 与 no-upstream 工作树。
- 回归覆盖 remote-only branch(分支)、已推送但未进默认分支、merged ancestry、patch equivalence 和 retirement candidate。
- registry(登记清单) 测试验证 missing/wrong schema(数据结构)、重复 ref、未知 override 和不完整 retention 全部失败关闭。

- 全部 worktree(Git 工作树)、默认分支完成与必要保留合同
- worktree(Git 工作树)/status/branch/default integration 实现
- exact governance、frozen history 与 retention schema(数据结构)
- 多 worktree(Git 工作树)、branch(分支) inventory 与 retention fixture
- 2026-08-29 完整 Admission(仓库准入检查) 回归 exit 0,覆盖本模块的 worktree(Git 工作树)、branch(分支)、default-ref、target 和 retention 路径。
- 测试 fixture 真实创建 primary、linked、detached(分离提交状态)、prunable、ahead 与 no-upstream 工作树。
- 回归覆盖 remote-only branch(分支)、已推送但未进默认分支、merged ancestry、patch equivalence 和 retirement candidate。
- registry(登记清单) 测试验证 missing/wrong schema(数据结构)、重复 ref、未知 override 和不完整 retention 全部失败关闭。

- 2026-08-29 两个 PUBLIC(公开) 仓库现场均确认 main/default integration=default、0/0,但 dirty 仍单独保留为 warning;这是历史现场。
- 2026-08-31 总索引的 live Admission(仓库准入检查) 回读唯一 main worktree(Git 工作树) 为 clean、0/0、integration_state=default,这是历史。2026-10-11 16:34 只读复查:dirty 0、ahead 2、behind 0、integration_state=unmerged、missing_default_commits=2;远端引用为本机缓存,另用 ls-remote 确认远端 main 未变。本次未重跑多 worktree(Git 工作树) fixture,也没有扫描其他仓库,结论不外推到全部 47 个仓库。
它把 Admission(仓库准入检查) 的 worktrees/branches 证据解释为真实收敛状态;Publication Gate 在此基础上继续审查候选内容和授权。

- 2026-08-29 两个 PUBLIC(公开) 仓库现场均确认 main/default integration=default、0/0,但 dirty 仍单独保留为 warning;这是历史现场。
- 2026-08-31 总索引的 live Admission(仓库准入检查) 回读唯一 main worktree(Git 工作树) 为 clean、0/0、integration_state=default,这是历史。2026-10-11 16:34 只读复查:dirty 0、ahead 2、behind 0、integration_state=unmerged、missing_default_commits=2;远端引用为本机缓存,另用 ls-remote 确认远端 main 未变。本次未重跑多 worktree(Git 工作树) fixture,也没有扫描其他仓库,结论不外推到全部 47 个仓库。
它把 Admission(仓库准入检查) 的 worktrees/branches 证据解释为真实收敛状态;Publication Gate 在此基础上继续审查候选内容和授权。
复制 AI 续作说明
项目:Worktree(工作树)、分支同步与默认分支收敛;仓库:页面未提供仓库地址;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。
把“目标”换成这次要做的事,整段复制给 AI。







