Survival-Kit 项目概览 解决的问题 Survival-Kit（生存工具箱）解决了以下核心问题： 1. 发现商业机会困难 - 自动化监控GitHub趋势项目，节省手动筛选时间 2. 商业价值评估复杂 - 提供结构化的多维度评分，客观评估项目商业潜力 3. 变现路径不明确 - 根据项目特性自动推荐最适合的变现模式和实施方案 4. 决策缺乏数据支持- 提供全面的市场分析和竞品对比，辅助决策制定 5. 技术创业者资源有限 - 自动化评估投入成本和回报周期，优化资源分配 简而言之，该项目帮助技术创业者快速发现和评估有商业价值的开源项目，降低创业决策风险。 技术选型 后端技术 - Python 3.x - 主要开发语言，具有强大的数据处理能力 - Flask - 轻量级Web框架，易于快速构建API服务 - Requests - 处理HTTP请求，与GitHub API交互 - OpenAI API - 提供AI驱动的项目分析能力 - Pandas & NumPy - 数据分析和处理 - Schedule - 实现定时任务和监控 - Python-dotenv - 环境变量管理 前端技术 - HTML/CSS/JavaScript - 基础前端技术 - 前端框架待完善 - 目前使用简单模板 开发工具 - Git - 版本控制 - Pytest - 单元测试 - Black & Pylint - 代码格式化和质量检查 快速上手指南 1. 环境准备 ```bash 克隆项目 git clone https://github.com/yourusername/survival-kit.git cd survival-kit 创建虚拟环境 python -m venv venv source venv/bin/activate # Linux/Mac # 或 venv\Scripts\activate # Windows 安装依赖 pip install -r requirements.txt ``` 2. 配置设置 ```bash 复制环境变量示例文件 cp .env.example .env 编辑.env文件，填入必要的API密钥 必须设置: GITHUB_TOKEN, OPENAI_API_KEY ``` 3. 运行项目 ```bash 运行监控程序 python run.py 启动Web界面(另一个终端) python -m src.app ``` 4. 查看结果 - 监控结果保存在 `data/github_trends.json` - 分析报告保存在 `data/opportunity_report.json` - Web界面访问: http://localhost:5000 5. 自定义配置 可以在 `.env` 文件中调整以下参数: - `MIN_STARS` - 最低星标数量要求 - `MIN_FORKS` - 最低分支数量要求 - `DAYS_SINCE_UPDATE` - 项目活跃度时间范围 6. 快捷命令 ```bash 仅运行分析模块 python -c "from src.analyzer.project_analyzer import ProjectAnalyzer; ProjectAnalyzer().batch_analyze('data/github_trends.json')" 查看最新报告摘要 python -c "import json; print(json.load(open('data/opportunity_report.json'))['summary'])" ```