> 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-02-jie-shi-yong-velogic-studio/troubleshooting-marker-detection.md).

# 标记点检测故障排除

Velogic Studio 中常见标记点检测问题的综合故障排除指南

Velogic Studio 应该会给你显示一个稳定的线框/骨架：

{% embed url="<https://ik.imagekit.io/vfframes/docs/George%20skeleton_D-74O6nry.mp4>" %}

并且质量指示器在检测方面应该显示“良好”：

![质量指示器显示“良好”的检测状态，表示标记识别正常](https://2529810062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-228659437abda88d137f68f93eb5b8d8ae54c2a9%2Ftroubleshooting-marker-detection.png?alt=media)

如果你没有看到这种情况，这个页面会帮助你排查问题。

> **已知问题：** 从 2026 年初生产的某些卷标记胶带并没有完全具备逆反射特性，这会导致标记在没有正对摄像机时消失。如果某个标记即使放置正确也持续消失，请参见 [标记反光率问题](/zh/di-02-jie-shi-yong-velogic-studio/marker-reflectivity-issue.md).

## 看看红点——有没有多余的？有没有缺失的？

如果 Velogic Studio 无法从 7 个（或 8 个）圆点中找到有效的骨架，它就会改为显示它识别到的标记红点。

![当 Velogic Studio 无法从检测到的标记形成有效骨架时显示的红点](https://2529810062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-0acc728aa3146b4837fa02004334d9bd464d7cbb%2Ftroubleshooting-marker-detection-1.png?alt=media)

你可以观察骑手踩踏时的情况，看看某个标记是否偶尔不会显示为红点。如果你注意到这种情况，请调整有问题的标记，让摄像机能更好地看到它。

如果你在场景中看到额外的红点（例如前轮轮圈上的反光），你可能需要将其遮挡，比如用美纹胶带覆盖。请注意，Velogic Studio 可以处理一些额外的反光，尤其是当它们离有效标记位置很远时；但如果额外反光很多，或者它们靠近有效标记位置，你就需要把它们遮住。

## 检查标记放置位置

请参阅我们的 [标记放置文档](/zh/di-02-jie-shi-yong-velogic-studio/joint-marker-placement.md)。标记需要放在摄像机可以直接看到的位置。常见问题有：

* 肩部标记放得太高
* 手腕标记旋转得离摄像机太远
* 脚跟标记（如使用）在鞋子上放得太靠下

## 检查所选圆点数量是否正确（7 个或 8 个）

在步骤 1 中有一个配置项，用来告诉 Velogic Studio 你使用的是 7 个标记，还是 8 个（包括一个脚跟标记）。请确保该设置与你实际使用的标记数量一致。

## 查找其他被标为红点的反光

* 短裤、骑行服和鞋子上的徽标或标签
* 自行车上的亮面部件
* 合金轮圈

我们在检测过程中使用了大量过滤来消除额外反光，而高等级标记（印在 VF-Tape 上的材料具有夜视等级）也是我们区分需要的反光和不需要的反光的方式之一。

## 骑手异常高大/矮小/比例异常？

为了帮助 Velogic Studio 过滤掉不需要的反光，它有一些内部规则，以确保由标记形成的骨架能够合理地代表人体。这些规则有些涉及比例，有些涉及身体部位尺寸。

有时你可能会遇到骑手违反我们某条比例规则的情况（更常见于非常矮小或非常高大的骑手）。如果你看到 7 个（或 8 个）红点，而且都在正确位置，但 Velogic Studio 没有生成线框/骨架，那么你可能遇到的就是这种情况。

为了帮助我们完善这些规则，请提交一个样本文件，我们会进行调查并用于调整规则。请参见下面的“提交文件供我们访问”。

## 摄像机离得太远了？

如果摄像机位置距离自行车平面超过大约 8 英尺，这些圆点可能太小，摄像机无法识别。

另请参见： [设置适配区域](/zh/di-01-jie-ru-men/setting-up-fit-area.md)

## 提交样本文件供我们评估

如果你在标记检测方面遇到问题，我们有一个简单流程用于 [提交文件供分析](/zh/di-01-jie-ru-men/sharing-with-support.md) （请参阅该页面上的“共享回放文件”部分）。

下面是“提交样本”流程的视频：

{% embed url="<https://vimeo.com/377229580>" %}


---

# 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-02-jie-shi-yong-velogic-studio/troubleshooting-marker-detection.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.