api-box/README.md

# api-box

🔩 各大 LLM 厂商的 API 服务聚合

## 任务清单

| 任务编号 | 任务名称                          | 优先级 | 说明                                                                 | 负责人   | 交付成果                           |
|----------|----------------------------------|--------|----------------------------------------------------------------------|----------|--------------------------------|
| T1       | 明确需求并撰写 PRD 文档           | 高     | 完成产品需求文档，明确功能及非功能需求                             | 产品     | 🟢 PRD 文档（含厂商列表、功能说明等）         |
| T2       | 确定支持厂商并获取 API 信息       | 高     | 确认 5 个主流 AI API 厂商的端点、密钥类型和请求格式                | 产品     | 🟢 完整厂商支持列表（含 API 示例）          |
| T3       | 搭建 Web 应用的基础架构（HTML/CSS/JS） | 中     | 创建 Web 首页和配置页、对话页，切换页面（可使用单页应用）          | 开发     | 🔵 项目框架（HTML + CSS + 前端基础）     |
| T4       | 实现厂商下拉选择功能              | 高     | 列出厂商选项，用户可选当前要配置的厂商                               | 开发     | 🔵 下拉菜单 + 厂商动态展示               |
| T5       | 实现 API 配置输入界面             | 高     | 根据所选厂商显示对应输入项（如密钥 + 接入点）                        | 开发     | 🔵 动态表单（密钥/接入点输入）              |
| T6       | 实现密钥输入验证                  | 高     | 检查输入格式是否符合厂商要求（如 OpenAI 密钥以 `sk-` 开头）         | 开发     | 🔵 格式校验 + 错误提示                 |
| T7       | 实现配置保存与加密存储            | 高     | 加密存储用户输入的密钥和接入点，使用 localStorage 或 indexedDB    | 开发     | 🔵 安全存储实现（AES 加密）              |
| T8       | 创建厂商配置数据结构              | 中     | 在前端代码中定义厂商配置信息（如 ID、名称、端点、字段等）             | 开发     | 🔵 `PLATFORMS` 配置数组（如 JS 对象结构） |
| T9       | 实现对话页界面                    | 中     | 输入框 + 厂商选择器 + 发送按钮 + 响应展示区                         | 开发     | 🔵 对话页面设计 + 基本交互               |
| T10      | 实现对话 API 调用逻辑             | 高     | 根据用户选择的厂商，使用对应密钥调用 AI API 并返回结果               | 开发     | 🔵 厂商 API 通信逻辑（POST 请求）        |
| T11      | 实现响应展示与错误处理            | 高     | 显示 API 返回内容，处理 401、500 等错误信息                         | 开发     | 🔵 响应展示模块 + 错误页/提示             |
| T12      | 添加「重试」机制（可选）          | 中     | 对于调用失败的情况提供一键重试功能                                | 开发     | 🔵 调用失败后支持重试按钮                 |
| T13      | 构建配置页与对话页的切换逻辑      | 中     | 用户可切换配置页和对话页，保证数据在页面间同步（如密钥已保存则自动填充） | 开发     | 🔵 页面切换功能 + 自动填充已有配置           |
| T14      | 添加「首次未配置提醒」            | 中     | 如果没有配置任何厂商，引导用户进行配置                             | 开发     | 🔵 首页友好提示信息                    |
| T15      | 添加厂商配置删除功能              | 中     | 允许用户删除已有配置，避免冗余数据                               | 开发     | 🔵 删除配置按钮 + localStorage 清理    |
| T16      | 添加厂商默认配置（可选）          | 中     | 预设 OpenAI、通义等厂商的默认接入点和字段提示                     | 开发     | 🔵 配置页面默认值设置                   |
| T17      | 构建完整 UI 界面（风格统一）      | 中     | 确保配置页和对话页操作一致、视觉统一                             | UI / 前端 | 🔵 响应式设计 + 现代化界面               |
| T18      | 进行基本可用性测试                | 中     | 验证主要功能是否可用（配置保存、API 调用、错误提示等）               | QA       | 🔵 功能测试报告（手动/自动）               |
| T19      | 添加部署方案（如 GitHub Pages）  | 低     | 配置前端静态部署，便于快速访问                                  | 产品     | 🔵 部署文档 + 示例部署链接               |
| T20      | 撰写项目说明文档和使用教程        | 低     | 提供给用户快速上手的说明，包含配置方法和常见问题                 | 产品     | 🔵 README 或使用指南文档              |
| T21      | 优化体验（如加载提示、输入缓存）  | 低     | 提升用户体验，如加载动画、输入自动保存（可选）                     | 开发     | 🔵 更流畅、更友好的 UI 交互              |
| T22      | 收集用户反馈并迭代设计            | 低     | 收集可用性数据、建议，优化方案（可选）                             | 产品     | 🔵 用户反馈记录 + 迭代计划               |