#元数据生成

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

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

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

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

#如何选择模型

你无需进行任何配置，Paseo 会自动选择模型。它会构建一个有序的候选列表，逐个尝试，直到生成成功，因此慢或不可用的模型会让位给下一个。

候选列表按以下顺序组成：

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

每个默认值按模型 id 或名称匹配，因此第一个提供匹配模型的已启用 Provider 胜出。无法在已启用 Provider 中解析的条目会被跳过。去除重复项后，生成过程从上到下依次尝试。

默认顺序的意图是：对于这些简短任务，优先使用小、快、便宜的模型，最后才退回到你选中的模型。

#选择模型

打开 设置 → 主机 → 元数据，选择 自动 或 手动。在手动模式下，Paseo 会先尝试你选择的模型，然后退回到其余已配置的模型和内置候选。选择模型会替换 agents.metadataGeneration.providers 中的第一项，并保留列表的其余部分。

#配置自定义的回退顺序

如果要配置多个首选模型或控制确切的顺序，请在 ~/.paseo/config.json 中设置 agents.metadataGeneration.providers。你的条目会在内置默认值之前尝试。

{
  "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。

#按项目设置指令

你可以在仓库根目录的 paseo.json 文件中，按仓库调整每类元数据的措辞。Paseo 从基础分支已提交的版本中读取它，方式与读取 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." }
  }
}

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