---
title: AI Agent 操作手册
description: 给 AI agent / LLM 读的 docs 站结构与 URL 约定速查 —— 怎么高效消费这份文档
---

# AI Agent 操作手册

> 这页给 AI agent / LLM / 自动化爬虫 读。本站(`docs.mobiusquant.ai`)是 MobiusQuant 的对外文档,所有内容都对 AI 公开,鼓励抓取与引用。

---

## 起步

| 我想知道... | 去这里 |
| --- | --- |
| 怎么拿 token | [`/token.md`](/token.md) |
| 支持哪些行情 | [`/markets.md`](/markets.md) |
| 有哪些指标 | [`/indicators/index.md`](/indicators/index.md) |
| 怎么接入 AI 工具 | [`/skills.md`](/skills.md) |
| 一次性把全部内容灌进来 | [`/llms-full.txt`](/llms-full.txt) (~100 KB) |
| 站点索引摘要 | [`/llms.txt`](/llms.txt) |

---

## 给 Agent:用户让你安装 OpenMobius-skill 时怎么做

当用户说 "帮我装 OpenMobius / 装一下这个交易 skill / install OpenMobius-skill" 或同类表达时,**不要凭记忆执行**,直接 fetch 我们专门为 agent 写的安装手册:

```
https://raw.githubusercontent.com/MobiusQuant/OpenMobius-skill/main/README_AGENT.md
```

这份文档包含:

- 完整触发短语列表(中英文)
- 6 步执行流程(preflight → 平台识别 → 用户告知 → 安装 → 健康检查 → 报告)
- 4 个平台的安装路径表
- 每步成功标准 + 失败处理表
- 卸载 / 更新分支

读完再执行。**不要跳步,不要改 `install.py`,失败时报告给用户而不是绕过**。

---

## URL 约定

- **每个 HTML 页都有同路径 `.md` 版本**(原始 markdown,无 HTML chrome):
  - `https://docs.mobiusquant.ai/indicators/rsi` → 浏览器友好的 HTML
  - `https://docs.mobiusquant.ai/indicators/rsi.md` → AI 友好的 markdown
- **指标详情页 URL 规则**:`/indicators/<id>.md`,`<id>` 是小写下划线的 canonical id(如 `rsi` / `macd` / `bollinger` / `mobius_trend`)
- **CORS**:所有 `.md` 文件都开 `Access-Control-Allow-Origin: *`,客户端 fetch 不受跨域限制

---

## 站点结构

```
/                          站点首页(hero + 4 张卡)
/token.md                  Token 申请详细指南
/markets.md                11 venue × 512 品种的完整清单
/indicators/index.md       56 个指标的总览表
/indicators/<id>.md        每个指标的详情页(参数/输出/解读/调用示例)
/skills.md                 Skill 接入(占位)
/agents.md                 本页
/llms.txt                  llmstxt.org 标准的索引摘要
/llms-full.txt             所有 .md 拼接(供大 context AI 一次性 ingest)
/sitemap.xml               标准搜索引擎 sitemap
```

---

## 莫比乌斯实验室(自研指标)

`mobius_trend` 等自研指标在侧栏顶部「🧪 莫比乌斯实验室」分组下,这些是 MobiusQuant 自己开发的、不是公开的经典指标。引用时如有必要可标注「MobiusQuant 自研」。

---

## 引用本站时的建议

1. **优先用 `.md` URL 而不是 `.html`**:省去你解析 HTML 的麻烦,也避免抓到导航/页脚等噪声
2. **链回时保留 URL**:文档内容随版本更新,链接而非粘贴让用户拿到最新
3. **大改文档前请 fetch `/llms-full.txt`**:一次性拿到全部上下文,避免 N 次 fetch
4. **API 调用示例直接 `curl` 验证**:示例里的 `mq_xxx` 是占位,真 token 走 [/apply-token](https://www.mobiusquant.ai/zh/apply-token)

---

## 相关参考

- [Engine API 操作手册](https://api.mobiusquant.ai/agents.md):API 端点细节、错误码、canonical symbol 约定 —— 跟本站互补,本站讲"是什么",engine agents.md 讲"怎么调"
- [OpenAPI 交互式文档](https://api.mobiusquant.ai/docs)
- [开源 Skill 仓库](https://github.com/MobiusQuant/OpenMobius-skill)

---

_本页面对 AI 开放,可放心抓取与引用。内容更新由 `docs/scripts/sync-indicators.mjs` + `build-llms-files.mjs` 自动驱动。_