内容
# SeatLayer AI 工具包
[](https://github.com/seatlayer/seatlayer-ai-toolkit/actions/workflows/ci.yml)
[](LICENSE)
代理技能、诊断和可选的 Designer MCP 配置，用于在现有应用程序中添加预留座位。
该工具包不会取代 [SeatLayer 开发者文档](https://docs.seatlayer.io/)。它教导代理如何检查存储库、选择正确的 SeatLayer 接口、加载最小的相关实时文档集、实现集成并证明结果。
[使用代理构建](https://docs.seatlayer.io/agents/overview/) ·
[开发者文档](https://docs.seatlayer.io/) ·
[演示中心](https://app.seatlayer.io/demo) ·
[官网](https://seatlayer.io/developers/)
## SeatLayer 生态系统
- [开发者文档](https://docs.seatlayer.io/) — 权威的产品合约、指南、API 参考和代理可读的 Markdown。
- [SeatLayer SDK](https://github.com/seatlayer/seatlayer-sdk) — 官方的 JavaScript 和 React 包源。
- [SeatLayer React Native SDK](https://github.com/seatlayer/seatlayer-react-native) — 类型化的 Expo、iOS 和 Android 包，带有可运行的示例。
- [SeatLayer iOS SDK](https://github.com/seatlayer/seatlayer-ios) — 公共原生 SDK 源和 Swift 包管理器预览。
- [SeatLayer Android SDK](https://github.com/seatlayer/seatlayer-android) — 原生 Kotlin 视图、协程控制器和安全 AndroidX WebKit 桥。
- [SeatLayer for Flutter](https://pub.dev/packages/seatlayer) — 官方 Flutter 包，源代码位于 [seatlayer/seatlayer-flutter](https://github.com/seatlayer/seatlayer-flutter)。
- [SeatLayer on GitHub](https://github.com/seatlayer) — 所有的公共 SeatLayer 存储库。
## 包含内容
- `integrate-seatlayer` — 一个用于实施、审查、故障排除和上线工作的便携式代理技能。
- `seatlayer-ai doctor` — 用于检查暴露的凭证、浏览器端预订、缺少幂等性和冲突处理以及弱 webhook 验证的确定性检查。
- Claude 代码命令，用于设置、集成、诊断和验证。
- Codex 和 Claude 插件清单。
- 可选的远程 Designer MCP 配置。OAuth 仍然是图表作用域的，发布始终需要明确的人类决策。
## 快速开始
克隆存储库：
```bash
git clone https://github.com/seatlayer/seatlayer-ai-toolkit.git
cd seatlayer-ai-toolkit
```
### Codex
将技能安装到您的个人 Codex 技能目录：
```bash
node scripts/install.mjs --target codex
```
然后询问：
```text
使用 $integrate-seatlayer 将预留座位添加到此存储库中。
```
### Claude Code
加载完整的插件：
```bash
claude --plugin-dir /absolute/path/to/seatlayer-ai-toolkit
```
可用命令：
```text
/seatlayer:setup
/seatlayer:integrate
/seatlayer:doctor
/seatlayer:verify
```
### GitHub Copilot
将便携式技能安装到项目中：
```bash
node scripts/install.mjs --target github --project /path/to/project
```
这会在不修改应用程序代码的情况下写入 `.github/skills/integrate-seatlayer/`。
### 任意编码代理
给代理这两个资源：
- `https://docs.seatlayer.io/llms.txt`
- `skills/integrate-seatlayer/SKILL.md`
完整的文档主体可在 `https://docs.seatlayer.io/llms-full.txt` 处找到，但优先使用聚焦的页面路由以避免不必要的上下文。
## 诊断现有集成
运行只读扫描器：
```bash
node scripts/doctor.mjs /path/to/project
```
对于机器可读输出：
```bash
node scripts/doctor.mjs /path/to/project --json
```
扫描器从不读取目标存储库外部的文件，从不打印环境变量值，并忽略依赖项和构建输出。
## 核心安全边界
- 浏览器选择并持有；受信任的服务器检查并预订。
- `SEATLAYER_SECRET_KEY` 永远不会进入浏览器代码。
- 金额来自受信任的服务器数据，而不是浏览器输入。
- `bookingRef` 是主机订单标识符，并为安全重试而重复使用。
- 库存冲突和过期的持有是正常的恢复路径。
- Webhook 签名从原始请求正文中验证。
实时文档在与工具包指导冲突时是权威的：
- [使用代理构建](https://docs.seatlayer.io/agents/overview/)
- [代理集成工作流](https://docs.seatlayer.io/agents/integrate-seatlayer/)
- [完整的结账](https://docs.seatlayer.io/examples/complete-checkout/)
- [集成最佳实践](https://docs.seatlayer.io/integrations/best-practices/)
## Designer MCP
包含的 `.mcp.json` 指向 SeatLayer 的远程 Streamable HTTP MCP 资源。它使用带有 PKCE 和图表作用域授权边界的 OAuth 2.1。SeatLayer 仪表板中显示了可用性和发布能力。
集成技能不得在任务涉及图表创作或审查时使用 Designer MCP。它必须在未经用户明确授权的情况下永远不会发布。
## 开发
要求：Node.js 18 或更高版本和 Python 3，用于可选的上游技能和插件验证器。
```bash
npm run validate
```
存储库故意没有运行时依赖。
## License
MIT © SeatLayer
