Hacktoberfest 2026:维护者为十月标记出来的 issue,仍然开放、适合新手。 浏览 Hacktoberfest issue

The headless guide teaches a chained do command the default belt refuses

未关闭
#1,447 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
3/5
预计耗时
1-2 天
新手友好度
78/100
Issue 类型
文档
描述清晰度
描述清楚
活跃度
活跃
技术栈
go

调研方向

Start at docs/HEADLESS.md:561 and compare its chained do command with cmd/codeaf/do.go:3430 and runRoadRefusesStore. Run the deterministic unset-belt and node-belt commands in a throwaway repository, then verify the complete documented chain produces persisted state with exit code 0. Done means the guide states which belt each command demonstrates, a docs command check catches the invalid unset-belt combination, and the change entry records the default-belt invalidation.

由索引模型根据 Issue 内容生成。

描述

area:headless bug sev:serious

Found on santos/dev2 at 008363c98 (#1410). It reaches dev when #1410 merges.

What happened

The section for a sequence of tasks that remember one another tells a reader to run codeaf do "$task" --db "$RUN/store/graph.db" --dir "$RUN/repo" …. On the default belt, --db exits 1 with --db names a store only the older engine works in; … Drop --db, or set CODEAF_TASK_BELT=node to run this on the older engine. No change entry's invalidates tells readers that the documented default changed.

Replication

Deterministic (no model). Create a throwaway repository with R=$(mktemp -d) && git -C "$R" init -q; run codeaf do noop --dir "$R" --db "$R/graph.db" --json with CODEAF_TASK_BELT unset. It exits 1 at flag validation. Set CODEAF_TASK_BELT=node and the flag passes validation. Use OPENROUTER_API_KEY=<any non-empty value> only if continuing to a model call.

Where

docs/HEADLESS.md:561 supplies the command; cmd/codeaf/do.go:3430, runRoadRefusesStore, supplies the refusal at 008363c98.

The fix

Make the guide explicitly select the older engine for durable --db chains, or provide an equivalent supported chain for the default belt. State which behavior each command demonstrates.

Acceptance

  • e2e: a reader can copy the guide's complete chain into a fresh repository and receive the documented persisted state, with exit code 0.
  • Unit: a docs command check catches an unset-belt invocation combining do and --db.
  • Update the manual's headless account and add the default-belt change to a change entry's invalidates.
主要语言
Go
星标
115
派生
14
平均合并
9 小时 37 分钟
30 天内合并 PR
755

环境准备

我们还没有检查这个项目的环境配置文件。先看它的 README,通用步骤见我们的新手贡献指南。

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

Agent-Field/CodeAF 的其他 Issue

查看 Agent-Field/CodeAF 的全部 Issue

相似的 Issue

更多 Go Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。