Skip to content

[Bug]: 角色可以选择 Pi / OpenCode / Kimi 但不填模型,保存成功,跑起来才报「需要指定模型」 #994

Open

Description

@pemila

现象

新建/编辑角色时把执行器选成 Pi(opencode、kimi 同理),模型下拉停留在「默认模型」(空值),保存成功;等到真正跑 SOP / 对话时才失败:

Pi 需要指定模型

(这条错误当时还带着误导性的 (exit 0),那是另一个问题,已提 PR #993。)

根因

三个 CLI 对"空模型"的处理不一致,而这一段规则只在运行时生效:

  • internal/runtime/agent_cli.go 的 agentCLIModelOptional(kind, baseURL) 只放过
    cursor、zcode、antigravity(仅官方端点)、deepseek(仅官方端点);
  • pi / opencode / kimi 无条件要求模型,ApplyAgentCLICredential 里
    model == "" 直接返回 fmt.Errorf("%s 需要指定模型", …);
  • 但 /api/executor-models 给 pi / opencode 的目录是 {CustomModel: true} ——
    没有内置型号,前端于是把「默认模型」作为一个合法选项,PUT /api/agents
    也没有任何模型校验。

结果:可以保存出一个永远跑不起来的角色,错误要等下一轮 run 才暴露。

建议

二选一(我倾向第一种,早失败早说):

  1. 保存时校验:PUT /api/agents 解析出 builtIn.Kind,对「无条件需要模型」的
    kind(pi、opencode、kimi)在 model 为空时返回 400,并在角色表单里把模型
    标为必填。规则可以直接复用 runtime 里的判断,避免两处漂移。
  2. 运行时兜底:模型为空时取责任人在该 CLI 上保存的模型目录第一条
    (AgentCLICredentials[kind].Models[0].ID)。Cursor 已有类似的目录解析路径,
    其它 CLI 没有;这样至少能把"个人配置里明明有模型"的用户救回来。

顺带:/api/executor-models 对这两个 kind 返回的空型号列表,其实可以顺手把
customModel: true 的 CLI 在 UI 上改成「必须手动输入」,默认项不再是可选值。

复现

  1. Agents → 新建角色 → 执行器选 Pi → 模型保持「默认模型」→ 保存(成功)。
  2. 让该角色跑任意 SOP 节点 / 发起一次执行 → 报 Pi 需要指定模型。

环境:0.3.8 镜像,执行机器 + docker 沙箱,负责人在个人配置里已填好 Pi 的 API Key / Base URL。

Activity

  1. cocofhu00 commented on Nov 17, 2026

    @cocofhu00
    Contributor

    感谢反馈!理解你的意思是:新建或编辑角色时把执行器选成 Pi(OpenCode、Kimi 同样),模型保持「默认模型」也能保存成功,真正跑 SOP 或对话时才报「Pi 需要指定模型」。

    已经看到,会按现有 Issue 排期查看。版本、复现步骤和实际报错都很完整,谢谢。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions