查清仓库与发布状态,避免改错地方

GitHub 总索引

进入一个仓库前,查清这个目录是谁、会推到哪里、默认分支和其他工作树是什么状态,还能按登记找到不在公开Git里的配套说明。它把网络读取失败、真正身份冲突、别人正在施工和普通未提交修改分开,避免因为一条命令失败就判错仓库,或漏掉私有规则后直接发布。公开内容、传输可用和本人授权始终是三件事。

项目状态
45个仓库均有本地副本;身份基线已对齐,私有配套说明可按登记发现
快照边界
索引和入场检查提供事实,不代替发布授权。普通未提交修改不等于有人正在施工,当前分支推送成功也不等于默认分支已交付。
观察时间
复制 AI 续作说明带着这个项目,交给 AI 接着做

写下接下来想做什么。这里会把你的目标、本页事实和来源整理在一起,复制给 Astra 或 Gemini 后,就不用重新介绍项目了。

整理续作说明

只在当前网页整理,不会发起 AI 任务。

用途与结果

最快了解这个项目

为什么需要它

仓库一多,同名目录、旧路径、临时工作树和多个远端很容易串台。只看当前文件夹干不干净,或听一句“已经推了”,可能漏掉把私密材料送进公开仓库、覆盖别人未提交的修改、分支落后、提交根本没进远端默认分支,以及另一个工作树仍握着唯一内容等真实事故。总索引把这些容易混淆的事实拆开核对。

举个实际例子

“这份代码是不是已经发布了?别只看当前目录,确认一下主分支和其他工作树。”它会告诉我提交在哪、是否进入真实远端默认分支、还有谁的未完成修改;网络读不到就保留未知,不把它说成仓库身份冲突。

最后我会得到什么

最后拿到的不是一张好看的项目列表,而是一份能直接行动的证据:正确仓库与远端、当前可见性、默认分支、全部工作树和分支状态、继续/警告/阻断原因、公开发布还缺什么,以及出错后该从哪里补证或恢复。新仓库还会列出落盘位置、创建回读、登记结果与首次默认分支收敛;真正发布后仍要从远端默认分支再次回读才算交付。

正常时

仓库身份、可见性、远端、默认分支、相关工作树和发布候选都已现场核对时,表示没有 Git 入场阻断;是否提交、推送或发布仍由当前任务授权和候选内容审查决定。

发现问题时

发现未提交修改、分支落后或分叉、工作树独有内容、索引漂移或公开风险时,给出警告或阻断及具体处理项,不覆盖并发施工。

入口不可用或证据不足时

GitHub、远端引用或本地仓库证据不可取得时,可以继续不依赖远端的安全只读或本地工作,但身份、同步和发布结论保持 Unknown(证据不足)。

从哪里开始

在已接入 GitHub 总索引的 AI 项目对话中点名仓库和希望确认或交付的 Git 结果;只读查看可直接要求“先检查仓库状态”。

需要准备什么

  • 仓库名称或本地项目
  • 目标分支和公开/私有要求
  • 是只检查、创建、同步还是发布

从开始到拿到结果

  1. 1
    核对本地与远端是否是同一仓库

    系统检查实际项目目录、远端仓库和默认分支;同名目录或旧索引不能单独确定目标。

  2. 2
    检查全部相关状态

    AI 读取项目规则、本地修改、所有工作树、分支和必要时的远端事实。

  3. 3
    处理精确内容

    只改和暂存本次文件;现有新个人仓库流程只创建空的 PRIVATE(私有) 远端,重大动作另核真实目标与所需保护。

  4. 4
    从目标回读

    分别说明本地提交、正常推送、默认分支可达和实际发布状态;哪层缺证据就留下哪层未知。

从这些需求了解功能

从一个实际问题看它怎样处理、交回什么;当前能做到哪一步和仍有哪些限制,也写在对应说明中。

