# 阅读器应用使用说明
## 应用简介
阅读器是一款功能丰富的在线文本阅读工具，支持多种文本格式和个性化阅读体验。应用已部署在：[http://api.afmax.cn/use/novel/index.php](http://api.afmax.cn/use/novel/index.php)
## 核心功能
### 1. 文本来源
- URL加载：直接输入文本文件的URL地址加载内容
- 本地文件：上传本地文本文件进行阅读
- 支持格式：TXT、Markdown、HTML、JSON等文本格式
### 2. 个性化阅读设置
- 字体设置：调整字体大小、颜色和字体类型
- 背景设置：选择背景色或上传自定义背景图片
- 阅读模式：支持夜间模式和日间模式切换
- 翻页方式：左右翻页或上下滚动两种模式
### 3. 阅读体验增强
- 搜索功能：全文搜索并高亮显示结果
- 阅读记录：自动保存阅读进度，支持继续阅读
- 章节列表：支持通过清单文件加载多个章节
- 阅读统计：显示字数统计和预计阅读时间
## 使用方法
### 基本使用流程
1. 打开应用：访问 [http://api.afmax.cn/use/novel/index.php](http://api.afmax.cn/use/novel/index.php)
2. 选择文本来源：
- URL：在"文本URL"输入框中输入文本文件的URL地址
- 本地文件：点击"选择文件"按钮上传本地文本文件
3. 点击"加载内容"按钮开始阅读
4. 根据需要调整阅读设置，如字体大小、背景色等
### 高级功能使用
#### URL参数加载
应用支持通过URL参数直接加载内容：
- 加载单个文档http://api.afmax.cn/use/novel/index.php?r=文件URL
- 示例http://api.afmax.cn/use/novel/index.php?r=https://example.com/book.txt
- 加载章节清单http://api.afmax.cn/use/novel/index.php?list=清单文件URL
- 清单文件格式：每行包含"标题:URL"
- 示例http://api.afmax.cn/use/novel/index.php?list=https://example.com/chapters.txt
- 加载自定义样式http://api.afmax.cn/use/novel/index.php?css=CSS文件URL
- 示例http://api.afmax.cn/use/novel/index.php?css=https://example.com/custom.css
- 组合使用http://api.afmax.cn/use/novel/index.php?r=https://example.com/book.txt&css=https://example.com/custom.css
#### 搜索功能
1. 在左侧菜单的"搜索文本"输入框中输入关键词
2. 点击"搜索"按钮或按Enter键
3. 搜索结果将高亮显示，并显示结果数量
4. 使用"上一个"和"下一个"按钮导航搜索结果
5. 点击"×"按钮清除搜索结果
#### 阅读记录
1. 应用会自动保存您的阅读记录
2. 在左侧菜单的"阅读记录"区域可以查看历史阅读记录
3. 点击记录项可以继续阅读
4. 点击"清除记录"按钮可以删除所有阅读记录
5. 点击"继续阅读"按钮可以恢复最近一次的阅读
## 代理设置
由于浏览器的跨域限制，加载远程URL时可能需要使用代理：
1. 在左侧菜单的"CORS代理"下拉菜单中选择代理方式：
- 默认代理：使用内置的代理服务器
- 直连模式：不使用代理（可能无法加载跨域内容）
- 自定义代理：输入您自己的代理服务器URL
## 快捷键
- 左右翻页：←（上一页）、→（下一页）
- 搜索：在搜索框中按Enter键
- 菜单切换：无快捷键，点击"菜单"按钮
## 注意事项
1. 隐私保护：本地文件不会上传到服务器，仅在浏览器本地处理
2. 存储限制：阅读记录和设置保存在浏览器的本地存储中，清除浏览器数据会导致这些信息丢失
3. 性能考虑：过大的文本文件可能会影响加载速度和阅读体验
4. 兼容性：建议使用现代浏览器，如Chrome、Firefox、Edge等
## 常见问题
### Q: 无法加载URL内容怎么办？
A: 尝试切换不同的代理设置，或者将文件下载到本地后通过"本地文件"方式加载。
### Q: 阅读记录丢失了怎么办？
A: 阅读记录存储在浏览器的localStorage中，如果清除了浏览器数据，记录将无法恢复。
### Q: 如何自定义背景图片？
A: 在左侧菜单的"背景图片"区域，点击"上传背景图"按钮选择本地图片文件。
### Q: 如何调整字体大小？
A: 在左侧菜单的"字体大小"区域，点击"A-"（减小）、"A"（默认）、"A+"（增大）按钮。
### Q: 我的网站网址无法使用直链模式
A:你没有在网站上声明api可以调用你的资源，导致api的请求被浏览器拦截，你在 server 块内、所有 location 块之前添加以下 CORS 配置，确保对所有请求生效：
# 1. 允许指定源（api.afmax.cn）跨域
add_header Access-Control-Allow-Origin "https://api.afmax.cn" always;
# 2. 明确允许 GET、OPTIONS、HEAD 三种方法（OPTIONS 是预检请求必需）
add_header Access-Control-Allow-Methods "GET, OPTIONS, HEAD" always;
# 3. 允许请求携带常见基础头（适配多数场景，可按需增减）
add_header Access-Control-Allow-Headers "Origin, X-Requested-With, Content-Type, Accept" always;
# 4. 处理 OPTIONS 预检请求（直接返回 204，避免冗余处理）
if ($request_method = 'OPTIONS') {
return 204;
}
ps:还是不会的话，把你的配置文件发给AI，跟他说增加一个同意api.afmax.cn跨域cors的get请求，生成好后复制到服务器上即可