138 lines
4.8 KiB
Markdown
138 lines
4.8 KiB
Markdown
|
# AI Proxy Worker Wiki
|
||
|
|
|
||
|
|
<div align="center">
|
||
|
|
|
||
|
|
**🌍 Language / 语言**
|
||
|
|
|
||
|
|
[🇺🇸 English](./Home.en.md) | [🇨🇳 中文](./Home.md)
|
||
|
|
|
||
|
|
</div>
|
||
|
|
|
||
|
|
欢迎来到 AI Proxy Worker 的完整文档！这里包含了从安装到高级使用的所有详细信息。
|
||
|
|
|
||
|
|
## 📚 文档导航
|
||
|
|
|
||
|
|
### 🚀 快速开始
|
||
|
|
- **[安装指南](./Installation)** - 详细的系统安装步骤
|
||
|
|
- **[部署教程](./Deployment)** - 多种部署方式对比
|
||
|
|
- **[快速配置](./Quick-Setup)** - 5分钟快速配置指南
|
||
|
|
|
||
|
|
### 📖 使用指南
|
||
|
|
- **[API 文档](./API-Reference)** - 完整的 API 参考
|
||
|
|
- **[配置指南](./Configuration)** - 环境变量和代码配置详解
|
||
|
|
- **[使用示例](./Examples)** - 各种编程语言示例
|
||
|
|
|
||
|
|
### 🔧 运维指南
|
||
|
|
- **[故障排除](./Troubleshooting)** - 常见问题解决方案
|
||
|
|
- **[监控指南](./Monitoring)** - 日志和性能监控
|
||
|
|
- **[安全配置](./Security)** - 生产环境安全最佳实践
|
||
|
|
|
||
|
|
### 🏗️ 开发指南
|
||
|
|
- **[贡献指南](./Contributing)** - 如何参与项目开发
|
||
|
|
- **[代码规范](./Code-Style)** - 代码风格和最佳实践
|
||
|
|
- **[测试指南](./Testing)** - 测试编写和执行
|
||
|
|
|
||
|
|
### 🔮 高级功能
|
||
|
|
- **[多 AI 支持](./Multi-AI-Support)** - 扩展支持其他 AI 服务
|
||
|
|
- **[自定义中间件](./Custom-Middleware)** - 添加自定义功能
|
||
|
|
- **[性能优化](./Performance)** - 性能调优指南
|
||
|
|
|
||
|
|
## 🎯 项目概览
|
||
|
|
|
||
|
|
AI Proxy Worker 是一个基于 Cloudflare Workers 的通用 AI API 代理服务，旨在解决以下问题：
|
||
|
|
|
||
|
|
### 🔐 安全性问题
|
||
|
|
- **问题**：客户端应用直接调用 AI API 需要暴露 API 密钥
|
||
|
|
- **解决**：代理服务将密钥安全存储在服务端，客户端只需要代理访问密钥
|
||
|
|
|
||
|
|
### ⚡ 性能问题
|
||
|
|
- **问题**：直接调用可能受网络限制影响速度
|
||
|
|
- **解决**：基于 Cloudflare 全球边缘网络，就近访问
|
||
|
|
|
||
|
|
### 🔄 兼容性问题
|
||
|
|
- **问题**：不同 AI 服务商 API 格式不统一
|
||
|
|
- **解决**：提供统一的代理接口，未来支持多个 AI 服务商
|
||
|
|
|
||
|
|
## 🏗️ 架构设计
|
||
|
|
|
||
|
|
```
|
||
|
|
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
|
||
|
|
│ 客户端应用 │────│ AI Proxy │────│ AI 服务商 │
|
||
|
|
│ (iOS/Web) │ │ Worker │ │ (DeepSeek) │
|
||
|
|
└─────────────────┘ └─────────────────┘ └─────────────────┘
|
||
|
|
│ │ │
|
||
|
|
│ PROXY_KEY │ DEEPSEEK_API_KEY │
|
||
|
|
│ (公开安全) │ (服务端机密) │
|
||
|
|
└────────────────────────┴───────────────────────┘
|
||
|
|
```
|
||
|
|
|
||
|
|
### 核心组件
|
||
|
|
|
||
|
|
1. **认证层**：处理客户端访问控制
|
||
|
|
2. **路由层**：分发请求到不同的 AI 服务
|
||
|
|
3. **代理层**：与上游 AI API 通信
|
||
|
|
4. **安全层**：请求验证、限流、日志记录
|
||
|
|
|
||
|
|
## 📊 支持的 AI 服务
|
||
|
|
|
||
|
|
### 当前支持 (v1.0)
|
||
|
|
- ✅ **DeepSeek API** - 完整支持，包含对话和推理模型
|
||
|
|
- `deepseek-chat` - 通用对话模型
|
||
|
|
- `deepseek-reasoner` - 复杂推理模型
|
||
|
|
|
||
|
|
### 计划支持 (未来版本)
|
||
|
|
- 🔄 **OpenAI API** - GPT 系列模型 (v2.0 计划)
|
||
|
|
- 🔄 **Claude API** - Anthropic Claude 模型 (v2.0 计划)
|
||
|
|
- 🔄 **Gemini API** - Google Gemini 模型 (v2.0 计划)
|
||
|
|
- 🔄 **统一路由** - 一套接口调用所有 AI 服务商 (v2.0 计划)
|
||
|
|
|
||
|
|
> **注意**: 当前版本专注于提供稳定可靠的 DeepSeek API 代理服务。多 AI 支持正在开发中，敬请期待！
|
||
|
|
|
||
|
|
## 🎯 使用场景
|
||
|
|
|
||
|
|
### 移动应用
|
||
|
|
- iOS/Android 应用安全调用 AI API
|
||
|
|
- 避免在客户端存储敏感密钥
|
||
|
|
- 提供统一的 AI 服务接口
|
||
|
|
|
||
|
|
### Web 应用
|
||
|
|
- 前端直接调用，无需后端中转
|
||
|
|
- 支持流式响应，实时对话体验
|
||
|
|
- 全球 CDN 加速访问
|
||
|
|
|
||
|
|
### 微服务架构
|
||
|
|
- 作为 AI 服务网关
|
||
|
|
- 统一的 AI API 访问层
|
||
|
|
- 支持多租户和访问控制
|
||
|
|
|
||
|
|
## 🔄 版本历史
|
||
|
|
|
||
|
|
### v1.0.0 (当前版本)
|
||
|
|
- ✅ 支持 DeepSeek API
|
||
|
|
- ✅ 完整的错误处理
|
||
|
|
- ✅ 流式响应支持
|
||
|
|
- ✅ 安全防护机制
|
||
|
|
|
||
|
|
### 未来版本
|
||
|
|
- 🔮 多 AI 服务商支持
|
||
|
|
- 🔮 用户级访问控制
|
||
|
|
- 🔮 请求限流和配额
|
||
|
|
- 🔮 详细的使用统计
|
||
|
|
|
||
|
|
## 🤝 社区
|
||
|
|
|
||
|
|
### 参与方式
|
||
|
|
- 🐛 [报告 Bug](../../issues/new?template=bug_report.md)
|
||
|
|
- 💡 [功能建议](../../issues/new?template=feature_request.md)
|
||
|
|
- 📝 [改进文档](../../issues/new?template=documentation.md)
|
||
|
|
- 🔧 [提交代码](./Contributing)
|
||
|
|
|
||
|
|
### 社区资源
|
||
|
|
- [GitHub Discussions](../../discussions) - 讨论和交流
|
||
|
|
- [示例项目](./Examples) - 实际使用案例
|
||
|
|
- [最佳实践](./Best-Practices) - 经验分享
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
**开始使用？** 👉 [安装指南](./Installation)
|