# 模眼 使用帮助

由 模眼 提供的公开使用文档，包含普通用户查询、比较和跟踪供应商的教程，以及供应商站长的收录、认领、检测入口和模型探针配置指南。

- 网页版：[https://okmoyan.com/help](https://okmoyan.com/help)
- Markdown 版：[https://okmoyan.com/help/index.md](https://okmoyan.com/help/index.md)

## 普通用户指南

### 1. 浏览供应商目录

打开 [https://okmoyan.com/suppliers](https://okmoyan.com/suppliers)，可以按供应商名称、域名、模型、标签和系统类型筛选。公开目录展示供应商简介、状态、模型厂商、公开模型数量和最近采集时间。

### 2. 看懂供应商详情

供应商详情会公开展示分组与模型、健康状态、质量摘要、数据来源、评分、收藏人数和近期评论。供应商实付价格、分组倍率、历史变化和完整检测记录需登录后查看。

### 3. 查询官方模型价格

打开 [https://okmoyan.com/prices](https://okmoyan.com/prices)，可以搜索模型并勾选最多四项进行对比。这里展示的是外部官方参考价格，不代表任何供应商的最终实付价格。

### 4. 登录后的功能

- 收藏供应商，并在“我的供应商”中集中查看。
- 发表、修改或删除自己的供应商评分与评价。
- 使用供应商对比查看质量、价格和模型覆盖差异。
- 使用模型验真辅助判断模型是否与标称一致。
- 订阅模型、分组、倍率和价格变化通知。

## 供应商站长指南

### 先分清检测入口和模型探针

- **检测入口**：从供应商系统读取分组、模型和价格等信息。
- **模型探针**：按模型发起延迟、可用率和模型真实性检测。

通常应先完成检测入口验证，再使用检测分组模式配置模型探针。

### 操作流程

#### 1. 提交收录或发起认领

- 尚未收录：登录后进入 **/console/site-submissions**，选择“我是站长”提交站长收录申请。
- 已经收录：登录后进入 **/console/supplier-claims**，搜索供应商并通过 DNS TXT 或 HTTP 文件完成域名验证。

#### 2. 添加检测入口

进入“供应商认领 → 已认领 → 检测与模型探针 → 检测入口”，填写供应商 API 地址和对应系统的用户级凭据，并完成一次验证。

Sub2API 支持邮箱密码和 Refresh Token 两种认证方式，请按站点实际情况选择：

- **邮箱密码**：标准站点可以填写登录邮箱和密码；系统会调用登录接口并自动维护访问令牌。
- **Refresh Token**：如果站点启用了验证码、Turnstile、二次验证，或登录接口有定制，请在已登录站点的浏览器开发者工具中打开“应用程序 → 本地存储”，复制 **refresh_token**，不要复制 **auth_token**。
- **New API**：从个人资料顶部获取用户 ID，再从“安全 → 访问令牌”生成或复制访问令牌。

验证成功后，系统才会把最近一次成功检测到的分组和模型带入探针配置。

#### 3. 配置模型探针

在同一窗口打开“模型探针”标签，推荐使用检测分组模式：选择分组、协议和模型后保存。系统会优先复用可用分组令牌，没有可用令牌时自动创建专用探针令牌。

- 分组模式适合已经检测到分组的 Sub2API / New API。
- 手动模式适合自定义系统或没有分组数据的兼容接口。
- 批量模式可以一次勾选多个分组，系统会分别保存探针配置，不会混用不同倍率。

供应商探针和模眼探针都由模眼主动发起实际请求，区别在于前者由已认领的站长维护，后者由模眼维护。供应商探针首次成功运行后才会对外生效；运行失败、分组消失或认领撤销时会自动切换到模眼探针。两类探针不会混合统计，公开监控则展示供应商已经公开的监控数据。

## 安全边界

Refresh Token、邮箱密码、访问令牌和 API 密钥都属于登录凭据，只应填写在自己认领供应商的检测入口。系统会加密保存，站长接口不会回显完整凭据；不要把凭据放入评论、备注或截图。

## 常见问题

- **验证成功但没有分组**：刷新检测入口并确认最近一次检测成功；旧版或关闭模型广场的站点请使用手动探针模式。
- **多个分组怎么配置**：使用“批量配置分组探针”，不同分组会分别保存，不会混用倍率。
- **保存后仍显示模眼探针**：等待供应商探针至少产生一次成功样本；成功前显示模眼探针是正常的。