[Bug] AI 对话切换 Claude Code 必定 400「不支持的执行器」:assistantEngineClaude 与 executorModelCatalogs 键名不一致
Maintainer thường phản hồi trong vòng 1 ngày
Đánh giá
- Độ khó
- 2/5
- Thời gian dự kiến
- 1-3 giờ
- Mức phù hợp với người mới
- 74/100
Hướng nghiên cứu
Bắt đầu tại internal/httpapi/assistant_models.go, ở handler GET /api/assistant/models, sau đó so sánh việc tra cứu catalog của handler với ánh xạ khóa Claude trong internal/httpapi/assistant_engines.go và các khóa catalog trong internal/httpapi/executor_models.go. Kiểm tra các bài kiểm thử của handler cho executor claude-code, hoặc bổ sung kiểm thử nếu chưa có. Hoàn thành khi yêu cầu danh sách model của Claude Code trả về thành công cùng catalog model và các ID executor khác vẫn hoạt động.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
摘要
在 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 里已有一份拷贝,再抄一份会继续漂)。
- Ngôn ngữ chính
- Go
- Star
- 711
- Fork
- 114
- Merge trung bình
- 1 ngày 10 giờ
- Pull request đã merge (30 ngày)
- 116
Chuẩn bị môi trường
- Có Dockerfile hoặc tệp Docker Compose
- Có mẫu pull request
- Đọc hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của Tencent/LoopForge
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 69/100
Tencent/LoopForge#969 · 1 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 75/100
Tencent/LoopForge#963 · 1 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 76/100
Tencent/LoopForge#900 · 1 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
-
[Bug]: 官方镜像未安装 wecom-cli,企业微信通知报「通知服务未安装 wecom-cli」Có thể đã có người làm @newexploreor đã nhận 5 ngày trước. Đang mởbug
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 76/100
Tencent/LoopForge#156 · 1 bình luận · 1 người được giao ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 54/100
Tencent/LoopForge#994 · 1 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
Tất cả issue của Tencent/LoopForge
Issue tương tự
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 74/100
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 75/100
trufflesecurity/trufflehog#5573 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Type/Improvement
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 67/100
OpenNSW/nsw-srilanka#1259 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 66/100
katzenpost/katzenpost#1287 ·
Maintainer thường phản hồi trong vòng 2 ngày
-
C-bug O-community X-blathers-untriaged
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 76/100
cockroachdb/cockroach#176245 · 1 bình luận ·