diff --git a/src/api/README.md b/src/api/README.md
new file mode 100644
index 0000000..d5a3076
--- /dev/null
+++ b/src/api/README.md
@@ -0,0 +1,241 @@
+# 小说网站 API 接口文档
+
+本项目基于提供的 Swagger API 文档创建了完整的前端接口调用封装。
+
+## 📁 文件结构
+
+```
+src/api/
+├── index.js # axios 基础配置
+├── auth.js # 授权登录相关接口
+├── home.js # 首页相关接口
+├── bookshelf.js # 书架相关接口（阅读书架、我的作品、读者成就）
+├── user.js # 用户相关接口（流水、评论、任务、申请作家、礼物订阅）
+├── modules.js # 统一导出所有API模块
+├── example.js # 使用示例
+├── types.ts # TypeScript 类型定义
+├── api.json # 原始 Swagger 文档
+└── README.md # 本文档
+```
+
+## 🚀 快速开始
+
+### 1. 基础配置
+
+项目已配置好 axios 实例，自动处理：
+- ✅ X-Access-Token 认证头
+- ✅ 统一的响应格式处理
+- ✅ 错误处理和401重定向
+- ✅ 请求超时设置
+
+### 2. 使用方式
+
+#### 方式一：按需导入
+```javascript
+import { authApi, homeApi, commentApi } from '@/api/modules.js';
+
+// 用户登录
+const loginResult = await authApi.appletLogin(loginData);
+
+// 获取首页banner
+const banner = await homeApi.getBanner();
+
+// 发表评论
+await commentApi.saveComment({ bookId: '123', content: '很棒的小说！' });
+```
+
+#### 方式二：全量导入
+```javascript
+import api from '@/api/modules.js';
+
+// 使用方式
+const books = await api.myBook.getMyShopPage({ pageNo: 1, pageSize: 10 });
+const userInfo = await api.auth.getUserByToken();
+```
+
+### 3. 在 Vue 组件中使用
+
+```vue
+
+
+
加载中...
+
{{ error }}
+
+
+
+
目录
-
+
+
+