一个专业的 Twitter/X.com 智能分析和报告生成系统，采用前后端分离架构，后端使用纯 Node.js 长期运行服务，前端使用 React + TypeScript + Vite 构建现代化 Web 界面。无需复杂的 shell 脚本和 cron 配置，支持一键 Docker 部署。集成推文采集、AI 分析、自动化报告和可视化展示功能。
- ⚡ 纯 Node.js 服务: 移除复杂的 shell 脚本和 cron 依赖
- 🎯 内置任务调度: 使用 Node.js 内置定时器，无需系统 cron 配置
- 🐳 一键 Docker 部署: 轻量化容器镜像，支持 Docker Compose 快速启动
- 🔄 优雅关闭: 支持 SIGINT 和 SIGTERM 信号处理
- 📝 统一日志管理: 集成日志格式，自动清理历史日志
- 🔍 智能推文爬取: 自动爬取指定列表的推文数据，支持批量处理
- 🤖 AI 智能分析: 使用硅基流动API分析推文内容，生成深度洞察
- 📊 自动报告生成: 生成结构化的科技资讯简报，支持多种格式
- 🔐 安全认证: 支持 Cookie 认证和环境变量配置，保障数据安全
- 💾 数据存储: 集成 Supabase 数据库存储，支持数据持久化
- 🔄 数据去重: 智能去重机制避免重复数据，提升数据质量
- 🌐 代理支持: 支持HTTP代理配置，适应不同网络环境
- 📈 性能优化: 支持并发处理和资源限制配置
- 📱 现代化 UI: 基于 React + TypeScript + Vite 构建的响应式界面
- 🎯 实时展示: 实时显示推文数据、分析结果和报告状态
- 📊 数据可视化: 直观展示数据统计和分析图表
- 🔍 搜索过滤: 支持推文内容搜索和多维度过滤
- 📄 报告预览: 在线预览和下载生成的分析报告
- 🎨 主题切换: 支持明暗主题切换，提升用户体验
- 📱 移动适配: 完全响应式设计，支持移动设备访问
- Node.js: 18.0.0 或更高版本
- Chrome/Chromium: 最新稳定版本浏览器
- 内存: 建议 4GB 以上可用内存
- 网络: 稳定的互联网连接（支持代理配置）
- 存储: 至少 2GB 可用磁盘空间
- 数据库: Supabase 账户和项目配置
- AI 服务: 硅基流动 API 密钥
- Node.js: 18.0.0 或更高版本
- 包管理器: pnpm（推荐）、npm 或 yarn
- 浏览器: 现代浏览器（Chrome、Firefox、Safari、Edge）
- 内存: 建议 2GB 以上可用内存
- 存储: 至少 500MB 可用磁盘空间
最简单的部署方式，一键启动所有服务：
# 1. 克隆项目
git clone <repository-url>
cd twitter-ai-reporter
# 2. 配置环境变量
cp .env.example .env
# 编辑 .env 文件，填入必要的配置
# 3. 一键启动服务
docker-compose up -d
# 4. 查看服务状态
docker-compose logs -f twitter-ai-reporter# 使用 npm
npm install
# 或使用 pnpm（推荐）
pnpm install
# 或使用 yarn
yarn installcp .env.example .env
# 编辑 .env 文件，配置必要的环境变量（详见下方配置说明）# 启动长期服务（包含自动任务调度）
npm run serve
# 或者开发模式
npm run dev# 推文爬取服务
node scripts/crawl-tweets.js
# AI 简报生成服务
node scripts/generate-report.js
# 更新登录cookies
node scripts/update-cookies.js# 生成AI简报
npm run generate-report
# 更新登录状态
npm run login
# 测试AI功能
npm run test-ai
# 检查配置
npm run check-configcd frontend# 使用 pnpm（推荐）
pnpm install
# 或使用 npm
npm install
# 或使用 yarn
yarn install# 启动开发服务器（默认端口 5173）
pnpm dev
# 或使用 npm
npm run dev
# 或使用 yarn
yarn dev# 构建生产版本
pnpm build
# 预览构建结果
pnpm preview- React 19: 最新版本的 React 框架
- TypeScript: 类型安全的 JavaScript 超集
- Vite: 快速的前端构建工具
- Tailwind CSS: 实用优先的 CSS 框架
- Lucide React: 现代化的图标库
- 响应式设计: 支持各种设备尺寸
- React Router DOM: 客户端路由管理
- React Hooks: 状态管理和副作用处理
- React Markdown: Markdown 内容渲染
- React Syntax Highlighter: 代码语法高亮
- Gray Matter: Front Matter 解析
frontend/
├── public/ # 静态资源
│ ├── logo.png # 应用图标
│ ├── outputs/ # 报告输出目录
│ └── vite.svg # Vite 图标
├── src/ # 源代码
│ ├── components/ # React 组件
│ │ ├── Navigation.tsx # 导航组件
│ │ └── ... # 其他组件
│ ├── pages/ # 页面组件
│ │ └── ... # 各种页面
│ ├── types/ # TypeScript 类型定义
│ │ └── ... # 类型文件
│ ├── utils/ # 工具函数
│ │ └── ... # 工具文件
│ ├── assets/ # 静态资源
│ ├── App.tsx # 主应用组件
│ ├── App.css # 应用样式
│ ├── main.tsx # 应用入口
│ └── index.css # 全局样式
├── eslint.config.js # ESLint 配置
├── postcss.config.js # PostCSS 配置
├── tailwind.config.js # Tailwind CSS 配置
├── tsconfig.json # TypeScript 配置
├── tsconfig.app.json # 应用 TypeScript 配置
├── tsconfig.node.json # Node.js TypeScript 配置
├── vite.config.ts # Vite 配置
└── package.json # 项目依赖
项目使用现代化的 ESLint 配置，支持：
- TypeScript 类型检查
- React Hooks 规则
- React Refresh 支持
// eslint.config.js
export default defineConfig([
globalIgnores(['dist']),
{
files: ['**/*.{ts,tsx}'],
extends: [
tseslint.configs.recommendedTypeChecked,
// 或使用更严格的规则
tseslint.configs.strictTypeChecked,
],
languageOptions: {
parserOptions: {
project: ['./tsconfig.node.json', './tsconfig.app.json'],
tsconfigRootDir: import.meta.dirname,
},
},
},
])项目包含三个 TypeScript 配置文件：
tsconfig.json: 基础配置tsconfig.app.json: 应用代码配置tsconfig.node.json: Node.js 工具配置
// vite.config.ts
export default defineConfig({
plugins: [react()],
server: {
port: 5173,
host: true,
},
build: {
outDir: 'dist',
sourcemap: true,
},
})- 使用函数式组件和 React Hooks
- 保持组件单一职责
- 使用 TypeScript 进行类型安全
- 遵循 React 最佳实践
- 使用 Tailwind CSS 实用类
- 保持响应式设计
- 遵循设计系统规范
- 运行 ESLint 检查：
pnpm lint - 使用 TypeScript 类型检查：
pnpm build - 遵循项目代码规范
# 启动开发服务器
pnpm dev
# 访问 http://localhost:5173# 构建生产版本
pnpm build
# 预览构建结果
pnpm preview前端应用已集成到 Docker Compose 配置中，支持一键部署：
# 构建并启动前后端服务
docker-compose up -d
# 前端服务将在指定端口提供服务Supabase 数据库配置
# Supabase 项目配置
SUPABASE_URL=your_supabase_url
SUPABASE_ANON_KEY=your_supabase_anon_key
SUPABASE_SERVICE_ROLE_KEY=your_supabase_service_role_keyAI 服务配置
# 硅基流动 API 配置
DEEPSEEK_API_KEY=your_deepseek_api_keyX.com 登录凭据（用于推文爬取）
X_USERNAME=your_x_username
X_PASSWORD=your_x_password
X_EMAIL=your_x_email网络代理配置
# HTTP/HTTPS 代理设置
PROXY_HOST=127.0.0.1
PROXY_PORT=7890
# 注意：当前版本不支持需要认证的代理
# 如需认证代理，请联系开发团队浏览器配置
# Chrome/Chromium 可执行文件路径
# 本地开发环境（macOS）
CHROME_EXECUTABLE_PATH=/Applications/Google Chrome.app/Contents/MacOS/Google Chrome
# Docker环境或Linux
CHROME_EXECUTABLE_PATH=/usr/bin/chromium-browser
# Windows 环境
CHROME_EXECUTABLE_PATH=C:\Program Files\Google\Chrome\Application\chrome.exe性能优化配置
# 并发处理数量
MAX_CONCURRENT=3
# 请求间隔（毫秒）
REQUEST_DELAY=1000
# 超时设置（毫秒）
TIMEOUT=30000
# 日志级别：error, warn, info, debug
LOG_LEVEL=infotwitter-ai-reporter/
├── frontend/ # 🎨 前端应用
│ ├── public/ # 静态资源
│ │ ├── logo.png # 应用图标
│ │ ├── outputs/ # 报告输出目录
│ │ └── vite.svg # Vite 图标
│ ├── src/ # 前端源代码
│ │ ├── components/ # React 组件
│ │ ├── pages/ # 页面组件
│ │ ├── types/ # TypeScript 类型定义
│ │ ├── utils/ # 工具函数
│ │ ├── assets/ # 静态资源
│ │ ├── App.tsx # 主应用组件
│ │ ├── main.tsx # 应用入口
│ │ └── index.css # 全局样式
│ ├── eslint.config.js # ESLint 配置
│ ├── tailwind.config.js # Tailwind CSS 配置
│ ├── tsconfig.json # TypeScript 配置
│ ├── vite.config.ts # Vite 配置
│ └── package.json # 前端依赖配置
├── scripts/ # 🚀 后端执行脚本和核心模块
│ ├── core/ # 核心功能模块
│ │ ├── data/ # 数据处理模块
│ │ │ ├── connectionManager.js # 数据库连接管理
│ │ │ ├── database.js # 数据库操作
│ │ │ └── twitter.js # Twitter 数据处理
│ │ ├── lib/ # 工具库和配置
│ │ │ ├── config.js # 应用配置
│ │ │ ├── proxyValidator.js # 代理验证
│ │ │ ├── timezone.js # 时区工具
│ │ │ └── utils.js # 通用工具
│ │ ├── reports/ # 报告生成模块
│ │ │ ├── config.js # 报告配置
│ │ │ └── generator.js # 报告生成器
│ │ └── services/ # 业务服务模块
│ │ ├── aiService.js # AI 分析服务
│ │ ├── fileService.js # 文件操作服务
│ │ └── tweetService.js # 推文处理服务
│ ├── tasks/ # 执行任务脚本
│ │ ├── crawl-tweets.js # Twitter 数据爬取
│ │ ├── diagnose-proxy.js # 代理诊断
│ │ ├── generate-report.js # AI 简报生成
│ │ └── update-cookies.js # Cookie 认证管理
│ └── tests/ # 🧪 测试文件
│ ├── connection-optimization.js # 连接优化测试
│ ├── proxy-utils.js # 代理工具测试
│ ├── proxy.test.js # 代理功能测试
│ └── supabase-connection.test.js # 数据库连接测试
├── logs/ # 📝 日志文件目录
├── outputs/ # 📊 报告输出目录
├── .env.example # ⚙️ 环境变量模板
├── app.js # 🎯 主应用服务（内置任务调度）
├── start.sh # 启动脚本
├── docker-compose.yml # 容器编排配置
├── Dockerfile.backend # 后端 Docker 镜像配置
├── Dockerfile.frontend # 前端 Docker 镜像配置
├── jest.config.js # 测试配置
└── package.json # 📋 后端项目依赖配置
# 爬取推文数据
node scripts/crawl-tweets.js
# 生成AI分析报告
node scripts/generate-report.js
# 更新登录状态
node scripts/update-cookies.js# 启用调试模式
NODE_ENV=development node scripts/crawl-tweets.js
# 启用详细日志
DEBUG=* node scripts/generate-report.js
# 测试特定功能
npm run test-ai # 测试AI功能
npm run check-config # 检查配置
npm run debug-data-loss # 调试数据问题# 测试代理连接
node tests/testProxy.js
# 验证数据库连接
node -e "require('./src/lib/supabase').testConnection()"
# 运行完整测试套件
npm test项目采用 Node.js 内置定时器实现任务调度，无需配置系统 cron 或 shell 脚本。服务启动后自动按计划执行所有任务。
项目使用 Node.js 内置调度器 进行任务调度，无需依赖系统 cron：
// 在 start.js 中配置调度时间
const SCHEDULE_TIME = process.env.SCHEDULE_TIME || '23:00'; // 默认每天 23:00
// 支持的时间格式
// '23:00' - 每天 23:00
// '*/2 * * * *' - 每 2 分钟（cron 格式）
// '0 */6 * * *' - 每 6 小时- ✅ 内置调度: 无需系统 cron 依赖
- ✅ 容器友好: 完美适配 Docker 环境
- ✅ 灵活配置: 支持环境变量动态配置
- ✅ 自动重启: 任务失败后自动重新调度
- ✅ 状态监控: 实时显示下次执行时间
默认执行时间表：
| 任务 | 时间 | 描述 |
|---|---|---|
| 日志清理 | 每天 02:00 | 清理7天前的日志文件 |
| 上午爬取 | 每天 09:00 | 执行推文爬取任务 |
| 下午爬取 | 每天 16:00 | 执行推文爬取任务 |
| 生成报告 | 每天 23:00 | 生成AI分析报告 |
如需修改任务执行时间，编辑 app.js 文件中的 cron 表达式：
// 例如：改为每天上午8点执行
scheduler.addTask('crawl-tweets-morning', '0 8 * * *', 'npm', ['start']);
// Cron 表达式格式：秒 分 时 日 月 星期
// 0 9 * * * = 每天上午9点
// 0 */6 * * * = 每6小时执行一次
// 0 0 * * 1 = 每周一午夜执行# Docker 环境
docker-compose ps
docker-compose logs -f twitter-ai
docker-compose logs --tail=100 twitter-ai
# 本地环境
ps aux | grep "node.*app.js"
tail -f logs/app.log# Docker 环境
docker-compose restart twitter-ai
docker-compose up -d --build # 重新构建并启动
# 本地环境
# 使用 Ctrl+C 停止服务，然后重新启动
npm run serve# Docker 环境
docker exec twitter-ai-reporter npm start
docker exec twitter-ai-reporter npm run generate-report
# 本地环境
node scripts/crawl-tweets.js
node scripts/generate-report.js- 简化部署: 不需要配置 cron 和 shell 脚本
- 统一日志: 所有任务日志集成在应用日志中
- 优雅关闭: 支持 SIGINT 和 SIGTERM 信号处理
- 跨平台: 不依赖特定的 shell 环境
- 易于调试: 所有逻辑都在 Node.js 中
- 资源效率: 更轻量的容器镜像
项目已完全简化 Docker 部署流程：
- ✅ 移除 cron 依赖: 不再需要复杂的 cron 配置
- ✅ 移除 shell 脚本: 纯 Node.js 服务架构
- ✅ 轻量化镜像: 更小的容器体积和更快的启动速度
- ✅ 统一日志: 集成的日志管理和自动清理
# 克隆项目
git clone <repository-url>
cd twitter-ai-reporter
# 创建必要的目录
mkdir -p logs outputs
# 确保 cookies.json 文件存在
touch cookies.json
# 配置环境变量
cp .env.example .env
# 编辑 .env 文件配置所有必需变量# 构建并启动服务
docker-compose up -d
# 查看服务状态
docker-compose ps
# 查看实时日志
docker-compose logs -f twitter-ai-reporter# 重启服务
docker-compose restart twitter-ai-reporter
# 重新构建并启动
docker-compose up -d --build
# 停止服务
docker-compose stop
# 停止并删除容器
docker-compose down
# 进入容器调试
docker-compose exec twitter-ai-reporter sh前置要求：
- 群辉 NAS 已安装 Docker 套件
- 确保有足够的存储空间（建议 5GB+）和内存资源（建议 2GB+）
部署步骤：
-
上传项目文件
# 建议放在以下目录 /volume1/docker/twitter-ai-reporter/ -
设置权限
# SSH 连接到群辉 NAS 后执行 sudo chown -R 1000:1000 /volume1/docker/twitter-ai-reporter/ sudo chmod -R 755 /volume1/docker/twitter-ai-reporter/ -
配置环境变量
cd /volume1/docker/twitter-ai-reporter/ cp .env.example .env # 编辑 .env 文件，特别注意设置正确的 Chrome 路径 echo "CHROME_EXECUTABLE_PATH=/usr/bin/chromium-browser" >> .env
-
启动服务
docker-compose up -d
资源限制：
- 内存限制：1GB（预留512MB）
- CPU限制：0.5核心（预留0.25核心）
- 存储：自动清理日志，保留最近30天
数据持久化：
./outputs- 报告输出目录./cookies.json- 登录状态文件./logs- 日志文件目录./.env- 环境配置文件
网络配置：
- 使用桥接网络模式
- 支持代理配置
- 自动处理 DNS 解析
问题说明： Docker 容器中可能出现 Chrome 浏览器路径错误：
Browser was not found at the configured executablePath
解决方案：
- 环境变量配置（推荐）：
# 在 .env 文件中设置正确路径
CHROME_EXECUTABLE_PATH=/usr/bin/chromium-browser- 不同环境的路径配置：
# Docker 环境
CHROME_EXECUTABLE_PATH=/usr/bin/chromium-browser
# macOS 本地开发
CHROME_EXECUTABLE_PATH=/Applications/Google Chrome.app/Contents/MacOS/Google Chrome
# Linux 系统
CHROME_EXECUTABLE_PATH=/usr/bin/google-chrome
# Windows 系统
CHROME_EXECUTABLE_PATH=C:\Program Files\Google\Chrome\Application\chrome.exe- 验证配置：
# 进入容器检查
docker exec -it twitter-ai-reporter sh
ls -la /usr/bin/chromium-browser
# 测试浏览器启动
chromium-browser --version项目采用内置日志管理系统，提供统一的日志格式和自动化管理功能：
- ✅ 统一日志格式: 所有输出都包含 ISO 时间戳和任务标识符
- ✅ 自动日志轮转: 当日志文件超过指定大小时自动创建新文件
- ✅ 智能清理: 自动删除过期日志文件，保留最近的记录
- ✅ 内存优化: 适配群辉 NAS 等资源受限环境
- ✅ 实时监控: 支持实时日志查看和状态监控
| 标识符 | 含义 |
|---|---|
[CONTAINER-START] |
容器启动 |
[SCHEDULER-START] |
任务调度器启动 |
[CRAWL-START] |
开始爬取 |
[CRAWL-SUCCESS] |
爬取成功 |
[CRAWL-ERROR] |
爬取错误 |
[AUTH-START] |
开始认证 |
[AUTH-SUCCESS] |
认证成功 |
[AUTH-ERROR] |
认证错误 |
[REPORT-START] |
开始生成报告 |
[REPORT-SUCCESS] |
报告生成成功 |
[REPORT-ERROR] |
报告生成错误 |
[LOG-CLEANUP] |
日志清理 |
[TASK-SCHEDULED] |
任务已调度 |
# Docker 环境 - 查看应用日志
docker-compose logs -f twitter-ai-reporter
docker-compose logs --tail=100 twitter-ai-reporter
# 本地环境 - 查看日志文件
tail -f logs/app.log
tail -f logs/error.log
# 查看特定日期的日志
ls logs/
cat logs/2024-01-15.loglogs/
├── app.log # 当前应用日志
├── error.log # 错误日志
├── 2024-01-15.log # 按日期归档的日志
├── 2024-01-14.log # 历史日志文件
└── .gitkeep # Git 目录占位文件
[2024-01-15T09:00:02.123Z] [SCHEDULER-START] 任务调度器已启动
[2024-01-15T09:00:05.456Z] [CRAWL-START] 开始执行推文爬取任务...
[2024-01-15T09:00:10.789Z] [CRAWL-SUCCESS] 成功创建浏览器实例
[2024-01-15T09:15:30.012Z] [CRAWL-SUCCESS] 推文爬取完成，共收集 25 条推文
[2024-01-15T23:00:01.345Z] [REPORT-START] 开始生成 AI 分析报告
[2024-01-15T23:05:15.678Z] [REPORT-SUCCESS] AI 报告生成完成: outputs/tech-report-2024-01-15.md
相比传统的 cron 日志系统，内置日志管理具有以下优势：
- 清晰的输出: 移除了 cron 任务中的乱码和二进制数据
- 完整的信息: 包含完整的时间戳和任务标识
- 统一的格式: 所有日志输出都遵循统一的格式标准
- 自动管理: 无需手动清理，系统自动处理日志轮转和清理
- 易于调试: 结构化的日志信息便于问题定位和调试
Q: 服务无法启动？
解决步骤：
# 1. 检查环境变量配置
npm run check-config
# 2. 查看容器日志
docker-compose logs twitter-ai
# 3. 验证配置文件
cat .env | grep -v "^#" | grep -v "^$"
# 4. 检查资源使用
docker stats twitter-aiQ: 任务没有执行？
解决步骤：
# 1. 检查系统时间是否正确
date
# 2. 查看应用日志中的任务调度信息
tail -f logs/app.log | grep "scheduler"
# 3. 手动执行任务测试
node scripts/crawl-tweets.jsQ: 如何获取 Supabase 配置？
A: 在 Supabase 项目设置中找到 API 密钥和项目 URL
Q: 硅基流动 API 密钥在哪里获取？
A: 访问硅基流动官网注册账号并获取 API 密钥
Q: 代理配置是必需的吗？
A: 根据网络环境决定，配置 PROXY_HOST 和 PROXY_PORT 即可
Q: 推文爬取失败怎么办？
解决步骤：
# 1. 检查登录状态
node scripts/update-cookies.js
# 2. 验证网络连接
node tests/testProxy.js
# 3. 检查浏览器配置
echo $CHROME_EXECUTABLE_PATH
# 4. 查看详细错误日志
NODE_ENV=development node scripts/crawl-tweets.jsQ: AI 简报生成失败？
解决步骤：
# 1. 验证 API 密钥
curl -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
https://api.siliconflow.cn/v1/models
# 2. 测试 AI 功能
npm run test-ai
# 3. 检查网络连接
ping api.siliconflow.cnQ: 内存不足或处理缓慢？
解决方案：
# 1. 调整 docker-compose.yml 中的内存限制
# 在 docker-compose.yml 中添加：
# deploy:
# resources:
# limits:
# memory: 2G
# reservations:
# memory: 1G
# 2. 监控容器资源使用情况
docker stats twitter-ai
# 3. 优化并发配置
echo "MAX_CONCURRENT=1" >> .env
echo "REQUEST_DELAY=2000" >> .env
# 4. 调整 Node.js 内存限制
node --max-old-space-size=4096 scripts/crawl-tweets.js# 本地调试运行
node app.js
# 查看详细日志
DEBUG=* node app.js
# 启用详细日志级别
LOG_LEVEL=debug npm run serve如果你之前使用的是 cron 版本，迁移步骤：
-
停止旧服务:
docker-compose down
-
更新代码到最新版本:
git pull origin main
-
重新构建并启动:
docker-compose up -d --build
-
验证服务正常运行:
docker-compose logs -f twitter-ai
注意: 旧的 shell 脚本和 cron 配置文件仍然保留，但不再使用。
Q: 数据库连接失败？
解决步骤：
# 1. 测试数据库连接
node -e "require('./src/lib/supabase').testConnection()"
# 2. 验证配置
echo $SUPABASE_URL
echo $SUPABASE_ANON_KEY
# 3. 检查网络访问
curl -I $SUPABASE_URLQ: 容器启动失败？
解决步骤：
# 1. 检查日志
docker compose logs twitter-ai-reporter
# 2. 验证环境文件
cat .env | grep -v "^#" | grep -v "^$"
# 3. 检查资源使用
docker stats twitter-ai-reporter
# 4. 重新构建
docker compose down
docker compose build --no-cache
docker compose up -dQ: 权限问题？
解决步骤：
# 设置正确的文件权限
sudo chown -R 1000:1000 logs outputs cookies.json
sudo chmod -R 755 logs outputs
sudo chmod 644 cookies.jsonQ: 内存不足或处理缓慢？
解决方案：
# 1. 调整 Node.js 内存限制
node --max-old-space-size=4096 scripts/crawl-tweets.js
# 2. 优化并发配置
echo "MAX_CONCURRENT=1" >> .env
echo "REQUEST_DELAY=2000" >> .env
# 3. 监控资源使用
top -p $(pgrep -f "node.*crawl-tweets")# 设置调试级别
LOG_LEVEL=debug node scripts/crawl-tweets.js
# 启用 Puppeteer 调试
DEBUG=puppeteer:* node scripts/crawl-tweets.js
# 查看实时日志
tail -f logs/app.log
tail -f logs/error.log# 查看系统资源
docker stats twitter-ai-reporter
# 监控进程
ps aux | grep node
# 检查磁盘使用
df -h
du -sh logs/ outputs/# 测试网络连接
ping twitter.com
nslookup twitter.com
curl -I https://twitter.com
# 测试代理连接
curl -x http://$PROXY_HOST:$PROXY_PORT http://www.example.com如果遇到无法解决的问题：
- 查看日志文件:
logs/error.log和logs/app.log - 运行诊断脚本:
npm run check-config - 检查系统要求: 确保满足所有环境要求
- 更新依赖:
npm update或npm audit fix - 重启服务: 清理缓存并重新启动
# 完整的故障排除流程
npm run check-config
node tests/testProxy.js
npm run test-ai
docker compose logs --tail=100- 🚫 不要将
.env文件提交到版本控制系统 - 🔑 定期更新 API 密钥和登录凭据
- 🛡️ 使用强密码和双因素认证
- 🔐 在生产环境中使用 HTTPS
- 💾 定期备份数据库数据
- 🌐 使用可信的代理服务器
- 🔒 避免在公共网络中运行敏感操作
- 🚪 配置防火墙规则限制访问
- 📊 监控异常网络活动
- 🐳 定期更新 Docker 镜像
- 👤 使用非 root 用户运行容器
- 📁 限制容器文件系统权限
- 🔍 定期扫描安全漏洞
- 克隆并设置开发环境：
git clone <repository-url>
cd twitter-ai-reporter
npm install
cp .env.example .env- 安装开发依赖：
npm install --save-dev jest eslint prettier- 配置代码格式化：
npm run lint
npm run format- ✅ 使用 ES6+ 语法
- ✅ 遵循 ESLint 配置
- ✅ 添加适当的注释和文档
- ✅ 编写单元测试
- ✅ 使用语义化的提交信息
- Fork 项目到你的 GitHub 账户
- 创建功能分支：
git checkout -b feature/amazing-feature - 提交更改：
git commit -m 'feat: add some amazing feature' - 推送分支：
git push origin feature/amazing-feature - 创建 Pull Request
使用约定式提交格式：
type(scope): description
[optional body]
[optional footer]
类型说明：
feat: 新功能fix: 修复 bugdocs: 文档更新style: 代码格式调整refactor: 代码重构test: 测试相关chore: 构建过程或辅助工具的变动
MIT License - 详见 LICENSE 文件。
- 🐛 Bug 报告: GitHub Issues
- 💡 功能建议: GitHub Discussions
- 📧 联系我们: [email protected]
- 📚 文档: 项目 Wiki
⭐ 如果这个项目对你有帮助，请给我们一个 Star！