# 命语文档

根目录的 [README](../README.md) 只保留项目简介、常用能力和快速入口。完整资料按用途分开放在这里。

## 普通用户

- [在线体验](https://aov.cc)：直接使用排盘、合盘、占卜和择日。
- [新手教程](https://aov.cc/tutorial)：了解四种模式和提示词使用方法。
- [完整能力与算法边界](capabilities.md)：查看支持的术式、主要资料和适用范围。

## 开发者

- [公开 API](api.md)：接口、参数和请求示例。
- [经典依据选项](经典依据选项.md)：按术数选取的简短典籍规则、适用条件与出处。
- [MCP Server](../mcp/README.md)：让支持 MCP 的 AI 客户端调用命语。
- [Agent Skill](../public/skills/mingyu/SKILL.md)：通用算命与周易玄学工作流 Skill，让 AI 代理准确选择术数并调用排盘。
- [`mingyu-core` 算法包](../packages/core/README.md)：在应用中复用核心算法。
- [开发与部署](development-and-deployment.md)：本地开发、项目结构、Cloudflare Pages、Docker 和内置 AI 配置。
- [模型评测](model-evaluation.md)：算命师大赛数据集和评测脚本。

## 在线发现入口

- [API 能力清单](https://aov.cc/api/v1/manifest)
- [OpenAPI](https://aov.cc/api/v1/openapi.json)
- [llms.txt](https://aov.cc/llms.txt)
- [Agent Skill](https://aov.cc/skills/mingyu/SKILL.md)
- [npm 核心包](https://www.npmjs.com/package/mingyu-core)

## Agent Skill 安装

推荐使用一条命令安装：

```bash
npx skills add Brhiza/mingyu --skill mingyu -g -y
```

手动安装时，从仓库复制完整的 `skills/mingyu/` 目录到客户端的 Skill 目录，包含 `SKILL.md` 和全部 `references/` 文件。

Skill 内容统一在 `skills/mingyu/` 维护，更新后运行 `node scripts/sync-skill.mjs` 同步公开入口。