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

Đang mở Phù hợp với người mới
#986 1 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

@jiangjiang248 đang làm issue này rồi.

Từ ngày 17/11/2026.

  • #999 của @jiangjiang248 — đang mở

Đá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
Loại issue
Lỗi
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
go
Lĩnh vực
api, backend

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

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

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. 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.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của Tencent/LoopForge

Tất cả issue của Tencent/LoopForge

Issue tương tự

Thêm issue về Go

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.