01仓库总账总索引现在还是最新的吗?有变化就正常完整刷新。先只查仓库登记和真实身份是否有差异;确有完整变化才生成整份新索引并回读,来源不完整时只报告缺口。这次发布是真正里程碑,给总账留一条记录。先确认远端确实收到目标提交且内容适合公开,再记录这一件真实交付;普通推送不自动变成里程碑。查看使用步骤与完整说明02项目入场这个目录最后会推到哪里?对照这个目录真正连接的远端仓库和当前分支;名字相似但地址不一致时先停在定位,不往猜出来的地方写。这个公开项目有没有另存的私人说明?先找到适用的规则,别扫我的其他资料。只按当前仓库登记查配套文件和链接,告诉我已映射、未登记、缺少映射或确有冲突;找到路径不等于已读正文,更不授权把私人配套文件提交到公开仓库。查看使用步骤与完整说明03工作树同步这个分支已经推了,算完成吗?除了看它和自己上游是否同步,还检查目标提交能否从远端真实默认分支到达;没进入默认分支就仍是未完成行动项。这个仓库的另一个工作目录还要留吗?先看里面有没有未保存修改、只存在那里的提交或正在使用的任务;任何一项不清楚都保留,不直接删除。查看使用步骤与完整说明04公开发布公开仓库里什么能发?逐项看这次准备发布的内容;普通路径和技术事实按实际用途保留,可复用密码必须拦住。目标能连接也不等于内容适合公开或本轮获准推送。查看使用步骤与完整说明05重大变更保护为这个新个人项目建一个只有我能看的代码仓库。先在正确的本地项目目录留下首个提交,再创建空的私人远端并正常推送;最后核对仓库仍是私有、主分支确实收到,失败时从真实停点继续。把这个仓库改名,其他设置都别动。冻结当前仓库 ID、旧名称、可见性、默认分支和新名称;只执行改名这一项,完成后从新名称回读同一仓库 ID,并确认可见性和默认分支都没变。删除这个仓库。先确认到底删哪一个、是否会失去唯一资料和这次是否获准;需要本人确认时先完成。结果不明先查实际仓库,不重复发可能已完成的删除。查看使用步骤与完整说明06快照与恢复索引刷新中断了怎么恢复?先看当前是否仍是一份完整旧索引;新文件必须全部生成并核对后才采用,半成品绝不和旧版拼在一起。查看使用步骤与完整说明
项目指标与相关入口查看规模、覆盖范围和关联能力

当前项目指标

仓库总账
45
公开 / 私有
24 / 21
本地 / 仅远端
45 / 0
当前差异
0 差异 · 0 问题

它负责

  • 确认每个项目实际对应哪个本地代码目录、哪个远端仓库、公开还是私有以及默认分支。
  • 按需要检查一个仓库的所有工作目录、未提交修改和本地与远端差异。
  • 把“网络能推送”“这些内容适合公开”“本次已获准发布”分开判断。
  • 维护可公开的仓库索引和本机私有导航,更新失败时保留上一份完整版本。
  • 说明专门分支、历史材料和仍有任务使用的工作目录为什么要留、何时可退出。
  • 删分支或清理工作目录前找出只存于那里的内容,不让唯一修改消失。
  • 新个人仓库放个人项目目录,工作项目放工作目录;不同用途有固定本地位置,不把唯一副本放临时盘。
  • 新个人仓库先建立本地首个提交,只创建空的私有远端,再正常推送并从远端默认分支确认结果。

它不负责

  • 具体项目自己决定功能、测试和怎样部署。
  • 检查结果显示“可以继续”,仍不等于获得修改、推送或公开授权。
  • 电脑计划任务、端口和备份恢复由 PCConfig 核对。
  • 真正可复用的秘密不能发到公开仓库;其他路径、名称与技术事实按具体内容判断,不按文件类型整类遮掉。
  • 普通提交和推送不要求每次重建完整索引。
  • 它不会在后台自行监视、刷新、提交、推送或删除工作目录。

