Update README.md

README.md

@@ -8,204 +8,209 @@ sdk_version: "4.0"
 app_file: app.py
 pinned: false
 ---
+# WordPress for Hugging Face Spaces
 
-# WordPress with SQLite for Hugging Face Spaces
+这是一个专门为 Hugging Face Spaces 优化的 WordPress 部署方案，采用单容器架构，使用 SQLite 数据库，并包含自动文件清理功能。
 
-这是一个专为 Hugging Face Spaces 设计的 WordPress 项目，使用 SQLite 数据库和 GitHub 自动备份功能。
+## 🚀 特性
 
-## 🚀 快速部署到 Hugging Face Space
+- **单容器部署**: 无需复杂的多容器编排
+- **SQLite 数据库**: 轻量级，无需单独的数据库服务器
+- **自动清理**: 自动删除超过1年的文件，保持存储空间整洁
+- **性能优化**: 针对 Hugging Face Spaces 环境优化
+- **安全配置**: 内置安全最佳实践
+- **监控面板**: 实时查看清理统计和系统状态
+
+## 📋 系统要求
+
+- Hugging Face Spaces (Docker 环境)
+- 最小 2GB RAM
+- 最小 10GB 存储空间
+
+## 🛠️ 部署步骤
 
 ### 1. 创建 Hugging Face Space
 
 1. 访问 [Hugging Face Spaces](https://huggingface.co/spaces)
 2. 点击 "Create new Space"
-3. 选择以下配置：
-   - **SDK**: `Docker`
-   - **Hardware**: `CPU basic` (推荐) 或更高
-   - **Visibility**: 根据需要选择
+3. 选择 "Docker" 作为 SDK
+4. 设置 Space 名称和可见性
 
-### 2. 上传项目文件
+### 2. 上传文件
+
+将以下文件上传到你的 Space 仓库：
 
-将以下文件上传到你的 Space：
 ```
-Dockerfile
-app.py
-requirements.txt
-config/wp_php.ini
-.dockerignore (可选)
-spaces.yml (可选)
+├── Dockerfile
+├── wp-config.php
+├── monitor-cleanup.sh
+├── .dockerignore
+└── README_SPACES.md
 ```
 
-### 3. 配置环境变量 (可选 - 用于GitHub备份)
+### 3. 自动部署
 
-在 Space 的 Settings 页面添加以下环境变量：
+Hugging Face 会自动检测 Dockerfile 并开始构建部署。
 
-- `GITHUB_TOKEN`: 你的 GitHub Personal Access Token
-- `GITHUB_REPO`: GitHub 仓库路径 (格式: `username/repository-name`)
+## 🔧 配置说明
 
-#### 创建 GitHub Token:
-1. 访问 GitHub Settings > Developer settings > Personal access tokens
-2. 创建新 token，需要以下权限：
-   - `repo` (完整仓库访问权限)
-   - `contents:write` (写入仓库内容)
+### 数据库配置
 
-#### 准备 GitHub 仓库:
-1. 创建一个新的 GitHub 仓库用于存储备份
-2. 在仓库中创建 `backups` 文件夹
+- **类型**: SQLite
+- **位置**: `/var/www/html/wp-content/database/wordpress.db`
+- **自动备份**: 每日备份到日志目录
 
-### 4. 启动 Space
+### 自动清理配置
 
-保存设置后，Space 会自动构建和启动。首次构建需要 5-10 分钟。
+在 `wp-config.php` 中可以调整以下设置：
 
-## 🏠 本地开发部署
+```php
+// 文件保留期限（天数）
+define('FILE_RETENTION_DAYS', 365); // 1年
 
-如果你想在本地开发环境中运行此项目：
+// 清理功能开关
+define('AUTO_CLEANUP_ENABLED', true);
+```
 
-### 使用 Docker Compose
+### 清理策略
 
-```bash
-# 克隆或下载项目
-git clone <your-repo-url>
-cd wordpress-docker-compose-master
+自动清理脚本会处理以下内容：
 
-# 构建并启动
-docker-compose up --build
+1. **上传文件**: 删除超过1年的媒体文件
+2. **缓存文件**: 清理过期的缓存
+3. **临时文件**: 删除临时和备份文件
+4. **日志文件**: 压缩和清理旧日志
+5. **空目录**: 删除空的目录结构
 
-# 或者在后台运行
-docker-compose up -d --build
-```
+### 排除规则
 
-### 使用 Docker 直接构建
+以下文件类型不会被自动删除：
+- 数据库文件 (*.db, *.sql)
+- 配置文件 (wp-config.php, .htaccess)
+- 核心文件 (index.php)
+- 当前日志文件
 
-```bash
-# 构建镜像
-docker build -t wordpress-sqlite .
+## 📊 监控功能
 
-# 运行容器
-docker run -p 7860:7860 wordpress-sqlite
-```
+### 管理面板统计
 
-### 本地开发配置
+登录 WordPress 管理后台后，在仪表板可以看到：
+- 最近清理记录
+- 删除文件统计
+- 磁盘使用情况
+- 系统性能指标
 
-- 数据持久化：使用 Docker volumes 保存数据
-- 主题开发：可以挂载本地主题目录
-- 插件开发：可以挂载本地插件目录
-- 配置文件：可以修改 `config/wp_php.ini`
+### 日志查看
 
-## 🔧 功能特性
+清理日志保存在 `/var/log/wordpress/cleanup.log`，包含：
+- 清理时间和结果
+- 删除的文件列表
+- 系统资源使用情况
+- 错误和警告信息
 
-### ✅ SQLite 数据库
-- 无需外部数据库服务
-- 数据存储在 `/var/www/html/wp-content/database/`
-- 自动配置 SQLite Integration 插件
+## 🔒 安全特性
 
-### ✅ GitHub 自动备份
-- **启动时恢复**: Space 重启时自动从 GitHub 加载最近 30 天的备份
-- **手动备份**: 可以手动运行备份脚本
-- **备份内容**: SQLite 数据库 + 上传文件
+- **文件编辑禁用**: 禁止在后台编辑文件
+- **XML-RPC 禁用**: 防止 XML-RPC 攻击
+- **登录限制**: 限��登录尝试次数
+- **调试模式**: 生产环境禁用调试输出
+- **文件权限**: 严格的文件权限控制
 
-### ✅ Hugging Face Space 优化
-- 端口 7860 (HF Space 标准端口)
-- 内存优化配置
-- 健康检查支持
+## ⚡ 性能优化
 
-## 📖 使用说明
+- **内存限制**: 256MB PHP 内存限制
+- **上传限制**: 64MB 文件上传限制
+- **自动保存**: 5分钟自动保存间隔
+- **修订控制**: 限制文章修订版本数量
+- **垃圾清理**: 30天自动清空垃圾箱
 
-### 访问 WordPress
+## 🚨 故障排除
 
-**Hugging Face Space:**
-- **前台**: `https://your-space-name.hf.space/`
-- **后台**: `https://your-space-name.hf.space/wp-admin/`
+### 常见问题
 
-**本地开发:**
-- **前台**: `http://localhost:7860/`
-- **后台**: `http://localhost:7860/wp-admin/`
+1. **数据库连接错误**
+   - 检查 SQLite 插件是否正确安装
+   - 确认数据库目录权限正确
 
-### 初次设置
+2. **文件上传失败**
+   - 检查上传目录权限
+   - 确认磁盘空间充足
 
-1. 访问你的 Space URL
-2. 按照 WordPress 安装向导完成设置
-3. 创建管理员账户
-4. 开始使用 WordPress
+3. **清理脚本不工作**
+   - 检查 cron 服务状态
+   - 查看清理日志文件
 
-### 手动备份到 GitHub
+### 调试模式
 
-如果配置了 GitHub 环境变量，可以手动创建备份：
+如需启用调试模式，在 `wp-config.php` 中修改：
+
+```php
+define('WP_DEBUG', true);
+define('WP_DEBUG_DISPLAY', true);
+```
+
+### 手动清理
+
+如需手动执行清理：
 
 ```bash
-# 在 Space 的终端中运行
-/usr/local/bin/backup-wordpress.sh
+# 进入容器
+docker exec -it <container_name> /bin/bash
+
+# 执行清理脚本
+/scripts/monitor-cleanup.sh
 ```
 
-## 🔍 故障排除
+## 📈 使用建议
 
-### 1. Space 无法启动
-- 检查 Dockerfile 语法
-- 确认端口设置为 7860
-- 查看构建日志中的错误信息
+### 内容管理
 
-### 2. WordPress 显示 403 错误
-- 等待容器完全启动 (1-2 分钟)
-- 检查健康检查状态
-- 确认 SQLite 插件正确安装
+1. **定期备份**: 虽然有自动清理，建议定期导出重要内容
+2. **媒体优化**: 上传前压缩图片，减少存储占用
+3. **插件选择**: 选择轻量级插件，避免资源密集型插件
 
-### 3. GitHub 备份失败
-- 验证 `GITHUB_TOKEN` 和 `GITHUB_REPO` 环境变量
-- 确认 GitHub Token 有正确权限
-- 检查仓库中是否存在 `backups` 文件夹
+### 性能监控
 
-### 4. 数据丢失
-- Space 重启时会自动尝试从 GitHub 恢复备份
-- 手动恢复：将备份文件解压到相应目录
+1. **定期检查**: 查看管理面板的清理统计
+2. **磁盘监控**: 关注磁盘使用率警告
+3. **日志分析**: 定期查看清理日志
 
-## 📁 项目结构
+### 安全维护
 
-```
-.
-├── Dockerfile                    # Docker 构建文件 (HF Space)
-├── app.py                       # HF Space 入口文件
-├── requirements.txt             # Python 依赖 (HF Space)
-├── spaces.yml                   # HF Space 配置
-├── README.md                    # 项目说明
-├── DEPLOYMENT_GUIDE.md          # 部署指南
-├── docker-compose.yml           # Docker Compose (SQLite)
-├── docker-compose.local.yml     # 本地开发配置
-├── docker-compose.mysql.yml     # MySQL 版本 (备份)
-├── config/
-│   ├── wp_php.ini              # PHP 配置
-│   └── pma_php.ini             # phpMyAdmin 配置 (MySQL版本)
-├── .dockerignore               # Docker 忽略文件
-└── env.example                 # 环境变量示例 (MySQL版本)
-```
+1. **定期更新**: 保持 WordPress 和插件更新
+2. **密码安全**: 使用强密码和双因素认证
+3. **访问控制**: 限制管理员账户数量
+
+## 🔄 更新和维护
+
+### 更新 WordPress
 
-## 🔒 安全注意事项
+由于使用 Docker 镜像，WordPress 更新需要重新构建镜像：
 
-1. **GitHub Token 安全**:
-   - 使用最小权限原则
-   - 定期轮换 Token
-   - 不要在代码中硬编码 Token
+1. 更新 Dockerfile 中的 WordPress 版本
+2. 重新部署 Space
 
-2. **WordPress 安全**:
-   - 使用强密码
-   - 定期更新 WordPress 和插件
-   - 限制管理员访问
+### 配置更新
 
-3. **备份安全**:
-   - 备份仓库设为私有
-   - 定期检查备份完整性
+修改配置文件后，需要重新部署：
 
-## 📝 更新日志
+1. 更新相应的配置文件
+2. 提交到 Git 仓库
+3. Hugging Face 会自动重新部署
 
-- **v1.0.0**: 初始版本，支持 SQLite 和 GitHub 备份
+## 📞 支持
 
-## 🤝 贡献
+如遇到问题，可以：
 
-欢迎提交 Issue 和 Pull Request！
+1. 查看 Hugging Face Spaces 文档
+2. 检查容器日志
+3. 参考 WordPress 官方文档
+4. 在 GitHub 上提交 Issue
 
 ## 📄 许可证
 
-本项目采用 MIT 许可证。详见 [LICENSE](LICENSE) 文件。
+本项目遵循原项目的许可证条款。
 
 ---
 
-**注意**: 这是一个为 Hugging Face Spaces 特别��化的 WordPress 部署方案。如果你需要在其他平台部署，可能需要调整配置。
+**注意**: 这是一个实验性部署方案，建议在生产环境使用前进行充分测试。