【架构优化】从 gitwork.RecordBaseline 中拆出基线候选回退 resolveBaselineSHA 与提交解析 resolveCommitSHA

Aberta
#447 0 comentários 0 reações 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 1 dia

@fx-kurumi já está trabalhando nisso.

Desde 13/11/2026.

  • #448 de @fx-kurumi — aberto

Avaliação

Dificuldade
3/5
Tempo estimado
Meio dia
Facilidade para iniciantes
25/100
Tipo de issue
Refatoração
Clareza
Razoavelmente clara
Status de atividade
Estagnada
Stack de tecnologia
git, go
Domínio
devtools

Direção de pesquisa

The work is in internal/gitwork/patch.go: read RecordBaseline and the inline resolve closure, then check the existing TestRecordBaseline* tests before extracting resolveCommitSHA and resolveBaselineSHA. Pull request #448 is already open against this issue, so coordinate with it before starting. Done means the existing tests pass unchanged and the new baseline_resolve_test.go covers the fallback order.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

现状问题

internal/gitwork/patch.go 中的 RecordBaseline 约 72 行,混合了三件事:

  1. .git / 基线文件的安全检查(Lstat、拒绝符号链接);
  2. 一个内联闭包 resolve(通过 stdin 把 ref 交给 git cat-file --batch-check,解析 commit SHA);
  3. 四级候选回退链 origin/<base> → origin/master → origin/main → HEAD,用一串 if err != nil 逐级尝试,另外还有 []byte/string 来回转换和一处 bytes.TrimSpace(sha) 冗余判断(resolve 成功时 sha 必为合法对象 ID,不可能为空)。

闭包和回退链无法单独测试,也让主函数的“检查 → 解析 → 写文件”流程不够直观。

重构方案

  • 把闭包提为包级函数 resolveCommitSHA(workspace, ref string) (string, error),逻辑与报错文字逐字不变(仍拒绝含 \r/\n 的 ref,ref 仍经 stdin 传给 git)。
  • 新增 resolveBaselineSHA(workspace, baseBranch string) (string, error):按原顺序构造候选列表并依次尝试,全部失败时返回最后一个候选(HEAD)的错误,与原实现一致。
  • RecordBaseline 改为调用 resolveBaselineSHA,外层错误包装 resolve repository baseline: %w 不变。

影响范围

仅 internal/gitwork/patch.go 一个文件;RecordBaseline 签名与行为不变,调用方(internal/runner/daemon.go、internal/engine/repository_workspace.go)无需改动。新增测试文件 internal/gitwork/baseline_resolve_test.go。

验证方式

  • gofmt、go vet ./internal/gitwork/、go build ./...
  • go test ./internal/gitwork/:既有 TestRecordBaseline*(诊断信息、符号链接拒绝、已冻结保留、远程基础分支、分支名不被当作 git 参数)全部通过;新增测试覆盖多行 ref 拒绝、SHA 解析、回退顺序(空/空白/不存在分支 → origin/main)、无远程时回退 HEAD、全部失败时报告最后候选错误。
Linguagem predominante
Go
Estrelas
141
Forks
28
Merge médio
1d 15h
PRs com merge (30d)
113

Preparar o ambiente

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de Tencent/LoopForge

Todas as issues de Tencent/LoopForge

Issues semelhantes

Mais issues de Go

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.