yeyin/KatelyaTV
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

fix: 修复文档格式和内容，确保成人内容过滤功能配置说明清晰

Browse Source
This commit is contained in:
katelya
2025-09-04 22:56:06 +08:00
parent db08179eb0
commit 9a5564b3cf
3 changed files with 42 additions and 29 deletions
Download Patch File Download Diff File Expand all files Collapse all files
CLOUDFLARE_PAGES_ADULT_FILTER.md
+9
View File
@@ -20,6 +20,7 @@ wrangler d1 create katelyatv-db
``` ```
记录输出的数据库 ID，类似： 记录输出的数据库 ID，类似：
``` ```
✅ Successfully created DB 'katelyatv-db' in region APAC ✅ Successfully created DB 'katelyatv-db' in region APAC
Created your database using D1's new storage backend. Created your database using D1's new storage backend.
@@ -112,11 +113,13 @@ wrangler pages deploy .vercel/output/static --project-name katelyatv
### 错误："获取用户设置失败" ### 错误："获取用户设置失败"
**可能原因**： **可能原因**：
- 未配置 D1 数据库 - 未配置 D1 数据库
- `NEXT_PUBLIC_STORAGE_TYPE` 未设置为 `d1` - `NEXT_PUBLIC_STORAGE_TYPE` 未设置为 `d1`
- 数据库中缺少 `user_settings` 表 - 数据库中缺少 `user_settings` 表
**解决方案**： **解决方案**：
1. 检查环境变量配置 1. 检查环境变量配置
2. 验证 D1 数据库绑定 2. 验证 D1 数据库绑定
3. 执行数据库迁移： 3. 执行数据库迁移：
@@ -127,10 +130,12 @@ wrangler pages deploy .vercel/output/static --project-name katelyatv
### 错误：D1 数据库连接失败 ### 错误：D1 数据库连接失败
**可能原因**： **可能原因**：
- wrangler.toml 中的数据库配置错误 - wrangler.toml 中的数据库配置错误
- Cloudflare Pages 中的 D1 绑定未正确配置 - Cloudflare Pages 中的 D1 绑定未正确配置
**解决方案**： **解决方案**：
1. 验证 `wrangler.toml` 中的 database_id 是否正确 1. 验证 `wrangler.toml` 中的 database_id 是否正确
2. 在 Cloudflare Pages Dashboard 中检查 Functions → D1 database bindings 2. 在 Cloudflare Pages Dashboard 中检查 Functions → D1 database bindings
3. 确保绑定的变量名为 `DB` 3. 确保绑定的变量名为 `DB`
@@ -138,10 +143,12 @@ wrangler pages deploy .vercel/output/static --project-name katelyatv
### 错误：构建失败 ### 错误：构建失败
**可能原因**： **可能原因**：
- Node.js 兼容性问题 - Node.js 兼容性问题
- 依赖安装失败 - 依赖安装失败
**解决方案**： **解决方案**：
1. 确保启用了 `nodejs_compat` 兼容性标志 1. 确保启用了 `nodejs_compat` 兼容性标志
2. 检查构建命令是否正确 2. 检查构建命令是否正确
3. 查看构建日志中的具体错误信息 3. 查看构建日志中的具体错误信息
@@ -167,11 +174,13 @@ wrangler pages deploy .vercel/output/static --project-name katelyatv
当项目更新包含数据库结构变更时： 当项目更新包含数据库结构变更时：
1. **备份数据**： 1. **备份数据**：
```bash ```bash
wrangler d1 export katelyatv-db --output backup.sql wrangler d1 export katelyatv-db --output backup.sql
``` ```
2. **执行迁移**： 2. **执行迁移**：
```bash ```bash
wrangler d1 execute katelyatv-db --file=D1_MIGRATION.md的SQL脚本 wrangler d1 execute katelyatv-db --file=D1_MIGRATION.md的SQL脚本
``` ```
D1_MIGRATION.md
+23 -23
View File
@@ -96,30 +96,30 @@ wrangler d1 execute your-database-name --file=./scripts/d1-init.sql
### user_settings 表字段 ### user_settings 表字段
| 字段名 | 类型 | 默认值 | 说明 | | 字段名 | 类型 | 默认值 | 说明 |
| ----------------------- | -------- | ------- | ------------------------- | | ---------------------- | -------- | -------- | ---------------------- |
| `id` | INTEGER | 自增 | 主键 | | `id` | INTEGER | 自增 | 主键 |
| `user_id` | INTEGER | 无 | 用户ID，关联users表 | | `user_id` | INTEGER | 无 | 用户 ID，关联 users 表 |
| `username` | TEXT | 无 | 用户名 | | `username` | TEXT | 无 | 用户名 |
| `filter_adult_content` | BOOLEAN | 1(true) | 成人内容过滤开关 | | `filter_adult_content` | BOOLEAN | 1(true) | 成人内容过滤开关 |
| `theme` | TEXT | 'auto' | 界面主题设置 | | `theme` | TEXT | 'auto' | 界面主题设置 |
| `language` | TEXT | 'zh-CN' | 语言设置 | | `language` | TEXT | 'zh-CN' | 语言设置 |
| `auto_play` | BOOLEAN | 1(true) | 自动播放开关 | | `auto_play` | BOOLEAN | 1(true) | 自动播放开关 |
| `video_quality` | TEXT | 'auto' | 视频质量偏好 | | `video_quality` | TEXT | 'auto' | 视频质量偏好 |
| `created_at` | DATETIME | 当前时间 | 创建时间 | | `created_at` | DATETIME | 当前时间 | 创建时间 |
| `updated_at` | DATETIME | 当前时间 | 更新时间 | | `updated_at` | DATETIME | 当前时间 | 更新时间 |
### skip_configs 表字段 ### skip_configs 表字段
| 字段名 | 类型 | 默认值 | 说明 | | 字段名 | 类型 | 默认值 | 说明 |
| ------------- | -------- | -------- | ------------------------- | | ------------ | -------- | -------- | ------------------------------- |
| `id` | INTEGER | 自增 | 主键 | | `id` | INTEGER | 自增 | 主键 |
| `user_id` | INTEGER | 无 | 用户ID，关联users表 | | `user_id` | INTEGER | 无 | 用户 ID，关联 users 表 |
| `config_key` | TEXT | 无 | 配置键，格式：`source+video_id` | | `config_key` | TEXT | 无 | 配置键，格式：`source+video_id` |
| `start_time` | INTEGER | 0 | 跳过开始时间（秒） | | `start_time` | INTEGER | 0 | 跳过开始时间（秒） |
| `end_time` | INTEGER | 0 | 跳过结束时间（秒） | | `end_time` | INTEGER | 0 | 跳过结束时间（秒） |
| `created_at` | DATETIME | 当前时间 | 创建时间 | | `created_at` | DATETIME | 当前时间 | 创建时间 |
| `updated_at` | DATETIME | 当前时间 | 更新时间 | | `updated_at` | DATETIME | 当前时间 | 更新时间 |
## ✅ 迁移验证 ## ✅ 迁移验证
@@ -144,7 +144,7 @@ PRAGMA table_info(skip_configs);
### 1. "获取用户设置失败" 错误 ### 1. "获取用户设置失败" 错误
**原因**：缺少 `user_settings` 表 **原因**：缺少 `user_settings` 表
**解决**：执行上述迁移SQL，确保user_settings表已创建 **解决**：执行上述迁移 SQL，确保 user_settings 表已创建
### 2. "表已存在" 错误 ### 2. "表已存在" 错误
@@ -153,7 +153,7 @@ PRAGMA table_info(skip_configs);
### 3. 外键约束错误 ### 3. 外键约束错误
**原因**：users表不存在或结构不匹配 **原因**：users 表不存在或结构不匹配
**解决**：确保先运行完整的 `./scripts/d1-init.sql` 初始化脚本 **解决**：确保先运行完整的 `./scripts/d1-init.sql` 初始化脚本
## 📞 需要帮助？ ## 📞 需要帮助？
README.md
+10 -6
View File
@@ -600,27 +600,30 @@ docker run -d \
成人内容过滤功能需要服务器端存储支持，**不能使用 `localstorage` 存储类型**。 成人内容过滤功能需要服务器端存储支持，**不能使用 `localstorage` 存储类型**。
| 部署平台 | 推荐存储类型 | 配置要求 | | 部署平台 | 推荐存储类型 | 配置要求 |
| -------------- | ------------ | ---------------------- | | ---------------- | ------------------- | ------------------------- |
| Docker | `redis` / `kvrocks` | 配置 Redis/Kvrocks 服务器 | | Docker | `redis` / `kvrocks` | 配置 Redis/Kvrocks 服务器 |
| Vercel | `upstash` | 配置 Upstash Redis | | Vercel | `upstash` | 配置 Upstash Redis |
| Cloudflare Pages | `d1` | 配置 D1 数据库 | | Cloudflare Pages | `d1` | 配置 D1 数据库 |
**Cloudflare Pages 特殊配置**： **Cloudflare Pages 特殊配置**：
如果你使用 Cloudflare Pages 部署，**必须配置 D1 数据库**才能使用成人内容过滤功能： 如果你使用 Cloudflare Pages 部署，**必须配置 D1 数据库**才能使用成人内容过滤功能：
1. **创建 D1 数据库**： 1. **创建 D1 数据库**：
```bash ```bash
wrangler d1 create katelyatv-db wrangler d1 create katelyatv-db
``` ```
2. **初始化数据库表**： 2. **初始化数据库表**：
```bash ```bash
wrangler d1 execute katelyatv-db --file=./scripts/d1-init.sql wrangler d1 execute katelyatv-db --file=./scripts/d1-init.sql
``` ```
3. **配置环境变量**： 3. **配置环境变量**：
```bash ```bash
NEXT_PUBLIC_STORAGE_TYPE=d1 NEXT_PUBLIC_STORAGE_TYPE=d1
``` ```
@@ -636,7 +639,8 @@ docker run -d \
**故障排除**： **故障排除**：
- ❌ **错误**："获取用户设置失败" - ❌ **错误**："获取用户设置失败"
- **原因**：使用了 `localstorage` 存储类型，服务器端API无法访问
- **原因**：使用了 `localstorage` 存储类型，服务器端 API 无法访问
- **解决**：按上述要求配置数据库存储 - **解决**：按上述要求配置数据库存储
- ❌ **错误**：过滤开关无法保存 - ❌ **错误**：过滤开关无法保存