Notion2API 管理界面使用指南

概述

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

访问管理界面

启动应用后，在浏览器中访问：
```
http://localhost:3000/admin
```
使用管理员账号登录：
- 默认用户名：admin
- 默认密码：您的 ADMIN_PASSWORD 环境变量值（如未设置，则使用 AUTH_TOKEN 的值）

可以通过环境变量自定义管理员凭据：

ADMIN_USERNAME=your_username
ADMIN_PASSWORD=your_password

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

功能介绍

1. 仪表板统计

界面顶部显示三个关键指标：

总Cookie数：系统中所有Cookie的总数
有效Cookie数：当前可用的Cookie数量
已配置ThreadID：已设置Thread ID的Cookie数量

2. Cookie管理

查看Cookie列表

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

添加新Cookie

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

编辑Thread ID

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

删除Cookie

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

刷新状态

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

3. 操作日志

界面底部显示所有操作的实时日志，包括：

Cookie的添加、删除、更新操作
系统状态变化
错误信息

Thread ID 管理

什么是Thread ID？

Thread ID 是Notion AI对话的会话标识符。使用固定的Thread ID可以：

保持对话上下文的连续性
避免重复创建新会话
提高响应效率

最佳实践

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

安全注意事项

认证令牌：请妥善保管您的AUTH_TOKEN，它是访问管理界面的唯一凭证
Cookie安全：Cookie包含敏感信息，请勿在公共网络环境下使用管理界面
定期更新：建议定期更新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获取方法。

移动端支持

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

移动端特性

响应式布局
- 自适应屏幕大小
- 优化的触摸操作
- 简化的表格显示
移动端操作
- 点击"三点"按钮查看更多操作
- 支持查看Cookie详情
- 底部浮动操作栏方便快速操作
优化的交互
- 大尺寸触摸目标
- 防止输入框缩放
- 流畅的滚动体验

移动端使用建议

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

技术支持

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