mirror of https://github.com/getpaseo/paseo.git synced 2026-10-30 05:02:58 +00:00

Files

T

Mohamed Boudra 4574142314 fix(server): use only the configured models for manual metadata generation (#7611 )

Manual metadata generation is a non-empty agents.metadataGeneration.providers
list, but the resolver always appended the built-in defaults and the current
agent selection after it. When a manual model failed, the prompt was retried
on providers the user never chose. Manual now resolves to exactly the
configured list; Automatic is unchanged.

Commit message and PR text generation swallowed failures without logging, so
a broken manual model was invisible. The git metadata generator now logs the
final failure with each attempt's provider, model and error, and the
structured generation loop receives the session logger for per-attempt
warnings, matching the branch name path.

2026-10-22 14:36:22 +07:00

4.6 KiB

Raw Permalink Blame History

title, description, nav

title	description	nav
元数据生成	Paseo 如何使用 Provider 生成分支名、提交信息和 PR 文本，以及如何配置。	元数据生成

元数据生成

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

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

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

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

如何选择模型

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

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

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

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

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

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

选择模型

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

配置自定义的回退顺序

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

{
  "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 的默认值冲突。功能性要求（要生成什么以及输出格式）始终适用，不能被覆盖。

4.6 KiB Raw Permalink Blame History