[Bug] AI 对话切换 Claude Code 必定 400「不支持的执行器」:assistantEngineClaude 与 executorModelCatalogs 键名不一致

Ouverte Adaptée aux débutants
#986 1 commentaire 0 réactions 0 personnes assignées Voir sur GitHub

Les mainteneurs répondent en général sous 1 jour

@jiangjiang248 y travaille déjà.

Depuis le 17/11/2026.

  • #999 par @jiangjiang248 — ouverte

Évaluation

Difficulté
2/5
Temps estimé
1-3 heures
Accessibilité débutants
74/100
Type d'issue
Bug
Clarté
Clairement spécifiée
Activité
Active
Stack technique
go
Domaine
api, backend

Piste de recherche

Commencez dans internal/httpapi/assistant_models.go, au niveau du handler GET /api/assistant/models, puis comparez sa recherche dans le catalogue avec le mappage des clés Claude dans internal/httpapi/assistant_engines.go et les clés du catalogue dans internal/httpapi/executor_models.go. Vérifiez les tests du handler pour l’executor claude-code, ou ajoutez une couverture s’il n’en existe pas. Le travail est terminé lorsque la requête des modèles Claude Code renvoie correctement son catalogue de modèles et que les autres ID d’executor continuent de fonctionner.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

摘要

在 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,revision 39f4fe76f9d757fff5fdba21da0e68dab8e68d9f)
  • 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 而不是设计
  1. 同仓库已有针对该不一致的显式映射,说明作者知道两套 id 需要对齐,只是漏在了 models handler:
// assistant_engines.go
func assistantEngineBuiltinModels(engine string) []assistantDiscoveredModel {
    catalogKey := engine
    if engine == assistantEngineClaude {
        catalogKey = "claude"          // ← 这里转了一次
    }
    for _, model := range executorModelCatalogs()[catalogKey].Models {
  1. 执行器资源侧(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 复用。

  1. 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 里已有一份拷贝,再抄一份会继续漂)。

Langage dominant
Go
Étoiles
711
Forks
114
Merge moyen
1 j 10 h
PR mergées (30 j)
116

Préparer son environnement

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de Tencent/LoopForge

Toutes les issues de Tencent/LoopForge

Issues similaires

Plus d'issues Go

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.