[Bug] AI 对话切换 Claude Code 必定 400「不支持的执行器」:assistantEngineClaude 与 executorModelCatalogs 键名不一致
Mantenedores costumam responder em até 1 dia
Avaliação
- Dificuldade
- 2/5
- Tempo estimado
- 1-3 horas
- Facilidade para iniciantes
- 74/100
Direção de pesquisa
Comece em internal/httpapi/assistant_models.go, no handler de GET /api/assistant/models, e compare a busca no catálogo com o mapeamento das chaves do Claude em internal/httpapi/assistant_engines.go e as chaves do catálogo em internal/httpapi/executor_models.go. Verifique os testes do handler para o executor claude-code ou adicione cobertura caso não exista. O trabalho estará concluído quando a solicitação dos modelos do Claude Code retornar com sucesso o catálogo de modelos e os outros IDs de executor continuarem funcionando.
Escrita pelo modelo de indexação a partir do texto da issue.
Descrição
摘要
在 AI 对话里把执行器切到 Claude Code,页面提示「不支持的执行器」,模型下拉为空,消息发不出去。CodeBuddy / Codex / DeepSeek Harness 均正常。
对应接口:GET /api/assistant/models?executor=claude-code
环境
- LoopForge v0.3.8(
ghcr.io/tencent/loopforge:0.3.8,revision39f4fe76f9d757fff5fdba21da0e68dab8e68d9f) - Linux aarch64 / Docker Compose 自托管,
AGENTFLOW_LOCAL_SANDBOX=docker
复现
curl -s -o /dev/null -w '%{http_code} %{size_download}\n' \
-b 'agentflow_user=<session>' \
'http://127.0.0.1:8090/api/assistant/models?executor=claude-code'
# 实际:400 33 ← {"error":"不支持的执行器"}
对照其他 id:
?executor=claude → 200 1376
?executor=codex → 200 874
?executor=dsh → 200 293
?executor=claude-code → 400 33 ← 只有这一个挂
服务端日志(59 = 33 字节响应 gzip 后):
[HTTP] GET /api/assistant/models -> 400 (59 bytes, 1ms)
根因
internal/httpapi/assistant_engines.go
assistantEngineClaude = "claude-code" // 引擎 id
internal/httpapi/executor_models.go
return map[string]executorModelCatalog{
"codebuddy": {...}, "codex": {...},
"claude": {...}, // ← 键是 "claude",不是 "claude-code"
...
}
internal/httpapi/assistant_models.go 的早返回分支直接拿引擎 id 查这张表:
id := assistantExecutor(raw)
catalog, ok := executorModelCatalogs()[id]
if !ok {
c.JSON(400, gin.H{"error": "不支持的执行器"})
return
}
...
Family: map[string]string{"codex": "gpt", "claude": "claude"}[id] // 同样取不到
⇒ executorModelCatalogs()["claude-code"] 恒 miss。
为什么是 bug 而不是设计
- 同仓库已有针对该不一致的显式映射,说明作者知道两套 id 需要对齐,只是漏在了 models handler:
// assistant_engines.go
func assistantEngineBuiltinModels(engine string) []assistantDiscoveredModel {
catalogKey := engine
if engine == assistantEngineClaude {
catalogKey = "claude" // ← 这里转了一次
}
for _, model := range executorModelCatalogs()[catalogKey].Models {
- 执行器资源侧(
web/app/agents.js)白名单用的也是claude:
const allowed = new Set(['codebuddy','codex','claude','opencode','cursor','agy','kimi','pi','dsh','zcode']);
即"executor 资源 id = claude"与"对话引擎 id = claude-code"是两个命名空间,却被同一个 map 复用。
assistantCLIEngines()下发的引擎列表里明确是claude-code(实测/api/assistant/models返回engines: ['codebuddy','codex','claude-code',...])。前端据此选中claude-code再回查模型 → 必然 400。
影响面
逐项比对,只有 claude-code 不匹配,其余 9 个(codebuddy / codex / opencode / cursor / agy / kimi / pi / dsh / zcode)正常。
即 v0.3.8 下 Claude Code 完全无法在 AI 对话里使用。同问题在 v0.3.9-rc.1 仍存在(已比对两处源码)。
建议修复(最小改动)
归一化键名,不要动共享 map(其他接口依赖 claude 键):
id := assistantExecutor(raw)
catalogKey := id
if id == assistantEngineClaude {
catalogKey = "claude"
}
catalog, ok := executorModelCatalogs()[catalogKey]
if !ok {
c.JSON(400, gin.H{"error": "不支持的执行器"})
return
}
family := map[string]string{"codex": "gpt", "claude": "claude"}[catalogKey]
更彻底的做法是把这层映射抽成一个函数复用(现在 assistantEngineBuiltinModels 里已有一份拷贝,再抄一份会继续漂)。
- Linguagem predominante
- Go
- Estrelas
- 711
- Forks
- 114
- Merge médio
- 1d 10h
- PRs com merge (30d)
- 116
Preparar o ambiente
- Inclui um Dockerfile ou arquivo Docker Compose
- Tem um modelo de pull request
- Ler o guia de contribuição
Primeiros passos
- Leia a issue inteira e depois o guia de contribuição do projeto.
- Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
- Faça um fork do repositório e trabalhe em uma branch.
- Abra um pull request que referencie o número da issue.
Mais de Tencent/LoopForge
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 69/100
Tencent/LoopForge#969 · 1 comentário ·
Mantenedores costumam responder em até 1 dia
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 75/100
Tencent/LoopForge#963 · 1 comentário ·
Mantenedores costumam responder em até 1 dia
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 76/100
Tencent/LoopForge#900 · 1 comentário ·
Mantenedores costumam responder em até 1 dia
-
[Bug]: 官方镜像未安装 wecom-cli,企业微信通知报「通知服务未安装 wecom-cli」Talvez já em andamento @newexploreor assumiu há 5 dias. Abertabug
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 76/100
Tencent/LoopForge#156 · 1 comentário · 1 responsável ·
Mantenedores costumam responder em até 1 dia
-
Dificuldade 3/5 1-2 dias Facilidade para iniciantes 54/100
Tencent/LoopForge#994 · 1 comentário ·
Mantenedores costumam responder em até 1 dia
Todas as issues de Tencent/LoopForge
Issues semelhantes
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 74/100
Mantenedores costumam responder em até 1 dia
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 75/100
trufflesecurity/trufflehog#5573 ·
Mantenedores costumam responder em até 1 dia
-
Type/Improvement
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 67/100
OpenNSW/nsw-srilanka#1259 ·
Mantenedores costumam responder em até 1 dia
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 66/100
katzenpost/katzenpost#1287 ·
Mantenedores costumam responder em até 2 dias
-
C-bug O-community X-blathers-untriaged
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 76/100
cockroachdb/cockroach#176245 · 1 comentário ·