产品思想与设计核心

01

先核实真实仓库身份

目录名、标题和旧缓存都不能证明远端是谁;动手前先对上远端、默认分支与 Git 共享目录。

02

看全工作树和分支,别只盯当前窗口

未提交修改、独有提交和仍被别的任务使用的工作树都要保留,不能拿当前目录干净替它们作证。

03

网络传输、公开内容与授权三层分开

网络能推不等于内容适合公开,内容适合公开也不等于当前任务已经拿到授权。

04

远端默认分支回读才算真正交付

功能分支对自己的上游显示为零远远不够;目标提交必须能从远端真实默认分支到达,并再次回读。

05

是否公开要看具体内容

仓库名、路径、版本和故障说明不因看着“私有”就自动消失;真正的个人敏感值逐项判断,可复用的密码和令牌始终不能公开。

06

证据不全时只拦高影响动作

仓库身份、可见性或远端不清时停止发布、删除和迁移,但安全的本地工作与只读诊断仍可继续。

07

仓库真变了才更新总账

仓库身份、公开性或长期保留关系变化时,先生成并核对一整份新索引再采用;只查状态不会顺手改登记,也没有后台自动删仓库。

08

清理前先证明没有唯一内容

分支或工作树只有在内容已整合并证明确实冗余,或已有明确保留用途和退出条件时,才进入退役。

项目怎样演化到现在

从凭目录名认仓库,变成查真实身份

把仓库、远端、公开性和本地位置对应起来;同名目录、多个分支和工作树不再靠记忆判断。

阶段依据
  • 2026-07-04 · 首次形成公开索引与可重建刷新入口。4dadd6e / e8fba18
  • 2026-07-05 · 零写一致性检查区分生成结果和已发布状态。242b06e / e2843d9

发布是否完成,要看目标而不是一句提示

分开网络传输、公开内容与本次授权,核对所有相关工作树和默认分支;索引生成失败保留上一份完整结果。

阶段依据
  • 2026-07-09 · 入场检查开始覆盖相关工作树。08c49ea / 5fa3171 / c7f44ee
  • 2026-07-10 · 入场、同步、发布和里程碑的责任收敛。3e26f26 / 6008fc1
  • 2026-07-25–2026-07-26 · 公开候选检查与有界远端读取,不把瞬时失败猜成身份冲突。a80d483 / d63b772 / 842b564
  • 2026-08-01 · 零写状态与仓库身份判断独立。ef88f77 / 0fe5595
  • 2026-08-16 · 不可变代际和当前/上一版指针使半成品不会替换完整索引。b076b52

范围缩到这次真正要操作的对象

支持准确工作树与分支检查,保留未同步提交和恢复依据;无关状态变化不会制造整仓重复工作。

阶段依据
  • 2026-08-21–2026-08-22 · 支持精确目标工作树和分支。4283c05 / d00220d / b9a8cd6
  • 2026-08-23 · 完整责任源基线与私有本地位置分开。6bfa180
  • 2026-08-25–2026-08-28 · 陈旧导航不替代真实Git身份。8749025 / b454cd9
  • 2026-08-29—08-30 · 公开内容判断消费活动全局分级,不按路径或文件类型自行升级。6afc858–84eeaca
  • 2026-08-30—08-31 · 当时的仓库覆盖快照,只作历史证据,不代表今天的仓库数量。e01433e–806b668
  • 2026-09-01 · 另一份有日期的基线增量;今天的数量由当前来源回读决定。281344b

公开仓库旁的私有说明也能找到

项目入场按登记找到私有配套,不把链接背后的修改漏在收尾之外;读取失败与确实读到错误身份分开,恢复备份分支也不冒充功能分支交付。

阶段依据
  • 2026-09-16–09-19 · 公开仓库旁的私有说明也能找到cfb0a64