# ai-profile

> AI 模型服务配置层

一份预置、一个协议、一套验证 —— 多个桌面应用共用。模型 id 变了只改一处，所有应用同时生效。

## Table of Contents

### 入门

- [这是什么](https://ai-profile.ruoyi.plus/guide/introduction.md)
- [安装与 feature](https://ai-profile.ruoyi.plus/guide/installation.md)
- [快速开始](https://ai-profile.ruoyi.plus/guide/quick-start.md)
- [按场景查找](https://ai-profile.ruoyi.plus/guide/cookbook.md)
- [用 AI 接入](https://ai-profile.ruoyi.plus/guide/ai-assisted.md)

### 接入实战

- [Tauri 应用接入](https://ai-profile.ruoyi.plus/guide/tauri-integration.md)
- [前端对接](https://ai-profile.ruoyi.plus/guide/frontend.md)
- [已发布应用的接入迁移](https://ai-profile.ruoyi.plus/guide/migration.md)

### API · 服务商目录

- [预置与服务商目录](https://ai-profile.ruoyi.plus/api/preset.md)
- [定制服务商目录](https://ai-profile.ruoyi.plus/api/catalog.md)

### API · 配置与连接

- [ai.profile 协议](https://ai-profile.ruoyi.plus/api/protocol.md)
- [端点与模型清单](https://ai-profile.ruoyi.plus/api/endpoint.md)
- [连通性验证](https://ai-profile.ruoyi.plus/api/verify.md)

### API · 对话辅助

- [限额：上下文窗口与输出上限](https://ai-profile.ruoyi.plus/api/limits.md)
- [历史裁剪与超长重试](https://ai-profile.ruoyi.plus/api/history.md)

### API · 多模态调用

- [生图、视频与配音](https://ai-profile.ruoyi.plus/api/media.md)

### 参考

- [服务商清单](https://ai-profile.ruoyi.plus/reference/providers.md)
- [错误码对照](https://ai-profile.ruoyi.plus/reference/errors.md)
- [更新日志](https://ai-profile.ruoyi.plus/reference/changelog.md)
- [版本策略](https://ai-profile.ruoyi.plus/reference/versioning.md)
- [加一家服务商](https://ai-profile.ruoyi.plus/reference/add-provider.md)
- [其他语言实现](https://ai-profile.ruoyi.plus/reference/spec.md)

### Other

- [接入 ai-profile](https://ai-profile.ruoyi.plus/public/ai/ai-profile-integration.md): 用于在本项目里接入或修改 ai-profile（AI 模型服务配置层 Rust crate）：服务商预置、「获取模型」验证、ai.profile 粘贴导入与分享、token 限额与历史裁剪、生图 / 视频 / 配音调用。

触发场景：
- 第一次把 ai-profile 接进项目，替换项目里自己写的服务商清单或地址拼接
- 做或修改「模型服务」设置页：服务商下拉、获取模型、测试连接、粘贴导入
- 对话请求前要裁历史、给 max_tokens 封顶，或处理「上下文超长」报错
- 升级 ai-profile 版本，或想加新模型 / 新服务商

触发词：ai-profile、模型服务、服务商预置、provider、获取模型、测试连接、ai.profile、粘贴导入、限额、上下文窗口、历史裁剪