# Vibe Coding(Beta)

{% hint style="info" %}
本文档基于上述开放的Android SDK，提供RayNeo X3 PRO Glasses快速进行AI开放的skill规范。将skill.md引入你的AI IDE中，有助于快速实现双目显示、镜腿触控、焦点管理等眼镜特性。
{% endhint %}

## skill.md下载

以下可以按需二选一：

* 一份skill合集，适用于本地ide已有较多其他skill场景，sdk整体技能命中率高，但可能token消耗较高：

{% file src="/files/m6EUq0QRX29u2jR3oKr5" %}

* 多个模块独立skill，符合渐进式披露原则，最小化token消耗，但可能存在诉求描述和技能匹配命中率问题：

{% file src="/files/Wtusx3NyaOunNtal4Xsf" %}

<table><thead><tr><th width="191">目录分类</th><th>内容介绍</th></tr></thead><tbody><tr><td>overview</td><td>快速了解 SDK 能力边界、核心类型入口与模块定位的场景。</td></tr><tr><td>quickstart</td><td>接入前检查、Manifest 配置、Application 初始化与基础交互约定落地。</td></tr><tr><td>core-api</td><td>连接状态监听、设备类型分支与基础能力接入。</td></tr><tr><td>mirror-ui</td><td>BindingPair、3D 视差、镜像 Activity/Fragment/Container 结构实现。</td></tr><tr><td>focus-touch</td><td>TempleAction 处理、焦点对象管理、动态焦点项与固定焦点跟踪。</td></tr><tr><td>dialog-toast</td><td>FDialog/FToast 构建、弹窗焦点切换与手势事件接入。</td></tr><tr><td>recyclerview</td><td>焦点随滑动、跟手滚动、SnapHelper 配置与列表双目同步。</td></tr><tr><td>ext-tools</td><td>dp/sp 转换、批量可见性控制、统一日志与调试建议落地。</td></tr><tr><td>checklisst</td><td>Threading/Lifecycle 评审、风险核查与合规自检。</td></tr></tbody></table>

***

## 摘要索引

| 类型                           | 包路径                  | 核心签名（节选）                                              | 作用              |
| ---------------------------- | -------------------- | ----------------------------------------------------- | --------------- |
| `MercurySDK`                 | `...sdk`             | `init(application: Application)`                      | SDK 初始化入口。      |
| `MobileState`                | `...sdk.api`         | `isMobileConnected(): Flow<Boolean>`                  | 手机连接状态监听。       |
| `BindingPair<B>`             | `...sdk.core`        | `updateView { }` / `setLeft { }` / `checkIsLeft(...)` | 左右布局映射与同步更新。    |
| `make3DEffect`               | `...sdk.core`        | `make3DEffect(leftView, rightView, enable, parallax)` | 双侧 3D 视差设置。     |
| `make3DEffectForSide`        | `...sdk.core`        | `make3DEffectForSide(view, isLeft, enable, parallax)` | 单侧 3D 视差设置。     |
| `BaseMirrorActivity<B>`      | `...sdk.ui.activity` | `abstract class BaseMirrorActivity<B : ViewBinding>`  | Activity 级合目基类。 |
| `FToast`                     | `...sdk.ui.toast`    | `show(...)` / `showCustom(...)`                       | 合目 Toast。       |
| `FDialog.Builder<T>`         | `...sdk.ui.dialog`   | `setContentView(...)` / `setEventHandler(...)`        | 合目 Dialog 构建器。  |
| `TempleAction`               | `...sdk.touch`       | `sealed class TempleAction`                           | 手势语义模型。         |
| `TempleActionViewModel`      | `...sdk.touch`       | `state: SharedFlow<TempleAction>`                     | 手势事件流分发。        |
| `FocusHolder` / `FocusInfo`  | `...sdk.ui.util`     | `addFocusTarget(...)` / `currentFocus(...)`           | 通用焦点项管理。        |
| `FixPosFocusTracker`         | `...sdk.ui.util`     | `handleFocusTargetEvent(action)`                      | 固定焦点项切换逻辑。      |
| `RecyclerViewFocusTracker`   | `...sdk.ui.util`     | `handleActionEvent(it, block)`                        | 移动焦点项列表跟踪。      |
| `RecyclerViewSlidingTracker` | `...sdk.ui.util`     | `observeOriginMotionEventStream(...)`                 | 固定焦点项 + 跟手滚动。   |
| `StartSnapHelper`            | `...sdk.util`        | `StartSnapHelper(offset2Start)`                       | 列表起始吸附。         |
| `DeviceUtil`                 | `...sdk.util`        | `isX3Device(): Boolean`                               | X3 设备判断。        |
| `FLogger`                    | `...sdk.util`        | `d(...)` / `i(...)` / `e(...)`                        | SDK 统一日志。       |

***

## 引入示例（以Cursor为例）

1. 使用cursor打开你的安卓工程，找到目录下的.curosr文件夹，若无则直接新建；
2. 将上述的skill.md文件解压缩后，拖入.cursor目录中；

<figure><img src="/files/LBbWWsGU2Lbu74x2Z2Pj" alt=""><figcaption></figcaption></figure>

3. 在cursor对话框中发起提问，agent会根据你的具体语义对skill内容进行引用并开始coding。

<figure><img src="/files/85nmOx6bs9iNVzx0pLUU" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://rayneo.gitbook.io/rayneo-devdoc/x-xi-lie/android-kai-fa/vibe-coding-beta.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.