> For the complete documentation index, see [llms.txt](https://docs.velogicfit.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.velogicfit.com/zh/di-03-jie-jiao-zhun-yu-ce-liang/bikefinder-integration.md).

# BikeFinder 集成

如何使用 Velogic Studio Pro 的 BikeFinder 集成来建议目标车架和把立配置，以获得最佳自行车拟合位置。

> **注意：** 此功能仅适用于 Velogic Studio Pro。Velogic Studio Essentials 不提供此功能。

## 原理说明

帮助您的客户选择和/或配置一辆合适的新车，通常被视为自行车拟合的一部分。Velogic Studio 的 bikefinder 集成可帮助您将这部分无缝纳入您的自行车拟合服务中。

### 如果他们心里有特定的车型：使用“目标车架”

自行车拟合客户在来做拟合时，通常会有以下两种情况之一：

* 已有一辆车，希望根据那辆车进行拟合（如果那辆车并不适合他们，可能会比较棘手）
* 或者是在购买前，但心里已有特定车型，并希望知道该车型的合适尺码。

完成拟合后，许多拟合师会为客户计算以下选项：

* 如果他们已有一辆车，但拟合得到的是不同的把组 XY 位置：您需要找到合适的把立/垫圈配置来实现该位置
* 如果他们心里有特定车型，您需要先建议最佳尺码，然后再找到合适的把立/垫圈配置来实现其目标 XY。

Velogic Studio 可以在拟合过程中自动通过建议把立/垫圈组合，并可选地建议车架尺码来提供帮助。只要您测量车架时（无论是手动，还是使用我们的测量杖），且测量值包含 BarX 和 BarY，Velogic Studio 就会给出建议。

更多内容请参见下方“选择目标车架”部分。

### 如果他们想要车辆建议：使用“在线搜索”

如果您的客户还没有锁定某个特定车型，您可以带着一份报告让他们回家，其中展示一些可能适合他们的选项。

更多内容请参见下方“在线搜索”部分。

## 选择目标车架

在拟合开始时，或在拟合过程中的任何时候，您都可以添加一个目标车架。在第 1 步：配置中，只需点击“添加目标车架”：

![Velogic Studio 第 1 步配置界面，目标车架区域中的“添加目标车架”按钮](https://2529810062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-6af8ceb87058fc35367ec93abc6a5352c9b3b6b7%2F7e94befa.png?alt=media)

> **注意：** 如果您看不到“目标车架”区域，您可能没有使用 Velogic Studio 的 Pro 版本，或者您可能需要启用 BikeFinder 插件（设置 -> 插件）

您会看到一个车架搜索弹窗，在其中输入搜索词：

![车架搜索弹窗，带有用于输入自行车品牌、型号和年份信息的搜索输入框](https://2529810062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-c35b8990a50fa577ce4dbb2895717f3edb69eca1%2Fba905c0e.png?alt=media)

搜索词支持自由输入文本，因此您可以包含品牌、型号和/或年份。最多会返回 30 条结果；如果您要找的车架不在结果集中，但结果很多，您可能需要输入更具体的条件。

如果您找不到一个您认为应该在数据库中的车架，请联系我们（<frames@velogicfit.com>）请求添加。

当您看到要找的车架后，点击它，您会看到它出现在搜索窗口右侧：

![车架搜索结果，显示所选自行车车架及尺寸选项和“添加目标车架”按钮](https://2529810062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-17320deb56f654bf328be05b1a0e19fd34006584%2Fbf22a511.png?alt=media)

您可以选择特定车架尺码（例如，如果您的客户已经有那辆车），或者将尺码保留为“任意”，让 Velogic Studio 为您建议车架尺码。

点击“添加目标车架”后，搜索弹窗将关闭，车架将被添加到“目标车架”区域：

![目标车架区域，显示已添加的自行车车架以及 BarXY 容差和坐垫突出量的配置选项](https://2529810062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-ae514f3e97bf86c606af85ca53348c120bb31f63%2F31c27925.png?alt=media)

> **注意：** 同一车架可以有多个目标车架，且尺寸不同。例如，如果您的客户使用的是 M 码，您可以为该尺码添加一个目标车架，再为同一型号但尺寸为“任意”的第二个目标车架。这样您就可以比较其尺码的最佳把立/垫圈配置，以及建议的最佳尺码。

添加一个或多个目标车架后，您会在“目标车架”区域顶部看到 BarXY 容差和坐垫突出量选项。两者都是可选项，但如果启用，您可以添加用于生成推荐的参数：

![目标车架配置，显示用于精确拟合建议的 BarXY 容差和坐垫突出量设置](https://2529810062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-76215d5ac13464a31660295d00625a0ba2f488b1%2Fbikefinder-add-target-frame.png?alt=media)

* 如果您指定了 BarXY 容差（毫米），Velogic Studio 绝不会建议一个与目标把组 XY 距离超出该指定范围的把立/垫圈配置。
* 如果您指定了坐垫突出量（%），并且随后测量了坐垫高度，Velogic Studio 还会检查坐垫立管 + 坐垫从座管顶部向外“突出”的比例是否至少达到总坐垫高度的指定百分比。这样可以防止出现这种情况：为实现所需的伸距，给一位较矮且骑姿激进的骑手建议一个大车架，但坐垫却会被压得过低贴在车架上（或者被座管迫使抬得高于理想高度）。更多信息请参见下方 FAQ 中的“什么是坐垫突出量”。

## 测量过程中获取目标车架建议

当您添加了一些目标车架，并使用测量杖测量车架（或输入手动测量值）时，您会看到建议的车架尺码和/或把立/垫圈组合，以实现该把组 XY（以及可选的坐垫高度）：

![BikeFinder 建议，显示各目标车架的推荐车架尺码和把立配置，并附带准确度指标](https://2529810062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-1fd222b1a632832d2a4ba035737779319f24287c%2Fbikefinder-frame-search.png?alt=media)

对于您在第 1 步中添加的每个目标车架，您会看到一条建议，其中包含：

* 目标车架的品牌、型号和年份
* 您选择的目标尺码
* 建议尺码（仅当您为目标尺码选择“任意”时）
* 建议的把立配置，例如“120mm +8°, 15mm 垫圈”
  * **120mm** 是把立长度
  * **+8°** 表示一个 8° 的把立，向上倾斜（如果符号为负，例如 -8°，则表示把立向下倾斜）
  * **15mm 垫圈** 表示从头管顶部到把立底部有 15mm 的垫高。

> **注意：** 垫圈数量是从头管顶部开始计算的。您需要测量并减去碗组和上盖/上档碗的高度，才能确定需要实际添加的垫圈高度。

* 有关该建议与目标测量值接近程度的信息：
  * Bar X 和 Bar Y 表示该建议比目标值超出了多少毫米（如果为负，则表示不足）
  * Saddle 显示坐垫突出量的百分比（参见 FAQ）

当您点击完成时，测量结果将被添加到拟合记录中。

## 在拟合记录中查看车架建议

当您查看拟合记录时，在“Bike metric”部分内会看到一个“目标车架”区域，每个目标车架占一行。

每个目标车架行都会为每个测量列显示一条建议，因此您可以看到在拟合过程中测量的不同位置对应的建议。

![拟合记录中的目标车架区域，显示不同测量位置的车架建议以及把立和垫圈推荐](https://2529810062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-90b5de3bc3782656110346c410d7fad2eb035f93%2Fbikefinder-frame-selected.png?alt=media)

如果 Velogic Studio 无法给出建议（因为它无法找到一个在目标把组 XY 指定容差范围内的车架尺码和把立/垫圈组合），它会显示“无建议”。如果您没有指定把组 XY 容差，那么 Velogic Studio 总会给出建议，即使该建议对于目标把组 XY 位置来说大得离谱（或小得离谱）。在这种情况下，您可以从文本底部一行读取 BarX 和 BarY 误差以及坐垫突出量，以判断是否可接受。

## 在线搜索

在测量或查看已有测量结果时，您可以使用 BikeFinder 模块的在线搜索功能。

![在线搜索界面，显示多个自行车车架选项及其与测得骑手位置的兼容性评级](https://2529810062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-b7314f5a1a7f6bf17047edf78486d4d464ad1817%2Fbikefinder-frame-suggestions.png?alt=media)

## 常见问题

### 问：我可以离线使用“目标车架”功能吗？

答：不可以。此功能会连接到 Velogic 在线车架数据库，因此在离线状态下无法使用。

不过，您可以离线进行拟合，然后在重新联网后添加目标车架，以获取该拟合的建议。

### 问：如果我不喜欢针对目标车架的建议怎么办？

答：请联系我们并说明您收到的建议细节，以及为什么它不是您预期的结果。我们的建议引擎一直在不断改进，以便在各种情况下提供最佳结果。

### 问：什么是坐垫突出量？

答：坐垫高度（从下轴承到坐垫顶部的距离）由自下而上的 3 个组件或阶段组成：

* 座管（从中轴到座管顶部）
* 然后是可见的座杆部分
* 最后是坐垫本身。

坐垫突出量就是由可见座杆部分和坐垫共同构成的坐垫高度百分比。它衡量座杆从座管中“伸出”了多少。

如果您测量了坐垫高度，并且我们有所选车架的 SeatTubeCT 数据可用（我们大多数情况下都有），Velogic Studio 会显示坐垫突出量百分比。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.velogicfit.com/zh/di-03-jie-jiao-zhun-yu-ce-liang/bikefinder-integration.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.