# Notion2API 管理界面使用指南

## 概述

Notion2API 提供了一个美观、易用的Web管理界面，用于管理Cookie和Thread ID配置。

## 访问管理界面

1. 启动应用后，在浏览器中访问：
   ```
   http://localhost:3000/admin
   ```

2. 使用管理员账号登录：
   - 默认用户名：`admin`
   - 默认密码：您的 `ADMIN_PASSWORD` 环境变量值（如未设置，则使用 `AUTH_TOKEN` 的值）
   
3. 可以通过环境变量自定义管理员凭据：
   ```
   ADMIN_USERNAME=your_username
   ADMIN_PASSWORD=your_password
   ```

4. 登录成功后会保存会话，24小时内无需重复登录

## 功能介绍

### 1. 仪表板统计

界面顶部显示三个关键指标：
- **总Cookie数**：系统中所有Cookie的总数
- **有效Cookie数**：当前可用的Cookie数量
- **已配置ThreadID**：已设置Thread ID的Cookie数量

### 2. Cookie管理

#### 查看Cookie列表
- 表格显示所有Cookie的详细信息
- 包括用户ID、空间ID、状态、最后使用时间和Thread ID
- 有效的Cookie显示绿色状态指示器

#### 添加新Cookie
1. 点击"添加Cookie"按钮
2. 在弹出的对话框中输入Cookie内容
3. 可选：输入Thread ID（必须手动获取，系统不会自动创建）
4. 支持批量添加（使用 | 分隔多个Cookie）

#### 编辑Thread ID
1. 点击Cookie行中的编辑按钮（铅笔图标）
2. 在弹出的对话框中修改Thread ID
3. 留空表示不使用特定的Thread ID

#### 删除Cookie
1. 点击Cookie行中的删除按钮（垃圾桶图标）
2. 确认删除操作

#### 刷新状态
- 点击"刷新状态"按钮重新验证所有Cookie的有效性

### 3. 操作日志

界面底部显示所有操作的实时日志，包括：
- Cookie的添加、删除、更新操作
- 系统状态变化
- 错误信息

## Thread ID 管理

### 什么是Thread ID？

Thread ID 是Notion AI对话的会话标识符。使用固定的Thread ID可以：
- 保持对话上下文的连续性
- 避免重复创建新会话
- 提高响应效率

### 最佳实践

1. **新用户**：Thread ID需要从现有的Notion对话中手动获取
2. **保持上下文**：如果需要保持对话连续性，记录并复用Thread ID
3. **重置对话**：不使用Thread ID即可开始新的对话会话

## 安全注意事项

1. **认证令牌**：请妥善保管您的AUTH_TOKEN，它是访问管理界面的唯一凭证
2. **Cookie安全**：Cookie包含敏感信息，请勿在公共网络环境下使用管理界面
3. **定期更新**：建议定期更新Cookie以确保服务的稳定性

## 常见问题

### Q: 为什么Cookie显示为无效？
A: Cookie可能已过期或被Notion撤销。请获取新的Cookie并更新。

### Q: Thread ID应该多久更换一次？
A: 除非遇到问题或需要重置对话上下文，否则可以一直使用同一个Thread ID。

### Q: 如何获取Thread ID？
A: Thread ID需要从Notion的现有对话中手动获取，系统不会自动创建。您可以通过浏览器开发者工具查看Notion AI对话的网络请求来获取。

### Q: 可以同时使用多个Cookie吗？
A: 是的，系统支持多Cookie轮询，可以提高请求的稳定性和效率。

### Q: 如何获取Notion Cookie？
A: 请参考主文档中的Cookie获取方法。

## 移动端支持

管理界面已针对移动设备进行了全面优化：

### 移动端特性

1. **响应式布局**
   - 自适应屏幕大小
   - 优化的触摸操作
   - 简化的表格显示

2. **移动端操作**
   - 点击"三点"按钮查看更多操作
   - 支持查看Cookie详情
   - 底部浮动操作栏方便快速操作

3. **优化的交互**
   - 大尺寸触摸目标
   - 防止输入框缩放
   - 流畅的滚动体验

### 移动端使用建议

1. **横屏模式**：在查看完整信息时，可以使用横屏模式
2. **快速操作**：使用底部操作栏进行刷新和添加操作
3. **详情查看**：点击"更多操作"→"查看详情"查看完整Cookie信息

## 技术支持

如遇到问题，请查看操作日志中的错误信息，或查看服务器控制台输出。