ClisbotClisbot
查看 Markdown

元数据生成

Clisbot 会请语言模型替你编写一些简短的文本，省去你自己动手。这与你正在对话的 Agent 无关：它是一次在后台进行的小型单次调用。

Clisbot 会生成以下几类元数据：

  • 工作区标题：工作区的简短任务式标签，显示在侧边栏中。
  • worktree 分支名：新建的 worktree 隔离工作区所用分支的 slug。
  • 提交信息：为你要提交的改动生成简洁的提交信息。
  • PR 标题和正文：创建 PR 时根据 diff 起草。

工作区标题和它的分支名由同一个提示词一起生成，但它们的措辞可以分别配置（见下文）。

如何选择模型

Clisbot 有两种模式。自动 是默认模式，无需任何配置。手动 只使用你选择的模型。

在自动模式下，Clisbot 会构建一个有序的候选列表，逐个尝试，直到生成成功，因此慢或不可用的模型会让位给下一个：

  1. 内置默认值，与你已启用的 Provider 的模型进行匹配：
    1. 一个 haiku 模型
    2. gpt-5.4-mini（低推理）
    3. minimax-m3
    4. nemotron-3-super
  2. 最后的备选：该 Agent 或草稿当前选中的模型。

每个默认值按模型 id 或名称匹配，因此第一个提供匹配模型的已启用 Provider 胜出。没有匹配的默认值会被跳过。去除重复项后，生成过程从上到下依次尝试。默认顺序的意图是：对于这些简短任务，优先使用小、快、便宜的模型，最后才退回到你选中的模型。

在手动模式下，Clisbot 只按你的顺序尝试你配置的模型。它不会加入内置默认值或当前选中的模型，因此你的提示词和 diff 只会发送给你选择的 Provider。如果所有配置的模型都失败，生成就会失败：不会生成工作区标题和分支名，提交和拉取请求会使用占位文本。请选择适合这些任务的模型。

每次失败都会写入 $CLISBOT_HOME/daemon.log（默认是 ~/.clisbot/daemon.log），包含 Provider、模型和错误。如果手动模型没有生成标题、分支名、提交信息或拉取请求文本，请查看这里。

选择模型

打开 设置 → 主机 → 元数据，选择 自动 或 手动。在手动模式下，选择 Clisbot 使用的模型。选择模型会替换 agents.metadataGeneration.providers 中的第一项，并保留列表的其余部分。切换回自动会清空该列表。

配置自定义的回退顺序

如果要在手动模式下使用多个模型，请在 ~/.clisbot/config.json 的 agents.metadataGeneration.providers 中列出它们。Clisbot 按顺序尝试你的条目，不会尝试其他模型。空列表表示自动。

{
  "agents": {
    "metadataGeneration": {
      "providers": [
        { "provider": "claude", "model": "claude-haiku-4-5-20251001", "thinkingOptionId": "low" },
        { "provider": "opencode" }
      ]
    }
  }
}

每个条目接受：

  • provider（必填）：Provider id。内置 id 为 claude、codex、copilot、opencode 和 pi；自定义 Provider 使用你为它指定的 id。
  • model（可选）：特定的模型 id。省略时使用该 Provider 的默认模型。
  • thinkingOptionId（可选）：支持推理/思考级别的模型所用的级别。如果该值对该模型无效，则使用模型的默认值。

设置界面只替换第一项，并保留自定义列表的其余部分。直接编辑文件后，请重启 daemon。

按项目设置指令

你可以在仓库根目录的 clisbot.json 文件中，按仓库调整每类元数据的措辞。Clisbot 从基础分支已提交的版本中读取它，方式与读取 worktree 配置相同。

{
  "metadataGeneration": {
    "title": { "instructions": "Keep titles to a few words, no leading verb." },
    "branchName": { "instructions": "Use the format <type>/<scope>-<short-desc>." },
    "commitMessage": { "instructions": "Follow Conventional Commits." },
    "pullRequest": { "instructions": "Include a Testing section in the body." }
  }
}

每个键都是可选的；只有你设置的键会受影响。你的指令会替换该类元数据的默认风格，而不是追加到默认风格之后，因此你的措辞永远不会与 Clisbot 的默认值冲突。功能性要求（要生成什么以及输出格式）始终适用，不能被覆盖。