# IT资讯自动化系统部署指南

## 📋 系统概述

IT资讯自动化系统是一个集成了网页抓取、内容处理、邮件发送和小红书发布的自动化系统。

## 🗂️ 目录结构

```
it_automation/
├── scripts/                    # 脚本文件
│   ├── main_scheduler_template.sh     # 主调度脚本模板
│   ├── enhanced_crawler_template.py   # 网页抓取模板
│   ├── content_converter_fixed.py     # 内容转换器
│   └── humanizer_cn.py                # 中文去AI化工具
├── config_templates/           # 配置模板
│   └── config_template.json    # 配置文件模板
├── docs/                       # 文档
│   └── DEPLOYMENT_GUIDE.md     # 本文件
└── .gitignore                  # Git忽略规则
```

## 🔧 部署步骤

### 1. 环境准备

```bash
# 安装Python依赖
pip3 install requests beautifulsoup4 sqlite3

# 安装小红书CLI（如果需要）
# 参考: https://github.com/your-repo/xiaohongshu-cli
```

### 2. 配置文件设置

1. 复制配置模板：
   ```bash
   cp config_templates/config_template.json config.json
   ```

2. 编辑 `config.json`，替换以下变量：
   - `{{WORK_DIR}}` - 工作目录路径
   - `{{DATABASE_PATH}}` - SQLite数据库路径
   - `{{COOKIE_FILE_PATH}}` - 小红书Cookie文件路径
   - `{{EMAIL_USERNAME}}` - 邮箱用户名
   - `{{EMAIL_PASSWORD}}` - 邮箱密码
   - `{{DEEPSEEK_API_KEY}}` - DeepSeek API密钥

### 3. 脚本配置

1. 编辑 `scripts/main_scheduler_template.sh`：
   ```bash
   # 替换以下变量
   WORK_DIR="/your/actual/work/dir"
   XHS_SKILL_DIR="/your/xiaohongshu/skill/dir"
   LOG_DIR="/your/log/dir"
   ```

2. 重命名脚本：
   ```bash
   mv scripts/main_scheduler_template.sh scripts/main_scheduler.sh
   chmod +x scripts/main_scheduler.sh
   ```

### 4. 敏感文件处理

**重要：以下文件不应提交到Git仓库**

1. **Cookie文件**：保持原位置，通过软链接引用
2. **数据库文件**：在工作目录中创建
3. **环境变量**：使用 `.env` 文件（已添加到.gitignore）

### 5. 定时任务设置

```bash
# 编辑crontab
crontab -e

# 添加以下行（每天16:00执行）
0 16 * * * /bin/bash /path/to/it_automation/scripts/main_scheduler.sh
```

## ⚠️ 安全注意事项

### 绝对不能提交的文件：
- `*.cookies.*` - Cookie文件
- `*.env` - 环境变量文件
- `config.json` - 包含敏感信息的配置文件
- `*.log` - 日志文件
- `*.db` - 数据库文件

### 安全建议：
1. 使用环境变量存储敏感信息
2. 定期更新Cookie
3. 监控系统日志
4. 定期备份数据库

## 🔍 故障排除

### 常见问题：

1. **脚本权限问题**：
   ```bash
   chmod +x scripts/*.sh scripts/*.py
   ```

2. **Python依赖问题**：
   ```bash
   pip3 install -r requirements.txt
   ```

3. **路径问题**：
   - 检查所有脚本中的路径配置
   - 确保目录存在且有写入权限

4. **小红书发布失败**：
   - 检查Cookie是否过期
   - 检查网络连接
   - 查看详细日志

## 📞 支持

如有问题，请检查：
1. 系统日志：`logs/` 目录
2. 错误信息：脚本输出
3. 文档更新：查看最新版本

---

**最后更新：2026-03-19**
**版本：1.0.0**